Phasor Dynamics

Root elements

Name	Value
`system_model_file`	Path to the system model file[1]
`dt_monitor`	Monitor output time interval for recorded simulation results (default: 0, no intermediate monitoring)
`tmax`	A floating-point value for max time
`rel_tol`	Relative solver tolerance (default: 1.0e-7)
`abs_tol`	Absolute solver tolerance override (default: 1.0e-9)
`dt_fixed`	Fixed solver time step size, or 0 for adaptive stepping (default: 0)
`max_steps`	Maximum number of solver time steps, 0 for the IDA default, or a negative number for unlimited steps (default: 0)
`max_order`	Maximum IDA integration method order from 1 to 5 (default: 5; fixed stepping is capped at 2)
`consistent_ic_type`	IDA consistent initial condition calculation type; one of { “y”, “ya_ydp” } (default: “ya_ydp”)
`events`	An array of event groups (see Events below)
`output_file`	Path to output (CSV) file (optional)
`reference_file`	A string containing the name of the case (optional)
`error_type`	One of { “relative” (default), “absolute” }
`error_tolerance`	A floating-point value for highest allowable total error (default: 1.0e-4)
`abs_err_threshold`	A floating-point value for the smallest value at which to scale relative error (default: machine epsilon for double-precision)

Each event group describes a system event that occurs at a given time point

Name	Value
`time`	A floating point value for time event occurs
`type`	Event type (one of { “fault_on”, “fault_off”, “in_service”, “out_of_service” })
`bus`	Number of the faulted bus (omitted for `ContingencyAnalysis`, which faults every bus in turn using the same `R` and `X`)
`R`	Fault resistance in per unit (required for “fault_on”)
`X`	Fault reactance in per unit (required for “fault_on”)
`device`	`id` of the branch to put in service (“in_service”) or take out of service (“out_of_service”)