generation#

popo.risk.generation(dss, customers, penetration, profile, rng, kv, horizon, limits=None, sizing=None, start_step=0, step_minutes=30, volt_var=None, volt_watt=None)#

Fit rooftop solar to a share of customers and report each customer’s voltage risk.

Parameters:
  • dss (Any) – An opendssdirect module with a compiled circuit, loads already shaped.

  • customers (Sequence[tuple[str, str]]) – (load name, bus) pairs eligible for installation.

  • penetration (float) – Share of customers fitted, in [0, 1].

  • profile (ndarray) – Generation per kWp at each interval (see popo.scenarios.attach_generation()).

  • rng (Generator) – Seeded generator choosing the customers.

  • kv (float) – Service voltage of the connection.

  • horizon (int) – Number of steps to solve.

  • limits (VoltageLimits | None) – Band events are counted against; EN 50160 by default.

  • sizing (ArraySizing | None) – Array size distribution.

  • start_step (int) – Step offset at which to begin.

  • step_minutes (int) – Length of one step.

  • volt_var (VoltVarCurve | None) – Reactive characteristic of the inverters; None leaves them at unity power factor.

  • volt_watt (VoltWattCurve | None) – Active-power curtailment of the inverters; with volt_var, both are installed as one control, as AS/NZS 4777.2 requires.

Return type:

DataFrame

Returns:

One row per customer – load, bus, pv (whether it holds an array), v_max_pu and the rest of popo.standards.VoltageLimits.event_summary()’s columns.