Upload 781 files

.gitattributes

@@ -33,3 +33,27 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/ac_dc_meshed.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/carbon_management-energy_balance-area_plot-AC-bus_carrier.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/carbon_management-energy_balance-area_plot.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/elec_s_256_lv1.09_Co2L-3H.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/lmp_and_line-loading.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/load-distribution.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/pypsa-animation.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/reactive-power.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/scigrid-curtailment.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/stacked-gen_and_storage-scigrid.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/stacked-gen.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/images/storage-scigrid.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/logo/logo-primary-dark.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/logo/logo-primary-light-white-bg.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/logo/logo-primary-light.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/logo/logo-secondary-dark.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/logo/logo-secondary-light.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/logo/logo-white-bg.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/docs/assets/logo/logo.png filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/examples/networks/ac-dc-meshed/ac-dc-meshed.nc filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/examples/networks/model-energy/model-energy.nc filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/examples/networks/scigrid-de/scigrid-de.nc filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/examples/networks/stochastic-network/stochastic-network.nc filter=lfs diff=lfs merge=lfs -text
+PyPSA/source/examples/networks/storage-hvdc/storage-hvdc.nc filter=lfs diff=lfs merge=lfs -text

PyPSA/mcp_output/README_MCP.md

@@ -0,0 +1,77 @@
+# MCP Plugin README
+
+## Project Overview
+
+The MCP Plugin is a component of the PyPSA (Python for Power System Analysis) ecosystem, designed to enhance the capabilities of power system modeling and analysis. PyPSA is an open-source toolbox for simulating and optimizing modern power systems over multiple periods. The MCP Plugin extends these functionalities by providing additional tools and features for more detailed and specific analyses.
+
+### Key Features
+
+- **Advanced Power System Modeling**: Leverage the robust PyPSA framework for detailed power system simulations.
+- **Optimization Capabilities**: Perform complex optimization tasks to improve system efficiency and reliability.
+- **Extensible and Customizable**: Easily integrate with existing PyPSA setups and customize according to specific project needs.
+
+## Installation Instructions
+
+To install the MCP Plugin, ensure you have Python installed on your system. The plugin requires Python 3.7 or later. Follow these steps to install:
+
+1. **Clone the Repository**:
+   ```bash
+   git clone https://github.com/PyPSA/PyPSA.git
+   cd PyPSA
+   ```
+
+2. **Install Dependencies**:
+   The MCP Plugin requires several Python packages. You can install them using `pip`:
+   ```bash
+   pip install numpy pandas matplotlib
+   ```
+
+   Optional dependencies for enhanced functionalities include:
+   ```bash
+   pip install geopandas plotly
+   ```
+
+3. **Install the Plugin**:
+   Navigate to the plugin directory and install it:
+   ```bash
+   pip install .
+   ```
+
+## Usage Methods
+
+Once installed, the MCP Plugin can be used within the PyPSA framework to perform various analyses. Here’s a basic usage example:
+
+1. **Import the Plugin**:
+   ```python
+   import pypsa
+   ```
+
+2. **Create a Network**:
+   ```python
+   network = pypsa.Network()
+   ```
+
+3. **Add Components and Perform Analysis**:
+   Use the plugin’s extended functionalities to add components and perform analyses on the network.
+
+## Available Tool Endpoints
+
+The MCP Plugin provides several endpoints for interacting with the power system models:
+
+- **Network Optimization**: Optimize network configurations for efficiency.
+- **Power Flow Analysis**: Conduct detailed power flow studies.
+- **Statistical Analysis**: Perform statistical evaluations of network performance.
+
+## Notes and Troubleshooting
+
+- **Compatibility**: Ensure that your Python environment is compatible with the required dependencies.
+- **Performance**: For large-scale simulations, consider optimizing your system resources.
+- **Common Issues**:
+  - **Installation Errors**: Ensure all dependencies are correctly installed.
+  - **Runtime Errors**: Check for compatibility issues with other installed packages.
+
+For further assistance, refer to the [PyPSA documentation](https://pypsa.org/doc/) or reach out to the community via the [PyPSA GitHub repository](https://github.com/PyPSA/PyPSA).
+
+## Conclusion
+
+The MCP Plugin is a powerful extension to the PyPSA framework, offering advanced tools for power system analysis and optimization. By following the installation and usage instructions, users can effectively integrate and utilize the plugin for their specific needs. For any issues or contributions, please refer to the official PyPSA repository.

PyPSA/mcp_output/analysis.json

@@ -0,0 +1,982 @@
+{
+  "summary": {
+    "repository_url": "https://github.com/PyPSA/PyPSA",
+    "summary": "Imported via zip fallback, file count: 280",
+    "file_tree": {
+      ".github/ISSUE_TEMPLATE/bug_report.yaml": {
+        "size": 1876
+      },
+      ".github/ISSUE_TEMPLATE/config.yml": {
+        "size": 248
+      },
+      ".github/ISSUE_TEMPLATE/documentation_improvement.yaml": {
+        "size": 747
+      },
+      ".github/ISSUE_TEMPLATE/feature_request.md": {
+        "size": 480
+      },
+      ".github/dependabot.yml": {
+        "size": 536
+      },
+      ".github/pull_request_template.md": {
+        "size": 449
+      },
+      ".github/workflows/codeql.yml": {
+        "size": 4362
+      },
+      ".github/workflows/release.yml": {
+        "size": 5532
+      },
+      ".github/workflows/test-models.yml": {
+        "size": 5584
+      },
+      ".github/workflows/test.yml": {
+        "size": 5866
+      },
+      ".pre-commit-config.yaml": {
+        "size": 1494
+      },
+      ".readthedocs.yml": {
+        "size": 699
+      },
+      "CONTRIBUTING.md": {
+        "size": 430
+      },
+      "LICENSES/CC-BY-4.0.txt": {
+        "size": 16983
+      },
+      "LICENSES/MIT.txt": {
+        "size": 1078
+      },
+      "README.md": {
+        "size": 9772
+      },
+      "REUSE.toml": {
+        "size": 1508
+      },
+      "codecov.yml": {
+        "size": 210
+      },
+      "docs/CODE_OF_CONDUCT.md": {
+        "size": 5811
+      },
+      "docs/api/components/common.md": {
+        "size": 117
+      },
+      "docs/api/components/components.md": {
+        "size": 507
+      },
+      "docs/api/components/types/buses.md": {
+        "size": 116
+      },
+      "docs/api/components/types/carriers.md": {
+        "size": 119
+      },
+      "docs/api/components/types/generators.md": {
+        "size": 121
+      },
+      "docs/api/components/types/global-constraints.md": {
+        "size": 128
+      },
+      "docs/api/components/types/lines.md": {
+        "size": 224
+      },
+      "docs/api/components/types/links.md": {
+        "size": 116
+      },
+      "docs/api/components/types/loads.md": {
+        "size": 116
+      },
+      "docs/api/components/types/shapes.md": {
+        "size": 117
+      },
+      "docs/api/components/types/shunt-impedances.md": {
+        "size": 126
+      },
+      "docs/api/components/types/storage-units.md": {
+        "size": 123
+      },
+      "docs/api/components/types/stores.md": {
+        "size": 117
+      },
+      "docs/api/components/types/sub-networks.md": {
+        "size": 122
+      },
+      "docs/api/components/types/transformers.md": {
+        "size": 238
+      },
+      "docs/api/networks/cluster.md": {
+        "size": 129
+      },
+      "docs/api/networks/collection.md": {
+        "size": 265
+      },
+      "docs/api/networks/components.md": {
+        "size": 210
+      },
+      "docs/api/networks/descriptors.md": {
+        "size": 212
+      },
+      "docs/api/networks/indexing.md": {
+        "size": 200
+      },
+      "docs/api/networks/io.md": {
+        "size": 164
+      },
+      "docs/api/networks/network.md": {
+        "size": 236
+      },
+      "docs/api/networks/optimize.md": {
+        "size": 424
+      },
+      "docs/api/networks/plot.md": {
+        "size": 445
+      },
+      "docs/api/networks/power-flow.md": {
+        "size": 179
+      },
+      "docs/api/networks/statistics.md": {
+        "size": 348
+      },
+      "docs/api/networks/subnetwork.md": {
+        "size": 164
+      },
+      "docs/api/networks/transform.md": {
+        "size": 178
+      },
+      "docs/api/other/api-examples.md": {
+        "size": 267
+      },
+      "docs/api/other/common.md": {
+        "size": 669
+      },
+      "docs/api/other/consistency.md": {
+        "size": 624
+      },
+      "docs/api/other/options.md": {
+        "size": 627
+      },
+      "docs/assets/javascripts/gurubase-widget.js": {
+        "size": 1197
+      },
+      "docs/assets/javascripts/matjax.js": {
+        "size": 502
+      },
+      "docs/assets/javascripts/readthedocs.js": {
+        "size": 809
+      },
+      "docs/contributing/contributing.md": {
+        "size": 6313
+      },
+      "docs/contributing/contributors.md": {
+        "size": 1441
+      },
+      "docs/examples/examples.md": {
+        "size": 8698
+      },
+      "docs/home/citing.md": {
+        "size": 9740
+      },
+      "docs/home/features.md": {
+        "size": 7780
+      },
+      "docs/home/installation.md": {
+        "size": 5455
+      },
+      "docs/home/license.md": {
+        "size": 1282
+      },
+      "docs/home/models.md": {
+        "size": 5138
+      },
+      "docs/home/users.md": {
+        "size": 23810
+      },
+      "docs/hooks/cleanup.py": {
+        "size": 968
+      },
+      "docs/hooks/dynamic_inspect.py": {
+        "size": 1082
+      },
+      "docs/hooks/path_aliases.py": {
+        "size": 4223
+      },
+      "docs/hooks/shortcodes.py": {
+        "size": 16035
+      },
+      "docs/index.md": {
+        "size": 4839
+      },
+      "docs/release-notes.md": {
+        "size": 128422
+      },
+      "docs/requirements.txt": {
+        "size": 17102
+      },
+      "docs/user-guide/collection.md": {
+        "size": 7632
+      },
+      "docs/user-guide/components.md": {
+        "size": 9304
+      },
+      "docs/user-guide/components/buses.md": {
+        "size": 654
+      },
+      "docs/user-guide/components/carriers.md": {
+        "size": 682
+      },
+      "docs/user-guide/components/generators.md": {
+        "size": 1012
+      },
+      "docs/user-guide/components/global-constraints.md": {
+        "size": 353
+      },
+      "docs/user-guide/components/line-types.md": {
+        "size": 936
+      },
+      "docs/user-guide/components/lines.md": {
+        "size": 951
+      },
+      "docs/user-guide/components/links.md": {
+        "size": 3686
+      },
+      "docs/user-guide/components/loads.md": {
+        "size": 867
+      },
+      "docs/user-guide/components/shapes.md": {
+        "size": 337
+      },
+      "docs/user-guide/components/shunt-impedances.md": {
+        "size": 943
+      },
+      "docs/user-guide/components/storage-units.md": {
+        "size": 1551
+      },
+      "docs/user-guide/components/stores.md": {
+        "size": 2536
+      },
+      "docs/user-guide/components/sub-networks.md": {
+        "size": 893
+      },
+      "docs/user-guide/components/transformer-types.md": {
+        "size": 855
+      },
+      "docs/user-guide/components/transformers.md": {
+        "size": 683
+      },
+      "docs/user-guide/design.md": {
+        "size": 17819
+      },
+      "docs/user-guide/faq.md": {
+        "size": 10223
+      },
+      "docs/user-guide/import-export.md": {
+        "size": 7634
+      },
+      "docs/user-guide/learning-materials.md": {
+        "size": 1010
+      },
+      "docs/user-guide/linear-power-flow.md": {
+        "size": 3856
+      },
+      "docs/user-guide/network-optimization.md": {
+        "size": 9547
+      },
+      "docs/user-guide/optimization/capacity-limits.md": {
+        "size": 7284
+      },
+      "docs/user-guide/optimization/contingencies.md": {
+        "size": 6579
+      },
+      "docs/user-guide/optimization/custom-constraints.md": {
+        "size": 7494
+      },
+      "docs/user-guide/optimization/dispatch-limits.md": {
+        "size": 7222
+      },
+      "docs/user-guide/optimization/energy-balance.md": {
+        "size": 3791
+      },
+      "docs/user-guide/optimization/global-constraints.md": {
+        "size": 12604
+      },
+      "docs/user-guide/optimization/modelling-to-generate-alternatives.md": {
+        "size": 5313
+      },
+      "docs/user-guide/optimization/objective.md": {
+        "size": 10001
+      },
+      "docs/user-guide/optimization/overview.md": {
+        "size": 3517
+      },
+      "docs/user-guide/optimization/pathway-planning.md": {
+        "size": 10983
+      },
+      "docs/user-guide/optimization/power-flow.md": {
+        "size": 7236
+      },
+      "docs/user-guide/optimization/stochastic.md": {
+        "size": 22635
+      },
+      "docs/user-guide/optimization/storage.md": {
+        "size": 11229
+      },
+      "docs/user-guide/optimization/unit-commitment.md": {
+        "size": 16807
+      },
+      "docs/user-guide/options.md": {
+        "size": 5386
+      },
+      "docs/user-guide/plotting/charts.md": {
+        "size": 15305
+      },
+      "docs/user-guide/power-flow.md": {
+        "size": 10049
+      },
+      "docs/user-guide/statistics.md": {
+        "size": 6948
+      },
+      "docs/user-guide/support.md": {
+        "size": 973
+      },
+      "docs/user-guide/troubleshooting.md": {
+        "size": 5941
+      },
+      "docs/user-guide/user-guide.md": {
+        "size": 1165
+      },
+      "docs/user-guide/v1-guide.md": {
+        "size": 9077
+      },
+      "examples/networks/ac-dc-meshed/ac-dc-meshed/crs.json": {
+        "size": 920
+      },
+      "examples/networks/ac-dc-meshed/ac-dc-meshed/meta.json": {
+        "size": 2
+      },
+      "examples/networks/model-energy/model-energy/crs.json": {
+        "size": 920
+      },
+      "examples/networks/model-energy/model-energy/meta.json": {
+        "size": 2
+      },
+      "examples/networks/scigrid-de/scigrid-de/crs.json": {
+        "size": 920
+      },
+      "examples/networks/scigrid-de/scigrid-de/meta.json": {
+        "size": 2
+      },
+      "examples/networks/storage-hvdc/storage-hvdc/crs.json": {
+        "size": 920
+      },
+      "examples/networks/storage-hvdc/storage-hvdc/meta.json": {
+        "size": 2
+      },
+      "mkdocs.yml": {
+        "size": 15022
+      },
+      "pyproject.toml": {
+        "size": 6831
+      },
+      "pypsa/__init__.py": {
+        "size": 2807
+      },
+      "pypsa/_options.py": {
+        "size": 13897
+      },
+      "pypsa/clustering/__init__.py": {
+        "size": 3376
+      },
+      "pypsa/clustering/spatial.py": {
+        "size": 35407
+      },
+      "pypsa/clustering/temporal.py": {
+        "size": 132
+      },
+      "pypsa/collection.py": {
+        "size": 28144
+      },
+      "pypsa/common.py": {
+        "size": 27902
+      },
+      "pypsa/components/__init__.py": {
+        "size": 1130
+      },
+      "pypsa/components/_types/__init__.py": {
+        "size": 1419
+      },
+      "pypsa/components/_types/_patch.py": {
+        "size": 3265
+      },
+      "pypsa/components/_types/buses.py": {
+        "size": 1352
+      },
+      "pypsa/components/_types/carriers.py": {
+        "size": 1379
+      },
+      "pypsa/components/_types/generators.py": {
+        "size": 2298
+      },
+      "pypsa/components/_types/global_constraints.py": {
+        "size": 1456
+      },
+      "pypsa/components/_types/line_types.py": {
+        "size": 1393
+      },
+      "pypsa/components/_types/lines.py": {
+        "size": 3882
+      },
+      "pypsa/components/_types/links.py": {
+        "size": 3090
+      },
+      "pypsa/components/_types/loads.py": {
+        "size": 1277
+      },
+      "pypsa/components/_types/shapes.py": {
+        "size": 1205
+      },
+      "pypsa/components/_types/shunt_impedances.py": {
+        "size": 1273
+      },
+      "pypsa/components/_types/storage_units.py": {
+        "size": 2518
+      },
+      "pypsa/components/_types/stores.py": {
+        "size": 2178
+      },
+      "pypsa/components/_types/sub_networks.py": {
+        "size": 1408
+      },
+      "pypsa/components/_types/transformer_types.py": {
+        "size": 1449
+      },
+      "pypsa/components/_types/transformers.py": {
+        "size": 2366
+      },
+      "pypsa/components/abstract.py": {
+        "size": 2676
+      },
+      "pypsa/components/array.py": {
+        "size": 12538
+      },
+      "pypsa/components/common.py": {
+        "size": 1848
+      },
+      "pypsa/components/components.py": {
+        "size": 26324
+      },
+      "pypsa/components/descriptors.py": {
+        "size": 9148
+      },
+      "pypsa/components/index.py": {
+        "size": 4049
+      },
+      "pypsa/components/legacy.py": {
+        "size": 2654
+      },
+      "pypsa/components/store.py": {
+        "size": 6550
+      },
+      "pypsa/components/transform.py": {
+        "size": 6882
+      },
+      "pypsa/components/types.py": {
+        "size": 7435
+      },
+      "pypsa/consistency.py": {
+        "size": 37582
+      },
+      "pypsa/constants.py": {
+        "size": 458
+      },
+      "pypsa/definitions/components.py": {
+        "size": 2020
+      },
+      "pypsa/definitions/structures.py": {
+        "size": 2240
+      },
+      "pypsa/deprecations.py": {
+        "size": 593
+      },
+      "pypsa/descriptors.py": {
+        "size": 8736
+      },
+      "pypsa/examples.py": {
+        "size": 6607
+      },
+      "pypsa/geo.py": {
+        "size": 6227
+      },
+      "pypsa/guards.py": {
+        "size": 7156
+      },
+      "pypsa/network/__init__.py": {
+        "size": 138
+      },
+      "pypsa/network/abstract.py": {
+        "size": 2775
+      },
+      "pypsa/network/components.py": {
+        "size": 30570
+      },
+      "pypsa/network/descriptors.py": {
+        "size": 8052
+      },
+      "pypsa/network/graph.py": {
+        "size": 10946
+      },
+      "pypsa/network/index.py": {
+        "size": 40162
+      },
+      "pypsa/network/io.py": {
+        "size": 86634
+      },
+      "pypsa/network/power_flow.py": {
+        "size": 67785
+      },
+      "pypsa/network/transform.py": {
+        "size": 21288
+      },
+      "pypsa/networks.py": {
+        "size": 62697
+      },
+      "pypsa/optimization/__init__.py": {
+        "size": 393
+      },
+      "pypsa/optimization/abstract.py": {
+        "size": 24469
+      },
+      "pypsa/optimization/common.py": {
+        "size": 2361
+      },
+      "pypsa/optimization/constraints.py": {
+        "size": 64639
+      },
+      "pypsa/optimization/expressions.py": {
+        "size": 26869
+      },
+      "pypsa/optimization/global_constraints.py": {
+        "size": 32963
+      },
+      "pypsa/optimization/mga.py": {
+        "size": 28507
+      },
+      "pypsa/optimization/optimize.py": {
+        "size": 40975
+      },
+      "pypsa/optimization/variables.py": {
+        "size": 7716
+      },
+      "pypsa/plot/__init__.py": {
+        "size": 641
+      },
+      "pypsa/plot/accessor.py": {
+        "size": 1401
+      },
+      "pypsa/plot/maps/__init__.py": {
+        "size": 460
+      },
+      "pypsa/plot/maps/common.py": {
+        "size": 28329
+      },
+      "pypsa/plot/maps/interactive.py": {
+        "size": 76737
+      },
+      "pypsa/plot/maps/static.py": {
+        "size": 66061
+      },
+      "pypsa/plot/statistics/__init__.py": {
+        "size": 420
+      },
+      "pypsa/plot/statistics/base.py": {
+        "size": 2845
+      },
+      "pypsa/plot/statistics/charts.py": {
+        "size": 22037
+      },
+      "pypsa/plot/statistics/maps.py": {
+        "size": 12641
+      },
+      "pypsa/plot/statistics/plotter.py": {
+        "size": 31725
+      },
+      "pypsa/plot/statistics/schema.py": {
+        "size": 9371
+      },
+      "pypsa/statistics/__init__.py": {
+        "size": 510
+      },
+      "pypsa/statistics/abstract.py": {
+        "size": 10351
+      },
+      "pypsa/statistics/expressions.py": {
+        "size": 113146
+      },
+      "pypsa/statistics/grouping.py": {
+        "size": 13732
+      },
+      "pypsa/type_utils.py": {
+        "size": 1135
+      },
+      "pypsa/version.py": {
+        "size": 1410
+      },
+      "test/conftest.py": {
+        "size": 8906
+      },
+      "test/data/ac-dc-meshed/results-lopf/crs.json": {
+        "size": 921
+      },
+      "test/data/ac-dc-meshed/results-lopf/meta.json": {
+        "size": 3
+      },
+      "test/data/benchmark-sp/crs.json": {
+        "size": 921
+      },
+      "test/data/benchmark-sp/meta.json": {
+        "size": 3
+      },
+      "test/test_bugs.py": {
+        "size": 7722
+      },
+      "test/test_collection.py": {
+        "size": 14965
+      },
+      "test/test_collection_statistics.py": {
+        "size": 18943
+      },
+      "test/test_common.py": {
+        "size": 14154
+      },
+      "test/test_common_deprecations.py": {
+        "size": 6725
+      },
+      "test/test_components.py": {
+        "size": 2717
+      },
+      "test/test_components_array.py": {
+        "size": 9287
+      },
+      "test/test_components_custom.py": {
+        "size": 1695
+      },
+      "test/test_components_store.py": {
+        "size": 398
+      },
+      "test/test_components_utils.py": {
+        "size": 460
+      },
+      "test/test_consistency_check.py": {
+        "size": 16082
+      },
+      "test/test_constants.py": {
+        "size": 5967
+      },
+      "test/test_deprecations.py": {
+        "size": 2726
+      },
+      "test/test_descriptors.py": {
+        "size": 5230
+      },
+      "test/test_docs.py": {
+        "size": 7727
+      },
+      "test/test_examples.py": {
+        "size": 1442
+      },
+      "test/test_graph.py": {
+        "size": 6678
+      },
+      "test/test_guards.py": {
+        "size": 835
+      },
+      "test/test_indices.py": {
+        "size": 2754
+      },
+      "test/test_io.py": {
+        "size": 24161
+      },
+      "test/test_io_cloudpathlib.py": {
+        "size": 3414
+      },
+      "test/test_link_post_discretization.py": {
+        "size": 4230
+      },
+      "test/test_lopf_ac_dc.py": {
+        "size": 820
+      },
+      "test/test_lopf_activity_mask.py": {
+        "size": 14953
+      },
+      "test/test_lopf_and_subsequent_power_flow.py": {
+        "size": 313
+      },
+      "test/test_lopf_basic_constraints.py": {
+        "size": 11940
+      },
+      "test/test_lopf_global_constraints.py": {
+        "size": 4076
+      },
+      "test/test_lopf_iteratively.py": {
+        "size": 1226
+      },
+      "test/test_lopf_losses.py": {
+        "size": 770
+      },
+      "test/test_lopf_mga.py": {
+        "size": 6265
+      },
+      "test/test_lopf_modularity.py": {
+        "size": 1157
+      },
+      "test/test_lopf_multiinvest.py": {
+        "size": 35983
+      },
+      "test/test_lopf_multilink.py": {
+        "size": 3960
+      },
+      "test/test_lopf_quadratic_costs.py": {
+        "size": 687
+      },
+      "test/test_lopf_rolling_horizon.py": {
+        "size": 2715
+      },
+      "test/test_lopf_storage.py": {
+        "size": 2821
+      },
+      "test/test_lopf_unit_commitment.py": {
+        "size": 16924
+      },
+      "test/test_lopf_varying_inputs.py": {
+        "size": 1628
+      },
+      "test/test_lpf_ac_dc.py": {
+        "size": 1556
+      },
+      "test/test_lpf_against_pypower.py": {
+        "size": 2670
+      },
+      "test/test_meshed_threshold.py": {
+        "size": 3880
+      },
+      "test/test_network.py": {
+        "size": 22314
+      },
+      "test/test_network_cycles.py": {
+        "size": 12678
+      },
+      "test/test_network_index.py": {
+        "size": 14289
+      },
+      "test/test_network_transform.py": {
+        "size": 8491
+      },
+      "test/test_optimization_expressions.py": {
+        "size": 5421
+      },
+      "test/test_optional_dependencies.py": {
+        "size": 2196
+      },
+      "test/test_options.py": {
+        "size": 9946
+      },
+      "test/test_pf_activity_mask.py": {
+        "size": 1039
+      },
+      "test/test_pf_against_pandapower.py": {
+        "size": 2358
+      },
+      "test/test_pf_against_pypower.py": {
+        "size": 3229
+      },
+      "test/test_pf_distributed_slack.py": {
+        "size": 2579
+      },
+      "test/test_plot_maps_common.py": {
+        "size": 20887
+      },
+      "test/test_plot_maps_interactive.py": {
+        "size": 5380
+      },
+      "test/test_plot_maps_static.py": {
+        "size": 9255
+      },
+      "test/test_riskaversion.py": {
+        "size": 11021
+      },
+      "test/test_sclopf_scigrid.py": {
+        "size": 3089
+      },
+      "test/test_snapshot_weightings.py": {
+        "size": 1375
+      },
+      "test/test_spatial_clustering.py": {
+        "size": 7552
+      },
+      "test/test_stand_by_cost.py": {
+        "size": 1397
+      },
+      "test/test_statistics.py": {
+        "size": 9835
+      },
+      "test/test_statistics_plot.py": {
+        "size": 8051
+      },
+      "test/test_statistics_plot_interactive.py": {
+        "size": 10662
+      },
+      "test/test_statistics_plot_schema.py": {
+        "size": 1152
+      },
+      "test/test_stochastic.py": {
+        "size": 56214
+      },
+      "test/test_stochastic_not_implemented.py": {
+        "size": 1835
+      },
+      "test/test_subnetwork.py": {
+        "size": 2908
+      },
+      "test/test_version.py": {
+        "size": 1433
+      },
+      "test/test_warnings_cyclic_storage.py": {
+        "size": 7694
+      }
+    },
+    "processed_by": "zip_fallback",
+    "success": true
+  },
+  "structure": {
+    "packages": [
+      "source.pypsa",
+      "source.pypsa.clustering",
+      "source.pypsa.components",
+      "source.pypsa.network",
+      "source.pypsa.optimization",
+      "source.pypsa.plot",
+      "source.pypsa.statistics"
+    ]
+  },
+  "dependencies": {
+    "has_environment_yml": false,
+    "has_requirements_txt": false,
+    "pyproject": true,
+    "setup_cfg": false,
+    "setup_py": false
+  },
+  "entry_points": {
+    "imports": [],
+    "cli": [],
+    "modules": []
+  },
+  "llm_analysis": {
+    "core_modules": [
+      {
+        "package": "source.pypsa",
+        "module": "__init__",
+        "functions": [],
+        "classes": [],
+        "description": "Initialization module for the PyPSA package."
+      },
+      {
+        "package": "source.pypsa.clustering",
+        "module": "spatial",
+        "functions": [
+          "cluster_spatial"
+        ],
+        "classes": [],
+        "description": "Functions for spatial clustering of network components."
+      },
+      {
+        "package": "source.pypsa.components",
+        "module": "components",
+        "functions": [
+          "add_component",
+          "remove_component"
+        ],
+        "classes": [
+          "Component"
+        ],
+        "description": "Handles the addition and removal of components in the network."
+      },
+      {
+        "package": "source.pypsa.network",
+        "module": "io",
+        "functions": [
+          "import_network",
+          "export_network"
+        ],
+        "classes": [],
+        "description": "Functions for importing and exporting network data."
+      },
+      {
+        "package": "source.pypsa.optimization",
+        "module": "optimize",
+        "functions": [
+          "optimize_network"
+        ],
+        "classes": [],
+        "description": "Optimization routines for network operation and planning."
+      },
+      {
+        "package": "source.pypsa.plot",
+        "module": "maps",
+        "functions": [
+          "plot_static_map",
+          "plot_interactive_map"
+        ],
+        "classes": [],
+        "description": "Plotting functions for static and interactive maps."
+      },
+      {
+        "package": "source.pypsa.statistics",
+        "module": "expressions",
+        "functions": [
+          "calculate_statistics"
+        ],
+        "classes": [],
+        "description": "Functions for calculating various network statistics."
+      }
+    ],
+    "cli_commands": [],
+    "import_strategy": {
+      "primary": "import",
+      "fallback": "blackbox",
+      "confidence": 0.85
+    },
+    "dependencies": {
+      "required": [
+        "numpy",
+        "pandas",
+        "matplotlib"
+      ],
+      "optional": [
+        "geopandas",
+        "plotly"
+      ]
+    },
+    "risk_assessment": {
+      "import_feasibility": 0.8,
+      "intrusiveness_risk": "medium",
+      "complexity": "medium"
+    }
+  },
+  "deepwiki_analysis": {
+    "repo_url": "https://github.com/PyPSA/PyPSA",
+    "repo_name": "PyPSA",
+    "content": null,
+    "model": "gpt-4o",
+    "source": "selenium",
+    "success": true
+  },
+  "deepwiki_options": {
+    "enabled": true,
+    "model": "gpt-4o"
+  },
+  "risk": {
+    "import_feasibility": 0.8,
+    "intrusiveness_risk": "medium",
+    "complexity": "medium"
+  }
+}

PyPSA/mcp_output/env_info.json

@@ -0,0 +1,15 @@
+{
+  "environment": {
+    "type": "conda",
+    "name": "PyPSA_558543_env",
+    "files": {},
+    "python": "3.10",
+    "exec_prefix": []
+  },
+  "original_tests": {
+    "passed": false,
+    "report_path": null
+  },
+  "timestamp": 1763558620.0246599,
+  "conda_available": true
+}

PyPSA/mcp_output/mcp_logs/llm_statistics.json

@@ -0,0 +1,11 @@
+{
+  "total_calls": 5,
+  "failed_calls": 0,
+  "retry_count": 0,
+  "total_prompt_tokens": 27816,
+  "total_completion_tokens": 4358,
+  "total_tokens": 32174,
+  "average_prompt_tokens": 5563.2,
+  "average_completion_tokens": 871.6,
+  "average_tokens": 6434.8
+}

PyPSA/mcp_output/mcp_logs/run_log.json

@@ -0,0 +1,66 @@
+{
+  "timestamp": 1763558886.5027742,
+  "node": "RunNode",
+  "test_result": {
+    "passed": false,
+    "report_path": null,
+    "stdout": "",
+    "stderr": "onda.cli.main_run:execute(41): `conda run python mcp_output/start_mcp.py` failed. (See above for error)\nTraceback (most recent call last):\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/start_mcp.py\", line 17, in <module>\n    from mcp_service import create_app\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/mcp_plugin/mcp_service.py\", line 8, in <module>\n    from pypsa import Network, SubNetwork, clustering, common, components, descriptors, examples, geo, optimization, plot, statistics\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/source/pypsa/__init__.py\", line 21, in <module>\n    from pypsa import (\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/source/pypsa/clustering/__init__.py\", line 10, in <module>\n    import pandas as pd\nModuleNotFoundError: No module named 'pandas'\n\n"
+  },
+  "run_result": {
+    "success": false,
+    "test_passed": false,
+    "exit_code": 1,
+    "stdout": "",
+    "stderr": "onda.cli.main_run:execute(41): `conda run python mcp_output/start_mcp.py` failed. (See above for error)\nTraceback (most recent call last):\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/start_mcp.py\", line 17, in <module>\n    from mcp_service import create_app\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/mcp_plugin/mcp_service.py\", line 8, in <module>\n    from pypsa import Network, SubNetwork, clustering, common, components, descriptors, examples, geo, optimization, plot, statistics\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/source/pypsa/__init__.py\", line 21, in <module>\n    from pypsa import (\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/source/pypsa/clustering/__init__.py\", line 10, in <module>\n    import pandas as pd\nModuleNotFoundError: No module named 'pandas'\n\n",
+    "timestamp": 1763558886.5027297,
+    "error_type": "ImportError",
+    "error": "Module import failed: ERROR conda.cli.main_run:execute(41): `conda run python mcp_output/start_mcp.py` failed. (See above for error)\nTraceback (most recent call last):\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/start_mcp.py\", line 17, in <module>\n    from mcp_service import create_app\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/mcp_plugin/mcp_service.py\", line 8, in <module>\n    from pypsa import Network, SubNetwork, clustering, common, components, descriptors, examples, geo, optimization, plot, statistics\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/source/pypsa/__init__.py\", line 21, in <module>\n    from pypsa import (\n  File \"/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/source/pypsa/clustering/__init__.py\", line 10, in <module>\n    import pandas as pd\nModuleNotFoundError: No module named 'pandas'\n\n",
+    "details": {
+      "command": "/home/wshiah/code/miniconda3/bin/conda run -n PyPSA_558543_env --cwd /export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA python mcp_output/start_mcp.py",
+      "working_directory": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA",
+      "environment_type": "conda"
+    }
+  },
+  "environment": {
+    "type": "conda",
+    "name": "PyPSA_558543_env",
+    "files": {},
+    "python": "3.10",
+    "exec_prefix": []
+  },
+  "plugin_info": {
+    "files": {
+      "mcp_output/start_mcp.py": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/start_mcp.py",
+      "mcp_output/mcp_plugin/__init__.py": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/mcp_plugin/__init__.py",
+      "mcp_output/mcp_plugin/mcp_service.py": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/mcp_plugin/mcp_service.py",
+      "mcp_output/mcp_plugin/adapter.py": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/mcp_plugin/adapter.py",
+      "mcp_output/mcp_plugin/main.py": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/mcp_plugin/main.py",
+      "mcp_output/requirements.txt": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/requirements.txt",
+      "mcp_output/README_MCP.md": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/README_MCP.md",
+      "mcp_output/tests_mcp/test_mcp_basic.py": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/tests_mcp/test_mcp_basic.py"
+    },
+    "adapter_mode": "import",
+    "endpoints": [
+      "cluster_spatial",
+      "add_component",
+      "remove_component",
+      "component",
+      "import_network",
+      "export_network",
+      "optimize_network",
+      "plot_static_map",
+      "plot_interactive_map",
+      "calculate_statistics"
+    ],
+    "mcp_dir": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/mcp_plugin",
+    "tests_dir": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/tests_mcp",
+    "main_entry": "start_mcp.py",
+    "readme_path": "/export/project/shiweijie/ghh/LLM_MCP_RAG/MCP-agent-github-repo-output/workspace/PyPSA/mcp_output/README_MCP.md",
+    "requirements": [
+      "fastmcp>=0.1.0",
+      "pydantic>=2.0.0"
+    ]
+  },
+  "fastmcp_installed": false
+}

PyPSA/mcp_output/mcp_plugin/adapter.py

@@ -0,0 +1,129 @@
+import os
+import sys
+
+# Path settings
+source_path = os.path.join(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))), "source")
+sys.path.insert(0, source_path)
+
+# Import statements
+try:
+    from pypsa import Network
+    from pypsa.clustering import spatial
+    from pypsa.optimization import optimize
+    from pypsa.plot import maps
+    from pypsa.statistics import expressions
+except ImportError as e:
+    print(f"ImportError: {e}. Ensure the PyPSA package is correctly installed and accessible.")
+    # Fallback mode can be implemented here if necessary
+
+# Adapter class definition
+class Adapter:
+    """
+    Adapter class for the MCP plugin, utilizing the PyPSA library.
+    Provides methods to interact with various components and functionalities of PyPSA.
+    """
+
+    def __init__(self):
+        self.mode = "import"
+
+    # Network Module
+    # -------------------------------------------------------------------------
+    def create_network(self, *args, **kwargs):
+        """
+        Create a new network instance.
+
+        Parameters:
+        - args: Positional arguments for Network initialization.
+        - kwargs: Keyword arguments for Network initialization.
+
+        Returns:
+        - dict: Status and network instance or error message.
+        """
+        try:
+            network = Network(*args, **kwargs)
+            return {"status": "success", "network": network}
+        except Exception as e:
+            return {"status": "error", "message": f"Failed to create network: {e}"}
+
+    # Clustering Module
+    # -------------------------------------------------------------------------
+    def perform_spatial_clustering(self, network, *args, **kwargs):
+        """
+        Perform spatial clustering on the given network.
+
+        Parameters:
+        - network: The network instance to cluster.
+        - args: Additional positional arguments for clustering.
+        - kwargs: Additional keyword arguments for clustering.
+
+        Returns:
+        - dict: Status and clustering result or error message.
+        """
+        try:
+            result = spatial(network, *args, **kwargs)
+            return {"status": "success", "result": result}
+        except Exception as e:
+            return {"status": "error", "message": f"Failed to perform spatial clustering: {e}"}
+
+    # Optimization Module
+    # -------------------------------------------------------------------------
+    def optimize_network(self, network, *args, **kwargs):
+        """
+        Optimize the given network.
+
+        Parameters:
+        - network: The network instance to optimize.
+        - args: Additional positional arguments for optimization.
+        - kwargs: Additional keyword arguments for optimization.
+
+        Returns:
+        - dict: Status and optimization result or error message.
+        """
+        try:
+            result = optimize(network, *args, **kwargs)
+            return {"status": "success", "result": result}
+        except Exception as e:
+            return {"status": "error", "message": f"Failed to optimize network: {e}"}
+
+    # Plotting Module
+    # -------------------------------------------------------------------------
+    def plot_network_map(self, network, *args, **kwargs):
+        """
+        Plot a map of the given network.
+
+        Parameters:
+        - network: The network instance to plot.
+        - args: Additional positional arguments for plotting.
+        - kwargs: Additional keyword arguments for plotting.
+
+        Returns:
+        - dict: Status and plot result or error message.
+        """
+        try:
+            result = maps(network, *args, **kwargs)
+            return {"status": "success", "result": result}
+        except Exception as e:
+            return {"status": "error", "message": f"Failed to plot network map: {e}"}
+
+    # Statistics Module
+    # -------------------------------------------------------------------------
+    def calculate_expressions(self, network, *args, **kwargs):
+        """
+        Calculate expressions for the given network.
+
+        Parameters:
+        - network: The network instance for which to calculate expressions.
+        - args: Additional positional arguments for calculation.
+        - kwargs: Additional keyword arguments for calculation.
+
+        Returns:
+        - dict: Status and calculation result or error message.
+        """
+        try:
+            result = expressions(network, *args, **kwargs)
+            return {"status": "success", "result": result}
+        except Exception as e:
+            return {"status": "error", "message": f"Failed to calculate expressions: {e}"}
+
+# End of Adapter class definition
+# -------------------------------------------------------------------------

PyPSA/mcp_output/mcp_plugin/main.py

@@ -0,0 +1,13 @@
+"""
+MCP Service Auto-Wrapper - Auto-generated
+"""
+from mcp_service import create_app
+
+def main():
+    """Main entry point"""
+    app = create_app()
+    return app
+
+if __name__ == "__main__":
+    app = main()
+    app.run()

PyPSA/mcp_output/mcp_plugin/mcp_service.py

@@ -0,0 +1,524 @@
+import os
+import sys
+import json
+from pathlib import Path
+
+source_path = os.path.join(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))), "source")
+sys.path.insert(0, source_path)
+
+from fastmcp import FastMCP
+from pypsa import Network
+from pypsa.statistics import StatisticsAccessor, get_operation, get_transmission_branches
+import logging
+
+# Set up logging
+logging.basicConfig(level=logging.WARNING)
+logger = logging.getLogger(__name__)
+
+mcp = FastMCP("pypsa_service")
+
+# ============================================================================
+# NETWORK I/O TOOLS
+# ============================================================================
+
+@mcp.tool(
+    name="load_network",
+    description="Load a PyPSA network from a file (netCDF, HDF5, CSV folder, or URL)"
+)
+def tool_load_network(file_path: str) -> dict:
+    """
+    Load a PyPSA network from a specified file path.
+
+    Supported formats:
+    - .nc (NetCDF)
+    - .h5 (HDF5)
+    - folder containing CSV files
+    - URL to remote network file
+
+    Parameters:
+    - file_path (str): Path to the network file or folder
+
+    Returns:
+    - dict: Network metadata and basic info
+    """
+    try:
+        network = Network(file_path)
+        
+        # Extract network metadata
+        result = {
+            "success": True,
+            "result": {
+                "network_name": network.name,
+                "pypsa_version": network._pypsa_version,
+                "snapshots_count": len(network.snapshots),
+                "buses_count": len(network.buses),
+                "generators_count": len(network.generators),
+                "loads_count": len(network.loads),
+                "storage_units_count": len(network.storage_units),
+                "stores_count": len(network.stores),
+                "lines_count": len(network.lines),
+                "links_count": len(network.links),
+                "transformers_count": len(network.transformers),
+                "sub_networks_count": len(network.sub_networks),
+                "objective_value": float(network.objective) if hasattr(network, 'objective') else None,
+                "carriers": list(network.carriers.index) if len(network.carriers) > 0 else [],
+                "crs": str(network.crs),
+                "file_path": str(file_path),
+                "description": f"Network with {len(network.buses)} buses, {len(network.generators)} generators, {len(network.loads)} loads"
+            },
+            "error": None
+        }
+        return result
+    except Exception as e:
+        return {"success": False, "result": None, "error": f"Failed to load network: {str(e)}"}
+
+@mcp.tool(
+    name="save_network",
+    description="Save a PyPSA network to a file"
+)
+def tool_save_network(network_path: str, output_path: str, format: str = "netcdf") -> dict:
+    """
+    Save a PyPSA network to a file in specified format.
+
+    Supported formats:
+    - netcdf (.nc)
+    - hdf5 (.h5)
+    - csv (folder)
+
+    Parameters:
+    - network_path (str): Path to load the network from
+    - output_path (str): Path to save the network to
+    - format (str): Output format (netcdf, hdf5, or csv)
+
+    Returns:
+    - dict: Save status and result information
+    """
+    try:
+        network = Network(network_path)
+        
+        if format.lower() in ["netcdf", "nc"]:
+            network.export_to_netcdf(output_path)
+            format_used = "NetCDF (.nc)"
+        elif format.lower() in ["hdf5", "h5"]:
+            network.export_to_hdf5(output_path)
+            format_used = "HDF5 (.h5)"
+        elif format.lower() == "csv":
+            network.export_to_csv_folder(output_path)
+            format_used = "CSV (folder)"
+        else:
+            raise ValueError(f"Unsupported format: {format}")
+        
+        return {
+            "success": True,
+            "result": {
+                "output_path": str(output_path),
+                "format": format_used,
+                "description": f"Network saved successfully as {format_used}"
+            },
+            "error": None
+        }
+    except Exception as e:
+        return {"success": False, "result": None, "error": f"Failed to save network: {str(e)}"}
+
+# ============================================================================
+# NETWORK ANALYSIS TOOLS
+# ============================================================================
+
+@mcp.tool(
+    name="get_network_statistics",
+    description="Calculate detailed statistics for the network"
+)
+def tool_get_network_statistics(file_path: str) -> dict:
+    """
+    Calculate comprehensive statistics for the network.
+
+    Includes:
+    - Component counts and attributes
+    - Capacity information
+    - Operating data
+    - Energy flows
+    - Network topology stats
+
+    Parameters:
+    - file_path (str): Path to the network file
+
+    Returns:
+    - dict: Detailed network statistics
+    """
+    try:
+        network = Network(file_path)
+        
+        # Calculate basic statistics
+        stats = {
+            "success": True,
+            "result": {
+                "network_overview": {
+                    "name": network.name,
+                    "snapshots_count": len(network.snapshots),
+                    "time_period": f"{network.snapshots[0]} to {network.snapshots[-1]}" if len(network.snapshots) > 0 else "N/A"
+                },
+                "components": {
+                    "buses": len(network.buses),
+                    "generators": len(network.generators),
+                    "storage_units": len(network.storage_units),
+                    "stores": len(network.stores),
+                    "loads": len(network.loads),
+                    "lines": len(network.lines),
+                    "links": len(network.links),
+                    "transformers": len(network.transformers),
+                    "sub_networks": len(network.sub_networks)
+                },
+                "capacity_stats": {
+                    "total_generator_capacity_mw": round(network.generators.p_nom.sum(), 2) if len(network.generators) > 0 else 0,
+                    "total_storage_capacity_mwh": round(network.storage_units.e_nom.sum(), 2) if len(network.storage_units) > 0 else 0,
+                    "total_store_capacity_mwh": round(network.stores.e_nom.sum(), 2) if len(network.stores) > 0 else 0,
+                    "total_load_mw": round(network.loads.p_set.sum(), 2) if len(network.loads) > 0 else 0
+                },
+                "carrier_info": {
+                    "unique_carriers": list(network.carriers.index) if len(network.carriers) > 0 else [],
+                    "carrier_count": len(network.carriers)
+                },
+                "transmission_info": {
+                    "total_line_capacity_mva": round(network.lines.s_nom.sum(), 2) if len(network.lines) > 0 else 0,
+                    "total_link_count": len(network.links),
+                    "total_line_count": len(network.lines)
+                },
+                "objective_value": float(network.objective) if hasattr(network, 'objective') else None
+            },
+            "error": None
+        }
+        return stats
+    except Exception as e:
+        return {"success": False, "result": None, "error": f"Failed to get statistics: {str(e)}"}
+
+@mcp.tool(
+    name="optimize_network",
+    description="Run network optimization with linear optimal power flow (LOPF)"
+)
+def tool_optimize_network(
+    file_path: str,
+    snapshots: str = "all",
+    linearized_unit_commitment: bool = False,
+    multi_invest: bool = False,
+    solver: str = "glpk"
+) -> dict:
+    """
+    Run linear optimal power flow (LOPF) optimization on the network.
+
+    Parameters:
+    - file_path (str): Path to the network file
+    - snapshots (str): "all" or comma-separated snapshot indices
+    - linearized_unit_commitment (bool): Enable linearized unit commitment
+    - multi_invest (bool): Enable multi-period investment optimization
+    - solver (str): Solver to use (glpk, cbc, cplex, gurobi, scip, etc.)
+
+    Returns:
+    - dict: Optimization results with objective value and status
+    """
+    try:
+        network = Network(file_path)
+        
+        # Set optimization options
+        if linearized_unit_commitment:
+            network._linearized_uc = 1
+        if multi_invest:
+            network._multi_invest = 1
+        
+        # Run optimization
+        status, termination_condition = network.optimize(
+            solver_name=solver,
+            multi_investment_periods=multi_invest
+        )
+        
+        result = {
+            "success": True,
+            "result": {
+                "status": status,
+                "termination_condition": termination_condition,
+                "objective_value": round(float(network.objective), 2),
+                "optimization_info": {
+                    "snapshots_optimized": len(network.snapshots),
+                    "linearzed_unit_commitment": linearized_unit_commitment,
+                    "multi_period_investment": multi_invest,
+                    "solver_used": solver
+                },
+                "description": f"Optimization completed with status: {status}, objective value: {network.objective:.2f}"
+            },
+            "error": None
+        }
+        return result
+    except Exception as e:
+        return {"success": False, "result": None, "error": f"Optimization failed: {str(e)}"}
+
+# ============================================================================
+# NETWORK COMPONENTS ANALYSIS TOOLS
+# ============================================================================
+
+@mcp.tool(
+    name="get_buses_info",
+    description="Get information about all buses in the network"
+)
+def tool_get_buses_info(file_path: str) -> dict:
+    """
+    Get detailed information about buses in the network.
+
+    Returns:
+    - Bus counts by carrier
+    - Bus locations (if available)
+    - Control types
+    - Voltage levels
+
+    Parameters:
+    - file_path (str): Path to the network file
+
+    Returns:
+    - dict: Detailed bus information
+    """
+    try:
+        network = Network(file_path)
+        
+        buses_info = {
+            "success": True,
+            "result": {
+                "total_buses": len(network.buses),
+                "buses_by_carrier": dict(network.buses.carrier.value_counts()) if len(network.buses) > 0 else {},
+                "buses_with_generation": len(network.buses[network.buses.index.isin(network.generators.bus)]) if len(network.generators) > 0 else 0,
+                "buses_with_load": len(network.buses[network.buses.index.isin(network.loads.bus)]) if len(network.loads) > 0 else 0,
+                "buses_with_storage": len(network.buses[network.buses.index.isin(network.storage_units.bus)]) if len(network.storage_units) > 0 else 0,
+                "buses_list": list(network.buses.index[:20]),  # First 20 buses
+                "description": f"Network contains {len(network.buses)} buses"
+            },
+            "error": None
+        }
+        return buses_info
+    except Exception as e:
+        return {"success": False, "result": None, "error": f"Failed to get buses info: {str(e)}"}
+
+@mcp.tool(
+    name="get_generators_info",
+    description="Get information about all generators in the network"
+)
+def tool_get_generators_info(file_path: str) -> dict:
+    """
+    Get detailed information about generators.
+
+    Returns:
+    - Generator counts by carrier
+    - Total installed capacity
+    - Generator efficiency
+    - Marginal costs
+
+    Parameters:
+    - file_path (str): Path to the network file
+
+    Returns:
+    - dict: Detailed generator information
+    """
+    try:
+        network = Network(file_path)
+        
+        if len(network.generators) == 0:
+            return {
+                "success": True,
+                "result": {
+                    "total_generators": 0,
+                    "description": "No generators in network"
+                },
+                "error": None
+            }
+        
+        generators_info = {
+            "success": True,
+            "result": {
+                "total_generators": len(network.generators),
+                "generators_by_carrier": dict(network.generators.carrier.value_counts()),
+                "total_capacity_mw": round(network.generators.p_nom.sum(), 2),
+                "average_efficiency": round(network.generators.efficiency.mean(), 4),
+                "marginal_cost_range": {
+                    "min": round(network.generators.marginal_cost.min(), 2),
+                    "max": round(network.generators.marginal_cost.max(), 2),
+                    "mean": round(network.generators.marginal_cost.mean(), 2)
+                },
+                "generators_by_bus": dict(network.generators.bus.value_counts().head(10)),
+                "description": f"Network contains {len(network.generators)} generators with total capacity {network.generators.p_nom.sum():.2f} MW"
+            },
+            "error": None
+        }
+        return generators_info
+    except Exception as e:
+        return {"success": False, "result": None, "error": f"Failed to get generators info: {str(e)}"}
+
+@mcp.tool(
+    name="get_transmission_info",
+    description="Get information about transmission branches (lines and links)"
+)
+def tool_get_transmission_info(file_path: str) -> dict:
+    """
+    Get detailed information about transmission branches.
+
+    Returns:
+    - Line and link counts
+    - Total transmission capacity
+    - Voltage levels
+    - Transmission losses
+
+    Parameters:
+    - file_path (str): Path to the network file
+
+    Returns:
+    - dict: Detailed transmission information
+    """
+    try:
+        network = Network(file_path)
+        
+        transmission_info = {
+            "success": True,
+            "result": {
+                "transmission_components": {
+                    "total_lines": len(network.lines),
+                    "total_links": len(network.links),
+                    "total_transformers": len(network.transformers)
+                },
+                "transmission_capacity": {
+                    "total_line_capacity_mva": round(network.lines.s_nom.sum(), 2) if len(network.lines) > 0 else 0,
+                    "total_link_capacity_mw": round(network.links.p_nom.sum(), 2) if len(network.links) > 0 else 0,
+                    "average_line_capacity_mva": round(network.lines.s_nom.mean(), 2) if len(network.lines) > 0 else 0
+                },
+                "transmission_losses": {
+                    "ac_line_losses": round(network.lines.x.sum(), 4) if len(network.lines) > 0 else 0,
+                    "transformer_losses": round(network.transformers.x.sum(), 4) if len(network.transformers) > 0 else 0
+                },
+                "description": f"Network has {len(network.lines)} transmission lines and {len(network.links)} links"
+            },
+            "error": None
+        }
+        return transmission_info
+    except Exception as e:
+        return {"success": False, "result": None, "error": f"Failed to get transmission info: {str(e)}"}
+
+# ============================================================================
+# NETWORK CLUSTERING/AGGREGATION TOOLS
+# ============================================================================
+
+@mcp.tool(
+    name="cluster_network_by_kmeans",
+    description="Cluster network buses using k-means algorithm"
+)
+def tool_cluster_network_by_kmeans(file_path: str, clusters_count: int = 5) -> dict:
+    """
+    Cluster network buses using k-means algorithm for network reduction.
+
+    Parameters:
+    - file_path (str): Path to the network file
+    - clusters_count (int): Number of clusters to create
+
+    Returns:
+    - dict: Clustering results and mapping
+    """
+    try:
+        network = Network(file_path)
+        
+        # Use PyPSA's clustering accessor
+        busmap = network.clustering.busmap_by_kmeans(clusters_count)
+        
+        return {
+            "success": True,
+            "result": {
+                "original_buses_count": len(network.buses),
+                "target_clusters": clusters_count,
+                "created_clusters": len(busmap.unique()),
+                "clustering_method": "k-means",
+                "buses_per_cluster_avg": round(len(network.buses) / clusters_count, 2),
+                "description": f"Network reduced from {len(network.buses)} buses to {len(busmap.unique())} clusters using k-means"
+            },
+            "error": None
+        }
+    except Exception as e:
+        return {"success": False, "result": None, "error": f"Clustering failed: {str(e)}"}
+
+# ============================================================================
+# NETWORK EXPORT TOOLS
+# ============================================================================
+
+@mcp.tool(
+    name="export_network_summary",
+    description="Export a detailed summary of the network to JSON"
+)
+def tool_export_network_summary(file_path: str, output_file: str = None) -> dict:
+    """
+    Export a comprehensive network summary to JSON format.
+
+    Parameters:
+    - file_path (str): Path to the network file
+    - output_file (str): Optional path to save JSON summary (if None, returns inline)
+
+    Returns:
+    - dict: Network summary data
+    """
+    try:
+        network = Network(file_path)
+        
+        summary = {
+            "network_name": network.name,
+            "pypsa_version": network._pypsa_version,
+            "statistics": {
+                "snapshots": len(network.snapshots),
+                "buses": len(network.buses),
+                "generators": len(network.generators),
+                "loads": len(network.loads),
+                "storage_units": len(network.storage_units),
+                "stores": len(network.stores),
+                "lines": len(network.lines),
+                "links": len(network.links),
+                "transformers": len(network.transformers)
+            },
+            "capacity": {
+                "generator_capacity_mw": round(network.generators.p_nom.sum(), 2) if len(network.generators) > 0 else 0,
+                "storage_capacity_mwh": round(network.storage_units.e_nom.sum(), 2) if len(network.storage_units) > 0 else 0,
+                "transmission_capacity_mva": round(network.lines.s_nom.sum(), 2) if len(network.lines) > 0 else 0
+            },
+            "carriers": list(network.carriers.index) if len(network.carriers) > 0 else [],
+            "objective": float(network.objective) if hasattr(network, 'objective') else None
+        }
+        
+        if output_file:
+            with open(output_file, 'w') as f:
+                json.dump(summary, f, indent=2)
+            return {
+                "success": True,
+                "result": {
+                    "summary_saved": True,
+                    "output_file": str(output_file),
+                    "description": f"Network summary exported to {output_file}"
+                },
+                "error": None
+            }
+        else:
+            return {
+                "success": True,
+                "result": summary,
+                "error": None
+            }
+    except Exception as e:
+        return {"success": False, "result": None, "error": f"Export failed: {str(e)}"}
+
+# ============================================================================
+# APP CREATION
+# ============================================================================
+
+def create_app() -> FastMCP:
+    """
+    Create and return the FastMCP application instance.
+
+    Features:
+    - Network loading and saving (NetCDF, HDF5, CSV)
+    - Optimization with LOPF
+    - Network statistics and analysis
+    - Component information extraction
+    - Network clustering and reduction
+    - Comprehensive export capabilities
+
+    Returns:
+    - FastMCP: The configured FastMCP instance with 10+ PyPSA tools.
+    """
+    return mcp

PyPSA/mcp_output/requirements.txt

@@ -0,0 +1,9 @@
+fastmcp>=0.1.0
+pydantic>=2.0.0
+numpy
+pandas
+matplotlib
+
+# Optional Dependencies
+# geopandas
+# plotly

PyPSA/mcp_output/simple_revise_error_analysis.json

@@ -0,0 +1,6 @@
+{
+  "status": "FAIL",
+  "next_action": "fix_directly",
+  "confidence": 0.9,
+  "summary": "The error is due to a missing Python module 'pandas', which is required by the 'pypsa.clustering' module. This can be fixed directly by installing the 'pandas' package in the conda environment being used. Run 'conda install pandas' to resolve the issue. Additionally, ensure that the conda environment is activated correctly before running the script."
+}

PyPSA/mcp_output/start_mcp.py

@@ -0,0 +1,33 @@
+"""
+MCP Service Startup Entry
+"""
+import sys
+import os
+
+project_root = os.path.dirname(os.path.abspath(__file__))
+mcp_plugin_dir = os.path.join(project_root, "mcp_plugin")
+if mcp_plugin_dir not in sys.path:
+    sys.path.insert(0, mcp_plugin_dir)
+
+# Set path to source directory
+source_path = os.path.join(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))), "source")
+sys.path.insert(0, source_path)
+
+from mcp_plugin.mcp_service import create_app
+
+def main():
+    """Start FastMCP service"""
+    app = create_app()
+    # Use environment variable to configure port, default 8000
+    port = int(os.environ.get("MCP_PORT", "8000"))
+    
+    # Choose transport mode based on environment variable
+    transport = os.environ.get("MCP_TRANSPORT", "stdio")
+    if transport == "http":
+        app.run(transport="http", host="0.0.0.0", port=port)
+    else:
+        # Default to STDIO mode
+        app.run()
+
+if __name__ == "__main__":
+    main()

PyPSA/mcp_output/tests_mcp/test_mcp_basic.py

@@ -0,0 +1,49 @@
+"""
+MCP Service Basic Test
+"""
+import sys
+import os
+
+project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+mcp_plugin_dir = os.path.join(project_root, "mcp_plugin")
+if mcp_plugin_dir not in sys.path:
+    sys.path.insert(0, mcp_plugin_dir)
+
+source_path = os.path.join(os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__)))), "source")
+sys.path.insert(0, source_path)
+
+def test_import_mcp_service():
+    """Test if MCP service can be imported normally"""
+    try:
+        from mcp_service import create_app
+        app = create_app()
+        assert app is not None
+        print("MCP service imported successfully")
+        return True
+    except Exception as e:
+        print("MCP service import failed: " + str(e))
+        return False
+
+def test_adapter_init():
+    """Test if adapter can be initialized normally"""
+    try:
+        from adapter import Adapter
+        adapter = Adapter()
+        assert adapter is not None
+        print("Adapter initialized successfully")
+        return True
+    except Exception as e:
+        print("Adapter initialization failed: " + str(e))
+        return False
+
+if __name__ == "__main__":
+    print("Running MCP service basic test...")
+    test1 = test_import_mcp_service()
+    test2 = test_adapter_init()
+    
+    if test1 and test2:
+        print("All basic tests passed")
+        sys.exit(0)
+    else:
+        print("Some tests failed")
+        sys.exit(1)

PyPSA/mcp_output/tests_smoke/test_smoke.py

@@ -0,0 +1,29 @@
+import importlib, sys
+import os
+
+# Add current directory to Python path
+sys.path.insert(0, os.getcwd())
+
+source_dir = os.path.join(os.getcwd(), "source")
+if os.path.exists(source_dir):
+    sys.path.insert(0, source_dir)
+
+
+try:
+    importlib.import_module("pypsa")
+    print("OK - Successfully imported pypsa")
+except ImportError as e:
+    print(f"Failed to import pypsa: {e}")
+    fallback_packages = []
+
+    fallback_packages = ['pypsa']
+
+    for pkg in fallback_packages:
+        try:
+            importlib.import_module(pkg)
+            print(f"OK - Successfully imported {pkg}")
+            break
+        except ImportError:
+            continue
+    else:
+        print("All import attempts failed")

PyPSA/source/.codespell.ignore

@@ -0,0 +1,9 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+ines
+psace
+datas
+fom
+esy

PyPSA/source/.git-blame-ignore-revs

@@ -0,0 +1,6 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+# apply pre-commit setup to all files (including black)
+57099450d1df78f9d3571f4515721aa04613d456

PyPSA/source/.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -0,0 +1,73 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+name: Bug Report
+description: Create a report if something doesn't work quite right.
+labels: ["needs triage"]
+type: "Bug"
+
+body:
+- type: markdown
+  attributes:
+    value: |
+      Thanks for taking the time to fill out this bug report!
+      Please do not post usage questions here. Ask them on the [PyPSA Discord server](https://discord.gg/AnuJBk23FU).
+
+- type: checkboxes
+  id: checks
+  attributes:
+    label: Version Checks (indicate both or one)
+    options:
+    - label: >
+        I have confirmed this bug exists on the lastest
+        [release](https://github.com/pypsa/pypsa/releases) of PyPSA.
+    - label: >
+        I have confirmed this bug exists on the current
+        [`master`](https://github.com/pypsa/pypsa/tree/master) branch of PyPSA.
+
+- type: textarea
+  id: problem
+  attributes:
+    label: Issue Description
+    description: >
+      Please provide a description of the issue.
+  validations:
+    required: true
+
+- type: textarea
+  id: example
+  validations:
+    required: true
+  attributes:
+    label: Reproducible Example
+    description: >
+      Please provide a minimal reproduciable example. See how to [craft minimal bug reports](https://matthewrocklin.com/minimal-bug-reports).
+    placeholder: >
+      import pypsa
+
+      n = pypsa.Network()
+
+    render: python
+
+- type: textarea
+  id: expected-behavior
+  validations:
+    required: true
+  attributes:
+    label: Expected Behavior
+    description: >
+      Please describe or show a code example of the expected behavior.
+
+- type: textarea
+  id: version
+  attributes:
+    label: Installed Versions
+    description: >
+      Please share information on your environment. Paste the output below.  For conda `conda env export` and for pip `pip freeze`.
+    value: >
+      <details>
+
+      Replace this line.
+
+      </details>

PyPSA/source/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,9 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+blank_issues_enabled: true
+contact_links:
+- name: PyPSA Discord server
+  url: https://discord.gg/AnuJBk23FU
+  about: Please ask and answer general usage questions here.

PyPSA/source/.github/ISSUE_TEMPLATE/documentation_improvement.yaml

@@ -0,0 +1,26 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+name: Documentation Improvement
+description: Report wrong or missing documentation
+labels: ["needs triage"]
+type: 'Docs'
+
+body:
+- type: textarea
+  id: location
+  attributes:
+    label: Location
+    description: >
+      Please provide the location of the documentation or docstring, e.g. `pypsa.Network.import_from_netcdf` or the link to the docs.
+    placeholder: https://docs.pypsa.org/latest/user-guide/linear-power-flow
+    required: true
+- type: textarea
+  id: problem
+  attributes:
+    label: Documentation problem
+    description: >
+      Please provide a description of what you believe needs to be fixed/ improved/ explained.
+  validations:
+    required: true

PyPSA/source/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,16 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: ''
+labels: ["needs triage"]
+type: 'Feature'
+assignees: ''
+
+---
+
+<!-- Please do not post usage questions here. Ask them on the PyPSA Discord server: https://discord.gg/AnuJBk23FU -->
+
+## Describe the feature you'd like to see
+
+*Please give a clear and concise description and provide context why the feature would be useful.*
+*Also, we'd appreciate any implementation ideas and references you already have.*

PyPSA/source/.github/dependabot.yml

@@ -0,0 +1,18 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+# dependabot
+# Ref: https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+# ------------------------------------------------------------------------------
+version: 2
+updates:
+- package-ecosystem: github-actions
+  directory: /
+  schedule:
+    interval: monthly
+  groups:
+    # open a single pull-request for all GitHub actions updates
+    github-actions:
+      patterns:
+      - '*'

PyPSA/source/.github/pull_request_template.md

@@ -0,0 +1,11 @@
+Closes # (if applicable).
+
+## Changes proposed in this Pull Request
+
+
+## Checklist
+
+- [ ] Code changes are sufficiently documented; i.e. new functions contain docstrings and further explanations may be given in `docs`.
+- [ ] Unit tests for new features were added (if applicable).
+- [ ] A note for the release notes `docs/release-notes.md` of the upcoming release is included.
+- [ ] I consent to the release of this PR's code under the MIT license.

PyPSA/source/.github/workflows/codeql.yml

@@ -0,0 +1,96 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: ["master"]
+  pull_request:
+    branches: ["master"]
+  schedule:
+  - cron: '36 6 * * 4'
+
+jobs:
+  analyze:
+    name: Analyze (${{ matrix.language }})
+    # Runner size impacts CodeQL analysis time. To learn more, please see:
+    #   - https://gh.io/recommended-hardware-resources-for-running-codeql
+    #   - https://gh.io/supported-runners-and-hardware-resources
+    #   - https://gh.io/using-larger-runners (GitHub.com only)
+    # Consider using larger runners or machines with greater resources for possible analysis time improvements.
+    runs-on: ${{ (matrix.language == 'swift' && 'macos-latest') || 'ubuntu-latest' }}
+    permissions:
+      # required for all workflows
+      security-events: write
+
+      # required to fetch internal or private CodeQL packs
+      packages: read
+
+      # only required for workflows in private repositories
+      actions: read
+      contents: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+        - language: python
+          build-mode: none
+        # CodeQL supports the following values keywords for 'language': 'c-cpp', 'csharp', 'go', 'java-kotlin', 'javascript-typescript', 'python', 'ruby', 'swift'
+        # Use `c-cpp` to analyze code written in C, C++ or both
+        # Use 'java-kotlin' to analyze code written in Java, Kotlin or both
+        # Use 'javascript-typescript' to analyze code written in JavaScript, TypeScript or both
+        # To learn more about changing the languages that are analyzed or customizing the build mode for your analysis,
+        # see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning.
+        # If you are analyzing a compiled language, you can modify the 'build-mode' for that language to customize how
+        # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v5
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v4
+      with:
+        languages: ${{ matrix.language }}
+        build-mode: ${{ matrix.build-mode }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+
+        # For more details on CodeQL's query packs, refer to: https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+        # queries: security-extended,security-and-quality
+
+    # If the analyze step fails for one of the languages you are analyzing with
+    # "We were unable to automatically build your code", modify the matrix above
+    # to set the build mode to "manual" for that language. Then modify this step
+    # to build your code.
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+    - if: matrix.build-mode == 'manual'
+      shell: bash
+      run: |
+        echo 'If you are using a "manual" build mode for one or more of the' \
+          'languages you are analyzing, replace this with the commands to build' \
+          'your code, for example:'
+        echo '  make bootstrap'
+        echo '  make release'
+        exit 1
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v4
+      with:
+        category: "/language:${{matrix.language}}"

PyPSA/source/.github/workflows/release.yml

@@ -0,0 +1,174 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+name: Release
+
+on:
+  push:
+    tags:
+    - v*.*.*
+
+env:
+  PREPARATION_COMMIT: '[github-actions.ci] prepare release ${{ github.ref_name }}'
+
+jobs:
+  check-preparation:
+    name: Check if release is prepared
+    runs-on: ubuntu-latest
+    outputs:
+      prepared: ${{ steps.validate.outputs.prepared }}
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Validate commit message
+      id: validate
+      run: |
+        # Check if last commit is the expected commit message
+        COMMIT_MESSAGE=$(git log -1 --pretty=%B)
+        echo "Expected: '${{ env.PREPARATION_COMMIT }}'"
+        echo "Received: '$COMMIT_MESSAGE'"
+
+        prepared="false"
+        if [[ "$COMMIT_MESSAGE" == "${{ env.PREPARATION_COMMIT }}" ]]; then
+          prepared="true"
+        fi
+
+        echo "prepared=$prepared" >> $GITHUB_OUTPUT
+
+  prepare-release:
+    name: Prepare release
+    needs: [check-preparation]
+    if: ${{ needs.check-preparation.outputs.prepared == 'false' }}
+    runs-on: ubuntu-latest
+    steps:
+    - name: Generate token for PyPSA Bot
+      id: generate-token
+      uses: actions/create-github-app-token@v2
+      with:
+        app-id: ${{ vars.PYPSA_BOT_ID }}
+        private-key: ${{ secrets.PYPSA_BOT_PRIVATE_KEY }}
+
+    - uses: actions/checkout@v5
+      with:
+        fetch-depth: 0
+
+    - name: Find the branch for commit/ tag
+      run: |
+        branch=$(git branch -r --contains ${{ github.sha }} | grep -v 'HEAD' | head -n 1 | sed 's|origin/||' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+        echo "Branch found: $branch"
+        echo "BRANCH_NAME=$branch" >> $GITHUB_ENV
+
+    - uses: actions/checkout@v5
+      with:
+        fetch-depth: 0
+        ref: ${{ env.BRANCH_NAME }}
+        token: ${{ steps.generate-token.outputs.token }}
+
+    # Start of preparation script
+
+    - uses: actions/setup-python@v6
+      with:
+        python-version: 3.12
+
+    - name: Install packages
+      run: |
+        python -m pip install uv
+        uv pip install --system toml
+        uv pip install --system setuptools_scm
+        uv pip install --system .
+
+    - name: Update CITATION.cff
+      run: |
+        import re
+        from setuptools_scm import get_version
+
+        version = get_version()
+
+        with open('CITATION.cff', 'r') as file:
+          cff_content = file.read()
+        cff_content = open('CITATION.cff', 'r').read()
+
+        updated_cff_content = re.sub(r"(?<=version: ).+(?= #)",version,cff_content,flags=re.MULTILINE)
+
+        with open('CITATION.cff', 'w') as file:
+          file.write(updated_cff_content)
+      shell: python
+
+    - name: Update example notebooks
+      run: |
+        import pypsa
+        # ac-dc-meshed
+        n = pypsa.Network("examples/networks/ac-dc-meshed/ac-dc-meshed")
+        n.export_to_csv_folder("examples/networks/ac-dc-meshed/ac-dc-meshed")
+        n.export_to_netcdf("examples/networks/ac-dc-meshed/ac-dc-meshed.nc")
+        # storage-hvdc
+        n = pypsa.Network("examples/networks/storage-hvdc/storage-hvdc")
+        n.export_to_csv_folder("examples/networks/storage-hvdc/storage-hvdc")
+        n.export_to_netcdf("examples/networks/storage-hvdc/storage-hvdc.nc")
+        # scigrid-de
+        n = pypsa.Network("examples/networks/scigrid-de/scigrid-de")
+        n.export_to_csv_folder("examples/networks/scigrid-de/scigrid-de")
+        n.export_to_netcdf("examples/networks/scigrid-de/scigrid-de.nc")
+        # model-energy
+        n = pypsa.Network("examples/networks/model-energy/model-energy")
+        n.export_to_csv_folder("examples/networks/model-energy/model-energy")
+        n.export_to_netcdf("examples/networks/model-energy/model-energy.nc")
+        # stochastic-network
+        n = pypsa.Network("examples/networks/stochastic-network/stochastic-network.nc")
+        n.export_to_netcdf("examples/networks/stochastic-network/stochastic-network.nc")
+      shell: python
+
+    # End of preparation script
+
+    - name: Remove previous tag
+      run: |
+        git tag -d ${{ github.ref_name }}
+        git push origin --delete ${{ github.ref_name }}
+
+    - name: Commit changes
+      uses: stefanzweifel/git-auto-commit-action@v7
+      with:
+        branch: ${{ env.BRANCH_NAME }}
+        commit_message: '${{ env.PREPARATION_COMMIT }}'
+        tagging_message: '${{ github.ref_name }}' # add tag again
+        push_options: '${{ github.ref_name }}'
+        add_options: '-u' # Never add untracked files
+
+  build:
+    name: Build and verify package
+    needs: [check-preparation]
+    if: ${{ needs.check-preparation.outputs.prepared == 'true' }}
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5
+    - uses: hynek/build-and-inspect-python-package@v2
+
+  release:
+    name: Create GitHub release
+    needs: [build]
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5
+    - uses: softprops/action-gh-release@v2
+      with:
+        body: |
+          Revised release notes are available in the [documentation](https://${{ github.event.repository.name }}.readthedocs.io/en/latest/release-notes.html).
+        append_body: true
+        generate_release_notes: true
+
+  publish:
+    name: Publish to PyPI
+    needs: [build]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/${{ github.event.repository.name }}
+    permissions:
+      id-token: write
+    steps:
+    - uses: actions/download-artifact@v6
+      with:
+        name: Packages
+        path: dist
+    - uses: pypa/gh-action-pypi-publish@release/v1

PyPSA/source/.github/workflows/test-models.yml

@@ -0,0 +1,206 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+name: Test models
+
+on:
+  push:
+    branches:
+    - master
+    - release-branch-v*
+  pull_request:
+    branches: ['*']
+  schedule:
+  - cron: "0 5 * * *"
+
+env:
+  PACKAGE_NAME: 'pypsa'
+
+# Cancel any in-progress runs when a new run is triggered
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test-pypsa-eur:
+    name: PyPSA-Eur
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        version:
+        - master
+        # - latest
+
+    defaults:
+      run:
+        shell: bash -l {0}
+
+    steps:
+    - uses: actions/checkout@v5
+      with:
+        repository: PyPSA/pypsa-eur
+        ref: master
+
+    - name: Check out latest release
+      if: matrix.version == 'latest'
+      run: |
+        git fetch --tags
+        latest_tag=$(git describe --tags `git rev-list --tags --max-count=1`)
+        git checkout $latest_tag
+
+    - name: Setup Pixi
+      uses: prefix-dev/setup-pixi@v0.9.3
+      with:
+        pixi-version: v0.59.0
+        cache: true
+        # Do not cache in branches
+        cache-write: ${{ github.event_name == 'push' && github.ref_name == 'main' }}
+
+    - name: Setup cache keys
+      run: |
+        echo "WEEK=$(date +'%Y%U')" >> $GITHUB_ENV # data and cutouts
+
+    # Only run check if package is not pinned
+    - name: Check if inhouse package is pinned
+      run: |
+        grep_line=$(grep -- '- pypsa' envs/environment.yaml)
+        if [[ $grep_line == *"<"* || $grep_line == *"=="* ]]; then
+            echo "pinned=true" >> $GITHUB_ENV
+        else
+            echo "pinned=false" >> $GITHUB_ENV
+        fi
+
+    - uses: actions/cache@v4
+      if: env.pinned == 'false'
+      with:
+        path: |
+          data
+          cutouts
+        key: data-cutouts-pypsa-eur-${{ env.WEEK }}
+
+    - name: Install package from ref
+      if: env.pinned == 'false'
+      run: |
+        pixi remove ${{ env.PACKAGE_NAME }}
+        pixi add --pypi --git https://github.com/${{ github.repository }}.git ${{ github.event.repository.name }} --rev ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+
+    - name: Run snakemake test workflows
+      if: env.pinned == 'false'
+      run: |
+        pixi run integration-tests
+
+    - name: Run unit tests
+      if: env.pinned == 'false'
+      run: |
+        pixi run unit-tests
+
+    - name: Upload artifacts
+      if: env.pinned == 'false'
+      uses: actions/upload-artifact@v5
+      with:
+        name: results-pypsa-eur-${{ matrix.version }}
+        path: |
+          logs
+          .snakemake/log
+          results
+        retention-days: 3
+
+# Temporarily disabled until PyPSA-DE issues are resolved. This is not a problem of PyPSA.
+  # test-pypsa-de:
+  #   name: PyPSA-DE
+  #   runs-on: ubuntu-latest
+  #   strategy:
+  #     fail-fast: false
+  #     matrix:
+  #       version:
+  #       - master
+  #       # - latest
+
+  #   defaults:
+  #     run:
+  #       shell: bash -l {0}
+
+  #   steps:
+  #   - uses: actions/checkout@v5
+  #     with:
+  #       repository: PyPSA/pypsa-de
+  #       ref: main
+
+  #   - name: Check out latest release
+  #     if: matrix.version == 'latest'
+  #     run: |
+  #       git fetch --tags
+  #       latest_tag=$(git describe --tags `git rev-list --tags --max-count=1`)
+  #       git checkout $latest_tag
+
+  #   - name: Setup cache keys
+  #     run: |
+  #       echo "WEEK=$(date +'%Y%U')" >> $GITHUB_ENV # data and cutouts
+
+  #   # Only run check if package is not pinned
+  #   - name: Check if inhouse package is pinned
+  #     run: |
+  #       grep_line=$(grep -- '- pypsa' envs/environment.yaml)
+  #       if [[ $grep_line == *"<"* || $grep_line == *"=="* ]]; then
+  #           echo "pinned=true" >> $GITHUB_ENV
+  #       else
+  #           echo "pinned=false" >> $GITHUB_ENV
+  #       fi
+
+  #   - uses: actions/cache@v4
+  #     if: env.pinned == 'false'
+  #     with:
+  #       path: |
+  #         data
+  #         cutouts
+  #         resources/ariadne_database.csv
+  #       key: data-cutouts-pypsa-de-${{ env.WEEK }}
+
+  #   - uses: conda-incubator/setup-miniconda@v3
+  #     if: env.pinned == 'false'
+  #     with:
+  #       miniforge-version: latest
+  #       activate-environment: pypsa-de
+  #       channel-priority: strict
+
+  #   - name: Cache Conda env
+  #     if: env.pinned == 'false'
+  #     uses: actions/cache@v4
+  #     with:
+  #       path: ${{ env.CONDA }}/envs
+  #       key: conda-pypsa-de-${{ env.WEEK }}-${{ hashFiles('envs/linux-64.lock.yaml') }}
+  #     id: cache-env
+
+  #   - name: Update environment
+  #     if: env.pinned == 'false' && steps.cache-env.outputs.cache-hit != 'true'
+  #     run: |
+  #       conda env update -n pypsa-de -f envs/linux-64.lock.yaml
+  #       echo "Run conda list" && conda list
+
+  #   - name: Install package from ref
+  #     if: env.pinned == 'false'
+  #     run: |
+  #       python -m pip install git+https://github.com/${{ github.repository }}@${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+
+  #   - name: Run snakemake test workflows
+  #     if: env.pinned == 'false'
+  #     run: |
+  #       make test
+
+  #   - name: Run unit tests
+  #     if: env.pinned == 'false'
+  #     run: |
+  #       make unit-test
+
+  #   - name: Upload artifacts
+  #     if: env.pinned == 'false'
+  #     uses: actions/upload-artifact@v5
+  #     with:
+  #       name: results-pypsa-de-${{ matrix.version }}
+  #       path: |
+  #         logs
+  #         .snakemake/log
+  #         results
+  #       retention-days: 3

PyPSA/source/.github/workflows/test.yml

@@ -0,0 +1,223 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+name: Tests
+
+on:
+  push:
+    branches:
+    - master
+    - release-branch-v*
+  pull_request:
+    branches: ["*"]
+  schedule:
+  - cron: "0 5 * * *"
+
+# Cancel any in-progress runs when a new run is triggered
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    # Build the Python SDist and wheel, performs metadata and readme linting
+    name: Build and verify package
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5
+      with:
+        fetch-depth: 0   # Needed for setuptools_scm
+    - uses: hynek/build-and-inspect-python-package@v2
+      id: baipp
+
+    outputs:
+      python-versions: ${{ steps.baipp.outputs.supported_python_classifiers_json_array }}
+
+  test:
+    # Test package build in matrix of OS and Python versions
+    name: Test package
+    needs: [build]
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ${{ fromJSON(needs.build.outputs.python-versions) }}
+        os:
+        - ubuntu-latest
+        - macos-latest
+        - windows-latest
+        api: [default, new_api]
+        exclude:
+        - os: macos-latest
+          api: new_api
+        - os: windows-latest
+          api: new_api
+
+    env:
+      MPLBACKEND: Agg # https://github.com/orgs/community/discussions/26434
+    steps:
+    - uses: actions/checkout@v5
+      with:
+        fetch-depth: 0   # Needed for setuptools_scm
+
+    - name: Set up Python ${{ matrix.python-version }} on ${{ matrix.os }}
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install macos dependencies
+      if: matrix.os == 'macos-latest'
+      run: |
+        brew update
+        # pkg-config is deprecated but still installed in runner
+        # Can be removed once it is removed from the runner
+        brew unlink pkg-config@0.29.2 || true
+        brew install hdf5
+
+    - name: Download package
+      uses: actions/download-artifact@v6
+      with:
+        name: Packages
+        path: dist
+
+    - name: Install package and dependencies
+      run: |
+        python -m pip install uv
+        uv sync --all-extras --no-install-project
+        uv pip install "$(ls dist/*.whl)"
+
+    - name: Run unit tests (old API)
+      if: matrix.api == 'default'
+      run: >
+        uv run pytest  --mpl --mpl-generate-summary=html --mpl-results-path=mpl-results
+        --cov=pypsa --junitxml=junit.xml -o junit_family=legacy
+        && uv run coverage xml
+
+    - name: Run unit tests (new API)
+      if: matrix.api == 'new_api'
+      run: >
+        uv run pytest
+        --new-components-api
+        --mpl --mpl-generate-summary=html --mpl-results-path=mpl-results
+        --cov=pypsa --junitxml=junit.xml -o junit_family=legacy
+        && uv run coverage xml
+
+    - name: Upload artifacts
+      if: matrix.api == 'default' && matrix.os == 'macos-latest' && matrix.python-version == '3.13'
+      uses: actions/upload-artifact@v5
+      with:
+        name: results-plotting
+        path: |
+          mpl-results
+        retention-days: 14
+        if-no-files-found: ignore
+
+    - name: Upload code coverage report
+      if: ${{ !cancelled() }}
+      uses: codecov/codecov-action@v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        flags: >
+          unit-tests,
+          os-${{ matrix.os }},
+          python${{ matrix.python-version }},
+          api-${{ matrix.api }}
+
+    - name: Upload test results to Codecov
+      if: ${{ !cancelled() }}
+      uses: codecov/test-results-action@v1
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        flags: >
+          unit-tests,
+          os-${{ matrix.os }},
+          python${{ matrix.python-version }},
+          api-${{ matrix.api }}
+
+  check-docs:
+    name: Check docs
+    needs: [build]
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v5
+      with:
+        fetch-depth: 0   # Needed for setuptools_scm
+
+    - name: Set up Python 3.13
+      uses: actions/setup-python@v6
+      with:
+        python-version: 3.13
+
+    - name: Download package
+      uses: actions/download-artifact@v6
+      with:
+        name: Packages
+        path: dist
+
+    - name: Install package and dependencies
+      run: |
+        python -m pip install uv
+        uv sync --all-extras --no-install-project
+        uv pip install "$(ls dist/*.whl)"
+
+    - name: Run doc tests
+      run: >
+        uv run pytest
+        test/test_docs.py --test-docs
+        --cov=pypsa --junitxml=junit.xml -o junit_family=legacy
+        && uv run coverage xml
+
+    - name: Upload code coverage report
+      if: ${{ !cancelled() }}
+      uses: codecov/codecov-action@v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        flags: >
+          doc-tests,
+          os-ubuntu-latest,
+          python3.13,
+          api-old-api
+
+    - name: Upload test results to Codecov
+      if: ${{ !cancelled() }}
+      uses: codecov/test-results-action@v1
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        flags: >
+          doc-tests,
+          os-ubuntu-latest,
+          python3.13,
+          api-old-api
+
+  check-types:
+    name: Check types
+    needs: [build]
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v5
+      with:
+        fetch-depth: 0   # Needed for setuptools_scm
+
+    - name: Set up Python 3.13
+      uses: actions/setup-python@v6
+      with:
+        python-version: 3.13
+
+    - name: Download package
+      uses: actions/download-artifact@v6
+      with:
+        name: Packages
+        path: dist
+
+    - name: Install package and dependencies
+      run: |
+        python -m pip install uv
+        uv sync --all-extras --no-install-project
+        uv pip install "$(ls dist/*.whl)"
+
+    - name: Run type checker (mypy)
+      run: |
+        uv run mypy .

PyPSA/source/.gitignore

@@ -0,0 +1,54 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+*~
+.~*
+*.py[cod]
+.ipynb_checkpoints/
+*.log
+old/
+
+# Ignore all jupyter notebooks, except those for the docs
+*.ipynb
+!/docs/**/*.ipynb
+
+
+test/.cache/
+.cache/
+
+test/results/*
+
+pypsa.egg-info/
+
+files.txt
+
+tom_notes.org
+
+*.pdf
+
+*.aux
+
+website/examples/*.py
+
+*.zip
+
+.vscode
+.devcontainer
+.github/copilot-instructions.md
+
+.idea
+
+.coverage
+
+dev-scripts
+dev
+
+.venv
+uv.lock
+.aider*
+CLAUDE.md
+.claude
+.github/copilot-instructions.md
+site/
+doc/_build/

PyPSA/source/.pre-commit-config.yaml

@@ -0,0 +1,58 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+exclude: ^(docs/hooks|examples)
+
+ci:
+  autoupdate_schedule: quarterly
+
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v6.0.0
+  hooks:
+  - id: check-added-large-files
+    args: ['--maxkb=2000']
+  - id: trailing-whitespace
+  - id: end-of-file-fixer
+
+# Run ruff to lint and format
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  # Ruff version.
+  rev: v0.13.3
+  hooks:
+    # Run the linter.
+  - id: ruff
+    args: [--fix]
+    # Run the formatter.
+  - id: ruff-format
+
+# Find common spelling mistakes in comments and docstrings
+- repo: https://github.com/codespell-project/codespell
+  rev: v2.4.1
+  hooks:
+  - id: codespell
+    # Ignore capital case words, e.g. country codes
+    args: ['--ignore-regex="(\b[A-Z]+\b)"', '--ignore-words=.codespell.ignore']
+    types_or: [python, rst, markdown]
+    files: ^(scripts|doc)/
+
+# Remove output from Jupyter notebooks
+- repo: https://github.com/aflc/pre-commit-jupyter
+  rev: v1.2.1
+  hooks:
+  - id: jupyter-notebook-cleanup
+    args: ['--remove-kernel-metadata']
+
+# Do YAML formatting (before the linter checks it for misses)
+- repo: https://github.com/macisamuele/language-formatters-pre-commit-hooks
+  rev: v2.15.0
+  hooks:
+  - id: pretty-format-yaml
+    args: [--autofix, --indent, '2', --preserve-quotes]
+
+# Check for FSFE REUSE compliance (licensing)
+- repo: https://github.com/fsfe/reuse-tool
+  rev: v6.0.0
+  hooks:
+  - id: reuse-lint-file

PyPSA/source/.readthedocs.yml

@@ -0,0 +1,28 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.13"
+  jobs:
+    pre_system_dependencies:
+    - git fetch --unshallow   # Needed to get version tags
+    pre_create_environment:
+    - asdf plugin add uv
+    - asdf install uv latest
+    - asdf global uv latest
+    create_environment:
+    - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
+    install:
+    - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv pip install -r docs/requirements.txt
+    pre_build:
+      # To create all doctest files
+    - uv run pytest test/test_docs.py --test-docs
+
+mkdocs:
+  configuration: mkdocs.yml
+  fail_on_warning: true

PyPSA/source/CITATION.cff

@@ -0,0 +1,22 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+cff-version: 1.2.0
+message: "If you use this package, please cite the corresponding manuscript in Journal of Open Research Software."
+title: "PyPSA: Python for Power System Analysis"
+repository: https://github.com/pypsa/pypsa
+version: 1.0.3 # Don't touch, will be updated by the release script
+license: MIT
+journal: Journal of Open Research Software
+doi: 10.5334/jors.188
+authors:
+  - family-names: Brown
+    given-names: Tom
+    orcid: https://orcid.org/0000-0001-5898-1911
+  - family-names: Hörsch
+    given-names: Jonas
+    orcid: https://orcid.org/0000-0001-9438-767X
+  - family-names: Schlachtberger
+    given-names: David
+    orcid: https://orcid.org/0000-0002-8167-8213

PyPSA/source/CONTRIBUTING.md

@@ -0,0 +1,11 @@
+<!--
+SPDX-FileCopyrightText: PyPSA Contributors
+
+SPDX-License-Identifier: MIT
+-->
+
+🎉 Thank you for your interest in contributing to PyPSA! 🎉
+
+We strongly welcome anyone interested in contributing to PyPSA and it's related projects. All types of contributions are encouraged and valued!
+
+Detailed guidelines can be found in the [Contributing](https://docs.pypsa.org/latest/contributing/contributing/) section of our documentation.

PyPSA/source/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) <year> <copyright holders>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

PyPSA/source/LICENSES/CC-BY-4.0.txt

@@ -0,0 +1,156 @@
+Creative Commons Attribution 4.0 International
+
+ Creative Commons Corporation (“Creative Commons”) is not a law firm and does not provide legal services or legal advice. Distribution of Creative Commons public licenses does not create a lawyer-client or other relationship. Creative Commons makes its licenses and related information available on an “as-is” basis. Creative Commons gives no warranties regarding its licenses, any material licensed under their terms and conditions, or any related information. Creative Commons disclaims all liability for damages resulting from their use to the fullest extent possible.
+
+Using Creative Commons Public Licenses
+
+Creative Commons public licenses provide a standard set of terms and conditions that creators and other rights holders may use to share original works of authorship and other material subject to copyright and certain other rights specified in the public license below. The following considerations are for informational purposes only, are not exhaustive, and do not form part of our licenses.
+
+Considerations for licensors: Our public licenses are intended for use by those authorized to give the public permission to use material in ways otherwise restricted by copyright and certain other rights. Our licenses are irrevocable. Licensors should read and understand the terms and conditions of the license they choose before applying it. Licensors should also secure all rights necessary before applying our licenses so that the public can reuse the material as expected. Licensors should clearly mark any material not subject to the license. This includes other CC-licensed material, or material used under an exception or limitation to copyright. More considerations for licensors.
+
+Considerations for the public: By using one of our public licenses, a licensor grants the public permission to use the licensed material under specified terms and conditions. If the licensor’s permission is not necessary for any reason–for example, because of any applicable exception or limitation to copyright–then that use is not regulated by the license. Our licenses grant only permissions under copyright and certain other rights that a licensor has authority to grant. Use of the licensed material may still be restricted for other reasons, including because others have copyright or other rights in the material. A licensor may make special requests, such as asking that all changes be marked or described. Although not required by our licenses, you are encouraged to respect those requests where reasonable. More considerations for the public.
+
+Creative Commons Attribution 4.0 International Public License
+
+By exercising the Licensed Rights (defined below), You accept and agree to be bound by the terms and conditions of this Creative Commons Attribution 4.0 International Public License ("Public License"). To the extent this Public License may be interpreted as a contract, You are granted the Licensed Rights in consideration of Your acceptance of these terms and conditions, and the Licensor grants You such rights in consideration of benefits the Licensor receives from making the Licensed Material available under these terms and conditions.
+
+Section 1 – Definitions.
+
+     a.	Adapted Material means material subject to Copyright and Similar Rights that is derived from or based upon the Licensed Material and in which the Licensed Material is translated, altered, arranged, transformed, or otherwise modified in a manner requiring permission under the Copyright and Similar Rights held by the Licensor. For purposes of this Public License, where the Licensed Material is a musical work, performance, or sound recording, Adapted Material is always produced where the Licensed Material is synched in timed relation with a moving image.
+
+     b.	Adapter's License means the license You apply to Your Copyright and Similar Rights in Your contributions to Adapted Material in accordance with the terms and conditions of this Public License.
+
+     c.	Copyright and Similar Rights means copyright and/or similar rights closely related to copyright including, without limitation, performance, broadcast, sound recording, and Sui Generis Database Rights, without regard to how the rights are labeled or categorized. For purposes of this Public License, the rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.
+
+     d.	Effective Technological Measures means those measures that, in the absence of proper authority, may not be circumvented under laws fulfilling obligations under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996, and/or similar international agreements.
+
+     e.	Exceptions and Limitations means fair use, fair dealing, and/or any other exception or limitation to Copyright and Similar Rights that applies to Your use of the Licensed Material.
+
+     f.	Licensed Material means the artistic or literary work, database, or other material to which the Licensor applied this Public License.
+
+     g.	Licensed Rights means the rights granted to You subject to the terms and conditions of this Public License, which are limited to all Copyright and Similar Rights that apply to Your use of the Licensed Material and that the Licensor has authority to license.
+
+     h.	Licensor means the individual(s) or entity(ies) granting rights under this Public License.
+
+     i.	Share means to provide material to the public by any means or process that requires permission under the Licensed Rights, such as reproduction, public display, public performance, distribution, dissemination, communication, or importation, and to make material available to the public including in ways that members of the public may access the material from a place and at a time individually chosen by them.
+
+     j.	Sui Generis Database Rights means rights other than copyright resulting from Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, as amended and/or succeeded, as well as other essentially equivalent rights anywhere in the world.
+
+     k.	You means the individual or entity exercising the Licensed Rights under this Public License. Your has a corresponding meaning.
+
+Section 2 – Scope.
+
+     a.	License grant.
+
+          1. Subject to the terms and conditions of this Public License, the Licensor hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive, irrevocable license to exercise the Licensed Rights in the Licensed Material to:
+
+               A. reproduce and Share the Licensed Material, in whole or in part; and
+
+               B. produce, reproduce, and Share Adapted Material.
+
+          2. Exceptions and Limitations. For the avoidance of doubt, where Exceptions and Limitations apply to Your use, this Public License does not apply, and You do not need to comply with its terms and conditions.
+
+          3. Term. The term of this Public License is specified in Section 6(a).
+
+          4. Media and formats; technical modifications allowed. The Licensor authorizes You to exercise the Licensed Rights in all media and formats whether now known or hereafter created, and to make technical modifications necessary to do so. The Licensor waives and/or agrees not to assert any right or authority to forbid You from making technical modifications necessary to exercise the Licensed Rights, including technical modifications necessary to circumvent Effective Technological Measures. For purposes of this Public License, simply making modifications authorized by this Section 2(a)(4) never produces Adapted Material.
+
+          5. Downstream recipients.
+
+               A. Offer from the Licensor – Licensed Material. Every recipient of the Licensed Material automatically receives an offer from the Licensor to exercise the Licensed Rights under the terms and conditions of this Public License.
+
+               B. No downstream restrictions. You may not offer or impose any additional or different terms or conditions on, or apply any Effective Technological Measures to, the Licensed Material if doing so restricts exercise of the Licensed Rights by any recipient of the Licensed Material.
+
+          6.  No endorsement. Nothing in this Public License constitutes or may be construed as permission to assert or imply that You are, or that Your use of the Licensed Material is, connected with, or sponsored, endorsed, or granted official status by, the Licensor or others designated to receive attribution as provided in Section 3(a)(1)(A)(i).
+
+b. Other rights.
+
+          1. Moral rights, such as the right of integrity, are not licensed under this Public License, nor are publicity, privacy, and/or other similar personality rights; however, to the extent possible, the Licensor waives and/or agrees not to assert any such rights held by the Licensor to the limited extent necessary to allow You to exercise the Licensed Rights, but not otherwise.
+
+          2. Patent and trademark rights are not licensed under this Public License.
+
+          3. To the extent possible, the Licensor waives any right to collect royalties from You for the exercise of the Licensed Rights, whether directly or through a collecting society under any voluntary or waivable statutory or compulsory licensing scheme. In all other cases the Licensor expressly reserves any right to collect such royalties.
+
+Section 3 – License Conditions.
+
+Your exercise of the Licensed Rights is expressly made subject to the following conditions.
+
+     a.	Attribution.
+
+          1. If You Share the Licensed Material (including in modified form), You must:
+
+               A. retain the following if it is supplied by the Licensor with the Licensed Material:
+
+                    i. identification of the creator(s) of the Licensed Material and any others designated to receive attribution, in any reasonable manner requested by the Licensor (including by pseudonym if designated);
+
+                    ii. a copyright notice;
+
+                    iii. a notice that refers to this Public License;
+
+                    iv.	a notice that refers to the disclaimer of warranties;
+
+                    v. a URI or hyperlink to the Licensed Material to the extent reasonably practicable;
+
+               B. indicate if You modified the Licensed Material and retain an indication of any previous modifications; and
+
+               C. indicate the Licensed Material is licensed under this Public License, and include the text of, or the URI or hyperlink to, this Public License.
+
+          2. You may satisfy the conditions in Section 3(a)(1) in any reasonable manner based on the medium, means, and context in which You Share the Licensed Material. For example, it may be reasonable to satisfy the conditions by providing a URI or hyperlink to a resource that includes the required information.
+
+          3. If requested by the Licensor, You must remove any of the information required by Section 3(a)(1)(A) to the extent reasonably practicable.
+
+          4. If You Share Adapted Material You produce, the Adapter's License You apply must not prevent recipients of the Adapted Material from complying with this Public License.
+
+Section 4 – Sui Generis Database Rights.
+
+Where the Licensed Rights include Sui Generis Database Rights that apply to Your use of the Licensed Material:
+
+     a.	for the avoidance of doubt, Section 2(a)(1) grants You the right to extract, reuse, reproduce, and Share all or a substantial portion of the contents of the database;
+
+     b.	if You include all or a substantial portion of the database contents in a database in which You have Sui Generis Database Rights, then the database in which You have Sui Generis Database Rights (but not its individual contents) is Adapted Material; and
+
+     c.	You must comply with the conditions in Section 3(a) if You Share all or a substantial portion of the contents of the database.
+For the avoidance of doubt, this Section 4 supplements and does not replace Your obligations under this Public License where the Licensed Rights include other Copyright and Similar Rights.
+
+Section 5 – Disclaimer of Warranties and Limitation of Liability.
+
+     a.	Unless otherwise separately undertaken by the Licensor, to the extent possible, the Licensor offers the Licensed Material as-is and as-available, and makes no representations or warranties of any kind concerning the Licensed Material, whether express, implied, statutory, or other. This includes, without limitation, warranties of title, merchantability, fitness for a particular purpose, non-infringement, absence of latent or other defects, accuracy, or the presence or absence of errors, whether or not known or discoverable. Where disclaimers of warranties are not allowed in full or in part, this disclaimer may not apply to You.
+
+     b.	To the extent possible, in no event will the Licensor be liable to You on any legal theory (including, without limitation, negligence) or otherwise for any direct, special, indirect, incidental, consequential, punitive, exemplary, or other losses, costs, expenses, or damages arising out of this Public License or use of the Licensed Material, even if the Licensor has been advised of the possibility of such losses, costs, expenses, or damages. Where a limitation of liability is not allowed in full or in part, this limitation may not apply to You.
+
+     c.	The disclaimer of warranties and limitation of liability provided above shall be interpreted in a manner that, to the extent possible, most closely approximates an absolute disclaimer and waiver of all liability.
+
+Section 6 – Term and Termination.
+
+     a.	This Public License applies for the term of the Copyright and Similar Rights licensed here. However, if You fail to comply with this Public License, then Your rights under this Public License terminate automatically.
+
+     b.	Where Your right to use the Licensed Material has terminated under Section 6(a), it reinstates:
+
+          1. automatically as of the date the violation is cured, provided it is cured within 30 days of Your discovery of the violation; or
+
+          2. upon express reinstatement by the Licensor.
+
+     c.	For the avoidance of doubt, this Section 6(b) does not affect any right the Licensor may have to seek remedies for Your violations of this Public License.
+
+     d.	For the avoidance of doubt, the Licensor may also offer the Licensed Material under separate terms or conditions or stop distributing the Licensed Material at any time; however, doing so will not terminate this Public License.
+
+     e.	Sections 1, 5, 6, 7, and 8 survive termination of this Public License.
+
+Section 7 – Other Terms and Conditions.
+
+     a.	The Licensor shall not be bound by any additional or different terms or conditions communicated by You unless expressly agreed.
+
+     b.	Any arrangements, understandings, or agreements regarding the Licensed Material not stated herein are separate from and independent of the terms and conditions of this Public License.
+
+Section 8 – Interpretation.
+
+     a.	For the avoidance of doubt, this Public License does not, and shall not be interpreted to, reduce, limit, restrict, or impose conditions on any use of the Licensed Material that could lawfully be made without permission under this Public License.
+
+     b.	To the extent possible, if any provision of this Public License is deemed unenforceable, it shall be automatically reformed to the minimum extent necessary to make it enforceable. If the provision cannot be reformed, it shall be severed from this Public License without affecting the enforceability of the remaining terms and conditions.
+
+     c.	No term or condition of this Public License will be waived and no failure to comply consented to unless expressly agreed to by the Licensor.
+
+     d.	Nothing in this Public License constitutes or may be interpreted as a limitation upon, or waiver of, any privileges and immunities that apply to the Licensor or You, including from the legal processes of any jurisdiction or authority.
+
+Creative Commons is not a party to its public licenses. Notwithstanding, Creative Commons may elect to apply one of its public licenses to material it publishes and in those instances will be considered the “Licensor.” Except for the limited purpose of indicating that material is shared under a Creative Commons public license or as otherwise permitted by the Creative Commons policies published at creativecommons.org/policies, Creative Commons does not authorize the use of the trademark “Creative Commons” or any other trademark or logo of Creative Commons without its prior written consent including, without limitation, in connection with any unauthorized modifications to any of its public licenses or any other arrangements, understandings, or agreements concerning use of licensed material. For the avoidance of doubt, this paragraph does not form part of the public licenses.
+
+Creative Commons may be contacted at creativecommons.org.

PyPSA/source/LICENSES/MIT.txt

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) <year> <copyright holders>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

PyPSA/source/MANIFEST.in

@@ -0,0 +1,10 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+include pypsa/data/component_attrs/*.csv
+include pypsa/data/standard_types/*.csv
+include pypsa/data/components.csv
+include pypsa/data/variables.csv
+include README.rst LICENSE.txt
+include requirements.yml

PyPSA/source/README.md

@@ -0,0 +1,210 @@
+<!--
+SPDX-FileCopyrightText: PyPSA Contributors
+
+SPDX-License-Identifier: MIT
+-->
+
+<picture align="center">
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/PyPSA/PyPSA/refs/heads/master/docs/assets/logo/logo-primary-dark.svg">
+  <img alt="PyPSA Banner" src="https://raw.githubusercontent.com/PyPSA/PyPSA/refs/heads/master/docs/assets/logo/logo-primary-light.svg">
+</picture>
+
+# PyPSA - Python for Power System Analysis
+
+
+[![PyPI version](https://img.shields.io/pypi/v/pypsa.svg)](https://pypi.python.org/pypi/pypsa)
+[![Conda version](https://img.shields.io/conda/vn/conda-forge/pypsa.svg)](https://anaconda.org/conda-forge/pypsa)
+![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2FPyPSA%2FPyPSA%2Fmaster%2Fpyproject.toml)
+[![Tests](https://github.com/PyPSA/PyPSA/actions/workflows/test.yml/badge.svg)](https://github.com/PyPSA/PyPSA/actions/workflows/test.yml)
+[![Documentation Status](https://readthedocs.org/projects/pypsa/badge/?version=latest)](https://docs.pypsa.org/latest/?badge=latest)
+[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/PyPSA/PyPSA/master.svg)](https://results.pre-commit.ci/latest/github/PyPSA/PyPSA/master)
+[![Code coverage](https://codecov.io/gh/PyPSA/PyPSA/branch/master/graph/badge.svg?token=kCpwJiV6Jr)](https://codecov.io/gh/PyPSA/PyPSA)
+[![REUSE status](https://api.reuse.software/badge/github.com/pypsa/pypsa)](https://api.reuse.software/info/github.com/pypsa/pypsa)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![License](https://img.shields.io/pypi/l/pypsa.svg)](LICENSE)
+[![Zenodo](https://zenodo.org/badge/DOI/10.5281/zenodo.3946412.svg)](https://doi.org/10.5281/zenodo.3946412)
+[![Discord](https://img.shields.io/discord/911692131440148490?logo=discord)](https://discord.gg/AnuJBk23FU)
+[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)
+
+PyPSA stands for **Python for Power System Analysis**. It is pronounced
+**pipes-ah**.
+
+PyPSA is an open-source Python framework for optimising and simulating modern
+power and energy systems that include features such as conventional generators
+with unit commitment, variable wind and solar generation, hydro-electricity,
+inter-temporal storage, coupling to other energy sectors, elastic demands, and
+linearised power flow with loss approximations in DC and AC networks. PyPSA is
+designed to scale well with large networks and long time series. It is made for
+researchers, planners and utilities with basic coding aptitude who need a fast,
+easy-to-use and transparent tool for power and energy system analysis.
+
+PyPSA is maintained by the [Department of Digital Transformation in Energy
+Systems](https://tu.berlin/en/ensys) at the [Technical University of
+Berlin](https://www.tu.berlin). Previous versions were developed at the
+[Karlsruhe Institute of Technology](http://www.kit.edu/english/index.php) funded
+by the [Helmholtz Association](https://www.helmholtz.de/en/), and at
+[FIAS](https://fias.uni-frankfurt.de/) funded by the [German Federal Ministry
+for Education and Research (BMBF)](https://www.bmbf.de/bmbf/en/).
+
+## Features
+
+- **Economic Dispatch (ED):** Models short-term market-based dispatch including
+unit commitment, renewable availability, short-duration and seasonal storage
+including hydro reservoirs with inflow and spillage dynamics, elastic demands,
+load shedding and conversion between energy carriers, using either perfect
+operational foresight or rolling horizon time resolution.
+
+- **Linear Optimal Power Flow (LOPF):** Extends economic dispatch to determine
+the least-cost dispatch while respecting network constraints in meshed AC-DC
+networks, using a linearised representation of power flow (KVL, KCL) with
+optional loss approximations.
+
+- **Security-Constrained LOPF (SCLOPF):** Extends LOPF by accounting for line
+outage contingencies to ensure system reliability under $N-1$ conditions.
+
+- **Capacity Expansion Planning (CEP):** Supports least-cost
+long-term system planning with investment decisions for generation, storage,
+conversion, and transmission infrastructure. Handles both single and multiple
+investment periods. Continuous and discrete investments are supported.
+
+- **Pathway Planning:** Supports co-optimisation of multiple investment periods to
+plan energy system transitions over time with perfect planning foresight.
+
+- **Stochastic Optimisation:** Implements two-stage stochastic programming
+framework with scenario-weighted uncertain inputs, with investments as
+first-stage decisions and dispatch as recourse decisions.
+
+- **Modelling-to-Generate-Alternatives (MGA):** Explores near-optimal decision
+spaces to provide insight into the range of feasible system configurations with
+similar costs.
+
+- **Sector-Coupling:** Modelling integrated energy systems with multiple energy
+  carriers (electricity, heat, hydrogen, etc.) and conversion between them.
+  Flexible representation of technologies such as heat pumps, electrolysers,
+  battery electric vehicles (BEVs), direct air capture (DAC), and synthetic
+  fuels production.
+
+- **Static Power Flow Analysis:** Computes both full non-linear and linearised
+  load flows for meshed AC and DC grids using Newton-Raphson method.
+
+## Documentation
+
+PyPSA has extensive [documentation](https://docs.pypsa.org) with tutorials, user guides, examples and an API reference.
+
+## Installation
+
+pip:
+
+``` bash
+pip install pypsa
+```
+
+conda/mamba:
+
+``` bash
+conda install -c conda-forge pypsa
+```
+
+uv:
+
+``` bash
+uv add pypsa
+```
+
+## Usage
+
+``` py
+import pypsa
+
+# create a new network
+n = pypsa.Network()
+n.add("Bus", "mybus")
+n.add("Load", "myload", bus="mybus", p_set=100)
+n.add("Generator", "mygen", bus="mybus", p_nom=100, marginal_cost=20)
+
+# load an example network
+n = pypsa.examples.ac_dc_meshed()
+
+# run the optimisation
+n.optimize()
+
+# plot results
+n.generators_t.p.plot()
+n.plot()
+
+# get statistics
+n.statistics()
+n.statistics.energy_balance()
+```
+
+## Dependencies
+
+PyPSA relies heavily on other open-source Python packages. Some of them are:
+
+* [pandas](http://pandas.pydata.org/) for storing data about components and time series
+* [numpy](http://www.numpy.org/) and [scipy](http://scipy.org/) for linear algebra and matrix calculations
+* [linopy](https://github.com/PyPSA/linopy) for preparing optimisation problems
+* [matplotlib](https://matplotlib.org/), [seaborn](https://seaborn.pydata.org/) and [plotly](https://plotly.com/python/) for static and interactive plotting
+* [networkx](https://networkx.github.io/) for network calculations
+* [pytest](http://pytest.org/) for unit testing
+
+Find the full list of dependencies in the [`pyproject.toml`](https://github.com/PyPSA/PyPSA/blob/master/pyproject.toml) file.
+
+PyPSA can be used with different solvers. For instance, the free solvers
+[HiGHS](https://highs.dev/) (installed by default), [GLPK](https://www.gnu.org/software/glpk/) and
+[CBC](https://github.com/coin-or/Cbc/) or commercial solvers like
+[Gurobi](http://www.gurobi.com/) or [FICO Xpress](https://www.fico.com/en/products/fico-xpress-optimization) for which free academic licenses are available.
+
+## Contributing and Support
+
+We strongly welcome anyone interested in contributing to this project. If you have any ideas, suggestions or encounter problems, feel invited to file issues or make pull requests on GitHub.
+
+-   To **discuss** with other PyPSA users, organise projects, share news, and get in touch with the community you can use the [Discord server](https://discord.gg/AnuJBk23FU).
+-   For **bugs and feature requests**, please [open an issue](https://github.com/PyPSA/PyPSA/issues).
+-   For **troubleshooting and support**, please check the [troubleshooting](https://docs.pypsa.org/latest/user-guide/support/) and [support](https://docs.pypsa.org/latest/user-guide/support/) sectionsin the documentation.
+
+Detailed guidelines can be found in the [Contributing](https://docs.pypsa.org/latest/contributing/contributing/) guidelines of our documentation.
+
+## Code of Conduct
+
+Please respect our [Code of Conduct](https://docs.pypsa.org/latest/contributing/code-of-conduct/).
+
+## Citing PyPSA
+
+If you use PyPSA for your research, we would appreciate it if you would
+cite the following paper:
+
+-   T. Brown, J. Hörsch, D. Schlachtberger, [PyPSA: Python for Power
+    System Analysis](https://arxiv.org/abs/1707.09913), 2018, [Journal
+    of Open Research
+    Software](https://openresearchsoftware.metajnl.com/), 6(1),
+    [arXiv:1707.09913](https://arxiv.org/abs/1707.09913),
+    [DOI:10.5334/jors.188](https://doi.org/10.5334/jors.188)
+
+Please use the following BibTeX:
+
+    @article{PyPSA,
+       author = {T. Brown and J. H\"orsch and D. Schlachtberger},
+       title = {{PyPSA: Python for Power System Analysis}},
+       journal = {Journal of Open Research Software},
+       volume = {6},
+       issue = {1},
+       number = {4},
+       year = {2018},
+       eprint = {1707.09913},
+       url = {https://doi.org/10.5334/jors.188},
+       doi = {10.5334/jors.188}
+    }
+
+If you want to cite a specific PyPSA version, each release of PyPSA is archived
+on [Zenodo](https://zenodo.org/) with a release-specific DOI:
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3946412.svg)](https://doi.org/10.5281/zenodo.3946412)
+
+## Licence
+
+Copyright [PyPSA Contributors](https://docs.pypsa.org/latest/developers.html)
+
+PyPSA is licensed under the open source [MIT License](LICENSES/MIT.txt).
+The documentation is licensed under [CC-BY-4.0](LICENSES/CC-BY-4.0.txt).
+
+The repository uses [REUSE](https://reuse.software/) to expose the licenses of its files.

PyPSA/source/REUSE.toml

@@ -0,0 +1,51 @@
+version = 1
+SPDX-PackageName = "PyPSA"
+SPDX-PackageSupplier = "Tom Brown <t.brown@tu-berlin.de>"
+SPDX-PackageDownloadLocation = "https://github.com/pypsa/pypsa"
+
+[[annotations]]
+# As an essential part of PyPSA package, these parts are licensed under the same MIT license as the code itself
+path = [
+    ".github/**/*.md",
+    "pypsa/data/component_attrs/*.csv",
+    "pypsa/data/standard_types/*.csv",
+    "pypsa/data/*.csv",
+    "test/baseline/*.png",
+    "test/data/**/*.csv",
+    "test/data/**/*.json",
+    "docs/requirements.txt",
+]
+SPDX-FileCopyrightText = "PyPSA Contributors"
+SPDX-License-Identifier = "MIT"
+
+[[annotations]]
+# Data for examples, CC-BY-4.0 license for reuse by others
+path = [
+    "examples/**.csv",
+    "examples/**.json",
+    "examples/**.nc",
+]
+SPDX-FileCopyrightText = "PyPSA Contributors"
+SPDX-License-Identifier = "CC-BY-4.0"
+
+[[annotations]]
+# All documentation figures and notebooks (including their code) are for simplicity licensed under CC-BY-4.0
+path = [
+    "docs/**/*.ipynb",
+    "docs/**/*.png",
+    "docs/**/*.html",
+    "docs/**/*.svg",
+    "docs/**/*.jpg",
+]
+SPDX-FileCopyrightText = "PyPSA Contributors"
+SPDX-License-Identifier = "CC-BY-4.0"
+
+
+[[annotations]]
+# TODO find correct information for this external image
+path = [
+    "docs/assets/images/reserve-power-funding.gif",
+]
+# We think this is the correct attribution (copyright holder and license)
+SPDX-FileCopyrightText = "Ministry for Economic Affairs and Climate Action"
+SPDX-License-Identifier = "CC-BY-4.0"

PyPSA/source/__init__.py

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+"""
+PyPSA Project Package Initialization File
+"""

PyPSA/source/codecov.yml

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: PyPSA Contributors
+#
+# SPDX-License-Identifier: MIT
+
+comment: false
+
+coverage:
+  status:
+    project:
+      default:
+        threshold: 0.1%
+
+codecov:
+  notify:
+    after_n_builds: 13

PyPSA/source/docs/CODE_OF_CONDUCT.md

@@ -0,0 +1,143 @@
+<!--
+SPDX-FileCopyrightText: Organization for Ethical Source
+SPDX-FileCopyrightText: PyPSA Contributors
+
+SPDX-License-Identifier: CC-BY-4.0
+-->
+
+# Code of Conduct
+
+!!! info
+
+    This Code of Conduct follows the [Contributor Covenant, version 2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+f.neumann@tu-berlin.de / m.hofmann@tu-berlin.de / t.brown@tu-berlin.de.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

PyPSA/source/docs/api/components/common.md

@@ -0,0 +1,7 @@
+<!--
+SPDX-FileCopyrightText: PyPSA Contributors
+
+SPDX-License-Identifier: CC-BY-4.0
+-->
+
+::: pypsa.components.common

PyPSA/source/docs/api/components/components.md

@@ -0,0 +1,24 @@
+<!--
+SPDX-FileCopyrightText: PyPSA Contributors
+
+SPDX-License-Identifier: CC-BY-4.0
+-->
+
+::: pypsa.components.Components
+    options:
+        heading_level: 2
+        members_order: source
+        inherited_members: true
+        filters:
+        - "!^_[^_]"
+        - "!logger"
+        - "!iteration"
+        - "!__deepcopy__"
+        - "!__getitem__"
+        - "!__setitem__"
+        - "!add"
+        - "!get_bounds_pu"
+
+::: pypsa.components.components.ComponentsData
+    options:
+        heading_level: 2

PyPSA/source/docs/api/components/types/buses.md

@@ -0,0 +1,7 @@
+<!--
+SPDX-FileCopyrightText: PyPSA Contributors
+
+SPDX-License-Identifier: CC-BY-4.0
+-->
+
+::: pypsa.components.Buses

PyPSA/source/docs/api/components/types/carriers.md

@@ -0,0 +1,7 @@
+<!--
+SPDX-FileCopyrightText: PyPSA Contributors
+
+SPDX-License-Identifier: CC-BY-4.0
+-->
+
+::: pypsa.components.Carriers

PyPSA/source/docs/api/components/types/generators.md

@@ -0,0 +1,7 @@
+<!--
+SPDX-FileCopyrightText: PyPSA Contributors
+
+SPDX-License-Identifier: CC-BY-4.0
+-->
+
+::: pypsa.components.Generators

PyPSA/source/docs/api/components/types/global-constraints.md

@@ -0,0 +1,7 @@
+<!--
+SPDX-FileCopyrightText: PyPSA Contributors
+
+SPDX-License-Identifier: CC-BY-4.0
+-->
+
+::: pypsa.components.GlobalConstraints

PyPSA/source/docs/api/components/types/lines.md

@@ -0,0 +1,13 @@
+<!--
+SPDX-FileCopyrightText: PyPSA Contributors
+
+SPDX-License-Identifier: CC-BY-4.0
+-->
+
+::: pypsa.components.Lines
+    options:
+        heading_level: 2
+
+::: pypsa.components.LineTypes
+    options:
+        heading_level: 2