# ESDL Release Notes

## Latest commits:

* renamed SolarFieldPotential to SolarPotential, and added type parametre (roof, field, road, BIPV, ...)
* added area and fullLoadHours parameters to SearchAreaWind/Solar
* costInformation: splitted O\_and\_MCosts into fixedOperationalAndMaintenanceCosts and variable OperationalAndMaintenanceCosts; added MarginalCosts
* added StorageStrategy
* added residentialBuildingType parameter to AggregatedBuilding
* made difference between supplyTemperature and returnTemperature for HeatCommodity
* changed cardinality of profile in the Port class from \[0..1] to \[0..\*]
* added Material class
* added PipeDiameterEnum enumeration
* added StateEnum enumeration
* added Switch, Compressor and PressureReducingValve classes
* added Sensor class
* renamed CircuitBraker to CircuitBreaker
* added parameters for Pipe class
* added version to EnergySystem
* added assetType to Asset
* added port reference to DrivenByProfile
* added POWER\_REACTIVE, FLOW, COMPOSITION and STATE to PhysicalQuantityEnum
* added VOLT\_AMPERE and VOLT\_AMPERE\_REACTIVE to UnitEnum

## Release v1901 ([link](https://github.com/EnergyTransition/ESDL/releases/tag/v1901))

* Added aggregated parameter for Potential
* Added aggregationCount parameter for Potential and Asset
* Added Glass Asset
* Added HeatExchange parameter
* Added VOLUME and AREA to PhysicalQuantityEnum
* Added IDs to a number of classes in EnergySystemInformation
* Added interpolationMethod to GenericProfile
* Added name to Port
* Added WKT and WKB as geometry types
* Added SearchAreaWind and SearchAreaSolar as new Potential subclasses
* Added efficiency as a parameter for the Transport class
* Added Joint class to solve conflicts with loops in toplogies (in-in and out-out ports)

## Release v1811 ([link](https://github.com/EnergyTransition/ESDL/releases/tag/v1811))

* Completely changed way of modeling energy potentials
* added WaterBuffer, UTES, RoomHeater
* EnergySystem ID marked as ID
* added 'aggregated' boolean to Asset
* added 'power' to Consumer
* added 'percent' to UnitEnum
* made relation between ControlStrategy and EnergyAsset bidirectional

## Release v1810 ([link](https://github.com/EnergyTransition/ESDL/releases/tag/v1810))

* ESDL version has been removed from namespace (was sometimes causing problems with code generation)
* Added MeasuresCollection (e.g. to group different renovation options for buildings)
* Added Sectors (and references from Asset and Party)
* Added ControlStrategy
* Added EnergyMarkets
* Added different Assets: WaterToPower (with types hydro, waves, osmosis, tidal), PVInstallation (with types roof, building integrated, road, field, ...) and WindTurbine types (sea, land, coast, roof), GasConversion, Electrolyzer types (PEM, alkaline, SOEC)
* Changed the way EnergyPotentials are modeled (now grouped per type)
* Restructured the subclasses of Transport
* Renamed KPIList to KPIs

## Release v180901 ([link](https://github.com/EnergyTransition/ESDL/releases/tag/v180901))

* Added KPIs to areas
* Added new way of describing Quantities and Units (now only used in profiles, kpis and energy carriers)
* Added possibility to add a DataSource to an asset, profile and so on, without the need for an EnergySystem
* Added ResidualHeatSourcePotential to list of possible Potentials

## Release v1809 ([link](https://github.com/EnergyTransition/ESDL/releases/tag/v1809))

* Added assets (GasStorage, Electrolyzer)
* Changed name of asset SinkProducer to SourceProducer
* Added buildingDensity parameter to Area

## Release v1808 ([link](https://github.com/EnergyTransition/ESDL/releases/tag/v1808))

* Merged Commodities and EnergyCarriers lists into Carriers list
* Removed commodities enumeration from ports
* Added mobility concepts to ESDL (Mobility demand per vehicle type and fuel type, fuel efficiency per vehicle type, number of vehicles per area)
* Improved the Geometry classes (added MultiPolygon)
* Added assets (ResidualHeatSource, MobilityDemand, SolarCollector, FermentationPlant)
* Added residual heat source potential
* Added Parties class to model ownership
* Added DataSources class to list sources of used data in an ESDL model
* Added Profiles class and ReferenceProfile class to enable reuse of profiles
* Measures is an Asset collection instead of an Item collection (to ease development of ESDL designer)

## Release v1807a ([link](https://github.com/EnergyTransition/ESDL/releases/tag/v1807a))

* Generated proper XSD, the v1807 release still contained the v1806 XSD

## Release v1807 ([link](https://github.com/EnergyTransition/ESDL/releases/tag/v1807))

* Added 'UNDEFINED' and 'ENERGY' to CommodityEnum
* Renamed some assets:
  * HeatPipe --> Pipe
  * HeatDemand --> HeatingDemand
  * CoolDemand --> CoolingDemand

## Release v1806 ([link](https://github.com/EnergyTransition/ESDL/releases/tag/v1806))

* Initial public release


---

# 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/releasenotes.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.