Equipment Catalog Archetypes¶

Generic equipment archetypes for energysim.

Every factory in this module is an illustrative archetype, not calibrated to an OEM datasheet: the parameters are round, plausible figures for the equipment class and carry no manufacturer endorsement or data-sheet provenance. See PROVENANCE for the source status of each archetype.

The manufacturer-branded names of earlier versions (Tesla_Megapack_2XL, Fluence_Gridstack, Nel_A1000, ITM_Power_Trident, Bloom_Energy_SOEC, GE_7HA_02, Siemens_SGT_800, Wartsila_34SG, CanadianSolar_HiKu7, Vestas_V150_4MW) are kept as deprecated aliases: they emit a DeprecationWarning and return the generic archetype configured with the numbers the old name used. They will be removed in a future release.

Archetypes¶

Factory	Builds	Provenance
`catalog.BESS_2h_2MW`	`BatteryBESS`	Generic 2-hour Li-ion BESS (2 MW / 4 MWh). Round figures; no datasheet source.
`catalog.BESS_4h_2MW`	`BatteryBESS`	Generic 4-hour Li-ion BESS (2 MW / 8 MWh). Round figures; no datasheet source.
`catalog.Alkaline_2MW`	`AlkalineElectrolyzer`	Generic atmospheric alkaline electrolyzer, 2 MW, ~52 kWh/kg system consumption (typical literature range 50-55). Not an OEM datasheet.
`catalog.PEM_5MW`	`PEMElectrolyzer`	Generic 5 MW PEM electrolyzer with an illustrative lookup polarization curve. Not fitted to any stack.
`catalog.SOEC_1MW`	`SOECElectrolyzer`	Generic 1 MW solid-oxide electrolyzer, ~37.5 kWh/kg electricity (heat supplied externally). Not an OEM datasheet.
`catalog.CCGT_570MW`	`CombinedCycle_CCGT`	Generic large-frame combined cycle, ~64 % LHV net at full load. Round figures; no datasheet source.
`catalog.Gas_Turbine_60MW`	`GasTurbine_OCGT`	Generic industrial open-cycle gas turbine, ~39 % LHV. No datasheet source.
`catalog.Gas_Engine_10MW`	`ReciprocatingGenset`	Generic lean-burn gas genset, 47 % electrical / 41 % heat recovery. No datasheet source.
`catalog.Solar_Farm`	`PhysicsPV`	Generic utility PV plant, 1.25 DC/AC ratio, -0.34 %/K. No datasheet source.
`catalog.Wind_Turbine_4MW`	`WindTurbine`	Generic 4 MW onshore turbine with a simple cubic power curve between cut-in and rated wind speed. No datasheet source.

Deprecated manufacturer-named aliases¶

These names emit a DeprecationWarning and will be removed. They are not backed by OEM datasheets.

Alias	Provenance
`catalog.Tesla_Megapack_2XL`	DEPRECATED alias of BESS_2h_2MW; keeps the old 1.929 MW / 3.916 MWh numbers which are not backed by a cited datasheet.
`catalog.Fluence_Gridstack`	DEPRECATED alias of BESS_4h_2MW; old numbers not backed by a cited datasheet.
`catalog.Nel_A1000`	DEPRECATED alias of Alkaline_2MW; keeps the old 2.2 MW figure, which is suspect (a 1000 Nm3/h machine would be ~4.5 MW) and unsourced.
`catalog.ITM_Power_Trident`	DEPRECATED alias of PEM_5MW; numbers unsourced.
`catalog.Bloom_Energy_SOEC`	DEPRECATED alias of SOEC_1MW; numbers unsourced.
`catalog.GE_7HA_02`	DEPRECATED alias of CCGT_570MW; keeps the old 573 MW figure, unsourced.
`catalog.Siemens_SGT_800`	DEPRECATED alias of Gas_Turbine_60MW; keeps the old 62 MW figure, unsourced.
`catalog.Wartsila_34SG`	DEPRECATED alias of Gas_Engine_10MW; keeps the old 9.7 MW figure, unsourced.
`catalog.CanadianSolar_HiKu7`	DEPRECATED alias of Solar_Farm; numbers unsourced.
`catalog.Vestas_V150_4MW`	DEPRECATED alias of Wind_Turbine_4MW; keeps the old 4.2 MW figure, unsourced.

Usage example¶

from energysim import world
from energysim.models import catalog

sim = world(start_time=0, stop_time=3600, t_macro=900)
bess = catalog.BESS_2h_2MW(name='bess', soc_init=0.5)
sim.add_model('bess', model=bess, outputs=['P_actual', 'SoC'], step_size=60)
res = sim.simulate()
print(res['bess'].tail(2))