DER::DERControlBase

Header Image
Project:
DERControlBase : Public Class
Created: 10/24/2012 10:38:50 AM
Modified: 8/16/2022 4:09:03 PM
Project:
Advanced:
Distributed Energy Resource (DER) Control Modes.<br/>
  • Attributes
  • Associations From
  • Advanced
Attribute Scope Type
opModConnect Public boolean
Notes: Set DER as connected (true) or disconnected (false). Used in conjunction with ramp rate when re-connecting. Implies galvanic isolation. If galvanic isolation is not supported, a value of false implies de-energize. If both opModConnect and opModEnergize are present, the values are logically ANDed to determine the connection state.<br/>
opModDeltaVar Public ReactivePowerDeltaControlType
Notes: Change in reactive power, in var. This DERControl mode is relative to the current reactive power input or output at the time the DERControl begins.<br/>
opModDeltaW Public ActivePowerDeltaControlType
Notes: Change in active power, in Watts. This DERControl Mode is relative to the current active power input or output at the time the DERControl begins.<br/>
opModEnergize Public boolean
Notes: Set DER as energized (true) or de-energized (false). Used in conjunction with ramp rate when re-energizing. If both opModConnect and opModEnergize are present, the values are logically ANDed to determine the connection state.<br/>
opModFixedPFAbsorbW Public PowerFactorWithExcitationControlType
Notes: The opModFixedPFAbsorbW function specifies a requested fixed Power Factor (PF) setting for when active power is being absorbed. The actual displacement SHALL be within the limits established by setMinPFOverExcited and setMinPFUnderExcited. If issued simultaneously with other reactive power DERControl Modes (e.g. opModFixedVar) the DERControl Mode resulting in least var magnitude SHOULD take precedence.<br/>
opModFixedPFInjectW Public PowerFactorWithExcitationControlType
Notes: The opModFixedPFInjectW function specifies a requested fixed Power Factor (PF) setting for when active power is being injected. The actual displacement SHALL be within the limits established by setMinPFOverExcited and setMinPFUnderExcited. If issued simultaneously with other reactive power DERControl Modes (e.g. opModFixedVar) the DERControl Mode resulting in least var magnitude SHOULD take precedence.<br/>
opModFixedV Public SignedPerCentControlType
Notes: The opModFixedV function specifies a requested voltage setpoint, in %setVNom (in hundredths).<br/>
opModFixedVar Public FixedVarControlType
Notes: The opModFixedVar function specifies the delivered or received reactive power setpoint.  The context for the setpoint value is determined by refType and SHALL be one of %setMaxW, %setMaxVA, %setMaxVar, or %statVarAvail. If issued simultaneously with other reactive power DERControl Modes (e.g. opModFixedPFInjectW) the DERControl Mode resulting in least var magnitude SHOULD take precedence.<br/>
opModFixedW Public SignedPerCentControlType
Notes: The opModFixedW function specifies a requested received (e.g., charge) or delivered (e.g., discharge) active power setpoint, in %setMaxChargeRateW if negative value or %setMaxW or %setMaxDischargeRateW if positive value (in hundredths).<br/>
opModFreqDroop Public FreqDroopType
Notes: Specifies a frequency-watt operation. This operation limits active power generation or consumption when the line frequency deviates from nominal by a specified amount.<br/>
opModFreqWatt Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 0.  The Frequency-Watt function limits active power generation or consumption when the line frequency deviates from nominal by a specified amount. The Frequency-Watt curve is specified as an array of Frequency-Watt pairs that are interpolated into a piecewise linear function with hysteresis.  The x value of each pair specifies a frequency in Hz. The y value specifies a corresponding active power output in %setMaxW.<br/>
opModGridConnectPermit Public boolean
Notes: Permits (true) or disallows (false) a grid reconnection. This DERControl Mode is likely to be more useful for microgrid controllers.<br/>
opModHFRTMayTrip Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 1. The High Frequency Ride-Through (HFRT) function is specified by one or two duration-frequency curves that define the operating region under high frequency conditions. Each HFRT curve is specified by an array of duration-frequency pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given frequency in seconds). The y value of each pair specifies a frequency, in Hz. This DERControl Mode specifies the "may trip" region.<br/>
opModHFRTMustTrip Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 2.  The High Frequency Ride-Through (HFRT) function is specified by a duration-frequency curve that defines the operating region under high frequency conditions.  Each HFRT curve is specified by an array of duration-frequency pairs that will be interpolated into a piecewise linear function that defines an operating region.  The x value of each pair specifies a duration (time at a given frequency in seconds). The y value of each pair specifies a frequency, in Hz. This DERControl Mode specifies the "must trip" region.<br/>
opModHVRTMayTrip Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 3. The High Voltage Ride-Through (HVRT) function is specified by one, two, or three duration-volt curves that define the operating region under high voltage conditions. Each HVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percentage voltage, defined as ((locally measured voltage - setVRefOfs / setVRef). This DERControl Mode specifies the "may trip" region.<br/>
opModHVRTMomentaryCessation Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 4.  The High Voltage Ride-Through (HVRT) function is specified by duration-volt curves that define the operating region under high voltage conditions.  Each HVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region.  The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef). This DERControl Mode specifies the "momentary cessation" region.<br/>
opModHVRTMustTrip Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 5.  The High Voltage Ride-Through (HVRT) function is specified by duration-volt curves that define the operating region under high voltage conditions.  Each HVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region.  The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef). This DERControl Mode specifies the "must trip" region.<br/>
opModIslandPermit Public boolean
Notes: Permits (true) or disallows (false) grid islanding. This DERControl Mode is likely to be more useful for microgrid controllers.<br/>
opModLFRTMayTrip Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 6. The Low Frequency Ride-Through (LFRT) function is specified by one or two duration-frequency curves that define the operating region under low frequency conditions. Each LFRT curve is specified by an array of duration-frequency pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given frequency in seconds). The y value of each pair specifies a frequency, in Hz. This DERControl Mode specifies the "may trip" region.<br/>
opModLFRTMustTrip Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 7.  The Low Frequency Ride-Through (LFRT) function is specified by a duration-frequency curve that defines the operating region under low frequency conditions.  Each LFRT curve is specified by an array of duration-frequency pairs that will be interpolated into a piecewise linear function that defines an operating region.  The x value of each pair specifies a duration (time at a given frequency in seconds). The y value of each pair specifies a frequency, in Hz. This DERControl Mode specifies the "must trip" region.<br/>
opModLVRTMayTrip Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 8. The Low Voltage Ride-Through (LVRT) function is specified by one, two, or three duration-volt curves that define the operating region under low voltage conditions. Each LVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region. The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef). This DERControl Mode specifies the "may trip" region.<br/>
opModLVRTMomentaryCessation Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 9.  The Low Voltage Ride-Through (LVRT) function is specified by duration-volt curves that define the operating region under low voltage conditions.  Each LVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region.  The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef). This DERControl Mode specifies the "momentary cessation" region.<br/>
opModLVRTMustTrip Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 10.  The Low Voltage Ride-Through (LVRT) function is specified by duration-volt curves that define the operating region under low voltage conditions.  Each LVRT curve is specified by an array of duration-volt pairs that will be interpolated into a piecewise linear function that defines an operating region.  The x value of each pair specifies a duration (time at a given voltage in seconds). The y value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef). This DERControl Mode specifies the "must trip" region.<br/>
opModMaxLimPctVAAbsorb Public PerCentControlType
Notes: The opModMaxLimPctVAAbsorb function sets the maximum apparent power absorption level at the electrical reference point as a percentage of set capacity (%setMaxChargeRateVA, in hundredths). If issued simultaneously with other active or reactive power modes/controls, this mode/control SHOULD take precedence.<br/>
opModMaxLimPctVAInject Public PerCentControlType
Notes: The opModMaxLimPctVAInject function sets the maximum apparent power injection level at the electrical reference point as a percentage of set capacity (%setMaxVA, in hundredths). If issued simultaneously with other active or reactive power modes/controls, this mode/control SHOULD take precedence.<br/>
opModMaxLimPctVarAbsorb Public UnsignedFixedVarControlType
Notes: The opModMaxLimPctVarAbsorb function sets the maximum reactive power absorption level at the electrical reference point as a percentage of set capacity (in hundredths). The context for the setpoint value is determined by refType and SHALL be one of %setMaxW, %setMaxVA, %setMaxVar, or %statVarAvail.<br/>
opModMaxLimPctVarInject Public UnsignedFixedVarControlType
Notes: The opModMaxLimPctVarInject function sets the maximum reactive power injection level at the electrical reference point as a percentage of set capacity (in hundredths). The context for the setpoint value is determined by refType and SHALL be one of %setMaxW, %setMaxVA, %setMaxVar, or %statVarAvail.<br/>
opModMaxLimPctWAbsorb Public PerCentControlType
Notes: The opModMaxLimPctWAbsorb function sets the maximum active power absorption level at the electrical reference point as a percentage of set capacity (%setMaxChargeRateW, in hundredths). This limitation may be met e.g. by increasing PV output or by decreasing active power used to charge associated storage or power other loads.<br/>
opModMaxLimVarAbsorb Public UnsignedReactivePowerControlType
Notes: The opModMaxLimVarAbsorb function sets the maximum reactive power absorption level at the electrical reference point.<br/>
opModMaxLimVarInject Public UnsignedReactivePowerControlType
Notes: The opModMaxLimVarInject function sets the maximum reactive power injection level at the electrical reference point.<br/>
opModMaxLimW Public PerCentControlType
Notes: The opModMaxLimW function sets the maximum active power generation level at the electrical reference point as a percentage of set capacity (%setMaxW, in hundredths). This limitation may be met e.g. by reducing PV output or by using excess PV output to charge associated storage or power other loads.<br/>Note: opModMaxLimW is inconsistently named for historical reasons as its units are PerCent instead of ActivePower. Its preferred name would have been opModMaxLimPctWInject.<br/>
opModMaxLimWAbsorb Public UnsignedActivePowerControlType
Notes: The opModMaxLimWAbsorb function sets the maximum active power absorption level at the electrical reference point. This limitation may be met e.g. by increasing PV output or by decreasing active power used to charge associated storage or power other loads.<br/>
opModMaxLimWInject Public UnsignedActivePowerControlType
Notes: The opModMaxLimWInject function sets the maximum active power generation level at the electrical reference point. This limitation may be met e.g. by reducing PV output or by using excess PV output to charge associated storage or power other loads.<br/>
opModTargetV Public VoltageRMSControlType
Notes: Target output power, in Volts.<br/>
opModTargetVar Public ReactivePowerControlType
Notes: Target reactive power, in var. This DERControl Mode is likely to be more useful for aggregators, as individual DERs may not be able to maintain a target setting.<br/>
opModTargetW Public ActivePowerControlType
Notes: Target output power, in Watts. This DERControl Mode is likely to be more useful for aggregators, as individual DERs may not be able to maintain a target setting.<br/>
opModVoltVar Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 11.  The static volt-var function provides over- or under-excited var compensation as a function of measured voltage. The volt-var curve is specified as an array of volt-var pairs that are interpolated into a piecewise linear function with hysteresis. The x value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef) and SHOULD support a domain of at least 0 - 135. If VRef is present in DERCurve, then the x value of each pair is additionally multiplied by (VRef / 10000). The y value specifies a target var output interpreted as a signed percentage (-100 to 100). The meaning of the y value is determined by yRefType and must be one of %setMaxW, %setMaxVA, %setMaxVar, or %statVarAvail.<br/>
opModVoltWatt Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 12.  The Volt-Watt varies active power as a function of measured voltage. The Volt-Watt curve is specified as an array of Volt-Watt pairs that are interpolated into a piecewise linear function with hysteresis. The x value of each pair specifies an effective percent voltage, defined as ((locally measured voltage - setVRefOfs) / setVRef) and SHOULD support a domain of at least 0 - 135. The y value specifies an active power setting interpreted as a signed percentage (-100 to 100). The meaning of the y value is determined by yRefType and must be one of %setMaxW or %statWAvail.<br/>
opModWattPF Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 13.  The Watt-PF function varies Power Factor (PF) as a function of delivered or received active power. The Watt-PF curve is specified as an array of Watt-PF coordinates that are interpolated into a piecewise linear function with hysteresis. The x value of each pair specifies a watt setting in %setMaxChargeRateW if negative value or %setMaxW or %setMaxDischargeRateW if positive value, (-100 to 100). The PF output setting is an unsigned displacement in the y value with the excitation set according to the excitation boolean. These settings are not expected to be updated very often during the life of the installation, therefore only a single curve is required.  If issued simultaneously with other reactive power DERControl Modes (e.g. opModFixedPFInjectW) the DERControl Mode resulting in least var magnitude SHOULD take precedence.<br/>
opModWattVar Public DERCurveLink
Notes: Specify DERCurveLink for curveType == 14. The Watt-Var function varies vars as a function of delivered or received active power. The Watt-Var curve is specified as an array of Watt-Var pairs that are interpolated into a piecewise linear function with hysteresis. The x value of each pair specifies a watt setting in %setMaxChargeRateW if negative value or %setMaxW or %setMaxDischargeRateW if positive value, (-100 to 100). The y value specifies a target var output interpreted as a signed percentage (-100 to 100). The meaning of the y value is determined by yRefType and must be one of %setMaxW, %setMaxVA, %setMaxVar, or %statVarAvail.<br/>
rampTms Public UInt16
Notes: Requested ramp time, in hundredths of a second, for the device to transition from the current DERControl Mode(s) to the new DERControl Mode(s). If absent, use default ramp rate (setGradW).  Resolution is 1/100 sec.<br/>
Element Source Role Target Role
DefaultDERControl
Class  
Name:  
 
Name:  
 
Details:
 
DERControl
Class  
Name:  
 
Name:  
 
Details:
 
Property Value
isFinalSpecialization: 0