Voltage Initializer¶

The voltage_initializer module is a tool to initialize voltage of a network before a loadflow and can prevent divergence.

Run the voltage initializer¶

run(network, params[, debug])

Run voltage initializer on the network with the given params.

VoltageInitializerParameters : How to parameterize the tool¶

`VoltageInitializerParameters`()	Parameters of a voltage initializer run.
`VoltageInitializerParameters.add_variable_shunt_compensators`(...)	Indicate to voltage initializer that the given shunt compensator has a variable susceptance.
`VoltageInitializerParameters.add_constant_q_generators`(...)	Indicate to voltage initializer that the given generator have a constant target reactive power.
`VoltageInitializerParameters.add_variable_two_windings_transformers`(...)	Indicate to voltage initializer that the given 2wt have a variable ratio.
`VoltageInitializerParameters.add_specific_low_voltage_limits`(...)	Indicate to voltage initializer to override the network low voltages limits, limit can be given relative to former limit or absolute.
`VoltageInitializerParameters.add_specific_high_voltage_limits`(...)	Indicate to voltage initializer to override the network high voltages limits, limit can be given relative to previous limit or absolute.
`VoltageInitializerParameters.add_specific_voltage_limits`(limits)	Indicate to voltage initializer to override the network voltages limits.
`VoltageInitializerParameters.set_objective`(...)	If you use BETWEEN_HIGH_AND_LOW_VOLTAGE_LIMIT, you also need to call
`VoltageInitializerParameters.set_objective_distance`(...)	If you use BETWEEN_HIGH_AND_LOW_VOLTAGE_LIMIT, you also need to call this function.
`VoltageInitializerParameters.set_log_level_ampl`(...)	Changes the log level of AMPL printings.
`VoltageInitializerParameters.set_log_level_solver`(...)	Changes the log level of non-linear optimization solver printings.
`VoltageInitializerParameters.set_reactive_slack_buses_mode`(...)	Changes the log level of non-linear optimization solver printings.
`VoltageInitializerParameters.set_min_plausible_low_voltage_limit`(...)	Changes the minimal plausible value for low voltage limits (in p.u.) in ACOPF solving.
`VoltageInitializerParameters.set_max_plausible_high_voltage_limit`(...)	Changes the maximal plausible value for high voltage limits (in p.u.) in ACOPF solving.
`VoltageInitializerParameters.set_active_power_variation_rate`(...)	Changes the weight to favor more/less minimization of active power produced by generators.
`VoltageInitializerParameters.set_min_plausible_active_power_threshold`(...)	Changes the threshold of active and reactive power considered as null in the optimization.
`VoltageInitializerParameters.set_low_impedance_threshold`(...)	Changes the threshold of impedance considered as null.
`VoltageInitializerParameters.set_min_nominal_voltage_ignored_bus`(...)	Changes the threshold used to ignore voltage levels with nominal voltage lower than it.
`VoltageInitializerParameters.set_min_nominal_voltage_ignored_voltage_bounds`(...)	Changes the threshold used to replace voltage limits of voltage levels with nominal voltage lower than it.
`VoltageInitializerParameters.set_max_plausible_power_limit`(...)	Changes the threshold defining the maximum active and reactive power considered in correction of generator limits.
`VoltageInitializerParameters.set_high_active_power_default_limit`(...)	Changes the threshold used for the correction of high active power limit of generators.
`VoltageInitializerParameters.set_low_active_power_default_limit`(...)	Changes the threshold used for the correction of low active power limit of generators.
`VoltageInitializerParameters.set_default_minimal_qp_range`(...)	Changes the threshold used to fix active (resp.
`VoltageInitializerParameters.set_default_qmax_pmax_ratio`(...)	Changes the ratio used to calculate threshold for corrections of high/low reactive power limits.
`VoltageInitializerParameters.set_default_variable_scaling_factor`(...)	Changes the scaling of all variables (except reactive slacks and transformer ratios) before ACOPF solving
`VoltageInitializerParameters.set_default_constraint_scaling_factor`(...)	Changes the scaling factor applied to all the constraints before ACOPF solving
`VoltageInitializerParameters.set_reactive_slack_variable_scaling_factor`(...)	Changes the scaling factor applied to all reactive slacks variables before ACOPF solving
`VoltageInitializerParameters.set_twt_ratio_variable_scaling_factor`(...)	Changes the scaling factor applied to all transformer ratio variables before ACOPF solving

VoltageInitializerResults : How to exploit the results¶

`VoltageInitializerResults`(result_handle)	Results of a voltage initializer run.
`VoltageInitializerResults.apply_all_modifications`(network)	Apply all the modifications voltage initializer found to the network.
`VoltageInitializerResults.status`	If the optimisation failed, it can be useful to check the indicators.
`VoltageInitializerResults.indicators`	Returns: The indicators as a dict of the optimisation