.. _test_cases:

Test Cases
==========


The existing power system test cases are stored in `./pydynamicestimator/test cases <https://gitlab.nccr-automation.ch/mkatanic/powerdynamicestimator/-/tree/main/pydynamicestimator/testcases?ref_type=heads>`_
subfolder. The list of current examples includes:

- :ref:`IEEE39_bus`
- :ref:`IEEE39_bus_ideal`


.. _IEEE39_bus:

IEEE39_bus
----------

The IEEE39 bus test case is shown in Figure 1. The bolded areas are included in the estimation, whereas the grayed out
areas are only used to generate ground-truth values for validating
the performance. The topology, parameters and dynamic models of grayed out areas are inaccessible to the estimator.
The topology and parameters of the bolded part of the system is known.
All loads consumptions are unknown/inaccessible to the estimator.

SIMULATION DATA

Used dynamic models for simulation (ground-truth) values:
    - Subtransient synchronous generators

Simulated disturbances:
    - Short circuit on branch 5-8 (t = 7.00 s)
    - Short circuit cleared by opening the branch on both ends (t = 7.04 s)
    - Load change at node 5 (t = 9.00 s)


ESTIMATION DATA

Used models for estimation:
    - Transient synchronous generators

Disturbances known to the estimator:
    - None

Available phasor measurements:

The following buses are equipped with voltage phasor measurements:
    - Bus 16
    - Bus 23
    - Bus 34
    - Bus 21

The following branches are equipped with current phasor measurements:
    - Bus 16 - Bus 19
    - Bus 16 - Bus 24
    - Bus 22 - Bus 23



.. figure:: _static/39network.png
   :alt: Example PDF Page 1
   :width: 600px

   Figure 1: IEEE_39bus.


.. _IEEE39_bus_ideal:

IEEE39_bus_ideal
----------------

This test case is very similar to the previous one except that all modeling errors and process and measurement noises are set to zero. The purpose of this model is mostly for functional testing to verify is the estimator produces
perfect estimation in perfect conditions.

.. _examples_git: https://www.python.org