open-energy-transition/open-tyndp 来源：https://github.com/open-energy-transition/open-tyndp GitHub 发布（最新版本，含预发布版） 落后于 PyPSA-Eur 的提交数 测试工作流（https://github.com/open-energy-transition/open-tyndp/actions/workflows/test.yaml） 文档（https://open-tyndp.readthedocs.io/en/latest/?badge=latest） 网站（https://open-tyndp.openenergytransition.org/） Snakemake（https://snakemake.readthedocs.io） Discord（https://discord.gg/AnuJBk23FU） REUSE 状态（https://api.reuse.software/info/github.com/open-energy-transition/open-tyndp） 引用与数据： 引用 Open-TYNDP（https://doi.org/10.5281/zenodo.19372053） 引用 PyPSA-Eur（https://doi.org/10.5281/zenodo.3520874） 引用 PyPSA-Eur-Sec（https://doi.org/10.5281/zenodo.3938042） TYNDP 输入数据（https://doi.org/10.5281/zenodo.14230568） # Open-TYNDP：将开放能源系统规划与 ENTSO-E 模型对接，并为 TYNDP 贡献力量 > [!WARNING] > Open-TYNDP 正处于积极开发中，尚未实现全部功能。在使用模型前，了解当前的开发状态和一般限制非常重要。 本仓库介绍了 Open-TYNDP 研究与创新项目的开放模型数据集。该项目是 Open Energy Transition (OET)（https://openenergytransition.org/）与欧洲输电网运营商联盟（ENTSO-E）的合作成果。项目目标是通过构建基于 PyPSA-Eur（https://github.com/pypsa/pypsa-eur）的工作流程，探索并考虑在十年网络发展规划（TYNDP）中采用 PyPSA，旨在补充当前 TYNDP 周期中使用的工具，特别是在情景构建（Scenario Building，SB）和成本效益分析（Cost-Benefit Analysis，CBA）方面。该方法旨在提高透明度，降低利益相关者参与欧洲能源规划的门槛。在欧洲之外，该项目还希望展示开源（OS）框架在能源规划中的可行性，推动更广泛的全球采用。 为了建立对该新开源工具链的信任并确保其可复现性，项目首先聚焦于复现 2024 年 TYNDP 周期的关键数据，随后再与当前的 2026 年 TYNDP 周期对齐。这一过程包括在开源领域开发新功能以填补现有空白，集成用于数据互操作性和动态可视化的工具，并发布最佳实践以鼓励开放能源模型的采用。此外，项目在开发 PyPSA 工具的同时，还强调利益相关者咨询和互动研讨会（https://open-energy-transition.github.io/open-tyndp-workshops/intro.html），进一步促进整个过程的协作与透明度。 本仓库是 OET/PyPSA-Eur（https://github.com/open-energy-transition/pypsa-eur）的软分叉，包含由 OET 支持的整个 Open-TYNDP 项目，包括代码和文档。本仓库的理念是不包含任何中间结果，所有结果均由原始数据和代码计算得出。本仓库采用 OET 的软分叉策略（https://open-energy-transition.github.io/handbook/docs/Engineering/SoftForkStrategy）进行维护。OET 的首要目标是尽可能向上游开源仓库贡献代码。对于无法直接合并到上游的长期更改，该策略会组织并维护 OET 的分叉，确保它们定期与上游保持同步和兼容，同时支持未来向开源仓库的后续贡献。 # 开发状态 警告：Open-TYNDP 正处于积极开发中，尚未实现全部功能。在使用模型前，了解当前的开发状态和一般限制非常重要。 该模型包含 TYNDP 2024 周期的部分数据，验证工作仍在进行。GitHub 仓库的问题（https://github.com/open-energy-transition/open-tyndp/issues）收集了我们正在处理的已知主题（欢迎提供帮助或提出建议）。该项目依赖软分叉策略，这意味着上游问题（https://github.com/PyPSA/PyPSA-Eur/issues）需要在 PyPSA-Eur 仓库中解决。文档（https://open-tyndp.readthedocs.io/）也仍在完善中。 # 仓库结构 * benchmarks：将存储 snakemake 基准测试（初始不存在） * config：研究中使用的配置 * cutouts：将存储来自 atlite 的原始天气数据切片（初始不存在） * data：包含不由任何 snakemake 规则生成的输入数据 * doc：包含构建 PyPSA-Eur 的 readthedocs 文档所需的所有文件 * envs：包含备用 conda 环境，以防 pixi 安装不成功 * logs：将存储日志文件（初始不存在） * notebooks：包含用于临时分析的所有 notebooks * report：包含构建报告所需的所有文件；图表和结果文件自动生成 * rules：包含加载在 Snakefile 中的所有 snakemake 规则 * resources：将存储工作流的中间结果，这些结果可被后续规则再次使用（初始不存在） * results：将存储求解后的 PyPSA 网络数据、汇总文件和图表（初始不存在） * scripts：包含由 snakemake 规则执行的所有 Python 脚本，用于构建模型 # 安装与使用 ## 1. 安装 ### 选项 A：Windows 安装程序（推荐用于 Windows） 对于 Windows 用户，请从发布页面（https://github.com/open-energy-transition/open-tyndp/releases）下载最新的安装程序（例如 open-tyndp-0.4.0-pixi-Windows-x86_64.exe）并运行。安装程序会自动设置您所需的一切，包括 pixi、仓库和 conda 环境。详情请参见 utils/windows-installer/README.md。 ### 选项 B：手动安装（所有平台） 克隆仓库： sh git clone https://github.com/open-energy-transition/open-tyndp PyPSA-Eur 以及 Open-TYNDP 依赖于一组其他 Python 包才能运行。我们使用 pixi（https://pixi.sh/latest/）来管理这些依赖。安装 pixi 后，您可以为您操作系统激活项目环境，并从命令行访问所有 PyPSA-Eur 依赖项： sh pixi shell -e open-tyndp >[!NOTE] >pixi 会在每个项目目录中创建一个独立的环境，即使您在本地克隆了项目的相同副本。由于存在通用的系统级包缓存，pixi 在这种情况下能有效节约磁盘空间。 >[!TIP] >如果 pixi 无法正常工作，您可以尝试从 envs 中的备用 conda 环境文件进行安装。更多详情请参阅 PyPSA-Eur 安装指南（https://pypsa-eur.readthedocs.io/en/latest/installation.html）。 ## 2. 运行分析 要运行所有情景构建的分析步骤以复现结果并生成报告，您可以执行： sh pixi run tyndp-sb 要列出所有需要执行的规则（空运行），请运行： sh pixi run tyndp-sb -n 类似地，要运行成本效益分析的所有步骤，您可以执行： sh pixi run tyndp-cba 并追加 -n 进行相应的空运行： sh pixi run tyndp-cba -n >[!TIP] >可以通过专用的 pixi 任务构建依赖关系图，并保存到 resources/ 目录。由于完整场景列表可能非常庞大，您可以将其限制为单个场景： > >sh >pixi run create-tyndp-graphs --config 'run={"name":"NT"}' > # 贡献与支持 我们热烈欢迎任何有兴趣为此项目做出贡献的人。如果您有任何想法、建议或遇到问题，欢迎在 GitHub 上提交 issue 或发起 pull request。 - 要与其他 PyPSA 用户讨论、组织项目、分享新闻并与社区联系，您可以使用 Discord 服务器（https://discord.gg/AnuJBk23FU）。Open-TYNDP 在项目专用频道 pypsa-open-tyndp（https://discord.com/channels/911692131440148490/1414977512089321564）中进行讨论。 - 对于错误和功能请求，请提交一个新的 issue（https://github.com/open-energy-transition/open-tyndp/issues/new/choose）。我们提供了面向社区成员报告错误或请求功能的模板，如果您熟悉的话，也欢迎使用更详细的维护者模板。Open-TYNDP 团队会在新 issue 提交后不久进行审查。Open-TYNDP 特有 issue 应提交到 Open-TYNDP Issues 页面（https://github.com/open-energy-transition/open-tyndp/issues），而 PyPSA-Eur 的 issue 应提交到 PyPSA-Eur GitHub Issues 页面（https://github.com/PyPSA/pypsa-eur/issues）。 # 联系方式 如果您对 Open-TYNDP 有任何疑问或其他问题，请通过 pypsa-open-tyndp（https://discord.com/channels/911692131440148490/1414977512089321564）频道或 [email protected] 联系。订阅项目新闻通讯（https://openenergytransitionnewsletter.eo.page/tyndp-oet）获取更新！ # 引用 如果您想引用特定版本的 Open-TYNDP，自 v0.5 起，每个版本都会在 Zenodo 上存档并附带版本特定的 DOI：DOI（https://doi.org/10.5281/zenodo.19372053） v0.5 和 v0.5.1 版本存档于 10.5281/zenodo.18494362（https://doi.org/10.5281/zenodo.18494362）。 如果您在研究中使用了 Open-TYNDP，请按照 Zenodo 上的说明进行引用，或使用 Open-TYNDP（https://github.com/open-energy-transition/open-tyndp）侧边栏中的“Cite this repository”按钮。 本工作建立在 PyPSA-Eur（https://github.com/pypsa/pypsa-eur）的基础上，并遵循 ENTSO-E 和 ENTSOG 的 TYNDP 2024 情景方法论报告（https://2024.entsos-tyndp-scenarios.eu/scenarios-methodology-report/）中描述的方法。 # 许可证 Open-TYNDP 是 PyPSA-Eur 的软分叉，采用类似的许可策略。与 PyPSA-Eur 一样，Open-TYNDP 中的代码根据 MIT 许可证（https://opensource.org/licenses/MIT）以自由软件形式发布。有关归属和许可策略的详细信息，请参见“许可证”（https://open-tyndp.readthedocs.io/en/latest/licenses.html）。此外，不同的输入数据可能适用不同的许可证和使用条款，请参见“数据来源”（https://open-tyndp.readthedocs.io/en/latest/data_sources.html）。