This repository provides the code required to run iterations of power flow to arrive at overvoltages and undervoltage situations on various sizes of power distribution grids. The voltage overvoltages and undervoltages can enable hunting between grid devices, which can result in voltage oscillations. As prerequisites to run the code, you will need Python 3 and the power flow program OpenDSS installed.
Using pip/pip3, you should install the following libraries:
- networkx (run
pip install networkx) - pandas (run
pip install pandas) - re (run
pip install re) - opendssdirect (
pip install OpenDSSDirect.py) - matplotlib (
pip install matplotlib) - numpy (
pip install numpy) - UliPlot (
pip install UliPlot)
Step 1) Clone this hunting-sims repository. Navigate into the src directory by running: cd introDSSsim in the Command Prompt/Terminal.
Step 2) Run the command python create_hunting.py in your terminal.
This is the file responsible for creating various hunting scenarios.
Step 3) Now the program will walk through a series of user input requests to setup your desired hunting scenario:
- "Please enter your feeder name:" -> e.g. enter
123or13bal(for 123 node feeder and 13 node feeder respectively). - "Please choose your 1st hunting node:" -> e.g. enter
48(can be any node number on the feeder you choose). - "Please choose your 2nd hunting node:" -> e.g. enter
83(any other node on the feeder, distinct from 1st hunting node). - "Do you want an overvoltage, undervoltage, or both?" -> e.g. (type o for overvoltage, u for undervoltage, or 'b' for both of these voltage issues).
- "Do you want to keep previous output (type y to save, n to clear)" -> Tell the program whether you'd like to write the results under previous results (save) or to overwrite them with the latest results (clear).
Step 4) The simulation will run to convergence and display the output of the successful over/undervoltage values in the command line.
Access the outputted results with the hunting_results.xlsx file. Consider the common ancestor node (CAN) between the given high_node and low_node. The nodal power setup that creates the overvoltage or undervoltage is comprised of zero loads from the CAN to the substation, constant loads from high_node to the CAN of value (P_hi+j Q_hi), and constant loads from low_node to the CAN of value (P_lo+j Q_lo). The rest of the network's PQ bus powers are the default spot loads given by the IEEE: https://cmte.ieee.org/pes-testfeeders/resources/
The image below shows an example of what the contents of the hunting_results.xlsx file look like:
