Struct power_flow_data::TwoTerminalDCLine30

pub struct TwoTerminalDCLine30 {

    pub i: LineNum,
    pub mdc: i8,
    pub rdc: f64,
    pub setvl: f64,
    pub vschd: f64,
    pub vcmod: f64,
    pub rcomp: f64,
    pub delti: f64,
    pub meter: ArrayString<1>,
    pub dcvmin: f64,
    pub cccitmx: i32,
    pub cccacc: f64,
    pub ipr: BusNum,
    pub nbr: i32,
    pub alfmx: f64,
    pub alfmn: f64,
    pub rcr: f64,
    pub xcr: f64,
    pub ebasr: f64,
    pub trr: f64,
    pub tapr: f64,
    pub tmxr: f64,
    pub tmnr: f64,
    pub stpr: f64,
    pub icr: BusNum,
    pub ifr: BusNum,
    pub itr: BusNum,
    pub idr: ArrayString<3>,
    pub xcapr: f64,
    pub ipi: BusNum,
    pub nbi: i32,
    pub gammx: f64,
    pub gammn: f64,
    pub rci: f64,
    pub xci: f64,
    pub ebasi: f64,
    pub tri: f64,
    pub tapi: f64,
    pub tmxi: f64,
    pub tmni: f64,
    pub stpi: f64,
    pub ici: BusNum,
    pub ifi: BusNum,
    pub iti: BusNum,
    pub idi: ArrayString<3>,
    pub xcapi: f64,
}

The two-terminal DC transmission line model is used to simulate either a point-to-point system with rectifier and inverter separated by a bipolar or mono-polar transmission system or a Back-to-Back system where the rectifier and inverter are physically located at the same site and separated only by a short bus-bar.

The data requirements fall into three groups:

• Control parameters and set-points
• Converter transformers
• The DC line characteristics

The steady-state model comprising this data enables not only power flow analysis but also establishes the initial steady-state for dynamic analysis.

Fields

i: LineNum

The DC line number.

mdc: i8

Control mode:

• 0 for blocked,
• 1 for power,
• 2 for current. mdc = 0 by default.

rdc: f64

The DC line resistance; entered in ohms. No default.

setvl: f64

Current (amps) or power (MW) demand. When mdc is 1, a positive value of setvl specifies desired power at the rectifier and a negative value specifies desired inverter power. No default.

vschd: f64

Scheduled compounded DC voltage; entered in kV. No default.

vcmod: f64

Mode switch DC voltage; entered in kV. When the inverter DC voltage falls below this value and the line is in power control mode (i.e. mdc = 1), the line switches to current control mode with a desired current corresponding to the desired power at scheduled DC voltage. vcmod = 0.0 by default.

rcomp: f64

Compounding resistance; entered in ohms. Gamma and/or TAPI is used to attempt to hold the compounded voltage (vdci + dccur ∗ rcomp) at vschd.

• To control the inverter end DC voltage VDCI, set rcomp to zero;
• to control the rectifier end DC voltage VDCR, set rcomp to the DC line resistance, rdc;
• otherwise, set rcomp to the appropriate fraction of rdc. rcomp = 0.0 by default.

delti: f64

Margin entered in per unit of desired DC power or current. This is the fraction by which the order is reduced when alpha is at its minimum (alfmn) and the inverter is controlling the line current. delti = 0.0 by default.

meter: ArrayString<1>

Metered end code of either “R” (for rectifier) or “I” (for inverter). meter = “I” by default.

dcvmin: f64

Minimum compounded DC voltage; entered in kV. Only used in constant gamma operation (i.e. when gammx = gammn) when TAPI is held constant and an AC transformer tap is adjusted to control DC voltage (i.e. when ifi, iti, and idi specify a two-winding transformer). dcvmin = 0.0 by default.

cccitmx: i32

Iteration limit for capacitor commutated two-terminal DC line Newton solution procedure. cccitmx = 20 by default.

cccacc: f64

Acceleration factor for capacitor commutated two-terminal DC line Newton solution procedure. cccacc = 1.0 by default.

ipr: BusNum

Rectifier converter bus number, or extended bus name enclosed in single quotes. No default.

nbr: i32

Number of bridges in series (rectifier). No default.

alfmx: f64

Nominal maximum rectifier firing angle; entered in degrees. No default.

alfmn: f64

Minimum steady-state rectifier firing angle; entered in degrees. No default.

rcr: f64

Rectifier commutating transformer resistance per bridge; entered in ohms. No default allowed.

xcr: f64

Rectifier commutating transformer reactance per bridge; entered in ohms. No default allowed.

ebasr: f64

Rectifier primary base AC voltage; entered in kV. No default.

trr: f64

Rectifier transformer ratio. trr = 1.0 by default.

tapr: f64

Rectifier tap setting. tapr = 1.0 by default.

tmxr: f64

Maximum rectifier tap setting. tmxr = 1.5 by default.

tmnr: f64

Minimum rectifier tap setting. tmnr = 0.51 by default.

stpr: f64

Rectifier tap step; must be positive. stpr = 0.00625 by default.

icr: BusNum

Rectifier firing angle measuring bus number, or extended bus name enclosed in single quotes. The firing angle and angle limits used inside the DC model are adjusted by the difference between the phase angles at this bus and the AC/DC interface (i.e. the converter bus, ipr). icr = 0 by default.

ifr: BusNum

Winding one side “from bus” number, or extended bus name enclosed in single quotes, of a two-winding transformer. ifr = 0 by default.

itr: BusNum

Winding two side “to bus” number, or extended bus name enclosed in single quotes, of a two-winding transformer. itr = 0 by default.

idr: ArrayString<3>

Circuit identifier; the branch described by ifr, itr, and idr must have been entered as a two-winding transformer; an AC transformer may control at most only one DC converter. idr = ‘1’ by default.

If no branch is specified, tapr is adjusted to keep alpha within limits; otherwise, tapr is held fixed and this transformer’s tap ratio is adjusted. The adjustment logic assumes that the rectifier converter bus is on the winding two side of the transformer. The limits tmxr and tmnr specified here are used; except for the transformer control mode flag (cod of Transformers), the AC tap adjustment data is ignored.

xcapr: f64

Commutating capacitor reactance magnitude per bridge; entered in ohms. xcapr = 0.0 by default.

ipi: BusNum

Inverter converter bus number, or extended bus name enclosed in single quotes.

nbi: i32

Number of bridges in series (inverter).

gammx: f64

Nominal maximum inverter firing angle; entered in degrees.

gammn: f64

Minimum steady-state inverter firing angle; entered in degrees.

rci: f64

Inverter commutating transformer resistance per bridge; entered in ohms.

xci: f64

Inverter commutating transformer reactance per bridge; entered in ohms.

ebasi: f64

Inverter primary base AC voltage; entered in kV.

tri: f64

Inverter transformer ratio.

tapi: f64

Inverter tap setting.

tmxi: f64

Maximum inverter tap setting.

tmni: f64

Minimum inverter tap setting.

stpi: f64

Inverter tap step; must be positive.

ici: BusNum

Inverter firing angle measuring bus number, or extended bus name enclosed in single quotes.

ifi: BusNum

Winding one side “from bus” number, or extended bus name enclosed in single quotes, of a two-winding transformer.

iti: BusNum

Winding two side “to bus” number, or extended bus name enclosed in single quotes, of a two-winding transformer.

idi: ArrayString<3>

Circuit identifier; the branch described by ifr, itr, and idr must have been entered as a two-winding transformer; an AC transformer may control at most only one DC converter.

xcapi: f64

Commutating capacitor reactance magnitude per bridge; entered in ohms.