The table below summarizes the units of each output variable reported as part of the various CSV files produced after each model run. The reported units are also provided. If a result file includes time-dependent values, the value will not include the hour weight in it. An annual sum ("AnnualSum") column/row will be provided whenever it is possible (e.g., emissions.csv).
!!! tip "Temporal Output File Formats"
For full time series temporal outputs (when WriteOutputs: "full"), users can specify the output format using the TemporalOutputFormat setting in genx_settings.yml. Supported formats are:
- "csv" (default): Standard CSV format
- "gzip": Gzipped CSV format (.csv.gz) for 50-70% storage reduction
- "parquet": Apache Parquet format (.parquet) for 80-90% storage reduction
This setting affects files like power.csv, charge.csv, storage.csv, curtailment.csv, and other time series outputs. Annual outputs (when `WriteOutputs: "annual"`) are always written in CSV format.
Reports optimal values of investment variables (except StartCap, which is an input)
| Output | Description | Units |
|---|---|---|
| StartCap | Initial power capacity of each resource type in each zone; this is an input | MW |
| RetCap | Retired power capacity of each resource type in each zone | MW |
| NewCap | Installed capacity of each resource type in each zone | MW |
| EndCap | Total power capacity of each resource type in each zone | MW |
| StartEnergyCap | Initial energy capacity of each resource type in each zone; this is an input and applies only to storage tech. | MWh |
| RetEnergyCap | Retired energy capacity of each resource type in each zone; applies only to storage tech. | MWh |
| NewEnergyCap | Installed energy capacity of each resource type in each zone; applies only to storage tech. | MWh |
| EndEnergyCap | Total installed energy capacity of each resource type in each zone; applies only to storage tech. | MWh |
| StartChargeCap | Initial charging power capacity of STOR = 2 resource type in each zone; this is an input |
MW |
| RetChargeCap | Retired charging power capacity of STOR = 2 resource type in each zone |
MW |
| NewChargeCap | Installed charging capacity of each resource type in each zone | MW |
| EndChargeCap | Total charging power capacity of each resource type in each zone | MW |
!!! note "Note"
Capacity output for Allam Cycle LOX resources that is included in the capacity.csv file is for the sCO2Turbine in an Allam Cycle LOX resource.
For the full capacity output, please refer to the capacity_allam_cycle_lox.csv file (GenX.write_allam_capacity).
Reports optimal objective function value and contribution of each term by zone.
| Output | Description | Units |
|---|---|---|
| cTotal | Total objective function value | USD |
| cFix | Total annualized investment and fixed operating & maintainenance (FOM) costs associated with all resources | USD |
| cVar | Total annual variable cost associated with all resources; includes fuel costs for thermal plants | USD |
| cNSE | Total annual cost of non-served energy | USD |
| cStart | Total annual cost of start-up of thermal power plants | USD |
| cUnmetRsv | Total annual cost of not meeting time-dependent operating reserve (spinning) requirements | USD |
| cNetworkExp | Total cost of network expansion | USD |
| cEmissionsRevenue | Total and zonal emissions revenue | USD |
| cEmissionsCost | Total an zonal emissions cost | USD |
Reports CO2 emissions by zone at each hour; an annual sum row will be provided. If any emission cap is present, emission prices each zone faced by each cap will be copied on top of this table with the following strucutre.
| Output | Description | Units |
|---|---|---|
| CO_2_price | Marginal CO2 abatement cost associated with constraint on maximum annual CO2 emissions; will be same across zones if CO2 emissions constraint is applied for the entire region and not zone-wise | USD/ tonne CO2. |
Reports non-served energy for every model zone, time step and cost-segment.
Reports power discharged by each resource (generation, storage, demand response) in each model time step.
Reports dual variable of maximum non-served energy constraint (shadow price of reliability constraint) for each model zone and time step.
Reports marginal electricity price for each model zone and time step. Marginal electricity price is equal to the dual variable of the load balance constraint. If GenX is configured as a mixed integer linear program, then this output is only generated if WriteShadowPrices flag is activated. If configured as a linear program (i.e. linearized unit commitment or economic dispatch) then output automatically available.
Reports computational performance of the model and objective function related information.
| Output | Description | Units |
|---|---|---|
| Status | termination criteria (optimal, timelimit etc.). | |
| solve | Solve time including time for pre-solve | seconds |
| Objval | Optimal objective function value | USD |
| Objbound | Best objective lower bound | USD |
| FinalMIPGap | Optimality gap at termination in case of a mixed-integer linear program (MIP gap); when using Gurobi, the lower bound and MIP gap is reported excluding constant terms (E.g. fixed cost of existing generators that cannot be retired) in the objective function and hence may not be directly usable. | Fraction |
This file summarizes the cost, revenue and profit for each generation technology for each region.
| Output | Description | Units |
|---|---|---|
| Fixed_OM_cost_MW | Fixed Operation and Maintenance cost of the MW capacity. | USD |
| Fixed_OM_cost_MWh | Fixed Operation and Maintenance cost of the MWh capacity. Only applicable to energy storage. | USD |
| Var_OM_cost_out | Variable Operation and Maintenance cost of the power generation or discharge. | USD |
| Var_OM_cost_in | Variable Operation and Maintenance cost of the power charge/pumping. Only applicable to energy storage. | USD |
| Fuel_cost | Fuel cost of the power generation. Only applicable to generation that burns fuel. | USD |
| Charge_cost | Cost of charging power (due to the payment for electricity) Only applicable to energy storage. | USD |
| EmissionsCost | Cost of buying emission credit. | USD |
| StartCost | Cost of generator start-up. | USD |
| Inv_cost_MW | Cost of building MW capacity. | USD |
| Inv_cost_MWh | Cost of building MWh capacity. | USD |
| EnergyRevenue | Revenue of generating power. | USD |
| SubsidyRevenue | Revenue of Min_Cap subsidy. | USD |
| ReserveMarginRevenue | Revenue earned from capacity reserve margin constraints. | USD |
| ESRRevenue | Revenue selling renewable/clean energy credits. | USD |
| Revenue | Total Revenue. | USD |
| Cost | Total Cost. | USD |
| Profit | Revenue minus Cost. | USD |
This section includes the output files that GenX will print if corresponding function is specified in the Settings.
This file includes the time-dependent capacity value calculated for each generator. GenX will print this file only if the capacity reserve margin constraints are modeled through the setting file. Each row of the file (excluding the header) corresponds to a generator specified in the inputs. Each column starting from the t1 to the second last one stores the result of capacity obligation provided in each hour divided by the total capacity. Thus the number is unitless. If the capacity margin reserve is not binding for one hour, GenX will return zero. The last column specified the name of the corresponding capacity reserve constraint. Note that, if the user calculates the hour-weight-averaged capacity value for each generator using data of the binding hours, the result is what RTO/ISO call capacity credit.
This file includes the energy revenue in USD earned by each generator through injecting into the grid. Only annual sum values are available.
This file includes the charging cost in USD of earned by each generator through withdrawing from the grid. Only annual sum values are available.
This file includes the shadow prices of the capacity reserve margin constraints. GenX will print this file only when capacity reserve margin is modeled and the shadow price can be obtained form the solver, as described earlier. Each row (except the header) corresponds to a capacity reserve margin constraint, and each column corresponds to an time step. As a reminder, GenX models the capacity reserve margin (aka capacity market) at the time-dependent level, and each constraint either stands for an overall market or a locality constraint.
This file includes the capacity revenue earned by each generator listed in the input file. GenX will print this file only when capacity reserve margin is modeled and the shadow price can be obtained form the solver. Each row corresponds to a generator, and each column starting from the 6th to the second last is the total revenue from each capacity reserve margin constraint. The revenue is calculated as the capacity contribution of each time steps multiplied by the shadow price, and then the sum is taken over all modeled time steps. The last column is the total revenue received from all capacity reserve margin constraints. As a reminder, GenX models the capacity reserve margin (aka capacity market) at the time-dependent level, and each constraint either stands for an overall market or a locality constraint.
This file includes the renewable/clean energy credit price of each modeled RPS/CES constraint. GenX will print this file only when RPS/CES is modeled and the shadow price can be obtained form the solver. The unit is USD/MWh.
This file includes the renewable/clean credit revenue earned by each generator listed in the input file. GenX will print this file only when RPS/CES is modeled and the shadow price can be obtained form the solver. Each row corresponds to a generator, and each column starting from the 6th to the second last is the total revenue earned from each RPS constraint. The revenue is calculated as the total annual generation (if elgible for the corresponding constraint) multiplied by the RPS/CES price. The last column is the total revenue received from all constraint. The unit is USD.
This file includes subsidy revenue earned if a generator specified Min_Cap is provided in the input file. GenX will print this file only the shadow price can be obtained form the solver. Do not confuse this with the Minimum Capacity Carveout constraint, which is for a subset of generators, and a separate revenue term will be calculated in other files. The unit is USD.
This section includes the output files related to specific resource types.
This file includes the capacity output for Allam Cycle LOX resources (GenX.write_allam_capacity).
| Output | Description | Units |
|---|---|---|
| Resource | Name of the Allam Cycle LOX resource | |
| Zone | Zone of the Allam Cycle LOX resource | |
| StartCap_sCO2turbine_MW_gross | Initial power capacity of the sCO2Turbine in the Allam Cycle LOX resource | MW |
| StartCap_ASU_MW_gross | Initial power capacity of the ASU in the Allam Cycle LOX resource | MW |
| StartCap_LOX_t | Initial power capacity of the LOX in the Allam Cycle LOX resource | t |
| RetCap_sCO2turbine_MW_gross | Retired power capacity of the sCO2Turbine in the Allam Cycle LOX resource | MW |
| RetCap_ASU_MW_gross | Retired power capacity of the ASU in the Allam Cycle LOX resource | MW |
| RetCap_LOX_t | Retired power capacity of the LOX in the Allam Cycle LOX resource | t |
| NewCap_sCO2turbine_MW_gross | Installed power capacity of the sCO2Turbine in the Allam Cycle LOX resource | MW |
| NewCap_ASU_MW_gross | Installed power capacity of the ASU in the Allam Cycle LOX resource | MW |
| NewCap_LOX_t | Installed power capacity of the LOX in the Allam Cycle LOX resource | t |
| EndCap_sCO2turbine_MW_gross | Total power capacity of the sCO2Turbine in the Allam Cycle LOX resource | MW |
| EndCap_ASU_MW_gross | Total power capacity of the ASU in the Allam Cycle LOX resource | MW |
| EndCap_LOX_t | Total power capacity of the LOX in the Allam Cycle LOX resource | t |
This file includes the output from each component of an Allam Cycle LOX resource (GenX.write_allam_output).
| Output | Description | Units |
|---|---|---|
| (resource_name)_sCO2Turbine_gross_power_output_mw | Hourly gross power output of the sCO2Turbine in the Allam Cycle LOX resource | MW |
| (resource_name)_sco2turbine_commit | Hourly unit commit status of the sCO2Turbine in the Allam Cycle LOX resource | |
| (resource_name)_ASU_gross_power_output_mw | Hourly gross power consumption of the ASU in the Allam Cycle LOX resource | MW |
| (resource_name)_asu_commit | Hourly unit commit status of the ASU in the Allam Cycle LOX resource | |
| (resource_name)_net_power_output_mw | Hourly net power output of the Allam Cycle LOX resource | MW |
| (resource_name)_storage_lox_t | Hourly status of charge of the LOX in the Allam Cycle LOX resource | t |
| (resource_name)_lox_in_t | Hourly amount of liquid oxygen charged into the LOX in the Allam Cycle LOX resource | t |
| (resource_name)_lox_out_t | Hourly amount of liquid oxygen discharged from the LOX in the Allam Cycle LOX resource | t |
| (resource_name)_gox_t | Hourly amount of gaseous oxygen produced by ASU in the Allam Cycle LOX resource | t |