# Solar Simulator

> Kostenloser PV-Ertragssimulator mit Live-Kalibrierung via Home Assistant und ioBroker

Solar Simulator ist eine kostenlose Web-Applikation zur Simulation des Photovoltaik-Ertrags
am eigenen Standort. Die Anwendung nutzt echte Wetterdaten von Open-Meteo, astronomisch
präzise Sonnenberechnungen und optionale Live-Integration mit Home Assistant (WebSocket) oder
ioBroker (simple-api). Alle Berechnungen erfolgen direkt im Browser, ohne Backend-Server.

## Kernfunktionen

- **Live-Kalibrierung**: Echtzeitverbrauch via Home Assistant WebSocket oder ioBroker simple-api
- **Batteriesimulation**: C-Rate-Modell (0,5 C / max. 5 kW), Zwei-Pass Carry-Over für realistischen Tagesverlauf
- **Sonnenberechnung**: Astronomische Formeln (Deklination, Stundenwinkel, Elevationswinkel)
- **Wetterdaten**: Open-Meteo API – Globalstrahlung, Bewölkung, Temperatur, stündlich
- **Wirtschaftlichkeit**: Eigenverbrauch, Ersparnis, CO₂-Bilanz, Amortisation
- **Mehrere Dachflächen**: Beliebige Ausrichtung (0–360°) und Neigung (0–90°)

## Technische Kennzahlen

- Simulationsauflösung: 15-Minuten-Slots (96 Datenpunkte/Tag)
- Speicherunterstützung: 1 kWh – 30 kWh
- Live-Update-Intervall: 5 s (ioBroker Polling) / Push (Home Assistant WebSocket)
- Genauigkeit: ±10 % gegenüber realen Anlagen
- Standorte: weltweit (Geocoding via Open-Meteo)

## Integrationen

- Home Assistant: WebSocket API, Long-Lived Access Token, beliebige Entity-ID
- ioBroker: simple-api Adapter (Standard-Port 8087), HTTP Polling, beliebiger Datenpunkt

## Docs

- [Startseite / Landingpage](https://solarsimulator.klickwerk.digital/)
- [Simulator (App)](https://solarsimulator.klickwerk.digital/#simulator)
- [AI Summary](https://solarsimulator.klickwerk.digital/ai/summary.json)
- [FAQ (JSON)](https://solarsimulator.klickwerk.digital/ai/faq.json)
- [Service (JSON)](https://solarsimulator.klickwerk.digital/ai/service.json)
- [RSS Feed](https://solarsimulator.klickwerk.digital/feed.xml)
- [Sitemap](https://solarsimulator.klickwerk.digital/sitemap.xml)

## Optional

- [Open-Meteo Wetterdaten](https://open-meteo.com)
- [Home Assistant Dokumentation](https://www.home-assistant.io/docs/authentication/)
- [ioBroker simple-api](https://github.com/ioBroker/ioBroker.simple-api)