Skip to content

Commit fd3de10

Browse files
jd-larajd-lara
authored
Merge pull request #1181 from NREL-Sienna/rh/add_more_honduras_structs
Add ST8C
2 parents deb98f3 + 3ce7468 commit fd3de10

File tree

5 files changed

+681
-0
lines changed

5 files changed

+681
-0
lines changed

‎src/PowerSystems.jl

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,7 @@ export ESST4B
142142
export ST6B
143143
export SCRX
144144
export SEXS
145+
export ST8C
145146

146147
#Machine Exports
147148
export Machine

‎src/descriptors/power_system_structs.json

Lines changed: 319 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8200,6 +8200,325 @@
82008200
],
82018201
"supertype": "AVR"
82028202
},
8203+
{
8204+
"struct_name": "ST8C",
8205+
"docstring": "In these excitation systems, voltage (and also current in compounded systems) is transformed to an appropriate level. Rectifiers, either controlled or non-controlled, provide the necessary direct current for the generator field.\nParameters of IEEE Std 421.5 Type ST8C Excitacion System. ST8C in PSSE and PSLF",
8206+
"fields": [
8207+
{
8208+
"name": "OEL_Flag",
8209+
"comment": "OEL Flag for ST8C: <2: Summation at Voltage Error, 2: OEL takeover at gate",
8210+
"null_value": 0,
8211+
"data_type": "Int",
8212+
"valid_range": {
8213+
"min": 0,
8214+
"max": 2
8215+
}
8216+
},
8217+
{
8218+
"name": "UEL_Flag",
8219+
"comment": "UEL Flag for ST8C: <2: Summation at Voltage Error, 2: UEL takeover at gate",
8220+
"null_value": 0,
8221+
"data_type": "Int",
8222+
"valid_range": {
8223+
"min": 0,
8224+
"max": 2
8225+
}
8226+
},
8227+
{
8228+
"name": "SCL_Flag",
8229+
"comment": "SCL Flag for ST8C: <2: Summation at Voltage Error, 2: SCL Takeover at UEL and OEL gates",
8230+
"null_value": 0,
8231+
"data_type": "Int",
8232+
"valid_range": {
8233+
"min": 0,
8234+
"max": 2
8235+
}
8236+
},
8237+
{
8238+
"name": "SW1_Flag",
8239+
"comment": "SW1 Flag for Power Source Selector for ST8C: <2: Source from generator terminal voltage, 2: Independent power source",
8240+
"null_value": 0,
8241+
"data_type": "Int",
8242+
"valid_range": {
8243+
"min": 0,
8244+
"max": 2
8245+
}
8246+
},
8247+
{
8248+
"name": "Tr",
8249+
"comment": "Regulator input filter time constant in seconds",
8250+
"null_value": 0,
8251+
"data_type": "Float64",
8252+
"valid_range": {
8253+
"min": 0,
8254+
"max": null
8255+
},
8256+
"validation_action": "warn"
8257+
},
8258+
{
8259+
"name": "K_pr",
8260+
"comment": "Regulator proportional gain (pu)",
8261+
"null_value": 0,
8262+
"data_type": "Float64",
8263+
"valid_range": {
8264+
"min": 0,
8265+
"max": null
8266+
},
8267+
"validation_action": "warn"
8268+
},
8269+
{
8270+
"name": "K_ir",
8271+
"comment": "Regulator integral gain (pu)",
8272+
"null_value": 0,
8273+
"data_type": "Float64",
8274+
"valid_range": {
8275+
"min": 0,
8276+
"max": null
8277+
},
8278+
"validation_action": "warn"
8279+
},
8280+
{
8281+
"name": "Vpi_lim",
8282+
"comment": "Regulator input limits (Vpi_min, Vpi_max)",
8283+
"null_value": "(min=0.0, max=0.0)",
8284+
"data_type": "MinMax"
8285+
},
8286+
{
8287+
"name": "K_pa",
8288+
"comment": "Field current regulator proportional gain (pu)",
8289+
"null_value": 0,
8290+
"data_type": "Float64",
8291+
"valid_range": {
8292+
"min": 0,
8293+
"max": null
8294+
},
8295+
"validation_action": "warn"
8296+
},
8297+
{
8298+
"name": "K_ia",
8299+
"comment": "Field current regulator integral gain (pu)",
8300+
"null_value": 0,
8301+
"data_type": "Float64",
8302+
"valid_range": {
8303+
"min": 0,
8304+
"max": null
8305+
},
8306+
"validation_action": "warn"
8307+
},
8308+
{
8309+
"name": "Va_lim",
8310+
"comment": "Field current regulator output limits (Va_min, Va_max)",
8311+
"null_value": "(min=0.0, max=0.0)",
8312+
"data_type": "MinMax"
8313+
},
8314+
{
8315+
"name": "K_a",
8316+
"comment": "Field current regulator proportional gain (pu)",
8317+
"null_value": 0,
8318+
"data_type": "Float64",
8319+
"valid_range": {
8320+
"min": 0,
8321+
"max": null
8322+
},
8323+
"validation_action": "warn"
8324+
},
8325+
{
8326+
"name": "T_a",
8327+
"comment": "Controlled rectifier bridge equivalent time constant in seconds",
8328+
"null_value": 0,
8329+
"data_type": "Float64",
8330+
"valid_range": {
8331+
"min": 0,
8332+
"max": null
8333+
},
8334+
"validation_action": "warn"
8335+
},
8336+
{
8337+
"name": "Vr_lim",
8338+
"comment": "Voltage regulator limits (Vr_min, Vr_max)",
8339+
"null_value": "(min=0.0, max=0.0)",
8340+
"data_type": "MinMax"
8341+
},
8342+
{
8343+
"name": "K_f",
8344+
"comment": "Exciter field current feedback gain (pu)",
8345+
"null_value": 0,
8346+
"data_type": "Float64",
8347+
"valid_range": {
8348+
"min": 0,
8349+
"max": null
8350+
},
8351+
"validation_action": "warn"
8352+
},
8353+
{
8354+
"name": "T_f",
8355+
"comment": "Field current feedback time constant in seconds",
8356+
"null_value": 0,
8357+
"data_type": "Float64",
8358+
"valid_range": {
8359+
"min": 0,
8360+
"max": null
8361+
},
8362+
"validation_action": "warn"
8363+
},
8364+
{
8365+
"name": "K_c1",
8366+
"comment": "Rectifier loading factor proportional to commutating reactance (pu)",
8367+
"null_value": 0,
8368+
"data_type": "Float64",
8369+
"valid_range": {
8370+
"min": 0,
8371+
"max": null
8372+
},
8373+
"validation_action": "warn"
8374+
},
8375+
{
8376+
"name": "K_p",
8377+
"comment": "Potential circuit (voltage) gain coefficient (pu)",
8378+
"null_value": 0,
8379+
"data_type": "Float64",
8380+
"valid_range": {
8381+
"min": 0,
8382+
"max": null
8383+
},
8384+
"validation_action": "warn"
8385+
},
8386+
{
8387+
"name": "K_i1",
8388+
"comment": "Potential circuit (current) gain coefficient (pu)",
8389+
"null_value": 0,
8390+
"data_type": "Float64",
8391+
"valid_range": {
8392+
"min": 0,
8393+
"max": null
8394+
},
8395+
"validation_action": "warn"
8396+
},
8397+
{
8398+
"name": "X_l",
8399+
"comment": "Reactance associated with potential source (pu)",
8400+
"null_value": 0,
8401+
"data_type": "Float64",
8402+
"valid_range": {
8403+
"min": 0,
8404+
"max": null
8405+
},
8406+
"validation_action": "warn"
8407+
},
8408+
{
8409+
"name": "θ_p",
8410+
"comment": "Potential circuit phase angle (degrees)",
8411+
"null_value": 0,
8412+
"data_type": "Float64",
8413+
"valid_range": {
8414+
"min": 0,
8415+
"max": null
8416+
},
8417+
"validation_action": "warn"
8418+
},
8419+
{
8420+
"name": "VB1_max",
8421+
"comment": "Maximum available exciter voltage (pu)",
8422+
"null_value": 0,
8423+
"data_type": "Float64",
8424+
"valid_range": {
8425+
"min": 0,
8426+
"max": null
8427+
},
8428+
"validation_action": "warn"
8429+
},
8430+
{
8431+
"name": "K_c2",
8432+
"comment": "Rectifier loading factor proportional to commutating reactance (pu)",
8433+
"null_value": 0,
8434+
"data_type": "Float64",
8435+
"valid_range": {
8436+
"min": 0,
8437+
"max": null
8438+
},
8439+
"validation_action": "warn"
8440+
},
8441+
{
8442+
"name": "K_i2",
8443+
"comment": "Potential circuit (current) gain coefficient (pu)",
8444+
"null_value": 0,
8445+
"data_type": "Float64",
8446+
"valid_range": {
8447+
"min": 0,
8448+
"max": null
8449+
},
8450+
"validation_action": "warn"
8451+
},
8452+
{
8453+
"name": "VB2_max",
8454+
"comment": "Maximum available exciter voltage (pu)",
8455+
"null_value": 0,
8456+
"data_type": "Float64",
8457+
"valid_range": {
8458+
"min": 0,
8459+
"max": null
8460+
},
8461+
"validation_action": "warn"
8462+
},
8463+
{
8464+
"name": "V_ref",
8465+
"comment": "Reference Voltage Set-point (pu)",
8466+
"null_value": 0,
8467+
"default": "1.0",
8468+
"data_type": "Float64",
8469+
"valid_range": {
8470+
"min": 0,
8471+
"max": null
8472+
}
8473+
},
8474+
{
8475+
"name": "Ifd_ref",
8476+
"comment": "Reference Field Current Set-point (pu)",
8477+
"null_value": 0,
8478+
"default": "1.0",
8479+
"data_type": "Float64",
8480+
"valid_range": {
8481+
"min": 0,
8482+
"max": null
8483+
}
8484+
},
8485+
{
8486+
"name": "ext",
8487+
"comment": "An [*ext*ra dictionary](@ref additional_fields) for users to add metadata that are not used in simulation, such as latitude and longitude.",
8488+
"data_type": "Dict{String, Any}",
8489+
"null_value": "Dict{String, Any}()",
8490+
"default": "Dict{String, Any}()"
8491+
},
8492+
{
8493+
"name": "states",
8494+
"exclude_setter": true,
8495+
"comment": "(**Do not modify.**) The [states](@ref S) are:\n\tVm: Sensed terminal voltage,\n\tx_a1: Regulator Integrator state,\n\tx_a2: Field Current regulator state,\n\tx_a3: Controller rectifier bridge state,\n\tx_a4: Regulator Feedback state",
8496+
"internal_default": "[:Vm, :x_a1, :x_a2, :x_a3, :x_a4]",
8497+
"data_type": "Vector{Symbol}"
8498+
},
8499+
{
8500+
"name": "n_states",
8501+
"exclude_setter": true,
8502+
"comment": "(**Do not modify.**) ST8C has 5 states",
8503+
"internal_default": 5,
8504+
"data_type": "Int"
8505+
},
8506+
{
8507+
"name": "states_types",
8508+
"comment": "(**Do not modify.**) ST8C has 5 states",
8509+
"internal_default": "[StateTypes.Hybrid, StateTypes.Hybrid, StateTypes.Hybrid, StateTypes.Hybrid, StateTypes.Hybrid]",
8510+
"data_type": "Vector{StateTypes}"
8511+
},
8512+
{
8513+
"name": "internal",
8514+
"comment": "(**Do not modify.**) PowerSystems.jl internal reference",
8515+
"data_type": "InfrastructureSystemsInternal",
8516+
"internal_default": "InfrastructureSystemsInternal()",
8517+
"exclude_setter": true
8518+
}
8519+
],
8520+
"supertype": "AVR"
8521+
},
82038522
{
82048523
"struct_name": "EXST1",
82058524
"docstring": "IEEE Type ST1 Excitation System (PTI version)",

0 commit comments

Comments
 (0)