Skip to content

Class: LoadResponseCharacteristic

_Models the characteristic response of the load demand due to changes in system conditions such as voltage and frequency. It is not related to demand response. _

_If LoadResponseCharacteristic.exponentModel is True, the exponential voltage or frequency dependent models are specified and used as to calculate active and reactive power components of the load model. _

_The equations to calculate active and reactive power components of the load model are internal to the power flow calculation, hence they use different quantities depending on the use case of the data exchange. _

_The equations for exponential voltage dependent load model injected power are: _

_pInjection= Pnominal* (Voltage/cim:BaseVoltage.nominalVoltage) ** cim:LoadResponseCharacteristic.pVoltageExponent _

_qInjection= Qnominal* (Voltage/cim:BaseVoltage.nominalVoltage) ** cim:LoadResponseCharacteristic.qVoltageExponent _

_Where: _

_1) * means "multiply" and ** is "raised to power of"; _

_2) Pnominal and Qnominal represent the active power and reactive power at nominal voltage as any load described by the voltage exponential model shall be given at nominal voltage. This means that EnergyConsumer.p and EnergyConsumer.q are at nominal voltage. _

_3) After power flow is solved: _

-pInjection and qInjection correspond to SvPowerflow.p and SvPowerflow.q respectively.

- Voltage corresponds to SvVoltage.v at the TopologicalNode where the load is connected.

URI: cim:LoadResponseCharacteristic

 classDiagram
    class LoadResponseCharacteristic
      IdentifiedObject <|-- LoadResponseCharacteristic

      LoadResponseCharacteristic : alias_name

      LoadResponseCharacteristic : description

      LoadResponseCharacteristic : diagram_objects

          LoadResponseCharacteristic --> DiagramObject : diagram_objects

      LoadResponseCharacteristic : energy_consumer

          LoadResponseCharacteristic --> EnergyConsumer : energy_consumer

      LoadResponseCharacteristic : exponent_model

      LoadResponseCharacteristic : instance_set

          LoadResponseCharacteristic --> InstanceSet : instance_set

      LoadResponseCharacteristic : m_rid

      LoadResponseCharacteristic : names

          LoadResponseCharacteristic --> Name : names

      LoadResponseCharacteristic : p_constant_current

      LoadResponseCharacteristic : p_constant_impedance

      LoadResponseCharacteristic : p_constant_power

      LoadResponseCharacteristic : p_frequency_exponent

      LoadResponseCharacteristic : p_voltage_exponent

      LoadResponseCharacteristic : properties_cimdata_object

          LoadResponseCharacteristic --> ChangeSetMember : properties_cimdata_object

      LoadResponseCharacteristic : q_constant_current

      LoadResponseCharacteristic : q_constant_impedance

      LoadResponseCharacteristic : q_constant_power

      LoadResponseCharacteristic : q_frequency_exponent

      LoadResponseCharacteristic : q_voltage_exponent

      LoadResponseCharacteristic : targeting_cimdata_object

          LoadResponseCharacteristic --> ChangeSetMember : targeting_cimdata_object

Inheritance

Slots

Name Cardinality and Range Description Inheritance
exponent_model 0..1
Boolean		 Indicates the exponential voltage dependency model is to be used direct
p_constant_current 0..1
Float		 Portion of active power load modelled as constant current direct
p_constant_impedance 0..1
Float		 Portion of active power load modelled as constant impedance direct
p_constant_power 0..1
Float		 Portion of active power load modelled as constant power direct
p_frequency_exponent 0..1
Float		 Exponent of per unit frequency effecting active power direct
p_voltage_exponent 0..1
Float		 Exponent of per unit voltage effecting real power direct
q_constant_current 0..1
Float		 Portion of reactive power load modelled as constant current direct
q_constant_impedance 0..1
Float		 Portion of reactive power load modelled as constant impedance direct
q_constant_power 0..1
Float		 Portion of reactive power load modelled as constant power direct
q_frequency_exponent 0..1
Float		 Exponent of per unit frequency effecting reactive power direct
q_voltage_exponent 0..1
Float		 Exponent of per unit voltage effecting reactive power direct
energy_consumer 0..*
EnergyConsumer		 The set of loads that have the response characteristics direct
alias_name 0..1
String		 The aliasName is free text human readable name of the object alternative to I... IdentifiedObject
description 0..1
String		 The description is a free human readable text describing or naming the object IdentifiedObject
m_rid 0..1
String		 Master resource identifier issued by a model authority IdentifiedObject
diagram_objects 0..*
DiagramObject		 The diagram objects that are associated with the domain object IdentifiedObject
instance_set 1..1
InstanceSet		 Dataset containing the data objects IdentifiedObject
names 0..*
Name		 All names of this identified object IdentifiedObject
properties_cimdata_object 0..1
ChangeSetMember		 The single CIM data object in the appropriate dataset context IdentifiedObject
targeting_cimdata_object 0..*
ChangeSetMember		 Data objects registered IdentifiedObject

Usages

used by used in type used
EnergyConsumer load_response range LoadResponseCharacteristic
ConformLoad load_response range LoadResponseCharacteristic
NonConformLoad load_response range LoadResponseCharacteristic
StationSupply load_response range LoadResponseCharacteristic

Identifier and Mapping Information

Schema Source

  • from schema: https://cim.ucaiug.io/ns#TC57CIM

Mappings

Mapping Type Mapped Value
self cim:LoadResponseCharacteristic
native cim:LoadResponseCharacteristic

LinkML Source

Direct

name: LoadResponseCharacteristic
description: "Models the characteristic response of the load demand due to changes\
  \ in system conditions such as voltage and frequency. It is not related to demand\
  \ response.\r\nIf LoadResponseCharacteristic.exponentModel is True, the exponential\
  \ voltage or frequency dependent models are specified and used as to calculate active\
  \ and reactive power components of the load model.\r\nThe equations to calculate\
  \ active and reactive power components of the load model are internal to the power\
  \ flow calculation, hence they use different quantities depending on the use case\
  \ of the data exchange. \r\nThe equations for exponential voltage dependent load\
  \ model injected power are: \r\npInjection= Pnominal* (Voltage/cim:BaseVoltage.nominalVoltage)\
  \ ** cim:LoadResponseCharacteristic.pVoltageExponent\r\nqInjection= Qnominal* (Voltage/cim:BaseVoltage.nominalVoltage)\
  \ ** cim:LoadResponseCharacteristic.qVoltageExponent\r\nWhere: \r\n1) * means \"\
  multiply\" and ** is \"raised to power of\";\r\n2) Pnominal and Qnominal represent\
  \ the active power and reactive power at nominal voltage as any load described by\
  \ the voltage exponential model shall be given at nominal voltage.  This means that\
  \ EnergyConsumer.p and EnergyConsumer.q  are at nominal voltage.\r\n3) After power\
  \ flow is solved: \r\n-pInjection and qInjection correspond to SvPowerflow.p and\
  \ SvPowerflow.q respectively.  \r\n- Voltage corresponds to SvVoltage.v at the TopologicalNode\
  \ where the load is connected."
from_schema: https://cim.ucaiug.io/ns#TC57CIM
rank: 1000
is_a: IdentifiedObject
attributes:
  exponent_model:
    name: exponent_model
    description: "Indicates the exponential voltage dependency model is to be used.\
      \ If false, the coefficient model is to be used.\r\nThe exponential voltage\
      \ dependency model consist of the attributes:\r\n- pVoltageExponent\r\n- qVoltageExponent\r\
      \n- pFrequencyExponent\r\n- qFrequencyExponent.\r\nThe coefficient model consist\
      \ of the attributes:\r\n- pConstantImpedance\r\n- pConstantCurrent\r\n- pConstantPower\r\
      \n- qConstantImpedance\r\n- qConstantCurrent\r\n- qConstantPower.\r\nThe sum\
      \ of pConstantImpedance, pConstantCurrent and pConstantPower shall equal 1.\r\
      \nThe sum of qConstantImpedance, qConstantCurrent and qConstantPower shall equal\
      \ 1."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.exponentModel
    multivalued: false
    domain_of:
    - LoadResponseCharacteristic
    range: boolean
    required: false
  p_constant_current:
    name: p_constant_current
    description: Portion of active power load modelled as constant current.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.pConstantCurrent
    multivalued: false
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  p_constant_impedance:
    name: p_constant_impedance
    description: Portion of active power load modelled as constant impedance.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.pConstantImpedance
    multivalued: false
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  p_constant_power:
    name: p_constant_power
    description: Portion of active power load modelled as constant power.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.pConstantPower
    multivalued: false
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  p_frequency_exponent:
    name: p_frequency_exponent
    description: "Exponent of per unit frequency effecting active power.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.pFrequencyExponent
    multivalued: false
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  p_voltage_exponent:
    name: p_voltage_exponent
    description: Exponent of per unit voltage effecting real power.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.pVoltageExponent
    multivalued: false
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  q_constant_current:
    name: q_constant_current
    description: Portion of reactive power load modelled as constant current.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.qConstantCurrent
    multivalued: false
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  q_constant_impedance:
    name: q_constant_impedance
    description: Portion of reactive power load modelled as constant impedance.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.qConstantImpedance
    multivalued: false
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  q_constant_power:
    name: q_constant_power
    description: Portion of reactive power load modelled as constant power.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.qConstantPower
    multivalued: false
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  q_frequency_exponent:
    name: q_frequency_exponent
    description: "Exponent of per unit frequency effecting reactive power.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.qFrequencyExponent
    multivalued: false
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  q_voltage_exponent:
    name: q_voltage_exponent
    description: Exponent of per unit voltage effecting reactive power.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.qVoltageExponent
    multivalued: false
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  energy_consumer:
    name: energy_consumer
    description: The set of loads that have the response characteristics.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:LoadResponseCharacteristic.EnergyConsumer
    multivalued: true
    domain_of:
    - EnergyConsumerPhase
    - LoadDynamics
    - LoadResponseCharacteristic
    - EnergyConsumerAction
    range: EnergyConsumer
    required: false
class_uri: cim:LoadResponseCharacteristic

Induced

name: LoadResponseCharacteristic
description: "Models the characteristic response of the load demand due to changes\
  \ in system conditions such as voltage and frequency. It is not related to demand\
  \ response.\r\nIf LoadResponseCharacteristic.exponentModel is True, the exponential\
  \ voltage or frequency dependent models are specified and used as to calculate active\
  \ and reactive power components of the load model.\r\nThe equations to calculate\
  \ active and reactive power components of the load model are internal to the power\
  \ flow calculation, hence they use different quantities depending on the use case\
  \ of the data exchange. \r\nThe equations for exponential voltage dependent load\
  \ model injected power are: \r\npInjection= Pnominal* (Voltage/cim:BaseVoltage.nominalVoltage)\
  \ ** cim:LoadResponseCharacteristic.pVoltageExponent\r\nqInjection= Qnominal* (Voltage/cim:BaseVoltage.nominalVoltage)\
  \ ** cim:LoadResponseCharacteristic.qVoltageExponent\r\nWhere: \r\n1) * means \"\
  multiply\" and ** is \"raised to power of\";\r\n2) Pnominal and Qnominal represent\
  \ the active power and reactive power at nominal voltage as any load described by\
  \ the voltage exponential model shall be given at nominal voltage.  This means that\
  \ EnergyConsumer.p and EnergyConsumer.q  are at nominal voltage.\r\n3) After power\
  \ flow is solved: \r\n-pInjection and qInjection correspond to SvPowerflow.p and\
  \ SvPowerflow.q respectively.  \r\n- Voltage corresponds to SvVoltage.v at the TopologicalNode\
  \ where the load is connected."
from_schema: https://cim.ucaiug.io/ns#TC57CIM
rank: 1000
is_a: IdentifiedObject
attributes:
  exponent_model:
    name: exponent_model
    description: "Indicates the exponential voltage dependency model is to be used.\
      \ If false, the coefficient model is to be used.\r\nThe exponential voltage\
      \ dependency model consist of the attributes:\r\n- pVoltageExponent\r\n- qVoltageExponent\r\
      \n- pFrequencyExponent\r\n- qFrequencyExponent.\r\nThe coefficient model consist\
      \ of the attributes:\r\n- pConstantImpedance\r\n- pConstantCurrent\r\n- pConstantPower\r\
      \n- qConstantImpedance\r\n- qConstantCurrent\r\n- qConstantPower.\r\nThe sum\
      \ of pConstantImpedance, pConstantCurrent and pConstantPower shall equal 1.\r\
      \nThe sum of qConstantImpedance, qConstantCurrent and qConstantPower shall equal\
      \ 1."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.exponentModel
    multivalued: false
    alias: exponent_model
    owner: LoadResponseCharacteristic
    domain_of:
    - LoadResponseCharacteristic
    range: boolean
    required: false
  p_constant_current:
    name: p_constant_current
    description: Portion of active power load modelled as constant current.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.pConstantCurrent
    multivalued: false
    alias: p_constant_current
    owner: LoadResponseCharacteristic
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  p_constant_impedance:
    name: p_constant_impedance
    description: Portion of active power load modelled as constant impedance.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.pConstantImpedance
    multivalued: false
    alias: p_constant_impedance
    owner: LoadResponseCharacteristic
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  p_constant_power:
    name: p_constant_power
    description: Portion of active power load modelled as constant power.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.pConstantPower
    multivalued: false
    alias: p_constant_power
    owner: LoadResponseCharacteristic
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  p_frequency_exponent:
    name: p_frequency_exponent
    description: "Exponent of per unit frequency effecting active power.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.pFrequencyExponent
    multivalued: false
    alias: p_frequency_exponent
    owner: LoadResponseCharacteristic
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  p_voltage_exponent:
    name: p_voltage_exponent
    description: Exponent of per unit voltage effecting real power.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.pVoltageExponent
    multivalued: false
    alias: p_voltage_exponent
    owner: LoadResponseCharacteristic
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  q_constant_current:
    name: q_constant_current
    description: Portion of reactive power load modelled as constant current.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.qConstantCurrent
    multivalued: false
    alias: q_constant_current
    owner: LoadResponseCharacteristic
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  q_constant_impedance:
    name: q_constant_impedance
    description: Portion of reactive power load modelled as constant impedance.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.qConstantImpedance
    multivalued: false
    alias: q_constant_impedance
    owner: LoadResponseCharacteristic
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  q_constant_power:
    name: q_constant_power
    description: Portion of reactive power load modelled as constant power.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.qConstantPower
    multivalued: false
    alias: q_constant_power
    owner: LoadResponseCharacteristic
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  q_frequency_exponent:
    name: q_frequency_exponent
    description: "Exponent of per unit frequency effecting reactive power.\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.qFrequencyExponent
    multivalued: false
    alias: q_frequency_exponent
    owner: LoadResponseCharacteristic
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  q_voltage_exponent:
    name: q_voltage_exponent
    description: Exponent of per unit voltage effecting reactive power.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:LoadResponseCharacteristic.qVoltageExponent
    multivalued: false
    alias: q_voltage_exponent
    owner: LoadResponseCharacteristic
    domain_of:
    - LoadResponseCharacteristic
    range: float
    required: false
  energy_consumer:
    name: energy_consumer
    description: The set of loads that have the response characteristics.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    slot_uri: cim:LoadResponseCharacteristic.EnergyConsumer
    multivalued: true
    alias: energy_consumer
    owner: LoadResponseCharacteristic
    domain_of:
    - EnergyConsumerPhase
    - LoadDynamics
    - LoadResponseCharacteristic
    - EnergyConsumerAction
    range: EnergyConsumer
    required: false
  alias_name:
    name: alias_name
    description: "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.\r\nThe 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.\r\
      \n\r\n"
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.aliasName
    multivalued: false
    alias: alias_name
    owner: LoadResponseCharacteristic
    domain_of:
    - IdentifiedObject
    range: string
    required: false
  description:
    name: description
    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.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.description
    multivalued: false
    alias: description
    owner: LoadResponseCharacteristic
    domain_of:
    - IdentifiedObject
    - NameType
    - NameTypeAuthority
    - DataSet
    - SwitchingStepGroup
    - AreaReserveSpec
    range: string
    required: false
  m_rid:
    name: m_rid
    description: "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.\r\nFor 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."
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.mRID
    multivalued: false
    alias: m_rid
    owner: LoadResponseCharacteristic
    domain_of:
    - IdentifiedObject
    - DataSet
    range: string
    required: false
  diagram_objects:
    name: diagram_objects
    description: The diagram objects that are associated with the domain object.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.DiagramObjects
    multivalued: true
    alias: diagram_objects
    owner: LoadResponseCharacteristic
    domain_of:
    - IdentifiedObject
    range: DiagramObject
    required: false
  instance_set:
    name: instance_set
    description: Dataset containing the data objects.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.InstanceSet
    multivalued: false
    alias: instance_set
    owner: LoadResponseCharacteristic
    domain_of:
    - IdentifiedObject
    range: InstanceSet
    required: true
  names:
    name: names
    description: All names of this identified object.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.Names
    multivalued: true
    alias: names
    owner: LoadResponseCharacteristic
    domain_of:
    - IdentifiedObject
    - NameType
    range: Name
    required: false
  properties_cimdata_object:
    name: properties_cimdata_object
    description: The single CIM data object in the appropriate dataset context.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.PropertiesCIMDataObject
    multivalued: false
    alias: properties_cimdata_object
    owner: LoadResponseCharacteristic
    domain_of:
    - IdentifiedObject
    range: ChangeSetMember
    required: false
  targeting_cimdata_object:
    name: targeting_cimdata_object
    description: Data objects registered.
    from_schema: https://cim.ucaiug.io/ns#TC57CIM
    rank: 1000
    slot_uri: cim:IdentifiedObject.TargetingCIMDataObject
    multivalued: true
    alias: targeting_cimdata_object
    owner: LoadResponseCharacteristic
    domain_of:
    - IdentifiedObject
    range: ChangeSetMember
    required: false
class_uri: cim:LoadResponseCharacteristic