Référence : glossaire, formats de fichiers & dépannage

En un coup d'œil

  • Cette annexe est la référence de consultation que vous ouvrez après avoir pris vos repères dans les onglets : elle définit chaque ligne du diagramme de pertes, chaque fichier que pvSpline lit et écrit, et chaque acronyme figurant sur la couverture du rapport.

  • Utilisez le glossaire de la cascade de pertes pour lire un diagramme de Sankey ligne par ligne : chaque entrée indique le nom affiché à l'écran, l'endroit de la chaîne où elle s'applique et ce qu'elle signifie physiquement.

  • Utilisez la référence des formats de fichier pour savoir ce qu'un projet .pvspline.json conserve (y compris les séries météo et de consommation embarquées qui permettent d'ouvrir un projet sans réseau), ce que contiennent les imports .PAN/.OND/.BTR et les exports CSV/XLSX/PDF/JSON, et quelle taille de fichier vous pouvez téléverser.

  • Utilisez le glossaire des acronymes, la référence clavier et souris et le dépannage / FAQ lorsqu'un point reste obscur ou qu'un calcul échoue.

  • Rien ici n'exige un projet chargé : c'est de la référence pure, et chaque section est une ancre à mettre en favori, sur sa propre page. Pour la physique derrière les chiffres, voir Physique de simulation & référence des données ; pour les vues qui les produisent, voir Lancer une simulation & l'onglet Production, Graphiques, cartes de chaleur & tableaux et Rapports & export.

La cascade de pertes, ligne par ligne

Chaque simulation pvSpline produit une seule cascade de pertes ordonnée : la chaîne qui transforme la lumière du soleil arrivant sur vos modules en énergie livrée au compteur. C'est ce que dessinent le diagramme de pertes de Sankey (Graphiques, cartes de chaleur & tableaux) et la page de pertes du rapport (Rapports & export), et c'est le même ordre dans le PDF, l'export CSV et le graphique à l'écran. L'ordre est canonique et fixe (irradiance d'abord, raccordement au réseau en dernier), de sorte qu'un auditeur peut le faire correspondre ligne par ligne à un diagramme de pertes PVsyst.

Quelques conventions rendent le diagramme lisible :

  • La plupart des lignes sont des pertes : l'énergie diminue à mesure que l'on descend. Une poignée d'entre elles sont des gains (un crédit, dessiné comme une marche montante) : la transposition, la face arrière bifaciale, la concentration LCPV et le crédit de récupération lors d'une coupure batterie, ainsi que la température, sur un site où les heures froides l'emportent sur les heures chaudes.

  • Certaines lignes sont des entrées fantômes. Le solveur physique a déjà soustrait cette énergie en amont (par exemple, l'ombrage lointain/horizon est intégré au total du plan des modules avant même que les cellules ne le voient) ; la ligne fantôme fait apparaître le montant caché pour le diagramme sans le déduire deux fois.

  • Une ligne n'apparaît que lorsqu'elle est non nulle pour votre projet. Une toiture à inclinaison fixe sans trackers, sans optimiseurs et sans transformateur affiche peut-être une douzaine de lignes ; une grande installation au sol avec trackers, coffrets de combinaison, transformateurs MT/HT et un réseau faible en affiche la plupart.

  • Sur le diagramme, un libellé peut porter, à la suite des noms listés ci-dessous, un qualificatif qui indique comment son chiffre a été obtenu : (hourly integrated), (computed), (scheduled), (STC, local), (3-D bake) et autres.

  • Chaque ligne porte une étiquette de provenance (voir Rapports & export) indiquant d'où vient son chiffre : une valeur que vous avez saisie, une décomposition attestée par PVGIS pour votre site exact, une perte météo calculée par Open-Meteo, ou une intégration heure par heure sur votre nomenclature dimensionnée.

Le tableau ci-dessous répertorie chaque ligne dans l'ordre de la cascade, regroupée par l'étape à laquelle elle appartient.

La cascade de pertes unifiée, dans l'ordre canonique de haut en bas.
Ligne du diagramme de pertesSignification
Étape de transpositionL'irradiance horizontale reprojetée sur le champ incliné.
Transposition (GHI → POA)Gain. L'irradiance supplémentaire qu'un plan incliné et orienté collecte par rapport à la valeur au sol horizontale et plate. Positive car un champ bien orienté voit plus de soleil que le capteur horizontal de la station météo.
Ombrage lointain (horizon)Fantôme. Rayonnement direct bloqué par la silhouette du terrain lointain (l'horizon PVGIS à 36 points ou une ligne d'horizon échantillonnée). Retranché du total du plan des modules avant que les cellules ne le convertissent.
Ombrage inter-rangéesFantôme. Ombrage mutuel de proximité entre rangées voisines à faible inclinaison sur des dispositions en dôme Est–Ouest, plus tout masquage de la vue du ciel sur les champs plans. Un précalcul d'ombrage 3D renomme la ligne d'après ce qu'il a mesuré (par exemple Ombrage proche — masquage du ciel (3D)). Nul pour une rangée unique en champ ouvert.
Backtracking / butée de rotation (trackers)Fantôme. Irradiance dans le plan des modules qu'un suiveur mono-axe abandonne en se tenant à sa rotation de backtracking ou saturée en butée, au lieu de l'angle de suivi idéal pour lequel l'irradiance PVGIS a été calculée (Suivi). Uniquement sur un suiveur dont le GCR de backtracking est supérieur à 0 ou qui a une limite de rotation ; nul pour une inclinaison fixe et pour un suivi idéal.
Mise en sécurité vent (wind-stow)Fantôme. Énergie abandonnée lorsque les trackers sont amenés à leur angle de mise en sécurité pendant les heures où la vitesse du vent dépasse le seuil configuré. Nul pour une inclinaison fixe ou lorsque la mise en drapeau au vent est désactivée.
Étape optiqueCe qui est perdu avant que les cellules ne convertissent quoi que ce soit.
Gain de concentration (LCPV)Gain. Rayonnement direct supplémentaire que les optiques à faible concentration (auges, auges en V, CPC) délivrent à la cellule. Uniquement sur les projets LCPV.
LCPV — pertes optiques (réflecteur/lentille)Absorption et salissure dans le réflecteur ou l'empilement de lentilles LCPV.
LCPV — hors de l'angle d'acceptanceRayonnement direct qui manque le cône d'acceptance du concentrateur (erreur saisonnière / de pointage).
LCPV — rejet du rayonnement diffusLumière diffuse du ciel qu'un plan fixe aurait conservée mais qu'un concentrateur rejette.
Ombrage mutuel — direct (rangées/brise-soleil)Fraction de rayonnement direct qu'une rangée illimitée ou un brise-soleil projette sur la suivante.
Ombrage proche — végétation (précalcul 3D, canopée)La part de l'ombrage direct de proximité venue de la végétation plutôt que du terrain, des rangées ou des bâtiments : des arbres qui atténuent le direct, mesurés sur la canopée de la scène 3D. Extraite de la ligne d'ombrage direct entre rangées (qui conserve la part de géométrie opaque), si bien que les deux réunies valent ce qu'une seule ligne valait autrefois. N'apparaît que sur les projets dont le précalcul d'ombrage 3D a vu une canopée (La vue Terre 3D du site).
Ombrage mutuel — diffus + sol (rangées/brise-soleil)Fraction diffuse et réfléchie par le sol masquée par les rangées ou brise-soleil voisins.
Angle d'incidenceRéflexion sur le verre lorsque la lumière frappe de biais (IAM). Lue sur la propre courbe IAM mesurée du module lorsqu'elle est disponible.
SalissuresPoussière et saleté sur le verre. Calculé par le modèle de Kimber à partir des pluies Open-Meteo, qui lavent les modules, et, pour les années que couvre l'historique de qualité de l'air, de ses poussières PM10 (les autres années prennent le taux d'encrassement quotidien constant du modèle). Un pourcentage saisi s'applique lorsque le projet n'a pas d'historique Open-Meteo ou que Auto (météo) est désactivé.
NeigeCouverture de neige sur les modules. Calculée à partir des chutes de neige d'Open-Meteo (modèle Marion) lorsqu'elles sont disponibles.
SpectralÉcart entre le spectre solaire réel (masse d'air, vapeur d'eau) et le spectre de référence STC.
Étape physique du moduleConversion de la lumière dans le plan des modules en puissance CC.
Conversion du module (STC)La conversion photovoltaïque de base, aux conditions de test standard : irradiance dans le plan des modules × le rendement STC nominal du module. La plus grande « perte » en magnitude (l'essentiel de la lumière n'est pas converti).
Concentrateur — optique (lentille/miroir)Perte d'efficacité optique de la lentille de Fresnel / du miroir HCPV. Projets HCPV uniquement.
Facteur d'utilisation spectrale (UF)Perte d'utilisation spectrale multi-jonction sur les cellules HCPV à triple jonction.
Angle d'acceptance / pointagePerte de pointage due à l'angle d'acceptance HCPV et à l'erreur de suivi.
Niveau d'irradianceNon-linéarité de la courbe IV à faible éclairement (la perte « IL » / faible luminosité). Uniquement lorsque le solveur à diode unique a été exécuté.
TempératureL'effet net de la température de cellule sur l'année : la puissance perdue aux heures où la cellule fonctionne à plus de 25 °C, moins la puissance gagnée aux heures plus froides, si bien que, sur un site froid, cet effet peut ressortir en gain. Généralement la plus grande perte physique après la STC dans les climats chauds.
Gain bifacial (face arrière)Gain. Irradiance de la face arrière récoltée par les modules bifaciaux, avec un albédo du sol tenant compte de la neige.
Ombrage mutuel — effet électrique (rangées/brise-soleil)Puissance supplémentaire qu'un module partiellement ombragé perd à cause de la limitation de chaîne et des diodes de dérivation, au-delà de l'ombre purement géométrique.
Qualité des modulesTolérance de puissance entre la fiche technique et la mesure (typiquement 0,5–1,5 %).
LID (1re année)Dégradation induite par la lumière au cours de la première année d'exploitation.
DésappariementDispersion de fabrication d'un module à l'autre au sein d'une chaîne.
Étape CC et onduleurCâblage, optimiseurs et conversion CC→CA.
Pertes ohmiques CCÉchauffement I2R dans le câblage CC des chaînes et du champ. Calculé à partir de vos conducteurs dimensionnés lorsqu'une nomenclature existe, sinon un pourcentage forfaitaire.
LCPV — flux non uniformeDéclassement CC dû à l'éclairement non homogène sur une cellule LCPV.
Pertes ohmiques coffretsI2R des barres omnibus, fusibles et connecteurs à l'intérieur des coffrets de combinaison.
Optimiseur — pertes de conversionPénalité de conversion à charge partielle des optimiseurs CC au niveau du module (classe Tigo / SolarEdge).
Optimiseur — écrêtage en puissanceÉnergie écrêtée à la limite de puissance de l'optimiseur.
Optimiseur — écrêtage en courantÉnergie écrêtée à la limite de courant de l'optimiseur.
OnduleurPerte de conversion de l'onduleur le long de sa courbe de rendement à charge partielle. Les compartiments de plage de fonctionnement ci-dessous s'y ajoutent, chacun étant une perte distincte.
OP_Oper / IL_Oper (rendement MPPT)Surcoût du suiveur de point de puissance maximale : le suiveur ne se place jamais exactement sur le vrai pic.
OP_Pmin / IL_Pmin (Pdc < seuil)Entrée CC en dessous du seuil de démarrage de l'onduleur ; l'onduleur ne produit rien.
OP_Pmax / IL_Pmax (écrêtage)Puissance CC supérieure à la puissance nominale CA de l'onduleur ; l'excédent est écrêté (la perte de surdimensionnement classique).
OP_Vmin / IL_Vmin (Vdc < Vmppt min)Tension de chaîne en dessous de la fenêtre MPPT ; l'onduleur est forcé hors de son optimum sur le rail bas.
OP_Vmax / IL_Vmax (Vdc > Vmppt max)Tension de chaîne au-dessus de la fenêtre MPPT ; forcé hors optimum sur le rail haut.
IL_Night (consommation nocturne)Consommation de veille / auxiliaire de l'onduleur pendant la nuit.
Puissance réactive / cos(φ)Écrêtage de la puissance active lorsqu'un facteur de puissance différent de 1 oblige la puissance apparente à rester dans l'enveloppe kVA de l'onduleur. Uniquement sur les projets dotés d'une consigne réseau de cos(φ).
Étape CA et réseauDe la sortie de l'onduleur jusqu'au compteur.
Pertes ohmiques CAI2R dans le câblage CA basse tension de l'onduleur au tableau de distribution.
Pertes transformateur MTPertes à vide (fer) plus en charge (cuivre) du ou des transformateurs élévateurs moyenne tension.
Pertes transformateur HT (élévateur)Pertes fer plus cuivre d'un transformateur haute tension optionnel côté réseau.
Pertes ohmiques ligne MTI2R dans la ligne moyenne tension du transformateur au point de raccordement.
AuxiliairesCharge CA parasite continue : ventilateurs, supervision, moteurs de trackers.
DisponibilitéIndisponibilité planifiée côté équipement : maintenance, coupures, écrêtage.
Indisponibilité réseauPertes non planifiées côté réseau : déclenchements de tenue en tension/fréquence, micro-coupures/coupures et délai de reconnexion de l'onduleur.
Récupération batterie (secours)Gain. kWh qu'une batterie a fournis à la charge locale pendant une coupure du réseau en mode secours, dessiné comme un crédit de récupération face à la perte d'indisponibilité du réseau.
Étape de dégradationVieillissement sur la durée de vie du projet.
Dégradation des modules (année N)Vieillissement pluriannuel du module au-delà du LID, pour les années de simulation après la première ; augmente avec l'année simulée.

Note

L'onduleur est rapporté sur une ligne Onduleur (sa conversion à charge partielle) suivie de jusqu'à six compartiments OP_*/IL_* pour la plage de fonctionnement (suivi MPPT, seuil de démarrage, écrêtage, les deux bornes de tension, consommation nocturne), qui se réconcilient ligne par ligne avec les deux ensembles de variables que PVsyst exporte. Chaque ligne est une perte distincte : rien n'est compté deux fois.

Astuce

Pour trouver quelle perte grignote votre productible, triez la page des pertes par magnitude. Sur les champs surdimensionnés, le coupable est généralement OP_Pmax (écrêtage de l'onduleur) : réduisez le ratio CC/CA ou ajoutez du stockage couplé en CC (Stockage, VE & systèmes spécialisés). Dans les climats chauds, c'est Température : améliorez la ventilation arrière ou choisissez un module avec un coefficient de température plus faible. Lorsque l'écrêtage de l'onduleur coûte 2 % de la production ou plus sur un système raccordé au réseau, le calcul le signale de lui-même dans la carte Avertissements des Résultats (Graphiques, cartes de chaleur & tableaux), en indiquant les kWh perdus, la puissance CA des onduleurs, les kWc du champ et le ratio CC:CA.

Formats de fichiers

Le fichier de projet : .pvspline.json

Un projet pvSpline est un unique document JSON autonome. Il enregistre tout ce qui concerne le projet : le nom et les coordonnées du client, le site (latitude, longitude, altitude, fuseau horaire, pays), chaque polygone de champ (inclinaison, azimut, taux de couverture du sol, albédo, type de tracker, le panneau utilisé, sa puissance crête), la structure tarifaire, l'abonnement de puissance, la configuration de la batterie, les fenêtres d'heures pleines/creuses, les sessions de VE, les calendriers de limitation d'injection, et l'étude par lots de l'onglet Lots (ses scénarios, ses résultats et les axes de son graphique), d'après laquelle est imprimée la page de comparaison du rapport.

Note

Depuis le schéma 8, le fichier embarque aussi les séries météo et de consommation récupérées (l'irradiance PVGIS, les pluies/neige/températures Open-Meteo et la courbe de charge relevée Enedis) dans un bloc dataPayloads. C'est ce qui vous permet d'envoyer un projet par courriel à un collègue, ou de l'ouvrir en avion, et de le simuler à l'identique sans aucune connexion réseau. Un projet enregistré dans votre compte les conserve aussi : les séries, ainsi que tout fichier météo importé, sont stockées à côté de la sauvegarde et reviennent quand vous l'ouvrez. Sa série Enedis est retirée de chaque version enregistrée dès que l'autorisation du client pour ce point de livraison n'est plus en vigueur, et seule une nouvelle autorisation vous permet de la télécharger à nouveau (Quand l'autorisation de votre client expire) ; d'ici là, un calcul avertit que le point de livraison n'a aucune série de consommation embarquée. Une sauvegarde qui n'a pas pu stocker ses séries se rouvre sans elles : sa météo est récupérée à nouveau avant son prochain calcul, si bien qu'un projet dont la météo venait d'un fichier importé est simulé avec la météo PVGIS jusqu'à ce que vous importiez à nouveau le fichier. Les schémas suivants y ont ajouté la nomenclature électrique dimensionnée, les indicateurs de PV flottant, les prix des composants, le décalage de calibrage de la carte 3D et les champs de contact client, tous sur le même principe d'autonomie. Depuis le schéma 19, l'emprise dessinée de chaque champ voyage elle aussi (l'anneau de sommets que vous avez tracé sur la carte), si bien qu'un projet ouvert sur une autre machine se redessine exactement comme vous l'aviez laissé ; le schéma 26 a ajouté un relevé de provenance pour les séries embarquées (la fenêtre que chacune couvre, quand elle a été récupérée et depuis où) pour qu'un relecteur distingue un jeu de données frais d'un jeu vieux de deux ans ; le schéma 29 embarque les deux images d'un précalcul d'ombrage 3D (le panorama d'horizon et la vue de l'ombrage proche), qui se rouvrent ainsi à côté des chiffres qu'elles illustrent, dans un fichier téléchargé comme dans une sauvegarde du compte ; et le schéma 30 enregistre la température froide de conception du site (l'heure diurne la plus froide de l'historique Open-Meteo pluriannuel embarqué), que la vérification de la tension à froid des chaînes planifiées utilise lorsqu'aucune température minimale du site n'est définie (Décider et appliquer).

Note

Cette autonomie est la promesse du format vis-à-vis de l'utilisateur, et c'est elle qui rend la version web praticable : le projet que vous ouvrez dans un onglet de navigateur est l'étude entière. Rien ne reste sur un serveur auquel il faudrait être connecté, et rien n'a besoin d'être récupéré à nouveau avant de pouvoir simuler. Ce même fichier unique est celui que vous téléchargez, celui que vous envoyez par courriel, celui que vous redéposez sur l'application, et celui qui est envoyé au moteur quand vous appuyez sur Lancer le projet.

Chaque fichier de projet porte un entier schema de premier niveau. La version actuelle est 31. pvSpline gère automatiquement les écarts de version :

  • Les fichiers plus anciens sont migrés une version à la fois lorsque vous les ouvrez, de sorte qu'un ancien projet continue de fonctionner après la mise à jour de l'application. Les fichiers en dessous du plancher pris en charge (schémas 1–4) sont refusés : ouvrez-les dans une version plus ancienne et ré-enregistrez-les pour les mettre à niveau.

  • Les fichiers plus récents (un fichier écrit par une version plus récente que le moteur qui répond) s'ouvrent avec un avertissement léger et ne lisent que les champs que ce moteur comprend. Il ne réécrira pas un tel projet à l'ancienne version : il refuse plutôt que d'abandonner silencieusement les données plus récentes, de sorte qu'un aller-retour par un moteur plus ancien ne peut pas endommager discrètement le fichier.

  • Un schema absent ou nul est rejeté d'emblée.

Mise en garde

Le fichier de projet est la source de vérité unique d'un projet. Un projet enregistré dans votre compte conserve un historique de versions que vous pouvez parcourir et depuis lequel vous pouvez restaurer (L'onglet Projet) ; un fichier téléchargé sur votre propre disque n'en conserve aucun. Placez donc tout ce qui est destiné au client sous gestion de versions ou sous un régime de sauvegarde. Écraser un fichier téléchargé est irréversible.

Fiches techniques de composants importées : .PAN / .OND / .BTR / .PMP

pvSpline lit directement les formats natifs de fiches techniques de composants PVsyst, de sorte que votre bibliothèque existante s'importe sans aucune ressaisie (Le catalogue de composants), dans l'application web, par toute personne détenant le rôle Direction ou Admin dans votre société :

  • .PAN (un module PV) : paramètres électriques, coefficients de température, tension système maximale pour laquelle il est certifié (IEC et UL), et les courbes mesurées d'angle d'incidence (IAM) et de faible luminosité.

  • .OND (un onduleur) : puissance nominale, fenêtre MPPT, et la courbe de rendement (Euro/CEC ou la courbe importée complète).

  • .BTR (une batterie) : capacité et caractéristiques électriques.

  • .PMP : une courbe de pompe solaire (hauteur manométrique en fonction du débit), pour le type de système de pompage de l'eau.

Ces fichiers sont encodés en Windows-1252 et utilisent la syntaxe de section PVObject_ de PVsyst ; pvSpline tolère les clés inconnues. L'import amène le composant dans votre catalogue ; il n'importe pas un projet PVsyst entier (.PRJ) ni une variante.

Ce que vous pouvez importer dans le navigateur

Chaque import passe par un sélecteur de fichier ordinaire : cliquez sur le bouton, choisissez un fichier sur votre propre ordinateur, et l'application le lit. Certains fichiers sont analysés dans le navigateur et n'en sortent jamais ; les autres sont envoyés au moteur, qui les analyse et renvoie le résultat. Rien n'est stocké côté serveur, hormis un téléversement cloud servant à acheminer un gros fichier jusqu'au moteur (voir ci-dessous).

Les fichiers que l'application web accepte, où vous les choisissez, et ce qu'ils apportent.
QuoiOùNotes
projet .pvspline.jsonProjet /projectAnalysé dans le navigateur ; il devient le projet de travail. Remplacer un projet non enregistré demande d'abord confirmation.
.PAN .OND .BTR .PMPCatalogue /catalogueFiches techniques PVsyst de module, onduleur, batterie et pompe. La vue Schéma accepte aussi un .OND directement sur une ligne d'onduleur : tout le monde peut en charger un dans la ligne, et avec le rôle Direction ou Admin il est aussi ajouté au catalogue Onduleurs de votre société.
.yaml / .ymlCatalogue /catalogueCoffrets de regroupement, câbles, groupes électrogènes et tarifs d'électricité : le format de départ propre au catalogue.
météo .epw .tmy3 .csv .jsonProduction /productionUn fichier météo horaire sur lequel simuler, à la place des séries récupérées.
Facture d'électricité (.pdf)Projet /projectLit une facture de fournisseur français et en remplit les tarifs, l'horaire heures pleines/creuses et la consommation mensuelle. Vous vérifiez ce qu'elle a analysé avant d'appliquer.
Rapport PVGIS (.pdf)Production /productionRelit un rapport de site PVGIS dans le projet, à des fins de comparaison.
Tarif horaire / calendrier Tempo (.csv)Projet /projectUne courbe de prix de 8760 lignes (8784 pour une année bissextile, dont le 29 février est ignoré), ou un calendrier de couleurs de jour.
contour de site .kmlCarte /mapImporte les contours de polygones comme zones de champ, avec les valeurs de dessin par défaut.
dessin CAO .dxfCarte /mapPlace les contours fermés du dessin (dans son système de projection, ou centrés sur la vue) et les importe comme zones de champ.
Image géoréférencéeCarte /mapUn GeoTIFF, ou un .png / .jpg avec son fichier de calage et son .prj, affiché sous les zones comme votre propre imagerie.
Modèle de bâtiment 3DCarte /map.glb .gltf .dae .3ds .fbx .obj .stl, convertis par le moteur pour la scène 3D.
Scénarios de lot .csvLots /batchAnalysé dans le navigateur. Vous pouvez aussi déposer le fichier sur le plan de travail.
Thème de rapport .jsonRésultats /resultsAnalysé dans le navigateur ; charge une conception de rapport enregistrée.
Production mesurée .jsonProduction /productionUne vraie série relevée, pour confronter la simulation.
Réglages .jsonPage Compte /account/preferencesAnalysé dans le navigateur ; restaure un document de préférences exporté.
Fichier vidéoVidéo /videoOuvrir un fichier vidéo… lit dans le lecteur un clip de votre ordinateur. Il reste dans le navigateur et n'est pas conservé après la fermeture de l'onglet.
Images (.png .jpg .bmp)Résultats /resultsIllustrations du rapport et du thème, et les photographies de site DP7/DP8 d'un dossier de permis.

Note

Chacun d'eux est un sélecteur de fichier du navigateur : l'application peut lire un fichier que vous choisissez, mais ne peut jamais aller d'elle-même dans votre système de fichiers, et n'écrit jamais dans le fichier que vous avez choisi. Les modifications vivent dans le projet de travail jusqu'à ce que vous le retéléchargiez ou l'enregistriez dans votre compte.

Quelle taille de fichier vous pouvez importer

Chaque sélecteur de fichier contrôle la taille avant de lire quoi que ce soit, et refuse un fichier trop volumineux en le nommant, avec les deux chiffres : celui de votre fichier et celui du plafond. Ce plafond n'est pas arbitraire : c'est la limite réelle de ce qui aurait sinon refusé le téléversement, de sorte que l'application n'écarte jamais un fichier que la plateforme aurait accepté.

Les plafonds de taille à l'import, tels que l'application les énonce.
Type d'importPlafondPourquoi ce chiffre
Tout ce qui est envoyé au cloud : fiches techniques, YAML de catalogue, fichiers météo, PDF de facture et PVGIS, CSV de tarif, KML, DXF, images géoréférencées, modèles 3D25 MoLe plafond par fichier propre au service cloud. Le fichier est téléversé une fois puis référencé : c'est donc ce chiffre qui s'applique, et non la limite de requête, plus basse.
Les fichiers analysés dans le navigateur : projet, réglages, CSV de lot, thème de rapport, série de production mesurée67 MoRien sur le réseau ne les contraint ; le plafond n'existe que pour qu'un fichier pathologique ne puisse pas figer l'onglet.
Images : illustrations du rapport et du thème, photographies de permis25 MoLe navigateur doit décoder l'original en taille réelle avant que l'application ne le réduise : c'est donc le fichier choisi qu'il faut borner.

Exports : PDF, CSV, XLSX, JSON, SVG, PNG

Tout ce que vous exportez arrive sous forme de téléchargement ordinaire du navigateur, enregistré là où votre navigateur place les téléchargements. Le moteur le produit et renvoie les octets ; rien n'est écrit sur votre disque sans vous.

  • PDF : le rapport client à votre marque, depuis l'espace rapport de Résultats (/results, Rapports & export). Il comprend une couverture thématisée avec votre logo et le QR code de vérification (Vérification du rapport), un plan de vos champs sur l'orthophotographie lorsqu'elle est disponible, le schéma unifilaire, les graphiques que vous avez cochés en haute résolution (dont le diagramme de pertes Sankey) et la projection financière avec son pied de page de performance. Il est rédigé dans la langue de l'interface (pour un calcul cloud, celle qu'utilisait la page au lancement du calcul). Ses autres onglets exportent le dossier productible, toujours en français, la déclaration préalable et le dossier technique Consuel.

  • XLSX : la projection financière sous forme de classeur Excel d'une seule feuille (le tableau, son bloc de synthèse et la légende des colonnes) et la nomenclature, toutes deux depuis Résultats.

  • CSV : la nomenclature depuis Résultats, le tableau des scénarios depuis Lots (Exporter CSV…).

  • PNG : n'importe quel graphique d'un calcul terminé, rendu côté serveur à la résolution du rapport (Graphiques, cartes de chaleur & tableaux).

  • SVG : le schéma unifilaire, depuis le menu voisin de Télécharger le PDF dans Résultats ou depuis le menu du canevas de Schéma (Exporter le schéma et la nomenclature). Le dessin s'exporte aussi en PDF. Les deux sont dessinés dans la langue de l'interface.

  • JSON : le projet de travail sous forme de fichier portable (Projet), vos préférences (la page Compte), et un thème de rapport.

Note

Exporter le rapport PDF livre le rapport stocké avec le calcul que vous prévisualisez ; le projet n'est pas relancé au préalable. Si ce calcul ne correspond plus au projet à l'écran, son badge Obsolète à côté de Lancer le projet l'indique : appuyez sur Lancer le projet, attendez le nouveau calcul, puis exportez (Ce que livre un export). Sans aucun calcul, l'export lance d'abord le projet.

Note

Les calculs cloud emportent leurs artefacts avec eux : dès qu'un calcul cloud simple réussit, Voir le résultat sur sa ligne dans Calculs cloud, sur Compte (Calculs cloud : l'historique des tâches), l'ouvre dans Résultats, et son rapport, son classeur, son dossier et ses images de graphiques sont récupérés directement depuis le stockage.

Fichiers de catalogue de tarifs (.yaml)

Les offres tarifaires des fournisseurs sont de petits fichiers YAML, un tarif par fichier. Ils sont livrés avec le catalogue, et vous pouvez ajouter les vôtres depuis l'onglet Tarifs de la vue Catalogue (/catalogue). Ils portent le nom du fournisseur et de l'offre, le pays/la devise, les dates de validité, le mode d'achat (tarif unique, HP/HC, HP/HC saisonnier, CSV horaire ou EDF Tempo), les tarifs par période, les charges réseau/abonnement et le tarif de revente du surplus. Appliquer un tarif du catalogue à un projet se fait par copie : les valeurs atterrissent dans les saisies tarifaires propres au projet (la Granularité de la carte TARIFICATION RÉSEAU comprise, lorsque le fichier en fixe une), et elles ne sont pas liées. Les tarifs de ces fichiers sont en centimes par kWh, et non en €/kWh : le 21.46 d'un fichier s'affiche 0,2146 dans les champs de tarif du projet.

Glossaire des termes et acronymes

Termes et acronymes utilisés dans pvSpline et ce manuel.
TermeSignification
GHIIrradiance horizontale globale : l'ensoleillement total sur une surface horizontale plane (W/m2).
DNIIrradiance normale directe : la composante directe mesurée perpendiculairement au soleil.
DHIIrradiance horizontale diffuse : la lumière du ciel diffusée sur une surface horizontale.
POAIrradiance dans le plan des modules : la lumière atteignant réellement vos modules inclinés et orientés.
TMYAnnée météorologique typique : une année représentative synthétique assemblée à partir d'enregistrements pluriannuels.
IAMModificateur d'angle d'incidence : la quantité de lumière perdue par réflexion sur le verre à mesure que le soleil s'écarte de la perpendiculaire.
STCConditions de test standard : 1000 W/m2, 25 °C, AM1,5 ; la référence sous laquelle les modules sont caractérisés.
AOIAngle d'incidence : angle entre le rayon solaire et la normale au module.
LIDDégradation induite par la lumière : perte de puissance la première année lors de la première exposition d'un module au soleil.
PRRatio de performance (IEC 61724-1) : énergie livrée divisée par l'énergie STC idéale pour l'irradiance collectée ; l'indicateur de qualité phare.
kWc / kWpKilowatt-crête / kilowatt-peak : la puissance nominale CC du champ aux STC. kWc est la forme française de kWp ; ils sont identiques.
kVAKilovoltampère : la puissance apparente ; l'unité de dimensionnement des onduleurs et des raccordements au réseau.
YfProductible final (spécifique) : énergie annuelle par puissance crête installée, kWh/kWp/an ; le chiffre phare du banquier.
YrProductible de référence : irradiation POA annuelle exprimée en heures d'ensoleillement crête équivalentes.
Facteur de capacitéÉnergie livrée exprimée en fraction d'un fonctionnement à pleine puissance nominale à chaque heure de l'année.
MPPTSuiveur de point de puissance maximale : le circuit de l'onduleur qui maintient une chaîne à sa tension optimale.
GCRTaux de couverture du sol : surface des modules divisée par la surface au sol ; détermine l'ombrage inter-rangées.
SOC / SOHÉtat de charge de la batterie (à quel point elle est pleine, maintenant) / état de santé (capacité conservée par rapport au neuf).
DoDProfondeur de décharge : à quel point une batterie est déchargée par cycle.
cos(φ)Facteur de puissance : rapport entre la puissance active et apparente ; une consigne de code réseau inférieure à 1 écrête la puissance active.
P50 / P90Probabilité de dépassement : le productible annuel qui sera dépassé 50 % (médiane) / 90 % (conservateur, cas prêteur) des années. Également P75, P99.
σIAVVariabilité interannuelle : la dispersion du productible d'une année à l'autre qui fixe la largeur de la distribution P50/P90.
LCOECoût actualisé de l'énergie : le coût par kWh produit sur la durée de vie ; le prix d'équilibre.
NPV / VANValeur actuelle nette (en anglais Net Present Value) : le flux de trésorerie des fonds propres sur la durée de vie, actualisé au coût des fonds propres (et non au CMPC, que seul le LCOE utilise).
IRR / TRITaux de rendement interne (en anglais Internal Rate of Return) : le taux d'actualisation pour lequel la valeur actuelle du flux de trésorerie avant impôt est nulle. pvSpline le donne sous deux formes : le TRI projet, sur le coût total de l'installation (la synthèse sous la projection financière, dans ses exports CSV et Sheets), et le TRI fonds propres, sur vos propres fonds après remboursement de l'emprunt (la ligne sous la projection financière dans Résultats, marquée (fonds propres) lorsqu'un emprunt rend les deux différents, les résultats par lots, le tableau de sensibilité de bancabilité, le classeur et le rapport PDF). Sans emprunt, les deux sont égaux.
DSCRRatio de couverture du service de la dette : trésorerie disponible divisée par la dette exigible sur une période ; un test de solvabilité pour le prêteur.
LLCRRatio de couverture sur la durée du prêt : trésorerie actualisée sur la durée du prêt divisée par la dette en cours.
TOU / HP-HCTarif selon l'heure d'utilisation (Time-Of-Use) ; en France, périodes d'heures pleines / heures creuses.
TempoTarif dynamique EDF avec des couleurs de jour bleu/blanc/rouge à des prix différents.
PRMIdentifiant de compteur Enedis français (14 chiffres) utilisé pour récupérer la consommation mesurée.
TURPELe tarif réglementé français d'utilisation du réseau inclus dans les frais de réseau.
EnedisLe gestionnaire français du réseau de distribution ; source des données de charge mesurée.
PVGISLe système d'information géographique photovoltaïque de l'UE : irradiance par site, TMY et horizon gratuits. Son TMY, téléchargé en CSV ou en JSON, est un fichier météo que pvSpline peut importer ; son téléchargement EPW ne l'est pas.
Open-MeteoArchive météo horaire bâtie sur les réanalyses Copernicus ERA5 / ERA5-Land, avec l'historique de qualité de l'air CAMS pour les particules ; le cloud de pvSpline est conçu pour la lire sur son propre serveur Open-Meteo. Elle alimente les modèles de salissure (pluies et PM10) et de neige, l'eau précipitable de la correction spectrale, l'albédo de sol enneigé, le canal de vent optionnel, la météo réelle de la vue 3D et la température froide de conception à laquelle sont confrontées les chaînes planifiées.
EPW / TMY3Formats de fichiers météo horaires standard de l'industrie que pvSpline peut importer ; une année type parmi eux, dont les mois proviennent d'années différentes, est ramenée sur une seule année civile.
NSRDBLa base de données nationale de rayonnement solaire des États-Unis (National Solar Radiation Database) ; son téléchargement CSV, une année donnée ou une année type, est un fichier météo que pvSpline sait importer.
SolcastService d'irradiance et de météo dérivées de satellites ; son export CSV, une série historique ou une année type, est un fichier météo que pvSpline sait importer.
SolargisBase de données de ressource solaire dérivée de satellites ; ses séries temporelles et ses fichiers TMY au format CSV sont des fichiers météo que pvSpline sait importer.
BOMNomenclature : la liste dimensionnée des conducteurs, coffrets et composants avec les longueurs de câble.
LCPV / HCPVPhotovoltaïque à basse / haute concentration : optiques qui concentrent la lumière du soleil sur la cellule.
V2HVehicle-to-Home : décharge de la batterie d'un véhicule électrique pour alimenter le bâtiment.
BacktrackingTrackers pivotant à l'écart du soleil aux angles faibles pour éviter d'ombrer la rangée suivante. Ce qu'il coûte correspond à la ligne Backtracking / butée de rotation (trackers) du diagramme des pertes.
SankeyLe diagramme de flux qui dessine la cascade de pertes sous la forme d'un ruban d'énergie qui rétrécit.
MoteurLe programme de simulation auquel le navigateur parle. Il ne fait pas partie de la page : l'application lui envoie un projet et il renvoie des résultats.
CalculUne simulation d'un projet. Vous la lancez, Résultats dit où elle en est, et les résultats se remplissent quand elle aboutit.
TâcheL'unité de travail mise en file derrière un calcul ; le terme sert aussi pour un balayage de lot, une optimisation, une récupération météo ou une construction de tuiles. Les tâches ont un identifiant, un état et un historique auquel vous pouvez revenir.
ObsolèteLe badge qu'affiche une vue de résultats dès que le projet a dérivé par rapport au calcul montré. Il indique Obsolète — le projet a changé depuis ce calcul.
QuotaLe budget décompté que dépense un compte cloud, renouvelé le 1er de chaque mois. Le temps moteur (calculs cloud), le streaming 3D, les constructions de tuiles et l'API cloud sont décomptés en secondes, les imports de fichiers en mégaoctets ; avec un abonnement, chaque membre a son propre quota pour chacun, et avec l'offre gratuite toute la société en partage un seul de chaque. Tous sont affichés sur Compte, et les chiffres de chaque offre figurent dans Quotas mensuels par formule.
Seconde-moteurL'unité dans laquelle le calcul cloud est décompté : une seconde de temps moteur. Un calcul léger en coûte environ une.
Seconde de streamingL'unité dans laquelle le streaming 3D est décompté, de la première image d'une session à sa fin (un quota distinct du temps moteur).
Construction de tuilesUne construction mise en file des tuiles 3D de la carte pour la zone d'un projet, décomptée des secondes que son exécuteur de construction y a passées.
Temps d'API cloudLes secondes de temps serveur passées à répondre à vos requêtes, décomptées d'un quota mensuel sur toutes les offres (le vôtre avec un abonnement, celui de votre société avec l'offre gratuite). La connexion et les pages de compte et de facturation ne sont pas comptées.
Compte vérifiéUn compte dont l'e-mail est confirmé et dont le SIREN de la société a été trouvé actif dans le répertoire Sirene de l'Insee. L'offre gratuite d'un nouveau compte démarre une fois celui-ci vérifié, et l'abonnement le demande aussi (Vérifier votre compte).
PosteUne personne sur une offre société, ou un jeton de service créé pour un serveur, un conteneur ou une chaîne de CI, qui occupe lui aussi un poste. Les postes limitent qui peut se connecter ; le budget de calcul, lui, est partagé et non attribué par poste.
ProfilCe qu'un compte peut faire dans sa société, affiché sur Compte sous la forme Profil : {role}. Le premier compte d'une société en est la Direction : il voit tous les projets et tous les calculs de la société, gère les membres et la facturation, et peut modifier le catalogue de la société. Les collègues qui la rejoignent ensuite sont Utilisateur (leurs propres projets et calculs) jusqu'à ce qu'une Direction les promeuve (Profils, et ce qu'un responsable peut modifier). Admin désigne l'équipe de support de pvSpline elle-même.
Sauvegarde / versionUn projet stocké dans votre compte. Chaque enregistrement ajoute une version, si bien que vous pouvez consulter une version antérieure et la restaurer.
PrécalculMesurer l'ombrage direct et le facteur de vue du ciel sur la vraie scène 3D plutôt qu'avec le modèle analytique de rangées. Les tables obtenues sont stockées dans le projet et utilisées par la simulation suivante.

Raccourcis clavier et souris

pvSpline est une application qui se pilote à la souris : presque tout est un bouton sur la vue où vous êtes, et aucun raccourci n'est le seul moyen d'atteindre une action. Les raccourcis ci-dessous sont ceux qui existent. Partout où il est écrit Ctrl, macOS utilise Cmd.

Partout dans l'application

Trois raccourcis sont liés à la fenêtre entière, quelle que soit la vue où vous vous trouvez.

RaccourciAction
Ctrl+EntréeLance le projet de travail et va directement à ses résultats. Toute carte que vous étiez encore en train d'éditer est validée d'abord, si bien que le calcul inclut ce qui est à l'écran.
Ctrl+ZAnnule la dernière modification du projet. Un bref message nomme ce qui a été annulé.
Ctrl+Maj+Z ou Ctrl+YRétablir.

Ils s'effacent délibérément dans quatre situations, pour ne jamais se déclencher quand vous vouliez autre chose :

  • tant que le curseur est dans une zone de texte, un champ numérique, une liste déroulante ou une zone de texte enrichi : Ctrl+Z appartient alors au champ où vous tapez ;

  • tant que le contrat de licence est à l'écran, car il possède la fenêtre entière jusqu'à ce que vous l'acceptiez ;

  • tant que l'éditeur de thème de rapport ou la boîte de dialogue de permis est ouvert : ceux-là prennent le clavier, avec leurs propres raccourcis (ci-dessous) ;

  • chaque fois que la touche Alt est également maintenue.

Attention

Il existe une règle souris globale qu'il vaut la peine de connaître. Faire tourner la molette au-dessus d'un champ numérique, d'un curseur, d'un champ de date/heure ou d'une liste déroulante qui n'a pas le focus fait défiler la page au lieu de changer la valeur. C'est délibéré : défiler devant un formulaire ne doit jamais le modifier en silence. Cliquez d'abord dans le contrôle (ou atteignez-le avec Tab) et la molette l'ajuste normalement.

Carte (/map)

GesteAction
Clic (pendant le dessin)Ajoute un sommet. Recliquer le premier sommet ferme l'anneau.
Double-clic (pendant le dessin)Ferme l'anneau.
Entrée (pendant le dessin)Ferme l'anneau.
Clic droit (pendant le dessin)Retire le dernier sommet posé ; une fois le brouillon vide, annule le dessin.
ÉchapAnnule le dessin, annule une épingle que vous faites glisser, ou range un outil armé (la pipette de couleur, la pose d'épingle).
Clic droit (outil armé)Équivaut à Échap pour une pipette de couleur, une pose d'épingle ou un pinceau à chaînes armé, sans retourner au bouton.
Glisser une poignée de sommetDéplace ce sommet. Les cartes et poignées du polygone s'écartent pendant toute la durée du glissement.
Clic droit sur un sommetLe supprime. Refusé lorsque le contour n'a plus que trois sommets, ou lorsque le polygone est verrouillé en rectangle.
Cliquer une pastille « + » sur une arêteCoupe cette arête en son milieu, en ajoutant un sommet.
Glisser le corps d'un polygoneDéplace l'emprise entière ; chaque sommet voyage avec elle.
Glisser une épingle d'équipementDéplace un marqueur de coffret, d'onduleur ou de tableau CA déjà posé.
Glisser à travers les modules (peintre armé)Peint les modules dans la chaîne active.
Maj+clic sur un module (peintre armé)Reprend la chaîne sous le pointeur au lieu de peindre (la pipette).
Maj+clic sur une emprise de bâtiment (superposition armée)L'importe directement comme bâtiment ; un simple clic propose le choix à la place.
Anneau de boussole : ← →Tourne de 1° à la fois, Maj pour 10° ; Début revient au nord. Donnez d'abord le focus à l'anneau ; sinon il se manipule à la souris.

Note

Éditer la carte d'un polygone ne demande aucun raccourci : la carte se réinscrit d'elle-même environ une demi-seconde après votre dernière frappe. Quitter la vue et Ctrl+Entrée sont les filets de sécurité pour une modification plus récente que cela.

Catalogue (/catalogue)

GesteAction
Cliquer une ligneLa sélectionne, en remplaçant la sélection.
Ctrl+clicAjoute ou retire cette seule ligne de la sélection.
Maj+clicSélectionne toutes les lignes entre l'ancre et celle-ci.
SupprSupprime les composants sélectionnés. Les lignes de catalogue livrées avec l'application ne sont jamais supprimées, et la touche respecte le même contrôle de rôle que le bouton.
Double-clic sur une ligneBascule son cœur de favori.
Glisser une sélection vers LotsAjoute ces composants au balayage en cours de rédaction.

Schéma unifilaire (/diagram)

Le dessin prend le clavier dès que vous cliquez dedans.

GesteAction
Molette de la sourisZoome autour du pointeur.
Glisser (bouton gauche)Déplace le dessin.
+ / -Zoom avant / arrière. (= fonctionne comme +.)
0Réinitialise la vue.
←/↑ / →/↓Fait reculer / avancer la sélection d'un élément à l'autre.
EntréeOuvre l'éditeur de l'élément sélectionné : un câble ouvre la boîte de dialogue de câble.
Suppr ou Retour arrièreRetire l'onduleur ou le coffret sélectionné. Demande confirmation ; rien d'autre n'est supprimable.
ÉchapEfface la sélection.
Clic droitOuvre le menu contextuel de ce qui se trouve sous le pointeur. L'arrière-plan porte le jeu d'actions complet, si bien que rien ici n'est accessible uniquement par un geste.
Menu ou Maj+F10Le même menu, au clavier, sur l'élément qui a le focus.
Dans un menu↑ ↓ se déplacent en bouclant, Début/Fin sautent aux extrémités, Échap ferme.
Double-clic sur un élémentOuvre son éditeur. Double-cliquez sur une ligne de câble dans le tableau pour la boîte de dialogue de câble.

Éditeur de thème de rapport (/results)

Tant que l'éditeur de thème est ouvert, il possède le clavier, et les raccourcis globaux ci-dessus s'effacent.

RaccourciAction
ÉchapFerme l'éditeur ou, si une boîte de dialogue est ouverte par-dessus, l'écarte d'abord.
Ctrl+Z / Ctrl+Maj+Z / Ctrl+YAnnuler / rétablir dans la conception. Pendant que vous éditez un texte sur place, ils appartiennent au texte.
Ctrl+SEnregistre le thème. Ctrl+Maj+S l'enregistre sous un nouveau nom.
Ctrl+TabFait défiler les pages de la conception (couverture, graphiques, tableaux) ; Ctrl+Maj+Tab dans l'autre sens.
Ctrl+0Ajuste la page à la fenêtre. Ctrl+1 revient à 100 %.
← → ↑ ↓Décale le cadre sélectionné d'un cran ; Maj en fait dix.
Suppr ou Retour arrièreVide le contenu de l'emplacement sélectionné. L'emplacement, lui, reste.
Maintenir EspaceDéplace la page tant que vous la maintenez, quel que soit l'outil actif.
V T P H ZChoisit les outils déplacer, texte, placer, main et zoom.

Ailleurs

RaccourciAction
← → sur une poignée de perteSur la cascade de pertes de Production, ajuste cette perte de 0,1 point (Maj pour un point entier).
Échap sur LotsFerme la fenêtre surgissante des réglages de calcul.
← → sur le séparateur de LotsDéplace la séparation entre les deux volets ; Début la réinitialise.
Déposer un fichier sur LotsUn .csv charge les scénarios ; une sélection du catalogue ajoute ces composants.
Espace dans le lecteur vidéoLecture / pause. F bascule le plein écran.
← → sur les onglets de documents de RésultatsAffiche le document précédent ou suivant ; Début et Fin vont au premier et au dernier.
↓ ↑ dans un menu de document de RésultatsParcourt ses entrées ; Début et Fin sautent à ses extrémités, Échap le ferme.
Échap dans n'importe quelle boîte de dialogueL'annule.

Où se placent les raccourcis propres au navigateur

pvSpline revendique très peu de choses sur le clavier, si bien que presque tous les raccourcis du navigateur continuent de fonctionner comme vous l'attendez. C'est une qualité, pas un oubli :

  • Actualiser (F5 / Ctrl+R) recharge l'application. Si le projet de travail a des modifications non enregistrées, l'invite « Quitter le site ? » propre au navigateur apparaît d'abord (c'est pvSpline qui la demande). Répondez que vous restez si ce n'était pas votre intention.

  • Précédent et suivant font passer d'une vue à l'autre, car chaque vue a sa propre adresse. Revenir en arrière depuis une page de résultats n'annule pas le calcul qui est derrière.

  • Rechercher (Ctrl+F) appartient au navigateur, intacte. Elle cherche dans ce qui est affiché ; pour chercher dans un catalogue ou dans vos projets, utilisez le champ de recherche propre à la vue, qui cherche dans tout et pas seulement dans les lignes visibles.

  • Imprimer (Ctrl+P) appartient au navigateur. Pour un livrable client, utilisez plutôt l'action d'impression propre au rapport : elle imprime le rapport rendu et non la fenêtre de l'application. Si votre navigateur bloque la fenêtre qu'elle ouvre, autorisez les pop-up pour ce site, ou exportez le PDF et imprimez-le.

  • Enregistrer la page (Ctrl+S) appartient au navigateur, sauf dans l'éditeur de thème de rapport, qui s'en sert pour enregistrer le thème. Pour enregistrer un projet dans votre compte, utilisez Sauvegarder sur Projet.

  • Zoom (Ctrl++ / Ctrl+-) met toute l'application à l'échelle. La carte, le schéma et l'aperçu du rapport ont aussi leur propre zoom, et c'est celui-là qu'il faut utiliser.

  • Plein écran (F11) appartient au navigateur et ne peut pas être réaffecté ; le lecteur vidéo propose F pour son propre plein écran.

Dépannage et FAQ

Chaque entrée ci-dessous est un symptôme, la cause derrière lui, et le remède.

Les données météo ou de consommation ne se chargent pas

Symptôme. Une récupération signale un échec, ou un calcul s'arrête en annonçant qu'il récupère la météo et ne finit jamais.

Cause et remède.

  • Aucun site défini. La récupération le dit : définissez d'abord la latitude et la longitude sur Carte (L'onglet Carte & conception du site). Rien ne peut être récupéré pour un site à 0, 0.

  • Déjà récupéré, rien ne se passe. La météo est récupérée automatiquement (au tracé ou à la modification d’un champ, avant le calcul suivant, et à nouveau chaque fois que le site bouge), et seul ce qui manque au projet est téléchargé, il n'y a donc souvent rien à presser. Un projet qui a déjà sa météo propose plutôt Actualiser les données météo, qui retélécharge tout à la demande.

  • Le badge Open-Meteo reste sur Données Open-Meteo absentes. Le service d'historique météo n'a pas répondu. La récupération embarque quand même l'irradiance PVGIS, si bien que les calculs se poursuivent, mais Salissures et Neige en Auto (météo) ne peuvent pas suivre la météo et conservent les valeurs propres au projet, et la Météo réelle de la vue 3D indique Météo indisponible : …. Aucun autre service météo ne prend le relais. Appuyez plus tard sur Actualiser les données météo dans Production pour réessayer : rien ne relance la récupération de lui-même tant que le site ne bouge pas.

  • La première récupération pour un site est lente. L'historique météo d'un site qui n'a encore jamais été récupéré met nettement plus de temps à arriver la première fois ; les récupérations suivantes pour le même site reviennent plus vite. Un calcul lancé entre-temps attend avec Récupération préalable des données météo du site — le calcul démarre dès leur arrivée… ; laissez-la se terminer.

  • La consommation Enedis ne se récupère pas. La récupération de courbe de charge est française et exige un point de livraison autorisé : le PRM à 14 chiffres appartient au projet enregistré et provient de l'autorisation du client, il ne peut donc pas être saisi ici. Si le projet n'en a pas, démarrez le parcours de consentement depuis la même carte (L'onglet Consommation).

  • Un point de livraison qui se téléchargeait auparavant est refusé avec Aucune autorisation Enedis n'est en vigueur pour ce PRM…. L'autorisation du client a très probablement expiré (elle court pour la durée indiquée sur le formulaire signé par le client, douze mois par défaut) ou a été révoquée ; le même message couvre un accès Enedis désactivé pour votre compte, que la direction de votre société peut activer. Un projet enregistré dans votre compte ne conserve la série relevée que tant que l'autorisation est en vigueur : dès qu'elle prend fin, la série est retirée de chaque version enregistrée, la carte Avertissements du calcul signale que le point de livraison n'a aucune série de consommation embarquée, et seule une nouvelle autorisation signée par le client vous permet de la télécharger à nouveau (Quand l'autorisation de votre client expire).

Astuce

Une fois les séries d'un site récupérées, elles sont embarquées dans le fichier de projet : le projet tourne dès lors sans toucher au réseau, y compris sur une machine qui n'a jamais vu ce site.

Un calcul a échoué, ou vous voulez en arrêter un

Symptôme. La place du rapport sur Résultats affiche Cette tâche a échoué : suivi d'un message, ou un calcul dont vous ne voulez plus est en route.

Cause et remède.

  • Lisez d'abord le message : il vient du moteur et nomme généralement l'entrée fautive. Relancez-le ensuite : la vérification qui ouvre chaque calcul liste, sous Lancer le projet, exactement ce qui manque ou sort des plages, et bloque le lancement avant que rien ne soit calculé.

  • Un calcul cloud en échec est imputé du temps moteur qu'il a consommé. Corriger l'entrée et relancer ajoute le nouveau calcul par-dessus : lisez la carte Avertissements du calcul échoué avant de le resoumettre. Une erreur que la vérification détecte arrête un calcul avant sa soumission : elle ne coûte donc rien.

  • Un calcul ne se retire pas depuis Résultats. Une fois que le moteur a pris une tâche, elle ne peut plus être interrompue : laissez-la finir et relancez. Un calcul cloud encore en file s'annule depuis la liste Calculs cloud de la page Compte (Calculs cloud : l'historique des tâches).

  • Des tâches disparaissent de Choisir une tâche. La liste conserve un nombre borné de tâches récentes par session. Un résultat que vous devez conserver est déjà dans votre historique de calculs sur Compte.

  • Certaines lignes d'un lot reviennent en échec. L'étape 4 les liste sous Scénarios non exécutés par le moteur :. Chacune substitue un composant que ni le projet, ni le catalogue du moteur, ni les composants partagés de votre société ne contiennent : le moteur refuse donc de l'exécuter plutôt que d'évaluer votre propre composant sous le nom de celui-ci. Le Journal du calcul nomme le composant : ajoutez-le au catalogue de votre société (rôle Direction ou Admin, Le catalogue de composants) ou choisissez-en un autre, puis relancez le lot (Simulation par lots & balayages de scénarios).

Un calcul cloud reste en file

Symptôme. Une ligne de Calculs cloud continue d'afficher En file — prise en charge typiquement ≤ 5 s bien au-delà de cinq secondes (ou, avec l'offre gratuite, En file — avec l’offre gratuite, un calcul démarre quand aucun calcul d’un client payant n’attend).

Cause. Tous les serveurs de calcul sont occupés. Ils sont partagés par toutes les sociétés clientes de pvSpline et passent de l'une à l'autre à tour de rôle : le long arriéré d'une autre société ne passe pas tout entier devant vous, seulement sa tâche suivante à chaque tour. Au sein de votre société, la tâche la plus ancienne démarre la première : les calculs et les lots que vos collègues (ou un script ou un assistant IA travaillant pour votre société) ont mis en file avant vous démarrent avant les vôtres. Avec l'offre gratuite, les calculs des clients payants passent d'abord, même ceux mis en file après le vôtre : votre calcul ne démarre qu'une fois qu'aucun d'eux n'attend, et un lot ou une optimisation en cours peut être interrompu pour laisser passer l'un d'eux ; sa ligne affiche alors Remis en file — interrompu pour laisser passer le calcul d’un client payant (offre gratuite) ; il reprendra depuis le début dès qu’un serveur sera libre (Le travail des clients payants passe d'abord).

Remède. Patientez : la ligne passe d'elle-même à En cours, et le temps passé en file n'est jamais facturé (le chiffre File du tiroir le compte à part du temps Moteur). Pour voir ce que votre société a en attente, choisissez la puce En cours dans Calculs cloud (Calculs cloud : l'historique des tâches), et annulez les calculs en file dont vous n'avez plus besoin : un calcul annulé avant sa prise en charge ne coûte rien. Avec l'offre gratuite, s'abonner lève l'attente aussitôt : les calculs de votre société, y compris ceux déjà en file, passent alors d'abord comme ceux de tout client payant.

Le cloud refuse de mettre un calcul en file

Symptôme. Appuyer sur Lancer produit un message au lieu d'une tâche, en mentionnant un quota ou un abonnement.

Cause. Le calcul cloud est décompté (par membre avec un abonnement, par société avec l'offre gratuite), et il y a plusieurs compteurs indépendants :

  • votre quota mensuel de simulations est épuisé — le calcul n'a pas été mis en file : votre quota de temps moteur est épuisé. Avec un abonnement, il vous est propre et n'est pas partagé avec vos collègues ; avec l'offre gratuite, c'est celui de la société, et les calculs d'un collègue comptent aussi. Il se réinitialise chaque mois.

  • Un message indiquant que votre quota mensuel d'API cloud est épuisé : le compteur de l'API cloud, que toutes les offres plafonnent. Jusqu'à son renouvellement le 1er du mois, les enregistrements sur votre compte et les autres travaux cloud sont refusés aussi.

  • l'abonnement de votre société est inactif — les calculs cloud sont suspendus : un état de facturation, pas un quota.

  • Votre offre n'inclut pas le streaming 3D ou Votre quota mensuel de constructions de tuiles est épuisé : les compteurs 3D, distincts du temps moteur.

Remède. Ouvrez la section Utilisation de Compte (/account/usage) : elle montre ce qu'il reste de chaque quota et la date à laquelle il se réinitialise, et le Mode avancé y ajoute chaque compteur, avec ce que vous avez consommé.

Un téléversement est refusé parce que le fichier est trop volumineux

Symptôme. Choisir un fichier produit un refus qui nomme le fichier, sa taille et une limite, avant même toute lecture.

Cause. Chaque import a un plafond, et pour tout ce que le moteur analyse, il est de 25 Mo par fichier via le cloud (Formats de fichiers).

Remède. Pour une image, redimensionnez-la ou recompressez-la d'abord : l'application réduit les images pour le rapport, mais le navigateur doit décoder l'original en taille réelle avant de le pouvoir.

Un autre refus, Votre quota d'import mensuel est épuisé, ne concerne pas un fichier en particulier : dans le cloud, chaque fichier assez volumineux pour être téléversé est décompté d'un quota mensuel (le vôtre avec un abonnement, celui de votre société avec l'offre gratuite), affiché dans le compteur Imports de fichiers sur Compte. Il se réinitialise au début du mois suivant.

Note

Les tailles qu'affiche l'application sont celles que montre votre gestionnaire de fichiers (Mo décimaux), vous pouvez donc les comparer directement aux propriétés du fichier.

La vue 3D ne démarre pas, ou l'image est mauvaise

Symptôme. Démarrer la session échoue, ou la session tourne mais l'image est floue ou saccadée.

Cause et remède. La vue 3D est une session de rendu exécutée pour vous dans le cloud et diffusée vers l'onglet : les échecs relèvent donc des droits, de la capacité et de la bande passante, et non de votre carte graphique :

  • Connectez-vous à votre compte cloud pour démarrer une session de streaming : elle n'est pas disponible hors connexion.

  • Votre offre n'inclut pas le streaming 3D : un droit, pas un quota. Toutes les offres portent un quota de streaming, l'offre gratuite comprise : ce message signifie donc que votre compte n'a aucune offre active (Votre compte, votre équipe & vos calculs cloud).

  • Votre quota mensuel de streaming 3D est épuisé : le compteur de streaming 3D sur Compte. Une session ne démarre qu'avec au moins 60 s restantes ; si le quota s'épuise en cours de session, la diffusion s'arrête, et seules les secondes réellement diffusées sont décomptées.

  • Tous les serveurs 3D sont occupés pour le moment. Réessayez dans quelques minutes — avec l’offre gratuite, une session ne démarre que si aucun client payant n’a besoin du serveur. : une question de capacité, pas de compte. Tous les serveurs 3D sont utilisés, et comme les clients payants passent en premier, une session de l'offre gratuite ne démarre que si un serveur est libre et qu'aucun client payant n'en a besoin (Le travail des clients payants passe d'abord). Réessayez quelques minutes plus tard.

  • Le streaming 3D n'est pas activé sur ce déploiement ou Le lecteur de streaming n'est pas installé sur ce déploiement : rien que vous puissiez corriger depuis l'application ; adressez-vous à qui exploite le déploiement.

  • Image floue ou saccadée. La diffusion s'adapte à votre connexion. Baissez le réglage Qualité, fermez les autres onglets lourds, et préférez une connexion filaire : ce n'est pas le rendu qui est le goulot d'étranglement, c'est le lien.

Note

La phase de démarrage (Démarrage du rendu cloud) n'est pas décomptée du quota de streaming. Le compteur démarre quand la session passe à En direct.

Les résultats ne correspondent pas au projet à l'écran

Symptôme. Une vue de résultats porte un badge Obsolète, ou les chiffres ne reflètent pas une modification que vous venez de faire.

Cause. Le lancement est explicite : éditer le projet ne le relance pas. Le badge apparaît dès que ce qui est à l'écran a dérivé par rapport au calcul affiché, et sa formulation nomme ce qui a dérivé : Obsolète — le projet a changé depuis ce calcul.

Remède. Appuyez sur Lancer le projet, juste avant le badge sur Résultats : il soumet le projet courant et vous emmène au nouveau résultat.

Note

Exporter ne relance pas le projet : le PDF est celui stocké avec le calcul que vous prévisualisez. Lorsque le badge indique que le projet a changé, appuyez sur Lancer le projet et exportez une fois le nouveau calcul terminé (Ce que livre un export).

L'icône Résultats est rouge

Symptôme. L'entrée Résultats du rail de navigation est rouge, et son infobulle liste Calcul : Le calcul n’a pas été effectué, parfois alors que Résultats affiche encore un calcul.

Cause. L'indicateur vaut pour le projet ouvert dans cet onglet : ce navigateur ne connaît aucun calcul réussi de ce projet. Le calcul affiché, s'il y en a un, est le plus récent de votre session et peut appartenir au projet que vous aviez ouvert auparavant. Un calcul échoué ne compte pas, pas plus qu'un calcul effectué quelque part que ce navigateur n'a pas vu : un autre navigateur ou ordinateur, un collègue, un assistant IA ou un script.

Remède. Lancez le projet (Lancer le projet, ou Ctrl+Entrée depuis n'importe quelle vue). S'il existe déjà un calcul cloud de ce projet que vous pouvez ouvrir (le vôtre, ou n'importe lequel de la société avec le rôle Direction), Voir le résultat sur sa ligne dans Calculs cloud (Calculs cloud : l'historique des tâches) efface l'indicateur sans dépenser un autre calcul.

Un projet ne s'ouvre pas

Symptôme. Choisir un fichier .pvspline.json affiche Impossible de lire le fichier sélectionné, ou le projet s'ouvre mais les cartes d'édition disent que le projet de travail n'est pas un JSON valide.

Cause et remède.

  • Ce n'est pas du JSON valide. Quelque chose a tronqué ou modifié le fichier. Ouvrez-le dans un éditeur de texte et vérifiez qu'il s'analyse, et qu'il porte un numéro schema de premier niveau.

  • Il est trop ancien. Les fichiers en dessous du plancher pris en charge (schémas 1–4) sont refusés d'emblée. Ouvrez un tel fichier dans une version plus ancienne de pvSpline et ré-enregistrez-le pour le faire évoluer.

  • Il est plus récent que le moteur qui répond. Le moteur ne lit que les champs qu'il comprend et vous avertit ; il ne réenregistrera pas le projet à l'ancien format.

Astuce

Lancer le projet est aussi le triage le plus rapide pour un projet qui s'ouvre mais se comporte bizarrement : une erreur que trouve la vérification du moteur s'affiche sous le bouton sans dépenser de calcul, et chaque avertissement qu'elle relève figure en tête de la carte Avertissements du calcul.

Une fiche technique de composant ne s'importe pas

  • Les fichiers .PAN/.OND/.BTR/.PMP sont encodés en Windows-1252 ; un fichier ré-enregistré en UTF-8, ou tronqué par une passerelle de messagerie, peut ne pas s'analyser. Réexportez-le depuis PVsyst et importez les octets d'origine.

  • Vous pouvez importer un composant, pas un projet ou une variante PVsyst entière : il n'existe pas d'importateur .PRJ.

  • Si le fichier est volumineux, vérifiez le plafond ci-dessus avant d'accuser le fichier.

  • Dans l'onglet Schéma, l'onduleur s'est chargé, mais il n'est pas dans le catalogue. Charger un .OND dans une ligne d'onduleur fonctionne pour tous les rôles, mais seul le rôle Direction ou Admin range aussi l'appareil dans le catalogue Onduleurs de votre société ; avec le rôle Utilisateur, la ligne est renseignée et rien de plus. Avec ce rôle, L’onduleur a été chargé, mais n’a pas pu être ajouté au catalogue : … signifie que la ligne est correcte et que seule la copie au catalogue a échoué. Importez à nouveau le fichier depuis la catégorie Onduleurs du Catalogue.

Le rapport ne s'imprime pas ou ne s'exporte pas

  • « Aucun calcul terminé. » Le rapport d'étude est tiré d'un calcul terminé : choisissez-en un en haut de l'onglet Résultats, ou lancez le projet avec Lancer le projet. La déclaration préalable et le dossier Consuel n'ont besoin d'aucun calcul.

  • « Aucun projet n'est chargé. » Le rapport est conditionné au projet, pas seulement au calcul. Ouvrez-en un ou créez-en un.

  • La fenêtre d'impression n'apparaît jamais. Votre navigateur a bloqué la fenêtre surgissante. Autorisez les pop-up pour ce site, ou exportez le PDF et imprimez-le depuis votre propre visionneuse.

  • L'export lance d'abord une simulation. Il n'y avait aucun calcul terminé à exporter : l'application en produit donc un (Le rapport nécessite une simulation à jour — calcul du projet en cours…) et exporte son rapport. Si ce calcul échoue, le message dit pourquoi : corrigez ce qu'il désigne et exportez à nouveau.

  • Le vérificateur ne trouve aucun code. Seul un rapport signé par le cloud en porte un : un calcul cloud effectué avant que les rapports soient scellés et un calcul mis en file par un assistant IA n'en portent pas. Relancez le projet pour obtenir un rapport qui en porte un. Déposez ensuite le PDF lui-même sur le vérificateur plutôt qu'une image de sa couverture : il en lit l'empreinte et le sceau. À une photographie trop floue pour être lue, il répond Aucun code QR détecté dans l’image. Essayez avec une photo plus nette, ou déposez le PDF. (Vérification du rapport).

  • La page de l'étude par lots manque. La page s'imprime à partir de l'étude par lots enregistrée dans le projet sur lequel le calcul a été effectué : un calcul fait avant le lot n'en a donc pas, et le rapport n'a pas de page pour elle. Relancez le projet, puis exportez en vérifiant que la case de la page est cochée dans la liste de graphiques (Étude par lots : comparaison des scénarios).

Les chiffres diffèrent de PVsyst

Symptôme. Une étude PVsyst du même site et du même matériel donne un productible annuel différent.

Cause. Presque toujours une différence d'entrées plutôt qu'une différence de physique, et la cascade de pertes est faite pour la rendre visible : elle est disposée dans l'ordre propre à PVsyst, et les pertes onduleur se réconcilient ligne à ligne avec les deux jeux de variables qu'exporte PVsyst (La cascade de pertes, ligne par ligne).

Remède. Mettez les deux diagrammes de pertes côte à côte et descendez-les. Les lignes qui diffèrent d'ordinaire sont :

  • Ombrage proche : pvSpline reporte l'ombrage mutuel entre rangées en lignes distinctes (direct, diffus et électrique), et extrait la végétation de la ligne de direct lorsqu'un précalcul 3D a vu une canopée. PVsyst regroupe tout cela dans sa scène 3D : comparez donc la somme, pas une seule ligne.

  • Salissures, neige et horizon : pvSpline les calcule à partir de la météo réelle et de l'horizon propre au site quand il le peut, au lieu d'un pourcentage saisi. Confrontez ce que chaque modèle a produit à la constante que l'autre étude a supposée.

  • Ohmique CC : calculé à partir de vos longueurs de câbles dimensionnées lorsque le projet a une nomenclature, plutôt qu'un pourcentage forfaitaire.

  • L'onduleur : sans onduleur dans la conception électrique, la conversion est une perte forfaitaire sans écrêtage et le productible ressort de quelques pour cent trop haut ; l'onduleur de départ générique que place Créer une conception initiale n'a pas de rendement constructeur. La carte Avertissements des Résultats signale quand l'un ou l'autre s'applique. Placez l'onduleur de la variante PVsyst dans l'onglet Schéma avant de comparer (L'onduleur de départ).

  • L'année de référence : vérifiez que les deux études utilisent la même source météo et la même probabilité de dépassement (un P50 médian face à un cas bancaire P90 ne s'accordera jamais). Un projet pvSpline est calculé au P90 sauf si vous choisissez un autre percentile, et les tuiles de Production ainsi que les kWh du diagramme de pertes affichent ce chiffre (les tuiles le disent : Production annuelle · P90), alors qu'un productible annuel PVsyst est le P50. Comparez-le au segment P50 de Production probabiliste (Production probabiliste (P50/P75/P90/P99)), ou choisissez P50 et relancez ; les pourcentages de pertes sont les mêmes à tout percentile.

Référence des champs

Cette annexe n'a pas de panneau éditable propre ; ses « champs » sont les entrées des fichiers que pvSpline lit et écrit. Les tableaux ci-dessous vous permettent de lire ou de rédiger à la main un fichier de projet, de site ou de tarif. Chaque ligne donne la clé, son type et son unité, sa valeur par défaut et sa signification. (Pour les contrôles à l'écran qui fixent ces valeurs, voir les chapitres référencés dans chaque sous-section.)

Fichier de projet : clés de premier niveau

Champ / contrôleType et unitéPar défautCe qu'il fait et comment le régler
schemaentier31Version du format de fichier. Obligatoire ; une valeur absente ou sous le plancher est rejetée. Écrite en 31 ; les fichiers plus anciens sont migrés automatiquement à l'ouverture.
projectNamechaîne""Titre de projet en texte libre affiché sur la couverture du rapport.
clientNamechaîne""Nom du client en texte libre pour la couverture.
clientEmail / clientPhone / clientSiretchaîne"" / "" / ""Bloc de coordonnées client : e-mail, téléphone et numéro d'entreprise SIRET (français). Tous vides par défaut. Ajouté au schéma 16.
prmchaîne""Identifiant de compteur Enedis français (14 chiffres) utilisé pour récupérer la charge mesurée.
saveIdentier-1Identifiant de ligne de la base de données locale. -1 signifie un projet uniquement fichier, sans ligne en base.
pNomStcKwpnombre · kWc0Puissance nominale CC installée aux conditions STC. Détermine toutes les métriques par kWp (productible spécifique, PR).
acSystemRatedKwnombre · kW0Puissance nominale CA cumulée des onduleurs. 0 désactive l'écrêtage CA.
summerMonthsMaskchaîne · 12 caractères""Indicateurs « 0/1 » de janvier à décembre marquant les mois qui utilisent le tarif d'été. Vide ou entièrement à zéro, il signifie d'avril à octobre.
horaireE / horaireHtableau—Les fenêtres horaires d'heures pleines/creuses d'été (horaireE) et d'hiver (horaireH), chacune étant une liste de plages {"start":"HH:MM","end":"HH:MM"} marquant les heures pleines (HP). Définies sur la carte TARIFS DE CONSOMMATION (Les cartes de tarifs de consommation et de tarification réseau du projet). Jusqu'à trois fenêtres par saison : la carte n'en ajoute pas davantage, et un enregistrement sur votre compte conserve les trois premières de chaque saison. En Heures pleines / creuses, les fenêtres d'hiver s'appliquent toute l'année.
hourlyTarifftableau · 8760 × €/kWh—Prix d'achat horaire facultatif. Il ne tarifie le calcul que lorsque la Source du tarif de la carte TARIFS DE CONSOMMATION vaut Depuis un CSV horaire (le régime CSV horaire), ou dans un fichier qui n'enregistre aucune granularité ; en Tempo (EDF), le calcul construit sa propre courbe à partir des six prix de couleur et le fichier porte cette courbe ici, et avec les formules à tarif unique ou à heures pleines/creuses une courbe est conservée mais ignorée.
exportLimitScheduletableau 12×24 · kW—Plafond d'injection réseau par mois × heure. -1 = sans plafond ; omis lorsque tout est sans plafond.
evSessionstableau—Sessions de recharge de véhicule électrique sous la forme qu'utilisent les fichiers plus anciens (arrivée et départ, énergie nécessaire, puissance du chargeur, mode de charge). L'application range plutôt les véhicules d'un projet parmi ses sources de consommation (consumptionSources) : un fichier qu'elle écrit n'en a donc généralement aucune ici. Les sessions trouvées ici sont tout de même lues, chacune devenant une source Véhicule électrique co-simulée, sauf si le fichier liste déjà un véhicule parmi ses sources, auquel cas elles sont ignorées. Voir L'onglet Consommation.
dataPayloadsobjet—Séries récupérées et intégrées (irradiance PVGIS, météo Open-Meteo, consommation) qui permettent au projet de s'ouvrir et de se simuler hors ligne. Ajouté au schéma 8.
dataPayloads.dataVintageobjet—Provenance de ces séries embarquées : pour chacune, sa source, la fenêtre qu'elle couvre réellement, quand elle a été récupérée et une empreinte de son contenu, ainsi que les fenêtres que la prochaine récupération devrait demander. Absent signifie « non vérifié », jamais « incohérent ». Ajouté au schéma 26.
dataPayloads.designClimateobjet—La température froide de conception du site : la température de l'air la plus froide (°C) de toute heure diurne de l'historique Open-Meteo pluriannuel embarqué (coldestDaylightC), avec les années qu'il couvre (firstYear, lastYear, years) et sa source. Écrite lorsque cet historique est embarqué et couvre au moins cinq ans ; absente sinon. La vérification de la tension à froid des chaînes planifiées l'utilise lorsqu'aucune température minimale du site n'est définie dans Schéma (Décider et appliquer). Ajouté au schéma 30.
dataPayloads.pvgisSeriesParamsobjet—Pour chaque polygone PV, indexé par son polyId, la requête à laquelle sa série PVGIS embarquée répond : le point interrogé (lat, lon), le plan (tilt, azimuth), le type de pose et de suivi PVGIS (mounting, tracking) et la part de la face principale dans le mélange à deux faces stocké (eastFraction). Écrit par la récupération météo à côté de chaque série. L'application web récupère à nouveau un polygone modifié après sa récupération au lieu de le simuler sur l'ancienne série, et un calcul avertit lorsqu'il doit le faire. Absent signifie que la série est considérée comme à jour. Ajouté au schéma 31.
electricalBomobjet—Longueurs de câbles dimensionnées, prix unitaires des conducteurs et des composants (componentPrices) et lignes de nomenclature saisies à la main (manualItems : structure, main-d'œuvre, autorisations, divers) pour une nomenclature portable. Ajouté aux schémas 9/11/17. Le schéma 21 y a ajouté l'état propre à l'estimateur de longueurs de câbles : l'épingle du tableau CA sur la carte (acPanelLat / acPanelLon) et les réglages de projet routingFactor / verticalDropM.
mapOffsetobjet—Décalage de calibrage Est/Nord de la carte 3D (mètres) qui aligne le tracé dessiné avec l'imagerie du fond de carte. Ajouté au schéma 12. Voir L'onglet Carte & conception du site.
tenderFamily / tenderPeriodechaîne"" / ""Famille cible et période de l'appel d'offres CRE (le segment français d'appel d'offres qui conditionne l'éligibilité module-ECS). Les deux vides par défaut. Ajouté au schéma 15.
rawValuesobjetvideMagasin de cellules clé/valeur de bas niveau reproduisant la grille de saisie interne de l'application. Il contient aussi une seconde fois les saisies tarifaires : les quatre tarifs d'achat (tarif_hph … tarif_hce, en c€/kWh ici), la charge de puissance, les mois d'été, les fenêtres d'heures pleines (horaire_h0s … horaire_e2e, trois par saison), la courbe horaire et le plafond d'injection. Pour celles-ci, une cellule qui porte une valeur prime sur la clé typée ci-dessus, qui ne s'applique que lorsque sa cellule est absente ou vide (ou, pour un tarif, une valeur de puissance ou la courbe, illisible). Un fichier écrit par l'application porte généralement les deux formes : pour modifier l'une de ces valeurs à la main, changez la cellule ou supprimez-la. Les cellules contiennent aussi la Granularité choisie sur les cartes TARIFS DE CONSOMMATION et TARIFICATION RÉSEAU (tarif_conso_mode, tarification_reseau_mode), les coches d'inclusion des graphiques dans le PDF (graph_vis_N) et l'étude par lots enregistrée (batch_study_json). Un enregistrement sur votre compte stocke les cellules, en remplissant une cellule vide à partir de sa clé typée, de sorte que le tarif avec lequel le projet est simulé survit à l'enregistrement et à la réouverture.

Sous-objet site

Voir L'onglet Projet et L'onglet Carte & conception du site pour les contrôles qui les définissent.

Champ / contrôleType et unitéPar défautCe qu'il fait et comment le régler
latitudenombre · °0.0Degrés décimaux, positifs vers le Nord. Plage -90 à +90.
longitudenombre · °0.0Degrés décimaux, positifs vers l'Est. Plage -180 à +180.
altitudenombre · m0.0Mètres au-dessus du niveau de la mer.
timezoneOffsetHoursnombre · h0Décalage signé par rapport à UTC, en heures, sans heure d'été ; un décalage à la demi-heure ou au quart d'heure comme 5.5 est conservé. Plage -12 à +14.
countryCodechaîne""ISO 3166-1 alpha-2 (par exemple FR). Le bilan carbone prend son facteur réseau sur la carte EMPREINTE CARBONE (L'onglet Projet), et ne lit ce code que lorsque la carte laisse vides à la fois son pays et son intensité carbone du réseau : le facteur réseau est alors celui que la table de pays intégrée donne pour ce code.
namechaîne""Étiquette de site en texte libre.

Tableau polygons (un par zone de champ)

Voir L'onglet Carte & conception du site et Lancer une simulation & l'onglet Production.

Champ / contrôleType et unitéPar défautCe qu'il fait et comment le régler
polyIdentier-1Identifiant unique du polygone.
tiltDegreesnombre · °35.0Inclinaison de la surface par rapport à l'horizontale. Détermine la transposition et l'auto-ombrage.
azimuthDegreesnombre · °0.0Azimut de la surface : 0=Nord, 90=Est, 180=Sud, 270=Ouest. Écrivez toujours à la fois cette clé et tiltDegrees : un polygone qui omet l'azimut est simulé face au nord. Un calcul avertit pour un champ fixe incliné de 10° ou plus et tourné vers le pôle de son hémisphère à 20° près (dans l'hémisphère nord, vers le nord), sauf sur un site situé à moins de 5° de l'équateur ; un champ moins incliné est simulé face au nord sans avertissement.
groundCoverageRationombre0.4Taux de couverture du sol pour le backtracking d'une zone de tracker à un axe (longueur de module / entraxe des rangées) ; sur un champ concentrateur à deux axes, c'est aussi l'espacement des rangées derrière son ombrage inter-rangées. Sur une zone dont le type de module est un tracker, c'est le GCR backtracking (0–1) du module qui s'applique (0 signifiant pas de backtracking), et choisir un tel module recopie ici une valeur non nulle. Ignoré pour les champs fixes (Physique de simulation & référence des données).
groundAlbedonombre0.2Réflectance du sol, 0–1. Alimente la lumière diffuse et bifaciale en face arrière.
trackerEnumentier00=Fixe, 1=Mono-axe (un axe horizontal orienté selon azimuthDegrees : 180 nord–sud, 90 est–ouest), 2=Deux-axes. Sur un calcul PVGIS, une zone mono-axe dont l'axe est à moins de 45° de la direction est–ouest reçoit l'irradiance d'un suiveur horizontal est–ouest, toute autre celle d'un suiveur horizontal nord–sud, sauf si singleAxisPvgisCode désigne l'axe. Écrit à partir du type de module de la zone chaque fois qu'un module est choisi pour la zone dans Carte, qui l'affiche en lecture seule sous Suiveur.
singleAxisPvgisCodeentier—Le type d'axe PVGIS pour lequel l'irradiance d'une zone mono-axe est demandée, lorsque le fichier en nomme un : 3=axe vertical, 4=horizontal est–ouest, 5=incliné nord–sud. Omis (par défaut), l'axe suit azimuthDegrees, comme sous trackerEnum. Il n'agit que sur la requête PVGIS : la géométrie propre du calcul tourne toujours autour d'un axe horizontal orienté selon azimuthDegrees.
trackingStrategyentier0Stratégie de suivi d'un tracker à un axe, recopiée du type de module : 0=Astronomique, 1=Optimisation d’éclairement. Omise à 0.
rotationLimitDegreesnombre · °—Limite de rotation mécanique d'un tracker à un axe, recopiée du type de module. Omise lorsque le type n'en fixe aucune.
windStowThresholdMs / windStowAngleDegreesnombre · m/s / nombre · °—Mise en sécurité au vent du tracker, recopiée du type de module : le vent horaire au-delà duquel le tracker se met en sécurité, et sa rotation en position de sécurité. Présentes seulement tant que la mise en sécurité est armée ; absentes = pas de mise en sécurité.
panelFingerprintchaîne""Référence adressée par contenu vers le module utilisé sur cette zone. Vide = valeur par défaut du projet. Le composant référencé voyage dans les tableaux de premier niveau panelLibrary / inverterLibrary / batteryLibrary / boxLibrary / wireLibrary du fichier (ajoutés aux schémas 3–4), de sorte qu'un projet partagé résout chaque composant sans nouvelle saisie.
kWpnombre · kWc0.0Puissance nominale installée sur ce polygone. Dérivée, non saisie : le placeur de modules réinscrit ce qu'il a réellement réussi à placer.
floatingbooléenfalseIndicateur sur l'eau (PV flottant) ; active le traitement thermique/albédo FPV. Ajouté au schéma 10.
albedoMaterial / autoAlbedochaîne / booléen"" / falseClé de préréglage de matériau de sol facultative et un indicateur signalant que l'albédo a été estimé à partir de l'imagerie du fond de carte. Ajouté au schéma 14.
vertexRingtableau—Le contour dessiné, [[lat, lon], ...] dans l'ordre des sommets (degrés WGS84), ouvert : le dernier point n'est pas répété. C'est ce qui permet à un projet partagé de redessiner son emprise et de replacer ses modules n'importe où. Ajouté au schéma 19 ; un projet créé avant lui figure dans le panneau latéral mais n'a pas d'emprise à dessiner. Depuis le schéma 23, un sommet peut porter un troisième élément, une hauteur au-dessus du sol en mètres, utilisée uniquement par la trajectoire de caméra 3D.
maxKwpCapnombre · kWc—Plafond de puissance installée par polygone. Le placeur de modules le respecte ; il ne l'écrit jamais. Ajouté au schéma 19.
pvPortraitModebooléen—Indique si les modules sont posés en portrait plutôt qu'en paysage sur cette zone. Ajouté au schéma 19.
isObstacle / isBuildingbooléenfalse / falseMarque le polygone comme un masque ou un bâtiment plutôt que comme une zone de champ : il porte de l'ombre mais aucun module. Ajouté au schéma 19.
bipvModechaîne""Montage intégré au bâti pour cette zone, qui remplace le montage de la fiche technique du module : integrated (dos isolé, sans circulation d'air, soit le régime le plus chaud) ou semi_integrated (lame d'air ventilée). Vide = non intégré à l'enveloppe. Ajouté au schéma 28. Voir L'onglet Carte & conception du site.
isBiomebooléenfalseMarque le polygone comme une région de végétation plutôt que comme un champ PV. Lorsqu'il est actif, les clés compagnes biomeType, biomePreset, biomeParams, plantSpecies, growthCurve, biomeCoverage et biomeDensity le décrivent ; elles sont entièrement omises sur tous les autres polygones. Ajouté au schéma 20. Voir La vue Terre 3D du site.
isVideoPath / videoFocusPvbooléenfalse / falseMarque le polygone dont le vertexRing est la trajectoire de caméra ouverte d'une vidéo 3D de course du soleil (son azimut sert aussi de direction de caméra), et indique si la caméra vise le champ le plus proche pendant le trajet. Ajouté au schéma 22 ; le schéma 23 a ajouté videoLensZoom (1 = objectif naturel), videoPerPointHeights et videoFollowTerrain.

Sous-objet tariffs (tarifs d'achat à 4 périodes)

Voir Préférences, tarifs & thèmes. Les clés manquantes prennent la valeur par défaut 0.0 (aucun revenu / aucun coût). Les tarifs que facture un calcul suivent la Granularité de la carte TARIFS DE CONSOMMATION : en Tarif unique, chaque heure est facturée à hphTarif, en Heures pleines / creuses, l'été est facturé au couple d'hiver, et avec la source Depuis un CSV horaire, la courbe horaire tarifie chaque heure (ou, sans courbe chargée, les quatre tarifs selon la saison et les heures pleines, ce dont un calcul avertit). Une cellule rawValues qui porte le même tarif (tarif_hph … tarif_hce, en c€/kWh) prime sur ces clés.

Champ / contrôleType et unitéPar défautCe qu'il fait et comment le régler
hphTarifnombre · €/kWh0.0Tarif d'achat heures pleines × hiver (HP × hiver).
hpeTarifnombre · €/kWh0.0Tarif d'achat heures pleines × été (HP × été).
hchTarifnombre · €/kWh0.0Tarif d'achat heures creuses × hiver (HC × hiver).
hceTarifnombre · €/kWh0.0Tarif d'achat heures creuses × été (HC × été).

Sous-objet capacityCharge

Le bloc d'abonnement de puissance, facturé dans la mesure où le permet la Granularité de la carte TARIFICATION RÉSEAU (rawValues.tarification_reseau_mode) : 0 (Aucune) n'en facture rien, 1 (Abonnement) facture puissanceSouscriteKva × prixKvaMois mais pas prixDepassementKvah, et 2 (TURPE + écrêtage de pointe), 3 (Comptage net) ou un fichier qui n'enregistre aucun niveau en facturent la totalité. Tout à zéro signifie « aucune charge de puissance ». Une cellule rawValues qui porte la même valeur prime sur ces clés. Voir Préférences, tarifs & thèmes.

Champ / contrôleType et unitéPar défautCe qu'il fait et comment le régler
puissanceSouscriteKvanombre · kVA0Puissance souscrite.
prixKvaMoisnombre · €/kVA/mois0Charge de puissance mensuelle par kVA souscrit.
prixDepassementKvahnombre · €/kVAh0Tarif de dépassement facturé lorsque la pointe dépasse la puissance souscrite.
prixPeakKwMoisnombre · €/kW/mois0Prime de puissance sur la pointe de soutirage de chaque mois, facturée avec ou sans puissance souscrite à partir du niveau TURPE ; absente du fichier quand elle vaut 0.
peakWindowMinutesentier · min0Fenêtre glissante utilisée pour définir la « pointe » facturée.

Sous-objet battery

Stockage physique et virtuel (banque cloud). Tout à zéro = pas de batterie. Voir Stockage, VE & systèmes spécialisés.

Champ / contrôleType et unitéPar défautCe qu'il fait et comment le régler
capacityKwhnombre · kWh0Capacité utile de la batterie. Nommée capacity avant le schéma 25 ; les fichiers plus anciens sont migrés.
isVirtualbooléenfalseBatterie virtuelle (banque d'énergie cloud). Mutuellement exclusive avec isPhysical.
isPhysicalbooléenfalseBatterie physique sur site.
physicalMinSocFracnombre0État de charge plancher (fraction 0–1) ; la batterie n'est jamais descendue en dessous. Nommée physicalDodMin avant le schéma 25 (un nom qui disait son propre contraire) et renommée aux deux endroits où elle persiste, si bien que les fichiers plus anciens sont migrés.
physicalMaxChargeKwnombre · kW0Puissance de charge maximale.
physicalMaxDischargeKwnombre · kW0Puissance de décharge maximale.
physicalCouplingentier00=couplage CA, 1=couplage CC. Le couplage CC stocke le surplus que l'écrêtage CA gaspillerait.
virtualFeeEurPerKwhnombre · €/kWh0Frais de retrait par kWh sur une banque virtuelle.
virtualSubscriptionEurPerMonthnombre · €/mois0Abonnement mensuel forfaitaire pour une banque virtuelle.
virtualSubscriptionEurPerKwcMonthnombre · €/kWc/mois0Abonnement par kWc, facturé sur les kWc installés en plus du forfait. Ajouté au schéma 18.
virtualConversionRationombre1.0Rendement aller-retour de la banque virtuelle, 0–1.
virtualExpiresMonthly / virtualExpiresAnnuallybooléenfalseIndique si le solde stocké est remis à zéro en fin de mois ou d'année. Mutuellement exclusifs.

YAML du catalogue de tarifs

Un tarif par fichier. Tous les champs sont facultatifs ; « absent » reste distinct de « explicitement 0 ». Les tarifs sont en centimes/kWh.

Champ / contrôleType et unitéPar défautCe qu'il fait et comment le régler
provider / namechaîne—Identité du fournisseur et de l'offre, affichée dans le catalogue.
country / currencychaîne—ISO 3166 alpha-2 / ISO 4217.
valid_from / valid_tochaîne · date ISO—Fenêtre de validité utilisée pour les avertissements d'obsolescence.
source_urlchaîne—Lien d'attribution / d'audit pour le tarif. Exclu de l'empreinte du tarif.
buy_modeénumération—L'une des valeurs flat (ou forfait), hp_hc (ou hphc), hp_hc_season (ou saison), hourly_csv (ou csv) ou tempo : les cinq modes ci-dessous.
flat_ratenombre · c/kWh—Tarif d'achat unique pour le mode flat.
hph / hpe / hch / hcenombre · c/kWh—Tarifs d'achat heures pleines/creuses × hiver/été.
summer_months_maskchaîne · 12 caractères—« 0/1 » de janvier à décembre ; mode seasonal uniquement.
hourly_csv_pathchaîne—Chemin (relatif au fichier de départ) vers une courbe de prix horaire de 8760 lignes ; mode hourly-CSV uniquement.
tempo_bleu_hc … tempo_rouge_hpnombre · c/kWh—Les six prix EDF Tempo ; mode Tempo uniquement.
tempo_calendar_codeschaîne · 365 caractères—Codes couleur par jour (0 bleu / 1 blanc / 2 rouge) ; vide = calendrier EDF canonique.
sell_ratenombre · c/kWh—Tarif de revente du surplus PV.
sell_escalation_pctnombre · %/an—Progression annuelle du tarif de revente.
network_kindénumération—Modèle de charge réseau : none, subscription (ou abonnement) ou turpe (ou turpe_peakshave). Appliquer le tarif règle en conséquence la Granularité de la carte TARIFICATION RÉSEAU du projet (Aucune, Abonnement ou TURPE + écrêtage de pointe), et ce niveau décide de ce qui est facturé : none aucune charge réseau, subscription la seule part mensuelle par kVA, turpe la pénalité de dépassement en plus. Les champs qu'un type ne facture pas sont tout de même écrits, simplement pas facturés. Absent, il laisse le niveau du projet tel quel ; net_metering_enabled à true sélectionne Comptage net à la place. Sur un projet qui était en comptage net, appliquer un tarif qui fixe un network_kind (ou une facture qui porte un modèle de charge réseau) désactive la réconciliation du comptage net en même temps que le changement de niveau, tout comme net_metering_enabled à false.
subscribed_kvanombre · kVA—Puissance souscrite pour la charge réseau.
price_kva_monthnombre · €/kVA/mois—Charge de puissance mensuelle (Enedis publie par an ; à convertir).
price_depassement_kvahnombre · €/kVAh—Pénalité de dépassement de puissance.
net_metering_enabled / period / ratio / true_upbooléen / entier / nombre / nombre—Bloc de comptage net (net metering) : activé/désactivé, mensuel (1) ou annuel (12), fraction de compensation, et le tarif de régularisation pour l'excédent.
reactive_tan_phi_thresholdnombre—Allocation gratuite de puissance réactive en tan(φ) avant application des pénalités (valeur TURPE par défaut 0,4).
price_kvarh_penaltynombre · €/kVArh—Pénalité d'énergie réactive facturée sur la consommation au-delà du seuil de tan(φ).
Mode d'achat du tarifSignification / effet
Tarif uniqueUn tarif unique appliqué à chaque heure.
HP/HCPériodes d'heures pleines et d'heures creuses.
HP/HC saisonnierDécoupage heures pleines/creuses subdivisé en outre selon les mois d'été et d'hiver.
CSV horaireUne courbe de prix horaire de 8760 lignes.
TempoLe calendrier de jours bleu/blanc/rouge d'EDF, chaque couleur ayant son propre tarif d'heures pleines et creuses.

Rendre un projet portable pour qu'il s'ouvre hors ligne

  1. Ouvrez le projet pendant que vous disposez d'une connexion Internet.

  2. Définissez le site et laissez pvSpline récupérer la météo (L'onglet Carte & conception du site) : l'irradiance PVGIS et Open-Meteo se téléchargent et se mettent en cache automatiquement la première fois.

  3. Si vous utilisez une charge mesurée, récupérez la consommation Enedis pour le PRM (L'onglet Consommation).

  4. Lancez une simulation une fois pour que chaque série soit matérialisée.

  5. Téléchargez le projet depuis Projet (/project). À partir du schéma 8, les séries récupérées sont embarquées dans le fichier .pvspline.json lui-même.

  6. Copiez ou envoyez par courriel ce fichier unique. Sur n'importe quelle machine, même sans réseau, le redéposer dans l'application l'ouvre et le resimule à l'identique, car la météo et la consommation voyagent à l'intérieur.

Diagnostiquer un projet que l'application refuse d'ouvrir

  1. Notez le message exact. « Impossible de lire le fichier sélectionné » signifie que le navigateur n'a pas pu le lire du tout ; « n'est pas un JSON valide » signifie qu'il l'a lu et que le contenu est malformé.

  2. Ouvrez le fichier dans un éditeur de texte et vérifiez qu'il s'analyse bien comme du JSON et qu'il porte un numéro schema de premier niveau. Un fichier qui a perdu sa clé schema, ou qu'une passerelle de messagerie a tronqué, échoue ici.

  3. Vérifiez la version. En dessous du plancher pris en charge (schémas 1–4) il est refusé ; ouvrez-le dans une version plus ancienne de pvSpline et ré-enregistrez-le pour le faire évoluer. Au-dessus de la version du moteur, il s'ouvre avec un avertissement et ne lit que les champs que ce moteur connaît.

  4. Si le fichier s'ouvre mais se comporte bizarrement, lancez-le. La vérification du moteur nomme chaque problème qu'elle peut voir : un site encore à 0, 0, aucun polygone, une valeur hors plage, un champ incliné tourné vers le pôle, un tarif horaire ou Tempo dont les prix manquent, un compteur sans série de consommation. Une erreur arrête le calcul sous Lancer le projet sans le dépenser ; un avertissement figure en tête de la carte Avertissements du calcul.