Specifying the type of...

Some fields in PowerSystems.jl are specified with an option from a pre-defined list (Specified with IS.scoped_enums).

Example syntax:

set_fuel!(gen, ThermalFuels.COAL)

These predefined lists are below:

AC Buses

ACBusTypes categorize buses for modeling activities and denote which quantities are specified for load flow calculations. ACBusTypes has the options:

NameDescription
ISOLATEDDisconnected from network
PQActive and reactive power defined (load bus)
PVActive power and voltage magnitude defined (generator bus)
REFReference bus (θ = 0)
SLACKSlack bus

Prime Movers

Each generator contains a field for prime_mover::PrimeMovers, based on the options in EIA form 923. PrimeMovers has the options:

NameDescription
BAEnergy Storage, Battery
BTTurbines Used in a Binary Cycle (including those used for geothermal applications)
CACombined-Cycle – Steam Part
CCCombined-Cycle - Aggregated Plant *augmentation of EIA
CEEnergy Storage, Compressed Air
CPEnergy Storage, Concentrated Solar Power
CSCombined-Cycle Single-Shaft Combustion turbine and steam turbine share a single generator
CTCombined-Cycle Combustion Turbine Part
ESEnergy Storage, Other
FCFuel Cell
FWEnergy Storage, Flywheel
GTCombustion (Gas) Turbine (including jet engine design)
HAHydrokinetic, Axial Flow Turbine
HBHydrokinetic, Wave Buoy
HKHydrokinetic, Other
HYHydraulic Turbine (including turbines associated with delivery of water by pipeline)
ICInternal Combustion (diesel, piston, reciprocating) Engine
PSEnergy Storage, Reversible Hydraulic Turbine (Pumped Storage)
OTOther
STSteam Turbine (including nuclear, geothermal and solar steam; does not include combined-cycle turbine)
PVePhotovoltaic (Note: renaming from EIA PV to PVe to avoid conflict with ACBusType.PV)
WTWind Turbine, Onshore
WSWind Turbine, Offshore

Fuels for Thermal Generators

Each ThermalGen generator has a field for fuel::ThermalFuels where ThermalFuels are intended to reflect the options in the Aggregated Fuel Codes from the EIA Annual Energy Review. ThermalFuels has the options:

NameEIA Fuel CodeDescription
ANTHRACITE_COALANTAnthracite Coal
BITUMINOUS_COALBITBituminous Coal
LIGNITE_COALLIGLignite Coal
SUBBITUMINOUS_COALSUBSubbituminous Coal
WASTE_COALWCWaste/Other Coal (including anthracite culm, bituminous gob, fine coal, lignite waste, waste coal)
REFINED_COALRCRefined Coal (A coal product that improves heat content and reduces emissions. Excludes coal processed by coal preparation plants.)
SYNTHESIS_GAS_COALSGCCoal-Derived Synthesis Gas
DISTILLATE_FUEL_OILDFODistillate Fuel Oil (including diesel, No. 1, No. 2, and No. 4 fuel oils)
JET_FUELJFJet Fuel
KEROSENEKERKerosene
PETROLEUM_COKEPCPetroleum Coke
RESIDUAL_FUEL_OILRFOResidual Fuel Oil (including No. 5 and No. 6 fuel oils, and bunker C fuel oil)
PROPANEPGPropane, gaseous
SYNTHESIS_GAS_PETROLEUM_COKESGPPetroleum Coke Derived Synthesis Gas
WASTE_OILWOWaste/Other Oil (including crude oil, liquid butane, liquid propane, naphtha, oil waste, re-refined motor oil, sludge oil, tar oil)
BLASTE_FURNACE_GASBFGBlast Furnace Gas
NATURAL_GASNGNatural Gas
OTHER_GASOGOther Gas
AG_BYPRODUCTABAgricultural By-products
MUNICIPAL_WASTEMSWMunicipal Solid Waste
OTHER_BIOMASS_SOLIDSOBSOther Biomass Solids
WOOD_WASTE_SOLIDSWDSWood/Wood Waste Solids (including paper, pellets, railroad ties, utility poles, wood chips, bark, and wood waste solids)
OTHER_BIOMASS_LIQUIDSOBLOther Biomass Liquids
SLUDGE_WASTESLWSludge Waste
BLACK_LIQUORBLQBlack Liquor
WOOD_WASTE_LIQUIDSWDLWood Waste Liquids excluding Black Liquor (includes red liquor, sludge wood, spent sulfite liquor, and other wood-based liquids)
LANDFILL_GASLFGLandfill Gas
OTHEHR_BIOMASS_GASOBGOther Biomass Gas (includes digester gas, methane, and other biomass gasses)
NUCLEARNUCNuclear Uranium, Plutonium, Thorium
WASTE_HEATWHWaste heat not directly attributed to a fuel source
TIREDERIVED_FUELTDFTire-derived Fuels
OTHEROTHOther type of fuel

Energy Storage

StorageTech defines the storage technology used in an energy Storage system, based on the options in EIA form 923. StorageTech has the options:

NameDescription
PTESPumped thermal energy storage
LIBLiON Battery
LABLead Acid Battery
FLWBRedox Flow Battery
SIBSodium Ion Battery
ZIBZinc Ion Battery
HGSHydrogen Gas Storage
LAESLiquid Air Storage
OTHER_CHEMOther Chemical Storage
OTHER_MECHOther Mechanical Storage
OTHER_THERMOther Thermal Storage

Facts Control Devices

FACTSOperationModes define the operation modes the FACTS Control Devices have. FACTSOperationModes has the options:

NameDescription
OOSOut-Of-Service (i.e., Series and Shunt links open)
NMLNormal mode of operation, where Series and Shunt links are operating
BYPSeries link is bypassed (i.e., like a zero impedance line) and Shunt link operates as a STATCOM

Dynamic States

StateTypes are used to denote the type of dynamic equation a specific state is subject to in PowerSimulationsDynamics.jl. StateTypes has the options:

NameDescription
DifferentialState evolves over time via a differential equation $\dot{x} = f(x)$
AlgebraicState evolves over time by satisfying an algebraic equation $0 = g(x)$
HybridDepending on specific parameters, the state can be Differential or Algebraic

Angle Units

AngleUnits can be specified in:

Name
DEGREES
RADIANS