lanl-ansi
diff --git a/‎.gitignore
+2 b/‎.gitignore
+2
diff --git a/‎.travis.yml
+2-7 b/‎.travis.yml
+2-7
diff --git a/‎CHANGELOG.md
+52-4 b/‎CHANGELOG.md
+52-4
diff --git a/‎LICENCE.md ‎LICENSE.md b/‎LICENCE.md ‎LICENSE.md
diff --git a/‎Manifest.toml
+22-16 b/‎Manifest.toml
+22-16
diff --git a/‎Project.toml
+11-1 b/‎Project.toml
+11-1
diff --git a/‎README.md
+25-11 b/‎README.md
+25-11
diff --git a/‎REQUIRE
-7 b/‎REQUIRE
-7
diff --git a/‎docs/make.jl
+7-2 b/‎docs/make.jl
+7-2
diff --git a/‎docs/src/developer.md
+7 b/‎docs/src/developer.md
+7
@@ -6,3 +6,5 @@ deps/deps.jl
 docs/build/
 docs/site/
 docs/.documenter
+.project
+.tags
@@ -16,16 +16,11 @@ addons:
     - gfortran
 
 before_install:
-    # don't keep an old version of the code in the cache
-  - julia -e 'using Pkg; if "PowerModels" in keys(Pkg.installed()) Pkg.rm("PowerModels"); Pkg.rm("PowerModels") end'
-  - julia -e 'using Pkg; Pkg.update()' #make sure we get the latest version of METADATA
-  - julia -e 'using Pkg; if !("Coverage" in keys(Pkg.installed())) Pkg.add("Coverage") end'
-  - julia -e 'using Pkg; if !("Documenter" in keys(Pkg.installed())) Pkg.add("Documenter") end'
+ - julia --project --color=yes -e "import Pkg; Pkg.instantiate(); Pkg.build();" #make sure the depedencies are working properly
 
 script:
   - if [[ -a .git/shallow ]]; then git fetch --unshallow; fi
-  - julia -e 'using Pkg; Pkg.clone(pwd())'
-  - julia -e 'using Pkg; Pkg.test("PowerModels", coverage=true)'
+  - julia --check-bounds=yes --depwarn=no --color=yes --project -e "import Pkg; Pkg.test(coverage=true);"
 
 after_success:
   - julia -e  'using PowerModels; using Coverage; cd(pathof(PowerModels)); LCOV.writefile("lcov.info", process_folder(".")); run(pipeline(`curl -s https://codecov.io/bash`, `bash`))'
 
@@ -1,9 +1,57 @@
 PowerModels.jl Change Log
-=================
+=========================
 
 ### Staged
 - nothing
 
+### v0.8.4
+- Added SparseSDPWRMPowerModel model (thanks to @kersulis)
+- Added Julia version upper bound
+- Improved OBBT bound update logic
+
+### v0.8.3
+- Added support for current limits, issue #342
+- Added a optimal power balance problem specification
+- Added a network flow approximation formulation, NFAPowerModel
+- Added conic variant of the SOCWRPowerModel model, SOCWRConicPowerModel (thanks to @kersulis)
+- Added data simplification for piecewise linear cost functions
+- Added sim_parallel_run_time to OBBT stats
+- Made thermal limits optional in the data model
+- Fixed a bug in quadratic conic objective functions
+- Fixed a bug where dcline reactive variables entered active power only formulations
+- Expanded documentation (mathematical model, formulations, references for formulations)
+
+### v0.8.2
+- Added optimality-based bound tightening (OBBT) functionality for the QC relaxations
+- Added branch flow conic forms, e.g. AbstractBFConicForm, SOCBFConicPowerModel
+- Update MINLP solvers used in testing
+- Minor issues closed #328
+
+### v0.8.1
+- Strengthened the QCWRTri Power Flow formulation
+- Added support for implicit single conductor to buspairs data
+- Made add_setpoint more flexible when working with a mixture of data types
+- Fixed a bug in TNEP voltage variable definitions
+
+### v0.8.0
+- Added support for asymmetric line charging in all formulations
+- Added Matpower data file export function
+- Added mathematical model to documentation
+- Added parsing string data from IO objects
+- Added support for network data with multiple conductors (breaking)
+- Removed explicit series variables from branch flow model
+- Improved helper functions ref, var, con to work with multiple networks and multiple conductors
+- Minor robustness improvements to parsing PTI files
+- Minor issues closed #316
+
+### v0.7.2
+- Removed Memento depreciation warnings
+
+### v0.7.1
+- Added warning when data is missing in a PTI file
+- Minor tidying of matpower test cases
+- Relaxed variable bounds in BFM to be consistent with BIM
+
 ### v0.7.0
 - Added component_table function for building matrices from component data
 - Added "source_id" to uniquely identify each component imported from a PTI file
@@ -77,7 +125,7 @@ PowerModels.jl Change Log
 - Made index_name an optional parameter in add_setpoint (breaking)
 - Moved check_cost_models into the objective building function
 - Fixed out of range bug in calc_theta_delta_bounds
-- Fixed bug in phase angle differences in AbstractACPForms
+- Fixed bug in voltage angle differences in AbstractACPForms
 - Fixed bugs in AbstractDCPLLForm and added OPF test
 
 ### v0.3.4
@@ -88,7 +136,7 @@ PowerModels.jl Change Log
 - Added w-theta formulation of AC-OPF
 - Added data units checks to update_data
 - Made branch flow parameter names consistent with Matpower
-- Fixed bug in constants for w-space phase angle difference constraints
+- Fixed bug in constants for w-space voltage angle difference constraints
 - Fixed bug when no reference bus was specified
 - Fixed dcline parsing bug
 
@@ -122,7 +170,7 @@ PowerModels.jl Change Log
 - Strengthened convex formulations with Lifted Nonlinear Cuts (LNCs)
 - Added ability to easily inspect the JuMP model produced by PowerModels
 - Added constraint templates to provide an abstraction layer between the network data and network constraint definitions
-- Moved system wide phase angle difference bounds to the "ref" dictionary
+- Moved system wide voltage angle difference bounds to the "ref" dictionary
 - Refactored model definitions to be based on complex numbers
 
 ### v0.2.3
 
@@ -9,9 +9,9 @@ version = "0.8.10"
 
 [[BinaryProvider]]
 deps = ["Libdl", "Pkg", "SHA", "Test"]
-git-tree-sha1 = "b530fbeb6f41ab5a83fbe3db1fcbe879334bcd2d"
+git-tree-sha1 = "38be61810f280c3c478f5c38aaf387f8f9199275"
 uuid = "b99e7846-7c00-51b0-8f62-c81ae34c0232"
-version = "0.4.2"
+version = "0.5.1"
 
 [[Calculus]]
 deps = ["Compat"]
@@ -27,15 +27,15 @@ version = "0.2.0"
 
 [[Compat]]
 deps = ["Base64", "Dates", "DelimitedFiles", "Distributed", "InteractiveUtils", "LibGit2", "Libdl", "LinearAlgebra", "Markdown", "Mmap", "Pkg", "Printf", "REPL", "Random", "Serialization", "SharedArrays", "Sockets", "SparseArrays", "Statistics", "Test", "UUIDs", "Unicode"]
-git-tree-sha1 = "ae262fa91da6a74e8937add6b613f58cd56cdad4"
+git-tree-sha1 = "ff2595695fc4f14427358ce2593f867085c45dcb"
 uuid = "34da2185-b29b-5c13-b0c7-acf172513d20"
-version = "1.1.0"
+version = "1.2.0"
 
 [[DataStructures]]
-deps = ["InteractiveUtils", "REPL", "Random", "Serialization", "Test"]
-git-tree-sha1 = "2afbbd0294306b0b74a753c196be50b35edb625c"
+deps = ["InteractiveUtils", "OrderedCollections", "REPL", "Random", "Serialization", "Test"]
+git-tree-sha1 = "8fc6e166e24fda04b2b648d4260cdad241788c54"
 uuid = "864edb3b-99cc-5e75-8d2d-829cb0a9cfe8"
-version = "0.11.1"
+version = "0.14.0"
 
 [[Dates]]
 deps = ["Printf"]
@@ -63,9 +63,9 @@ uuid = "8ba89e20-285c-5b6f-9357-94700520ee1b"
 
 [[EzXML]]
 deps = ["BinaryProvider", "Libdl", "Pkg", "Printf", "Test"]
-git-tree-sha1 = "0080045a5ce51180a704d67074c0f15a41b9427a"
+git-tree-sha1 = "5623d1486bfaadd815f5c4ca501adda02b5337f1"
 uuid = "8f5d6c58-4d21-5cfd-889c-e3ad7ee6a615"
-version = "0.8.0"
+version = "0.9.0"
 
 [[ForwardDiff]]
 deps = ["CommonSubexpressions", "DiffResults", "DiffRules", "InteractiveUtils", "LinearAlgebra", "NaNMath", "Pkg", "Random", "SparseArrays", "SpecialFunctions", "StaticArrays", "Test"]
@@ -91,11 +91,11 @@ version = "0.19.0"
 
 [[JuMP]]
 deps = ["Calculus", "Compat", "DataStructures", "ForwardDiff", "MathOptInterface", "NaNMath"]
-git-tree-sha1 = "fad7882951ac4e093b3479445b6b3595abcdb7b5"
+git-tree-sha1 = "145418bd00fe9b66250715818bd6dbf2a6b1b32e"
 repo-rev = "master"
 repo-url = "https://github.com/JuliaOpt/JuMP.jl.git"
 uuid = "4076af6c-e467-56ae-b986-b466b2749572"
-version = "0.18.2+"
+version = "0.18.4+"
 
 [[LibGit2]]
 uuid = "76f85450-5226-5b5a-8eaa-529ad045b433"
@@ -116,9 +116,9 @@ uuid = "d6f4376e-aef5-505a-96c1-9c027394607a"
 
 [[MathOptInterface]]
 deps = ["Compat", "Unicode"]
-git-tree-sha1 = "f2791f990529b7aea1fcb9fd45b636cd3a9d1e79"
+git-tree-sha1 = "ba12e7ce825c1458c03f88aae84fa630d882d303"
 uuid = "b8f27783-ece8-5eb3-8dc8-9495eed66fee"
-version = "0.6.0"
+version = "0.6.1"
 
 [[Memento]]
 deps = ["Compat", "JSON", "Libdl", "Nullables", "Pkg", "Syslogs", "Test", "TimeZones"]
@@ -147,6 +147,12 @@ git-tree-sha1 = "ae1a63457e14554df2159b0b028f48536125092d"
 uuid = "4d1e1d77-625e-5b40-9113-a560ec7a8ecd"
 version = "0.0.8"
 
+[[OrderedCollections]]
+deps = ["Pkg", "Random", "Serialization", "Test"]
+git-tree-sha1 = "85619a3f3e17bb4761fe1b1fd47f0e979f964d5b"
+uuid = "bac558e1-5e72-5ebc-8fee-abe8a469f55d"
+version = "1.0.2"
+
 [[Pkg]]
 deps = ["Dates", "LibGit2", "Markdown", "Printf", "REPL", "Random", "SHA", "UUIDs"]
 uuid = "44cfe95a-1eb2-52ea-b672-e2afdf69b78f"
@@ -181,10 +187,10 @@ deps = ["LinearAlgebra", "Random"]
 uuid = "2f01184e-e22b-5df5-ae63-d93ebab69eaf"
 
 [[SpecialFunctions]]
-deps = ["BinDeps", "BinaryProvider", "Compat", "Libdl"]
-git-tree-sha1 = "d12f8917be3782f4b800ba16003b8d0d4858c2e5"
+deps = ["BinDeps", "BinaryProvider", "Libdl", "Test"]
+git-tree-sha1 = "c35c9c76008babf4d658060fc64aeb369a41e7bd"
 uuid = "276daf66-3868-5448-9aa4-cd146d93841b"
-version = "0.7.0"
+version = "0.7.1"
 
 [[StaticArrays]]
 deps = ["InteractiveUtils", "LinearAlgebra", "Random", "Statistics", "Test"]
 
@@ -1,12 +1,22 @@
 name = "PowerModels"
 uuid = "c36e90e8-916a-50a6-bd94-075b64ef4655"
-version = "0.7.0"
+version = "v0.8.4"
 
 [deps]
 Compat = "34da2185-b29b-5c13-b0c7-acf172513d20"
 InfrastructureModels = "2030c09a-7f63-5d83-885d-db604e0e9cc0"
 JSON = "682c06a0-de6a-54ab-a142-c8b1cf79cde6"
 JuMP = "4076af6c-e467-56ae-b986-b466b2749572"
+LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
 MathOptInterface = "b8f27783-ece8-5eb3-8dc8-9495eed66fee"
 Memento = "f28f55f0-a522-5efc-85c2-fe41dfb9b2d9"
 Pkg = "44cfe95a-1eb2-52ea-b672-e2afdf69b78f"
+
+[extras]
+Cbc = "9961bab8-2fa3-5c5a-9d89-47fab24efd76"
+Ipopt = "b6b21f68-93f8-5de0-b562-5493be1d77c9"
+SCS = "c946c3f1-0d1f-5ce8-9dea-7daa1f7e2d13"
+Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
+
+[targets]
+test = ["Test", "Cbc", "Ipopt", "SCS"]
@@ -22,14 +22,23 @@ This enables the definition of a wide variety of power network formulations and
 **Core Network Formulations**
 * AC (polar and rectangular coordinates)
 * DC Approximation (polar coordinates)
+* SDP Relaxation (W-space)
 * SOC Relaxation (W-space)
 * QC Relaxation (W+L-space)
 
 **Network Data Formats**
 * Matpower ".m" files
 * PTI ".raw" files (PSS(R)E v33 specfication)
 
-For further information, consult the package [documentation](https://lanl-ansi.github.io/PowerModels.jl/stable/).
+
+## Documentation
+
+The package [documentation](https://lanl-ansi.github.io/PowerModels.jl/stable/) includes a variety of useful information including a [quick-start guide](https://lanl-ansi.github.io/PowerModels.jl/stable/quickguide.html), [network model specification](https://lanl-ansi.github.io/PowerModels.jl/stable/network-data.html), and [baseline results](https://lanl-ansi.github.io/PowerModels.jl/stable/experiment-results.html).
+
+Additionally, these presentations provide a brief introduction to various aspects of PowerModels,
+- [Network Model Update, v0.6](https://youtu.be/j7r4onyiNRQ)
+- [PSCC 2018](https://youtu.be/AEEzt3IjLaM)
+- [JuMP Developers Meetup 2017](https://youtu.be/W4LOKR7B4ts)
 
 
 ## Development
@@ -41,27 +50,32 @@ Community-driven development and enhancement of PowerModels are welcome and enco
 
 This code has been developed as part of the Advanced Network Science Initiative at Los Alamos National Laboratory.
 The primary developer is Carleton Coffrin(@ccoffrin) with support from the following contributors,
-- Russell Bent (@rb004f) LANL, TNEP problem specification
+- Russell Bent (@rb004f) LANL, Matpower export, TNEP problem specification
+- Hakan Ergun (@hakanergun) KU Leuven, HVDC lines
 - David Fobes (@pseudocubic) LANL, PSS(R)E v33 data support
 - Rory Finnegan (@rofinn) Invenia, Memento Logging
-- Frederik Geth (@frederikgeth) and Hakan Ergun (@hakanergun) KU Leuven, Branch Flow formulation and HVDC lines
+- Frederik Geth (@frederikgeth) CSIRO, Branch Flow formulation
+- Jonas Kersulis (@kersulis) University of Michigan, Sparse SDP formulation
 - Miles Lubin (@mlubin) MIT, Julia/JuMP advise
 - Yeesian Ng (@yeesian) MIT, Documenter.jl setup
+- Kaarthik Sundar (@kaarthiksundar) LANL, OBBT utility
 
 
 ## Citing PowerModels
 
-If you find PowerModels useful in your work, we kindly request that you cite the following [technical report](https://arxiv.org/abs/1711.01728):
+If you find PowerModels useful in your work, we kindly request that you cite the following [publication](https://ieeexplore.ieee.org/document/8442948/):
 ```
-@misc{1711.01728,
-  author = {Carleton Coffrin and Russell Bent and Kaarthik Sundar and Yeesian Ng and Miles Lubin},
-  title = {PowerModels.jl: An Open-Source Framework for Exploring Power Flow Formulations},
-  year = {2017},
-  eprint = {arXiv:1711.01728},
-  url = {http://arxiv.org/abs/1711.01728}
+@inproceedings{8442948, 
+  author = {Carleton Coffrin and Russell Bent and Kaarthik Sundar and Yeesian Ng and Miles Lubin}, 
+  title = {PowerModels.jl: An Open-Source Framework for Exploring Power Flow Formulations}, 
+  booktitle = {2018 Power Systems Computation Conference (PSCC)}, 
+  year = {2018},
+  month = {June},
+  pages = {1-8}, 
+  doi = {10.23919/PSCC.2018.8442948}
 }
 ```
-Citation of the orginal works for problem denifitions (e.g. OPF) and power flow formulations (e.g. SOC) is also encuraged when publishing works that use PowerModels.
+Citation of the orginal works for problem denifitions (e.g. OPF) and [power flow formulations](https://lanl-ansi.github.io/PowerModels.jl/stable/formulation-details.html) (e.g. SOC) is also encouraged when publishing works that use PowerModels.
 
 
 ## License
 
@@ -11,7 +11,9 @@ makedocs(
         "Manual" => [
             "Getting Started" => "quickguide.md",
             "Network Data Format" => "network-data.md",
-            "Result Data Format" => "result-data.md"
+            "Result Data Format" => "result-data.md",
+            "Mathematical Model" => "math-model.md",
+            "Utilities" => "utilities.md"
         ],
         "Library" => [
             "Network Formulations" => "formulations.md",
@@ -25,7 +27,10 @@ makedocs(
             "Relaxation Schemes" => "relaxations.md",
             "File IO" => "parser.md"
         ],
-        "Developer" => "developer.md",
+        "Developer" => [
+                "Developer" => "developer.md",
+                "Formulation Details" => "formulation-details.md"
+        ],
         "Experiment Results" => "experiment-results.md"
     ]
 )
 
@@ -73,6 +73,13 @@ $y = g + j\cdot b$:
 - `b`: susceptance ($S$)
 
 
+### Standard Value Names
+
+- network ids:`network`, `nw`, `n`
+- conductors ids: `conductor`, `cnd`, `c`
+- phase ids: `phase`, `ph`, `h`
+
+
 ## DistFlow derivation
 
 ### For an asymmetric pi section