Faults

Type: object

Objects that define faults for running a sequence of fault studies. Fault objects are shunt-like objects with admittance (conductance and susceptance) defined, and the phase connections to which the admittance matrix is applied.


Example:

{
    "701": {
        "3p": {
            "1": {
                "name": "1",
                "g": [
                    [
                        200,
                        -100,
                        -100
                    ],
                    [
                        -100,
                        200,
                        -100
                    ],
                    [
                        -100,
                        -100,
                        200
                    ]
                ],
                "status": "ENABLED",
                "connections": [
                    1,
                    2,
                    3
                ],
                "b": [
                    [
                        0,
                        0,
                        0
                    ],
                    [
                        0,
                        0,
                        0
                    ],
                    [
                        0,
                        0,
                        0
                    ]
                ],
                "fault_type": "3p",
                "bus": "701"
            }
        }
    }
}

All properties whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^.+$
Type: object

Bus on which the faults apply

All properties whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^[3p|3pg|ll|llg|lg]$
Type: object

collection of faults of type {}

All properties whose name matches the following regular expression must respect the following conditions

Property name regular expression: ^\d+$
Type: object

enumerated faults in case there are more than one fault of the same type on the same bus

No Additional Properties

Type: string

Name of the fault

Type: array of integer

Connections over which the fault applies

Each item of this array must be:

Type: array of array

conductance matrix of size (len(connections),len(connections))

Each item of this array must be:

Type: array of number

row vector

Each item of this array must be:

Type: array of array

susceptance matrix of size (len(connections),len(connections). Usually all zeros.

Each item of this array must be:

Type: array of number

row vector

Each item of this array must be:

Type: enum (of string)

Type of fault, i.e., 3-phase (3p), 3-phase-grounded (3pg), line-to-line (ll), line-to-line-to-ground (llg), or line-to-ground (lg)

Must be one of:

  • "3p"
  • "3pg"
  • "ll"
  • "llg"
  • "lg"

Type: enum (of string)

status of the fault, i.e. is the fault active or not

Must be one of:

  • "ENABLED"
  • "DISABLED"