From ff9bf7b916e6eb28920dca4eebef1ea976060087 Mon Sep 17 00:00:00 2001 From: lisrte Date: Wed, 20 Nov 2024 17:15:35 +0100 Subject: [PATCH 1/3] Replace Dynawaltz with Dynawo Update link to powsybl-dynawo and reference to DLS/ mapping. Add documentation for itools command list-dynamic-simulation-models Signed-off-by: lisrte --- docs/simulation/dynamic/configuration.md | 2 +- docs/simulation/dynamic/index.md | 15 +++++----- .../dynamic_security/configuration.md | 2 +- docs/simulation/dynamic_security/index.md | 1 + docs/user/itools/dynamic-security-analysis.md | 3 ++ docs/user/itools/dynamic-simulation.md | 4 +-- docs/user/itools/index.md | 3 +- .../itools/list-dynamic-simulation-models.md | 29 +++++++++++++++++++ 8 files changed, 47 insertions(+), 12 deletions(-) create mode 100644 docs/user/itools/list-dynamic-simulation-models.md diff --git a/docs/simulation/dynamic/configuration.md b/docs/simulation/dynamic/configuration.md index c696f4be8eb..7c132033eb0 100644 --- a/docs/simulation/dynamic/configuration.md +++ b/docs/simulation/dynamic/configuration.md @@ -3,7 +3,7 @@ ## Implementation If you have several implementations in your classpath, you need to choose which implementation to use in your configuration file with the `default-impl-name` property. Each implementation is identified by its name, that may be unique in the classpath: -- use "DynaWaltz" to use powsybl-dynawo implementation +- use "Dynawo" to use powsybl-dynawo implementation **YAML configuration:** ```yaml diff --git a/docs/simulation/dynamic/index.md b/docs/simulation/dynamic/index.md index c3c6b963ad8..e32725ea57a 100644 --- a/docs/simulation/dynamic/index.md +++ b/docs/simulation/dynamic/index.md @@ -24,18 +24,18 @@ The inputs of a dynamic simulation are the following: (dynamic-models-mapping)= ### Dynamic models mapping -For the moment, the only way to associate dynamic models to static components is through a groovy script. Note that the syntax of this script is specific to each simulator: -- [Dynawo dynamic model DSL](inv:powsybldynawo:*:*#dynamic_simulation/dynamic-models-dsl) +Powsybl core implements dynamic models mapping through a groovy script. Note that the syntax of this script is specific to each simulator. +See [Dynawo dynamic model mapping](inv:powsybldynawo:*:*#dynamic_simulation/dynamic-models-mapping) for Dynawo specific DSL and others mapping methods. (event-models-mapping)= ### Event models mapping -For the moment, the only way to add events to the simulation is through a groovy script. Note that the syntax of this script is specific to each simulator: -- [Dynawo event model DSL](inv:powsybldynawo:*:*#dynamic_simulation/event-models-dsl) +Powsybl core implements event models mapping through a groovy script. Note that the syntax of this script is specific to each simulator. +See [Dynawo event model DSL](inv:powsybldynawo:*:*#dynamic_simulation/event-models-mapping) for Dynawo specific DSL and others mapping methods. (output-variables-configuration)= ### Output variables configuration -For the moment, the only way to add output variables configuration is to provide a groovy script to the simulation. Note that the syntax of this script is specific to each simulator: -- [Dynawo output variables DSL](inv:powsybldynawo:*:*#dynamic_simulation/output-variables-dsl) +Powsybl core implements output variables configuration mapping through a groovy script. Note that the syntax of this script is specific to each simulator. +See [Dynawo output variables DSL](inv:powsybldynawo:*:*#dynamic_simulation/output-variables-mapping) for Dynawo specific DSL and others mapping methods. ## Outputs @@ -52,4 +52,5 @@ The outputs of a dynamic simulation are: For the moment, the only available implementation is provided by powsybl-dynawo, which links PowSyBl with [Dynaωo](http://dynawo.org) open source suite. ## Going further -- [Run a dynamic simulation through an iTools command](../../user/itools/dynamic-simulation.md): Learn how to perform a dynamic simulation from the command line \ No newline at end of file +- [Run a dynamic simulation through an iTools command](../../user/itools/dynamic-simulation.md): Learn how to perform a dynamic simulation from the command line +- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): Learn how to load a list of all dynamic simulation models from the command line \ No newline at end of file diff --git a/docs/simulation/dynamic_security/configuration.md b/docs/simulation/dynamic_security/configuration.md index 63485b1f80a..9fc66674b62 100644 --- a/docs/simulation/dynamic_security/configuration.md +++ b/docs/simulation/dynamic_security/configuration.md @@ -3,7 +3,7 @@ ## Implementation If you have several implementations in your classpath, you need to choose which implementation to use in your configuration file with the `default-impl-name` property. Each implementation is identified by its name, that may be unique in the classpath: -- use "DynaWaltz" to use powsybl-dynawo implementation +- use "Dynawo" to use powsybl-dynawo implementation **YAML configuration:** ```yaml diff --git a/docs/simulation/dynamic_security/index.md b/docs/simulation/dynamic_security/index.md index 3db2a273947..1ae7881d304 100644 --- a/docs/simulation/dynamic_security/index.md +++ b/docs/simulation/dynamic_security/index.md @@ -25,3 +25,4 @@ For the moment, the only available implementation is provided by powsybl-dynawo, - Security analysis [Action DSL](../security/action-dsl.md). - Security analysis [Contingency DSL](../security/action-dsl.md). - [Run a dynamic security analysis through an iTools command](../../user/itools/dynamic-security-analysis.md): Learn how to perform a security analysis from the command line. +- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): Learn how to load a list of all dynamic simulation models from the command line. \ No newline at end of file diff --git a/docs/user/itools/dynamic-security-analysis.md b/docs/user/itools/dynamic-security-analysis.md index afd22662d73..10ed443be69 100644 --- a/docs/user/itools/dynamic-security-analysis.md +++ b/docs/user/itools/dynamic-security-analysis.md @@ -95,3 +95,6 @@ This option defines the list of extensions to complete the simulation results wi ### with-extensions Use the `--with-extensions` parameter to activate a list of `com.powsybl.security.interceptors.SecurityAnalysisInterceptor` implementations. + +## See also +- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): Learn how to load a list of all dynamic simulation models from the command line. \ No newline at end of file diff --git a/docs/user/itools/dynamic-simulation.md b/docs/user/itools/dynamic-simulation.md index a754af94be7..cbead60e091 100644 --- a/docs/user/itools/dynamic-simulation.md +++ b/docs/user/itools/dynamic-simulation.md @@ -64,11 +64,10 @@ This option defines the path where to export the [results](#results) of the simu This option defines the path of the [parameters](#parameters) file of the simulation. If this option is not used, the simulation is run with the default parameters. ## Simulators - The available power flow simulators implementations are described [here](../../simulation/dynamic/index.md#implementations). ## Parameters -The available parameters are described [here](../../simulation/dynamic/parameters.md). +The available parameters are described [here](../../simulation/dynamic/configuration.md). ## Results The expected results are described in the [time domain documentation](../../simulation/dynamic/index.md#outputs) @@ -98,3 +97,4 @@ dynamic simulation results: ``` ## See also +- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): Learn how to load a list of all dynamic simulation models from the command line. \ No newline at end of file diff --git a/docs/user/itools/index.md b/docs/user/itools/index.md index 66bcd08f681..a5aec09dfb4 100644 --- a/docs/user/itools/index.md +++ b/docs/user/itools/index.md @@ -9,12 +9,13 @@ action-simulator.md cim_anonymizer.md compare-security-analysis-results.md convert_network.md +dynamic-security-analysis.md dynamic-simulation.md +list-dynamic-simulation-models.md loadflow.md loadflow-validation.md run-script.md security-analysis.md -dynamic-security-analysis.md sensitivity-computation.md ``` diff --git a/docs/user/itools/list-dynamic-simulation-models.md b/docs/user/itools/list-dynamic-simulation-models.md new file mode 100644 index 00000000000..456ecdc05b2 --- /dev/null +++ b/docs/user/itools/list-dynamic-simulation-models.md @@ -0,0 +1,29 @@ +# iTools list-dynamic-simulation-models + +The `list-dynamic-simulation-models` command list all models used by the [time domain](../../simulation/dynamic/index.md) simulation for a given provider. + +## Usage +``` +usage: itools [OPTIONS] list-dynamic-simulation-models [--dynamic-models] + [--event-models] [--help] + +Available options are: + --config-name Override configuration file name + +Available arguments are: + --dynamic-models display implemented dynamic models + --event-models display implemented event models + --help display the help and quit + +``` + +### Optional options + +`--dynamic-models` +This option allows to display dynamic models only. (by default all models will be displayed) + +`--event-models` +This option allows to display event models only. (by default all models will be displayed) + +## See also +- [Run a dynamic simulation through an iTools command](../../user/itools/dynamic-simulation.md): Learn how to perform a dynamic simulation from the command line. \ No newline at end of file From 396429d65bd3d9e7e6dac4a7a5fe52cd5ac1ed09 Mon Sep 17 00:00:00 2001 From: lisrte Date: Wed, 4 Dec 2024 16:34:03 +0100 Subject: [PATCH 2/3] Review fix Signed-off-by: lisrte --- docs/simulation/dynamic/index.md | 10 +++++----- docs/user/itools/dynamic-security-analysis.md | 2 +- docs/user/itools/dynamic-simulation.md | 2 +- docs/user/itools/list-dynamic-simulation-models.md | 11 +++++------ 4 files changed, 12 insertions(+), 13 deletions(-) diff --git a/docs/simulation/dynamic/index.md b/docs/simulation/dynamic/index.md index e32725ea57a..6dbc1ba5cc9 100644 --- a/docs/simulation/dynamic/index.md +++ b/docs/simulation/dynamic/index.md @@ -24,17 +24,17 @@ The inputs of a dynamic simulation are the following: (dynamic-models-mapping)= ### Dynamic models mapping -Powsybl core implements dynamic models mapping through a groovy script. Note that the syntax of this script is specific to each simulator. +The dynamic models may be provided through a groovy script thanks to the `GroovyDynamicModelsSupplier` provided in powsybl-dynamic-simulation-dsl artifact. Note that the syntax of this groovy script is specific to each simulator. See [Dynawo dynamic model mapping](inv:powsybldynawo:*:*#dynamic_simulation/dynamic-models-mapping) for Dynawo specific DSL and others mapping methods. (event-models-mapping)= ### Event models mapping -Powsybl core implements event models mapping through a groovy script. Note that the syntax of this script is specific to each simulator. +The event models may be provided through a groovy script thanks to the `GroovyEventModelsSupplier` provided in powsybl-dynamic-simulation-dsl artifact. Note that the syntax of this groovy script is specific to each simulator. See [Dynawo event model DSL](inv:powsybldynawo:*:*#dynamic_simulation/event-models-mapping) for Dynawo specific DSL and others mapping methods. (output-variables-configuration)= ### Output variables configuration -Powsybl core implements output variables configuration mapping through a groovy script. Note that the syntax of this script is specific to each simulator. +The output variables configuration may be provided through a groovy script thanks to the `GroovyOutputVariablesSupplier` provided in powsybl-dynamic-simulation-dsl artifact. Note that the syntax of this groovy script is specific to each simulator. See [Dynawo output variables DSL](inv:powsybldynawo:*:*#dynamic_simulation/output-variables-mapping) for Dynawo specific DSL and others mapping methods. ## Outputs @@ -52,5 +52,5 @@ The outputs of a dynamic simulation are: For the moment, the only available implementation is provided by powsybl-dynawo, which links PowSyBl with [Dynaωo](http://dynawo.org) open source suite. ## Going further -- [Run a dynamic simulation through an iTools command](../../user/itools/dynamic-simulation.md): Learn how to perform a dynamic simulation from the command line -- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): Learn how to load a list of all dynamic simulation models from the command line \ No newline at end of file +- [Run a dynamic simulation through an iTools command](../../user/itools/dynamic-simulation.md): learn how to perform a dynamic simulation from the command line +- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): learn how to load a list of all dynamic simulation models from the command line diff --git a/docs/user/itools/dynamic-security-analysis.md b/docs/user/itools/dynamic-security-analysis.md index 10ed443be69..cc0e8d5ac0f 100644 --- a/docs/user/itools/dynamic-security-analysis.md +++ b/docs/user/itools/dynamic-security-analysis.md @@ -97,4 +97,4 @@ Use the `--with-extensions` parameter to activate a list of `com.powsybl.securit implementations. ## See also -- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): Learn how to load a list of all dynamic simulation models from the command line. \ No newline at end of file +- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): learn how to load a list of all dynamic simulation models from the command line. diff --git a/docs/user/itools/dynamic-simulation.md b/docs/user/itools/dynamic-simulation.md index cbead60e091..a2f16355641 100644 --- a/docs/user/itools/dynamic-simulation.md +++ b/docs/user/itools/dynamic-simulation.md @@ -97,4 +97,4 @@ dynamic simulation results: ``` ## See also -- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): Learn how to load a list of all dynamic simulation models from the command line. \ No newline at end of file +- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): learn how to load a list of all dynamic simulation models from the command line. diff --git a/docs/user/itools/list-dynamic-simulation-models.md b/docs/user/itools/list-dynamic-simulation-models.md index 456ecdc05b2..cc8593b81fa 100644 --- a/docs/user/itools/list-dynamic-simulation-models.md +++ b/docs/user/itools/list-dynamic-simulation-models.md @@ -1,6 +1,6 @@ # iTools list-dynamic-simulation-models -The `list-dynamic-simulation-models` command list all models used by the [time domain](../../simulation/dynamic/index.md) simulation for a given provider. +The `list-dynamic-simulation-models` command lists all models used by the [time domain](../../simulation/dynamic/index.md) simulation for a given provider. ## Usage ``` @@ -19,11 +19,10 @@ Available arguments are: ### Optional options -`--dynamic-models` -This option allows to display dynamic models only. (by default all models will be displayed) +By default, all models are displayed, but you can use one of the following options to display specific models: +- `--dynamic-models`: allows to display dynamic models only. -`--event-models` -This option allows to display event models only. (by default all models will be displayed) +- `--event-models`: allows to display event models only. ## See also -- [Run a dynamic simulation through an iTools command](../../user/itools/dynamic-simulation.md): Learn how to perform a dynamic simulation from the command line. \ No newline at end of file +- [Run a dynamic simulation through an iTools command](../../user/itools/dynamic-simulation.md): learn how to perform a dynamic simulation from the command line. From 110129ca11f9bff59f8590a26ace4bdf93864c24 Mon Sep 17 00:00:00 2001 From: Florian Dupuy <66690739+flo-dup@users.noreply.github.com> Date: Fri, 6 Dec 2024 09:25:11 +0100 Subject: [PATCH 3/3] Apply suggestions from code review Co-authored-by: Sophie Frasnedo <93923177+So-Fras@users.noreply.github.com> Signed-off-by: Florian Dupuy <66690739+flo-dup@users.noreply.github.com> --- docs/simulation/dynamic/configuration.md | 2 +- docs/simulation/dynamic_security/configuration.md | 2 +- docs/simulation/dynamic_security/index.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/simulation/dynamic/configuration.md b/docs/simulation/dynamic/configuration.md index 7c132033eb0..65673895861 100644 --- a/docs/simulation/dynamic/configuration.md +++ b/docs/simulation/dynamic/configuration.md @@ -3,7 +3,7 @@ ## Implementation If you have several implementations in your classpath, you need to choose which implementation to use in your configuration file with the `default-impl-name` property. Each implementation is identified by its name, that may be unique in the classpath: -- use "Dynawo" to use powsybl-dynawo implementation +- Use "Dynawo" to use powsybl-dynawo implementation **YAML configuration:** ```yaml diff --git a/docs/simulation/dynamic_security/configuration.md b/docs/simulation/dynamic_security/configuration.md index 9fc66674b62..85945cd352f 100644 --- a/docs/simulation/dynamic_security/configuration.md +++ b/docs/simulation/dynamic_security/configuration.md @@ -3,7 +3,7 @@ ## Implementation If you have several implementations in your classpath, you need to choose which implementation to use in your configuration file with the `default-impl-name` property. Each implementation is identified by its name, that may be unique in the classpath: -- use "Dynawo" to use powsybl-dynawo implementation +- Use "Dynawo" to use powsybl-dynawo implementation **YAML configuration:** ```yaml diff --git a/docs/simulation/dynamic_security/index.md b/docs/simulation/dynamic_security/index.md index 1ae7881d304..22221043c05 100644 --- a/docs/simulation/dynamic_security/index.md +++ b/docs/simulation/dynamic_security/index.md @@ -25,4 +25,4 @@ For the moment, the only available implementation is provided by powsybl-dynawo, - Security analysis [Action DSL](../security/action-dsl.md). - Security analysis [Contingency DSL](../security/action-dsl.md). - [Run a dynamic security analysis through an iTools command](../../user/itools/dynamic-security-analysis.md): Learn how to perform a security analysis from the command line. -- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): Learn how to load a list of all dynamic simulation models from the command line. \ No newline at end of file +- [List dynamic simulation models with an iTools command](../../user/itools/list-dynamic-simulation-models.md): learn how to load a list of all dynamic simulation models from the command line. \ No newline at end of file