Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Data Model Abstraction Refactor #272

Merged
merged 230 commits into from
May 13, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
230 commits
Select commit Hold shift + click to select a range
c12f035
Squashed commit of the following:
sanderclaeys Feb 12, 2020
de9694f
first pass
sanderclaeys Feb 12, 2020
c5fed31
mapping updated
sanderclaeys Feb 13, 2020
fada2c5
pmd trans update
sanderclaeys Feb 14, 2020
bed7a68
solution infrastructure
sanderclaeys Feb 14, 2020
7fe38f6
first prototype
sanderclaeys Feb 14, 2020
2fcbede
bounds absent update
sanderclaeys Feb 15, 2020
26111af
looking good
sanderclaeys Feb 15, 2020
c48b05d
create/add functions
sanderclaeys Feb 15, 2020
cc65208
stash changes
sanderclaeys Feb 20, 2020
ceca3f0
Merge branch 'data-model' into optional-bounds
sanderclaeys Feb 20, 2020
f6ff62f
rm data model changes
sanderclaeys Feb 20, 2020
15a8cae
fixes
sanderclaeys Feb 21, 2020
e26e843
bound wrapper
sanderclaeys Feb 21, 2020
8f4fc92
rm data model files
sanderclaeys Feb 21, 2020
0df6c84
forgotten bounds
sanderclaeys Feb 21, 2020
2d9be01
bound names revert
sanderclaeys Feb 21, 2020
1d97e08
minor fixs
sanderclaeys Feb 21, 2020
eef3854
David's comments
sanderclaeys Feb 23, 2020
72ae1e8
Merge branch 'optional-bounds' into data-model
sanderclaeys Feb 23, 2020
fddf8c0
merged master
sanderclaeys Feb 23, 2020
92ddbd7
pf validated
sanderclaeys Feb 24, 2020
7da85b8
DOC: Data model documentation formatting
pseudocubic Feb 24, 2020
3945ede
ADD: Buscoord parsing into PMD data structure (#249)
pseudocubic Feb 20, 2020
083b021
transformer fixing
sanderclaeys Feb 25, 2020
e2f9e51
DOC: formatting
pseudocubic Feb 25, 2020
06ae4df
Merge branch 'master' into data-model
pseudocubic Feb 26, 2020
86311cc
DSS parser refactor
pseudocubic Feb 26, 2020
ec24bb3
solution_unmake_pu! -> solution_make_si!
pseudocubic Feb 26, 2020
b335d1d
Minor mapping changes
pseudocubic Feb 26, 2020
b2efa2d
parse_file_dm rewrite
pseudocubic Feb 26, 2020
4242af9
refactor opendss_dm
pseudocubic Feb 26, 2020
1b4e002
REF: "model" -> "data_model"
pseudocubic Feb 27, 2020
2acf074
RM: old opendss.jl
pseudocubic Feb 27, 2020
c6001e7
RM: old index in transformation
pseudocubic Feb 27, 2020
217e96f
FIX: _apply_like!
pseudocubic Feb 27, 2020
cd2e682
DOC: remove function call example for internal functions
pseudocubic Feb 27, 2020
0f830c1
ADD: loadshape parsing to eng model
pseudocubic Feb 27, 2020
0c3158d
REF: move data model transformation to IO function
pseudocubic Feb 27, 2020
c96e653
ADD: line reactors
pseudocubic Feb 27, 2020
3b2b2c7
DOC: docstring updates
pseudocubic Feb 27, 2020
48d6545
trans bugs
sanderclaeys Feb 27, 2020
8ba626d
Merge remote-tracking branch 'origin/data-model' into data-model
sanderclaeys Feb 27, 2020
661ee3f
FIX: transformer parsing
pseudocubic Feb 27, 2020
95f2793
REF: add_component! functions
pseudocubic Feb 27, 2020
3ae313d
UPD: transform data model
pseudocubic Mar 2, 2020
60e46d0
v_var_scalar -> kv_kvar_scalar
pseudocubic Mar 2, 2020
aecb716
WIP: data model mapping prototype
pseudocubic Mar 2, 2020
555a87d
REF: _discover_buses
pseudocubic Mar 3, 2020
8a06c53
DOC: move data_model.md to docs
pseudocubic Mar 3, 2020
3f95e96
FIX: duplicate includes
pseudocubic Mar 3, 2020
c41cec7
RM: old io/common.jl
pseudocubic Mar 3, 2020
a8afec5
FIX: generators, pvsystems, storage
pseudocubic Mar 3, 2020
c8a418d
REF: parse_file_dm -> parse_file
pseudocubic Mar 3, 2020
691b2e8
FIX: kv_kvar_scalar -> v_var_scalar
pseudocubic Mar 3, 2020
8ab5d8f
FIX: pad properties
pseudocubic Mar 3, 2020
1a0417e
FIX: switches
pseudocubic Mar 3, 2020
0061f35
FIX: power flow tests
pseudocubic Mar 3, 2020
1851047
FIX: sourcebus parse from dss to eng
pseudocubic Mar 4, 2020
d18d4c2
FIX: eng2math for multiple components
pseudocubic Mar 4, 2020
ae5bcfa
FIX: line / linecode properties
pseudocubic Mar 4, 2020
d93cbb1
FIX: shunt reactor
pseudocubic Mar 4, 2020
bcf48ef
REF: file names & function locations
pseudocubic Mar 4, 2020
2aca64e
REF: refactored dss parser
pseudocubic Mar 4, 2020
a510f0d
FIX: data.jl tests
pseudocubic Mar 4, 2020
4387873
FIX: opf tests
pseudocubic Mar 5, 2020
056091a
Enable all opf tests
pseudocubic Mar 5, 2020
0c5e3ee
Enable storage tests
pseudocubic Mar 5, 2020
191152e
Enable debug tests
pseudocubic Mar 5, 2020
cceecb1
Enable MLD tests
pseudocubic Mar 5, 2020
34071d4
Enable shunt tests
pseudocubic Mar 5, 2020
80ec57a
FIX: delta gens tests
pseudocubic Mar 5, 2020
3b76460
Misc fixes to parser
pseudocubic Mar 5, 2020
b4f3fd6
pu conversion added
sanderclaeys Mar 8, 2020
859c211
nearly all ut working
sanderclaeys Mar 8, 2020
c331396
remove pu from eng2math.jl
sanderclaeys Mar 8, 2020
bbe0a46
all ut working
sanderclaeys Mar 9, 2020
b967732
FIX: mld for opendss files
pseudocubic Mar 9, 2020
860fcdc
FIX: _eng2math_switch!
pseudocubic Mar 9, 2020
48e5b15
WIP: ADD: transformer banking
pseudocubic Mar 9, 2020
c282c52
ADD: transformer banking
pseudocubic Mar 9, 2020
ba64c57
REF: make_per_unit
pseudocubic Mar 9, 2020
138a534
RM: dangling @warn in bank_transformers
pseudocubic Mar 9, 2020
cff9752
FIX: remove deg2rad from _eng2math_bus!
pseudocubic Mar 9, 2020
b201aba
ADD: support 'edit' in dss parser
pseudocubic Mar 9, 2020
23fd45b
FIX: parsing of circuit sourcebus
pseudocubic Mar 9, 2020
922d78b
FIX: disable angle unit conversion on buses
pseudocubic Mar 9, 2020
3b4ea19
banking improved
sanderclaeys Mar 10, 2020
12670f1
solution_math2eng added
sanderclaeys Mar 10, 2020
3d14434
transformer math2eng added
sanderclaeys Mar 10, 2020
34eb43a
FIX: property assignment in dss parser
pseudocubic Mar 10, 2020
9507a45
REF: source parsing from dss, other parser upgrades
pseudocubic Mar 10, 2020
009a097
FIX: opendss tests
pseudocubic Mar 11, 2020
11bc95d
FIX: ACP MLD formulation
pseudocubic Mar 11, 2020
1061592
REF: misc cleanup
pseudocubic Mar 12, 2020
e9ed15e
Merge branch 'master' into data-model
pseudocubic Mar 12, 2020
c4d530c
pad vmax Inf
sanderclaeys Mar 13, 2020
9883a4d
fix data.jl (changes were lost)
sanderclaeys Mar 13, 2020
540a26f
REF: component creation, checking, adding
pseudocubic Mar 16, 2020
1c0a592
ADD: run_mc_model
pseudocubic Mar 17, 2020
2417016
REVERT: pad vmax with INF
pseudocubic Mar 17, 2020
c2947b0
REF: rename pvsystem to solar
pseudocubic Mar 17, 2020
c1ed2d3
WIP: ADD math2eng conversions
pseudocubic Mar 17, 2020
b1242fe
REF: opendss parser
pseudocubic Mar 17, 2020
ffe3d1d
FIX: automatic solution converter
pseudocubic Mar 19, 2020
e8ddd25
REF: New solution unmap pattern
pseudocubic Mar 19, 2020
6338a0b
FIX: deg2rad conversion
pseudocubic Mar 23, 2020
4d019c3
REF: model building tools
pseudocubic Mar 23, 2020
2f9256a
RM: sourcebus
pseudocubic Mar 25, 2020
42246fc
REF: parse_file logic
pseudocubic Mar 25, 2020
772d883
ADD: select model type in Model
pseudocubic Mar 25, 2020
34e1703
ADD: lossless option to parser
pseudocubic Mar 25, 2020
5a9c2d5
RM: unused function constraint_mc_transformer_flow
pseudocubic Mar 25, 2020
5627e10
ADD: support non-standard dss parameters
pseudocubic Mar 26, 2020
2958e9f
ADD: xycurve support
pseudocubic Mar 26, 2020
232a6ff
ADD: xfmrcode support
pseudocubic Mar 26, 2020
3776363
FIX: busname parsing for sourcebus
pseudocubic Mar 27, 2020
2447621
FIX: parsing of voltagebases
pseudocubic Mar 27, 2020
b3f81c8
REF: InfrastructureModels solution tools
pseudocubic Mar 31, 2020
bac2434
Merge branch 'master' into data-model
pseudocubic Mar 31, 2020
df56681
REF: opendss parsing simplification
pseudocubic Mar 31, 2020
54e43aa
UPD: component checks
pseudocubic Apr 1, 2020
d6a59e8
FIX: Double export
pseudocubic Apr 2, 2020
0017c0c
xfmrcode/transformer fix
sanderclaeys Apr 7, 2020
def9fd1
trans ut working
sanderclaeys Apr 7, 2020
f5c6c08
FIX: Buscoords parsing (func arg type)
pseudocubic Apr 15, 2020
3b72408
FIX: xfmrcode parsing
pseudocubic Apr 15, 2020
64930bc
REF: add types to function args in units.jl for debugging
pseudocubic Apr 15, 2020
58fd122
ADD: export optimizer_with_attributes from JuMP
pseudocubic Apr 15, 2020
bb014ea
FIX: transformer banking using xfmrcodes
pseudocubic Apr 15, 2020
d1c6de0
FIX: transformer parsing bugs
pseudocubic Apr 15, 2020
40506b0
FIX: discover_buses was missing islanded buses
pseudocubic Apr 16, 2020
ef26601
FIX: import_all for mathematial data model
pseudocubic Apr 16, 2020
2378557
ADD: Types for function args, docstrings, cleanup
pseudocubic Apr 16, 2020
96118a3
UPD: lossmodel building logic
pseudocubic Apr 17, 2020
04ddcbe
ADD: Transformations example
pseudocubic Apr 17, 2020
3692a73
UPD: Generator property names
pseudocubic Apr 17, 2020
44116c8
REF: move utility functions
pseudocubic Apr 17, 2020
5614f78
REF: reorganized file to match data model document
pseudocubic Apr 17, 2020
c54ee88
FIX: _init_math_obj! calls
pseudocubic Apr 17, 2020
0e815bb
REF: more reorganization to match data model document
pseudocubic Apr 17, 2020
1f7a24a
UPD: Storage parameter names
pseudocubic Apr 17, 2020
9d7e4aa
FIX: Unit tests
pseudocubic Apr 17, 2020
99f7260
4w patch
sanderclaeys Apr 18, 2020
3d17abb
4w solution extension
sanderclaeys Apr 18, 2020
9f7d647
2-phase delta transformers
sanderclaeys Apr 20, 2020
31b5da5
various patches for ieee8500
sanderclaeys Apr 20, 2020
1ea3fd6
WIP: FIX: dropped eng2math code
pseudocubic Apr 20, 2020
b45969b
prev ut fixing
sanderclaeys Apr 21, 2020
ad2c0dd
cap fix
sanderclaeys Apr 21, 2020
0a32063
subphase transformer terminals fix
sanderclaeys Apr 21, 2020
dd66cc7
sourcegen fix
sanderclaeys Apr 21, 2020
1ff6bc3
fix loss model transformers
sanderclaeys Apr 21, 2020
5b66e69
minor fix
sanderclaeys Apr 21, 2020
5a36637
json parser fix
sanderclaeys Apr 21, 2020
eb8d64f
expanded math2eng solution parsing
sanderclaeys Apr 21, 2020
411b3f9
REF: Switch to engineering model by default
pseudocubic Apr 21, 2020
c1dbaf2
FIX: PowerModels imports
pseudocubic Apr 21, 2020
1601e41
ADD: make_si kwarg for run_mc_model
pseudocubic Apr 21, 2020
ac37419
REF: converts pf tests to eng model
pseudocubic Apr 21, 2020
3e31ec8
FIX: count_nodes for eng model
pseudocubic Apr 21, 2020
9797025
REF: convert opf tests to eng data model
pseudocubic Apr 21, 2020
f6685fc
FIX: transformer solution reporting
pseudocubic Apr 21, 2020
0304d69
REF: opf_bf tests to eng data model
pseudocubic Apr 21, 2020
feaef3e
REF: opf_iv tests to eng data model
pseudocubic Apr 21, 2020
1e2e638
REF: storage tests to eng data model
pseudocubic Apr 21, 2020
f05f997
REF: loadmodels tests to eng data model
pseudocubic Apr 21, 2020
89e9e73
REF: mld tests to eng data model
pseudocubic Apr 21, 2020
e1121d8
REF: misc tests updates
pseudocubic Apr 21, 2020
6c6e3a4
REF: transformer tests to eng data model
pseudocubic Apr 21, 2020
2c066d8
ADD: example of usage of eng data model
pseudocubic Apr 21, 2020
4f8b68d
UPD: PowerModels v0.16
pseudocubic Apr 23, 2020
aff5f56
REF: data_model to enum
pseudocubic Apr 23, 2020
98c24a2
ADD: changelog
pseudocubic Apr 23, 2020
eadfe12
UPD: PowerModels v0.16 in Project.toml
pseudocubic Apr 23, 2020
aac6af5
UPD: Julia v1.4 travis testing
pseudocubic Apr 23, 2020
4759e12
UPD: PowerModels v0.17
pseudocubic Apr 23, 2020
88d723e
ADD: stub for eng2math documentation
pseudocubic Apr 27, 2020
6802cf6
WIP: add enums
pseudocubic Apr 27, 2020
f707f3d
WIP: final data model changes
pseudocubic Apr 29, 2020
fae605e
enum vector equalities
sanderclaeys Apr 30, 2020
7fa4dd3
vbase/sbase/scale_factor
sanderclaeys Apr 30, 2020
47b5982
ADD: multinetwork support
pseudocubic Apr 30, 2020
0eba108
WIP: updating for final data model
pseudocubic Apr 30, 2020
d5d69a3
FIX: failing travis tests
pseudocubic May 1, 2020
d3a1f85
FIX: create_storage accidentally named create_solar (duplicate)
pseudocubic May 1, 2020
01b1119
RM: ipynb checkpoints
pseudocubic May 1, 2020
22013d0
RM: data_model_test.jl
pseudocubic May 1, 2020
4a80b1c
UPD: multinetwork creation pattern
pseudocubic May 1, 2020
3f1e8b3
REF: move multiple dispatch from run_{model_name} to run_mc_model
pseudocubic May 1, 2020
f06a6ef
UPD: data model documentation
pseudocubic May 1, 2020
6c33142
FIX: documenter build
pseudocubic May 1, 2020
7ba109d
FIX: powermodels warnings
pseudocubic May 1, 2020
261e7c6
REF: checks cleanup
pseudocubic May 1, 2020
2ae2d6a
REF: merge problem variants
pseudocubic May 1, 2020
ba1bc80
DOC: update readme
pseudocubic May 1, 2020
9406fb0
FIX: oltc docstring
pseudocubic May 1, 2020
df9e13c
ADD: Citation
pseudocubic May 4, 2020
398ebc9
FIX: PR#262 -> data-model refactor
pseudocubic May 4, 2020
6b51cf2
DOC: minor updates to data_model.md
pseudocubic May 4, 2020
fb7b49b
FIX: make_lossless! for transformers
pseudocubic May 5, 2020
7eefe83
FIX: vbase calculation for networks with switches
pseudocubic May 5, 2020
c4d9bb3
REF: vnom, snom -> vm_nom, sm_nom
pseudocubic May 5, 2020
3ea057f
ADD: support for AL2W transformer definition in eng2math
pseudocubic May 6, 2020
7f30657
ADD: al2w transformer component to create_transformer
pseudocubic May 6, 2020
cea11bd
UPD: assertion failure text
pseudocubic May 6, 2020
47a9e9a
UPD: transformations syntax in parse_file
pseudocubic May 6, 2020
4301d4b
DOC: Data model changes
pseudocubic May 6, 2020
ed3418d
DOC: data model page title
pseudocubic May 6, 2020
9c9fe90
DOC: update type hierarchies documentation
pseudocubic May 6, 2020
8cc066e
ADD: Enums documentation
pseudocubic May 6, 2020
9f2c6c6
ADD: reference to examples
pseudocubic May 6, 2020
1cc773e
FIX: "rs" -> "rw" for transformers
pseudocubic May 6, 2020
4783195
FIX: transformations interface in parse_file
pseudocubic May 6, 2020
c7eb1c9
FIX: calc_voltage_bases for eng model
pseudocubic May 6, 2020
0400545
DOC: example notebook
pseudocubic May 6, 2020
7354c3b
FIX: Changelog
pseudocubic May 6, 2020
3801d7e
ADD: examples of multinetworks
pseudocubic May 7, 2020
feec716
ADD: example for using helper funcs for eng model creation
pseudocubic May 7, 2020
132a857
ADD: more helper funcs to example
pseudocubic May 7, 2020
f0937a6
ADD: unit tests for new features
pseudocubic May 7, 2020
ea97e10
FIX: bug in data_model tests
pseudocubic May 7, 2020
9c9659b
ADD: missing si -> pu conversions
pseudocubic May 7, 2020
4363f45
FIX: Address review comments
pseudocubic May 11, 2020
14e6c1b
added docs
sanderclaeys May 12, 2020
07dc49d
ADD: instantiate_mc_model
pseudocubic May 12, 2020
a4e4f88
DOC: cleanup
pseudocubic May 12, 2020
cd01fc4
FIX: readme logo size
pseudocubic May 12, 2020
7dfa94b
FIX: constraint_mc_load_setpoint not passing report
pseudocubic May 13, 2020
e339de7
REF: `imag` -> `cmag` on transformers
pseudocubic May 13, 2020
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,6 @@
deps/deps.jl
docs/build

Manifest.toml
Manifest.toml

.ipynb_checkpoints/
4 changes: 2 additions & 2 deletions .travis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,15 @@ os:
- windows
julia:
- 1.0
- 1.3
- 1.4
- nightly
codecov: true
jobs:
allow_failures:
- julia: nightly
include:
- stage: "Documentation"
julia: 1.3
julia: 1.4
os: linux
script:
- julia --project=docs/ -e 'using Pkg; Pkg.instantiate(); Pkg.develop(PackageSpec(path=pwd()))'
Expand Down
32 changes: 29 additions & 3 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,40 @@

## staged

- none

## v0.9.0

- Add `instantiate_mc_model` to aid in building JuMP model from ENGINEERING data model
- SDP and SOC relaxations were broken but are fixed again (unit tests added)
- Remove `run_mc_opf_iv`, `run_mc_opf_bf`, `run_mc_opf_bf_lm`, `run_mc_pf_bf`, `run_mc_pf_iv`, these can be accessed by using the correct formulation with `run_mc_opf` and `run_mc_pf`
- Add support for Memento 1.1
- Add support for PowerModels v0.17 (breaking)
- Add support for InfrastructureModels v0.5
- Updates JSON parser to handle enum (`"data_model"` values)
- Adds some commonly used InfrastructureModels and PowerModels functions as exports
- Adds model building functions `add_{component}!` to aid in building simple models for testing (experimental)
- Add `run_mc_model` (adds `ref_add_arcs_transformer!` to ref_extensions, and sets `multiconductor=true` by default) (breaking)
- Rename `ref_add_arcs_trans` -> `ref_add_arcs_transformer` (breaking)
- Update `count_nodes`, now counts source nodes as well, excludes \_virtual objects
- Change \_PMs and \_IMs to \_PM, \_IM, respectively
- Add example for PowerModelsDistribution usage (see Jupyter notebooks in `/examples`)
- Update transformer mathematical model
- Introduce new data models: ENGINEERING, MATHEMATICAL (see data model documentation) (breaking)
- Update DSS parser to be more robust, and parse into new format (breaking)
- Updates DSS paser to parse more options/commands, moves these into `"options"` dict (breaking)
- Updates how dss `like` is applied to better match opendss (almost all properties are copied with like) (breaking)
- Add support for new OpenDSS components (loadshape, xfmrcode, xycurve)
- Add support for JuMP v0.22 (exports `optimizer_with_attributtes` by default)
- Add support for PowerModels v0.16 (breaking)
- Add support for Memento v0.13, v1.0

## v0.8.1

- Update to support JuMP v0.21
- Makes bounds optional, turned on by default (#250)
- Updated transformer data model in the mathematical model (#250)
- Add automatic parsing of lon,lat from buscoords file into PMD data structure (#245, #249)
- Add automatic parsing of lon,lat from buscoords file into PowerModelsDistribution data structure (#245, #249)
- Updates virtual_sourcebus, which is intended to represent a voltage source, to have a fixed voltage magnitude (#246,#248)
- Add parsing of series data files into array fields in OpenDSS parser
- Add LoadShape parsing to OpenDSS parser (#247)
Expand All @@ -22,9 +48,9 @@

## v0.8.0

- Update solution building infrastructure (PMs #77) (breaking). The reported solution is now consistent with the variable space of the formulation.
- Update solution building infrastructure (PowerModels #77) (breaking). The reported solution is now consistent with the variable space of the formulation.
- Moved multi-conductor support from PowerModels into PowerModelsDistribution. (breaking)
- PMs.var no longer takes conductor as an argument
- PowerModels.var no longer takes conductor as an argument
- Constraints have been (partially) re-written to use vectorized JuMP syntax where possible.
- Bugfixes: generator on-off and storage on-off constraints were incorrect
- Removal of SOCWRPowerModel
Expand Down
8 changes: 4 additions & 4 deletions Project.toml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ name = "PowerModelsDistribution"
uuid = "d7431456-977f-11e9-2de3-97ff7677985e"
authors = ["David M Fobes <[email protected]>", "Carleton Coffrin"]
repo = "https://github.com/lanl-ansi/PowerModelsDistribution.jl.git"
version = "0.8.1"
version = "0.9.0"

[deps]
InfrastructureModels = "2030c09a-7f63-5d83-885d-db604e0e9cc0"
Expand All @@ -16,14 +16,14 @@ Statistics = "10745b16-79ce-11e8-11f9-7d13ad32a3b2"

[compat]
Cbc = ">= 0.4"
InfrastructureModels = "~0.4"
InfrastructureModels = "~0.5"
Ipopt = ">= 0.4"
JSON = "~0.18, ~0.19, ~0.20, ~0.21"
JuMP = "~0.19.2, ~0.20, ~0.21"
Juniper = ">= 0.4"
MathOptInterface = "~0.8, ~0.9"
Memento = "~0.10, ~0.11, ~0.12, ~0.13, ~1.0"
PowerModels = "~0.15"
Memento = "~0.10, ~0.11, ~0.12, ~0.13, ~1.0, ~1.1"
PowerModels = "~0.17"
SCS = ">= 0.4"
julia = "^1"

Expand Down
46 changes: 38 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,22 +16,37 @@ This enables the definition of a wide variety of power network formulations and
## Core Problem Specifications

- Power Flow (pf)
- Optimal Power Flow (opf), for the Bus Injection Model (BIM) as well as the Branch Flow Model (BFM)
- Continuous load shed, minimum load delta (mld), for the Branch Flow Model (LPLinUBFPowerModel), AC Polar (ACPPowerModel), and Network Flow Approximation (NFAPowerModel)
- ACP, ACR, IVR, LinDist3Flow, NFA, DCP
- Optimal Power Flow (opf)
- ACP, ACR, IVR, LinDist3Flow, NFA, DCP
- Continuous load shed, minimum load delta (mld)
- ACP, LinDist3Flow, NFA
- Optimal Power Flow with on-load tap-changer (opf_oltc)
- ACP

**Note: The documentation is somewhat lagging behind development and the parings of network features with problem specifications with formulations has not been enumerated. We are working to correct this for you.**

## Core Network Formulations

- AC (polar and rectangular coordinates)
- SDP BFM relaxation
- SOC BFM and BIM relaxation (W-space)
- Linear approximation (LinDist3Flow and simplified unbalanced DistFlow)
- Nonlinear
- ACP
- ACR
- IVR
- Relaxations
- SDP BFM
- SOC BFM and BIM relaxation (W-space)
- Linear Approximations
- LinDist3Flow
- NFA
- DCP

## Network Data Formats

- Matlab ".m" files (extended for three-phase)
- OpenDSS ".dss" files

**Warning:** This package is under active development and may change drastically without warning.
## Examples

Examples of how to use PowerModelsDistribution can be found in the main documentation and in Jupyter Notebooks inside the `/examples` directory

## Development

Expand All @@ -44,6 +59,21 @@ This code has been developed as part of the Advanced Network Science Initiative
- Sander Claeys (@sanderclaeys) KU Leuven, transformer models and ACR formulation
- Frederik Geth (@frederikgeth) CSIRO, Distribution modeling advise

## Citing PowerModelsDistribution

If you find PowerModelsDistribution useful for your work, we kindly request that you cite the following [https://arxiv.org/abs/2004.10081](publication):

```bibtex
@misc{fobes2020powermodelsdistributionjl,
title={PowerModelsDistribution.jl: An Open-Source Framework for Exploring Distribution Power Flow Formulations},
author={David M Fobes and Sander Claeys and Frederik Geth and Carleton Coffrin},
year={2020},
eprint={2004.10081},
archivePrefix={arXiv},
primaryClass={cs.CE}
}
```

## License

This code is provided under a BSD license as part of the Multi-Infrastructure Control and Optimization Toolkit (MICOT) project, LA-CC-13-108.
4 changes: 2 additions & 2 deletions docs/Project.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,5 @@ InfrastructureModels = "2030c09a-7f63-5d83-885d-db604e0e9cc0"
PowerModels = "c36e90e8-916a-50a6-bd94-075b64ef4655"

[compat]
InfrastructureModels = "~0.4"
PowerModels = "~0.15"
InfrastructureModels = "~0.5"
PowerModels = "~0.17"
7 changes: 6 additions & 1 deletion docs/make.jl
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,13 @@ makedocs(
"Home" => "index.md",
"Manual" => [
"Getting Started" => "quickguide.md",
"Connecting Components" => "connections.md",
"Mathematical Model" => "math-model.md",
"Data Formats" => "data-formats.md",
"Engineering Data Model" => "eng-data-model.md",
"Enums in Engineering Model" => "enums.md",
"Conversion to Mathematical Model" => "eng2math.md",
"External Data Formats" => "external-data-formats.md",
"Examples" => "engineering_model.md",
],
"Library" => [
"Network Formulations" => "formulations.md",
Expand Down
Loading