Pumped storage fleet
--------------------

<img src="../../_static/Pumpedstoragefleet.png" alt="Alt text" width="50" style="float: left; margin-right: 10px;">

**Technology ID: PUMPED_STORAGE_FLEET**



**Input energy interface, with default energy:**

 - CONSUMPTION: electricity

**Output energy interface, with default energy:**

 - SYNC_RESERVE_DOWN: syncResDown
 - MFRR_DOWN: mfrrResDown
 - SYNC_RESERVE_UP: syncResUp
 - MFRR_UP: mfrrResUp
 - PRODUCTION: electricity

**Technology behaviors:**

 - OPTIM_PATHWAY
 - OPTIM_PMAX
 - DISCHARGE_TIMES
 - CLUSTER
 - RESERVE
 - USE_PMAX_IN

**Technology parameters:**

| ID | Label | Unit | Behaviors | Description  |
| --- | --- | --- | --- | --- |
| SYNC_RESERVE_UP_MAX_SHARE | Max share to upward sync. reserve | % | RESERVE | Maximal share of upward sync. reserve in running capacity |
| SYNC_RESERVE_DOWN_MAX_SHARE | Max share to downward sync. reserve | % | RESERVE | Maximal share of downward sync. reserve in running capacity |
| MFRR_UP_MAX_SHARE | Max share to upward reserve | % | RESERVE | Maximal share of upward mFRR and sync. reserve in running capacity |
| MFRR_DOWN_MAX_SHARE | Max share to downward reserve | % | RESERVE | Maximal share of downward mFRR and sync. reserve in running capacity |
| SYNC_RESERVE_UP_COST | Op. cost of the upward sync. reserve | Euro/MW | RESERVE | Operating cost of the upward sync. reserve< |
| SYNC_RESERVE_DOWN_COST | Op. cost of the downward sync. reserve | Euro/MW | RESERVE | Operating cost of the downward sync. reserve |
| MFRR_UP_COST | Op. cost of upward mFRR | Euro/MW | RESERVE | Operating cost of upward mFRR |
| MFRR_DOWN_COST | Op. cost of downward mFRR | Euro/MW | RESERVE | Operating cost of downward mFRR |
| CAPEX_OVERNIGHT | CAPEX Overnight | Euro/MW |  | -Overall capital expenditure (only used for pathway optimization) |
| DEINVEST_COST | Deinvest cost | Euro/MW |  | Deinvest cost (only used for pathway optimization) |
| LIFETIME | Lifetime |  |  | Lifetime of the asset (only used for pathway optimization) |
| YIELD_INVEST | Yield of investment | % |  | Yield associated with investment |
| INSTALL_MAX | Max installation | MW | OPTIM_PATHWAY | Max installation (only used for pathway optimization) |
| DECOMM_MAX | Max decommissioning | MW | OPTIM_PATHWAY | Max decommissioning (only used for pathway optimization) |
| STORAGE_CAPEX_OVERNIGHT | Overnight CAPEX (Storage) | Euro/MW.h/Year |  | Overnight capital expenditure for storage assets |
| CAPEX | CAPEX | Euro/MW/Year |  | Capital expenditure (only used for capacity optimization) |
| FOC | Fixed Operating Costs | Euro/MW/Year |  | Fixed Operating Costs (only used for capacity optimization) |
| PMAX | Pmax | MW | (not OPTIM_PMAX) and (not OPTIM_PATHWAY) | Installed power capacity |
| PMAXMIN | Min Pmax | MW | OPTIM_PMAX or OPTIM_PATHWAY | Installed capacity lower bound for capacity optimization |
| PMAXMAX | Max Pmax | MW | OPTIM_PMAX or OPTIM_PATHWAY | Installed capacity upper bound for capacity optimization |
| AVAILABILITY | Availability | % |  | Available capacity, expressed as a percentage of the installed capacity |
| AVAILABILITY_IN | Input availability | % |  | Injection capacity availability |
| PRODUCTION_COST | Production cost | Euro/MW.h |  | Production cost (emission cost excluded) |
| CONSUMPTION_COST | Consumption cost | Euro/MW.h |  | Consumption cost |
| MIN_LOAD | Fleet min load | % | not CLUSTER | Minimum production level, expressed as a percentage of the available capacity |
| STORAGE_CAPEX | CAPEX (Storage) | Euro/MW.h/Year |  | Capital expenditure for storage assets |
| STORAGE_CAPACITY | Storage capacity | MW.h | (not DISCHARGE_TIMES) | Storage capacity |
| DISCHARGE_TIME | Discharge time | h | DISCHARGE_TIMES | Discharge time |
| STORAGE_AVAILABILITY | Storage availability | % |  | Storage availability, expressed as a percentage of the installed storage capacity |
| INPUT_EFFICIENCY | Input efficiency | % |  | Pumping efficiency |
| OUTPUT_EFFICIENCY | Output efficiency | % |  | Turbining efficiency |
| MIN_STORAGE_LEVEL | Minimal storage level | % |  | Minimum level for storage, expressed as a percentage of the installed storage capacity |
| INITIAL_STORAGE_LEVEL | Storage initial level | % |  | Initial storage level, expressed as a percentage of the installed storage capacity |
| BOUNDED_SUPPLY | Bounded supply | MW |  | Supply with overflow control. Excess supply will not be added to storage if it is already full. |
| STORAGE_COST | Storage cost | Euro/MW.h/h |  | Cost associated with storage. Non-zero storage cost prevents equaly-optimal \ |
| PMAX_IN | Pmax In | MW | USE_PMAX_IN and not OPTIM_PMAX | Input maximal power |
| CLUSTER_STARTING_COST | Starting cost | Euro/MW | CLUSTER | Cost to start additional capacity |
| RUNNING_COST | Running cost | Euro/MW | CLUSTER | Cost associated with maintaining a certain running capacity |
| RUNNING_CAPACITY_MIN_LOAD | Running capacity min load | % | RESERVE or CLUSTER | Minimum level for the production, expressed as a percentage of the running capacity in Cluster Mode and as percentage of available capacity (pMax*availabilty) inUnit Mode .For assets in fleet mode with reserve, please refer to addReserveProduction(..) for the running capacity definition. |
| MIN_OFF_TIME | Min off time | h | CLUSTER | When a part of the running capacity is switched off, this part cannot be switch on before a duration equals to min Off time. |
|  |

**Model code:**

``` python
stateON = AssetState('ON')
addEnergyProduction(asset, stateON)
addEnergyConsumption(asset, stateON, availability="AVAILABILITY_IN")
addDischargeStock(asset, stateON, minStorageLevel=MIN_STORAGE_LEVEL, inputEfficiency=INPUT_EFFICIENCY, outputEfficiency=OUTPUT_EFFICIENCY, initialStorageLevel=INITIAL_STORAGE_LEVEL, storageAvailability=STORAGE_AVAILABILITY, initialEqualsFinal=True)
addReserveProductionStorage(asset, stateON)
finalize(stateON)

```