dnv-solarfarmer 0.2.0__tar.gz

dnv_solarfarmer-0.2.0/LICENSE

@@ -0,0 +1,13 @@
+Copyright [2026] [DNV AS]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

dnv_solarfarmer-0.2.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include LICENSE
+include README.md
+include mkdocs.yml
+recursive-include docs *.md
+recursive-include examples *.py

dnv_solarfarmer-0.2.0/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: dnv-solarfarmer
+Version: 0.2.0
+Summary: Python SDK for SolarFarmer, a bankable solar PV design and energy yield assessment tool by DNV.
+Author-email: DNV <solarfarmer@dnv.com>
+License: Apache-2.0
+Project-URL: Homepage, https://www.dnv.com/software/services/solarfarmer/
+Project-URL: Repository, https://github.com/dnv-opensource/solarfarmer-python-sdk
+Project-URL: Issues, https://github.com/dnv-opensource/solarfarmer-python-sdk/issues
+Keywords: solar,pv,photovoltaic,solarfarmer,dnv,sdk,api
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Requires-Dist: requests>=2.28
+Requires-Dist: tabulate>=0.9.0
+Provides-Extra: notebooks
+Requires-Dist: ipykernel<8,>=6.29; extra == "notebooks"
+Requires-Dist: jupyterlab<6,>=4.0; extra == "notebooks"
+Requires-Dist: notebook<9,>=7.0; extra == "notebooks"
+Provides-Extra: all
+Requires-Dist: dnv-solarfarmer[notebooks]; extra == "all"
+Requires-Dist: pandas>=2.0; extra == "all"
+Requires-Dist: matplotlib>=3.5; extra == "all"
+Dynamic: license-file
+
+# SolarFarmer Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/dnv-solarfarmer)](https://pypi.org/project/dnv-solarfarmer/)
+[![Python versions](https://img.shields.io/pypi/pyversions/dnv-solarfarmer)](https://pypi.org/project/dnv-solarfarmer/)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
+[![CI](https://github.com/dnv-opensource/solarfarmer-python-sdk/actions/workflows/test.yml/badge.svg)](https://github.com/dnv-opensource/solarfarmer-python-sdk/actions/workflows/test.yml)
+[![Documentation](https://img.shields.io/badge/docs-online-teal)](https://dnv-opensource.github.io/solarfarmer-python-sdk/)
+
+The official Python SDK for [SolarFarmer](https://www.dnv.com/software/services/solarfarmer/), a bankable solar PV design and energy yield assessment software from DNV. This SDK provides a typed Python interface that simplifies calling SolarFarmer APIs: build payloads, run 2D and 3D energy calculations, and process results programmatically.
+
+## Key Features
+
+- **Data models that mirror the API schema.** Pydantic classes with field validation catch payload errors locally before the API call. Field descriptions and type hints improve discoverability.
+- **Two plant-building paths.** Full control via `EnergyCalculationInputs` and component classes, or quick screening via `PVSystem` from high-level specs (DC and AC capacities, tilt, GCR)
+- **Structured results.** `CalculationResults` gives direct access to annual/monthly metrics, loss trees, and time series without parsing raw JSON.
+- **Automatic endpoint handling.** One function call runs 2D or 3D calculations. The SDK selects the right endpoint, polls async jobs, and supports cancellation via `terminate_calculation()`.
+
+## Requirements
+
+- Python >= 3.10 (tested on 3.10, 3.11, 3.12, 3.13)
+- A SolarFarmer API key (commercial licence required; see [API Key](#api-key))
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install dnv-solarfarmer
+```
+
+The package is imported as `solarfarmer` regardless of the distribution name:
+
+```python
+import solarfarmer as sf
+```
+
+Install with optional extras:
+
+```bash
+pip install "dnv-solarfarmer[notebooks]"  # JupyterLab and notebook support
+pip install "dnv-solarfarmer[all]"        # full installation including pandas and matplotlib
+```
+
+For development and documentation extras (managed as dependency groups, requires `uv`):
+
+```bash
+uv sync --group dev    # linting and testing tools (for contributors)
+uv sync --group docs   # documentation build tools
+```
+
+Install from source:
+
+```bash
+git clone https://github.com/dnv-opensource/solarfarmer-python-sdk
+cd solarfarmer-python-sdk
+pip install -e .
+```
+
+## API Key
+
+A SolarFarmer API key is required to run energy calculations. Obtain one from the [SolarFarmer portal](https://solarfarmer.dnv.com/). For setup instructions, see the [API key documentation](https://mysoftware.dnv.com/download/public/renewables/solarfarmer/manuals/latest/WebApi/Introduction/ApiKey.html).
+
+Set your key as an environment variable (recommended):
+
+```bash
+export SF_API_KEY="your_api_key_here"
+```
+
+Alternatively, pass it directly as the `api_key` parameter to any function that calls the API.
+
+## Configuration
+
+| Environment Variable | Default | Description |
+|---|---|---|
+| `SF_API_KEY` | *(none; required for calculations)* | API authentication token |
+| `SF_API_URL` | `https://solarfarmer.dnv.com/latest/api` | Override the base API URL for custom deployments |
+
+## Optional Dependencies
+
+The core SDK (`pydantic`, `requests`, `tabulate`) does not depend on `pandas`.
+Install the `all` extra for DataFrame-based features:
+
+```bash
+pip install "dnv-solarfarmer[all]"
+```
+
+This unlocks `sf.from_dataframe()` and `sf.from_pvlib()` for writing weather files from DataFrames, and enables `CalculationResults` to parse timeseries outputs into DataFrames. Without pandas, those functions raise `ImportError` or return `None`. All other SDK features work without it.
+
+## Getting Started
+
+The SDK supports three workflows for different use cases:
+
+| Workflow | Best for | Entry point |
+|---|---|---|
+| 1. Load existing files | Users with pre-built API payloads from the SolarFarmer desktop app or a previous export | `sf.run_energy_calculation(inputs_folder_path=...)` |
+| 2. PVSystem builder | Quick screening from high-level specs (capacity, tilt, equipment files). The design is approximate: string sizing and inverter count are inferred, so DC/AC capacity may not match the target exactly. | `plant = sf.PVSystem(...)` then `plant.run_energy_calculation()` |
+| 3. Custom integration | Developers mapping internal databases or proprietary formats to the SolarFarmer API | `params = sf.EnergyCalculationInputs(...)` then `sf.run_energy_calculation(plant_builder=params)` |
+
+See the [Getting Started guide](https://dnv-opensource.github.io/solarfarmer-python-sdk/getting-started/) for full per-workflow walkthroughs, and the [example notebooks](https://dnv-opensource.github.io/solarfarmer-python-sdk/notebooks/Example_EnergyCalculations/) for runnable end-to-end examples.
+
+## Documentation
+
+Full documentation (API reference, workflow guides, notebook tutorials):
+
+**https://dnv-opensource.github.io/solarfarmer-python-sdk/**
+
+To build and serve the documentation locally:
+
+```bash
+uv sync --group docs
+zensical serve -o                          # build, serve, and open in browser (port 8000)
+zensical serve -o -a localhost:8080        # use a different port
+```
+
+`zensical serve` builds the docs and starts a local server in one step. The `-o` flag opens the page automatically in your default browser.
+
+## Contributing
+
+Fork the repository, create a branch, and submit a pull request to `main`. To set up a development environment:
+
+```bash
+git clone https://github.com/dnv-opensource/solarfarmer-python-sdk
+cd solarfarmer-python-sdk
+pip install -e .
+uv sync --group dev
+```
+
+- **Linting and formatting:** `ruff check solarfarmer/ tests/` and `ruff format solarfarmer/ tests/`
+- **Tests:** `pytest tests/ -v`
+
+All contributions should include tests for new functionality. For feature proposals or questions, contact [solarfarmer@dnv.com](mailto:solarfarmer@dnv.com). See [CONTRIBUTING.md](CONTRIBUTING.md) for full guidelines.
+
+## Getting Technical Support
+
+- **SDK documentation:** https://dnv-opensource.github.io/solarfarmer-python-sdk/
+- **SolarFarmer API documentation:** https://mysoftware.dnv.com/download/public/renewables/solarfarmer/manuals/latest/WebApi/Introduction/introduction.html
+- **Issue tracker:** https://github.com/dnv-opensource/solarfarmer-python-sdk/issues
+- **Email:** [solarfarmer@dnv.com](mailto:solarfarmer@dnv.com)
+
+## License
+
+Apache License, Version 2.0 — see [LICENSE](LICENSE).

dnv_solarfarmer-0.2.0/README.md

@@ -0,0 +1,142 @@
+# SolarFarmer Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/dnv-solarfarmer)](https://pypi.org/project/dnv-solarfarmer/)
+[![Python versions](https://img.shields.io/pypi/pyversions/dnv-solarfarmer)](https://pypi.org/project/dnv-solarfarmer/)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
+[![CI](https://github.com/dnv-opensource/solarfarmer-python-sdk/actions/workflows/test.yml/badge.svg)](https://github.com/dnv-opensource/solarfarmer-python-sdk/actions/workflows/test.yml)
+[![Documentation](https://img.shields.io/badge/docs-online-teal)](https://dnv-opensource.github.io/solarfarmer-python-sdk/)
+
+The official Python SDK for [SolarFarmer](https://www.dnv.com/software/services/solarfarmer/), a bankable solar PV design and energy yield assessment software from DNV. This SDK provides a typed Python interface that simplifies calling SolarFarmer APIs: build payloads, run 2D and 3D energy calculations, and process results programmatically.
+
+## Key Features
+
+- **Data models that mirror the API schema.** Pydantic classes with field validation catch payload errors locally before the API call. Field descriptions and type hints improve discoverability.
+- **Two plant-building paths.** Full control via `EnergyCalculationInputs` and component classes, or quick screening via `PVSystem` from high-level specs (DC and AC capacities, tilt, GCR)
+- **Structured results.** `CalculationResults` gives direct access to annual/monthly metrics, loss trees, and time series without parsing raw JSON.
+- **Automatic endpoint handling.** One function call runs 2D or 3D calculations. The SDK selects the right endpoint, polls async jobs, and supports cancellation via `terminate_calculation()`.
+
+## Requirements
+
+- Python >= 3.10 (tested on 3.10, 3.11, 3.12, 3.13)
+- A SolarFarmer API key (commercial licence required; see [API Key](#api-key))
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install dnv-solarfarmer
+```
+
+The package is imported as `solarfarmer` regardless of the distribution name:
+
+```python
+import solarfarmer as sf
+```
+
+Install with optional extras:
+
+```bash
+pip install "dnv-solarfarmer[notebooks]"  # JupyterLab and notebook support
+pip install "dnv-solarfarmer[all]"        # full installation including pandas and matplotlib
+```
+
+For development and documentation extras (managed as dependency groups, requires `uv`):
+
+```bash
+uv sync --group dev    # linting and testing tools (for contributors)
+uv sync --group docs   # documentation build tools
+```
+
+Install from source:
+
+```bash
+git clone https://github.com/dnv-opensource/solarfarmer-python-sdk
+cd solarfarmer-python-sdk
+pip install -e .
+```
+
+## API Key
+
+A SolarFarmer API key is required to run energy calculations. Obtain one from the [SolarFarmer portal](https://solarfarmer.dnv.com/). For setup instructions, see the [API key documentation](https://mysoftware.dnv.com/download/public/renewables/solarfarmer/manuals/latest/WebApi/Introduction/ApiKey.html).
+
+Set your key as an environment variable (recommended):
+
+```bash
+export SF_API_KEY="your_api_key_here"
+```
+
+Alternatively, pass it directly as the `api_key` parameter to any function that calls the API.
+
+## Configuration
+
+| Environment Variable | Default | Description |
+|---|---|---|
+| `SF_API_KEY` | *(none; required for calculations)* | API authentication token |
+| `SF_API_URL` | `https://solarfarmer.dnv.com/latest/api` | Override the base API URL for custom deployments |
+
+## Optional Dependencies
+
+The core SDK (`pydantic`, `requests`, `tabulate`) does not depend on `pandas`.
+Install the `all` extra for DataFrame-based features:
+
+```bash
+pip install "dnv-solarfarmer[all]"
+```
+
+This unlocks `sf.from_dataframe()` and `sf.from_pvlib()` for writing weather files from DataFrames, and enables `CalculationResults` to parse timeseries outputs into DataFrames. Without pandas, those functions raise `ImportError` or return `None`. All other SDK features work without it.
+
+## Getting Started
+
+The SDK supports three workflows for different use cases:
+
+| Workflow | Best for | Entry point |
+|---|---|---|
+| 1. Load existing files | Users with pre-built API payloads from the SolarFarmer desktop app or a previous export | `sf.run_energy_calculation(inputs_folder_path=...)` |
+| 2. PVSystem builder | Quick screening from high-level specs (capacity, tilt, equipment files). The design is approximate: string sizing and inverter count are inferred, so DC/AC capacity may not match the target exactly. | `plant = sf.PVSystem(...)` then `plant.run_energy_calculation()` |
+| 3. Custom integration | Developers mapping internal databases or proprietary formats to the SolarFarmer API | `params = sf.EnergyCalculationInputs(...)` then `sf.run_energy_calculation(plant_builder=params)` |
+
+See the [Getting Started guide](https://dnv-opensource.github.io/solarfarmer-python-sdk/getting-started/) for full per-workflow walkthroughs, and the [example notebooks](https://dnv-opensource.github.io/solarfarmer-python-sdk/notebooks/Example_EnergyCalculations/) for runnable end-to-end examples.
+
+## Documentation
+
+Full documentation (API reference, workflow guides, notebook tutorials):
+
+**https://dnv-opensource.github.io/solarfarmer-python-sdk/**
+
+To build and serve the documentation locally:
+
+```bash
+uv sync --group docs
+zensical serve -o                          # build, serve, and open in browser (port 8000)
+zensical serve -o -a localhost:8080        # use a different port
+```
+
+`zensical serve` builds the docs and starts a local server in one step. The `-o` flag opens the page automatically in your default browser.
+
+## Contributing
+
+Fork the repository, create a branch, and submit a pull request to `main`. To set up a development environment:
+
+```bash
+git clone https://github.com/dnv-opensource/solarfarmer-python-sdk
+cd solarfarmer-python-sdk
+pip install -e .
+uv sync --group dev
+```
+
+- **Linting and formatting:** `ruff check solarfarmer/ tests/` and `ruff format solarfarmer/ tests/`
+- **Tests:** `pytest tests/ -v`
+
+All contributions should include tests for new functionality. For feature proposals or questions, contact [solarfarmer@dnv.com](mailto:solarfarmer@dnv.com). See [CONTRIBUTING.md](CONTRIBUTING.md) for full guidelines.
+
+## Getting Technical Support
+
+- **SDK documentation:** https://dnv-opensource.github.io/solarfarmer-python-sdk/
+- **SolarFarmer API documentation:** https://mysoftware.dnv.com/download/public/renewables/solarfarmer/manuals/latest/WebApi/Introduction/introduction.html
+- **Issue tracker:** https://github.com/dnv-opensource/solarfarmer-python-sdk/issues
+- **Email:** [solarfarmer@dnv.com](mailto:solarfarmer@dnv.com)
+
+## License
+
+Apache License, Version 2.0 — see [LICENSE](LICENSE).

dnv_solarfarmer-0.2.0/dnv_solarfarmer.egg-info/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: dnv-solarfarmer
+Version: 0.2.0
+Summary: Python SDK for SolarFarmer, a bankable solar PV design and energy yield assessment tool by DNV.
+Author-email: DNV <solarfarmer@dnv.com>
+License: Apache-2.0
+Project-URL: Homepage, https://www.dnv.com/software/services/solarfarmer/
+Project-URL: Repository, https://github.com/dnv-opensource/solarfarmer-python-sdk
+Project-URL: Issues, https://github.com/dnv-opensource/solarfarmer-python-sdk/issues
+Keywords: solar,pv,photovoltaic,solarfarmer,dnv,sdk,api
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Requires-Dist: requests>=2.28
+Requires-Dist: tabulate>=0.9.0
+Provides-Extra: notebooks
+Requires-Dist: ipykernel<8,>=6.29; extra == "notebooks"
+Requires-Dist: jupyterlab<6,>=4.0; extra == "notebooks"
+Requires-Dist: notebook<9,>=7.0; extra == "notebooks"
+Provides-Extra: all
+Requires-Dist: dnv-solarfarmer[notebooks]; extra == "all"
+Requires-Dist: pandas>=2.0; extra == "all"
+Requires-Dist: matplotlib>=3.5; extra == "all"
+Dynamic: license-file
+
+# SolarFarmer Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/dnv-solarfarmer)](https://pypi.org/project/dnv-solarfarmer/)
+[![Python versions](https://img.shields.io/pypi/pyversions/dnv-solarfarmer)](https://pypi.org/project/dnv-solarfarmer/)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
+[![CI](https://github.com/dnv-opensource/solarfarmer-python-sdk/actions/workflows/test.yml/badge.svg)](https://github.com/dnv-opensource/solarfarmer-python-sdk/actions/workflows/test.yml)
+[![Documentation](https://img.shields.io/badge/docs-online-teal)](https://dnv-opensource.github.io/solarfarmer-python-sdk/)
+
+The official Python SDK for [SolarFarmer](https://www.dnv.com/software/services/solarfarmer/), a bankable solar PV design and energy yield assessment software from DNV. This SDK provides a typed Python interface that simplifies calling SolarFarmer APIs: build payloads, run 2D and 3D energy calculations, and process results programmatically.
+
+## Key Features
+
+- **Data models that mirror the API schema.** Pydantic classes with field validation catch payload errors locally before the API call. Field descriptions and type hints improve discoverability.
+- **Two plant-building paths.** Full control via `EnergyCalculationInputs` and component classes, or quick screening via `PVSystem` from high-level specs (DC and AC capacities, tilt, GCR)
+- **Structured results.** `CalculationResults` gives direct access to annual/monthly metrics, loss trees, and time series without parsing raw JSON.
+- **Automatic endpoint handling.** One function call runs 2D or 3D calculations. The SDK selects the right endpoint, polls async jobs, and supports cancellation via `terminate_calculation()`.
+
+## Requirements
+
+- Python >= 3.10 (tested on 3.10, 3.11, 3.12, 3.13)
+- A SolarFarmer API key (commercial licence required; see [API Key](#api-key))
+
+## Installation
+
+Install from PyPI:
+
+```bash
+pip install dnv-solarfarmer
+```
+
+The package is imported as `solarfarmer` regardless of the distribution name:
+
+```python
+import solarfarmer as sf
+```
+
+Install with optional extras:
+
+```bash
+pip install "dnv-solarfarmer[notebooks]"  # JupyterLab and notebook support
+pip install "dnv-solarfarmer[all]"        # full installation including pandas and matplotlib
+```
+
+For development and documentation extras (managed as dependency groups, requires `uv`):
+
+```bash
+uv sync --group dev    # linting and testing tools (for contributors)
+uv sync --group docs   # documentation build tools
+```
+
+Install from source:
+
+```bash
+git clone https://github.com/dnv-opensource/solarfarmer-python-sdk
+cd solarfarmer-python-sdk
+pip install -e .
+```
+
+## API Key
+
+A SolarFarmer API key is required to run energy calculations. Obtain one from the [SolarFarmer portal](https://solarfarmer.dnv.com/). For setup instructions, see the [API key documentation](https://mysoftware.dnv.com/download/public/renewables/solarfarmer/manuals/latest/WebApi/Introduction/ApiKey.html).
+
+Set your key as an environment variable (recommended):
+
+```bash
+export SF_API_KEY="your_api_key_here"
+```
+
+Alternatively, pass it directly as the `api_key` parameter to any function that calls the API.
+
+## Configuration
+
+| Environment Variable | Default | Description |
+|---|---|---|
+| `SF_API_KEY` | *(none; required for calculations)* | API authentication token |
+| `SF_API_URL` | `https://solarfarmer.dnv.com/latest/api` | Override the base API URL for custom deployments |
+
+## Optional Dependencies
+
+The core SDK (`pydantic`, `requests`, `tabulate`) does not depend on `pandas`.
+Install the `all` extra for DataFrame-based features:
+
+```bash
+pip install "dnv-solarfarmer[all]"
+```
+
+This unlocks `sf.from_dataframe()` and `sf.from_pvlib()` for writing weather files from DataFrames, and enables `CalculationResults` to parse timeseries outputs into DataFrames. Without pandas, those functions raise `ImportError` or return `None`. All other SDK features work without it.
+
+## Getting Started
+
+The SDK supports three workflows for different use cases:
+
+| Workflow | Best for | Entry point |
+|---|---|---|
+| 1. Load existing files | Users with pre-built API payloads from the SolarFarmer desktop app or a previous export | `sf.run_energy_calculation(inputs_folder_path=...)` |
+| 2. PVSystem builder | Quick screening from high-level specs (capacity, tilt, equipment files). The design is approximate: string sizing and inverter count are inferred, so DC/AC capacity may not match the target exactly. | `plant = sf.PVSystem(...)` then `plant.run_energy_calculation()` |
+| 3. Custom integration | Developers mapping internal databases or proprietary formats to the SolarFarmer API | `params = sf.EnergyCalculationInputs(...)` then `sf.run_energy_calculation(plant_builder=params)` |
+
+See the [Getting Started guide](https://dnv-opensource.github.io/solarfarmer-python-sdk/getting-started/) for full per-workflow walkthroughs, and the [example notebooks](https://dnv-opensource.github.io/solarfarmer-python-sdk/notebooks/Example_EnergyCalculations/) for runnable end-to-end examples.
+
+## Documentation
+
+Full documentation (API reference, workflow guides, notebook tutorials):
+
+**https://dnv-opensource.github.io/solarfarmer-python-sdk/**
+
+To build and serve the documentation locally:
+
+```bash
+uv sync --group docs
+zensical serve -o                          # build, serve, and open in browser (port 8000)
+zensical serve -o -a localhost:8080        # use a different port
+```
+
+`zensical serve` builds the docs and starts a local server in one step. The `-o` flag opens the page automatically in your default browser.
+
+## Contributing
+
+Fork the repository, create a branch, and submit a pull request to `main`. To set up a development environment:
+
+```bash
+git clone https://github.com/dnv-opensource/solarfarmer-python-sdk
+cd solarfarmer-python-sdk
+pip install -e .
+uv sync --group dev
+```
+
+- **Linting and formatting:** `ruff check solarfarmer/ tests/` and `ruff format solarfarmer/ tests/`
+- **Tests:** `pytest tests/ -v`
+
+All contributions should include tests for new functionality. For feature proposals or questions, contact [solarfarmer@dnv.com](mailto:solarfarmer@dnv.com). See [CONTRIBUTING.md](CONTRIBUTING.md) for full guidelines.
+
+## Getting Technical Support
+
+- **SDK documentation:** https://dnv-opensource.github.io/solarfarmer-python-sdk/
+- **SolarFarmer API documentation:** https://mysoftware.dnv.com/download/public/renewables/solarfarmer/manuals/latest/WebApi/Introduction/introduction.html
+- **Issue tracker:** https://github.com/dnv-opensource/solarfarmer-python-sdk/issues
+- **Email:** [solarfarmer@dnv.com](mailto:solarfarmer@dnv.com)
+
+## License
+
+Apache License, Version 2.0 — see [LICENSE](LICENSE).

dnv_solarfarmer-0.2.0/dnv_solarfarmer.egg-info/SOURCES.txt

@@ -0,0 +1,71 @@
+LICENSE
+MANIFEST.in
+README.md
+mkdocs.yml
+pyproject.toml
+dnv_solarfarmer.egg-info/PKG-INFO
+dnv_solarfarmer.egg-info/SOURCES.txt
+dnv_solarfarmer.egg-info/dependency_links.txt
+dnv_solarfarmer.egg-info/requires.txt
+dnv_solarfarmer.egg-info/top_level.txt
+docs/404.md
+docs/api.md
+docs/faq.md
+docs/index.md
+docs/license.md
+docs/getting-started/end-to-end-examples.md
+docs/getting-started/index.md
+docs/getting-started/quick-start-examples.md
+docs/getting-started/workflow-1-existing-api-files.md
+docs/getting-started/workflow-2-pvplant-builder.md
+docs/getting-started/workflow-3-plantbuilder-advanced.md
+solarfarmer/__init__.py
+solarfarmer/__version__.py
+solarfarmer/api.py
+solarfarmer/config.py
+solarfarmer/endpoint_about.py
+solarfarmer/endpoint_modelchains.py
+solarfarmer/endpoint_modelchains_utils.py
+solarfarmer/endpoint_service.py
+solarfarmer/endpoint_terminate_async.py
+solarfarmer/logging.py
+solarfarmer/weather.py
+solarfarmer/models/__init__.py
+solarfarmer/models/_base.py
+solarfarmer/models/auxiliary_losses.py
+solarfarmer/models/energy_calculation_inputs.py
+solarfarmer/models/energy_calculation_options.py
+solarfarmer/models/energy_calculation_results.py
+solarfarmer/models/enums.py
+solarfarmer/models/inverter.py
+solarfarmer/models/layout.py
+solarfarmer/models/location.py
+solarfarmer/models/model_chain_response.py
+solarfarmer/models/monthly_albedo.py
+solarfarmer/models/mounting_type_specification.py
+solarfarmer/models/ond_supplements.py
+solarfarmer/models/pan_supplements.py
+solarfarmer/models/pv_plant.py
+solarfarmer/models/tracker_system.py
+solarfarmer/models/transformer.py
+solarfarmer/models/transformer_specification.py
+solarfarmer/models/pvsystem/__init__.py
+solarfarmer/models/pvsystem/plant_defaults.py
+solarfarmer/models/pvsystem/plant_utils.py
+solarfarmer/models/pvsystem/pvsystem.py
+solarfarmer/models/pvsystem/validation.py
+tests/test_api.py
+tests/test_construct_plant.py
+tests/test_endpoint_about.py
+tests/test_endpoint_modelchain.py
+tests/test_endpoint_modelchains_utils.py
+tests/test_endpoint_service.py
+tests/test_endpoint_terminate_async.py
+tests/test_energy_calculation_results.py
+tests/test_logging.py
+tests/test_model_chain_response.py
+tests/test_plant_utils.py
+tests/test_pvsystem.py
+tests/test_validation_message.py
+tests/test_version.py
+tests/test_weather.py

dnv_solarfarmer-0.2.0/dnv_solarfarmer.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dnv_solarfarmer-0.2.0/dnv_solarfarmer.egg-info/requires.txt

@@ -0,0 +1,13 @@
+pydantic>=2.0
+requests>=2.28
+tabulate>=0.9.0
+
+[all]
+dnv-solarfarmer[notebooks]
+pandas>=2.0
+matplotlib>=3.5
+
+[notebooks]
+ipykernel<8,>=6.29
+jupyterlab<6,>=4.0
+notebook<9,>=7.0

dnv_solarfarmer-0.2.0/dnv_solarfarmer.egg-info/top_level.txt

@@ -0,0 +1 @@
+solarfarmer

dnv_solarfarmer-0.2.0/docs/404.md

@@ -0,0 +1,36 @@
+# 404 - Page Not Found
+
+The page you're looking for cannot be found.
+
+## Quick Links
+
+**[← Back to Home](index.md)** | **[Getting Started](getting-started/index.md)** | **[API Reference](api.md)**
+
+## Find What You Need
+
+### Popular Pages
+
+- [Quick Start Examples](getting-started/quick-start-examples.md)
+- [Workflow 1: Load Existing API Files](getting-started/workflow-1-existing-api-files.md)
+- [Workflow 2: Design Plants with PVSystem](getting-started/workflow-2-pvplant-builder.md)
+- [Workflow 3: Advanced Integration](getting-started/workflow-3-plantbuilder-advanced.md)
+- [End-to-End Examples](getting-started/end-to-end-examples.md)
+
+### Example Notebooks
+
+Browse our [Jupyter notebook examples](getting-started/index.md) for hands-on tutorials covering:
+
+- Using the About and Service Endpoints
+- Running 2D and 3D Calculations
+- Creating Plants with PVSystem
+- Terminating Asynchronous Calculations
+
+## Need Help?
+
+**Search** - Use the search bar above to find documentation
+
+**Report Issues** - [GitHub Issues](https://github.com/dnv-opensource/solarfarmer-api-python-sdk/issues)
+
+**Contact** - [solarfarmer@dnv.com](mailto:solarfarmer@dnv.com)
+
+**Community** - Follow on [LinkedIn](https://www.linkedin.com/feed/hashtag/solarfarmer/)