HALOWERKSolarwerk
autonomy forecast
Daily energy balance and straight run-down from the figures supplied. Solar input is caller data in watt-hours per day; nothing is fetched and no weather is assumed. Time to empty means time to the reserve floor, not to zero. Idle draw and conversion efficiency apply to AC loads only. Ageing, temperature and Peukert behaviour are not modelled, which matters for lead acid far more than for LiFePO4.
POST https://solar.halowerk.com/autonomy-forecastEingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| battery | object | Ja | |
| loads | array | Ja | |
| inverter | object | Nein | |
| daily_solar_input_wh | number | Nein | Expected harvest per day. |
Vollständiges Eingabeschema anzeigen
{
"type": "object",
"required": [
"battery",
"loads"
],
"additionalProperties": false,
"properties": {
"battery": {
"type": "object",
"required": [
"soc_percent"
],
"additionalProperties": false,
"properties": {
"capacity_wh": {
"type": "number",
"minimum": 10,
"maximum": 10000000
},
"capacity_ah": {
"type": "number",
"minimum": 1,
"maximum": 100000
},
"nominal_voltage_v": {
"type": "number",
"minimum": 6,
"maximum": 1000,
"default": 12
},
"soc_percent": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"reserve_soc_percent": {
"type": "number",
"minimum": 0,
"maximum": 90,
"default": 20,
"description": "Floor not to be crossed."
}
}
},
"loads": {
"type": "array",
"minItems": 1,
"maxItems": 60,
"items": {
"type": "object",
"required": [
"name",
"watts"
],
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"watts": {
"type": "number",
"minimum": 0,
"maximum": 50000
},
"hours_per_day": {
"type": "number",
"minimum": 0,
"maximum": 24,
"default": 24
},
"dc": {
"type": "boolean",
"default": false,
"description": "True for loads fed straight from the battery."
}
}
}
},
"inverter": {
"type": "object",
"additionalProperties": false,
"properties": {
"efficiency": {
"type": "number",
"minimum": 0.5,
"maximum": 1,
"default": 0.9
},
"idle_w": {
"type": "number",
"minimum": 0,
"maximum": 500,
"default": 15
},
"hours_powered_per_day": {
"type": "number",
"minimum": 0,
"maximum": 24,
"default": 24
}
}
},
"daily_solar_input_wh": {
"type": "number",
"minimum": 0,
"maximum": 1000000,
"default": 0,
"description": "Expected harvest per day."
}
}
}Veröffentlichtes Eingabebeispiel
{
"battery": {
"capacity_wh": 2400,
"soc_percent": 80,
"reserve_soc_percent": 20
},
"loads": [
{
"name": "router",
"watts": 10,
"hours_per_day": 24,
"dc": true
}
],
"daily_solar_input_wh": 300
}Ergebnis & Dokumentation
Veröffentlichtes Ergebnisschema anzeigen
{
"$ref": "https://solar.halowerk.com/autonomy-forecast/schema#/outputSchema"
}Veröffentlichtes Ergebnisbeispiel öffnen
Maschinenlesbare Dokumentation dieses Hubs
Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.
Weitere Endpunkte dieses Hubs
- Solarwerk0,004 USDC
battery cycle
POSThttps://solar.halowerk.com/battery-cycleIntegrates the supplied current over time by the trapezoidal rule, so the result is only as good as the sampling interval; gaps longer than the stated max_gap_seconds are excluded and reported. Sign convention: positive current is charging,
- Solarwerk0,004 USDC
building heat demand
POSThttps://solar.halowerk.com/building-heat-demandComputes a transparent planning estimate for space-heating demand. The method is not DIN, VDI, GEG or PHPP and must not be used as regulatory proof. It combines transmission heat loss from each envelope component, ventilation heat loss from
- Solarwerk0,003 USDC
clear sky yield
POSThttps://solar.halowerk.com/clear-sky-yieldThis is an astronomical and geometric calculation, not a forecast. It assumes a cloudless sky and states the models used; real yield is lower whenever there is cloud, haze, snow, soiling or high cell temperature. The system_derate factor co