1.4. Disturbance description

The following options change how a pre-defined scenario is described and used. These should be added to a dst file and loaded to the simulation cases through pyramses.case.addDst. For instance:

import pyramses
case = pyramses.cfg()
case.addDst('short_circ.dst')

If you are looking how to put distrubance description in an interactive manner, please check pyramses.sim.Disturb.

time CONTINUE SOLVER disc_meth max_h min_h latency upd_over

Sets the parameters for the simulation.

Parameters
  • time (float (seconds)) – Time of the event

  • disc_meth (str) – Discretization method: TR: Trapezoidal, BE: Backward Euler, BD: BDF2

  • max_h (float (seconds)) – Maximum time-step

  • min_h (float (seconds)) – Minimum time-step

  • latency (float (per-unit)) – Latency tolerance (default: 0.0). Parameters for latency [AFC14].

  • upd_over (str) – Jacobian update override ALL: Update all injectors and network, NET: Update only network, ABL: Update only injectors, IBL: Update all injectors and network, NOT: Do not override

time STOP

Stops the simulation. It needs to be always the last command in a file.

Parameters

time (float (seconds)) – Time of the event

time BREAKER BRANCH name_of_line orig_break extrem_break

Trip a line or transformer.

Parameters
  • time (float (seconds)) – Time of the event

  • name_of_line (str) – Name of line or transformer.

  • orig_break (binary (0/1 for no/yes)) – Trip the origin of the line.

  • extrem_break (binary (0/1 for no/yes)) – Trip the extremity of the line.

time BREAKER SYNC_MACH name_of_synch_mach breaker

Trip a generator.

Parameters
  • time (float (seconds)) – Time of the event

  • name_of_synch_mach (str) – Name of generator.

  • breaker (binary (0/1 for no/yes)) – Trip the generator.

time BREAKER INJ name_of_inj breaker

Trip an injector.

Parameters
  • time (float (seconds)) – Time of the event

  • name_of_inj (str) – Name of injector.

  • breaker (binary (0/1 for no/yes)) – Trip the injector.

time FAULT BUS name_of_bus rfault xfault

Apply 3-phase short-circuit to bus. Applying a fault to a line requires to create a virtual bus splitting the line and apply the fault on that virtual bus.

It has to be followed by the command CLEAR BUS (see below).

Parameters
  • time (float (seconds)) – Time of the event

  • name_of_bus (str) – Name of bus.

  • rfault (float) – Resistance of fault in Ohms. 0 for solid short-circuit.

  • xfault (float) – Reactance of fault in Ohms. 0 for solid short-circuit.

time CLEAR BUS name_of_bus

Clears 3-phase short-circuit to bus. It has to be followed by the command FAULT BUS (see above).

Parameters
  • time (float (seconds)) – Time of the event

  • name_of_bus (str) – Name of bus.

time LFRESV name_of_filename

Export the power flow solution at a specific point in time.

Parameters
  • time (float (seconds)) – Time of the event

  • name_of_filename (str) – Name of output file.