Capacity Output

Contents

Overview | Columns | Variable Types | Configuration | Assumptions | Examples | See Also

Overview

File: capacity.csv

capacity.csv records the capacity of every edge and storage component in the system after the optimization. For each component, five capacity variables are reported: total optimal capacity, new capacity added in this period, capacity retired, capacity retrofitted, and existing (pre-installed) capacity at the start of the period.

This is one of the most important output files. Capacity decisions are the primary investment variables in Macro — the flows and costs all depend on the capacity choices made here.

The file uses long format by default: every (component, variable) combination occupies one row. However, to facilitate easier analysis of capacity breakdowns, an optional wide format pivots the variable column into separate columns for each capacity type (total, new, retired, existing, retrofitted).

Columns

Variable Types

The variable column takes one of five values, all reported for each component in the same file:

Configuration

Assumptions

• Units follow whatever unit system you define in your inputs. The default assumption in the Macro documentation is MW for power capacity and MWh for energy storage capacity. Capacity is reported per component (edge or storage), not per asset. A single asset may contain multiple components with separate capacity rows.
• Components without capacity — components with has_capacity = false are excluded from the output. Only components where has_capacity = true appear in capacity.csv. All storage components are always included (all storages have capacity variables by definition).
• Multi-period models — each period's results_period_N/ directory contains capacity values reflecting the capacity available during that planning period. Per the multi-period accounting assumptions, new capacity comes online at the beginning of a period. existing_capacity reflects the carry-over from the previous period, and new_capacity reflects investments made during period N.
• Single-period models — existing_capacity is the user-specified existing_capacity from the input data. capacity = existing_capacity + new_capacity - retired_capacity.
• Capacity is reported per component, not per asset. An asset such as a Battery will produce rows for each of its edges (charge, discharge) and its storage component separately. Especially for symmetric battery systems, users interested in the total installed battery capacity should typically look at the storage component or the discharge edge.

Examples

Default Long Format

Wide Format (OutputLayout.Capacity = "wide")

Writing Capacity Programmatically

• write_capacity allows you to write capacity data to a custom file path, with optional filters for commodity, asset type, or component type. This is useful for exporting subsets of the capacity data or for writing to a different location.
• get_optimal_capacity returns the capacity data as a DataFrame without writing a file. This is useful for programmatic access to capacity values within Julia.

# After solving:
(case, model) = solve_case(case_path, optimizer)

# Export capacity for a specific period/system
system = case.systems[1];
write_capacity("my_capacity.csv", system)

# Export only electricity capacity
write_capacity("elec_capacity.csv", system, commodity="Electricity")

# Export only Battery and VRE assets
write_capacity("storage_vre.csv", system, asset_type=["Battery", "VRE"])

# Get capacity as a DataFrame (no file written)
df = get_optimal_capacity(system)

See Also

• Outputs Overview — overview of all output files and settings
• Costs Output — investment and O&M costs associated with capacity decisions
• Financial Assumptions — how investment costs are annualized from CAPEX
• Multi-Period Accounting — how capacity evolves across planning periods
• Edges — edge investment parameters (can_expand, existing_capacity, etc.)
• Storage — storage investment parameters