Simulations or Fault Scenarios
After having defined a PowerGrid
a simulation can be run.
Currently PowerDynamics supports the following fault/simulation types:
A specific scenario can be simulated for a given powergrid using the simulate
function
PowerDynamics.simulate
— Functionsimulate(p::ChangeInitialConditions, powergrid, x0; timespan)
Simulates a ChangeInitialConditions
simulate(np::AbstractPerturbation, powergrid, x1, timespan)
Simulates a AbstractPerturbation
Detailed Simulation/ Fault Type Documentation
Change Initial Conditions
PowerDynamics.ChangeInitialConditions
— TypeChangeInitialConditions(;node,var,f)
Keyword Arguments
node
: number of the nodevar
: symbol of the variable to be perturbatedf
: function for mapping the variable x to the perturbated value
AbstractPertubation
types
PowerDynamics.AbstractPerturbation
— TypeAbstractPerturbation(;)
An AbstractPerturbation can be uses to construct almost any type of perturbation that has a time span of a fault. Perturbations that are of type of AbstractPerturbation can use the same simulate function then. For example implementations of faults as type AbstractPerturbation see e.g. PowerPerturbation.
Keyword Arguments
tspan_fault
: number of the node
PowerDynamics.LineFailure
— TypeLineFailure(;line_name,tspan_fault)
The arguments line_name
and tspan_fault
specify the line that should be disconnected from the grid and the respective fault duration. For a list of lines the line_name is the index and for an OrderedDict it is the key of the line.
PowerDynamics.NodeParameterChange
— TypeNodeParameterChange(;node, value, tspan_fault, var)
Keyword Arguments
node
: number or name of the nodevalue
: value of power during fault eventtspan_fault
: PowerPerturbation timespanvar
: symbol of parameter that is perturbed
PowerDynamics.NodeShortCircuit
— Type NodeShortCircuit(;node,Y,tspan_fault)
Keyword Arguments
node
: number or name of the nodeY
: admittance of the short circuittspan_fault
: short circuit timespan
Optional Keyword Arguments
var
: symbol of the shunt admittance, default::Y_n
PowerDynamics.PowerPerturbation
— TypePowerPerturbation(;node_number,fault_power,tspan_fault,var)
Keyword Arguments
node_number
: number or name of the nodefault_power
: value of power during fault eventtspan_fault
: PowerPerturbation timespanvar
: parameter symbol on the node that represents Power, default is :P
LineFault
Deprecated! Use LineFailure
instead!