# Energy System

The EnergySystem class will be the place to start if you want to model an energy system for a certain region.

An EnergySystem contains the following information:

* [Instances](/esdl/esdl-concepts/data-types/energy-system.md#instances)
* [Potentials](/esdl/esdl-concepts/data-types/energy-system.md#potentials)
* [Measures](/esdl/esdl-concepts/data-types/energy-system.md#measures)
* [Parties](/esdl/esdl-concepts/data-types/energy-system.md#parties)
* [EnergySystemInformation](/esdl/esdl-concepts/data-types/energy-system.md#energysysteminformation)

## Instances

An EnergySystem can contain zero or more Instances. Instances are used to represent different representations of the **same** EnergySystem. Most of the times only one Instance will be used. The primary use case for having more than one Instance is when you have different aggregations of the same EnergySystem in the same model (e.g. the same region on house level and aggregated on neighbourhood level). Another option would be to create different instances for different years (to describe the progress of the energy transition).

All instances contain an Area. The Area is the class to represent a geographical or logical area. An Area contains all assets in that area or can be subdivided into more Areas

## Potentials

Potentials can be used to describe all different kinds of energy potentials. Examples of potentials are:

* GeothermalPotential: to describe the potential for geothermal energy
* WindPotential: to describe the potential for wind turbines
* SolarPotential: to describe the potential for solar PV fields
* LegalArea: to describe for example areas where no aquifers are allowed because the underground water is used for drinking water (a negative potential).

## Measures

Measures can be used to describe possible assets that can be installed in the EnergySystem (e.g. added by a model calculating minimum investments required to match future demands).

## Parties

Parties can be used if you want to model ownership of assets

## EnergySystemInformation

The EnergySystemInformation class is a container for additional information about the EnergySystem in general.

Currently the following information can be added:

* AvailableEnergyCarriers: list of available energy carriers with information about energy content and CO2 emissions. Power plants typically refer to energy carriers to indicate what the source of their energy is.
* EnergyPrices: prices for gas, electricity


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://energytransition.gitbook.io/esdl/esdl-concepts/data-types/energy-system.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.