Time series

A time series is a named profile of multiplicative scale factors that makes a static parameter time-varying. Components reference profiles to model a load shape, a PV generation curve, and so on; a snapshot at a time index multiplies the static parameter by the profile value. This is a data-model page — time series carry no OPF variables or constraints; they transform the input data that the component models then consume. Symbols are defined in Notation.

Data model

time_series

A time_series entry is a named profile.

Referencing a profile

Any component that supports time variation carries a time_series map from a parameter name to a profile id:

"load": {
  "d1": {
    "p_nom": [4000.0], "q_nom": [1000.0], "bus": "b1",
    "configuration": "WYE", "terminal_map": ["a", "n"],
    "time_series": { "p_nom": "residential_shape" }
  }
}

Here the load's p_nom is scaled by the residential_shape profile; unreferenced parameters stay static.

Snapshot semantics

A snapshot at integer time index $\textcolor{red}{\tau}$ replaces each referenced parameter $\textcolor{red}{x}$ by

\[\textcolor{red}{x}[\textcolor{red}{\tau}] = \textcolor{red}{x}\cdot \textcolor{red}{v_{\textcolor{red}{\tau}}},\]

where $\textcolor{red}{v_{\textcolor{red}{\tau}}}$ is the profile's values[τ]. The snapshot is an ordinary static network at that instant — the OPF is then built and solved exactly as documented on the component pages. A time series is therefore a pre-processing transform, never a decision variable, and does not couple time steps (each snapshot is an independent solve).

Implementation in BMOPFTools

• get_snapshot(net, t_index) walks every component's time_series map and multiplies the named static parameter by values[t_index], returning a plain static network.
• The OPF builders (solve_opf, solve_feasibility_opf) accept a t_index argument and snapshot the network before building the model; with the default index the network is used as-is.
• Because a snapshot is a static network, all component models, the objective, and the feasibility relaxation apply unchanged.