Complete documentation

Signed-off-by: Denis Bonnand <[email protected]>

Author: Denis Bonnand

docs/loadflow/parameters.md

@@ -596,6 +596,16 @@ When set to `false`:
 
 The default value is `true`.
 
+**acDcNetwork**
+
+Defines if the loadflow uses DC detailed component and computes an AC DC loadflow 
+
+If `true`, the network supports DC detailed components, and the loadflow is computed on the whole connected network, 
+AC and DC sides in the same Jacobian matrix.
+
+If `false`, the loadflow is the classic one, without DC detailed components.
+
+The default value is `false`.
 
 ## Configuration file example
 See below an extract of a config file that could help:

src/main/java/com/powsybl/openloadflow/ac/AcTargetVector.java

@@ -66,11 +66,11 @@ private static double getReactivePowerControlTarget(LfBranch branch) {
 
     public static void init(Equation<AcVariableType, AcEquationType> equation, LfNetwork network, double[] targets) {
         switch (equation.getType()) {
-            case BUS_TARGET_P:
+            case BUS_TARGET_P :
                 targets[equation.getColumn()] = network.getBus(equation.getElementNum()).getTargetP();
                 break;
 
-            case BUS_DISTR_SLACK_P:
+            case BUS_DISTR_SLACK_P :
                 targets[equation.getColumn()] = network.getBus(equation.getElementNum()).getTargetP() - network.getSlackBuses().get(0).getTargetP();
                 break;
 

src/main/java/com/powsybl/openloadflow/ac/equations/AcVariableType.java

@@ -25,9 +25,9 @@ public enum AcVariableType implements Quantity {
     BRANCH_RHO1("\u03C1", ElementType.BRANCH), // branch voltage ratio
     DUMMY_P("dummy_p", ElementType.BRANCH), // dummy active power injection (zero impedance branch)
     DUMMY_Q("dummy_q", ElementType.BRANCH), // dummy reactive power injection (zero impedance branch)
-    DC_NODE_V("v_dc", ElementType.DC_NODE),
-    CONV_P_AC("conv_p_ac", ElementType.CONVERTER),
-    CONV_Q_AC("conv_q_ac", ElementType.CONVERTER);
+    DC_NODE_V("v_dc", ElementType.DC_NODE), // dc node voltage
+    CONV_P_AC("conv_p_ac", ElementType.CONVERTER), // converter active power, at AC side
+    CONV_Q_AC("conv_q_ac", ElementType.CONVERTER); // converter reactive power, at DC side
 
     private final String symbol;
 

src/main/java/com/powsybl/openloadflow/network/LfNetwork.java

@@ -182,7 +182,6 @@ public LfNetwork(int numCC, int numSC, SlackBusSelector slackBusSelector, int ma
     }
 
     public LfNetwork(LfNetwork network) {
-        //TODO : find a better way to implement AC and DC subnetworks
         this(network.numCC, network.numSC, network.slackBusSelector, network.maxSlackBusCount,
                 network.connectivityFactory, network.referenceBusSelector, ReportNode.NO_OP);
     }