Outage

Type: object

Document describing details of an active or planned outage in a part of the electrical network.
A non-planned outage may be created upon:
- a breaker trip,
- a fault indicator status change,
- a meter event indicating customer outage,
- a reception of one or more customer trouble calls, or
- an operator command, reflecting information obtained from the field crew.
Outage restoration may be performed using a switching plan which complements the outage information with detailed switching activities, including the relationship to the crew and work.
A planned outage may be created upon:
- a request for service, maintenance or construction work in the field, or
- an operator-defined outage for what-if/contingency network analysis.

No Additional Properties

EquipmentPointerArray

Type: array

Pointers to Equipment objects

No Additional Items

Each item of this array must be:

EquipmentPointer

Type: object

Pointer to Equipment object

EquipmentPointer

Type: string

Pointer to Equipment object

EnergyConsumerPointer

Type: string

Pointer to EnergyConsumer object

EnergySourcePointer

Type: string

Pointer to EnergySource object

EnergySourcePointer

Type: string

Pointer to EnergySource object

ACLineSegmentPointer

Type: string

Pointer to ACLineSegment object

SeriesCompensatorPointer

Type: string

Pointer to SeriesCompensator object

SwitchPointer

Type: string

Pointer to Switch object

PowerTransformerPointer

Type: string

Pointer to PowerTransformer object

status

Type: object

Status of subject matter (e.g., Agreement, Work) this document represents. For status of the document itself, use 'docStatus' attribute.

No Additional Properties

Type: string Default: null

Status value at 'dateTime'; prior status changes may have been kept in instances of activity records associated with the object to which this status applies.

Type: string Default: null

Pertinent information regarding the current 'value', as free form text.

Type: string Default: null

Reason code or explanation for why an object went to the current status 'value'.

Type: string Default: null

Date and time for which status 'value' applies.

comment

Type: string

Free text comment.

docStatus

Type: object

Status of this document. For status of subject matter this document represents (e.g., Agreement, Work), use 'status' attribute.
Example values for 'docStatus.status' are draft, approved, cancelled, etc.

No Additional Properties

Type: string Default: null

Status value at 'dateTime'; prior status changes may have been kept in instances of activity records associated with the object to which this status applies.

Type: string Default: null

Pertinent information regarding the current 'value', as free form text.

Type: string Default: null

Reason code or explanation for why an object went to the current status 'value'.

Type: string Default: null

Date and time for which status 'value' applies.

cimObjectType

Type: enum (of string)

Used in RAVENS Schema to identify the corresponding CIM Object Type of the JSON object.

Must be one of:

  • "Outage"

electronicAddress

Type: object

Electronic address.

No Additional Properties

Type: string Default: null

World wide web address.

Type: string Default: null

User ID needed to log in, which can be for an individual person, an organisation, a location, etc.

Type: string Default: null

MAC (Media Access Control) address.

Type: string Default: null

Password needed to log in.

Type: string Default: null

Alternate email address.

Type: string Default: null

Address on local area network.

Type: string Default: null

Primary email address.

Type: string Default: null

Radio address.

description

Type: string

The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy.

authorName

Type: string

Name of the author of this document.

statusKind

Type: enum (of string)

defines the status of the crew as in dispatched or arrived, etc.

Must be one of:

  • "CrewStatusKind.awaitingCrewAssignment"
  • "CrewStatusKind.assigned"
  • "CrewStatusKind.arrived"
  • "CrewStatusKind.enroute"
  • "CrewStatusKind.fieldComplete"

anticipatedStartDay

Type: string

nan

anticipatedStartHour

Type: integer

nan

anticipatedDuration

Type: string

nan

loadFractionTotal

Type: object or number

nan

No Additional Properties

Type: number Default: null

Normally 0 to 100 on a defined base.

UnitSymbol

Type: enum (of string) Default: "none"

nan

Must be one of:

  • "UnitSymbol.JPerkg"
  • "UnitSymbol.NPerm"
  • "UnitSymbol.WPerW"
  • "UnitSymbol.JPermol"
  • "UnitSymbol.WPerm2sr"
  • "UnitSymbol.V"
  • "UnitSymbol.A2h"
  • "UnitSymbol.JPerK"
  • "UnitSymbol.m3Perkg"
  • "UnitSymbol.HzPerHz"
  • "UnitSymbol.T"
  • "UnitSymbol.Vh"
  • "UnitSymbol.tonne"
  • "UnitSymbol.JPerm2"
  • "UnitSymbol.CPerkg"
  • "UnitSymbol.VPerHz"
  • "UnitSymbol.ohm"
  • "UnitSymbol.K"
  • "UnitSymbol.m3Compensated"
  • "UnitSymbol.lx"
  • "UnitSymbol.lPerh"
  • "UnitSymbol.APerm"
  • "UnitSymbol.charPers"
  • "UnitSymbol.katPerm3"
  • "UnitSymbol.Pas"
  • "UnitSymbol.ohmPerm"
  • "UnitSymbol.radPers2"
  • "UnitSymbol.Btu"
  • "UnitSymbol.WPers"
  • "UnitSymbol.h"
  • "UnitSymbol.lPerl"
  • "UnitSymbol.l"
  • "UnitSymbol.As"
  • "UnitSymbol.cosPhi"
  • "UnitSymbol.W"
  • "UnitSymbol.count"
  • "UnitSymbol.PaPers"
  • "UnitSymbol.onePerHz"
  • "UnitSymbol.m3Pers"
  • "UnitSymbol.KPers"
  • "UnitSymbol.Vs"
  • "UnitSymbol.m2Pers"
  • "UnitSymbol.Ah"
  • "UnitSymbol.deg"
  • "UnitSymbol.mPers2"
  • "UnitSymbol.lm"
  • "UnitSymbol.d"
  • "UnitSymbol.JPerkgK"
  • "UnitSymbol.m"
  • "UnitSymbol.min"
  • "UnitSymbol.dB"
  • "UnitSymbol.Gy"
  • "UnitSymbol.Nm"
  • "UnitSymbol.JPerm3"
  • "UnitSymbol.sPers"
  • "UnitSymbol.Q"
  • "UnitSymbol.rev"
  • "UnitSymbol.N"
  • "UnitSymbol.Bq"
  • "UnitSymbol.WPermK"
  • "UnitSymbol.GyPers"
  • "UnitSymbol.HPerm"
  • "UnitSymbol.molPerkg"
  • "UnitSymbol.molPerm3"
  • "UnitSymbol.Wb"
  • "UnitSymbol.VPerm"
  • "UnitSymbol.WPerm2"
  • "UnitSymbol.kn"
  • "UnitSymbol.CPerm2"
  • "UnitSymbol.anglemin"
  • "UnitSymbol.Oe"
  • "UnitSymbol.kgm"
  • "UnitSymbol.character"
  • "UnitSymbol.APerA"
  • "UnitSymbol.A2s"
  • "UnitSymbol.Qh"
  • "UnitSymbol.JPers"
  • "UnitSymbol.Hz"
  • "UnitSymbol.rad"
  • "UnitSymbol.kat"
  • "UnitSymbol.degC"
  • "UnitSymbol.bar"
  • "UnitSymbol.M"
  • "UnitSymbol.molPermol"
  • "UnitSymbol.kgPerJ"
  • "UnitSymbol.J"
  • "UnitSymbol.HzPers"
  • "UnitSymbol.WPersr"
  • "UnitSymbol.anglesec"
  • "UnitSymbol.F"
  • "UnitSymbol.Mx"
  • "UnitSymbol.ha"
  • "UnitSymbol.SPerm"
  • "UnitSymbol.gal"
  • "UnitSymbol.mmHg"
  • "UnitSymbol.m2"
  • "UnitSymbol.mPers"
  • "UnitSymbol.V2h"
  • "UnitSymbol.m3"
  • "UnitSymbol.G"
  • "UnitSymbol.H"
  • "UnitSymbol.mol"
  • "UnitSymbol.rotPers"
  • "UnitSymbol.VAh"
  • "UnitSymbol.mPerm3"
  • "UnitSymbol.onePerm"
  • "UnitSymbol.V2"
  • "UnitSymbol.WPerA"
  • "UnitSymbol.Pa"
  • "UnitSymbol.kgPerm3"
  • "UnitSymbol.CPerm3"
  • "UnitSymbol.Sv"
  • "UnitSymbol.S"
  • "UnitSymbol.JPermolK"
  • "UnitSymbol.ft3"
  • "UnitSymbol.Wh"
  • "UnitSymbol.radPers"
  • "UnitSymbol.ohmm"
  • "UnitSymbol.kgm2"
  • "UnitSymbol.m3Perh"
  • "UnitSymbol.dBm"
  • "UnitSymbol.VA"
  • "UnitSymbol.A2"
  • "UnitSymbol.s"
  • "UnitSymbol.therm"
  • "UnitSymbol.VArh"
  • "UnitSymbol.cd"
  • "UnitSymbol.VPerV"
  • "UnitSymbol.gPerg"
  • "UnitSymbol.kg"
  • "UnitSymbol.A"
  • "UnitSymbol.m3Uncompensated"
  • "UnitSymbol.ppm"
  • "UnitSymbol.FPerm"
  • "UnitSymbol.C"
  • "UnitSymbol.sr"
  • "UnitSymbol.none"
  • "UnitSymbol.VPerVAr"
  • "UnitSymbol.VAr"
  • "UnitSymbol.VPerVA"
  • "UnitSymbol.lPers"

UnitMultiplier

Type: enum (of string) Default: "none"

nan

Must be one of:

  • "UnitMultiplier.f"
  • "UnitMultiplier.c"
  • "UnitMultiplier.G"
  • "UnitMultiplier.d"
  • "UnitMultiplier.z"
  • "UnitMultiplier.p"
  • "UnitMultiplier.y"
  • "UnitMultiplier.h"
  • "UnitMultiplier.Y"
  • "UnitMultiplier.a"
  • "UnitMultiplier.none"
  • "UnitMultiplier.k"
  • "UnitMultiplier.m"
  • "UnitMultiplier.n"
  • "UnitMultiplier.E"
  • "UnitMultiplier.da"
  • "UnitMultiplier.T"
  • "UnitMultiplier.M"
  • "UnitMultiplier.P"
  • "UnitMultiplier.Z"
  • "UnitMultiplier.micro"

loadFractionCritical

Type: object or number

nan

No Additional Properties

Type: number Default: null

Normally 0 to 100 on a defined base.

UnitSymbol

Type: enum (of string) Default: "none"

nan

Must be one of:

  • "UnitSymbol.JPerkg"
  • "UnitSymbol.NPerm"
  • "UnitSymbol.WPerW"
  • "UnitSymbol.JPermol"
  • "UnitSymbol.WPerm2sr"
  • "UnitSymbol.V"
  • "UnitSymbol.A2h"
  • "UnitSymbol.JPerK"
  • "UnitSymbol.m3Perkg"
  • "UnitSymbol.HzPerHz"
  • "UnitSymbol.T"
  • "UnitSymbol.Vh"
  • "UnitSymbol.tonne"
  • "UnitSymbol.JPerm2"
  • "UnitSymbol.CPerkg"
  • "UnitSymbol.VPerHz"
  • "UnitSymbol.ohm"
  • "UnitSymbol.K"
  • "UnitSymbol.m3Compensated"
  • "UnitSymbol.lx"
  • "UnitSymbol.lPerh"
  • "UnitSymbol.APerm"
  • "UnitSymbol.charPers"
  • "UnitSymbol.katPerm3"
  • "UnitSymbol.Pas"
  • "UnitSymbol.ohmPerm"
  • "UnitSymbol.radPers2"
  • "UnitSymbol.Btu"
  • "UnitSymbol.WPers"
  • "UnitSymbol.h"
  • "UnitSymbol.lPerl"
  • "UnitSymbol.l"
  • "UnitSymbol.As"
  • "UnitSymbol.cosPhi"
  • "UnitSymbol.W"
  • "UnitSymbol.count"
  • "UnitSymbol.PaPers"
  • "UnitSymbol.onePerHz"
  • "UnitSymbol.m3Pers"
  • "UnitSymbol.KPers"
  • "UnitSymbol.Vs"
  • "UnitSymbol.m2Pers"
  • "UnitSymbol.Ah"
  • "UnitSymbol.deg"
  • "UnitSymbol.mPers2"
  • "UnitSymbol.lm"
  • "UnitSymbol.d"
  • "UnitSymbol.JPerkgK"
  • "UnitSymbol.m"
  • "UnitSymbol.min"
  • "UnitSymbol.dB"
  • "UnitSymbol.Gy"
  • "UnitSymbol.Nm"
  • "UnitSymbol.JPerm3"
  • "UnitSymbol.sPers"
  • "UnitSymbol.Q"
  • "UnitSymbol.rev"
  • "UnitSymbol.N"
  • "UnitSymbol.Bq"
  • "UnitSymbol.WPermK"
  • "UnitSymbol.GyPers"
  • "UnitSymbol.HPerm"
  • "UnitSymbol.molPerkg"
  • "UnitSymbol.molPerm3"
  • "UnitSymbol.Wb"
  • "UnitSymbol.VPerm"
  • "UnitSymbol.WPerm2"
  • "UnitSymbol.kn"
  • "UnitSymbol.CPerm2"
  • "UnitSymbol.anglemin"
  • "UnitSymbol.Oe"
  • "UnitSymbol.kgm"
  • "UnitSymbol.character"
  • "UnitSymbol.APerA"
  • "UnitSymbol.A2s"
  • "UnitSymbol.Qh"
  • "UnitSymbol.JPers"
  • "UnitSymbol.Hz"
  • "UnitSymbol.rad"
  • "UnitSymbol.kat"
  • "UnitSymbol.degC"
  • "UnitSymbol.bar"
  • "UnitSymbol.M"
  • "UnitSymbol.molPermol"
  • "UnitSymbol.kgPerJ"
  • "UnitSymbol.J"
  • "UnitSymbol.HzPers"
  • "UnitSymbol.WPersr"
  • "UnitSymbol.anglesec"
  • "UnitSymbol.F"
  • "UnitSymbol.Mx"
  • "UnitSymbol.ha"
  • "UnitSymbol.SPerm"
  • "UnitSymbol.gal"
  • "UnitSymbol.mmHg"
  • "UnitSymbol.m2"
  • "UnitSymbol.mPers"
  • "UnitSymbol.V2h"
  • "UnitSymbol.m3"
  • "UnitSymbol.G"
  • "UnitSymbol.H"
  • "UnitSymbol.mol"
  • "UnitSymbol.rotPers"
  • "UnitSymbol.VAh"
  • "UnitSymbol.mPerm3"
  • "UnitSymbol.onePerm"
  • "UnitSymbol.V2"
  • "UnitSymbol.WPerA"
  • "UnitSymbol.Pa"
  • "UnitSymbol.kgPerm3"
  • "UnitSymbol.CPerm3"
  • "UnitSymbol.Sv"
  • "UnitSymbol.S"
  • "UnitSymbol.JPermolK"
  • "UnitSymbol.ft3"
  • "UnitSymbol.Wh"
  • "UnitSymbol.radPers"
  • "UnitSymbol.ohmm"
  • "UnitSymbol.kgm2"
  • "UnitSymbol.m3Perh"
  • "UnitSymbol.dBm"
  • "UnitSymbol.VA"
  • "UnitSymbol.A2"
  • "UnitSymbol.s"
  • "UnitSymbol.therm"
  • "UnitSymbol.VArh"
  • "UnitSymbol.cd"
  • "UnitSymbol.VPerV"
  • "UnitSymbol.gPerg"
  • "UnitSymbol.kg"
  • "UnitSymbol.A"
  • "UnitSymbol.m3Uncompensated"
  • "UnitSymbol.ppm"
  • "UnitSymbol.FPerm"
  • "UnitSymbol.C"
  • "UnitSymbol.sr"
  • "UnitSymbol.none"
  • "UnitSymbol.VPerVAr"
  • "UnitSymbol.VAr"
  • "UnitSymbol.VPerVA"
  • "UnitSymbol.lPers"

UnitMultiplier

Type: enum (of string) Default: "none"

nan

Must be one of:

  • "UnitMultiplier.f"
  • "UnitMultiplier.c"
  • "UnitMultiplier.G"
  • "UnitMultiplier.d"
  • "UnitMultiplier.z"
  • "UnitMultiplier.p"
  • "UnitMultiplier.y"
  • "UnitMultiplier.h"
  • "UnitMultiplier.Y"
  • "UnitMultiplier.a"
  • "UnitMultiplier.none"
  • "UnitMultiplier.k"
  • "UnitMultiplier.m"
  • "UnitMultiplier.n"
  • "UnitMultiplier.E"
  • "UnitMultiplier.da"
  • "UnitMultiplier.T"
  • "UnitMultiplier.M"
  • "UnitMultiplier.P"
  • "UnitMultiplier.Z"
  • "UnitMultiplier.micro"

utilityDisclaimer

Type: string

This contains an disclaimers the utility would like to place on the data provided to any stakeholder. This may be different for different stakeholders. This should possibly be an attribute under the Organization class but it is placed here for now.

weight

Type: number

nan

type

Type: string

Utility-specific classification of this document, according to its corporate standards, practices, and existing IT systems (e.g., for management of assets, maintenance, work, outage, customers, etc.).

title

Type: string

Document title.

communityDescriptor

Type: string

a name to denote the community - this could be a name or a code of some kind.

revisionNumber

Type: string

Revision number for this document.

originalCustomersServed

Type: integer

the total number of customers that are served in the area (both outaged and not outaged).

estimatedPeriod

Type: object

Estimated outage period for a planned outage. The start of the period is the start of the planned outage and the end of the period corresponds to the end of the planned outage.

No Additional Properties

Type: string Default: null

End date and time of this interval. The end date and time where the interval is defined up to, but excluded.

Type: string Default: null

Start date and time of this interval. The start date and time is included in the defined interval.

customersRestored

Type: integer

number of customers that have been restored in the area.

createdDateTime

Type: string

Date and time that this document was created.

causeKind

Type: enum (of string)

The possible cause that could be associated with this unplanned outage.

Must be one of:

  • "OutageCauseKind.treeDown"
  • "OutageCauseKind.animal"
  • "OutageCauseKind.lightingStrike"
  • "OutageCauseKind.poleDown"
  • "OutageCauseKind.lineDown"

originalMetersAffected

Type: integer

The original number of meters that were affected as reported by the OMS within the utility. That is, this is the total number of meters that were out at the beginning of the outage.

subject

Type: string

Document subject.

reason

Type: string

The reason for the planned outage.

summary

Type: object

Summary counts of service points (customers) affected by this outage.

No Additional Properties

Type: integer Default: null

Number of critical service (delivery) points affected by an outage.

Type: integer Default: null

Number of all service (delivery) points affected by an outage.

metersAffected

Type: integer

The updated number of meters affected by the outage as reported by the OMS within the utility. It is assumed this number will be updated repeatedly until the full outage is resolved.

reportedStartTime

Type: string

The earliest start time of the Outage - as reported by some system or individual

lastModifiedDateTime

Type: string

Date and time this document was last modified. Documents may potentially be modified many times during their lifetime.

actualPeriod

Type: object

Actual outage period; end of the period corresponds to the actual restoration time.

No Additional Properties

Type: string Default: null

End date and time of this interval. The end date and time where the interval is defined up to, but excluded.

Type: string Default: null

Start date and time of this interval. The start date and time is included in the defined interval.

cause

Type: string

The cause of this outage. This is the cause that is used to present to external entities. That is, the cause is weather, equipment failure, etc.
Note: At present, this is a free string text; it could be replaced with an enumeration in the future.

outageKind

Type: enum (of string)

Defines if the outage has been verified or is only estimated

Must be one of:

  • "OutageStatusKind.predicted"
  • "OutageStatusKind.closed"
  • "OutageStatusKind.confirmed"
  • "OutageStatusKind.restored"
  • "OutageStatusKind.partiallyRestored"

aliasName

Type: string

The aliasName is free text human readable name of the object alternative to IdentifiedObject.name. It may be non unique and may not correlate to a naming hierarchy.
The attribute aliasName is retained because of backwards compatibility between CIM relases. It is however recommended to replace aliasName with the Name class as aliasName is planned for retirement at a future time.

mRID

Type: string

Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended.
For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements.

name

Type: string

The name is any free human readable and possibly non unique text naming the object.