GitHub

Visualizing Output Data

POMATWO supports different visualizations to analyze the model results.

Interactive Plots

plot_market_interactive(results; time_horizon=nothing, scalefactor=1/1000, kind=:DA)

Creates an interactive plot for visualizing market results by zone, including generation dispatch, load, and price curves.

Arguments

  • results: A data structure containing DA market simulation results (typically a DataFiles struct).
  • time_horizon: (optional, keyword) A range of time steps (hours) to plot. If not provided, uses the entire time range in results.GEN.
  • scalefactor: (optional, keyword, default: 1/1000) A scaling factor for power values (e.g., from MW to GW).
  • kind: (optional, keyword, default: :DA) Specify what market stage should be visualized. Currently supported are :DA for Day-Ahead and :REDISP for Redispatch.

Interactivity

  • Dropdown menu to select market zone.
  • Plot updates automatically to show:
    • Generation dispatch (per technology)
    • Load curve
    • Day-ahead price curve
  • Dual y-axes for power (GW) and price (EUR/MWh).

Returns

  • fig: An interactive plot figure (Makie.Figure) for display or saving.

Example

fig = plot_market_interactive(results)

plot_DA_w_Redisp_interactive(results; time_horizon = nothing, scalefactor = 1/1000)

Creates an interactive, comparative visualization of Day-Ahead (DA) and Redispatch market results by zone, showing generation, load, and prices before and after redispatch. This function enables side-by-side analysis of how redispatch alters zonal dispatch and market prices.

Arguments

  • results: Data structure containing Day-Ahead and redispatch simulation results (typically a DataFiles struct).
  • time_horizon: (optional, keyword) Range of time steps (hours) to plot. Defaults to the full time range in results.GEN.
  • scalefactor: (optional, keyword, default: 1/1000) Factor to scale power values (e.g., MW to GW).

Interactivity

  • Dropdown menu to select the market zone.
  • The plot consists of two subplots:
    • Top subplot: Generation, load, and prices after redispatch (reflecting resolved network constraints).
    • Bottom subplot: Generation, load, and prices in the Day-Ahead market (as originally scheduled).
  • Dual y-axes for both power (GW) and price (EUR/MWh).
  • Plots update interactively when the selected zone changes.

Returns

  • fig: The interactive plot (Makie.Figure) ready for display or saving.

Example

using GLMakie, Tyler, ColorSchemes
fig = plot_DA_w_Redisp_interactive(results)

plot_total_gen_interactive(results::DataFiles)

Create an interactive bar plot of total generation by category for a selected kind and zone.

This function displays an interactive Makie figure with two dropdown menus: one for selecting the generation kind (e.g., day-ahead, redispatch, etc.) and one for selecting the zone. The bar plot updates automatically to reflect the selected kind and zone, showing total generation per category in GWh with category-specific colors.

Arguments

  • results: The results data structure containing generation data, available kinds, zones, and category colors.

Returns

  • Figure: A Makie Figure object with the interactive bar plot and dropdown menus.

Example

using GLMakie, Tyler, ColorSchemes
fig = plot_total_gen_interactive(results)

Static Plots

create_lineplot(results_path, data, type="max", exclude_dc_lines=false, threshhold=0.95)

Creates a geographical network map showing transmission line utilization with color-coded lines based on either maximum utilization frequency or average utilization.

Arguments

  • results_path: Path to the directory containing simulation results.
  • data: A dictionary containing file paths for required network data tables (see section Input Data Load).
  • type: (optional, default: "max") Visualization mode:
    • "max": Color lines by the count of timesteps where utilization >= threshhold.
    • "avg": Color lines by the average utilization across all timesteps.
  • exclude_dc_lines: (optional, default: false) If true, only AC lines are visualized.
  • threshhold: (optional, default: 0.95) Utilization threshold (0-1 scale) for "max" mode counting.

Plot Details

  • Lines are colored using the ColorSchemes.lajolla colormap.
  • Max mode: Colorbar shows the count of hours where line utilization exceeds the threshold.
  • Avg mode: Colorbar shows average utilization percentage (0-100%).
  • Network nodes are displayed as black points.
  • Uses geographical coordinates with Web Mercator projection.

Returns

  • fig: A Makie figure object with the network map, color-coded lines, and colorbar.

Example

using GLMakie, Tyler, ColorSchemes

datafiles = Dict{Symbol,String}(
    :plants => joinpath(datapath, "plants.csv"),
    :nodes => joinpath(datapath, "nodes.csv"),
    :zones => joinpath(datapath, "zones.csv"),
    :lines => joinpath(datapath, "lines.csv"),
    :dclines => joinpath(datapath, "dclines.csv"),
    :demand => joinpath(datapath, "nodal_load.csv"),
    :types => joinpath(datapath, "planttypes.csv"),
)
results_path = "path/to/results"

# Visualize lines by max utilization frequency
fig = create_lineplot(results_path, datafiles, "max", false, 0.95)

# Visualize lines by average utilization
fig = create_lineplot(results_path, datafiles, "avg")

plot_market_statistics(results::DataFiles, zone::String="DE"; save_path=nothing)

Create a comprehensive multi-panel visualization of market statistics for a specified zone.

Generates a 3×3 grid figure displaying time series, distribution histograms, box plots, and summary statistics for exchange flows, lost load events, and market prices. The visualization provides both temporal dynamics and statistical distributions of key market parameters.

Arguments

  • results::DataFiles: DataFiles object containing model results with EXCHANGE and ZonalMarketBalance data.
  • zone::String="DE": Zone identifier for which to create visualizations. Defaults to "DE".
  • save_path=nothing: (keyword) Optional file path to save the figure (e.g., "market_stats.png"). If nothing, the figure is not saved to disk.

Plot Layout

The figure consists of a 3×3 grid:

  • Row 1 - Time Series:

    • Exchange flow over time (MW)
    • Lost Load events over time (MW)
    • Market prices over time (€/MWh)

  • Row 2 - Distributions:

    • Exchange histogram with mean line
    • Lost Load histogram with mean line
    • Price histogram with mean line

  • Row 3 - Statistical Summary:

    • Box plots of all three parameters (Z-score normalized for comparability)
    • Text summary panel with key statistics (mean, median, std, min, max, sum, event count)

Returns

  • Figure: A Makie Figure object (1800×1200 pixels) containing all visualization panels.

Notes

  • Time series use sequential indices to avoid gaps in visualization.
  • Box plots are Z-score normalized to enable comparison across different scales.
  • Colors are consistent across all panels: steelblue (Exchange), coral (Lost Load), mediumseagreen (Price).
  • If save_path is provided, the figure is saved and a confirmation message is printed.

Example

using GLMakie, Tyler, ColorSchemes

results = DataFiles("path/to/results")

# Display the figure interactively
fig = plot_market_statistics(results, "DE")

# Save to file
fig = plot_market_statistics(results, "FR"; save_path="france_market_stats.png")