powersync-docs/docs/fonctionnalites/prevision-pv.md

# Prévision de production PV

<span class="badge testing">BETA</span> <span class="badge community">COMMUNITY</span>

La box prévoit la production de vos panneaux, heure par heure, jusqu'à la fin du
lendemain, et l'affiche dans l'application à côté de la production mesurée. C'est une
fonction de la version **Community** (GPL-3.0) : elle repose sur le moteur d'énergie et
sur le plugin [OpenMeteo](../appareils/tarifs/openmeteo.md), sans aucun service ETM.

!!! info "Beta"
    Livrée et en fonctionnement sur notre installation de test, elle n'est pas encore
    publiée dans un canal du dépôt APT.

## Ce que vous voyez dans l'application

- **La courbe de production prévue**, heure par heure jusqu'à la fin du lendemain,
  superposée à la production mesurée.
- **Une fourchette météo** autour de cette courbe (voir plus bas).
- **La météo heure par heure** sur la carte « Journée » : une icône (soleil, nuages,
  pluie…), le jour ou la nuit, et la température.

## Comment la prévision est calculée

Pour chaque plan PV déclaré — inclinaison, orientation, puissance crête (kWc) et
rendement du système —, la box convertit l'irradiance prévue par Open-Meteo en
puissance. Elle additionne ensuite tous les plans du site.

Deux corrections s'appliquent, toutes deux **déterministes** : des modèles physiques
publics, paramétrés par les fiches techniques, sans aucun apprentissage.

- **Correction de température** : un module chaud produit moins. La box l'estime à partir
  de la température prévue, de la NOCT et du coefficient de température des modules.
- **Plafond onduleur** : la somme des plans ne dépasse jamais la puissance AC maximale de
  l'onduleur, si elle a été renseignée.

La prévision est recalculée à chaque nouvelle publication des modèles météo, soit au plus
une fois par heure.

### Une prévision, et un plafond optimiste

Ce que la box affiche est une **prévision**, pas une mesure. C'est aussi un **plafond
optimiste** : l'ombrage (arbres, cheminée, bâtiments voisins) et l'encrassement des
panneaux ne sont pas modélisés. Une production réelle sous la courbe est donc normale et
ne signale pas une panne.

### Une heure sans donnée est un trou, jamais un zéro

Si une heure manque (internet coupé, service météo indisponible), la courbe s'interrompt.
La box n'écrit jamais « 0 » à la place : un zéro se lirait comme « pas de soleil prévu ».

## La fourchette météo

Autour de la courbe, l'application trace une bande :
**prévu × (1 ± dispersion des modèles du jour)**. La dispersion mesure à quel point
plusieurs modèles météo divergent pour la journée.

Cette bande qualifie **la météo**, et seulement la météo. Elle ne dit rien de la
précision de la prévision de production : l'ombrage et l'encrassement n'y figurent pas.
Par grand beau temps stable, elle est étroite alors que l'écart dû à ces facteurs est le
plus fort. Ce n'est donc ni une « erreur attendue » ni un « intervalle de confiance ».

## Mise en service

1. Installez le plugin OpenMeteo et créez le **site** et ses **plans PV** — voir la
   [fiche OpenMeteo](../appareils/tarifs/openmeteo.md).
2. **Désignez le site de prévision** dans l'application. Tant qu'aucun site n'est
   désigné, la carte de prévision affiche « Aucun site de prévision désigné » et
   propose les sites disponibles. Tous les plans du site désigné sont additionnés.
3. Facultatif : renseignez le **plafond onduleur** (puissance AC maximale, en W).
   Sans lui, aucun plafond n'est appliqué.

## Ce que la prévision ne fait pas

C'est la règle centrale de la version Community : **sans optimiseur, le pilotage se fait
par règles** (surplus solaire, délestage, priorités). La prévision PV, le
[tarif saisi](../tarifs.md) et la consommation de base sont **affichés** et
**enregistrés localement**, mais ils ne servent jamais à décider. Un test automatique
le vérifie : le moteur prend les mêmes décisions avec ou sans prévision, tarif et profil
de consommation.

L'enregistrement local sert à mesurer la précision des prévisions dans le temps. La
validation sur une installation réelle est en cours ; aucun chiffre de précision n'est
publié avant qu'elle soit terminée.

## Consommation de base prévue <span class="badge nightly">À VENIR</span>

La box calculera un profil de consommation du foyer, hors charges pilotées, à partir de
ses propres mesures : une médiane par heure de la journée, séparée entre jours ouvrés
et week-end. Il faut au moins **7 jours** de mesures avant qu'un profil existe.
D'ici là, rien n'est affiché : une absence, jamais un zéro.

## Vos données

Seul le plugin OpenMeteo se connecte à internet. Il n'envoie que les **coordonnées du
site** (arrondies à environ 1 km dans les versions du plugin qui portent cette fonction ; la version `1.15.2+etm1` du canal testing les envoie sans arrondi), son **altitude** si elle est renseignée, et
l'**orientation des panneaux** (inclinaison, azimut). Les mesures, les prévisions
enregistrées, le tarif et la consommation restent sur la box. L'accès à distance est
désactivé par défaut : il ne s'ouvre que si vous l'activez vous-même dans
l'application.

## Et un optimiseur ?

L'architecture prévoit une **interface ouverte et documentée** vers un optimiseur externe,
qui pourrait utiliser ces prévisions pour planifier. L'optimisation tournerait chez vous,
sur la box ou sur une machine de votre réseau local. Cette connexion est en cours de
développement ; la version Community fonctionne entièrement sans elle.