pydynamicestimator.config

Attributes

IntegrationSchemaEst

IntegrationSchemeSim

Frequency

Filter

Levels

config

Classes

Config

Configuration class used to store all relevant attributes for the execution of

Module Contents

pydynamicestimator.config.IntegrationSchemaEst
pydynamicestimator.config.IntegrationSchemeSim
pydynamicestimator.config.Frequency
pydynamicestimator.config.Filter
pydynamicestimator.config.Levels
class pydynamicestimator.config.Config(/, **data: Any)[source]

Bases: pydantic.BaseModel

Configuration class used to store all relevant attributes for the execution of simulation and estimation.

Parameters:

data (Any)

testsystemfile: str
fn: Frequency
Sb: int
ts: float
te: float
T_start: float
T_end: float
filter: Filter
int_scheme: IntegrationSchemaEst
int_scheme_sim: IntegrationSchemeSim
init_error_diff: float
init_error_alg: bool
plot: bool
plot_voltage: bool
plot_diff: bool
proc_noise_alg: float
proc_noise_diff: float
incl_lim: bool
log_level: Levels
updated(**kwargs: Any) Config[source]

All keyword arguments listed below are optional and can be used to customize the configuration.

Parameters:
  • testsystemfile (str) – The path to the system test case.

  • fn (float) – System frequency (currently only tested for 50 Hz).

  • Sb (float) – Base power of the grid in [MW]. Line parameters are assumed to be calculated using this base power.

  • ts (float) – Simulation time step.

  • te (float) – Estimation time step. Must be greater than or equal to the simulation time step.

  • T_start (float) – Estimation start time (must currently be 0).

  • T_end (float) – End time of the simulation/estimation.

  • int_scheme (str) – Integration scheme for the estimation. Must be ‘trapezoidal’ or ‘backward’.

  • init_error_diff (float) – Estimation initialization error for differential states. E.g., 1.0 corresponds to 10% error.

  • init_error_alg (bool) – Whether to use a flat start (True) or true values (False) for initialization.

  • plot (bool) – Enable or disable plotting.

  • plot_voltage (bool) – Whether to plot voltage data.

  • plot_diff (bool) – Whether to plot differential state data.

  • proc_noise_alg (float) – Process noise for the algebraic equations. Default is 1e-3.

  • proc_noise_diff (float) – Process noise for the differential equations. Default is 1e-4.

  • incl_lim (bool) – If state limiters should be included in the simulation and the estimation. If False, the simulation will be much faster.

  • kwargs (Any)

Returns:

A new instance of the Config class configured with the provided parameters.

Return type:

Config

get_log_level()[source]

Returns the log level.

pydynamicestimator.config.config