📤 Export de données
L'export de données vous remet, dans un classeur Excel ou un fichier CSV, les séries que PVReactive connaît pour vos installations : production, production théorique, consommation, flux avec le réseau, bridage et météo. Une station se télécharge sur-le-champ ; un site ou un compte entier est préparé en tâche de fond et vous est signalé par mail.
Rôles concernés
Ce que l'on peut exporter
- Une station — bouton « Exporter les données » sur la fiche de la station, à côté du lien vers le portail du constructeur. Le fichier est produit pendant que vous patientez et se télécharge directement : comptez jusqu'à une minute pour un an de données à l'heure.
- Un site — bouton « Exporter les données » sur la fiche du site. Toutes les stations suivies du site sont exportées, une par une, dans le même fichier.
- Un compte entier — bouton « Exporter les données » sur la fiche du compte. Toutes les stations suivies du compte sont exportées.
Les exports d'un site ou d'un compte sont préparés en tâche de fond : vous pouvez fermer la page, un mail vous prévient dès que le fichier est prêt.
Préparer un export, en cinq étapes
L'écran d'export est le même pour une station, un site ou un compte.
- Modèle — choisissez un point de départ : il coche les séries, fixe le pas de temps et propose une période. Tout reste modifiable ; dès que vous retouchez la sélection, elle devient « personnalisée ».
- Séries — cochez celles dont vous avez besoin. Elles sont rangées par famille, chacune avec son unité et sa définition.
- Annexes (facultatives) — joignez au fichier les tableaux qui accompagnent les séries : facteur de puissance, périodes de bridage, journal des événements (voir plus bas).
- Période et pas de temps — du premier au dernier jour inclus, sans dépasser aujourd'hui, à l'heure, au jour ou au mois.
- Format — classeur Excel ou CSV, puis « Télécharger le fichier » (une station) ou « Préparer le fichier » (un site, un compte).
Les quatre modèles fournis
| Modèle | Contenu | Pas et période proposés |
|---|---|---|
| Étude stockage ou extension | Production, consommation, autoconsommation, injection et soutirage, production théorique, potentiel non bridé, surplus perdu par bridage, charge et décharge de la batterie. | À l'heure, sur les 12 derniers mois complets. |
| Bilan d'autoconsommation | Flux avec le réseau, taux d'autoconsommation et taux d'autoproduction, charge et décharge de la batterie. | Au mois, sur les 12 derniers mois complets. |
| Reporting mensuel | Production, production théorique, ratio de performance, irradiation et température de l'air. | Au jour, sur le mois précédent. |
| Données brutes | Toutes les séries disponibles. | À l'heure, sur le mois précédent. |
Les modèles de votre compte
Sous le formulaire, « Enregistrer comme modèle du compte » mémorise les séries, les annexes et le pas choisis sous le nom de votre choix. Le modèle est ensuite proposé dans l'écran d'export de toutes les stations et de tous les sites du compte, signalé par un marque-page. Il ne fixe pas de période : vous la choisissez à chaque export. Un modèle se supprime depuis la même zone.
Les séries disponibles
| Famille | Série (unité) | Ce qu'elle mesure |
|---|---|---|
| Production | Production (kWh) | Énergie produite, relevée sur les onduleurs. Quand un onduleur n'a rien transmis pour une heure alors que le compteur a mesuré de la production, c'est la valeur du compteur qui est retenue ; le classeur Excel indique combien d'heures ont été complétées ainsi. |
| Théorique et performance | Production théorique (kWh) | Production attendue d'après l'ensoleillement, transposée sur le plan des modules quand la station a ses plans d'installation. |
| Ratio de performance (%) | Production divisée par la production théorique, sur les heures où les deux sont connues. | |
| Bridage | Potentiel non bridé (kWh) | Ce que la centrale aurait pu produire sans bridage : la production théorique corrigée du rendement constaté hors bridage, plafonnée à la puissance maximale des onduleurs, et jamais inférieure à la production réelle de l'heure. |
| Surplus perdu par bridage (kWh) | Potentiel non bridé moins production, compté seulement aux heures où la centrale est bridée. | |
| Plafond de puissance (kW) | Le plafond en sortie d'onduleurs en vigueur ce jour-là, celui qui borne le potentiel non bridé. Vide sans plafond, ou quand le plafond porte sur le point de livraison. Au jour et au mois, c'est le plus haut plafond en vigueur qui est retenu : un plafond ne s'additionne pas. | |
| Flux réseau et consommation | Consommation du site (kWh) | Autoconsommation plus soutirage : ce que le site a consommé. |
| Autoconsommation (kWh) | Part de la production consommée sur place. | |
| Injection réseau (kWh) | Énergie envoyée sur le réseau. | |
| Soutirage réseau (kWh) | Énergie achetée au réseau. | |
| Taux d'autoconsommation (%) | Autoconsommation divisée par la production, sur les heures où le compteur mesure. | |
| Taux d'autoproduction (%) | Autoconsommation divisée par la consommation du site : la part de la consommation couverte par le solaire. | |
| Batterie | Charge de la batterie (kWh) | Énergie stockée dans la batterie, relevée chez le constructeur. Vide quand la station n'a pas de batterie ou que son constructeur ne la remonte pas. |
| Décharge de la batterie (kWh) | Énergie restituée par la batterie. | |
| Jumeau numérique (Pack Advanced) | Production attendue par le jumeau (kWh) | Ce que le jumeau numérique attendait de la station, bridage d'exploitation compris : la référence des graphiques du Pack Advanced. Calculée aux heures de jour. |
| Irradiation dans le plan des modules (kWh/m²) | Rayonnement reçu par les modules selon le jumeau, pondéré par la puissance de chaque pan. | |
| Production ÷ attendu du jumeau (%) | Production divisée par la production attendue, sur les heures où les deux sont connues. | |
| Météo | Irradiation horizontale (kWh/m²) | Rayonnement global horizontal de la source météo de la station. |
| Température de l'air (°C) | Température à 2 m, moyenne sur la période. | |
| Vitesse du vent (m/s) | Vent à 10 m, moyenne sur la période. | |
| Précipitations (mm) | Cumul de pluie et de neige fondue. |
Les séries de consommation demandent un compteur
Les séries du jumeau numérique demandent le Pack Advanced
Les annexes
Les annexes joignent à l'export des tableaux qui ne sont pas des séries horaires. Elles sont bornées à la période choisie, toutes stations réunies avec une colonne « Station » : une feuille par annexe dans le classeur Excel, une section à la fin du fichier dans le CSV, séparée par une ligne vide et un titre.
- Facteur de puissance — les périodes pendant lesquelles la consigne de facteur de puissance a gardé le même verdict, puis le relevé de chaque jour et de chaque appareil : pente entre puissance réactive et puissance active, cos phi médian, nombre d'échantillons, puissance maximale, et verdict. Ce sont les mêmes colonnes que l'export de l'historique sur la fiche station. Le verdict compare au standard du parc (cos phi 0,944) : il informe, il n'accuse pas. Réservée au propriétaire et aux administrateurs du compte.
- Périodes de bridage — les plafonds de puissance datés en vigueur pendant la période, avec leur origine et leur note.
- Journal des événements — les événements de la station pendant la période : nettoyage, remplacement de matériel, intervention.
Une annexe sans rien à montrer pour une station le dit en une ligne, par exemple « Aucun relevé de facteur de puissance sur la période ».
Comment les valeurs sont calculées
- Une valeur inconnue reste une cellule vide, jamais un zéro. Un zéro est une mesure nulle ; une cellule vide, une donnée qui n'a pas été transmise.
- Heures légales françaises — une ligne par heure de l'horloge locale, la ligne 08:00 couvrant 08:00 à 09:00. L'heure qui n'existe pas au passage à l'heure d'été n'apparaît pas.
- Au jour et au mois — les énergies sont additionnées, la température et le vent moyennés, sur les heures renseignées ; le plafond de puissance est le plus haut en vigueur.
- Les taux, le ratio de performance et le rapport au jumeau d'un jour ou d'un mois sont recalculés à partir des sommes de leurs heures, et non comme la moyenne des valeurs horaires : une heure d'aube ne pèse pas autant que midi.
Les formats
- Excel (.xlsx) — un classeur en trois onglets, plus un par annexe demandée :
- Données : une ligne par période et par station, les dates en vraies dates Excel ;
- Couverture : mois par mois et série par série, la part des heures renseignées, puis les périodes d'au moins six heures que la station n'a pas transmises, avec leurs dates ;
- Métadonnées : le périmètre, la période, le modèle, la méthode de la production théorique, ce que l'export a complété, et la définition de chaque série.
- CSV pour Excel français — séparateur point-virgule et virgule décimale : le fichier s'ouvre tel quel dans un Excel réglé en français.
- CSV international — séparateur virgule et point décimal, celui qu'attendent la plupart des outils de calcul.
Les fichiers CSV portent les données, sans couverture ni métadonnées ; les annexes demandées s'y ajoutent à la fin. Pour savoir si une somme mensuelle repose sur un mois complet, préférez le classeur Excel.
La page « Exports »
La page Exports, accessible depuis le menu, liste les exports du compte : date de la demande, périmètre et nombre de stations, période, pas et format, auteur de la demande et état. Tant qu'un export est en préparation, la page se met à jour toute seule.
- En attente puis en cours — le fichier est en préparation.
- Prêt — le bouton « Télécharger » est disponible, avec sa date limite.
- Échec — le motif est affiché ; relancez l'export depuis la fiche du site ou du compte.
- Expiré — le fichier a été effacé au bout de sept jours ; la ligne reste pour l'historique.
Le mail « Votre export de données est prêt »
Quand un export préparé en tâche de fond (un site, un compte, ou un export programmé) est prêt, son demandeur reçoit un mail avec un lien de téléchargement, valable sept jours. Ce lien demande d'être connecté à PVReactive avec un accès propriétaire ou administrateur au compte exporté : transmis à un tiers, il ne lui ouvre pas le fichier. Si la préparation échoue, le mail le dit aussi.
Recevoir un export automatiquement
Sous le formulaire, « Recevoir cet export automatiquement » programme le même export à intervalle régulier : mêmes séries, mêmes annexes, même pas, même format, sur la période qui vient de s'écouler.
- Chaque 1er du mois, le mois précédent ;
- Chaque lundi, la semaine précédente (du lundi au dimanche).
Les exports programmés partent vers 6 h et vous arrivent par le mail habituel. Ils apparaissent en tête de la page Exports, avec leur prochain envoi : vous pouvez les suspendre, les reprendre ou les supprimer. Une programmation dont le destinataire perd son accès complet au compte est désactivée automatiquement.
Limites
| Limite | Valeur | Que faire au-delà |
|---|---|---|
| Période au pas horaire | 400 jours | Découpez la période, ou passez au pas journalier ou mensuel (une dizaine d'années possible). |
| Taille d'un classeur Excel | 400 000 cellules | Choisissez le CSV, un pas plus long ou une période plus courte. L'export est alors refusé avec ce conseil. |
| Exports en préparation | 3 par compte | Attendez qu'un export se termine. Un export programmé qui tombe pendant ce temps est reporté à l'heure suivante. |
| Conservation d'un fichier | 7 jours | Relancez l'export : les données ne sont pas perdues, seul le fichier est effacé. |
Un an de données horaires pour plusieurs stations
Exporter par l'API
Les mêmes exports se demandent par l'API PVReactive, avec un jeton qui porte la permission production:read :
on demande l'export, on suit son état, puis on télécharge le fichier, disponible sept jours. Un export demandé par l'API
n'envoie pas de mail. Les règles et les limites sont les mêmes que dans l'écran, annexes comprises (champ
annexes) ; un jeton restreint à certaines
stations n'exporte que celles-là. Voir la page OAuth pour obtenir un jeton.