From 69472697661d4a840dabb9fd70479502e88c164f Mon Sep 17 00:00:00 2001
From: Samir Romdhani <samir.romdhani_externe@rte-france.com>
Date: Fri, 23 Jan 2026 16:53:02 +0100
Subject: [PATCH 1/5] add security analysis tutorials

Signed-off-by: Samir Romdhani <samir.romdhani_externe@rte-france.com>
---
 docs/img/sa/nad.png                           | Bin 0 -> 25315 bytes
 docs/index.md                                 |   2 +
 docs/security-analysis.md                     | 159 ++++++++++++++++++
 pom.xml                                       |   1 +
 security-analysis/README.md                   |  27 +++
 security-analysis/pom.xml                     |  62 +++++++
 .../sa/SecurityAnalysisTutorials.java         | 139 +++++++++++++++
 .../src/main/resources/config.yml             |   3 +
 .../src/main/resources/network.xiidm          |  42 +++++
 .../main/resources/simplelogger.properties    |   2 +
 10 files changed, 437 insertions(+)
 create mode 100644 docs/img/sa/nad.png
 create mode 100644 docs/security-analysis.md
 create mode 100644 security-analysis/README.md
 create mode 100644 security-analysis/pom.xml
 create mode 100644 security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
 create mode 100644 security-analysis/src/main/resources/config.yml
 create mode 100644 security-analysis/src/main/resources/network.xiidm
 create mode 100644 security-analysis/src/main/resources/simplelogger.properties

diff --git a/docs/img/sa/nad.png b/docs/img/sa/nad.png
new file mode 100644
index 0000000000000000000000000000000000000000..86b5a0edf48940938a0b1c187399d79b72d65086
GIT binary patch
literal 25315
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
L%DDWG+fV)j8P$-m

literal 0
HcmV?d00001

diff --git a/docs/index.md b/docs/index.md
index bc3ed77..1b24b62 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -11,6 +11,7 @@ intellij.md
 iTools<itools/index.md>
 Load flow<loadflow.md>
 Sensitivity analysis<sensitivity-analysis.md>
+Security analysis<security-analysis.md>
 Topology<topology.md>
 Diagrams<diagram/index.md>
 Downscaling<downscaling.md>
@@ -29,6 +30,7 @@ Network modifications in Groovy<network_modifications_groovy.md>
 ## Simulation
 - [Create the Java code to run power flows](loadflow.md): Learn how to create the Java code to setup and run power flows
 - [Create the Java code to run sensitivity analyses](sensitivity-analysis.md): Learn how to create the Java code to setup and run sensitivity analyses
+- [Security analyses](security-analysis.md): Learn how to use security analyses
 
 ## Topology
 - [Manage bus/breaker and node/breaker topology](topology.md): Learn how to manipulate topological views of the network
diff --git a/docs/security-analysis.md b/docs/security-analysis.md
new file mode 100644
index 0000000..82aff9d
--- /dev/null
+++ b/docs/security-analysis.md
@@ -0,0 +1,159 @@
+---
+layout: default
+---
+
+# Write the Java code to perform security analysis
+
+In order to perform a `security analysis`, you need a `network` and at least one `contingency` (i.e. one failure) on that network,
+and possibly `operator strategies` that can take `actions` to correct a default.
+
+### What will you build?
+
+This tutorial presents three use cases of security analysis simulation. 
+Each example follows a brief and straightforward workflow, using input data that includes an XIIDM file and at least one contingency.
+
+> The three workflows can be summarized as follows:
+```text
+Network + contingency                       --> Security Analysis 
+Network + contingency + operators strategy  --> Security Analysis 
+Network + contingency + limit reduction     --> Security Analysis 
+```
+
+
+#### Tutorial steps
+
+Loading the network is a common step for all workflows. Then:
+
+1. Define a contingency and run the security analysis. 
+2. Add operator strategies and reference the associated actions. 
+3. Configure limit reduction parameters.
+
+
+### Import the network from an XML IIDM file
+
+The network we use here is available in the tutorial's resources and is described in the IIDM format. 
+Start by adding the following lines in the main function of the tutorial:
+
+```java
+Network network = Network.read("network.xiidm", SecurityAnalysisTutorials.class.getResourceAsStream("/network.xiidm"));
+```
+We now have a network in memory.
+
+The following are shown in the (Network Area Diagram) below.
+- 4 `voltage levels`
+- There is one `generator` in the voltage levels `VLGEN`.
+- There is one `load` on the voltage levels `VLLOAD`.
+- The voltage levels `VLHV1` and `VLHV2` they are connected by two parallel lines.
+
+![Workflow](./img/sa/nad.png){width="75%" .center-image}
+
+### Create a contingency
+
+Before creating a contingency, make sure that contingency can actually cause a network violation.
+As an example, we will add a limit to the line `NHV1_NHV2_1` to simulate a default violation.
+
+```java
+network.getLine("NHV1_NHV2_1")
+        .getOrCreateSelectedOperationalLimitsGroup1("DEFAULT")
+        .newCurrentLimits()
+        .setPermanentLimit(460)
+        .add();
+network.getLine("NHV1_NHV2_1").setSelectedOperationalLimitsGroup1("DEFAULT");
+```
+
+Next, on the other line `NHV1_NHV2_2`, we can add a contingency. 
+
+```java
+Contingency contingency = Contingency.line("NHV1_NHV2_2");
+```
+
+Now the security-analysis inputs are prepared, 
+we can run a security analysis. This is done in the following way.
+```java
+SecurityAnalysis.run(network, List.of(contingency));
+```
+Here are the corresponding prints in the tutorial:
+
+````
+:: SecurityAnalysis :: network and contingency
+Pre contingency results
+Post contingency results
+    Contingency : NHV1_NHV2_2
+	 	  Violation Value: 1008.9287882269946 MW/°
+	 	  Violation Limit: 460.0 MW/°
+Operator strategy results
+````
+
+### Create an Operator Strategy with Actions
+
+```java
+LoadAction loadAction = new LoadActionBuilder()
+        .withId("loadActionId")
+        .withLoadId("LOAD")
+        .withActivePowerValue(300)
+        .withRelativeValue(false)
+        .build();
+GeneratorAction generatorAction = new GeneratorActionBuilder()
+        .withId("generatorActionId")
+        .withGeneratorId("GEN")
+        .withActivePowerValue(300)
+        .withActivePowerRelativeValue(false)
+        .build();
+
+OperatorStrategy operatorStrategy = new OperatorStrategy("id1", ContingencyContext.specificContingency(contingency.getId()),
+        List.of(new ConditionalActions("stage1", new TrueCondition(), List.of(loadAction.getId(), generatorAction.getId()))));
+
+SecurityAnalysisRunParameters parameters = new SecurityAnalysisRunParameters();
+parameters.addOperatorStrategy(operatorStrategy);
+parameters.addAction(loadAction);
+parameters.addAction(generatorAction);
+
+// Run security analysis
+SecurityAnalysis.run(network, List.of(contingency), parameters);
+```
+
+Here are the corresponding prints in the tutorial:
+````
+:: SecurityAnalysis :: network, contingency, operator strategies and actions
+Pre contingency results
+Post contingency results
+    Contingency : NHV1_NHV2_2
+	 	  Violation Value: 1008.9287882269946 MW/°
+	 	  Violation Limit: 460.0 MW/°
+Operator strategy results
+    OperatorStrategy : id1
+        Violation Value: 516.0706108379493 MW/°
+        Violation Limit: 460.0 MW/°
+````
+
+### Create a Limit Reduction
+
+Note that the reduction affect results as pre-contingency violations.
+
+As an example, we are going to reduce the current limit of `NHV1_NHV2_1` line by 10%.
+
+```java
+// Limit Reduction
+LimitReduction limitReduction = LimitReduction.builder(LimitType.CURRENT, 0.9)
+        .withMonitoringOnly(false)
+        .withContingencyContext(ContingencyContext.all())
+        .build();
+parameters.addLimitReduction(limitReduction);
+
+// Run security analysis
+SecurityAnalysis.run(network, List.of(contingency), parameters);
+```
+
+Here are the corresponding prints in the tutorial:
+
+````
+:: SecurityAnalysis :: network, contingency and limit reduction
+Pre contingency results
+    Value: 456.7689759899928 MW/°
+    Limit: 460.0 MW/°
+Post contingency results
+    Contingency : NHV1_NHV2_2
+        Violation Value: 1008.9287882269946 MW/°
+        Violation Limit: 460.0 MW/°
+Operator strategy results
+````
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index cbc147d..97ec2bd 100644
--- a/pom.xml
+++ b/pom.xml
@@ -49,6 +49,7 @@
         <module>sensitivity</module>
         <module>sld-custom-node</module>
         <module>topology</module>
+        <module>security-analysis</module>
     </modules>
 
     <build>
diff --git a/security-analysis/README.md b/security-analysis/README.md
new file mode 100644
index 0000000..3de8e89
--- /dev/null
+++ b/security-analysis/README.md
@@ -0,0 +1,27 @@
+# Security Analysis tutorial
+
+This tutorial aims to compute security analysis on a network, loading a network Then:
+- [x] Make a contingency on a line and compute a security analysis.
+- [x] Add operator strategies which contains references for actions
+- [x] Add limit reduction parameters
+
+The complete tutorial is described in the [security analysis](https://powsybl.readthedocs.io/projects/powsybl-tutorials/en/latest/security-analysis.html) powsybl-tutorials documentation.
+
+# How to install the security analysis simulator
+The available security analysis implementations are described in the .
+
+In the tutorial, we use the OpenLoadFlow implementation. Please visit this page: [security analysis](https://powsybl.readthedocs.io/projects/powsybl-core/en/stable/simulation/security/implementations.html) in powsybl-core documentation for more information about it.
+
+# How to configure this tutorial
+The configuration file is:
+```
+<path_to_powsybl_tutorials>/security-analysis/src/main/resources/config.yml
+```
+
+# Running the tutorial
+You just need to execute the following command lines:
+```
+cd <path_to_powsybl_tutorials>/security-analysis/
+mvn clean package exec:exec@run
+```
+
diff --git a/security-analysis/pom.xml b/security-analysis/pom.xml
new file mode 100644
index 0000000..8114137
--- /dev/null
+++ b/security-analysis/pom.xml
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>com.powsybl.tutorials</groupId>
+        <artifactId>powsybl-tutorials</artifactId>
+        <version>2.1.0-SNAPSHOT</version>
+    </parent>
+
+    <artifactId>security-analysis</artifactId>
+    <name>Security analysis tutorial</name>
+
+    <!-- These properties are only needed to run the tutorial from the command line with mvn exec:exec@run -->
+    <properties>
+        <exec.cleanupDaemonThreads>false</exec.cleanupDaemonThreads>
+        <exec.mainClass>com.powsybl.tutorials.sa.SecurityAnalysisTutorials</exec.mainClass>
+    </properties>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>exec-maven-plugin</artifactId>
+                <configuration>
+                    <systemProperties>
+                        <systemProperty>
+                            <key>powsybl.config.dirs</key>
+                            <value>${project.basedir}/src/main/resources</value>
+                        </systemProperty>
+                    </systemProperties>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.powsybl</groupId>
+            <artifactId>powsybl-config-classic</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.powsybl</groupId>
+            <artifactId>powsybl-iidm-api</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.powsybl</groupId>
+            <artifactId>powsybl-iidm-impl</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.powsybl</groupId>
+            <artifactId>powsybl-open-loadflow</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.slf4j</groupId>
+            <artifactId>slf4j-simple</artifactId>
+            <scope>runtime</scope>
+        </dependency>
+    </dependencies>
+</project>
\ No newline at end of file
diff --git a/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java b/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
new file mode 100644
index 0000000..1dd0c0c
--- /dev/null
+++ b/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
@@ -0,0 +1,139 @@
+/**
+ * Copyright (c) 2026, RTE (http://www.rte-france.com)
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ * SPDX-License-Identifier: MPL-2.0
+ */
+package com.powsybl.tutorials.sa;
+
+import com.powsybl.action.*;
+import com.powsybl.contingency.Contingency;
+import com.powsybl.contingency.ContingencyContext;
+import com.powsybl.iidm.network.*;
+import com.powsybl.security.SecurityAnalysis;
+import com.powsybl.security.SecurityAnalysisResult;
+import com.powsybl.security.SecurityAnalysisRunParameters;
+import com.powsybl.security.condition.TrueCondition;
+import com.powsybl.security.limitreduction.LimitReduction;
+import com.powsybl.security.strategy.ConditionalActions;
+import com.powsybl.security.strategy.OperatorStrategy;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import java.io.*;
+import java.util.List;
+
+/**
+ * @author Samir Romdhani {@literal <samir.romdhani_externe at rte-france.com>}
+ */
+public final class SecurityAnalysisTutorials {
+    private static final Logger LOGGER = LoggerFactory.getLogger(SecurityAnalysisTutorials.class);
+
+    private SecurityAnalysisTutorials() {
+    }
+
+    public static void main(String[] args) {
+        // Network and Contingency
+        log(runSecurityAnalysisUseCase1());
+        // Network, Contingency, Operator Strategies and Actions
+        log(runSecurityAnalysisUseCase2());
+        // Network, Contingency, and Limit Reductions
+        log(runSecurityAnalysisUseCase3());
+    }
+
+    public static SecurityAnalysisResult runSecurityAnalysisUseCase1() {
+        Network network = Network.read("network.xml", SecurityAnalysisTutorials.class.getResourceAsStream("/network.xiidm"));
+        LOGGER.info(":: SecurityAnalysis :: network and contingency");
+
+        network.getLine("NHV1_NHV2_1")
+                .getOrCreateSelectedOperationalLimitsGroup1("DEFAULT")
+                .newCurrentLimits()
+                .setPermanentLimit(460).add();
+        network.getLine("NHV1_NHV2_1").setSelectedOperationalLimitsGroup1("DEFAULT");
+
+        Contingency contingency = Contingency.line("NHV1_NHV2_2");
+        return SecurityAnalysis.run(network, List.of(contingency)).getResult();
+    }
+
+    public static SecurityAnalysisResult runSecurityAnalysisUseCase2() {
+        Network network = Network.read("network.xml", SecurityAnalysisTutorials.class.getResourceAsStream("/network.xiidm"));
+        LOGGER.info(":: SecurityAnalysis :: network, contingency, operator strategies and actions");
+
+        network.getLine("NHV1_NHV2_1")
+                .getOrCreateSelectedOperationalLimitsGroup1("DEFAULT")
+                .newCurrentLimits()
+                .setPermanentLimit(460).add();
+        network.getLine("NHV1_NHV2_1").setSelectedOperationalLimitsGroup1("DEFAULT");
+
+        Contingency contingency = Contingency.line("NHV1_NHV2_2");
+        LoadAction loadAction = new LoadActionBuilder()
+                .withId("loadActionId")
+                .withLoadId("LOAD")
+                .withActivePowerValue(300)
+                .withRelativeValue(false)
+                .build();
+        GeneratorAction generatorAction = new GeneratorActionBuilder()
+                .withId("generatorActionId")
+                .withGeneratorId("GEN")
+                .withActivePowerValue(300)
+                .withActivePowerRelativeValue(false)
+                .build();
+
+        OperatorStrategy operatorStrategy = new OperatorStrategy("id1", ContingencyContext.specificContingency(contingency.getId()),
+                List.of(new ConditionalActions("stage1", new TrueCondition(), List.of(loadAction.getId(), generatorAction.getId()))));
+
+        SecurityAnalysisRunParameters parameters = new SecurityAnalysisRunParameters();
+        parameters.addOperatorStrategy(operatorStrategy);
+        parameters.addAction(loadAction);
+        parameters.addAction(generatorAction);
+        return SecurityAnalysis.run(network, List.of(contingency), parameters).getResult();
+    }
+
+    public static SecurityAnalysisResult runSecurityAnalysisUseCase3() {
+        Network network = Network.read("network.xml", SecurityAnalysisTutorials.class.getResourceAsStream("/network.xiidm"));
+        LOGGER.info(":: SecurityAnalysis :: network, contingency and limit reduction");
+
+        network.getLine("NHV1_NHV2_1")
+                .getOrCreateSelectedOperationalLimitsGroup1("DEFAULT")
+                .newCurrentLimits()
+                .setPermanentLimit(460).add();
+        network.getLine("NHV1_NHV2_1").setSelectedOperationalLimitsGroup1("DEFAULT");
+
+        Contingency contingency = Contingency.line("NHV1_NHV2_2");
+        SecurityAnalysisRunParameters parameters = new SecurityAnalysisRunParameters();
+        LimitReduction limitReduction = LimitReduction.builder(LimitType.CURRENT, 0.9)
+                .withMonitoringOnly(false)
+                .withContingencyContext(ContingencyContext.all())
+                .build();
+        parameters.addLimitReduction(limitReduction);
+        return SecurityAnalysis.run(network, List.of(contingency), parameters).getResult();
+    }
+
+    private static void log(SecurityAnalysisResult result) {
+        LOGGER.info("\t Pre contingency results");
+        result.getPreContingencyLimitViolationsResult().getLimitViolations()
+                .forEach(value -> {
+                    LOGGER.info("\t\t Value: {} MW/°", value.getValue());
+                    LOGGER.info("\t\t Limit: {} MW/°", value.getLimit());
+                });
+        LOGGER.info("\t Post contingency results");
+        result.getPostContingencyResults().forEach(postContingencyResult -> {
+            LOGGER.info("\t\t Contingency : {}", postContingencyResult.getContingency().getId());
+            postContingencyResult.getLimitViolationsResult().getLimitViolations()
+                    .forEach(value -> {
+                        LOGGER.info("\t\t\t Violation Value: {} MW/°", value.getValue());
+                        LOGGER.info("\t\t\t Violation Limit: {} MW/°", value.getLimit());
+                    });
+        });
+        LOGGER.info("\t Operator strategy results");
+        result.getOperatorStrategyResults().forEach(operatorStrategyResult -> {
+            LOGGER.info("\t\t OperatorStrategy : {}", operatorStrategyResult.getOperatorStrategy().getId());
+            operatorStrategyResult.getLimitViolationsResult().getLimitViolations()
+                    .forEach(value -> {
+                        LOGGER.info("\t\t\t Violation Value: {} MW/°", value.getValue());
+                        LOGGER.info("\t\t\t Violation Limit: {} MW/°", value.getLimit());
+                    });
+        });
+    }
+}
diff --git a/security-analysis/src/main/resources/config.yml b/security-analysis/src/main/resources/config.yml
new file mode 100644
index 0000000..0379aef
--- /dev/null
+++ b/security-analysis/src/main/resources/config.yml
@@ -0,0 +1,3 @@
+# This file is loaded when `powsybl.config.dirs` points to this resources directory.
+security-analysis:
+  default-impl-name: "OpenLoadFlow"
\ No newline at end of file
diff --git a/security-analysis/src/main/resources/network.xiidm b/security-analysis/src/main/resources/network.xiidm
new file mode 100644
index 0000000..1349874
--- /dev/null
+++ b/security-analysis/src/main/resources/network.xiidm
@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<iidm:network xmlns:iidm="http://www.powsybl.org/schema/iidm/1_15" id="sim1" caseDate="2013-01-15T18:45:00.000+01:00" forecastDistance="0" sourceFormat="test" minimumValidationLevel="STEADY_STATE_HYPOTHESIS">
+    <iidm:substation id="P1" country="FR" tso="RTE" geographicalTags="A">
+        <iidm:voltageLevel id="VLGEN" nominalV="24.0" topologyKind="BUS_BREAKER">
+            <iidm:busBreakerTopology>
+                <iidm:bus id="NGEN"/>
+            </iidm:busBreakerTopology>
+            <iidm:generator id="GEN" energySource="OTHER" minP="-9999.99" maxP="9999.99" voltageRegulatorOn="true" targetP="607.0" targetV="24.5" targetQ="301.0" bus="NGEN" connectableBus="NGEN">
+                <iidm:minMaxReactiveLimits minQ="-9999.99" maxQ="9999.99"/>
+            </iidm:generator>
+        </iidm:voltageLevel>
+        <iidm:voltageLevel id="VLHV1" nominalV="380.0" topologyKind="BUS_BREAKER">
+            <iidm:busBreakerTopology>
+                <iidm:bus id="NHV1"/>
+            </iidm:busBreakerTopology>
+        </iidm:voltageLevel>
+        <iidm:twoWindingsTransformer id="NGEN_NHV1" r="0.26658461538461536" x="11.104492831516762" g="0.0" b="0.0" ratedU1="24.0" ratedU2="400.0" voltageLevelId1="VLGEN" bus1="NGEN" connectableBus1="NGEN" voltageLevelId2="VLHV1" bus2="NHV1" connectableBus2="NHV1"/>
+    </iidm:substation>
+    <iidm:substation id="P2" country="FR" tso="RTE" geographicalTags="B">
+        <iidm:voltageLevel id="VLHV2" nominalV="380.0" topologyKind="BUS_BREAKER">
+            <iidm:busBreakerTopology>
+                <iidm:bus id="NHV2"/>
+            </iidm:busBreakerTopology>
+        </iidm:voltageLevel>
+        <iidm:voltageLevel id="VLLOAD" nominalV="150.0" topologyKind="BUS_BREAKER">
+            <iidm:busBreakerTopology>
+                <iidm:bus id="NLOAD"/>
+            </iidm:busBreakerTopology>
+            <iidm:load id="LOAD" loadType="UNDEFINED" p0="600.0" q0="200.0" bus="NLOAD" connectableBus="NLOAD"/>
+        </iidm:voltageLevel>
+        <iidm:twoWindingsTransformer id="NHV2_NLOAD" r="0.04724999999999999" x="4.049724365620455" g="0.0" b="0.0" ratedU1="400.0" ratedU2="158.0" voltageLevelId1="VLHV2" bus1="NHV2" connectableBus1="NHV2" voltageLevelId2="VLLOAD" bus2="NLOAD" connectableBus2="NLOAD">
+            <iidm:ratioTapChanger regulating="true" lowTapPosition="0" tapPosition="1" targetDeadband="0.0" loadTapChangingCapabilities="true" regulationMode="VOLTAGE" regulationValue="158.0">
+                <iidm:terminalRef id="NHV2_NLOAD" side="TWO"/>
+                <iidm:step r="0.0" x="0.0" g="0.0" b="0.0" rho="0.8505666905244191"/>
+                <iidm:step r="0.0" x="0.0" g="0.0" b="0.0" rho="1.0006666666666666"/>
+                <iidm:step r="0.0" x="0.0" g="0.0" b="0.0" rho="1.150766642808914"/>
+            </iidm:ratioTapChanger>
+        </iidm:twoWindingsTransformer>
+    </iidm:substation>
+    <iidm:line id="NHV1_NHV2_1" r="3.0" x="33.0" g1="0.0" b1="1.93E-4" g2="0.0" b2="1.93E-4" voltageLevelId1="VLHV1" bus1="NHV1" connectableBus1="NHV1" voltageLevelId2="VLHV2" bus2="NHV2" connectableBus2="NHV2"/>
+    <iidm:line id="NHV1_NHV2_2" r="3.0" x="33.0" g1="0.0" b1="1.93E-4" g2="0.0" b2="1.93E-4" voltageLevelId1="VLHV1" bus1="NHV1" connectableBus1="NHV1" voltageLevelId2="VLHV2" bus2="NHV2" connectableBus2="NHV2"/>
+</iidm:network>
diff --git a/security-analysis/src/main/resources/simplelogger.properties b/security-analysis/src/main/resources/simplelogger.properties
new file mode 100644
index 0000000..7456f15
--- /dev/null
+++ b/security-analysis/src/main/resources/simplelogger.properties
@@ -0,0 +1,2 @@
+# Hide INFO logs from openloadflow
+org.slf4j.simpleLogger.log.com.powsybl.openloadflow=warn

From c108af711d8031caf639c82539c5158109475dff Mon Sep 17 00:00:00 2001
From: Samir Romdhani <samir.romdhani_externe@rte-france.com>
Date: Wed, 28 Jan 2026 13:46:20 +0100
Subject: [PATCH 2/5] improve used method name for tutorial

Signed-off-by: Samir Romdhani <samir.romdhani_externe@rte-france.com>
---
 security-analysis/README.md                         |  2 --
 .../tutorials/sa/SecurityAnalysisTutorials.java     | 13 ++++++-------
 2 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/security-analysis/README.md b/security-analysis/README.md
index 3de8e89..4d643f0 100644
--- a/security-analysis/README.md
+++ b/security-analysis/README.md
@@ -8,8 +8,6 @@ This tutorial aims to compute security analysis on a network, loading a network
 The complete tutorial is described in the [security analysis](https://powsybl.readthedocs.io/projects/powsybl-tutorials/en/latest/security-analysis.html) powsybl-tutorials documentation.
 
 # How to install the security analysis simulator
-The available security analysis implementations are described in the .
-
 In the tutorial, we use the OpenLoadFlow implementation. Please visit this page: [security analysis](https://powsybl.readthedocs.io/projects/powsybl-core/en/stable/simulation/security/implementations.html) in powsybl-core documentation for more information about it.
 
 # How to configure this tutorial
diff --git a/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java b/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
index 1dd0c0c..8d13a5b 100644
--- a/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
+++ b/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
@@ -21,7 +21,6 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-import java.io.*;
 import java.util.List;
 
 /**
@@ -35,14 +34,14 @@ private SecurityAnalysisTutorials() {
 
     public static void main(String[] args) {
         // Network and Contingency
-        log(runSecurityAnalysisUseCase1());
+        log(runSecurityAnalysisWithContingency());
         // Network, Contingency, Operator Strategies and Actions
-        log(runSecurityAnalysisUseCase2());
+        log(runSecurityAnalysisWithOperatorStrategyAndActions());
         // Network, Contingency, and Limit Reductions
-        log(runSecurityAnalysisUseCase3());
+        log(runSecurityAnalysisWithLimitReduction());
     }
 
-    public static SecurityAnalysisResult runSecurityAnalysisUseCase1() {
+    public static SecurityAnalysisResult runSecurityAnalysisWithContingency() {
         Network network = Network.read("network.xml", SecurityAnalysisTutorials.class.getResourceAsStream("/network.xiidm"));
         LOGGER.info(":: SecurityAnalysis :: network and contingency");
 
@@ -56,7 +55,7 @@ public static SecurityAnalysisResult runSecurityAnalysisUseCase1() {
         return SecurityAnalysis.run(network, List.of(contingency)).getResult();
     }
 
-    public static SecurityAnalysisResult runSecurityAnalysisUseCase2() {
+    public static SecurityAnalysisResult runSecurityAnalysisWithOperatorStrategyAndActions() {
         Network network = Network.read("network.xml", SecurityAnalysisTutorials.class.getResourceAsStream("/network.xiidm"));
         LOGGER.info(":: SecurityAnalysis :: network, contingency, operator strategies and actions");
 
@@ -90,7 +89,7 @@ public static SecurityAnalysisResult runSecurityAnalysisUseCase2() {
         return SecurityAnalysis.run(network, List.of(contingency), parameters).getResult();
     }
 
-    public static SecurityAnalysisResult runSecurityAnalysisUseCase3() {
+    public static SecurityAnalysisResult runSecurityAnalysisWithLimitReduction() {
         Network network = Network.read("network.xml", SecurityAnalysisTutorials.class.getResourceAsStream("/network.xiidm"));
         LOGGER.info(":: SecurityAnalysis :: network, contingency and limit reduction");
 

From d53ae1d23b5e3847d2e7ff137b88fb896c6782d4 Mon Sep 17 00:00:00 2001
From: Samir Romdhani <samir.romdhani_externe@rte-france.com>
Date: Wed, 28 Jan 2026 14:27:15 +0100
Subject: [PATCH 3/5] add state monitor parameter for security analysis
 tutorials

Signed-off-by: Samir Romdhani <samir.romdhani_externe@rte-france.com>
---
 docs/security-analysis.md                     | 38 ++++++++++++++-
 security-analysis/README.md                   |  1 +
 .../sa/SecurityAnalysisTutorials.java         | 47 +++++++++++++++++--
 3 files changed, 81 insertions(+), 5 deletions(-)

diff --git a/docs/security-analysis.md b/docs/security-analysis.md
index 82aff9d..58a3b88 100644
--- a/docs/security-analysis.md
+++ b/docs/security-analysis.md
@@ -17,6 +17,7 @@ Each example follows a brief and straightforward workflow, using input data that
 Network + contingency                       --> Security Analysis 
 Network + contingency + operators strategy  --> Security Analysis 
 Network + contingency + limit reduction     --> Security Analysis 
+Network + contingency + state monitor       --> Security Analysis 
 ```
 
 
@@ -27,7 +28,7 @@ Loading the network is a common step for all workflows. Then:
 1. Define a contingency and run the security analysis. 
 2. Add operator strategies and reference the associated actions. 
 3. Configure limit reduction parameters.
-
+4. Add state monitor parameters.
 
 ### Import the network from an XML IIDM file
 
@@ -156,4 +157,39 @@ Post contingency results
         Violation Value: 1008.9287882269946 MW/°
         Violation Limit: 460.0 MW/°
 Operator strategy results
+````
+
+### Create a state Monitor
+
+A state Monitor provides information about the state of elements of the network such as branch, bus and three-winding transformers
+
+As an example, we are going to add state monitor parameter, we will add branch and voltage levels ids that we want information about.
+
+```java
+
+Contingency contingency = Contingency.line("NHV1_NHV2_2");
+SecurityAnalysisRunParameters parameters = new SecurityAnalysisRunParameters();
+// State Monitor
+StateMonitor stateMonitor = new StateMonitor(new ContingencyContext(contingency.getId(), SPECIFIC),
+        Set.of("NHV1_NHV2_1"), // <= branch id
+        Set.of("VLGEN", "VLHV1", "VLHV2", "VLLOAD"), // <= Voltage Levels id
+        Set.of());
+parameters.addMonitor(stateMonitor);
+
+// Run security analysis
+SecurityAnalysis.run(network, List.of(contingency), parameters);
+```
+
+Here are the corresponding prints in the tutorial:
+````
+:: SecurityAnalysis :: network, contingency and state Monitor
+Pre contingency results
+Post contingency results
+        Contingency : NHV1_NHV2_2
+        branchResult: BranchResult{branchId='NHV1_NHV2_1', p1=610.56215354332, q1=334.0562715296571, i1=1008.9287882269946, p2=-600.9961559564288, q2=-285.3791465506596, i2=1047.8257691455576, flowTransfer=NaN}
+        busResult: BusResults{voltageLevelId='VLGEN', busId='NGEN', v=24.5, angle=2.3579552596552684}
+        busResult: BusResults{voltageLevelId='VLHV1', busId='NHV1', v=398.26472467308224, angle=0.0}
+        busResult: BusResults{voltageLevelId='VLHV2', busId='NHV2', v=366.58481145130054, angle=-7.499211315976122}
+        busResult: BusResults{voltageLevelId='VLLOAD', busId='NLOAD', v=137.74213838955504, angle=-14.464666247602445}
+Operator strategy results
 ````
\ No newline at end of file
diff --git a/security-analysis/README.md b/security-analysis/README.md
index 4d643f0..c871e2d 100644
--- a/security-analysis/README.md
+++ b/security-analysis/README.md
@@ -4,6 +4,7 @@ This tutorial aims to compute security analysis on a network, loading a network
 - [x] Make a contingency on a line and compute a security analysis.
 - [x] Add operator strategies which contains references for actions
 - [x] Add limit reduction parameters
+- [x] Add state monitor parameters
 
 The complete tutorial is described in the [security analysis](https://powsybl.readthedocs.io/projects/powsybl-tutorials/en/latest/security-analysis.html) powsybl-tutorials documentation.
 
diff --git a/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java b/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
index 8d13a5b..7f68869 100644
--- a/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
+++ b/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
@@ -16,12 +16,16 @@
 import com.powsybl.security.SecurityAnalysisRunParameters;
 import com.powsybl.security.condition.TrueCondition;
 import com.powsybl.security.limitreduction.LimitReduction;
+import com.powsybl.security.monitor.StateMonitor;
 import com.powsybl.security.strategy.ConditionalActions;
 import com.powsybl.security.strategy.OperatorStrategy;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 import java.util.List;
+import java.util.Set;
+
+import static com.powsybl.contingency.ContingencyContextType.SPECIFIC;
 
 /**
  * @author Samir Romdhani {@literal <samir.romdhani_externe at rte-france.com>}
@@ -39,6 +43,8 @@ public static void main(String[] args) {
         log(runSecurityAnalysisWithOperatorStrategyAndActions());
         // Network, Contingency, and Limit Reductions
         log(runSecurityAnalysisWithLimitReduction());
+        // Network, Contingency, and State Monitor
+        log(runSecurityAnalysisWithStateMonitor());
     }
 
     public static SecurityAnalysisResult runSecurityAnalysisWithContingency() {
@@ -109,13 +115,33 @@ public static SecurityAnalysisResult runSecurityAnalysisWithLimitReduction() {
         return SecurityAnalysis.run(network, List.of(contingency), parameters).getResult();
     }
 
+    public static SecurityAnalysisResult runSecurityAnalysisWithStateMonitor() {
+        Network network = Network.read("network.xml", SecurityAnalysisTutorials.class.getResourceAsStream("/network.xiidm"));
+        LOGGER.info(":: SecurityAnalysis :: network, contingency and state Monitor");
+        Contingency contingency = Contingency.line("NHV1_NHV2_2");
+        SecurityAnalysisRunParameters parameters = new SecurityAnalysisRunParameters();
+        StateMonitor stateMonitor = new StateMonitor(new ContingencyContext(contingency.getId(), SPECIFIC),
+                Set.of("NHV1_NHV2_1"), // <= branch id
+                Set.of("VLGEN", "VLHV1", "VLHV2", "VLLOAD"), // <= Voltage Levels id
+                Set.of());
+        parameters.addMonitor(stateMonitor);
+        return SecurityAnalysis.run(network, List.of(contingency), parameters).getResult();
+    }
+
     private static void log(SecurityAnalysisResult result) {
         LOGGER.info("\t Pre contingency results");
-        result.getPreContingencyLimitViolationsResult().getLimitViolations()
-                .forEach(value -> {
-                    LOGGER.info("\t\t Value: {} MW/°", value.getValue());
-                    LOGGER.info("\t\t Limit: {} MW/°", value.getLimit());
+        result.getPreContingencyResult().getLimitViolationsResult().getLimitViolations()
+                .forEach(limitViolation -> {
+                    LOGGER.info("\t\t Value: {} MW/°", limitViolation.getValue());
+                    LOGGER.info("\t\t Limit: {} MW/°", limitViolation.getLimit());
                 });
+        result.getPreContingencyResult().getNetworkResult().getBranchResults()
+                .forEach(branchResult -> LOGGER.info("\t\t branchResult: {}", branchResult.toString()));
+        result.getPreContingencyResult().getNetworkResult().getBusResults()
+                .forEach(busResult -> LOGGER.info("\t\t busResult: {}", busResult.toString()));
+        result.getPreContingencyResult().getNetworkResult().getThreeWindingsTransformerResults()
+                .forEach(transformerResult -> LOGGER.info("\t\t TWT Result: {}", transformerResult.toString()));
+
         LOGGER.info("\t Post contingency results");
         result.getPostContingencyResults().forEach(postContingencyResult -> {
             LOGGER.info("\t\t Contingency : {}", postContingencyResult.getContingency().getId());
@@ -124,7 +150,14 @@ private static void log(SecurityAnalysisResult result) {
                         LOGGER.info("\t\t\t Violation Value: {} MW/°", value.getValue());
                         LOGGER.info("\t\t\t Violation Limit: {} MW/°", value.getLimit());
                     });
+            postContingencyResult.getNetworkResult().getBranchResults()
+                    .forEach(branchResult -> LOGGER.info("\t\t branchResult: {}", branchResult.toString()));
+            postContingencyResult.getNetworkResult().getBusResults()
+                    .forEach(busResult -> LOGGER.info("\t\t busResult: {}", busResult.toString()));
+            postContingencyResult.getNetworkResult().getThreeWindingsTransformerResults()
+                    .forEach(transformerResult -> LOGGER.info("\t\t TWT Result: {}", transformerResult.toString()));
         });
+
         LOGGER.info("\t Operator strategy results");
         result.getOperatorStrategyResults().forEach(operatorStrategyResult -> {
             LOGGER.info("\t\t OperatorStrategy : {}", operatorStrategyResult.getOperatorStrategy().getId());
@@ -133,6 +166,12 @@ private static void log(SecurityAnalysisResult result) {
                         LOGGER.info("\t\t\t Violation Value: {} MW/°", value.getValue());
                         LOGGER.info("\t\t\t Violation Limit: {} MW/°", value.getLimit());
                     });
+            operatorStrategyResult.getNetworkResult().getBranchResults()
+                    .forEach(branchResult -> LOGGER.info("\t\t branchResult: {}", branchResult.toString()));
+            operatorStrategyResult.getNetworkResult().getBusResults()
+                    .forEach(busResult -> LOGGER.info("\t\t busResult: {}", busResult.toString()));
+            operatorStrategyResult.getNetworkResult().getThreeWindingsTransformerResults()
+                    .forEach(transformerResult -> LOGGER.info("\t\t TWT Result: {}", transformerResult.toString()));
         });
     }
 }

From 7aa15adc23cb33d66526f0ea7f496c3243fff31b Mon Sep 17 00:00:00 2001
From: Samir Romdhani <samir.romdhani_externe@rte-france.com>
Date: Fri, 30 Jan 2026 10:02:48 +0100
Subject: [PATCH 4/5] Update based on review comments

Signed-off-by: Samir Romdhani <samir.romdhani_externe@rte-france.com>
---
 docs/security-analysis.md                     | 28 ++++++-------
 security-analysis/README.md                   | 12 +++---
 .../sa/SecurityAnalysisTutorials.java         | 39 ++++++++-----------
 3 files changed, 37 insertions(+), 42 deletions(-)

diff --git a/docs/security-analysis.md b/docs/security-analysis.md
index 58a3b88..16d7ee4 100644
--- a/docs/security-analysis.md
+++ b/docs/security-analysis.md
@@ -4,12 +4,13 @@ layout: default
 
 # Write the Java code to perform security analysis
 
-In order to perform a `security analysis`, you need a `network` and at least one `contingency` (i.e. one failure) on that network,
-and possibly `operator strategies` that can take `actions` to correct a default.
+A `security analysis` is a simulation run on a `network` to check for violations. 
+To have more information about the contingencies we want to simulate and the network elements we want to monitor 
+please refer to the [Powsybl security analysis](inv:powsyblcore:*:*#simulation/security/index) documentation page.
 
-### What will you build?
+## What will you build?
 
-This tutorial presents three use cases of security analysis simulation. 
+This tutorial presents 4 use cases of security analysis simulation. 
 Each example follows a brief and straightforward workflow, using input data that includes an XIIDM file and at least one contingency.
 
 > The three workflows can be summarized as follows:
@@ -20,8 +21,7 @@ Network + contingency + limit reduction     --> Security Analysis
 Network + contingency + state monitor       --> Security Analysis 
 ```
 
-
-#### Tutorial steps
+### Tutorial steps
 
 Loading the network is a common step for all workflows. Then:
 
@@ -30,7 +30,7 @@ Loading the network is a common step for all workflows. Then:
 3. Configure limit reduction parameters.
 4. Add state monitor parameters.
 
-### Import the network from an XML IIDM file
+## Import the network from an XML IIDM file
 
 The network we use here is available in the tutorial's resources and is described in the IIDM format. 
 Start by adding the following lines in the main function of the tutorial:
@@ -48,7 +48,7 @@ The following are shown in the (Network Area Diagram) below.
 
 ![Workflow](./img/sa/nad.png){width="75%" .center-image}
 
-### Create a contingency
+## Create a contingency
 
 Before creating a contingency, make sure that contingency can actually cause a network violation.
 As an example, we will add a limit to the line `NHV1_NHV2_1` to simulate a default violation.
@@ -85,7 +85,7 @@ Post contingency results
 Operator strategy results
 ````
 
-### Create an Operator Strategy with Actions
+## Create an operator strategy with actions
 
 ```java
 LoadAction loadAction = new LoadActionBuilder()
@@ -127,9 +127,9 @@ Operator strategy results
         Violation Limit: 460.0 MW/°
 ````
 
-### Create a Limit Reduction
+### create a limit reduction
 
-Note that the reduction affect results as pre-contingency violations.
+Note that the limit reductions also affect the pre-contingency violations results.
 
 As an example, we are going to reduce the current limit of `NHV1_NHV2_1` line by 10%.
 
@@ -159,11 +159,11 @@ Post contingency results
 Operator strategy results
 ````
 
-### Create a state Monitor
+## Use state monitor
 
-A state Monitor provides information about the state of elements of the network such as branch, bus and three-winding transformers
+A `StateMonitor` provides information about the state of network elements we want to monitor such as branch, bus and three-winding transformers...
 
-As an example, we are going to add state monitor parameter, we will add branch and voltage levels ids that we want information about.
+As an example, we are going to add state monitor parameter, we will add branch and voltage levels ids that we want to monitor.
 
 ```java
 
diff --git a/security-analysis/README.md b/security-analysis/README.md
index c871e2d..2062376 100644
--- a/security-analysis/README.md
+++ b/security-analysis/README.md
@@ -1,15 +1,15 @@
 # Security Analysis tutorial
 
-This tutorial aims to compute security analysis on a network, loading a network Then:
-- [x] Make a contingency on a line and compute a security analysis.
-- [x] Add operator strategies which contains references for actions
-- [x] Add limit reduction parameters
-- [x] Add state monitor parameters
+This tutorial aims at computing security analysis on a network. After loading a network then:
+- [x] Create a contingency on a line and compute a security analysis.
+- [x] Create an operator strategy containing references to actions.
+- [x] Create a limit reduction.
+- [x] Add a state monitor to monitor elements on the network.
 
 The complete tutorial is described in the [security analysis](https://powsybl.readthedocs.io/projects/powsybl-tutorials/en/latest/security-analysis.html) powsybl-tutorials documentation.
 
 # How to install the security analysis simulator
-In the tutorial, we use the OpenLoadFlow implementation. Please visit this page: [security analysis](https://powsybl.readthedocs.io/projects/powsybl-core/en/stable/simulation/security/implementations.html) in powsybl-core documentation for more information about it.
+In the tutorial, we use the OpenLoadFlow implementation. Please visit this page: [security analysis](https://powsybl.readthedocs.io/projects/powsybl-core/en/stable/simulation/security/index.html#implementation) in powsybl-core documentation for more information about it.
 
 # How to configure this tutorial
 The configuration file is:
diff --git a/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java b/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
index 7f68869..11beb98 100644
--- a/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
+++ b/security-analysis/src/main/java/com/powsybl/tutorials/sa/SecurityAnalysisTutorials.java
@@ -37,13 +37,13 @@ private SecurityAnalysisTutorials() {
     }
 
     public static void main(String[] args) {
-        // Network and Contingency
+        // Network and contingency
         log(runSecurityAnalysisWithContingency());
-        // Network, Contingency, Operator Strategies and Actions
+        // Network, contingency, operator strategies and actions
         log(runSecurityAnalysisWithOperatorStrategyAndActions());
-        // Network, Contingency, and Limit Reductions
+        // Network, contingency and limit reduction
         log(runSecurityAnalysisWithLimitReduction());
-        // Network, Contingency, and State Monitor
+        // Network, contingency and state monitor
         log(runSecurityAnalysisWithStateMonitor());
     }
 
@@ -51,12 +51,7 @@ public static SecurityAnalysisResult runSecurityAnalysisWithContingency() {
         Network network = Network.read("network.xml", SecurityAnalysisTutorials.class.getResourceAsStream("/network.xiidm"));
         LOGGER.info(":: SecurityAnalysis :: network and contingency");
 
-        network.getLine("NHV1_NHV2_1")
-                .getOrCreateSelectedOperationalLimitsGroup1("DEFAULT")
-                .newCurrentLimits()
-                .setPermanentLimit(460).add();
-        network.getLine("NHV1_NHV2_1").setSelectedOperationalLimitsGroup1("DEFAULT");
-
+        addLimitInLine1(network);
         Contingency contingency = Contingency.line("NHV1_NHV2_2");
         return SecurityAnalysis.run(network, List.of(contingency)).getResult();
     }
@@ -65,13 +60,9 @@ public static SecurityAnalysisResult runSecurityAnalysisWithOperatorStrategyAndA
         Network network = Network.read("network.xml", SecurityAnalysisTutorials.class.getResourceAsStream("/network.xiidm"));
         LOGGER.info(":: SecurityAnalysis :: network, contingency, operator strategies and actions");
 
-        network.getLine("NHV1_NHV2_1")
-                .getOrCreateSelectedOperationalLimitsGroup1("DEFAULT")
-                .newCurrentLimits()
-                .setPermanentLimit(460).add();
-        network.getLine("NHV1_NHV2_1").setSelectedOperationalLimitsGroup1("DEFAULT");
-
+        addLimitInLine1(network);
         Contingency contingency = Contingency.line("NHV1_NHV2_2");
+
         LoadAction loadAction = new LoadActionBuilder()
                 .withId("loadActionId")
                 .withLoadId("LOAD")
@@ -99,13 +90,9 @@ public static SecurityAnalysisResult runSecurityAnalysisWithLimitReduction() {
         Network network = Network.read("network.xml", SecurityAnalysisTutorials.class.getResourceAsStream("/network.xiidm"));
         LOGGER.info(":: SecurityAnalysis :: network, contingency and limit reduction");
 
-        network.getLine("NHV1_NHV2_1")
-                .getOrCreateSelectedOperationalLimitsGroup1("DEFAULT")
-                .newCurrentLimits()
-                .setPermanentLimit(460).add();
-        network.getLine("NHV1_NHV2_1").setSelectedOperationalLimitsGroup1("DEFAULT");
-
+        addLimitInLine1(network);
         Contingency contingency = Contingency.line("NHV1_NHV2_2");
+
         SecurityAnalysisRunParameters parameters = new SecurityAnalysisRunParameters();
         LimitReduction limitReduction = LimitReduction.builder(LimitType.CURRENT, 0.9)
                 .withMonitoringOnly(false)
@@ -174,4 +161,12 @@ private static void log(SecurityAnalysisResult result) {
                     .forEach(transformerResult -> LOGGER.info("\t\t TWT Result: {}", transformerResult.toString()));
         });
     }
+
+    private static void addLimitInLine1(Network network) {
+        network.getLine("NHV1_NHV2_1")
+                .getOrCreateSelectedOperationalLimitsGroup1("DEFAULT")
+                .newCurrentLimits()
+                .setPermanentLimit(460).add();
+        network.getLine("NHV1_NHV2_1").setSelectedOperationalLimitsGroup1("DEFAULT");
+    }
 }

From 0bba4d226ab02e8627921f199f1950de8db9f1e5 Mon Sep 17 00:00:00 2001
From: Samir Romdhani <samir.romdhani_externe@rte-france.com>
Date: Fri, 30 Jan 2026 13:31:58 +0100
Subject: [PATCH 5/5] align sections based on tutorial content

Signed-off-by: Samir Romdhani <samir.romdhani_externe@rte-france.com>
---
 docs/security-analysis.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/security-analysis.md b/docs/security-analysis.md
index 16d7ee4..a7da3eb 100644
--- a/docs/security-analysis.md
+++ b/docs/security-analysis.md
@@ -21,7 +21,7 @@ Network + contingency + limit reduction     --> Security Analysis
 Network + contingency + state monitor       --> Security Analysis 
 ```
 
-### Tutorial steps
+## Tutorial steps
 
 Loading the network is a common step for all workflows. Then:
 
@@ -30,7 +30,7 @@ Loading the network is a common step for all workflows. Then:
 3. Configure limit reduction parameters.
 4. Add state monitor parameters.
 
-## Import the network from an XML IIDM file
+### Import the network from an XML IIDM file
 
 The network we use here is available in the tutorial's resources and is described in the IIDM format. 
 Start by adding the following lines in the main function of the tutorial:
@@ -48,7 +48,7 @@ The following are shown in the (Network Area Diagram) below.
 
 ![Workflow](./img/sa/nad.png){width="75%" .center-image}
 
-## Create a contingency
+### Create a contingency
 
 Before creating a contingency, make sure that contingency can actually cause a network violation.
 As an example, we will add a limit to the line `NHV1_NHV2_1` to simulate a default violation.
@@ -85,7 +85,7 @@ Post contingency results
 Operator strategy results
 ````
 
-## Create an operator strategy with actions
+### Create an operator strategy with actions
 
 ```java
 LoadAction loadAction = new LoadActionBuilder()
@@ -127,7 +127,7 @@ Operator strategy results
         Violation Limit: 460.0 MW/°
 ````
 
-### create a limit reduction
+### Create a limit reduction
 
 Note that the limit reductions also affect the pre-contingency violations results.
 
@@ -159,7 +159,7 @@ Post contingency results
 Operator strategy results
 ````
 
-## Use state monitor
+### Use state monitor
 
 A `StateMonitor` provides information about the state of network elements we want to monitor such as branch, bus and three-winding transformers...