Source code for x2power.utilities.plant_plotting
"""Optional Matplotlib figures for continuous biogas-plant ledgers."""
from collections.abc import Sequence
from x2power.methods.biogas_plant import PlantResult
[docs]
def plot_biogas_plant(results: Sequence[PlantResult], *, title: str = "Biogas plant"):
"""Plot interval-average flows/powers and gas inventory at interval boundaries.
Storage is an inventory; the other panels show rates, not interval totals.
Import is positive in the electrical panel and reported separately from net power.
"""
from matplotlib.figure import Figure
if not results:
raise ValueError("Cannot plot an empty plant simulation")
edges = [0.0]
for result in results:
edges.append(edges[-1] + result.power.duration_h)
figure = Figure(figsize=(11, 10), layout="constrained")
axes = figure.subplots(4, 1, sharex=True)
series = (
("biogas_captured_nm3", "Captured", "#2f6fdb"),
("biogas_to_chp_nm3", "CHP", "#008577"),
("biogas_flared_nm3", "Flare", "#d97706"),
)
for key, label, color in series:
values = [float(r.metrics[key] or 0) / r.power.duration_h for r in results]
axes[0].stairs(values, edges, label=label, color=color)
axes[0].set_ylabel("Biogas (Nm³/h)")
axes[1].stairs([r.power.net_power_kw for r in results], edges, label="Plant net electricity")
for key, label in (("grid_export_kwh", "Grid export"), ("grid_import_kwh", "Grid import")):
axes[1].stairs(
[float(r.metrics[key] or 0) / r.power.duration_h for r in results], edges, label=label
)
axes[1].set_ylabel("Electricity (kW)")
inventory = [float(results[0].metrics["initial_stored_biogas_nm3"] or 0)]
inventory.extend(r.state.stored_biogas_nm3 for r in results)
axes[2].plot(edges, inventory, label="Gas holder", color="#008577")
axes[2].set_ylabel("Stored biogas (Nm³)")
for key, label in (
("recovered_heat_kwh", "CHP recovered heat"),
("process_heat_demand_kwh", "Digester heat demand"),
("electric_heating_kwh", "Backup heater electricity"),
):
axes[3].stairs(
[getattr(r.power, key) / r.power.duration_h for r in results], edges, label=label
)
axes[3].set_ylabel("Heat / input power (kW)")
axes[3].set_xlabel("Elapsed time (h)")
for axis in axes:
axis.legend(loc="upper left", ncol=3, fontsize=8)
axis.grid(alpha=0.2)
figure.suptitle(title)
return figure