Skip to content

3.3. Event Types

Jump to bottom
Julius Susanto edited this page Mar 21, 2015 · 7 revisions

The following event types are available in PYPOWER-Dynamics (sorted in alphabetical order):

CLEAR_FAULT

Clears a fault on a bus. The CLEAR_FAULT event takes one parameter:

  • Bus Row Number is the PYPOWER bus row number (i.e. array position) that the fault will be cleared at. Note that arrays start from row 0.

For example:

1.2, CLEAR_FAULT, 0

In the example above, the fault on the bus at row 0 is cleared at t=1.2s.

FAULT

Three-phase fault on a bus. The FAULT event takes three parameters:

  • Bus Row Number is the PYPOWER bus row number (i.e. array position) that the fault will initiated at. Note that arrays start from row 0.
  • Rf is the fault resistance in pu. A negative value indicates infinite fault resistance.
  • Xf is the fault reactance in pu. A negative value indicates infinite fault reactance.

For example:

1.0, FAULT, 1, -1, 0.1

In the example above, a fault is initiated on the bus at row 1 at t=1.0s with a fault impedance of Zf = Inf - j0.1pu.

LOAD

Add or subtract a constant admittance load onto a bus. The LOAD event takes three parameters:

  • Bus Row Number is the PYPOWER bus row number (i.e. array position) that the fault will initiated at. Note that arrays start from row 0.
  • Pl is the load active power in MW.
  • Ql is the load reactive power in MVAr.

For example:

1.0, LOAD, 1, 10, 6

In the example above, a load of S = 10MW + j6MVAr is added onto the bus at row 1 at t=1.0s.

SIGNAL

Change the value of a signal. The SIGNAL event takes three parameters:

  • Element ID is the unique element identifier
  • Signal Name is the name of the signal to change
  • Value is the new value for the signal

For example:

1.0, SIGNAL, GEN1, Pm, 0.5

In the example above, the signal Pm (mechanical power) of machine GEN1 is changed to 0.5 at t=1s.

STATE

Change the value of a state variable. The STATE event takes three parameters:

  • Element ID is the unique element identifier
  • State Name is the name of the state variable to change
  • Value is the new value for the state variable

For example:

2.0, STATE, GEN1, omega, 1.01

In the example above, the state variable omega (frequency) of machine GEN1 is changed to 1.01 at 2=1s.

TRIP_BRANCH

Trips a line or transformer. The TRIP_BRANCH event takes one parameter:

  • Branch Number is the PYPOWER branch number that will be tripped. Note that branches are numbered according to their array position in PYPOWER and not associated bus numbers (PYPOWER does not have other unique identifiers for branches).

For example:

1.2, TRIP_BRANCH, 1

In the example above, branch number 1 is tripped at t=1.2s.

Clone this wiki locally