<p align="center">
<a href="https://www.alitiq.com"><img src="https://alitiq.com/wp-content/uploads/2022/08/Logo-1.png" alt="alitiq Forecasting Energy"></a>
</p>
<p align="center">
<em>alitiq-py , high performance, easy to use, ready for production python software development kit </em>
</p>
<p align="center">
<a href="" target="_blank">
<img src="https://img.shields.io/pypi/pyversions/fastapi.svg?color=%2334D058" alt="Supported Python versions">
</a>
<a href="https://docs.alitiq.com">
<img src="https://img.shields.io/badge/Documentation-here-blue">
</a>
</p>
## Overview π οΈ
Welcome to **alitiq's Forecasting Service SDK**, a robust Python-based SDK that simplifies interaction with alitiqβs Solar, Wind and Load Forecast APIs. This SDK enables seamless data retrieval, measurements management, and forecasting for solar power plants, energy demand, and more. Built with flexibility and scalability in mind, it supports a range of features such as pushing measurements, retrieving forecasts, and managing locations.
Before you start using the SDK, you need to obtain an API key. For the engine / load API you will receive your key and relevant information from the alitiq Team. To obtain a key for the solar power forecasting API register here: [Solar-APP](https://solar-app.alitiq.com)
This is a work in progress. We will shortly add an extensive documentation with step by step guides to use our API with python.
---
## Features β¨
- **Solar Power Plant Management**:
Manage PV system configurations and retrieve forecasts for your solar power installations.
- **WindPark Management**:
Manage WindPark configurations and retrieve forecasts for your portfolio.
- **Load Forecasting** by alitiq Engine:
Fetch and manage energy load forecasts for heat, gas, and electricity demand.
- **Pushing and Retrieving Measurements**:
Push new measurement data to the API and inspect historical measurement data.
- **Robust Validation**:
Powered by Pydantic, ensuring data integrity for all API interactions.
---
## Installation π¦
With pip:
```bash
pip install alitiq
```
Or check out locally:
1. Clone the repository:
```bash
git clone https://github.com/alitiq/alitiq-py.git
cd alitiq-py
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. (Optional) Install the SDK locally:
```bash
pip install .
```
---
## Quickstart π
Example shows how to add a new Solar PV power plant, retrieve most recent forecast and push measurements for a given location.
```python
from datetime import datetime
from alitiq import alitiqSolarAPI, SolarPowerPlantModel, PvMeasurementForm
# Initialize the API client
solar_api = alitiqSolarAPI(api_key="your-api-key")
# Create a solar power plant location
plant = SolarPowerPlantModel(
site_name="My Solar Plant",
location_id="SP123",
latitude=48.160170,
longitude=10.55907,
installed_power=500.0,
installed_power_inverter=480.0,
azimuth=180.0,
tilt=25.0,
)
response = solar_api.create_location(plant)
print("Location created:", response)
# Retrieve a forecast ( after 1-6 hours after creation available)
forecast = solar_api.get_forecast(location_id="SP123")
print(forecast)
# Post measurements
pv_measurements = [
PvMeasurementForm(
location_id="SP123",
dt=datetime(2024, 6, 10, 10).isoformat(),
power=120.5,
power_measure="kW",
timezone="UTC",
interval_in_minutes=15,
),
PvMeasurementForm(
location_id="SP123",
dt=datetime(2024, 6, 10, 10, 15).isoformat(),
power=90.8,
power_measure="kW",
timezone="UTC",
interval_in_minutes=15,
),
PvMeasurementForm(
location_id="SP123",
dt=datetime(2024, 6, 10, 10, 30).isoformat(),
power=150.0,
power_measure="kW",
timezone="UTC",
interval_in_minutes=15,
),
]
response = solar_api.post_measurements(pv_measurements)
print(response)
```
Please go to our docs for detailed information [alitiq-Docs](https://docs.alitiq.com)
---
## Project Structure ποΈ
```plaintext
alitiq/
βββ enumerations/
β βββ __init__.py
β βββ forecast_models.py
β βββ services.py
β
βββ models/
β βββ __init__.py
β βββ load_forecast.py
β βββ solar_power_forecast.py
β βββ wind_power_forecast.py
β
βββ __init__.py
βββ base.py
βββ load_forecast.py
βββ solar_power_forecast.py
βββ wind_power_forecast.py
```
---
## Key Modules π
### Solar Forecasting Module (`solar_power_forecast.py`)
Manage PV systems and retrieve solar power forecasts. Key methods:
- `create_location`: Add new PV system configurations.
- `list_locations`: List current portfolio
- `delete_location`: Deletes one location from portfolio
- `get_forecast`: Retrieve solar power forecasts for a specific location.
- `get_forecast_portfolio`: Retrieve solar power forecasts for the whole portfolio.
- `push_measurements`: Submit real-time measurements for your solar plant.
- `get_measurements`: Retrieve historical data for a location.
### Wind Forecasting Module (`wind_power_forecast.py`)
Manage WindParks and retrieve wind power forecasts. Key methods:
- `create_location`: Add new WindPark configurations.
- `list_locations`: List current portfolio
- `delete_location`: Deletes one location from portfolio
- `get_forecast`: Retrieve wind power forecasts for a specific location.
- `get_forecast_portfolio`: Retrieve wind power forecasts for the whole portfolio.
- `push_measurements`: Submit real-time measurements for your WindPark.
- `get_measurements`: Retrieve historical data for a location.
### Load Forecasting Module (`load_forecast.py`)
Interact with alitiq's load forecast API for heat, gas, and electricity. Key methods:
- `get_measurements`: Retrieve historical data for a location.
- `post_measurements`: Push new measurement data.
- `get_forecast`: Fetch load forecasts for your configured location.
---
## Contributing π€
We welcome contributions! To contribute:
1. Fork the repository.
2. Create a new branch:
```bash
git checkout -b feature/new-feature
```
3. Commit your changes:
```bash
git commit -m "Add a new feature"
```
4. Push to your branch and submit a pull request.
---
## License π
MIT License, see attached LICENSE
---
## Developer Notes
Run `python3 -m build` to build the package and then upload with twine: `twine upload -r pypi dist/*`
---
## Support & Contact π§
For any questions or issues, please contact [support@alitiq.com](mailto:support@alitiq.com).
π **Happy Forecasting!** π
Raw data
{
"_id": null,
"home_page": null,
"name": "alitiq",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "energy, forecasting, solar, pv, demand, prediction, wind, windpower, solarpower, power, powerprediction",
"author": "Daniel Lassahn | alitiq GmbH",
"author_email": "info@alitiq.com",
"download_url": "https://files.pythonhosted.org/packages/5a/3a/3e647aecc49e72ba813eb61c4737a7354b036072ffd401dca16a814fae0e/alitiq-2025.2.19.tar.gz",
"platform": null,
"description": "\n<p align=\"center\">\n <a href=\"https://www.alitiq.com\"><img src=\"https://alitiq.com/wp-content/uploads/2022/08/Logo-1.png\" alt=\"alitiq Forecasting Energy\"></a>\n</p>\n<p align=\"center\">\n <em>alitiq-py , high performance, easy to use, ready for production python software development kit </em>\n</p>\n<p align=\"center\">\n<a href=\"\" target=\"_blank\">\n <img src=\"https://img.shields.io/pypi/pyversions/fastapi.svg?color=%2334D058\" alt=\"Supported Python versions\">\n</a>\n<a href=\"https://docs.alitiq.com\">\n <img src=\"https://img.shields.io/badge/Documentation-here-blue\">\n</a>\n</p>\n\n## Overview \ud83d\udee0\ufe0f\nWelcome to **alitiq's Forecasting Service SDK**, a robust Python-based SDK that simplifies interaction with alitiq\u2019s Solar, Wind and Load Forecast APIs. This SDK enables seamless data retrieval, measurements management, and forecasting for solar power plants, energy demand, and more. Built with flexibility and scalability in mind, it supports a range of features such as pushing measurements, retrieving forecasts, and managing locations.\n\nBefore you start using the SDK, you need to obtain an API key. For the engine / load API you will receive your key and relevant information from the alitiq Team. To obtain a key for the solar power forecasting API register here: [Solar-APP](https://solar-app.alitiq.com)\n\nThis is a work in progress. We will shortly add an extensive documentation with step by step guides to use our API with python. \n\n---\n\n## Features \u2728 \n- **Solar Power Plant Management**: \n Manage PV system configurations and retrieve forecasts for your solar power installations. \n- **WindPark Management**: \n Manage WindPark configurations and retrieve forecasts for your portfolio. \n- **Load Forecasting** by alitiq Engine: \n Fetch and manage energy load forecasts for heat, gas, and electricity demand. \n- **Pushing and Retrieving Measurements**: \n Push new measurement data to the API and inspect historical measurement data. \n- **Robust Validation**: \n Powered by Pydantic, ensuring data integrity for all API interactions. \n\n---\n\n## Installation \ud83d\udce6 \nWith pip: \n```bash\npip install alitiq\n```\n\nOr check out locally:\n1. Clone the repository: \n ```bash\n git clone https://github.com/alitiq/alitiq-py.git\n cd alitiq-py\n ```\n2. Install dependencies: \n ```bash\n pip install -r requirements.txt\n ```\n\n3. (Optional) Install the SDK locally: \n ```bash\n pip install .\n ```\n\n\n---\n\n## Quickstart \ud83d\ude80 \nExample shows how to add a new Solar PV power plant, retrieve most recent forecast and push measurements for a given location. \n```python\nfrom datetime import datetime\nfrom alitiq import alitiqSolarAPI, SolarPowerPlantModel, PvMeasurementForm\n\n# Initialize the API client\nsolar_api = alitiqSolarAPI(api_key=\"your-api-key\")\n\n# Create a solar power plant location\nplant = SolarPowerPlantModel(\n site_name=\"My Solar Plant\",\n location_id=\"SP123\",\n latitude=48.160170,\n longitude=10.55907,\n installed_power=500.0,\n installed_power_inverter=480.0,\n azimuth=180.0,\n tilt=25.0,\n)\n\nresponse = solar_api.create_location(plant)\nprint(\"Location created:\", response)\n\n# Retrieve a forecast ( after 1-6 hours after creation available)\nforecast = solar_api.get_forecast(location_id=\"SP123\")\nprint(forecast)\n\n# Post measurements \npv_measurements = [\n PvMeasurementForm(\n location_id=\"SP123\",\n dt=datetime(2024, 6, 10, 10).isoformat(),\n power=120.5,\n power_measure=\"kW\",\n timezone=\"UTC\",\n interval_in_minutes=15,\n ),\n PvMeasurementForm(\n location_id=\"SP123\",\n dt=datetime(2024, 6, 10, 10, 15).isoformat(),\n power=90.8,\n power_measure=\"kW\",\n timezone=\"UTC\",\n interval_in_minutes=15,\n ),\n PvMeasurementForm(\n location_id=\"SP123\",\n dt=datetime(2024, 6, 10, 10, 30).isoformat(),\n power=150.0,\n power_measure=\"kW\",\n timezone=\"UTC\",\n interval_in_minutes=15,\n ),\n]\n\nresponse = solar_api.post_measurements(pv_measurements)\nprint(response)\n\n```\nPlease go to our docs for detailed information [alitiq-Docs](https://docs.alitiq.com)\n\n---\n\n## Project Structure \ud83c\udfd7\ufe0f \n\n```plaintext\nalitiq/\n\u2502\u2500\u2500 enumerations/\n\u2502 \u2502\u2500\u2500 __init__.py\n\u2502 \u2502\u2500\u2500 forecast_models.py\n\u2502 \u2502\u2500\u2500 services.py\n\u2502\n\u2502\u2500\u2500 models/\n\u2502 \u2502\u2500\u2500 __init__.py\n\u2502 \u2502\u2500\u2500 load_forecast.py\n\u2502 \u2502\u2500\u2500 solar_power_forecast.py\n\u2502 \u2502\u2500\u2500 wind_power_forecast.py\n\u2502\n\u2502\u2500\u2500 __init__.py\n\u2502\u2500\u2500 base.py\n\u2502\u2500\u2500 load_forecast.py\n\u2502\u2500\u2500 solar_power_forecast.py\n\u2502\u2500\u2500 wind_power_forecast.py\n\n```\n\n---\n\n## Key Modules \ud83d\udcda \n\n### Solar Forecasting Module (`solar_power_forecast.py`) \nManage PV systems and retrieve solar power forecasts. Key methods: \n- `create_location`: Add new PV system configurations.\n- `list_locations`: List current portfolio\n- `delete_location`: Deletes one location from portfolio\n- `get_forecast`: Retrieve solar power forecasts for a specific location. \n- `get_forecast_portfolio`: Retrieve solar power forecasts for the whole portfolio. \n- `push_measurements`: Submit real-time measurements for your solar plant. \n- `get_measurements`: Retrieve historical data for a location. \n\n### Wind Forecasting Module (`wind_power_forecast.py`) \nManage WindParks and retrieve wind power forecasts. Key methods: \n- `create_location`: Add new WindPark configurations.\n- `list_locations`: List current portfolio\n- `delete_location`: Deletes one location from portfolio\n- `get_forecast`: Retrieve wind power forecasts for a specific location. \n- `get_forecast_portfolio`: Retrieve wind power forecasts for the whole portfolio. \n- `push_measurements`: Submit real-time measurements for your WindPark. \n- `get_measurements`: Retrieve historical data for a location. \n\n### Load Forecasting Module (`load_forecast.py`) \nInteract with alitiq's load forecast API for heat, gas, and electricity. Key methods: \n- `get_measurements`: Retrieve historical data for a location. \n- `post_measurements`: Push new measurement data. \n- `get_forecast`: Fetch load forecasts for your configured location. \n\n---\n\n## Contributing \ud83e\udd1d \nWe welcome contributions! To contribute: \n1. Fork the repository. \n2. Create a new branch: \n ```bash\n git checkout -b feature/new-feature\n ```\n3. Commit your changes: \n ```bash\n git commit -m \"Add a new feature\"\n ```\n4. Push to your branch and submit a pull request. \n\n---\n\n## License \ud83d\udcdc \n\nMIT License, see attached LICENSE\n\n---\n\n## Developer Notes\n\nRun `python3 -m build` to build the package and then upload with twine: `twine upload -r pypi dist/*` \n\n---\n\n## Support & Contact \ud83d\udce7 \nFor any questions or issues, please contact [support@alitiq.com](mailto:support@alitiq.com). \n\n\ud83c\udf1f **Happy Forecasting!** \ud83c\udf1f\n",
"bugtrack_url": null,
"license": "IP belongs to alitiq GmbH",
"summary": "alitiq python SDK",
"version": "2025.2.19",
"project_urls": null,
"split_keywords": [
"energy",
" forecasting",
" solar",
" pv",
" demand",
" prediction",
" wind",
" windpower",
" solarpower",
" power",
" powerprediction"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "85eed9c47b2e9aff3b382500efcccc6b12b89b92e6f26c2d7ad87ddaa5c335cd",
"md5": "ccc94e9f828c60e316ceabf789d7fb76",
"sha256": "d09c5347a7d4b929c4fc5c94cd0d0c62d875e5b27a3e6f32001179254c64cb90"
},
"downloads": -1,
"filename": "alitiq-2025.2.19-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ccc94e9f828c60e316ceabf789d7fb76",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 19295,
"upload_time": "2025-02-18T09:54:28",
"upload_time_iso_8601": "2025-02-18T09:54:28.053662Z",
"url": "https://files.pythonhosted.org/packages/85/ee/d9c47b2e9aff3b382500efcccc6b12b89b92e6f26c2d7ad87ddaa5c335cd/alitiq-2025.2.19-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5a3a3e647aecc49e72ba813eb61c4737a7354b036072ffd401dca16a814fae0e",
"md5": "f7731333c87f7a2cdb8915f4695fc450",
"sha256": "8d9d07aa0bb26027072c6f4026881f282f724f607fc5e302529f21d10f926b2e"
},
"downloads": -1,
"filename": "alitiq-2025.2.19.tar.gz",
"has_sig": false,
"md5_digest": "f7731333c87f7a2cdb8915f4695fc450",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 13732,
"upload_time": "2025-02-18T09:54:29",
"upload_time_iso_8601": "2025-02-18T09:54:29.327260Z",
"url": "https://files.pythonhosted.org/packages/5a/3a/3e647aecc49e72ba813eb61c4737a7354b036072ffd401dca16a814fae0e/alitiq-2025.2.19.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-18 09:54:29",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "alitiq"
}