PowSyBl Core 项目教程

1. 项目的目录结构及介绍

PowSyBl Core 项目的目录结构如下：

powsybl-core/
├── ampl-converter/
├── ampl-executor/
├── cgmes/
├── cim-anonymiser/
├── commons-test/
├── commons/
├── computation-local-test/
├── computation-local/
├── computation/
├── config-classic/
├── config-test/
├── contingency/
├── distribution-core/
├── docs/
├── dsl/
├── dynamic-security-analysis/
├── dynamic-simulation/
├── entsoe-util/
├── ieee-cdf/
├── iidm/
├── itools-packager/
├── loadflow/
├── math/
├── matpower/
├── powerfactory/
├── psse/
├── scripting-test/
├── scripting/
├── security-analysis/
├── sensitivity-analysis-api/
├── shortcircuit-api/
├── time-series/
├── tools-test/
├── tools/
├── triple-store/
├── ucte/
├── gitattributes
├── gitignore
├── LICENSE.txt
├── README.md
├── install.sh
├── mvnw
├── mvnw.cmd
├── pom.xml

目录结构介绍

• ampl-converter/ 和 ampl-executor/：与 AMPL 相关的转换和执行模块。
• cgmes/ 和 cim-anonymiser/：与 CGMES 和 CIM 相关的模块。
• commons-test/ 和 commons/：通用测试和通用模块。
• computation-local-test/ 和 computation-local/：本地计算相关的测试和模块。
• computation/：计算相关的模块。
• config-classic/ 和 config-test/：经典配置和配置测试模块。
• contingency/：与电网事故相关的模块。
• distribution-core/：分布式核心模块。
• docs/：项目文档。
• dsl/：领域特定语言模块。
• dynamic-security-analysis/ 和 dynamic-simulation/：动态安全分析和动态仿真模块。
• entsoe-util/：与 ENTSO-E 相关的实用工具。
• ieee-cdf/：与 IEEE CDF 格式相关的模块。
• iidm/：与 IIDM 模型相关的模块。
• itools-packager/：iTools 打包器。
• loadflow/：潮流计算模块。
• math/：数学计算模块。
• matpower/：与 Matpower 相关的模块。
• powerfactory/：与 PowerFactory 相关的模块。
• psse/：与 PSS/E 相关的模块。
• scripting-test/ 和 scripting/：脚本测试和脚本模块。
• security-analysis/：安全分析模块。
• sensitivity-analysis-api/ 和 shortcircuit-api/：灵敏度分析和短路分析 API。
• time-series/：时间序列模块。
• tools-test/ 和 tools/：工具测试和工具模块。
• triple-store/：三重存储模块。
• ucte/：与 UCTE 相关的模块。
• gitattributes 和 gitignore：Git 配置文件。
• LICENSE.txt：项目许可证。
• README.md：项目介绍和使用说明。
• install.sh：安装脚本。
• mvnw 和 mvnw.cmd：Maven 包装器脚本。
• pom.xml：Maven 项目配置文件。

2. 项目的启动文件介绍

PowSyBl Core 项目的启动文件主要是 install.sh 脚本。该脚本用于编译和安装项目，生成 iTools 分布。

install.sh 脚本介绍

• 功能：编译项目代码并生成 iTools 分布，安装到指定目录。
• 使用方法：

  ./install.sh
  

• 选项：
  • --help：显示帮助信息。
  • --prefix：设置安装目录，默认是 $HOME/powsybl。
  • --mvn：设置 Maven 命令，默认是 mvn。

3. 项目的配置文件介绍

PowSyBl Core 项目的主要配置文件是 pom.xml 和 install.cfg。

pom.xml

• 功能：Maven 项目配置文件，定义了项目的依赖、插件、构建配置等。
• 主要内容：
  • 依赖管理：定义了项目所需的各种依赖库。
  • 插件配置：配置了 Maven 插件，用于编译、测试、打包等。
  • 构建配置：定义了项目的构建流程和目标。

install.cfg

• 功能：安装脚本的配置文件，保存了 install.sh 脚本的全局选项。
• 主要内容：
  • powsybl_prefix：安装目录，默认是 $HOME/powsybl。
  • powsybl_mvn：Maven 命令，默认是 mvn。

通过这些配置文件，用户可以自定义项目的构建和安装过程，以适应不同的开发和部署环境。