Reservoir

A water storage facility within a hydro system, including: ponds, lakes, lagoons, and rivers. The storage is usually behind some type of dam.

Type

Class

URI

cim:Reservoir

CIM standard (perspective)

IEC61970 (Grid)

Class hierarchy

Slots

Associated classes
Figure 1. Associated classes
Name Cardinality Type Description

InstanceSet

1

InstanceSet

Dataset containing the data objects.

SpillsFromReservoir

0..1

Reservoir

A reservoir may spill into a downstream reservoir.

TargetLevelSchedule

0..1

TargetLevelSchedule

A reservoir may have a water level target schedule.

activeStorageCapacity

0..1

Volume

Storage volume between the full supply level and the normal minimum operating level.

energyStorageRating

0..1

float

The reservoir's energy storage rating in energy for given head conditions.

fullSupplyLevel

0..1

WaterLevel

Full supply level, above which water will spill. This can be the spillway crest level or the top of closed gates.

grossCapacity

0..1

Volume

Total capacity of reservoir.

normalMinOperateLevel

0..1

WaterLevel

Normal minimum operating level below which the penstocks will draw air.

riverOutletWorks

0..1

string

River outlet works for riparian right releases or other purposes.

spillTravelDelay

0..1

Seconds

The spillway water travel delay to the next downstream reservoir.

spillWayGateType

0..1

string

Type of spillway gate, including parameters.

spillwayCapacity

0..1

float

The flow capacity of the spillway in cubic meters per second.

spillwayCrestLength

0..1

Length

The length of the spillway crest.

spillwayCrestLevel

0..1

WaterLevel

Spillway crest level above which water will spill.

HydroPowerPlants

0..*

HydroPowerPlant

Generators discharge water to or pumps are supplied water from a downstream reservoir.

InflowForecasts

0..*

InflowForecast

A reservoir may have a "natural" inflow forecast.

LevelVsVolumeCurves

0..*

LevelVsVolumeCurve

A reservoir may have a level versus volume relationship.

SpillsIntoReservoirs

0..*

Reservoir

A reservoir may spill into a downstream reservoir.

UpstreamFromHydroPowerPlants

0..*

HydroPowerPlant

Generators are supplied water from or pumps discharge water to an upstream reservoir.

AssetDatasheet

0..1

AssetInfo

Datasheet information for this power system resource.

Location

0..1

Location

Location of this power system resource.

PSRType

0..1

PSRType

Custom classification for this power system resource.

PropertiesCIMDataObject

0..1

ChangeSetMember

The single CIM data object in the appropriate dataset context.

aliasName

0..1

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.

description

0..1

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.

mRID

0..1

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

0..1

string

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

Assets

0..*

Asset

All assets represented by this power system resource. For example, multiple conductor assets are electrically modelled as a single AC line segment.

Clearances

0..*

ClearanceDocument

All clearances applicable to this power system resource.

ConfigurationEvent

0..*

ConfigurationEvent

All configuration events created for this Power System resource.

Controls

0..*

Control

The controller outputs used to actually govern a regulating device, e.g. the magnetization of a synchronous machine or capacitor bank breaker actuator.

DiagramObjects

0..*

DiagramObject

The diagram objects that are associated with the domain object.

GenericAction

0..*

GenericAction

The generic action that is performed on the power system resource

Measurements

0..*

Measurement

The measurements associated with this power system resource.

Names

0..*

Name

All names of this identified object.

OperatingShare

0..*

OperatingShare

The operating shares of this power system resource.

OperationalTags

0..*

OperationalTag

All operational tags placed on this power system resource.

PSREvents

0..*

PSREvent

All events associated with this power system resource.

ReportingGroup

0..*

ReportingGroup

Reporting groups to which this power system resource belongs.

TargetingCIMDataObject

0..*

ChangeSetMember

Data objects registered.

VerificationAction

0..*

VerificationAction

The verification action that is performed on the power system resource


activeStorageCapacity

Storage volume between the full supply level and the normal minimum operating level.

URI

cim:Reservoir.activeStorageCapacity

Cardinality

0..1

Type

Volume

aliasName

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.

URI

cim:IdentifiedObject.aliasName

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

AssetDatasheet

Datasheet information for this power system resource.

URI

cim:PowerSystemResource.AssetDatasheet

Cardinality

0..1

Type

AssetInfo

Inherited from

PowerSystemResource

Assets

All assets represented by this power system resource. For example, multiple conductor assets are electrically modelled as a single AC line segment.

URI

cim:PowerSystemResource.Assets

Cardinality

0..*

Type

Asset

Inherited from

PowerSystemResource

Clearances

All clearances applicable to this power system resource.

URI

cim:PowerSystemResource.Clearances

Cardinality

0..*

Type

ClearanceDocument

Inherited from

PowerSystemResource

ConfigurationEvent

All configuration events created for this Power System resource.

URI

cim:PowerSystemResource.ConfigurationEvent

Cardinality

0..*

Type

ConfigurationEvent

Inherited from

PowerSystemResource

Controls

The controller outputs used to actually govern a regulating device, e.g. the magnetization of a synchronous machine or capacitor bank breaker actuator.

URI

cim:PowerSystemResource.Controls

Cardinality

0..*

Type

Control

Inherited from

PowerSystemResource

description

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.

URI

cim:IdentifiedObject.description

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

DiagramObjects

The diagram objects that are associated with the domain object.

URI

cim:IdentifiedObject.DiagramObjects

Cardinality

0..*

Type

DiagramObject

Inherited from

IdentifiedObject

energyStorageRating

The reservoir's energy storage rating in energy for given head conditions.

URI

cim:Reservoir.energyStorageRating

Cardinality

0..1

Type

float

fullSupplyLevel

Full supply level, above which water will spill. This can be the spillway crest level or the top of closed gates.

URI

cim:Reservoir.fullSupplyLevel

Cardinality

0..1

Type

WaterLevel

GenericAction

The generic action that is performed on the power system resource

URI

cim:PowerSystemResource.GenericAction

Cardinality

0..*

Type

GenericAction

Inherited from

PowerSystemResource

grossCapacity

Total capacity of reservoir.

URI

cim:Reservoir.grossCapacity

Cardinality

0..1

Type

Volume

HydroPowerPlants

Generators discharge water to or pumps are supplied water from a downstream reservoir.

URI

cim:Reservoir.HydroPowerPlants

Cardinality

0..*

Type

HydroPowerPlant

InflowForecasts

A reservoir may have a "natural" inflow forecast.

URI

cim:Reservoir.InflowForecasts

Cardinality

0..*

Type

InflowForecast

InstanceSet

Dataset containing the data objects.

URI

cim:IdentifiedObject.InstanceSet

Cardinality

1

Type

InstanceSet

Inherited from

IdentifiedObject

LevelVsVolumeCurves

A reservoir may have a level versus volume relationship.

URI

cim:Reservoir.LevelVsVolumeCurves

Cardinality

0..*

Type

LevelVsVolumeCurve

Location

Location of this power system resource.

URI

cim:PowerSystemResource.Location

Cardinality

0..1

Type

Location

Inherited from

PowerSystemResource

Measurements

The measurements associated with this power system resource.

URI

cim:PowerSystemResource.Measurements

Cardinality

0..*

Type

Measurement

Inherited from

PowerSystemResource

mRID

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.

URI

cim:IdentifiedObject.mRID

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

name

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

URI

cim:IdentifiedObject.name

Cardinality

0..1

Type

string

Inherited from

IdentifiedObject

Names

All names of this identified object.

URI

cim:IdentifiedObject.Names

Cardinality

0..*

Type

Name

Inherited from

IdentifiedObject

normalMinOperateLevel

Normal minimum operating level below which the penstocks will draw air.

URI

cim:Reservoir.normalMinOperateLevel

Cardinality

0..1

Type

WaterLevel

OperatingShare

The operating shares of this power system resource.

URI

cim:PowerSystemResource.OperatingShare

Cardinality

0..*

Type

OperatingShare

Inherited from

PowerSystemResource

OperationalTags

All operational tags placed on this power system resource.

URI

cim:PowerSystemResource.OperationalTags

Cardinality

0..*

Type

OperationalTag

Inherited from

PowerSystemResource

PropertiesCIMDataObject

The single CIM data object in the appropriate dataset context.

URI

cim:IdentifiedObject.PropertiesCIMDataObject

Cardinality

0..1

Type

ChangeSetMember

Inherited from

IdentifiedObject

PSREvents

All events associated with this power system resource.

URI

cim:PowerSystemResource.PSREvents

Cardinality

0..*

Type

PSREvent

Inherited from

PowerSystemResource

PSRType

Custom classification for this power system resource.

URI

cim:PowerSystemResource.PSRType

Cardinality

0..1

Type

PSRType

Inherited from

PowerSystemResource

ReportingGroup

Reporting groups to which this power system resource belongs.

URI

cim:PowerSystemResource.ReportingGroup

Cardinality

0..*

Type

ReportingGroup

Inherited from

PowerSystemResource

riverOutletWorks

River outlet works for riparian right releases or other purposes.

URI

cim:Reservoir.riverOutletWorks

Cardinality

0..1

Type

string

SpillsFromReservoir

A reservoir may spill into a downstream reservoir.

URI

cim:Reservoir.SpillsFromReservoir

Cardinality

0..1

Type

Reservoir

SpillsIntoReservoirs

A reservoir may spill into a downstream reservoir.

URI

cim:Reservoir.SpillsIntoReservoirs

Cardinality

0..*

Type

Reservoir

spillTravelDelay

The spillway water travel delay to the next downstream reservoir.

URI

cim:Reservoir.spillTravelDelay

Cardinality

0..1

Type

Seconds

spillwayCapacity

The flow capacity of the spillway in cubic meters per second.

URI

cim:Reservoir.spillwayCapacity

Cardinality

0..1

Type

float

spillwayCrestLength

The length of the spillway crest.

URI

cim:Reservoir.spillwayCrestLength

Cardinality

0..1

Type

Length

spillwayCrestLevel

Spillway crest level above which water will spill.

URI

cim:Reservoir.spillwayCrestLevel

Cardinality

0..1

Type

WaterLevel

spillWayGateType

Type of spillway gate, including parameters.

URI

cim:Reservoir.spillWayGateType

Cardinality

0..1

Type

string

TargetingCIMDataObject

Data objects registered.

URI

cim:IdentifiedObject.TargetingCIMDataObject

Cardinality

0..*

Type

ChangeSetMember

Inherited from

IdentifiedObject

TargetLevelSchedule

A reservoir may have a water level target schedule.

URI

cim:Reservoir.TargetLevelSchedule

Cardinality

0..1

Type

TargetLevelSchedule

UpstreamFromHydroPowerPlants

Generators are supplied water from or pumps discharge water to an upstream reservoir.

URI

cim:Reservoir.UpstreamFromHydroPowerPlants

Cardinality

0..*

Type

HydroPowerPlant

VerificationAction

The verification action that is performed on the power system resource

URI

cim:PowerSystemResource.VerificationAction

Cardinality

0..*

Type

VerificationAction

Inherited from

PowerSystemResource