Progress Plot Module

class progress.mod_plot.RAPlotTools(main_folder)

Bases: object

Provides plotting tools for visualizing simulation results, including wind and solar generation, state-of-charge (SOC) of ESS, load curtailment, and outage heat maps.

Parameters:

main_folder (str) – The primary directory where plot outputs will be saved.

OutageMap(outage_data)

Plots a heatmap of outage data, typically representing the percentage of load loss across months and hours.

Parameters:

outage_data (str) – Path to a CSV file containing outage percentages, with rows corresponding to months and columns corresponding to hours.

Returns:

None

Return type:

None

Raises:

FileNotFoundError – If the specified CSV file does not exist.

PlotCOV(COV_rec, samples, size)

Plots the Coefficient of Variation (COV) of LOLP across samples.

Parameters:
  • COV_rec (numpy.ndarray) – A 1D NumPy array (length = samples) of COV values computed at each sample.

  • samples (int) – Number of Monte Carlo samples.

  • size (int) – The total number of MPI processes (or 1 if serial execution).

Returns:

None

Return type:

None

PlotLOLP(mLOLP_rec, samples, size)

Plots the running average of the Loss of Load Probability (LOLP) across samples.

Parameters:
  • mLOLP_rec (numpy.ndarray) – A 1D NumPy array (length = samples) of running mean LOLP values.

  • samples (int) – Number of Monte Carlo samples.

  • size (int) – The total number of MPI processes (or 1 if serial execution).

Returns:

None

Return type:

None

PlotLoadCurt(curt_rec)

Plots load curtailment over time.

Parameters:

curt_rec (numpy.ndarray) – A 1D NumPy array (length = hours) of load curtailment values (in MW).

Returns:

None

Return type:

None

PlotSOC(SOC_rec, essname)

Plots state of charge (SOC) of energy storage systems (ESS) over time.

Parameters:
  • SOC_rec (numpy.ndarray) – A 2D NumPy array (shape: (number_of_ESS, hours)) representing the state of charge of each ESS over time.

  • essname (list[str]) – A list of ESS names corresponding to each row in SOC_rec.

Returns:

None

Return type:

None

PlotSolarGen(solar_rec, bus_name)

Plots solar power generation over time.

Parameters:
  • solar_rec (numpy.ndarray) – A 2D NumPy array (shape: (number_of_zones, hours)) of solar power generation values over time.

  • bus_name (list[str]) – A list of bus names corresponding to each row (zone) in solar_rec.

Returns:

None

Return type:

None

PlotWindGen(wind_rec, bus_name)

Plots wind power generation over time.

Parameters:
  • wind_rec (numpy.ndarray) – A 2D NumPy array (shape: (number_of_zones, hours)) of wind power generation values over time.

  • bus_name (list[str]) – A list of bus names corresponding to each row (zone) in wind_rec.

Returns:

None

Return type:

None