https://github.com/lampspuc/pwf.jl
A Julia package for reading the Brazilian electric power system file ".pwf".
https://github.com/lampspuc/pwf.jl
electricity julia power-systems
Last synced: 3 months ago
JSON representation
A Julia package for reading the Brazilian electric power system file ".pwf".
- Host: GitHub
- URL: https://github.com/lampspuc/pwf.jl
- Owner: LAMPSPUC
- License: mit
- Created: 2021-11-19T21:47:23.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-08-17T15:48:25.000Z (about 2 years ago)
- Last Synced: 2025-03-24T09:53:00.328Z (6 months ago)
- Topics: electricity, julia, power-systems
- Language: Julia
- Homepage: https://lampspuc.github.io/PWF.jl
- Size: 656 KB
- Stars: 20
- Watchers: 1
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
PWF.jl
---
PWF.jl is a Julia package for converting ANAREDE data format (".pwf") into a Julia dictionary.
Additionaly, PWF provides parsing .pwf file directly to [PowerModels.jl](https://github.com/lanl-ansi/PowerModels.jl) network data dictionary.
The implementations were made based on the ANAREDE user guide manual (v09).
**Quickstart**
Until the creating of PWF.jl, '.pwf' files could only be parsed through Brazilian commercial softwares, such as ANAREDE and Organon. Therefore, the Brazilian Power System community was compelled to use one of the two solutions to run Power Flow analysis.
PWF.jl unlocks the power of open-source to the Power System community. Therefore, now, anyone can read the standard Brazilian file ('.pwf') and run steady-state electrical analysis with state-of-the-art methodologies. For the Power Flow algorithm, we encourage the usage of the package PowerModels.jl, which already have integration with the PWF.jl package.
To perform Power Flow analysis using PWF.jl in Julia, follow the steps bellow:
1. First of all, make sure you have [Visual Studio Code](https://code.visualstudio.com/) and [Julia Language](https://julialang.org/downloads/) Long-term support (LTS) 1.6.6 configured correctly;
2. Then, add PWF.jl and PowerModels.jl to the known packages;
```julia
using Pkg
Pkg.add("PWF")
Pkg.add("PowerModels")
```
3. Finally, you are ready to perform power flow analysis
```julia
using PWF, PowerModels
network_path = "network.pwf"
network = PWF.parse_file(network_path)
results = PowerModels.run_ac_pf(network)
results["solution"]["bus"]["1"]["vm"] # folution for voltage magniture of bus 1
results["solution"]["bus"]["1"]["va"] # solution for voltage angle of bus 1
```
For more information about PowerModels.jl visit the PowerModels [documentation](https://lanl-ansi.github.io/PowerModels.jl/stable/)
## Parser
The package can parse all available sections into a julia dictionary withou any modifications. Each key represents a .pwf section as shown below:
```julia
julia> parse_file(file; pm = false)
Dict{String, Any} with 6 entries:
"DLIN" => Dict{String, Any}[Dict("AGGREGATOR 10"=>nothing, "AGGREGATOR 5"=>nothing, "AGGR"…
"name" => "3bus"
"DBAR" => Dict{String, Any}[Dict("AGGREGATOR 10"=>nothing, "ANGLE"=>0.0, "MINIMUM REACTIV"…
"TITU" => "Ande Case"…
"DCTE" => Dict{String, Any}("TLVC"=>0.5, "APAS"=>90.0, "BASE"=>100.0, "STIR"=>1.0, "CPAR"…
"DOPC" => Dict{String, Any}("CONT"=>'L', "CELO"=>'L' "MOST"=>'L', "MOSF"=>'L', "RCVG"=>'…
```
## PowerModels.jl converter
The package also allow converting .pwf file directly into PowerModels.jl network data structure:
```julia
julia> parse_file(file; pm = true) # default
Dict{String, Any} with 13 entries:
"bus" => Dict{String, Any}("1"=>Dict{String, Any}("zone"=>1, "bus_i"=>1, "bus_"…
"source_type" => "pwf"
"name" => "3bus"
"dcline" => Dict{String, Any}()
"source_version" => "09"
"branch" => Dict{String, Any}("1"=>Dict{String, Any}("br_r"=>0.181, "shift"=>-0.0…
"gen" => Dict{String, Any}("1"=>Dict{String, Any}("pg"=>11.52, "model"=>2, "sh"…
"storage" => Dict{String, Any}()
"switch" => Dict{String, Any}()
"baseMVA" => 100.0
"per_unit" => false
"shunt" => Dict{String, Any}()
"load" => Dict{String, Any}("1"=>Dict{String, Any}("source_id"=>Any["load", 3, …
```
**Network Data Sections Available:**
- bus
- gen
- load
- branch
- dcline
- shunt
**Incoming Network Data Sections:**
- switch
- storage
**Two parsing modes comprehended**
There are two main softwares used for parsing PWF files and each one does slightly different assumptions to the data parsed. For more information, visit the documentation.
```julia
julia> data = parse_file(file; pm = true, software = ANAREDE) # default
julia> data = parse_file(file; pm = true, software = Organon)
```
**Additional data inside PWF files**
If parse_file' argument add_control_data is set to true (default = false), additional information present on the PWF file that is not used by PowerModels will be stored inside each element in the field "control_data", such as the example below:
```julia
julia> data = parse_file(file, pm = true, add_control_data = true);
julia> data["shunt"]["1"]["control_data"]
Dict{String, Any} with 9 entries:
"vmmax" => 1.029
"section" => "DBAR"
"shunt_control_type" => 3
"bsmin" => 0.0
"shunt_type" => 2
"bsmax" => 0.0
"inclination" => nothing
"vmmin" => 1.029
"controlled_bus" => 1
```
**PWF Sections Available:**
- DBAR
- DBSH
- DCBA
- DCCV
- DCER
- DCLI
- DCNV
- DCSC
- DCTE
- DELO
- DGBT
- DGER
- DGLT
- DLIN
- DOPC
- DSHL
- DARE
- DCAI
- DCAR
- DGEI
- DINJ
- DMFL
- DMOT
- DMTE
- DAGR
- DCMT
- DTPF
## Contributing
- PRs such as adding new sections and fixing bugs are very welcome!
- For nontrivial changes, you'll probably want to first discuss the changes via issue. Suggestions are super welcome!