{ "cells": [ { "cell_type": "markdown", "source": [ "Line Modeling simulation with [PowerSimulationsDynamics.jl](https://github.com/NREL-SIIP/PowerSimulationsDynamics.jl)" ], "metadata": {} }, { "cell_type": "markdown", "source": [ "**Originally Contributed by**: José Daniel Lara" ], "metadata": {} }, { "cell_type": "markdown", "source": [ "## Introduction" ], "metadata": {} }, { "cell_type": "markdown", "source": [ "This tutorial will introduce the modeling of an inverter with Virtual Innertia in a multi-machine\n", "model of the system. We will load the data directly from PSS/e dynamic files" ], "metadata": {} }, { "cell_type": "markdown", "source": [ "The tutorial uses a modified 14-bus system on which all the synchronous machines have been\n", "substitued by generators with ESAC1A AVR's and no Turbine Governors." ], "metadata": {} }, { "cell_type": "markdown", "source": [ "In the first portion of the tutorial we will simulate the system with the original data and\n", "cause a line trip between Buses 2 and 4. In the second part of the simulation, we will switch\n", "generator 6 with a battery using an inverter and perform the same fault." ], "metadata": {} }, { "cell_type": "markdown", "source": [ "Load the packages" ], "metadata": {} }, { "outputs": [ { "output_type": "execute_result", "data": { "text/plain": "Plots.GRBackend()" }, "metadata": {}, "execution_count": 1 } ], "cell_type": "code", "source": [ "using SIIPExamples # Only needed for the tutorial, comment if you want to run\n", "import DisplayAs # Only needed for the tutorial\n", "using PowerSimulationsDynamics\n", "PSID = PowerSimulationsDynamics\n", "using PowerSystems\n", "using Logging\n", "using Sundials\n", "using Plots\n", "gr()" ], "metadata": {}, "execution_count": 1 }, { "cell_type": "markdown", "source": [ "Create the system" ], "metadata": {} }, { "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[ Info: The PSS(R)E parser currently supports buses, loads, shunts, generators, branches, transformers, and dc lines\n", "[ Info: The following fields in GENERATOR are missing: O2, F2, O3, F3, O4, F4, WMOD, WPF\n", "[ Info: The following fields in GENERATOR are missing: O2, F2, O3, F3, O4, F4, WMOD, WPF\n", "[ Info: The following fields in GENERATOR are missing: O2, F2, O3, F3, O4, F4, WMOD, WPF\n", "[ Info: The following fields in GENERATOR are missing: O2, F2, O3, F3, O4, F4, WMOD, WPF\n", "[ Info: The following fields in GENERATOR are missing: O2, F2, O3, F3, O4, F4, WMOD, WPF\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: angmin and angmax values are 0, widening these values on branch 4 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 1 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 12 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 20 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 2 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 6 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 11 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 13 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 5 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 15 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 16 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 14 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 7 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 8 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 17 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 10 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 19 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 9 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 18 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 3 to +/- 60.0 deg.\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 4 to 651.7693\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 1 to 1943.3753\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 12 to 1340.1421\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 20 to 686.916\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 2 to 527.2551\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 6 to 658.7239\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 11 to 1099.9023\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 13 to 404.9974\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 5 to 661.3166\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 15 to 406.1471\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 16 to 312.073\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 14 to 579.3328\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 7 to 2739.0808\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 8 to 548.9677\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 17 to 578.6164\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 10 to 828.1844\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 19 to 480.1216\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 9 to 426.3491\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 18 to 217.5559\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 3 to 594.6825\n", "┌ Info: Constructing System from Power Models\n", "│ data[\"name\"] = \"14bus\"\n", "└ data[\"source_type\"] = \"pti\"\n", "[ Info: Reading bus data\n", "[ Info: Reading generator data\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -399.96\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-6-1 (ThermalStandard):\n", "│ name: generator-6-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 06 (Bus)\n", "│ active_power: 0.15\n", "│ reactive_power: 0.14800000000000002\n", "│ rating: 99.99028802838804\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -0.06, max = 0.24)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 25.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: nothing\n", "│ ext: Dict{String,Any}(\"z_source\" => (r = 0.0, x = 0.12))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -16.258536585365853\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-1-1 (ThermalStandard):\n", "│ name: generator-1-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 01 (Bus)\n", "│ active_power: 1.9333000000000002\n", "│ reactive_power: 0.01121\n", "│ rating: 100.48880584423323\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -10.0, max = 10.0)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 615.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: nothing\n", "│ ext: Dict{String,Any}(\"z_source\" => (r = 0.0, x = 0.23))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -399.96\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-8-1 (ThermalStandard):\n", "│ name: generator-8-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 08 (Bus)\n", "│ active_power: 0.1\n", "│ reactive_power: 0.22292\n", "│ rating: 99.99028802838804\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -0.06, max = 0.24)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 25.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: nothing\n", "│ ext: Dict{String,Any}(\"z_source\" => (r = 0.0, x = 0.12))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -166.65\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-2-1 (ThermalStandard):\n", "│ name: generator-2-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 02 (Bus)\n", "│ active_power: 0.3\n", "│ reactive_power: 0.27015999999999996\n", "│ rating: 99.99125011719775\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -0.4, max = 0.5)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 60.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: nothing\n", "│ ext: Dict{String,Any}(\"z_source\" => (r = 0.0, x = 0.13))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -166.65\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-3-1 (ThermalStandard):\n", "│ name: generator-3-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 03 (Bus)\n", "│ active_power: 0.2\n", "│ reactive_power: 0.21719000000000002\n", "│ rating: 99.99080007680706\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = 0.0, max = 0.4)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 60.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: nothing\n", "│ ext: Dict{String,Any}(\"z_source\" => (r = 0.0, x = 0.13))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "[ Info: Reading branch data\n", "┌ Warning: Rate 651.77 MW for BUS 02-BUS 04-i_4 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1943.38 MW for BUS 01-BUS 02-i_1 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1340.14 MW for BUS 09-BUS 10-i_12 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 527.26 MW for BUS 01-BUS 05-i_2 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 658.72 MW for BUS 03-BUS 04-i_6 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1099.9 MW for BUS 07-BUS 09-i_11 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 405.0 MW for BUS 09-BUS 14-i_13 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 661.32 MW for BUS 02-BUS 05-i_5 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 406.15 MW for BUS 12-BUS 13-i_15 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 312.07 MW for BUS 13-BUS 14-i_16 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 579.33 MW for BUS 10-BUS 11-i_14 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 2739.08 MW for BUS 04-BUS 05-i_7 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 548.97 MW for BUS 06-BUS 11-i_8 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 828.18 MW for BUS 06-BUS 13-i_10 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 426.35 MW for BUS 06-BUS 12-i_9 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 594.68 MW for BUS 02-BUS 03-i_3 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "[ Info: Reading branch data\n", "[ Info: Reading DC Line data\n", "[ Info: Reading storage data\n", "[ Info: Generators provided in .dyr, without a generator in .raw file will be skipped.\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n" ] }, { "output_type": "execute_result", "data": { "text/plain": "System\n======\nSystem Units Base: SYSTEM_BASE\nBase Power: 100.0\nBase Frequency: 60.0\n\nComponents\n==========\nNum components: 77\n\n\u001b[1m11×3 DataFrame\u001b[0m\n\u001b[1m Row \u001b[0m│\u001b[1m ConcreteType \u001b[0m\u001b[1m SuperTypes \u001b[0m\u001b[1m C\u001b[0m ⋯\n\u001b[1m \u001b[0m│\u001b[90m String \u001b[0m\u001b[90m String \u001b[0m\u001b[90m I\u001b[0m ⋯\n─────┼──────────────────────────────────────────────────────────────────────────\n 1 │ Arc Topology <: Component <: Infrast… ⋯\n 2 │ Area AggregationTopology <: Topology …\n 3 │ Bus Topology <: Component <: Infrast…\n 4 │ DynamicGenerator{RoundRotorQuadr… DynamicInjection <: Device <: Co…\n 5 │ DynamicGenerator{RoundRotorQuadr… DynamicInjection <: Device <: Co… ⋯\n 6 │ Line ACBranch <: Branch <: Device <: …\n 7 │ LoadZone AggregationTopology <: Topology …\n 8 │ PowerLoad StaticLoad <: ElectricLoad <: St…\n 9 │ TapTransformer ACBranch <: Branch <: Device <: … ⋯\n 10 │ ThermalStandard ThermalGen <: Generator <: Stati…\n 11 │ Transformer2W ACBranch <: Branch <: Device <: …\n\u001b[36m 1 column omitted\u001b[0m\n\nTimeSeriesContainer\n===================\nComponents with time series data: 0\nTotal StaticTimeSeries: 0\nTotal Forecasts: 0\n", "text/html": [ "

System

\n", "

Base Power: 100.0

\n", "

Components

\n", "

Num components: 77

\n", "

11 rows × 3 columns (omitted printing of 1 columns)

ConcreteTypeSuperTypes
StringString
1ArcTopology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
2AreaAggregationTopology <: Topology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
3BusTopology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
4DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,GasTG,PSSFixed}DynamicInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
5DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,TGFixed,PSSFixed}DynamicInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
6LineACBranch <: Branch <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
7LoadZoneAggregationTopology <: Topology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
8PowerLoadStaticLoad <: ElectricLoad <: StaticInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
9TapTransformerACBranch <: Branch <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
10ThermalStandardThermalGen <: Generator <: StaticInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
11Transformer2WACBranch <: Branch <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
\n", "\n", "

TimeSeriesContainer

\n", "

Components with time series data: 0

\n", "

Total StaticTimeSeries: 0

\n", "

Total Forecasts: 0

\n", "

Resolution: 0 seconds

\n" ] }, "metadata": {}, "execution_count": 2 } ], "cell_type": "code", "source": [ "file_dir = joinpath(\n", " dirname(dirname(pathof(SIIPExamples))),\n", " \"script\",\n", " \"4_PowerSimulationsDynamics_examples\",\n", " \"Data\",\n", ")\n", "\n", "sys = System(joinpath(file_dir, \"14bus.raw\"), joinpath(file_dir, \"dyn_data.dyr\"))" ], "metadata": {}, "execution_count": 2 }, { "cell_type": "markdown", "source": [ "Define Simulation Problem with a 20 second simulation period and the branch trip at t = 1.0" ], "metadata": {} }, { "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[ Info: Serialized time series data to /var/folders/27/2jr8c7gn4j72fvrg4qt81zrw8w_711/T/jl_Ynz8dS/sys_time_series_storage.h5.\n", "[ Info: Serialized System to /var/folders/27/2jr8c7gn4j72fvrg4qt81zrw8w_711/T/jl_Ynz8dS/sys.json\n", "[ Info: Loaded time series from storage file existing=sys_time_series_storage.h5 new=/var/folders/27/2jr8c7gn4j72fvrg4qt81zrw8w_711/T/jl_39VPVV\n", "┌ Warning: Rate 2739.08 MW for BUS 04-BUS 05-i_7 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 406.15 MW for BUS 12-BUS 13-i_15 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 661.32 MW for BUS 02-BUS 05-i_5 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 527.26 MW for BUS 01-BUS 05-i_2 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 579.33 MW for BUS 10-BUS 11-i_14 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 828.18 MW for BUS 06-BUS 13-i_10 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 405.0 MW for BUS 09-BUS 14-i_13 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 594.68 MW for BUS 02-BUS 03-i_3 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 548.97 MW for BUS 06-BUS 11-i_8 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 651.77 MW for BUS 02-BUS 04-i_4 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 658.72 MW for BUS 03-BUS 04-i_6 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 312.07 MW for BUS 13-BUS 14-i_16 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 426.35 MW for BUS 06-BUS 12-i_9 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1340.14 MW for BUS 09-BUS 10-i_12 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1099.9 MW for BUS 07-BUS 09-i_11 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1943.38 MW for BUS 01-BUS 02-i_1 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -166.65\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-3-1 (ThermalStandard):\n", "│ name: generator-3-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 03 (Bus)\n", "│ active_power: 0.2\n", "│ reactive_power: 0.21719000000000002\n", "│ rating: 99.99080007680706\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = 0.0, max = 0.4)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 60.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: generator-3-1 (DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,TGFixed,PSSFixed})\n", "│ ext: Dict{String,Any}(\"z_source\" => Dict{String,Any}(\"x\" => 0.13,\"r\" => 0))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -399.96\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-8-1 (ThermalStandard):\n", "│ name: generator-8-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 08 (Bus)\n", "│ active_power: 0.1\n", "│ reactive_power: 0.22292\n", "│ rating: 99.99028802838804\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -0.06, max = 0.24)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 25.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: generator-8-1 (DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,TGFixed,PSSFixed})\n", "│ ext: Dict{String,Any}(\"z_source\" => Dict{String,Any}(\"x\" => 0.12,\"r\" => 0))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -16.258536585365853\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-1-1 (ThermalStandard):\n", "│ name: generator-1-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 01 (Bus)\n", "│ active_power: 1.9333000000000002\n", "│ reactive_power: 0.01121\n", "│ rating: 100.48880584423323\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -10.0, max = 10.0)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 615.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: generator-1-1 (DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,GasTG,PSSFixed})\n", "│ ext: Dict{String,Any}(\"z_source\" => Dict{String,Any}(\"x\" => 0.23,\"r\" => 0))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -166.65\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-2-1 (ThermalStandard):\n", "│ name: generator-2-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 02 (Bus)\n", "│ active_power: 0.3\n", "│ reactive_power: 0.27015999999999996\n", "│ rating: 99.99125011719775\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -0.4, max = 0.5)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 60.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: generator-2-1 (DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,TGFixed,PSSFixed})\n", "│ ext: Dict{String,Any}(\"z_source\" => Dict{String,Any}(\"x\" => 0.13,\"r\" => 0))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -399.96\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-6-1 (ThermalStandard):\n", "│ name: generator-6-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 06 (Bus)\n", "│ active_power: 0.15\n", "│ reactive_power: 0.14800000000000002\n", "│ rating: 99.99028802838804\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -0.06, max = 0.24)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 25.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: generator-6-1 (DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,TGFixed,PSSFixed})\n", "│ ext: Dict{String,Any}(\"z_source\" => Dict{String,Any}(\"x\" => 0.12,\"r\" => 0))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "[ Info: Unit System changed to UnitSystem.DEVICE_BASE = 1\n", "[ Info: The System has no islands\n", "[ Info: Initializing Simulation States\n", "[ Info: Unit System changed to UnitSystem.SYSTEM_BASE = 0\n", "[ Info: The System has no islands\n", "[ Info: PowerFlow solve converged, the results have been stored in the system\n", "[ Info: Unit System changed to UnitSystem.DEVICE_BASE = 1\n", "[ Info: Attaching Perturbations\n", "[ Info: Completed Build Successfully. Simulations status = BUILT\n" ] }, { "output_type": "execute_result", "data": { "text/plain": "Simulation()\n" }, "metadata": {}, "execution_count": 3 } ], "cell_type": "code", "source": [ "sim = PSID.Simulation(\n", " file_dir, #path for the simulation output\n", " sys, #system\n", " (0.0, 20.0), #time span\n", " BranchTrip(1.0, \"BUS 02-BUS 04-i_4\");\n", " console_level = Logging.Info,\n", ")" ], "metadata": {}, "execution_count": 3 }, { "cell_type": "markdown", "source": [ "Now that the system is initialized, we can verify the system states for potential issues." ], "metadata": {} }, { "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Voltage Variables\n", "====================\n", "BUS 01\n", "====================\n", "Vm 1.06\n", "θ 0.0\n", "====================\n", "BUS 02\n", "====================\n", "Vm 1.04\n", "θ -0.0711\n", "====================\n", "BUS 03\n", "====================\n", "Vm 1.01\n", "θ -0.1787\n", "====================\n", "BUS 04\n", "====================\n", "Vm 1.0129\n", "θ -0.1458\n", "====================\n", "BUS 05\n", "====================\n", "Vm 1.0165\n", "θ -0.1235\n", "====================\n", "BUS 06\n", "====================\n", "Vm 1.06\n", "θ -0.1949\n", "====================\n", "BUS 07\n", "====================\n", "Vm 1.0438\n", "θ -0.1812\n", "====================\n", "BUS 08\n", "====================\n", "Vm 1.08\n", "θ -0.1656\n", "====================\n", "BUS 09\n", "====================\n", "Vm 1.0263\n", "θ -0.2102\n", "====================\n", "BUS 10\n", "====================\n", "Vm 1.0245\n", "θ -0.2125\n", "====================\n", "BUS 11\n", "====================\n", "Vm 1.0384\n", "θ -0.2059\n", "====================\n", "BUS 12\n", "====================\n", "Vm 1.0436\n", "θ -0.2105\n", "====================\n", "BUS 13\n", "====================\n", "Vm 1.0372\n", "θ -0.2119\n", "====================\n", "BUS 14\n", "====================\n", "Vm 1.0126\n", "θ -0.2291\n", "====================\n", "====================\n", "Differential States\n", "generator-1-1\n", "====================\n", "eq_p 1.0604\n", "ed_p -0.0111\n", "ψ_kd 1.0563\n", "ψ_kq 0.1134\n", "δ 0.1684\n", "ω 1.0\n", "Vm 1.06\n", "Vr1 0.0049\n", "Vr2 1.951\n", "Ve 1.4049\n", "Vr3 -0.0585\n", "x_g1 0.3144\n", "x_g2 0.3144\n", "x_g3 0.3144\n", "====================\n", "Differential States\n", "generator-3-1\n", "====================\n", "eq_p 1.0649\n", "ed_p 0.1243\n", "ψ_kd 0.9872\n", "ψ_kq 0.2132\n", "δ 0.034\n", "ω 1.0\n", "Vm 1.01\n", "Vr1 0.006\n", "Vr2 2.419\n", "Ve 1.791\n", "Vr3 -0.0726\n", "====================\n", "Differential States\n", "generator-8-1\n", "====================\n", "eq_p 1.2657\n", "ed_p 0.0462\n", "ψ_kd 1.1584\n", "ψ_kq 0.1748\n", "δ 0.019\n", "ω 1.0\n", "Vm 1.08\n", "Vr1 0.0097\n", "Vr2 3.9162\n", "Ve 2.8839\n", "Vr3 -0.1175\n", "====================\n", "Differential States\n", "generator-2-1\n", "====================\n", "eq_p 1.1038\n", "ed_p 0.1491\n", "ψ_kd 1.003\n", "ψ_kq 0.2748\n", "δ 0.1963\n", "ω 1.0\n", "Vm 1.04\n", "Vr1 0.0071\n", "Vr2 2.8613\n", "Ve 2.1338\n", "Vr3 -0.0858\n", "====================\n", "Differential States\n", "generator-6-1\n", "====================\n", "eq_p 1.167\n", "ed_p 0.0955\n", "ψ_kd 1.08\n", "ψ_kq 0.3084\n", "δ 0.1387\n", "ω 1.0\n", "Vm 1.06\n", "Vr1 0.0082\n", "Vr2 3.2875\n", "Ve 2.4472\n", "Vr3 -0.0986\n", "====================\n" ] } ], "cell_type": "code", "source": [ "print_device_states(sim)" ], "metadata": {}, "execution_count": 4 }, { "cell_type": "markdown", "source": [ "We execute the simulation with an additional tolerance for the solver set at 1e-8." ], "metadata": {} }, { "outputs": [], "cell_type": "code", "source": [ "PSID.execute!(sim, IDA(); abstol = 1e-8)" ], "metadata": {}, "execution_count": 5 }, { "cell_type": "markdown", "source": [ "Using `PowerSimulationsDynamics` tools for exploring the results, we can plot all the voltage\n", "results for the buses" ], "metadata": {} }, { "outputs": [ { "output_type": "execute_result", "data": { "text/plain": "DisplayAs.Showable{MIME{Symbol(\"image/png\")}}(Plot{Plots.GRBackend() n=14})", "image/png": "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" }, "metadata": {}, "execution_count": 6 } ], "cell_type": "code", "source": [ "p = plot()\n", "for b in get_components(Bus, sys)\n", " voltage_series = get_voltagemag_series(sim, get_number(b))\n", " plot!(\n", " p,\n", " voltage_series;\n", " xlabel = \"Time\",\n", " ylabel = \"Voltage Magnitude [pu]\",\n", " label = \"Bus - $(get_name(b))\",\n", " )\n", "end\n", "img = DisplayAs.PNG(p) # This line is only needed because of literate use display(p) when running locally" ], "metadata": {}, "execution_count": 6 }, { "cell_type": "markdown", "source": [ "We can also explore the frequency of the different generators" ], "metadata": {} }, { "outputs": [ { "output_type": "execute_result", "data": { "text/plain": "DisplayAs.Showable{MIME{Symbol(\"image/png\")}}(Plot{Plots.GRBackend() n=5})", "image/png": "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PklPTx8xYkTTpk3feOON4Dsfe+yxrKysYOOWLVuIaPz48bG/s1gsLVq0IKIOHTpERUUFGwcPHnzB++RiqnWOUGgKeoQAALpyKgjLy8sDgUBGRkZVy7fffnvllVdWrS/Tp08fIUReXt75bPfJJ58cOHDgnj17du7cOXfu3Ozs7KqXHnjggQEDBuzatSs3NzcvL2/hwoVlZWVjxoxZvHhxdnb2pk2bJk+efOzYsRUrVixduvTXX3/dsmXLM888M2HCBCKaO3du6e+uueaakSNHBrf52WefBRtXr1594TvlImJMqnFBvRqQOIIQAEBHTgVhZGSkwWAoKioKPj169OjRo0d79uxZ9YbgLXn9fv85N+r1ej/55JO//OUvRJSSknLzzTd/8MEHVa9u2LAheF9Dk8l08803L1q0aMeOHSaT6dprryWirKysjh07Llmy5Keffurfv39wes6IESO2bNlSfXW348ePr1279u677w4+DQQCLpfrz++GkOGyofrlE5qmMKw1CgCgJ6eCUJbl5s2bv/POO8ETcv/3f/9HRNVHGnNycogoPT39nBs9ceKE3+9v2rRp8GmzZs2OHDlS9ardbi8sLAw+Dq5rarfbnU6n2+0ONhYWFh4+fLjW24jo8OHDVRuZP39+v379qr7itttuS0pKatas2apVq85SmKqqW2o6ceLEOX/OheFENWaNcm4I8TcCAMAfUGOY7u9///s999zTvHnz5OTkjRs3duvWrU+fPlWvfvbZZ1lZWfHx8efcqMPhkGXZaDQGn1qt1upTYO67775JkyYJIYqKipYsWeLz+dq1a9exY8d777133Lhxa9asOX78uNPpvPPOO6dPnz5z5syOHTvOmjXLZrM5nc7gFoQQ8+fP/8c//hF8umzZsubNmxPRvHnz7rjjjl9//fVMae31esePH1+95Z577hk3btzp73S73ZqmBTvBF8Lr8wsSVZUrql8Vp57CxdrPcHbYz+GB/RweLpdLCHGe+9lqtfJzLWNSIwjHjBmjadqcOXMKCwvvvPPOF198serzbrf7xx9/vPPOO8/ni5OSkhRFcTgckZGRRFRaWpqcnFz16tNPP52Zmfnxxx+npqZOnjz5vffe45yvWbPm3//+98KFC3v27Dl06NDMzMzMzMxNmza9+eabOTk5kyZNGjVqVGZmZnAL69atKyoquvnmm4NPgylI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S52iKB999FGXLl3efvvtSZMmBRu3bNliMpmGDh1KRJxjyO0i2LdvX1lZ2ZQpU6Kiop577rmbb755w4YNixcvnjVr1gcffFBaWjp69OiMjIyuXbv++e8QUFNGRsaqVauCj2+55ZZ//vOf9VtPQzVmzJhXXnmlvqtoyIqLi4mosLBQCBEIBBISEr7//vvgS9dff/3LL79cr9U1KBEREdnZ2cHH48ePnzlzZv3W04AdPHiQiMrLy3v16vXWW28FG//617+OGzfuQjaLf7DUUFZWlpeX17179+DT7t27b9++vX5LasAWLVo0ePDghx566MCBA/VdSwN38uTJoqKibt26BZ/iDzuklixZMmjQoAceeCAnJ6e+a2lotm/fnpycHBUVtXPnzup/zzt27LiQzWJotIbCwkIistvtwacxMTHBFrjorr/++htvvNFms61atapLly47duxo1KhRfRfVYBUWFprNZrPZHHwaExODm6uESP/+/QcOHBgREbFmzZouXbps3779PJd1hHPKz89/6KGHXnnlFa/X63A4qh+oCwoKLmTLCMIaoqOjicjtdkdGRhKR0+ms2tdwcd15553BB4MHD967d++iRYsmT55cvyU1YNHR0T6fT1EUWZYJf9ihNGLEiOCDwYMH79u3b+HChc8880z9ltQwFBcXDxgwYOLEiXfeeacQwmQyud3u4EsX/veModEaEhISrFbr/v37g0/379/fuHHjeq3ospCamlpRUVHfVTRkqampBoOhaggaf9jhgT/si6W0tHTAgAHDhg176qmniIgx1qhRo4t4oEYQ1iBJ0siRI1977TUiOnHixMcffzx69Oj6Lqph2rhxY/DBzz//vGLFimuvvbZ+62nYrFbr8OHDZ8+eTUSHDx/+/PPPR40aVd9FNUxVf9jbtm1bvnz5NddcU7/1NAAVFRWDBg26+uqrn3vuuarG0aNHv/HGG6qqOhyOBQsWXOiB+iLM42lYTpw40b179/T0dLvdPnXq1Poup8HKzMyMiooK3ktl1qxZ9V1OQ5OQkBDzu7i4OCHEkSNHOnXqlJGRYbfbZ8yYUd8FNhCdO3eOqebYsWNXXHFF8A/bbre/8MIL9V1gQ/Dpp5/G1JSTk+NwOAYNGpSUlBQTE3PfffepqnohX4G7T9QtPz8/KirKarXWdyENWXl5ucfjSUlJqe9CLiMnT5602+0Wi6W+C2nIKioq3G43/rDDoLi42Gg0nvMuS+eEIAQAgMsazhECAMBlDUEIAACXNQQhAABc1hCEAABwWUMQAgDAZQ1BCAAAlzUEIUCDUlxcvGDBggtcgxjgsoJFtwEuJd9888348ePP9GrPnj0feeSRe+65Z926dUlJSeEsDODShSAEuJRkZGSMHTs2+Njlcr3wwgt9+vQZOHBgsCUzMzMjI+PZZ59t0qRJ/dUIcInByjIAl6rCwsKkpKTHH3/8hRdeOPs7KysrhRDBu4wFlZaWRkVFBe/KVF1xcTFjLC4u7uKXC6BXOEcI0KBs3bo1JSVl48aN3377bWxs7OrVqwcMGBAdHW2322+66abKysoNGza0bt06Li4uMjJyypQpVf8UnjdvXuPGjRMSEuLj41u1avXVV1/V7w8BCBsEIUCD4vf78/PzfT5fIBAoKyu7//77r7766s2bN7/55ptr1qwZP378Pffc8/jjj2dnZ//lL3+ZPn36F198QUSzZ88eP3787bffnp2dvXnz5rZt2w4ZMmT79u31/WsAwgHnCAEaspEjR06ZMoWIunXrtnbt2mXLln366afDhg0jok6dOi1duvTTTz/t16/f008/PW7cuIYJrIAAAAFESURBVJdeein4qcWLF7dp0+bVV1+dN29efVYPEBYIQoCG7Prrr6963Lx5c8bYgAEDgk8lSWrWrFleXt6mTZsqKioaNWpUfTi0cePGu3btCne5APUBQQjQkMXExFQ9NplMJpOp+l02jUaj3+8PXnQ4a9YsSZKqfzY1NTVsdQLUIwQhwOUuOJt0yZIlgwcPru9aAOoBJssAXO569OhhNpuXLVtW34UA1A/0CAEud7GxsZMmTXr22WcTExMnTJiQnJycl5f39ddfy7J833331Xd1ACGHIAQAmjZtmtVqfeGFF2bOnBlsycjImD59ev1WBRAeWFkG4BKmqirnnDFWq7HWtJfzpCjK3r17PR5PWlpaampqrc0CNFQIQgAAuKxhsgwAAFzWEIQAAHBZQxACAMBlDUEIAACXNQQhAABc1hCEAABwWfv/uKAy5KboiYAAAAAASUVORK5CYII=" }, "metadata": {}, "execution_count": 7 } ], "cell_type": "code", "source": [ "p2 = plot()\n", "for g in get_components(ThermalStandard, sys)\n", " state_series = get_state_series(sim, (get_name(g), :ω))\n", " plot!(\n", " p2,\n", " state_series;\n", " xlabel = \"Time\",\n", " ylabel = \"Speed [pu]\",\n", " label = \"$(get_name(g)) - ω\",\n", " )\n", "end\n", "img = DisplayAs.PNG(p2) # This line is only needed because of literate use display(p2) when running locally" ], "metadata": {}, "execution_count": 7 }, { "cell_type": "markdown", "source": [ "It is also possible to explore the small signal stability of this system we created. However,\n", "Since a simulation has already taken place, we need to reset the model." ], "metadata": {} }, { "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[ Info: Rebuilding the simulation after reset\n", "[ Info: Unit System changed to UnitSystem.DEVICE_BASE = 1\n", "[ Info: The System has no islands\n", "[ Info: Initializing Simulation States\n", "[ Info: Unit System changed to UnitSystem.SYSTEM_BASE = 0\n", "[ Info: The System has no islands\n", "[ Info: PowerFlow solve converged, the results have been stored in the system\n", "[ Info: Unit System changed to UnitSystem.DEVICE_BASE = 1\n", "[ Info: Attaching Perturbations\n", "[ Info: Completed Build Successfully. Simulations status = BUILT\n", "[ Info: Simulation reset to status BUILT\n", "┌ Warning: No Infinite Bus found. Confirm stability directly checking eigenvalues.\n", "│ If all eigenvalues are on the left-half plane and only one eigenvalue is zero, the system is small signal stable.\n", "└ @ PowerSimulationsDynamics ~/.julia/packages/PowerSimulationsDynamics/HqcnV/src/base/small_signal.jl:89\n", "┌ Info: Eigenvalues are:\n", "│ -1000.0000000000014 + 0.0im\n", "│ -1000.0000000000009 + 0.0im\n", "│ -1000.0000000000002 + 0.0im\n", "│ -999.9999999999998 + 0.0im\n", "│ -999.9999999999994 + 0.0im\n", "│ -51.807502094887305 + 0.0im\n", "│ -51.66123303723068 + 0.0im\n", "│ -51.49196116847845 + 0.0im\n", "│ -51.48204797296263 + 0.0im\n", "│ -51.38460395958913 + 0.0im\n", "│ -43.606770822347016 + 0.0im\n", "│ -36.89352970900156 + 0.0im\n", "│ -33.31097212895758 + 0.0im\n", "│ -30.40864223348849 + 0.0im\n", "│ -28.01655761625278 + 0.0im\n", "│ -23.88123468187301 + 0.0im\n", "│ -20.770613941795236 + 0.0im\n", "│ -18.298812818468587 + 0.0im\n", "│ -15.817280799219855 + 0.0im\n", "│ -12.4535351731598 + 0.0im\n", "│ -7.386324091020085 + 0.0im\n", "│ -6.703133543800532 + 0.0im\n", "│ -5.276882204482481 + 0.0im\n", "│ -4.5126237915183145 + 0.0im\n", "│ -4.473060547983035 - 10.72465167518535im\n", "│ -4.473060547983035 + 10.72465167518535im\n", "│ -3.7758166100050334 - 10.229252854125122im\n", "│ -3.7758166100050334 + 10.229252854125122im\n", "│ -3.742914873327555 - 9.915880591116311im\n", "│ -3.742914873327555 + 9.915880591116311im\n", "│ -2.6700435249538588 - 8.718145502364601im\n", "│ -2.6700435249538588 + 8.718145502364601im\n", "│ -2.413324071441693 - 7.998019427009456im\n", "│ -2.413324071441693 + 7.998019427009456im\n", "│ -2.3466700384540498 - 8.544936857679344im\n", "│ -2.3466700384540498 + 8.544936857679344im\n", "│ -2.2736098985790534 - 8.930102316891308im\n", "│ -2.2736098985790534 + 8.930102316891308im\n", "│ -1.921996374355548 + 0.0im\n", "│ -1.6595628314344688 + 0.0im\n", "│ -1.568604674011719 - 1.9420692161219602im\n", "│ -1.568604674011719 + 1.9420692161219602im\n", "│ -1.304344028522091 - 8.826562169098914im\n", "│ -1.304344028522091 + 8.826562169098914im\n", "│ -1.2863044260315994 + 0.0im\n", "│ -1.189196636506337 - 0.12712066641976974im\n", "│ -1.189196636506337 + 0.12712066641976974im\n", "│ -0.9782745903713628 - 0.06936177246604834im\n", "│ -0.9782745903713628 + 0.06936177246604834im\n", "│ -0.8488982894117668 - 0.498701658187088im\n", "│ -0.8488982894117668 + 0.498701658187088im\n", "│ -0.6457299452858358 - 0.19425247186886496im\n", "│ -0.6457299452858358 + 0.19425247186886496im\n", "│ -0.49499928165816176 + 0.0im\n", "│ -0.4167034353505496 + 0.0im\n", "│ -0.33954022474042556 - 7.568615170969771im\n", "│ -0.33954022474042556 + 7.568615170969771im\n", "└ 0.0 + 0.0im\n" ] }, { "output_type": "execute_result", "data": { "text/plain": "The system is small signal stable\n" }, "metadata": {}, "execution_count": 8 } ], "cell_type": "code", "source": [ "res = small_signal_analysis(sim; reset_simulation = true)" ], "metadata": {}, "execution_count": 8 }, { "cell_type": "markdown", "source": [ "The eigenvalues can be explored visually" ], "metadata": {} }, { "outputs": [ { "output_type": "execute_result", "data": { "text/plain": "Plot{Plots.GRBackend() n=1}", "image/png": "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", "text/html": [ "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n" ], "image/svg+xml": [ "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n" ] }, "metadata": {}, "execution_count": 9 } ], "cell_type": "code", "source": [ "scatter(res.eigenvalues; legend = false)" ], "metadata": {}, "execution_count": 9 }, { "cell_type": "markdown", "source": [ "## Modifiying the system and adding storage" ], "metadata": {} }, { "cell_type": "markdown", "source": [ "Reload the system for this example" ], "metadata": {} }, { "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[ Info: The PSS(R)E parser currently supports buses, loads, shunts, generators, branches, transformers, and dc lines\n", "[ Info: The following fields in GENERATOR are missing: O2, F2, O3, F3, O4, F4, WMOD, WPF\n", "[ Info: The following fields in GENERATOR are missing: O2, F2, O3, F3, O4, F4, WMOD, WPF\n", "[ Info: The following fields in GENERATOR are missing: O2, F2, O3, F3, O4, F4, WMOD, WPF\n", "[ Info: The following fields in GENERATOR are missing: O2, F2, O3, F3, O4, F4, WMOD, WPF\n", "[ Info: The following fields in GENERATOR are missing: O2, F2, O3, F3, O4, F4, WMOD, WPF\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: The following fields in BRANCH are missing: O2, F2, O3, F3, O4, F4\n", "[ Info: angmin and angmax values are 0, widening these values on branch 4 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 1 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 12 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 20 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 2 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 6 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 11 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 13 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 5 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 15 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 16 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 14 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 7 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 8 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 17 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 10 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 19 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 9 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 18 to +/- 60.0 deg.\n", "[ Info: angmin and angmax values are 0, widening these values on branch 3 to +/- 60.0 deg.\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 4 to 651.7693\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 1 to 1943.3753\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 12 to 1340.1421\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 20 to 686.916\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 2 to 527.2551\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 6 to 658.7239\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 11 to 1099.9023\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 13 to 404.9974\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 5 to 661.3166\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 15 to 406.1471\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 16 to 312.073\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 14 to 579.3328\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 7 to 2739.0808\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 8 to 548.9677\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 17 to 578.6164\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 10 to 828.1844\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 19 to 480.1216\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 9 to 426.3491\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 18 to 217.5559\n", "[ Info: this code only supports positive rate_a values, changing the value on branch 3 to 594.6825\n", "┌ Info: Constructing System from Power Models\n", "│ data[\"name\"] = \"14bus\"\n", "└ data[\"source_type\"] = \"pti\"\n", "[ Info: Reading bus data\n", "[ Info: Reading generator data\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -399.96\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-6-1 (ThermalStandard):\n", "│ name: generator-6-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 06 (Bus)\n", "│ active_power: 0.15\n", "│ reactive_power: 0.14800000000000002\n", "│ rating: 99.99028802838804\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -0.06, max = 0.24)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 25.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: nothing\n", "│ ext: Dict{String,Any}(\"z_source\" => (r = 0.0, x = 0.12))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -16.258536585365853\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-1-1 (ThermalStandard):\n", "│ name: generator-1-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 01 (Bus)\n", "│ active_power: 1.9333000000000002\n", "│ reactive_power: 0.01121\n", "│ rating: 100.48880584423323\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -10.0, max = 10.0)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 615.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: nothing\n", "│ ext: Dict{String,Any}(\"z_source\" => (r = 0.0, x = 0.23))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -399.96\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-8-1 (ThermalStandard):\n", "│ name: generator-8-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 08 (Bus)\n", "│ active_power: 0.1\n", "│ reactive_power: 0.22292\n", "│ rating: 99.99028802838804\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -0.06, max = 0.24)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 25.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: nothing\n", "│ ext: Dict{String,Any}(\"z_source\" => (r = 0.0, x = 0.12))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -166.65\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-2-1 (ThermalStandard):\n", "│ name: generator-2-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 02 (Bus)\n", "│ active_power: 0.3\n", "│ reactive_power: 0.27015999999999996\n", "│ rating: 99.99125011719775\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -0.4, max = 0.5)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 60.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: nothing\n", "│ ext: Dict{String,Any}(\"z_source\" => (r = 0.0, x = 0.13))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -166.65\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-3-1 (ThermalStandard):\n", "│ name: generator-3-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 03 (Bus)\n", "│ active_power: 0.2\n", "│ reactive_power: 0.21719000000000002\n", "│ rating: 99.99080007680706\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = 0.0, max = 0.4)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 60.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: nothing\n", "│ ext: Dict{String,Any}(\"z_source\" => (r = 0.0, x = 0.13))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "[ Info: Reading branch data\n", "┌ Warning: Rate 651.77 MW for BUS 02-BUS 04-i_4 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1943.38 MW for BUS 01-BUS 02-i_1 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1340.14 MW for BUS 09-BUS 10-i_12 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 527.26 MW for BUS 01-BUS 05-i_2 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 658.72 MW for BUS 03-BUS 04-i_6 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1099.9 MW for BUS 07-BUS 09-i_11 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 405.0 MW for BUS 09-BUS 14-i_13 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 661.32 MW for BUS 02-BUS 05-i_5 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 406.15 MW for BUS 12-BUS 13-i_15 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 312.07 MW for BUS 13-BUS 14-i_16 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 579.33 MW for BUS 10-BUS 11-i_14 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 2739.08 MW for BUS 04-BUS 05-i_7 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 548.97 MW for BUS 06-BUS 11-i_8 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 828.18 MW for BUS 06-BUS 13-i_10 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 426.35 MW for BUS 06-BUS 12-i_9 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 594.68 MW for BUS 02-BUS 03-i_3 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "[ Info: Reading branch data\n", "[ Info: Reading DC Line data\n", "[ Info: Reading storage data\n", "[ Info: Generators provided in .dyr, without a generator in .raw file will be skipped.\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n" ] }, { "output_type": "execute_result", "data": { "text/plain": "System\n======\nSystem Units Base: SYSTEM_BASE\nBase Power: 100.0\nBase Frequency: 60.0\n\nComponents\n==========\nNum components: 77\n\n\u001b[1m11×3 DataFrame\u001b[0m\n\u001b[1m Row \u001b[0m│\u001b[1m ConcreteType \u001b[0m\u001b[1m SuperTypes \u001b[0m\u001b[1m C\u001b[0m ⋯\n\u001b[1m \u001b[0m│\u001b[90m String \u001b[0m\u001b[90m String \u001b[0m\u001b[90m I\u001b[0m ⋯\n─────┼──────────────────────────────────────────────────────────────────────────\n 1 │ Arc Topology <: Component <: Infrast… ⋯\n 2 │ Area AggregationTopology <: Topology …\n 3 │ Bus Topology <: Component <: Infrast…\n 4 │ DynamicGenerator{RoundRotorQuadr… DynamicInjection <: Device <: Co…\n 5 │ DynamicGenerator{RoundRotorQuadr… DynamicInjection <: Device <: Co… ⋯\n 6 │ Line ACBranch <: Branch <: Device <: …\n 7 │ LoadZone AggregationTopology <: Topology …\n 8 │ PowerLoad StaticLoad <: ElectricLoad <: St…\n 9 │ TapTransformer ACBranch <: Branch <: Device <: … ⋯\n 10 │ ThermalStandard ThermalGen <: Generator <: Stati…\n 11 │ Transformer2W ACBranch <: Branch <: Device <: …\n\u001b[36m 1 column omitted\u001b[0m\n\nTimeSeriesContainer\n===================\nComponents with time series data: 0\nTotal StaticTimeSeries: 0\nTotal Forecasts: 0\n", "text/html": [ "

System

\n", "

Base Power: 100.0

\n", "

Components

\n", "

Num components: 77

\n", "

11 rows × 3 columns (omitted printing of 1 columns)

ConcreteTypeSuperTypes
StringString
1ArcTopology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
2AreaAggregationTopology <: Topology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
3BusTopology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
4DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,GasTG,PSSFixed}DynamicInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
5DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,TGFixed,PSSFixed}DynamicInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
6LineACBranch <: Branch <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
7LoadZoneAggregationTopology <: Topology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
8PowerLoadStaticLoad <: ElectricLoad <: StaticInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
9TapTransformerACBranch <: Branch <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
10ThermalStandardThermalGen <: Generator <: StaticInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
11Transformer2WACBranch <: Branch <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
\n", "\n", "

TimeSeriesContainer

\n", "

Components with time series data: 0

\n", "

Total StaticTimeSeries: 0

\n", "

Total Forecasts: 0

\n", "

Resolution: 0 seconds

\n" ] }, "metadata": {}, "execution_count": 10 } ], "cell_type": "code", "source": [ "sys = System(joinpath(file_dir, \"14bus.raw\"), joinpath(file_dir, \"dyn_data.dyr\"))" ], "metadata": {}, "execution_count": 10 }, { "cell_type": "markdown", "source": [ "We want to remove the generator 6 and the dynamic component attached to it." ], "metadata": {} }, { "outputs": [], "cell_type": "code", "source": [ "thermal_gen = get_component(ThermalStandard, sys, \"generator-6-1\")\n", "remove_component!(sys, get_dynamic_injector(thermal_gen))\n", "remove_component!(sys, thermal_gen)" ], "metadata": {}, "execution_count": 11 }, { "cell_type": "markdown", "source": [ "We can now define our storage device and add it to the system" ], "metadata": {} }, { "outputs": [], "cell_type": "code", "source": [ "storage = GenericBattery(\n", " name = \"Battery\",\n", " bus = get_component(Bus, sys, \"BUS 06\"),\n", " available = true,\n", " prime_mover = PrimeMovers.BA,\n", " active_power = 0.6,\n", " reactive_power = 0.16,\n", " rating = 1.1,\n", " base_power = 25.0,\n", " initial_energy = 50.0,\n", " state_of_charge_limits = (min = 5.0, max = 100.0),\n", " input_active_power_limits = (min = 0.0, max = 1.0),\n", " output_active_power_limits = (min = 0.0, max = 1.0),\n", " reactive_power_limits = (min = -1.0, max = 1.0),\n", " efficiency = (in = 0.80, out = 0.90),\n", ")\n", "\n", "add_component!(sys, storage)" ], "metadata": {}, "execution_count": 12 }, { "cell_type": "markdown", "source": [ "A good sanity check it running a power flow on the system to make sure all the components\n", "are properly scaled and that the system is properly balanced. We can use `PowerSystems` to\n", "perform this check. We can get the results back and perform a sanity check" ], "metadata": {} }, { "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[ Info: Unit System changed to UnitSystem.SYSTEM_BASE = 0\n", "[ Info: The System has no islands\n", "[ Info: PowerFlow solve converged, the results are exported in DataFrames\n", "[ Info: Voltages are exported in pu. Powers are exported in MW/MVAr.\n", "[ Info: Unit System changed to UnitSystem.SYSTEM_BASE = 0\n" ] }, { "output_type": "execute_result", "data": { "text/plain": "\u001b[1m14×9 DataFrame\u001b[0m\n\u001b[1m Row \u001b[0m│\u001b[1m bus_number \u001b[0m\u001b[1m Vm \u001b[0m\u001b[1m θ \u001b[0m\u001b[1m P_gen \u001b[0m\u001b[1m P_load \u001b[0m\u001b[1m P_net \u001b[0m\u001b[1m Q_gen \u001b[0m\u001b[1m Q\u001b[0m ⋯\n\u001b[1m \u001b[0m│\u001b[90m Int64 \u001b[0m\u001b[90m Float64 \u001b[0m\u001b[90m Float64 \u001b[0m\u001b[90m Float64 \u001b[0m\u001b[90m Float64 \u001b[0m\u001b[90m Float64 \u001b[0m\u001b[90m Float64 \u001b[0m\u001b[90m F\u001b[0m ⋯\n─────┼──────────────────────────────────────────────────────────────────────────\n 1 │ 1 1.06 0.0 193.33 0.0 193.33 1.12086 ⋯\n 2 │ 2 1.04 -0.0711029 30.0 21.7 8.3 27.0157\n 3 │ 3 1.01 -0.178704 20.0 94.2 -74.2 21.719\n 4 │ 4 1.01285 -0.145825 0.0 47.8 -47.8 0.0\n 5 │ 5 1.01648 -0.123536 0.0 7.6 -7.6 0.0 ⋯\n 6 │ 6 1.06 -0.194906 15.0 11.2 3.8 14.8004\n 7 │ 7 1.04377 -0.181188 0.0 0.0 0.0 0.0\n 8 │ 8 1.08 -0.165561 10.0 0.0 10.0 22.2916\n 9 │ 9 1.02628 -0.210231 0.0 29.5 -29.5 0.0 ⋯\n 10 │ 10 1.02453 -0.212546 0.0 9.0 -9.0 0.0\n 11 │ 11 1.03837 -0.205887 0.0 3.5 -3.5 0.0\n 12 │ 12 1.04362 -0.210542 0.0 6.1 -6.1 0.0\n 13 │ 13 1.03723 -0.211859 0.0 13.5 -13.5 0.0 ⋯\n 14 │ 14 1.01263 -0.229125 0.0 14.9 -14.9 0.0\n\u001b[36m 2 columns omitted\u001b[0m", "text/html": [ "

14 rows × 9 columns

bus_numberVmθP_genP_loadP_netQ_genQ_loadQ_net
Int64Float64Float64Float64Float64Float64Float64Float64Float64
111.060.0193.330.0193.331.120860.01.12086
221.04-0.071102930.021.78.327.015712.714.3157
331.01-0.17870420.094.2-74.221.71919.02.71896
441.01285-0.1458250.047.8-47.80.00.00.0
551.01648-0.1235360.07.6-7.60.01.6-1.6
661.06-0.19490615.011.23.814.80047.57.3004
771.04377-0.1811880.00.00.00.00.00.0
881.08-0.16556110.00.010.022.29160.022.2916
991.02628-0.2102310.029.5-29.50.016.6-16.6
10101.02453-0.2125460.09.0-9.00.05.8-5.8
11111.03837-0.2058870.03.5-3.50.01.8-1.8
12121.04362-0.2105420.06.1-6.10.01.6-1.6
13131.03723-0.2118590.013.5-13.50.05.8-5.8
14141.01263-0.2291250.014.9-14.90.05.0-5.0
" ] }, "metadata": {}, "execution_count": 13 } ], "cell_type": "code", "source": [ "res = solve_powerflow(sys)\n", "res[\"bus_results\"]" ], "metadata": {}, "execution_count": 13 }, { "cell_type": "markdown", "source": [ "After verifying that the system works, we can define our inverter dynamics and add it to the\n", "battery that has already been stored in the system." ], "metadata": {} }, { "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "┌ Warning: struct DynamicInverter does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n" ] } ], "cell_type": "code", "source": [ "inverter = DynamicInverter(\n", " name = get_name(storage),\n", " ω_ref = 1.0, # ω_ref,\n", " converter = AverageConverter(rated_voltage = 138.0, rated_current = 100.0),\n", " outer_control = OuterControl(\n", " VirtualInertia(Ta = 2.0, kd = 400.0, kω = 20.0),\n", " ReactivePowerDroop(kq = 0.2, ωf = 1000.0),\n", " ),\n", " inner_control = CurrentControl(\n", " kpv = 0.59, #Voltage controller proportional gain\n", " kiv = 736.0, #Voltage controller integral gain\n", " kffv = 0.0, #Binary variable enabling the voltage feed-forward in output of current controllers\n", " rv = 0.0, #Virtual resistance in pu\n", " lv = 0.2, #Virtual inductance in pu\n", " kpc = 1.27, #Current controller proportional gain\n", " kic = 14.3, #Current controller integral gain\n", " kffi = 0.0, #Binary variable enabling the current feed-forward in output of current controllers\n", " ωad = 50.0, #Active damping low pass filter cut-off frequency\n", " kad = 0.2,\n", " ),\n", " dc_source = FixedDCSource(voltage = 600.0),\n", " freq_estimator = KauraPLL(\n", " ω_lp = 500.0, #Cut-off frequency for LowPass filter of PLL filter.\n", " kp_pll = 0.084, #PLL proportional gain\n", " ki_pll = 4.69, #PLL integral gain\n", " ),\n", " filter = LCLFilter(lf = 0.08, rf = 0.003, cf = 0.074, lg = 0.2, rg = 0.01),\n", ")\n", "add_component!(sys, inverter, storage)" ], "metadata": {}, "execution_count": 14 }, { "cell_type": "markdown", "source": [ "These are the current system components:" ], "metadata": {} }, { "outputs": [ { "output_type": "execute_result", "data": { "text/plain": "System\n======\nSystem Units Base: SYSTEM_BASE\nBase Power: 100.0\nBase Frequency: 60.0\n\nComponents\n==========\nNum components: 77\n\n\u001b[1m13×3 DataFrame\u001b[0m\n\u001b[1m Row \u001b[0m│\u001b[1m ConcreteType \u001b[0m\u001b[1m SuperTypes \u001b[0m\u001b[1m C\u001b[0m ⋯\n\u001b[1m \u001b[0m│\u001b[90m String \u001b[0m\u001b[90m String \u001b[0m\u001b[90m I\u001b[0m ⋯\n─────┼──────────────────────────────────────────────────────────────────────────\n 1 │ Arc Topology <: Component <: Infrast… ⋯\n 2 │ Area AggregationTopology <: Topology …\n 3 │ Bus Topology <: Component <: Infrast…\n 4 │ DynamicGenerator{RoundRotorQuadr… DynamicInjection <: Device <: Co…\n 5 │ DynamicGenerator{RoundRotorQuadr… DynamicInjection <: Device <: Co… ⋯\n 6 │ DynamicInverter{AverageConverter… DynamicInjection <: Device <: Co…\n 7 │ GenericBattery Storage <: StaticInjection <: De…\n 8 │ Line ACBranch <: Branch <: Device <: …\n 9 │ LoadZone AggregationTopology <: Topology … ⋯\n 10 │ PowerLoad StaticLoad <: ElectricLoad <: St…\n 11 │ TapTransformer ACBranch <: Branch <: Device <: …\n 12 │ ThermalStandard ThermalGen <: Generator <: Stati…\n 13 │ Transformer2W ACBranch <: Branch <: Device <: … ⋯\n\u001b[36m 1 column omitted\u001b[0m\n\nTimeSeriesContainer\n===================\nComponents with time series data: 0\nTotal StaticTimeSeries: 0\nTotal Forecasts: 0\n", "text/html": [ "

System

\n", "

Base Power: 100.0

\n", "

Components

\n", "

Num components: 77

\n", "

13 rows × 3 columns (omitted printing of 1 columns)

ConcreteTypeSuperTypes
StringString
1ArcTopology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
2AreaAggregationTopology <: Topology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
3BusTopology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
4DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,GasTG,PSSFixed}DynamicInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
5DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,TGFixed,PSSFixed}DynamicInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
6DynamicInverter{AverageConverter,OuterControl{VirtualInertia,ReactivePowerDroop},CurrentControl,FixedDCSource,KauraPLL,LCLFilter}DynamicInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
7GenericBatteryStorage <: StaticInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
8LineACBranch <: Branch <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
9LoadZoneAggregationTopology <: Topology <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
10PowerLoadStaticLoad <: ElectricLoad <: StaticInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
11TapTransformerACBranch <: Branch <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
12ThermalStandardThermalGen <: Generator <: StaticInjection <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
13Transformer2WACBranch <: Branch <: Device <: Component <: InfrastructureSystemsComponent <: InfrastructureSystemsType <: Any
\n", "\n", "

TimeSeriesContainer

\n", "

Components with time series data: 0

\n", "

Total StaticTimeSeries: 0

\n", "

Total Forecasts: 0

\n", "

Resolution: 0 seconds

\n" ] }, "metadata": {}, "execution_count": 15 } ], "cell_type": "code", "source": [ "sys" ], "metadata": {}, "execution_count": 15 }, { "cell_type": "markdown", "source": [ "Define Simulation problem using the same parameters:" ], "metadata": {} }, { "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[ Info: Serialized time series data to /var/folders/27/2jr8c7gn4j72fvrg4qt81zrw8w_711/T/jl_zMinxm/sys_time_series_storage.h5.\n", "[ Info: Serialized System to /var/folders/27/2jr8c7gn4j72fvrg4qt81zrw8w_711/T/jl_zMinxm/sys.json\n", "[ Info: Loaded time series from storage file existing=sys_time_series_storage.h5 new=/var/folders/27/2jr8c7gn4j72fvrg4qt81zrw8w_711/T/jl_uPswqc\n", "┌ Warning: Rate 2739.08 MW for BUS 04-BUS 05-i_7 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 406.15 MW for BUS 12-BUS 13-i_15 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 661.32 MW for BUS 02-BUS 05-i_5 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 527.26 MW for BUS 01-BUS 05-i_2 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 579.33 MW for BUS 10-BUS 11-i_14 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 828.18 MW for BUS 06-BUS 13-i_10 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 405.0 MW for BUS 09-BUS 14-i_13 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 594.68 MW for BUS 02-BUS 03-i_3 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 548.97 MW for BUS 06-BUS 11-i_8 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 651.77 MW for BUS 02-BUS 04-i_4 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 658.72 MW for BUS 03-BUS 04-i_6 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 312.07 MW for BUS 13-BUS 14-i_16 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 426.35 MW for BUS 06-BUS 12-i_9 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1340.14 MW for BUS 09-BUS 10-i_12 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1099.9 MW for BUS 07-BUS 09-i_11 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: Rate 1943.38 MW for BUS 01-BUS 02-i_1 is larger than the max expected in the range of (min = 12.0, max = 13.0).\n", "└ @ PowerSystems ~/.julia/packages/PowerSystems/4kGrw/src/utils/IO/branchdata_checks.jl:148\n", "┌ Warning: struct DynamicInverter does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: struct DynamicInverter does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -166.65\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-3-1 (ThermalStandard):\n", "│ name: generator-3-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 03 (Bus)\n", "│ active_power: 0.2\n", "│ reactive_power: 0.21719000000000002\n", "│ rating: 99.99080007680706\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = 0.0, max = 0.4)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 60.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: generator-3-1 (DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,TGFixed,PSSFixed})\n", "│ ext: Dict{String,Any}(\"z_source\" => Dict{String,Any}(\"x\" => 0.13,\"r\" => 0))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -399.96\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-8-1 (ThermalStandard):\n", "│ name: generator-8-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 08 (Bus)\n", "│ active_power: 0.1\n", "│ reactive_power: 0.22292\n", "│ rating: 99.99028802838804\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -0.06, max = 0.24)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 25.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: generator-8-1 (DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,TGFixed,PSSFixed})\n", "│ ext: Dict{String,Any}(\"z_source\" => Dict{String,Any}(\"x\" => 0.12,\"r\" => 0))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -16.258536585365853\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-1-1 (ThermalStandard):\n", "│ name: generator-1-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 01 (Bus)\n", "│ active_power: 1.9333000000000002\n", "│ reactive_power: 0.01121\n", "│ rating: 100.48880584423323\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -10.0, max = 10.0)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 615.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: generator-1-1 (DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,GasTG,PSSFixed})\n", "│ ext: Dict{String,Any}(\"z_source\" => Dict{String,Any}(\"x\" => 0.23,\"r\" => 0))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "┌ Warning: Invalid range\n", "│ valid_info.struct_name = \"ThermalStandard\"\n", "│ field_name = \"active_power_limits\"\n", "│ field_value = -166.65\n", "│ valid_range = Dict{String,Any} with 2 entries: …\n", "│ valid_info.ist_struct =\n", "│ generator-2-1 (ThermalStandard):\n", "│ name: generator-2-1\n", "│ available: true\n", "│ status: true\n", "│ bus: BUS 02 (Bus)\n", "│ active_power: 0.3\n", "│ reactive_power: 0.27015999999999996\n", "│ rating: 99.99125011719775\n", "│ active_power_limits: (min = -99.99, max = 99.99)\n", "│ reactive_power_limits: (min = -0.4, max = 0.5)\n", "│ ramp_limits: (up = 0.9998999999999999, down = 0.9998999999999999)\n", "│ operation_cost: ThreePartCost\n", "│ base_power: 60.0\n", "│ time_limits: nothing\n", "│ prime_mover: PrimeMovers.OT = 19\n", "│ fuel: ThermalFuels.OTHER = 14\n", "│ services: 0-element Array{Service,1}\n", "│ time_at_status: 1.0e6\n", "│ dynamic_injector: generator-2-1 (DynamicGenerator{RoundRotorQuadratic,SingleMass,ESAC1A,TGFixed,PSSFixed})\n", "│ ext: Dict{String,Any}(\"z_source\" => Dict{String,Any}(\"x\" => 0.13,\"r\" => 0))\n", "│ time_series_container: InfrastructureSystems.TimeSeriesContainer: 0\n", "│ InfrastructureSystems.SystemUnitsSettings:\n", "│ base_value: 100.0\n", "│ unit_system: UnitSystem.SYSTEM_BASE = 0\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:228\n", "┌ Warning: struct DynamicGenerator does not exist in validation configuration file, validation skipped\n", "└ @ InfrastructureSystems ~/.julia/packages/InfrastructureSystems/v75Hd/src/validation.jl:51\n", "[ Info: Unit System changed to UnitSystem.DEVICE_BASE = 1\n", "[ Info: The System has no islands\n", "[ Info: Initializing Simulation States\n", "[ Info: Unit System changed to UnitSystem.SYSTEM_BASE = 0\n", "[ Info: The System has no islands\n", "[ Info: PowerFlow solve converged, the results have been stored in the system\n", "[ Info: Unit System changed to UnitSystem.DEVICE_BASE = 1\n", "┌ Warning: Initialization failed, initial conditions do not meet conditions for an stable equilibrium.\n", "│ Trying to solve again reducing numeric tolerance from 1.0e-9:\n", "└ @ PowerSimulationsDynamics ~/.julia/packages/PowerSimulationsDynamics/HqcnV/src/base/simulation_initialization.jl:117\n", "[ Info: Initialization succeeded with a relaxed tolerance of 1.0e-6. Saving solution\n", "[ Info: Attaching Perturbations\n", "[ Info: Completed Build Successfully. Simulations status = BUILT\n" ] }, { "output_type": "execute_result", "data": { "text/plain": "Simulation()\n" }, "metadata": {}, "execution_count": 16 } ], "cell_type": "code", "source": [ "sim = PSID.Simulation(\n", " file_dir, #path for the simulation output\n", " sys, #system\n", " (0.0, 20.0), #time span\n", " BranchTrip(1.0, \"BUS 02-BUS 04-i_4\");\n", " console_level = Logging.Info,\n", ")" ], "metadata": {}, "execution_count": 16 }, { "cell_type": "markdown", "source": [ "We can verify the small signal stability of the system before running the simulation:" ], "metadata": {} }, { "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "┌ Warning: No Infinite Bus found. Confirm stability directly checking eigenvalues.\n", "│ If all eigenvalues are on the left-half plane and only one eigenvalue is zero, the system is small signal stable.\n", "└ @ PowerSimulationsDynamics ~/.julia/packages/PowerSimulationsDynamics/HqcnV/src/base/small_signal.jl:89\n", "┌ Info: Eigenvalues are:\n", "│ -2274.2469750440414 - 6834.9069586386095im\n", "│ -2274.2469750440414 + 6834.9069586386095im\n", "│ -2102.367936395657 - 6526.604770463303im\n", "│ -2102.367936395657 + 6526.604770463303im\n", "│ -1605.2366971863967 - 292.6664161689679im\n", "│ -1605.2366971863967 + 292.6664161689679im\n", "│ -1000.0000000000009 + 0.0im\n", "│ -1000.0000000000003 + 0.0im\n", "│ -1000.0 + 0.0im\n", "│ -999.9999999999989 + 0.0im\n", "│ -984.449461144326 + 0.0im\n", "│ -499.9999999999987 + 0.0im\n", "│ -471.10004434838106 + 0.0im\n", "│ -223.53403479862283 + 0.0im\n", "│ -56.90163909202578 - 289.00694522337295im\n", "│ -56.90163909202578 + 289.00694522337295im\n", "│ -51.85095741537765 + 0.0im\n", "│ -51.53608624290841 + 0.0im\n", "│ -51.468087206497316 + 0.0im\n", "│ -51.39649987307159 + 0.0im\n", "│ -50.3524399583718 + 0.0im\n", "│ -50.28019655121397 + 0.0im\n", "│ -43.11041954380906 + 0.0im\n", "│ -36.86624356267333 + 0.0im\n", "│ -33.28289754683637 + 0.0im\n", "│ -29.7275731664875 + 0.0im\n", "│ -24.864038336061544 + 0.0im\n", "│ -20.759543837404244 + 0.0im\n", "│ -17.549135305830006 + 0.0im\n", "│ -13.170128547508595 + 0.0im\n", "│ -11.310043467840698 + 0.0im\n", "│ -11.176980179041552 + 0.0im\n", "│ -6.959056395568068 - 0.36524519711982284im\n", "│ -6.959056395568068 + 0.36524519711982284im\n", "│ -6.628223110733827 - 26.402111215751454im\n", "│ -6.628223110733827 + 26.402111215751454im\n", "│ -5.3125797666175085 - 0.14269957459448374im\n", "│ -5.3125797666175085 + 0.14269957459448374im\n", "│ -4.534720935357964 + 0.0im\n", "│ -3.847678181440572 - 9.993362504739203im\n", "│ -3.847678181440572 + 9.993362504739203im\n", "│ -3.615696930288592 - 10.480595189658755im\n", "│ -3.615696930288592 + 10.480595189658755im\n", "│ -2.5406664001369528 - 8.665901831268302im\n", "│ -2.5406664001369528 + 8.665901831268302im\n", "│ -2.4252661187203746 - 8.084946273995225im\n", "│ -2.4252661187203746 + 8.084946273995225im\n", "│ -2.1789359528755945 - 8.963911206888236im\n", "│ -2.1789359528755945 + 8.963911206888236im\n", "│ -1.9125339762107467 + 0.0im\n", "│ -1.5879211373085478 - 8.860537538480695im\n", "│ -1.5879211373085478 + 8.860537538480695im\n", "│ -1.5216689060985993 - 2.1166258806082263im\n", "│ -1.5216689060985993 + 2.1166258806082263im\n", "│ -1.448103829269238 + 0.0im\n", "│ -1.3105897902209567 + 0.0im\n", "│ -1.0674736791174282 - 0.1695193932714451im\n", "│ -1.0674736791174282 + 0.1695193932714451im\n", "│ -1.036594223264721 - 0.45335996937030665im\n", "│ -1.036594223264721 + 0.45335996937030665im\n", "│ -0.7286140353934802 + 0.0im\n", "│ -0.49998604215908005 + 0.0im\n", "│ -0.39218035801249895 - 7.452795054063343im\n", "│ -0.39218035801249895 + 7.452795054063343im\n", "│ -0.3145728821134344 + 0.0im\n", "└ 0.0 + 0.0im\n" ] }, { "output_type": "execute_result", "data": { "text/plain": "The system is small signal stable\n" }, "metadata": {}, "execution_count": 17 } ], "cell_type": "code", "source": [ "res = small_signal_analysis(sim)" ], "metadata": {}, "execution_count": 17 }, { "outputs": [ { "output_type": "execute_result", "data": { "text/plain": "Plot{Plots.GRBackend() n=1}", "image/png": "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", "text/html": [ "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n" ], "image/svg+xml": [ "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", " \n", " \n", " \n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n", "\n" ] }, "metadata": {}, "execution_count": 18 } ], "cell_type": "code", "source": [ "scatter(res.eigenvalues)" ], "metadata": {}, "execution_count": 18 }, { "cell_type": "markdown", "source": [ "We execute the simulation" ], "metadata": {} }, { "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "[ Info: Rebuilding the simulation after reset\n", "[ Info: Unit System changed to UnitSystem.DEVICE_BASE = 1\n", "[ Info: The System has no islands\n", "[ Info: Initializing Simulation States\n", "[ Info: Unit System changed to UnitSystem.SYSTEM_BASE = 0\n", "[ Info: The System has no islands\n", "[ Info: PowerFlow solve converged, the results have been stored in the system\n", "[ Info: Unit System changed to UnitSystem.DEVICE_BASE = 1\n", "┌ Warning: Initialization failed, initial conditions do not meet conditions for an stable equilibrium.\n", "│ Trying to solve again reducing numeric tolerance from 1.0e-9:\n", "└ @ PowerSimulationsDynamics ~/.julia/packages/PowerSimulationsDynamics/HqcnV/src/base/simulation_initialization.jl:117\n", "[ Info: Initialization succeeded with a relaxed tolerance of 1.0e-6. Saving solution\n", "[ Info: Attaching Perturbations\n", "[ Info: Completed Build Successfully. Simulations status = BUILT\n", "[ Info: Simulation reset to status BUILT\n" ] } ], "cell_type": "code", "source": [ "PSID.execute!(sim, IDA(); abstol = 1e-8)" ], "metadata": {}, "execution_count": 19 }, { "cell_type": "markdown", "source": [ "Using `PowerSimulationsDynamics` tools for exploring the results, we can plot all the voltage\n", "results for the buses" ], "metadata": {} }, { "outputs": [ { "output_type": "execute_result", "data": { "text/plain": "DisplayAs.Showable{MIME{Symbol(\"image/png\")}}(Plot{Plots.GRBackend() n=14})", "image/png": "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6Oe0tLSnn356eOMZwerq6j799NPS0tKkpKS//e1v0YlNTU333ntvVVVVYWHhk08+6XA4hjfIkae6uvrzzz8vKytLS0t79NFHAQCCIFx//fXdMyxfvrznn8gZ8f7773/00UfHjx9PSEj4/e9/v3jxYgBAeXn5n/70p5aWlrlz5z722GM6ne50NjEyS4TPPPPMp59++sorr9xwww0XXXRRc3PzcEc0KmzZsiUrK+uKK6644oorlixZMtzhjGTFxcUVFRWyLG/evLl74sUXX+xwON566y2CIK6++uphDG+k2rdv37FjxwRB2Lp1a3SKLMsffvjhxRdfHD3tx48fP7wRjkjr16+/6KKLXn311eXLl1900UX79+/neX7JkiWzZ89+8803q6qq7rjjjtPdBhyJUlJS1q5dG/182WWX/fWvfx3eeEaJWbNmrVmzZrijGEXeeuutqVOnRj/v3r3bYrGIogghDIVCGo2moqJiWKMbsV5//fXZs2dHP4dCIQAAz/PDG9LosWzZsieeeOKdd94pLCyMTqmurmZZ1uv1ns5qR2CJ0OfzNTU1TZs2LfrntGnTSktLhzek0ePJJ5+84IIL7r33XpfLNdyxjC5lZWUTJ06kKAoAoNPpxo0bV1ZWNtxBjRYrVqy47LLLVq9eLUnScMcykomiWFFRkZOTU1ZW1n2Fz87O1mq1VVVVp7PmEfiMMHoJNpvN0T8tFgu6KJ8d1113XWJiIkmSb7755owZM0pLSw0Gw3AHNVq4XK7ucx4AYLVaOzo6hjGeUYIkyccff3zSpEl+v//xxx/ft2/fO++8M9xBjVh33XVXamrqJZdcsnbt2p59Z1osltM820dgIjSZTACASCQS7VYnFAr1vEAgP57bbrst+mHp0qU5OTnr16+/4oorhjek0cNkMkUike4/g8EgOu3PAoZhHnjggejnCRMm5OXlvfTSS+jI/xgeffTRrVu3btu2DcfxM362j8CqUbvdrtPpqquro39WV1enp6cPa0SjDkEQTqfT7/cPdyCjSHp6evc5r6pqXV0dOu3PssTERAAAOu1/DE899dS77767adOm6IgLPc92r9fr8XhO82wfgYmQIIirrrrq+eefBwC0trZ+/PHH11577XAHNfIFAoGKioro5y+++OLQoUNoMISz6bzzzvP7/evWrQMAvP/++1qtFh3/s6C2trazsxMAIMvyI488kpWVlZqaOtxBjTSrV69+/fXXN2/e7HQ6o1OuvPLK3bt3Rxt/vPzyy7NmzUpJSTmtbZyJhjw/OW1tbdOnT09KSjKbzQ8++OBwhzMqNDU1OZ1Om83mcDiSkpLefffd4Y5oJNuyZYulh6uuugpC+OWXXzocjszMzMTExG3btg13jCPQV1991fOw33DDDR988IHBYEhKSjIYDNOmTSspKRnuGEegMWPG9Dzs99xzD4Tw9ddft1gs6enpOTk55eXlp7mJkTz6REdHh8Fg0Gq1wx3IKNLZ2YlhmN1uH+5ARilJkjo7O51OJ0EQwx3LaCFJUldXl9FoPM13upFTJQiC2+1OSEjAMOw0VzWSEyGCIAiCDGkEPiNEEARBkNihRIggCIKMaigRIgiCIKMaSoQIgiDIqIYSIYIgCDKqoUSIIAiCjGooESLIz0xJScm777473FEgyMiB3iNEkJ+Wv/zlL2+//fZA3953333Nzc3PPvtsOBw+m1EhyAg2AkefQJCftZkzZ9I0Hf186NChTz75ZOXKlWlpadEphYWFeXl5er1++AJEkJEGlQgR5KfrzTffvOmmm7Zv3z5v3rzB53S5XCaTiWGY6J+Koni93r593UmS5Ha7jUYj6noQQbqhZ4QI8jPz9NNPZ2VlAQAeeOCB3NzcLVu2ZGVlOZ1Ok8n0yCOPAABefPFFh8MRFxcXHx8fHY8CAMBx3B133GG32xMSEoxG4/nnn9/U1DScu4EgPxmoahRBfmaCwWB7ezsAgOO45ubm3/72t4899lh2dvYbb7zx0EMPNTU1lZeXv/vuu3q9/v7777/22muPHz9uNBovv/zyvXv3PvXUU3PmzGlsbLzzzjuXLFlSUlLSXYhEkFELJUIE+RmLRCIvv/zywoULAQBFRUXvv//+Bx98UFdXFx2/9LnnnpsyZcq2bdu0Wu26des++eSTSy65BACQn5+flpaWn5+/Zs2ayy+/fJj3AUGGG0qECPIzxrLs/Pnzo58ZhklPT7dardEsCADIzc0FADQ1NTU0NBAEwTDMpk2bupc1Go3l5eUoESIISoQI8jNmMplw/Psn/TRNWyyWnn8CAARB6OjogBBed911PZclCMLv95+1UBHkJwslQgQZ+UwmE0VR7e3t3S9mIAjSDbUaRZCRb/78+YIgfP7558MdCIL8FKESIYKMfJdccsn06dNvu+22SCSybNkyhmFqamo++uijSy+9dMqUKcMdHYIMM1QiRJCRjyCIr776aunSpb/61a8cDofJZJoyZcrGjRt1Ot1wh4Ygww/1LIMgP10QQlVVCYLoNRFC2LONTOwCgUBlZSVN0ykpKVar9QyFiSA/bygRIgiCIKMaqhpFEARBRjWUCBEEQZBRDSVCBEEQZFRDiRBBEAQZ1VAiRBAEQUY1lAgRBEGQUe3/Bz3OlC1c90m8AAAAAElFTkSuQmCC" }, "metadata": {}, "execution_count": 20 } ], "cell_type": "code", "source": [ "p = plot()\n", "for b in get_components(Bus, sys)\n", " voltage_series = get_voltagemag_series(sim, get_number(b))\n", " plot!(\n", " p,\n", " voltage_series;\n", " xlabel = \"Time\",\n", " ylabel = \"Voltage Magnitude [pu]\",\n", " label = \"Bus - $(get_name(b))\",\n", " )\n", "end\n", "img = DisplayAs.PNG(p) # This line is only needed because of literate use display(p) when running locally" ], "metadata": {}, "execution_count": 20 }, { "cell_type": "markdown", "source": [ "We can also explore the frequency of the different static generators and storage" ], "metadata": {} }, { "outputs": [ { "output_type": "execute_result", "data": { "text/plain": "DisplayAs.Showable{MIME{Symbol(\"image/png\")}}(Plot{Plots.GRBackend() n=5})", "image/png": "iVBORw0KGgoAAAANSUhEUgAAAlgAAAGQCAIAAAD9V4nPAAAABmJLR0QA/wD/AP+gvaeTAAAgAElEQVR4nOzdd3wURfsA8Gfb1dxdrqT3kASSEAIEkEDohIBSpPgCgiiCYKWI4qu+Igg/FRGxoQiIDQER6ahIB5EiLSSUhFQgPbnL5S5Xts3vj4UzBgTEC1GZ7x9+budmd+eOk4eZnZmHQAgBhmEYht2tyOZuAIZhGIY1JxwIMQzDsLsaDoQYhmHYXQ0HQgzDMOyuhgMhhmEYdlfDgRDDMAy7q+FAiGEYht3VcCDEMAzD7mo4EGIYhmF3NRwIMQzDsLvavzYQlpaWVlVV3WJlQRCatDGYB0II7+p3x+Af9h2DEBJFsblbcbfw+g/7XxsIFyxYsHLlylus7HA4mrQxmAfP8yzLNncr7hb4h33HCIKAf9h3jNd/2P/aQIhhGIZhtwIHQgzDMOyuhgMhhmEYdlfDgRDDMAy7q+FA2FREgWvuJmAYhmE3hwNhUzGXn2zuJmAYhmE3hwNhU6m6fLC5m4BhGIbdHA6ETaWu+pzbaW7uVmAYhmE3gQNhU3E7amzm3OZuBYZhGHYTdHM34F/L5aiyWwpMIZ09JUjgCQp/4RjWPCoqKgoKCpro4oIgCIIgk8ma6PqYJDQ0NCwszOuXxX8vNxXWVcu5bb8di0LFW0/oRzwlj23bfI3CsLvXd99999prr0VFRTV3Q7DbVFJSMm7cuHnz5nn9yjgQNhWBd/JcveeQvXSBr7jkzDyIAyGGNZdhw4Z99NFHzd0K7DbNmzfP5XI1xZXxM8KmIvJunrV7Drnyi5TenystbMYmYRiGYdfCgbBJICSIIicIv+1GL1gqFXHt+JqyZmwVhmEYdi0cCJuEwLsBQOR/68ULtdWy8Dixvg4JfPO1C8MwDGsMB8ImIe2vJggNAqGtltQaSI1etOLFhRiGYX8jOBA2CSSyACA2GBoV7bWUxpfS+Ao2HAgxDMP+RnAgbBKiyMPv990WHTZSrSU1esFW23ztwjAMwxrDgbBJXB0adf9W4rCRKg3l4yvacSDEMAz7G8GBsEmgRj1ChJDLQShUpMZXtFubs2UYhmHY7+FA2CREkYOrTwoBALEuoBmCokmVRqyva9amYRiG/Tl2u53n/83T3XEgbBJSX1C8ulJCdDlIhQoASLUWB0IMw+6w48ePv/vuu7dx4meffWY0GkNDQ7Va7eDBg83m3831czqdjz76aJs2bQwGw/nz573U2GaAA2GTQIgnSFq8+owQuRyEXAkApFor4ECIYdidlZ+fv23btts4sUePHrm5ubW1tRUVFU6n89VXX21UISkp6cMPP6yrqxMEwRstbR44EDYJUeQpSi6KV34ZoqueVKgBgFRpRIf9hqdiGPbvZ7FYxo4dGxkZmZGR8cknn8yZMwcADh8+3K9fv4iIiHvvvffcuXMA8P7773/66afjxo0LCwsbOHBgaWkpABQUFAwfPjw6OjotLW3v3r0AsHnz5jlz5kyZMiUsLGzdunU///xzenp6WFhYu3btPv7448rKynnz5p04cSI9PX348OEAcP78+fvuuy8yMrJPnz5Hjx4FgO+//37WrFnTp08PDw9ftWqVp53R0dFGoxEANBpN165dKyoqGn4KpVI5ffr07t27/6nPXlxcPHDgQI77bVL96tWrZ8+efXvfpFfgTbebBBIFilGKnmeEbteVHqHKBzltNzwVw7A7hBeh0oXuwI38FQT9+07HU089xTDMmTNnCgsL77333o4dOxYWFg4ZMuSbb77p0qXLxo0bBw4ceObMmZycnPXr13/77beLFy9+8sknX3311Xfffbd3795z585dvXr1sWPHhg0bduzYsUuXLr3++uvLli2bPXs2RVGFhYXvvvtuy5Yt8/PzBw0aFB8fP3369C+++GLt2rUEQTidzn79+s2YMWPdunUbN27MyMjIzc0tKSmZP3/+Rx999Morr5Dk79paUlKybdu2srKydevWffHFF3/921ixYoVcLmcYxlPSpk2biRMnTp8+XafT/fXr3wYcCJsEEnmKVkhzRwFAdDtIhRIASKUP7hFi2N/EeSvq98OdmAOyfyAdoyU8h4IgrFu3rqCgQK1Wt27d+qGHHjp//vyKFSsGDx6cnJxstVo7dOigVCqPHz8OAA888EBaWhoAPPLIIzNnzty8ebPUO7Tb7YGBgampqT/88AMAdOjQYdy4cdL127ZtW1BQsGXLlqqqqqioqP3797dq1YphGL1eDwA//PCDUqmcOnUqAIwePXrJkiWbNm0CgDZt2kyYMEG6AkIIAAiCAACbzXb8+PHS0lKZTEZRVKN3b+y6NXfv3i11TF0ul9lsDg4OTkxMVCqVhw8fzsjI+Gvf9G3CgbBJICRQlJznHFcO3S5CJvUINaITB0IM+1torSdKH2RuXs/bLBYLz/OBgYHSYXBw8Pnz5y9dunTw4MH//Oc/UmFQUJA0UdPf318qUalUDofj4sWL+fn5nmoAoFAoWJZtmK528eLF77777tChQ41GI8/zFoul4d3LysrCw8M9h1FRUSUlJcHBwZ4r9O3bVxov/eyzz4YPH96qVatPPvkEABYuXPjEE08MHTpUygg4evRoqfyPzJw5c8mSJQAwderUuXPnesovXboUEhICAAcOHHjllVcOHz4MAKGhoRcvXvwz36I34UDYJJAokLQCsVdGQRHrIuQKACAYGSCEOJZgcCZrDLtLGY1GHx+fnJycxMREAJDmW4aHh5MkuWLFioY1165d2+jc8PDwsLCwHTt2NCxcvHhxw/HMDz/88Msvv0xNTQWArKwsAKAoShRF6d2QkJCioiKEkNRRy8/P7969uyAInivs3Lnzus2Oi4urrKycOXPmzJkzb+VjvvXWW2+99dZ1P74Um0tKSqSnngBgNptNJtOtXLYp4MkyTUIUeYpWeBbUi24nKVNIrwmFWnTV//GpGIb9yxEE8eSTT06ePHnfvn0rVqzYsGEDAEyYMGHjxo0rV640m82XL1/+9NNP6+quM8N8yJAh1dXV8+bNq6qqKi8vX79+/YULFxrVMRqNu3fvttvt69ev37x5MwBERkaeP3/+4MGDmZmZPXv2FARhwYIF1dXVK1asOHv27P333/9HTV2+fPnBgwcLCwt37979yiuvXFvzwIEDO3fuRAgdPnx4586dDafA/JF+/fp99dVXpaWlX3/9tcFg+OGHHzZu3FhdXf1nJ914UVMFwiNHjjz66KPt2rUbMWJEo7cEQZgyZYrRaAwICPD0lysqKu69916NRhMbGyv9yUkXSU5O1mg0Xbp0kf7RtG/fvhYN7Nq1q4na/xchJDR8RojYK5NlAIBUqpHL0XxNwzCs+b3++usPPPDABx98kJ+f/8QTTxiNxoiIiP3792/evLlr165DhgzJzMxkGKZly5ZRUVHSKTqdLjU1VaVSHThwoKioqE+fPv369duyZYtSqQwLC2vdurXn4h9//PGePXvat2//448/vvnmm3FxcSkpKf/973/ffvvt1157TS6X79y589ixY927d9+wYcOePXsMBkNISEibNm2ubafb7X7xxRfT09NnzZo1ZsyYN954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" }, "metadata": {}, "execution_count": 21 } ], "cell_type": "code", "source": [ "p2 = plot()\n", "for g in get_components(ThermalStandard, sys)\n", " state_series = get_state_series(sim, (get_name(g), :ω))\n", " plot!(\n", " p2,\n", " state_series;\n", " xlabel = \"Time\",\n", " ylabel = \"Speed [pu]\",\n", " label = \"$(get_name(g)) - ω\",\n", " )\n", "end\n", "state_series = get_state_series(sim, (\"Battery\", :ω_oc))\n", "plot!(p2, state_series; xlabel = \"Time\", ylabel = \"Speed [pu]\", label = \"Battery - ω\")\n", "img = DisplayAs.PNG(p2) # This line is only needed because of literate use display(p2) when running locally" ], "metadata": {}, "execution_count": 21 }, { "cell_type": "markdown", "source": [ "---\n", "\n", "*This notebook was generated using [Literate.jl](https://github.com/fredrikekre/Literate.jl).*" ], "metadata": {} } ], "nbformat_minor": 3, "metadata": { "language_info": { "file_extension": ".jl", "mimetype": "application/julia", "name": "julia", "version": "1.5.2" }, "kernelspec": { "name": "julia-1.5", "display_name": "Julia 1.5.2", "language": "julia" } }, "nbformat": 4 }