Struct power_flow_data::VSCDCLine

source · 
pub struct VSCDCLine {
Show 41 fields
    pub name: ArrayString<15>,
    pub mdc: i8,
    pub rdc: f64,
    pub o1: OwnerNum,
    pub f1: f64,
    pub o2: OwnerNum,
    pub f2: f64,
    pub o3: OwnerNum,
    pub f3: f64,
    pub o4: OwnerNum,
    pub f4: f64,
    pub ibus1: BusNum,
    pub type1: i8,
    pub mode1: i8,
    pub docet1: f64,
    pub acset1: f64,
    pub aloss1: f64,
    pub bloss1: f64,
    pub minloss1: f64,
    pub smax1: f64,
    pub imax1: f64,
    pub pwf1: f64,
    pub maxq1: f64,
    pub minq1: f64,
    pub remot1: BusNum,
    pub rmpct1: f64,
    pub ibus2: BusNum,
    pub type2: i8,
    pub mode2: i8,
    pub docet2: f64,
    pub acset2: f64,
    pub aloss2: f64,
    pub bloss2: f64,
    pub minloss2: f64,
    pub smax2: f64,
    pub imax2: f64,
    pub pwf2: f64,
    pub maxq2: f64,
    pub minq2: f64,
    pub remot2: BusNum,
    pub rmpct2: f64,

}
Expand description

Voltage source converter (VSC) DC lines.

Defines line quantities and control parameters, and the converter buses (converter 1 and converter 2), along with their data quantities and control parameters.

Fields§

§name: ArrayString<15>

The non-blank alphanumeric identifier assigned to this VSC DC line. Each VSC DC line must have a unique name. The name may be up to twelve characters and must be enclosed in single quotes. name may contain any combination of blanks, uppercase letters, numbers and special characters. No default.

§mdc: i8

Control mode:

  • 0 for out-of-service,
  • 1 for in-service. mdc = 1 by default.
§rdc: f64

The DC line resistance entered in ohms. rdc must be positive. No default.

§o1: OwnerNum

An owner number; (1 through the maximum number of owners at the current size level). Each VSC DC line may have up to four owners. See Owner. By default, 01 is 1, and O2, O3 and O4 are zero.

§f1: f64

The fraction of total ownership assigned to owner o1; each F_i must be positive. The F_i values are normalized such that they sum to 1.0 before they are placed in the working case. By default, each F_i is 1.0.

§o2: OwnerNum

An owner number; (1 through the maximum number of owners at the current size level). See Owner. By default, o2 is zero.

§f2: f64

The fraction of total ownership assigned to owner o2; must be positive. By default, f2 is 1.0.

§o3: OwnerNum

An owner number; (1 through the maximum number of owners at the current size level). By default, o3 is zero.

§f3: f64

The fraction of total ownership assigned to owner o2; must be positive. By default, f3 is 1.0.

§o4: OwnerNum

An owner number; (1 through the maximum number of owners at the current size level). By default, o4 is zero.

§f4: f64

The fraction of total ownership assigned to owner o2; must be positive. By default, f4 is 1.0.

§ibus1: BusNum

Converter 1 bus number, or extended bus name enclosed in single quotes. No default.

§type1: i8

Code for the type of converter 1 DC control:

  • 0 for converter out-of-service,
  • 1 for DC voltage control,
  • 2 for MW control. When both converters are in-service, exactly one converter of each VSC DC line must be type 1. No default.
§mode1: i8

Converter 1 AC control mode:

  • 1 for AC voltage control,
  • 2 for fixed AC power factor. mode = 1 by default.
§docet1: f64

Converter 1 DC setpoint.

  • For type = 1, dcset is the scheduled DC voltage on the DC side of the converter bus; entered in kV.
  • For type = 2, dcset is the power demand, where a positive value specifies that the converter is feeding active power into the AC network at bus ibus, and a negative value specifies that the converter is withdrawing active power from the AC network at bus ibus; entered in MW. No default.
§acset1: f64

Converter 1 AC setpoint.

  • For mode = 1, acset is the regulated AC voltage setpoint; entered in pu.
  • For mode = 2, acset is the power factor setpoint. acset = 1.0 by default.
§aloss1: f64

Coefficients of the linear equation used to calculate converter 1 losses: KW_{conv loss} = A_{loss} + I_{dc} * B_{loss} aloss is entered in kW. aloss = bloss = 0.0 by default.

§bloss1: f64

Coefficients of the linear equation used to calculate converter 1 losses: KW_{conv loss} = A_{loss} + I_{dc} * B_{loss} bloss is entered in kW/amp. aloss = bloss = 0.0 by default.

§minloss1: f64

Minimum converter 1 losses; entered in kW. minloss = 0.0 by default.

§smax1: f64

Converter 1 MVA rating; entered in MVA. smax = 0.0 to allow unlimited converter MVA loading. smax = 0.0 by default.

§imax1: f64

Converter 1 AC current rating; entered in amps. imax = 0.0 to allow unlimited converter current loading. If a positive imax is specified, the base voltage assigned to bus ibus must be positive. imax = 0.0 by default.

§pwf1: f64

Power weighting factor fraction (0.0 < pwf < 1.0) used in reducing the active power order and either the reactive power order (when mode is 2) or the reactive power limits (when mode is 1) when the converter MVA or current rating is violated. When pwf is 0.0, only the active power is reduced; when PWF is 1.0, only the reactive power is reduced; otherwise, a weighted reduction of both active and reactive power is applied. pwf = 1.0 by default.

§maxq1: f64

Reactive power upper limit; entered in Mvar. A positive value of reactive power indicates reactive power flowing into the AC network from the converter; a negative value of reactive power indicates reactive power withdrawn from the AC network. Not used if mode = 2. maxq = 9999.0 by default.

§minq1: f64

Reactive power lower limit; entered in Mvar. A positive value of reactive power indicates reactive power flowing into the AC network from the converter; a negative value of reactive power indicates reactive power withdrawn from the AC network. Not used if mode = 2. minq = -9999.0 by default.

§remot1: BusNum

Bus number, or extended bus name enclosed in single quotes, of a remote type 1 or 2 bus whose voltage is to be regulated by this converter to the value specified by acset. If bus remot is other than a type 1 or 2 bus, bus ibus regulates its own voltage to the value specified by acset. remot is entered as zero if the converter is to regulate its own voltage. Not used if mode = 2. remot = 0 by default.

§rmpct1: f64

Percent of the total Mvar required to hold the voltage at the bus controlled by bus ibus that are to be contributed by this VSC; rmpct must be positive. rmpct is needed only if remot specifies a valid remote bus and there is more than one local or remote voltage controlling device (plant, switched shunt, FACTS device shunt element, or VSC DC line converter) controlling the voltage at bus remot to a setpoint, or remot is zero but bus ibus is the controlled bus, local or remote, of one or more other setpoint mode voltage controlling devices. Not used if mode = 2. rmpct = 100.0 by default.

§ibus2: BusNum

Converter 2 bus number, or extended bus name enclosed in single quotes. No default.

§type2: i8

Code for the type of converter 2 DC control

§mode2: i8

Converter 2 AC control mode

§docet2: f64

Converter 2 DC setpoint.

§acset2: f64

Converter 2 AC setpoint.

§aloss2: f64

Coefficient A_{loss} of the linear equation used to calculate converter 2 losses.

§bloss2: f64

Coefficient B_{loss} of the linear equation used to calculate converter 2 losses.

§minloss2: f64

Minimum converter 2 losses; entered in kW. minloss = 0.0 by default.

§smax2: f64

Converter 2 MVA rating; entered in MVA.

§imax2: f64

Converter 2 AC current rating; entered in amps.

§pwf2: f64

Power weighting factor fraction (0.0 < pwf < 1.0) for converter 2.

§maxq2: f64

Reactive power upper limit for converter 2; entered in Mvar.

§minq2: f64

Reactive power lower limit for converter 2; entered in Mvar.

§remot2: BusNum

Bus number to be regulated by converter 2 to the value specified by acset2.

§rmpct2: f64

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.