HALOWERKSolarwerk
shadow simulator
Pure astronomy and geometry on level ground: sun position by the NOAA method, shadow length as object height divided by the tangent of the sun elevation. Refraction is only applied to sunrise and sunset. Terrain slope, surrounding buildings, vegetation and diffuse light are not modelled, so a point outside the shadow can still be shaded in reality. Times are UTC.
POST https://solar.halowerk.com/shadow-simulatorEingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| lat | number | Ja | |
| lon | number | Ja | |
| date | string | Ja | Day as YYYY-MM-DD. |
| object_height_m | number | Ja | |
| step_minutes | integer | Nein | |
| obstacle_distance_m | number | Nein | Distance of the point of interest from the object. |
| obstacle_bearing_deg | number | Nein | Compass bearing from the object to that point. |
| bearing_tolerance_deg | number | Nein | |
| max_shadow_length_m | number | Nein | Shadow lengths above this are reported as capped. |
Vollständiges Eingabeschema anzeigen
{
"type": "object",
"required": [
"lat",
"lon",
"date",
"object_height_m"
],
"additionalProperties": false,
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"date": {
"type": "string",
"description": "Day as YYYY-MM-DD."
},
"object_height_m": {
"type": "number",
"minimum": 0.01,
"maximum": 1000
},
"step_minutes": {
"type": "integer",
"minimum": 5,
"maximum": 60,
"default": 30
},
"obstacle_distance_m": {
"type": "number",
"minimum": 0.01,
"maximum": 10000,
"description": "Distance of the point of interest from the object."
},
"obstacle_bearing_deg": {
"type": "number",
"minimum": 0,
"maximum": 360,
"description": "Compass bearing from the object to that point."
},
"bearing_tolerance_deg": {
"type": "number",
"minimum": 1,
"maximum": 90,
"default": 10
},
"max_shadow_length_m": {
"type": "number",
"minimum": 1,
"maximum": 100000,
"default": 500,
"description": "Shadow lengths above this are reported as capped."
}
}
}Veröffentlichtes Eingabebeispiel
{
"lat": -90,
"lon": -180,
"date": "beispiel",
"object_height_m": 0.01,
"step_minutes": 30,
"bearing_tolerance_deg": 10,
"max_shadow_length_m": 500
}Ergebnis & Dokumentation
Maschinenlesbare Dokumentation dieses Hubs
Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.
Weitere Endpunkte dieses Hubs
- Solarwerk0,003 USDC
autonomy forecast
POSThttps://solar.halowerk.com/autonomy-forecastDaily 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
- 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