Skip to content

Commit

Permalink
Merge pull request #1181 from NREL-Sienna/rh/add_more_honduras_structs
Browse files Browse the repository at this point in the history 
Add ST8C
  • Loading branch information
@jd-lara
jd-lara authored Aug 28, 2024
2 parents deb98f3 + 3ce7468 commit fd3de10
Show file tree
Hide file tree
Showing 5 changed files with 681 additions and 0 deletions.
1 change: 1 addition & 0 deletions src/PowerSystems.jl
View file
Original file line number Diff line number Diff line change
Expand Up @@ -142,6 +142,7 @@ export ESST4B
export ST6B
export SCRX
export SEXS
export ST8C

#Machine Exports
export Machine
Expand Down
319 changes: 319 additions & 0 deletions src/descriptors/power_system_structs.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8200,6 +8200,325 @@
],
"supertype": "AVR"
},
{
"struct_name": "ST8C",
"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",
"fields": [
{
"name": "OEL_Flag",
"comment": "OEL Flag for ST8C: <2: Summation at Voltage Error, 2: OEL takeover at gate",
"null_value": 0,
"data_type": "Int",
"valid_range": {
"min": 0,
"max": 2
}
},
{
"name": "UEL_Flag",
"comment": "UEL Flag for ST8C: <2: Summation at Voltage Error, 2: UEL takeover at gate",
"null_value": 0,
"data_type": "Int",
"valid_range": {
"min": 0,
"max": 2
}
},
{
"name": "SCL_Flag",
"comment": "SCL Flag for ST8C: <2: Summation at Voltage Error, 2: SCL Takeover at UEL and OEL gates",
"null_value": 0,
"data_type": "Int",
"valid_range": {
"min": 0,
"max": 2
}
},
{
"name": "SW1_Flag",
"comment": "SW1 Flag for Power Source Selector for ST8C: <2: Source from generator terminal voltage, 2: Independent power source",
"null_value": 0,
"data_type": "Int",
"valid_range": {
"min": 0,
"max": 2
}
},
{
"name": "Tr",
"comment": "Regulator input filter time constant in seconds",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "K_pr",
"comment": "Regulator proportional gain (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "K_ir",
"comment": "Regulator integral gain (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "Vpi_lim",
"comment": "Regulator input limits (Vpi_min, Vpi_max)",
"null_value": "(min=0.0, max=0.0)",
"data_type": "MinMax"
},
{
"name": "K_pa",
"comment": "Field current regulator proportional gain (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "K_ia",
"comment": "Field current regulator integral gain (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "Va_lim",
"comment": "Field current regulator output limits (Va_min, Va_max)",
"null_value": "(min=0.0, max=0.0)",
"data_type": "MinMax"
},
{
"name": "K_a",
"comment": "Field current regulator proportional gain (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "T_a",
"comment": "Controlled rectifier bridge equivalent time constant in seconds",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "Vr_lim",
"comment": "Voltage regulator limits (Vr_min, Vr_max)",
"null_value": "(min=0.0, max=0.0)",
"data_type": "MinMax"
},
{
"name": "K_f",
"comment": "Exciter field current feedback gain (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "T_f",
"comment": "Field current feedback time constant in seconds",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "K_c1",
"comment": "Rectifier loading factor proportional to commutating reactance (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "K_p",
"comment": "Potential circuit (voltage) gain coefficient (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "K_i1",
"comment": "Potential circuit (current) gain coefficient (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "X_l",
"comment": "Reactance associated with potential source (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "θ_p",
"comment": "Potential circuit phase angle (degrees)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "VB1_max",
"comment": "Maximum available exciter voltage (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "K_c2",
"comment": "Rectifier loading factor proportional to commutating reactance (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "K_i2",
"comment": "Potential circuit (current) gain coefficient (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "VB2_max",
"comment": "Maximum available exciter voltage (pu)",
"null_value": 0,
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
},
"validation_action": "warn"
},
{
"name": "V_ref",
"comment": "Reference Voltage Set-point (pu)",
"null_value": 0,
"default": "1.0",
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
}
},
{
"name": "Ifd_ref",
"comment": "Reference Field Current Set-point (pu)",
"null_value": 0,
"default": "1.0",
"data_type": "Float64",
"valid_range": {
"min": 0,
"max": null
}
},
{
"name": "ext",
"comment": "An [*ext*ra dictionary](@ref additional_fields) for users to add metadata that are not used in simulation, such as latitude and longitude.",
"data_type": "Dict{String, Any}",
"null_value": "Dict{String, Any}()",
"default": "Dict{String, Any}()"
},
{
"name": "states",
"exclude_setter": true,
"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",
"internal_default": "[:Vm, :x_a1, :x_a2, :x_a3, :x_a4]",
"data_type": "Vector{Symbol}"
},
{
"name": "n_states",
"exclude_setter": true,
"comment": "(**Do not modify.**) ST8C has 5 states",
"internal_default": 5,
"data_type": "Int"
},
{
"name": "states_types",
"comment": "(**Do not modify.**) ST8C has 5 states",
"internal_default": "[StateTypes.Hybrid, StateTypes.Hybrid, StateTypes.Hybrid, StateTypes.Hybrid, StateTypes.Hybrid]",
"data_type": "Vector{StateTypes}"
},
{
"name": "internal",
"comment": "(**Do not modify.**) PowerSystems.jl internal reference",
"data_type": "InfrastructureSystemsInternal",
"internal_default": "InfrastructureSystemsInternal()",
"exclude_setter": true
}
],
"supertype": "AVR"
},
{
"struct_name": "EXST1",
"docstring": "IEEE Type ST1 Excitation System (PTI version)",
Expand Down
Loading

0 comments on commit fd3de10

Please sign in to comment.