Struct RegulatingControl 

pub struct RegulatingControl {
    pub base: PowerSystemResource,
    pub terminal: Option<MridRef>,
    pub discrete: Option<bool>,
    pub enabled: Option<bool>,
    pub max_allowed_target_value: Option<f64>,
    pub min_allowed_target_value: Option<f64>,
    pub mode: Option<UriRef>,
    pub target_deadband: Option<f64>,
    pub target_value: Option<f64>,
    pub target_value_unit_multiplier: Option<UriRef>,
}

Specifies a set of equipment that works together to control a power system quantity such as voltage or flow. Remote bus voltage control is possible by specifying the controlled terminal located at some place remote from the controlling equipment. The specified terminal shall be associated with the connectivity node of the controlled point. The most specific subtype of RegulatingControl shall be used in case such equipment participate in the control, e.g. TapChangerControl for tap changers. For flow control, load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment. The attribute minAllowedTargetValue and maxAllowedTargetValue are required in the following cases: - For a power generating module operated in power factor control mode to specify maximum and minimum power factor values; - Whenever it is necessary to have an off center target voltage for the tap changer regulator. For instance, due to long cables to off shore wind farms and the need to have a simpler setup at the off shore transformer platform, the voltage is controlled from the land at the connection point for the off shore wind farm. Since there usually is a voltage rise along the cable, there is typical and overvoltage of up 3-4 kV compared to the on shore station. Thus in normal operation the tap changer on the on shore station is operated with a target set point, which is in the lower parts of the dead band. The attributes minAllowedTargetValue and maxAllowedTargetValue are not related to the attribute targetDeadband and thus they are not treated as an alternative of the targetDeadband. They are needed due to limitations in the local substation controller. The attribute targetDeadband is used to prevent the power flow from move the tap position in circles (hunting) that is to be used regardless of the attributes minAllowedTargetValue and maxAllowedTargetValue.

Fields

base: PowerSystemResource

terminal: Option<MridRef>

The terminal associated with this regulating control. The terminal is associated instead of a node, since the terminal could connect into either a topological node or a connectivity node. Sometimes it is useful to model regulation at a terminal of a bus bar object.

discrete: Option<bool>

The regulation is performed in a discrete mode. This applies to equipment with discrete controls, e.g. tap changers and shunt compensators.

enabled: Option<bool>

The flag tells if regulation is enabled.

max_allowed_target_value: Option<f64>

Maximum allowed target value (RegulatingControl.targetValue).

min_allowed_target_value: Option<f64>

Minimum allowed target value (RegulatingControl.targetValue).

mode: Option<UriRef>

The regulating control mode presently available. This specification allows for determining the kind of regulation without need for obtaining the units from a schedule.

target_deadband: Option<f64>

This is a deadband used with discrete control to avoid excessive update of controls like tap changers and shunt compensator banks while regulating. The units of those appropriate for the mode. The attribute shall be a positive value or zero. If RegulatingControl.discrete is set to ‘false’, the RegulatingControl.targetDeadband is to be ignored. Note that for instance, if the targetValue is 100 kV and the targetDeadband is 2 kV the range is from 99 to 101 kV.

target_value: Option<f64>

The target value specified for case input. This value can be used for the target value without the use of schedules. The value has the units appropriate to the mode attribute.

target_value_unit_multiplier: Option<UriRef>

Specify the multiplier for used for the targetValue.

Implementations

impl RegulatingControl

pub fn from_block(b: &RdfBlock) -> Self

Trait Implementations

impl CimElement for RegulatingControl

fn mrid(&self) -> &str

fn type_name(&self) -> &'static str

fn as_any(&self) -> &dyn Any

fn to_json_value(&self) -> Value

fn to_block(&self) -> RdfBlock

impl Clone for RegulatingControl

fn clone(&self) -> RegulatingControl

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RegulatingControl

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RegulatingControl

fn default() -> RegulatingControl

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RegulatingControl

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RegulatingControl

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.