From GridLAB-D Wiki
Jump to: navigation, search


Application Concept

The fault_study object will be used to automatically collect information from a list of objects. It will display in a single location the results of a short circuit study applied to each of the devices within the list.

Use Case

A user would like to know the short circuit current at each location within a feeder to identify placement of new protection equipment. The user requires a tabulated output of all the short circuit currents for each type of fault.

General Requirements

The fault_study object will collect and tabulate all of the available short circuit current and produce them into a tabulated output.


The object will collect the short circuit results from a system.


By default, the object will collect all fault types.


Users will have the option to select a particular fault, rather than all faults.


The object will produce a CSV file that contains fault type, name of object, and faults currents a double format (real/imaginary & magnitude/angle).


The user will have the option to produce the results in polar or rectangular coordinates. Polar will be the default.


The object will allow users to set the positive and zero sequence impedance of the voltage source. By default, this will be zero.


The source impedance will be three-phase balanced, as implied by the sequence components.


The user will be able to set the runtime of the fault study.


If not set, the default runtime will be immediately following the first timestep.

See also