State Estimation
The module provides a state estimation for pandapower networks.
Theoretical Background
State Estimation is a process to estimate the electrical state of a network by eliminating inaccuracies and errors from measurement data. Various measurements are placed around the network and transferred to the operational control center via SCADA. Unfortunately measurements are not perfect: There are tolerances for each measurement device, which lead to an inherent inaccuracy in the measurement value. Analog transmission of data can change the measurement values through noise. Faulty devices can return completely wrong measurement values. To account for the measurement errors, the state estimation processes all available measurements and uses a regression method to identify the likely real state of the electrical network. The output of the state estimator is therefore a set of voltage absolutes and voltage angles for all buses in the grid. The input is the network in pandapower format and a number of measurements.
Amount of Measurements
There is a minimum amount of required measurements necessary for the regression to be mathematically possible. Assuming the network contains \(n\) buses, the network is then described by \(2n\) variables, namely \(n\) voltage absolute values and \(n\) voltage angles. A slack bus serves as the reference, its voltage angle is set to zero or the value provided in the corresponding net.ext_grid.va_degree entry (see init parameter) and is not altered in the estimation process. The voltage angles of the other network buses are relative to the voltage angles of the connected slack bus. The state estimation therefore has to find \(2nk\) variables, where \(k\) is the number of defined slack buses. The minimum amount of measurements \(m_{min}\) needed for the method to work is therefore:
\(m_{min} = 2nk\)
To perform well however, the number of redundant measurements should be higher. A value of \(m \approx 4n\) is often considered reasonable for practical purposes.
Standard Deviation
Since each measurement device may have a different tolerance and a different path length it has to travel to the control center, the accuracy of each measurement can be different. Therefore each measurement is assigned an accuracy value in the form of a standard deviation. Typical measurement errors are 1 % for voltage measurements and 13 % for power measurements.
For a more indepth explanation of the internals of the state estimation method, please see the following sources:
See also
Power System State Estimation: Theory and Implementation by Ali Abur, Antonio Gómez Expósito, CRC Press, 2004.
State Estimation in Electric Power Systems  A Generalized Approach by A. Monticelli, Springer, 1999.
Defining Measurements
Measurements are defined via the pandapower “create_measurement” function. There are different physical properties, which can be measured at different elements. The following lists and table clarify the possible combinations.
Types of Measurements
“v” for voltage measurements (in perunit)
“p” for active power measurements (in MW)
“q” for reactive power measurements (in MVar)
“i” for electrical current measurements at a line (in kA)
Element Types
“bus” for bus measurements
“line” for line measurements
“trafo” for transformer measurements
“trafo3w” for threewindingtransformer measurements
Available Measurements per Element
Element Type 
Available Measurement Types 

bus 
v, p, q 
line 
i, p, q 
trafo 
i, p, q 
trafo3w 
i, p, q 
The “create_measurement” function is defined as follows:
 pandapower.create.create_measurement(net, meas_type, element_type, value, std_dev, element, side=None, check_existing=True, index=None, name=None, **kwargs)
Creates a measurement, which is used by the estimation module. Possible types of measurements are: v, p, q, i, va, ia
 INPUT:
meas_type (string)  Type of measurement. “v”, “p”, “q”, “i”, “va”, “ia” are possible
element_type (string)  Clarifies which element is measured. “bus”, “line”, “trafo”, and “trafo3w” are possible
value (float)  Measurement value. Units are “MW” for P, “MVar” for Q, “p.u.” for V, “kA” for I. Bus power measurement is in load reference system, which is consistent to the rest of pandapower.
std_dev (float)  Standard deviation in the same unit as the measurement
element (int)  Index of the measured element (either bus index, line index, trafo index, trafo3w index)
side (int, string, default: None)  Only used for measured lines or transformers. Side defines at which end of the branch the measurement is gathered. For lines this may be “from”, “to” to denote the side with the from_bus or to_bus. It can also the be index of the from_bus or to_bus. For transformers, it can be “hv”, “mv” or “lv” or the corresponding bus index, respectively
 OPTIONAL:
check_existing (bool, default: None)  Check for and replace existing measurements for this bus, type and element_type. Set it to false for performance improvements which can cause unsafe behavior
index (int, default: None)  Index of the measurement in the measurement table. Should not exist already.
name (str, default: None)  Name of measurement
 OUTPUT:
(int) Index of measurement
 EXAMPLES:
2 MW load measurement with 0.05 MW standard deviation on bus 0: create_measurement(net, “p”, “bus”, 0, 2., 0.05.)
4.5 MVar line measurement with 0.1 MVar standard deviation on the “to_bus” side of line 2 create_measurement(net, “q”, “line”, 2, 4.5, 0.1, “to”)
Running the State Estimation
The state estimation can be used with the wrapper function “estimate”, which prevents the need to deal with the state_estimation class object and functions. It can be imported from “estimation.state_estimation”.
 pandapower.estimation.estimate(net, algorithm='wls', init='flat', tolerance=1e06, maximum_iterations=10, calculate_voltage_angles=True, zero_injection='aux_bus', fuse_buses_with_bb_switch='all', **opt_vars)
Wrapper function for WLS state estimation.
 INPUT:
net (pandapowerNet)  The net within this line should be created
init (string)  Initial voltage for the estimation. ‘flat’ sets 1.0 p.u. / 0° for all buses, ‘results’ uses the values from res_bus if available and ‘slack’ considers the slack bus voltage (and optionally, angle) as the initial values. Default is ‘flat’
 OPTIONAL:
tolerance (float)  When the maximum state change between iterations is less than tolerance, the process stops. Default is 1e6
maximum_iterations (integer)  Maximum number of iterations. Default is 10
calculate_voltage_angles (boolean)  Take into account absolute voltage angles and phase shifts in transformers, if init is ‘slack’. Default is True
zero_injection (str, iterable, None)  Defines which buses are zero injection bus or the method to identify zero injection bus, with ‘wls_estimator’ virtual measurements will be added, with ‘wls_estimator with zero constraints’ the buses will be handled as constraints
“auto”: all bus without p,q measurement, without p, q value (load, sgen…) and aux buses will be identified as zero injection bus
“aux_bus”: only aux bus will be identified as zero injection bus
None: no bus will be identified as zero injection bus
iterable: the iterable should contain index of the zero injection bus and also aux bus will be identified as zeroinjection bus
fuse_buses_with_bb_switch (str, iterable, None)  Defines how buses with closed bb switches should be handled, if fuse buses will only fused to one for calculation, if not fuse, an auxiliary bus and auxiliary line will be automatically added to the network to make the buses with different p,q injection measurements identifieble
“all”: all buses with bbswitches will be fused, the same as the default behaviour in load flow
None: buses with bbswitches and individual p,q measurements will be reconfigurated by auxiliary elements
iterable: the iterable should contain the index of buses to be fused, the behaviour is contigous e.g. if one of the bus among the buses connected through bb switch is given, then all of them will still be fused
 OUTPUT:
successful (boolean)  Was the state estimation successful?
Handling of bad data
Note
The bad data removal is not very robust at this time. Please treat the results with caution!
The state estimation class allows additionally the removal of bad data, especially single or noninteracting false measurements. For detecting bad data the Chisquared distribution is used to identify the presence of them. Afterwards follows the largest normalized residual test that identifys the actual measurements which will be removed at the end. Both methods are combined in the perform_rn_max_test function that is part of the state estimation class. To access it, the following wrapper function remove_bad_data has been created.
 pandapower.estimation.remove_bad_data(net, init='flat', tolerance=1e06, maximum_iterations=10, calculate_voltage_angles=True, rn_max_threshold=3.0)
Wrapper function for bad data removal.
 INPUT:
net  The net within this line should be created
init  (string) Initial voltage for the estimation. ‘flat’ sets 1.0 p.u. / 0° for all buses, ‘results’ uses the values from res_bus_est if available and ‘slack’ considers the slack bus voltage (and optionally, angle) as the initial values. Default is ‘flat’
 OPTIONAL:
tolerance  (float)  When the maximum state change between iterations is less than tolerance, the process stops. Default is 1e6
maximum_iterations  (integer)  Maximum number of iterations. Default is 10
calculate_voltage_angles  (boolean)  Take into account absolute voltage angles and phase shifts in transformers, if init is ‘slack’. Default is True
rn_max_threshold (float)  Identification threshold to determine if the largest normalized residual reflects a bad measurement (default value of 3.0)
 OUTPUT:
successful (boolean)  Was the state estimation successful?
Nevertheless the Chisquared test is available as well to allow a identification of topology errors or, as explained, false measurements. It is named as chi2_analysis. The detection’s result of present bad data of the Chisquared test is stored internally as bad_data_present (boolean, class member variable) and returned by the function call.
 pandapower.estimation.chi2_analysis(net, init='flat', tolerance=1e06, maximum_iterations=10, calculate_voltage_angles=True, chi2_prob_false=0.05)
Wrapper function for the chisquared test.
 INPUT:
net  The net within this line should be created.
init  (string) Initial voltage for the estimation. ‘flat’ sets 1.0 p.u. / 0° for all buses, ‘results’ uses the values from res_bus_est if available and ‘slack’ considers the slack bus voltage (and optionally, angle) as the initial values. Default is ‘flat’
 OPTIONAL:
tolerance  (float)  When the maximum state change between iterations is less than tolerance, the process stops. Default is 1e6
maximum_iterations  (integer)  Maximum number of iterations. Default is 10
calculate_voltage_angles  (boolean)  Take into account absolute voltage angles and phase shifts in transformers, if init is ‘slack’. Default is True
chi2_prob_false (float)  probability of error / false alarms (default value: 0.05)
 OUTPUT:
bad_data_detected (boolean)  Returns true if bad data has been detected
Background information about this topic can be sourced from the following literature:
See also
Power System State Estimation: Theory and Implementation by Ali Abur, Antonio Gómez Expósito, CRC Press, 2004.
Power Generation, Operation, and Control by Allen J. Wood, Bruce Wollenberg, Wiley Interscience Publication, 1996.
Example
As an example, we will define measurements for a simple pandapower network net with 4 buses. Bus 4 is outofservice. The external grid is connected at bus 1.
There are multiple measurements available, which have to be defined for the state estimator. There are two voltage measurements at buses 1 and 2. There are two power measurements (active and reactive power) at bus 2. There are also line power measurements at bus 1. The measurements are both for active and reactive power and are located on the line from bus 1 to bus 2 and from bus 1 to bus 3. This yields the following code:
pp.create_measurement(net, "v", "bus", 1.006, .004, bus1) # V at bus 1
pp.create_measurement(net, "v", "bus", 0.968, .004, bus2) # V at bus 2
pp.create_measurement(net, "p", "bus", 501, 10, bus2) # P at bus 2
pp.create_measurement(net, "q", "bus", 286, 10, bus2) # Q at bus 2
pp.create_measurement(net, "p", "line", 888, 8, element=line1, side="from") # P_line (bus 1 > bus 2) at bus 1
pp.create_measurement(net, "p", "line", 1173, 8, element=line2, side="from") # P_line (bus 1 > bus 3) at bus 1
# you can either define the side with a string ("from" / "to") or
# using the bus index where the line ends and the measurement is located
pp.create_measurement(net, "q", "line", 568, 8, element=line1, side=bus1) # Q_line (bus 1 > bus 2) at bus 1
pp.create_measurement(net, "q", "line", 663, 8, element=line2, side=bus1) # Q_line (bus 1 > bus 3) at bus 1
Now that the data is ready, the state_estimation can be initialized and run. We want to use the flat start condition, in which all voltages are set to 1.0 p.u..
success = estimate(net, init="flat")
V, delta = net.res_bus_est.vm_pu, net.res_bus_est.va_degree
The resulting variables now contain the voltage absolute values in V, the voltage angles in delta, an indication of success in success. The bus power injections can be accessed similarly with net.res_bus_est.p_mw and net.res_bus_est.q_mvar. Line data is also available in the same format as defined in res_line.
If we like to check our data for fault measurements, and exclude them in in our state estimation, we use the following code:
success_rn_max = remove_bad_data(net, init="flat")
V_rn_max, delta_rn_max = net.res_bus_est.vm_pu, net.res_bus_est.va_degree
In the case that we only like to know if there is a likelihood of fault measurements (probabilty of fault can be adjusted), the Chisquared test should be performed separatly. If the test detects the possibility of fault data, the value of the added class member variable bad_data_present would be true as well as the boolean variable success_chi2 that is used here:
success_chi2 = chi2_analysis(net, init="flat")
Further Algorithms and Estimators
Since Pandapower 2.0.1 further algorithms and estimators (robust estimators) are available for the state estimation module, these include:
Algorithm 
Available Estimators 

wls (NewtonGauss) 

wls with zero injection constraints 

lp 
lav 
irwls 
wls, shgm 
Scipy Optimization Tool 
wls, lav, ql, qc 
Most of the algorithms and estimators are implemented as explained in the Power System State Estimation: Theory and Implementation by Ali Abur, Antonio Gómez Expósito, CRC Press, 2004. While the QC and QL estimators are adjusted mathematically for a better convergence of scipy optimization tool.
For SHGM: Please see “Robust state estimation based on projection statistics,” IEEE Trans. Power Syst, vol. 11, no. 2, pp. 1118–1127, 1996. by L. Mili, M. Cheniae, N. Vichare, and P. Rousseeuw. The projection statistics was rewritten in Python based on the code published by original authors of the paper.
Example of using extra estimators:
# Using shgm
success = estimate(net, algorithm="irwls", estimator='shgm', a=5)
# Using lav
success = estimate(net, algorithm="lp")
# Using ql
success = estimate(net, algorithm="opt", estimator="ql", a=3)
Note that: The state estimation with Scipy Optimization Tool could collapse in some cases with flat start, it’s suggested to give the algorithm a warm start or try some other optimization’s methods offered by scipy, which preserves the effects of the estimator while helps the convergence.
Example for chained estimation (warm start for SciPy Optimization Tool):
# Initialize eppci for the algorithm which contains pypowergrid,
# measurements and estimated grid state (initial value)
net, ppc, eppci = pp2eppci(net)
# Initialize algorithm
estimation_wls = WLSAlgorithm(1e3, 5)
estimation_opt = OptAlgorithm(1e6, 1000)
# Start Estimation with specified estimator
eppci = estimation_wls.estimate(eppci)
# for some estimators extra parameters must be specified
eppci = estimation_opt.estimate(eppci, estimator="ql", a=3)
# Update the pandapower network with estimated results
net = eppci2pp(net, ppc, eppci)