A Fault object is a resistor network that can be configured in a variety of ways. It is nominally designed with the same connection philosophy as the Capacitor. That is, it is a two-terminal device in which the second terminal defaults to ground. This is often what is desired when simulating a fault for short-circuit studies. However, the OpenDSS Fault object may be configured to do much more and can be configured to represent any type of fault. For example, it can be connected between transmission overbuild and distribution underbuild to simulate the transmission falling on the distribution circuit.


A Fault object is a standard linear Power Delivery component, completely defined by its primitive admittance matrix. You can have as many Fault objects on the circuit as you wish (some may cause the power flow solution to diverge – if so, switch to a direct solution or a dynamic solution). For Monte Carlo fault mode (MF) you will distribute Fault objects all over the circuit is some proportion. The solver will enable one at a time for each solution.


Since the Fault object is nothing more than a resistor network, you may use it for purposes other than modeling short circuit faults – anything that requires a resistor model. With the Gmatrix property a very complex resistive network can be modeled. For example, you may wish to represent a fault that has one resistance L-L and another L-ground. Note that it is specified as a nodal conductance matrix.


In time mode simulations such as Dynamics, the initiation of the fault can be delayed (ONtime property) and it will automatically clear itself when the current drops below a certain level (MinAmps property) if the fault is declared to be Temporary.


phases

Number of Phases. Default is 1.

bus1

Name of first bus. Examples: 
bus1=busname
bus1=busname.1.2.3

bus2

Name of 2nd bus. Defaults to all phases connected to first bus, node 0, if not specified. (Shunt Wye to ground connection)

R

Resistance, each phase, ohms. Default is 0.0001. Assumed to be Mean value if gaussian random mode.Max value if uniform mode. A Fault is actually a series resistance that defaults to a wye connection to ground on the second terminal. You may reconnect the 2nd terminal to achieve whatever connection. Use the Gmatrix property to specify an arbitrary conductance matrix.

Gmatrix

Use this to specify a nodal conductance (G) matrix to represent some arbitrary resistance network. Specify in lower triangle form as usual for DSS matrices.

MinAmps

Minimum amps that can sustain a temporary fault. Default is 5.

ONtime

Time (sec) at which the fault is established for time varying simulations. Default is 0.0 (on at the beginning of the simulation)

pctperm

Percent of failures that become permanent. (not currently used)

Temporary

{Yes | No} Default is No. Designate whether the fault is temporary. For Time-varying simulations, the fault will be removed if the current through the fault drops below the MINAMPS criteria.

%stddev

Percent standard deviation in resistance to assume for Monte Carlo fault (MF) solution mode for GAUSSIAN distribution. Default is 0 (no variation from mean).


Standard Inherited Properties (may not apply to all Fault elements)


normamps

Normal rated current.

emergamps

Maximum current.

basefreq

Base Frequency for ratings.

faultrate

No. of failures per year. This property can be used by such things as a monte carlo fault study to specify how often this fault is likely to occur.

repair

Hours to repair.

enabled

{Yes|No or True|False} Indicates whether this element is enabled.

like

Make like another object, e.g.: 
New Fault.F2 like=F1 ...