dcline documentation, technical report

abhishek1591 · Jan 11, 2017 · 43f0f54 · 43f0f54
1 parent 1da477a
commit 43f0f54
Show file tree

Hide file tree

Showing 18 changed files with 437 additions and 227 deletions.
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -1,7 +1,7 @@
 Change Log
 =============
 
-unreleased
+[1.1.0] - 2017-01-11
 ----------------------
 - [ADDED] impedance element can now be used with unsymetric impedances zij != zji
 - [ADDED] dcline element that allows modelling DC lines in PF and OPF

diff --git a/doc/about/tests.rst b/doc/about/tests.rst
@@ -149,7 +149,7 @@ The loadflow result for the exact same network are now compared in pandapower an
 and transformer results:
 
 .. image:: ../pics/validation/validation_trafo.png
-	:width: 60em
+	:width: 40em
 	:align: center
 
 match within the margins defined above.

diff --git a/doc/about_latex.rst b/doc/about_latex.rst
@@ -12,9 +12,11 @@ Operation at the Fraunhofer Institute for Wind Energy and Energy System Technolo
     :maxdepth: 1
 
     about/what
-    about/introduction
     about/contributions
+    getting_started/introduction
     about/units
+    about/tests
+    about/changelog
     about/license
 
 

diff --git a/doc/converter/matpower.rst b/doc/converter/matpower.rst
@@ -1,5 +1,5 @@
 ==============
-Matpower
+MATPOWER
 ==============
 
 .. _converter_matpower:

diff --git a/doc/converter/pypower.rst b/doc/converter/pypower.rst
@@ -1,5 +1,5 @@
 ==================
-Pypower
+PYPOWER
 ==================
 
 .. _converter_pypower:

diff --git a/doc/elements/dcline.rst b/doc/elements/dcline.rst
@@ -35,23 +35,31 @@ Input Parameters
 Electric Model
 =================
 
-Generators are modelled as PV-nodes in the power flow:
+A DC line is modelled as two generators in the loadflow:
 
-.. image:: gen.png
-	:width: 12em
+.. image:: dcline1.png
+	:width: 20em
 	:alt: alternate Text
 	:align: center
 
-Voltage magnitude and active power are defined by the input parameters in the generator table:
+.. image:: dcline2.png
+	:width: 20em
+	:alt: alternate Text
+	:align: center
+
+The active power at the from side is defined by the parameters in the dcline table. The active power at the to side is equal to the active power on the from side minus the losses of the DC line.
 
 .. math::
    :nowrap:
    
    \begin{align*}
-    P_{gen} &= p\_kw * scaling \\
-    v_{bus} &= vm\_pu
-   \end{align*}
+    P_{from} &= p\_kw \\
+    P_{to} &= - (p\_kw - loss\_kw) \cdot (1 - \frac{loss\_percent}{100})
     
+   \end{align*}
+
+The voltage control with reactive power works just as described for the generator model. Maximum and Minimum reactive power limits are considered in the OPF, and in the PF if it is run with enforce_q_lims=True.
+
 Result Parameters
 ==========================
 *net.res_dcline*
@@ -60,4 +68,19 @@ Result Parameters
 .. csv-table:: 
    :file: dcline_res.csv
    :delim: ;
-   :widths: 10, 10, 50
+   :widths: 10, 10, 50
+
+.. math::
+   :nowrap:
+   
+   \begin{align*}
+    p\_from\_kw &= P_{from} \\
+    p\_to\_kw &= P_{to} \\
+    pl\_kw &= p\_from\_kw + p\_to\_kw \\
+    q\_from\_kvar &= Q_{from} \\
+    q\_to\_kvar &= Q_{to} \\
+    va\_from\_degree &= \angle \underline{v}_{from} \\
+    va\_to\_degree &= \angle \underline{v}_{to} \\
+    vm\_from\_degree &= |\underline{v}_{from}| \\    
+    vm\_to\_degree &= |\underline{v}_{to}| \\
+   \end{align*}
diff --git a/doc/elements/dcline1.png b/doc/elements/dcline1.png
diff --git a/tutorials/opf/example_opf _dc.sxe.bak → doc/elements/dcline1.sxe b/tutorials/opf/example_opf _dc.sxe.bak → doc/elements/dcline1.sxe
diff --git a/doc/elements/dcline2.png b/doc/elements/dcline2.png
diff --git a/doc/elements/dcline2.sxe b/doc/elements/dcline2.sxe
diff --git a/doc/elements/gen.rst b/doc/elements/gen.rst
@@ -72,7 +72,8 @@ The power flow returns reactive generator power and generator voltage angle:
    \begin{align*}
     p\_kw &= P_{gen} \\
     q\_kvar &= Q_{gen} \\
-    va\_degree &= \angle \underline{v}_{bus}
+    va\_degree &= \angle \underline{v}_{bus} \\
+    vm\_degree &= |\underline{v}_{bus}|
    \end{align*}
 
    

diff --git a/doc/file_io.rst b/doc/file_io.rst
@@ -1,8 +1,8 @@
 .. _file_io:
 
-########################
+========================
 Save and Load Networks
-########################
+========================
 
 pandapower networks can be saved and loaded using the pickle library or with an excel file.
 
@@ -17,15 +17,15 @@ Even though the relevant information is conserved, the process is not as robust
 
 
 pickle
-=======================================
+-----------
 
 .. autofunction:: pandapower.to_pickle
 
 .. autofunction:: pandapower.from_pickle
 
 
 Excel
-=======================================
+-----------
 
 .. autofunction:: pandapower.to_excel
 

diff --git a/doc/getting_started/pandapower.pdf b/doc/getting_started/pandapower.pdf
diff --git a/doc/std_types.rst b/doc/std_types.rst
@@ -1,8 +1,8 @@
 .. _std_types:
 
-##########################
+=========================
 Standard Type Libraries
-##########################
+==========================
 
 Lines and transformers have two different categories of parameters: parameter that depend on the specific element (like the length of a line or the bus to which a transformer is connected to etc.) and parameter that only 
 depend on the type of line or transformer which is used (like the rated power of a transformer or the resistance per kilometer line).

diff --git a/pandapower/test/consistency_checks.py b/pandapower/test/consistency_checks.py
@@ -13,7 +13,7 @@ def runpp_with_consistency_checks(net, **kwargs):
     consistency_checks(net)
     return True
 
-def consistency_checks(net, rtol):
+def consistency_checks(net, rtol=1e-5):
     indices_consistent(net)
     branch_loss_consistent_with_bus_feed_in(net, rtol)
     element_power_consistent_with_bus_power(net, rtol)