【亲测免费】 PYPOWER 开源项目使用教程

1. 项目目录结构及介绍

PYPOWER 是一个将 MATPOWER 移植到 Python 的电力系统分析工具。以下是 PYPOWER 项目的目录结构及其主要文件的介绍：

PYPOWER/
├── AUTHORS
├── CHANGELOG.rst
├── CITATION.bib
├── LICENSE
├── MANIFEST.in
├── README.rst
├── requirements.txt
├── requirements_py27.txt
├── setup.cfg
├── setup.py
├── tox.ini
├── github/
│   └── workflows/
├── doc/
│   └── ...
├── pypower/
│   ├── api/
│   ├── casefiles/
│   ├── ext2int.py
│   ├── idx_brch.py
│   ├── idx_bus.py
│   ├── idx_gen.py
│   ├── loadcase.py
│   ├── makeBdc.py
│   ├── makeB.py
│   ├── makeSbus.py
│   ├── makeYbus.py
│   ├── newtonpf.py
│   ├── opf.py
│   ├── pfsoln.py
│   ├── rundcopf.py
│   ├── rundcpf.py
│   ├── runopf.py
│   ├── runpf.py
│   ├── runuopf.py
│   ├── scale_load.py
│   ├── t.py
│   ├── toggle_softlims.py
│   ├── totcost.py
│   └── update_mupq.py
└── tests/
    └── ...

主要目录和文件介绍：

• AUTHORS: 项目作者列表。
• CHANGELOG.rst: 项目变更日志。
• CITATION.bib: 项目引用信息。
• LICENSE: 项目许可证文件。
• MANIFEST.in: 项目打包清单文件。
• README.rst: 项目介绍和使用说明。
• requirements.txt: 项目依赖库列表。
• requirements_py27.txt: 针对 Python 2.7 的依赖库列表。
• setup.cfg: 项目安装配置文件。
• setup.py: 项目安装脚本。
• tox.ini: 项目测试配置文件。
• github/workflows/: GitHub Actions 工作流配置文件。
• doc/: 项目文档目录。
• pypower/: 项目核心代码目录，包含 API、案例文件和主要功能模块。
• tests/: 项目测试代码目录。

2. 项目启动文件介绍

PYPOWER 项目的启动文件主要是 pypower/runpf.py 和 pypower/runopf.py，分别用于执行电力系统潮流计算和最优潮流计算。

runpf.py

runpf.py 是 PYPOWER 中用于执行电力系统潮流计算的启动文件。它提供了多种潮流计算方法，包括直流潮流（DC Power Flow）和交流潮流（AC Power Flow）。

runopf.py

runopf.py 是 PYPOWER 中用于执行电力系统最优潮流计算的启动文件。它支持直流最优潮流（DC OPF）和交流最优潮流（AC OPF）。

3. 项目配置文件介绍

PYPOWER 项目的配置文件主要包括 setup.cfg 和 tox.ini。

setup.cfg

setup.cfg 是 PYPOWER 项目的安装配置文件，用于指定项目的基本信息和安装选项。它包含了项目的元数据、依赖库、安装脚本等信息。

tox.ini

tox.ini 是 PYPOWER 项目的测试配置文件，用于配置项目的测试环境和测试命令。它支持在不同的 Python 版本下运行测试，确保项目的兼容性和稳定性。

通过以上介绍，您可以更好地理解 PYPOWER 项目的结构和使用方法，从而更高效地进行电力系统分析和优化。