Introduction & présentation

Ce qu'est pvSpline

pvSpline est une suite moderne de simulation et de conception photovoltaïque qui s'exécute dans votre navigateur web. Vous ouvrez une URL, vous vous connectez et vous travaillez ; pas d'installeur, pas de fichier de licence à recopier d'une machine à l'autre, pas de système d'exploitation à choisir. Derrière l'interface se trouve un moteur physique et financier complet qui modélise la lumière du soleil frappant vos panneaux, les pertes sur le chemin jusqu'au réseau, le comportement des batteries ou des véhicules électriques que vous ajoutez, et le productible énergétique et l'économie du projet qui en résultent.

Ce moteur est un programme distinct, sans interface, avec lequel le navigateur dialogue par le réseau. Où s'exécute le moteur de simulation explique où il s'exécute et ce que cela signifie pour vous.

Le nom vient de la spline : pvSpline reconstruit des courbes lisses et infra-horaires de production et de consommation à partir des données météo horaires grossières où la plupart des outils s'arrêtent, au moyen d'une interpolation qui préserve l'énergie. Cela lui permet de capturer les brefs pics d'irradiance et l'écrêtage onduleur que les outils purement horaires lissent, et c'est pourquoi les résultats de stockage, de pointe et d'autoconsommation ressortent plus nets.

Un atout majeur pour quiconque migre depuis un autre outil : pvSpline lit directement les fichiers de composants standard de l'industrie. Si vous tenez déjà une bibliothèque de fichiers PVsyst .PAN (module), .OND (onduleur) et .BTR (batterie), ils s'importent sans ressaisie, même si, comme toute modification du catalogue, l'import est réservé aux rôles Direction et Admin de votre société. Voir Le catalogue de composants pour le catalogue de composants et les importateurs.

À qui il s'adresse

pvSpline est conçu pour les professionnels du solaire, pas pour l'estimation occasionnelle :

• Les concepteurs esquissent le champ sur la photographie aérienne de l'IGN, placent les chaînes, et laissent les panneaux remplir automatiquement un toit ou un terrain dessiné.

• Les ingénieurs électriques dimensionnent les conducteurs, vérifient le courant admissible selon les normes NEC / CEI / UTE, et génèrent un schéma unifilaire interactif.

• Les ingénieurs productible exécutent une transposition anisotrope, une physique de module à diode unique et une cascade de pertes transparente, puis lisent les productibles de dépassement P50/P90.

• Les développeurs et analystes calculent le LCOE, la VAN, le TRI, le temps de retour et les ratios de couverture prêteur (DSCR, LLCR), et les soumettent à des tests de résistance, le tout dans l'outil.

Vue d'ensemble : d'une carte vierge à un rapport client

Tout dans pvSpline sert un seul fil : transformer un emplacement et un ensemble de composants en un résultat simulé, chiffré et présentable. Le parcours typique se déroule de haut en bas le long du rail de navigation, sur le bord gauche de la fenêtre.

Instantané, rapide ou en file : comment le travail s'exécute vraiment

Il est utile de savoir dès le départ quelles actions sont gratuites et lesquelles coûtent du temps. pvSpline les sépare délibérément, et l'interface vous indique laquelle vous avez déclenchée :

Instantané

Faire glisser un sommet de polygone, saisir dans un champ, déplacer et zoomer la carte ou un graphique. Ces actions n'attendent jamais rien ; elles répondent à la fréquence d'affichage.

Rapide

Régénérer le schéma unifilaire, replacer les modules dans un polygone que vous venez de modifier, chercher dans le catalogue, analyser un fichier importé. Ces actions interrogent le moteur et reviennent en bien moins d'une seconde ; le contrôle sur lequel vous avez cliqué affiche un état d'attente, et rien d'autre sur la page n'est bloqué.

Un calcul

Une simulation. Vous la lancez et le moteur contrôle d'abord le projet : une erreur l'arrête là. Puis l'onglet Résultats dit où elle en est, et les résultats se remplissent à son arrivée. Vous restez libre de travailler entre-temps. Les vues de résultats portent une pastille Obsolète dès que le projet s'est éloigné du calcul que vous consultez, à côté d'un bouton qui le relance : Lancer le projet sur Résultats, ailleurs le bouton Relancer de la pastille elle-même.

Calcul en file

Les balayages par lots, le dimensionnement automatique et tous les calculs cloud. Ils disposent d'une liste de tâches, d'un historique et d'un relevé de quota.

Principales capacités en un coup d'œil

pvSpline est vaste. La liste ci-dessous regroupe ses principales capacités pour que vous sachiez ce qui est disponible et quel chapitre ouvrir. Vous n'utiliserez pas tout sur un même projet.

Simulation & physique

Transposition anisotrope (Perez 1990, Hay-Davies 1980) ; modèle de module IV à diode unique ; réponse à l'angle d'incidence par module lue depuis le fichier .PAN ; corrections spectrales et thermiques ; simulation infra-horaire jusqu'à une résolution de 1 à 30 minutes avec un modèle transitoire de température de cellule. (Lancer une simulation & l'onglet Production, Physique de simulation & référence des données)

Ombrage & suivi

Ombrage lointain (horizon) à partir de l'horizon PVGIS ou d'une ligne d'horizon mesurée dans la scène 3D ; ombrage mutuel entre rangées ; trackers fixes, à un axe et à deux axes avec backtracking publié et mise en drapeau au vent ; un précalcul d'ombrage 3D optionnel qui mesure l'ombrage direct et la vue du ciel sur la scène réelle et écrit les tables qu'utilisera le calcul suivant. (Lancer une simulation & l'onglet Production, La vue Terre 3D du site)

Productible & bancabilité

Productible probabiliste P50 / P75 / P90 / P99 ; ratios de couverture DSCR et LLCR ; tests de résistance prêteur un à un ; métriques de performance CEI 61724-1 ; une cascade de pertes transparente et étiquetée par source. (Lancer une simulation & l'onglet Production, Graphiques, cartes de chaleur & tableaux)

Dimensionnement & études de scénarios

De nombreuses simulations complètes du projet chargé en une seule passe (balayages d'un paramètre, matrices de plusieurs paramètres et comparatifs de composants), comparées côte à côte sur l'énergie, la VAN, le LCOE, le temps de retour, le TRI des fonds propres et les DSCR et LLCR du prêteur ; et un dimensionnement automatique en un clic, Optimiser maintenant, qui note une grille chiffrée de tailles de système à la VAN ou au TRI des fonds propres et applique la meilleure conception au projet. (Simulation par lots & balayages de scénarios)

Conception électrique

Dimensionnement automatique des câbles avec pertes ohmiques réelles ; vérifications NEC / CEI 60364 / UTE C15-712 ; un schéma unifilaire CEI/IEEE interactif ; modèle d'onduleur détaillé ; optimiseurs et micro-onduleurs ; nomenclature. (Conception électrique & schéma unifilaire)

Stockage & systèmes spécialisés

Batteries couplées en CA et en CC avec quatre stratégies de pilotage ; vieillissement de batterie fondé sur la physique ; stockage virtuel / banque d'énergie ; co-simulation VE ; pompage solaire de l'eau ; traction sur réseau CC ; hybride PV + diesel / hors-réseau ; HCPV, LCPV et agrivoltaïsme. (Stockage, VE & systèmes spécialisés)

Vue Terre 3D

Une scène photoréaliste Unreal Engine 5 de votre site, reconstruite à partir du LiDAR, du terrain et de l'imagerie de l'IGN (France métropolitaine) et diffusée dans le navigateur ; placement de panneaux tenant compte des toitures ; géométrie de scène pilotée par CAO ; course du soleil animée ; clips de course du soleil exportés jusqu'en 4K. (La vue Terre 3D du site)

Carte interactive & rapports

Dessinez le champ sur la photographie aérienne de l'IGN ; détourez une toiture dans l'imagerie avec la pipette de couleur ; peignez les chaînes ; plus de 40 graphiques et cartes de chaleur ; un diagramme de pertes Sankey infographique ; un rapport PDF à votre marque, portant un QR code de vérification qu'un client ou un prêteur contrôle avec le vérificateur pvSpline gratuit (Vérification du rapport) ; et un dossier d'autorisation CERFA 16702. (L'onglet Carte & conception du site, Graphiques, cartes de chaleur & tableaux, Rapports & export)

Flux de travail natif web

Chaque vue a une URL que l'on peut mettre en favori, et un calcul terminé a la sienne, qui ouvre le résultat lui-même et non une capture d'écran. Les projets sont enregistrés sur votre compte avec un historique des versions, et un compte Direction voit tous les projets de la société ; le travail survit à un rechargement, et un onglet fermé avec des modifications non enregistrées vous les repropose à votre visite suivante. (L'onglet Projet, Votre compte, votre équipe & vos calculs cloud)

Expérience & prise en main

Thèmes clair et sombre, interface français/anglais, contrôles pilotés par l'état qui masquent ce que votre projet n'utilise pas, et dix-sept tutoriels guidés rejouables (dont deux mises en pratique notées, et celui de la mascotte, dont l'humeur est la santé de votre projet) avec des badges qui habillent la mascotte. (Tutoriels guidés & prise en main, Préférences, tarifs & thèmes)

Données, météo & réseau

Irradiance PVGIS gratuite et sans clé, horizon et pertes attestées ; pluie / neige / qualité de l'air Open-Meteo alimentant les modèles de salissure et de neige ; import de fichiers EPW, TMY3, TMY PVGIS, NSRDB, Solcast et Solargis ; consommation mesurée en direct du réseau français (Enedis). (L'onglet Consommation, L'onglet Carte & conception du site)

Automatisation & API HTTP

Le service cloud expose une API HTTP/JSON documentée, qu'un script pilote avec un jeton de service : les simulations par lots et les balayages de scénarios s'exécutent donc sans aucune interface, ce qui est idéal pour la CI et les grandes études. (Simulation par lots & balayages de scénarios, Automatiser les calculs cloud)

Assistants IA

Connectez à votre compte, depuis la France, Claude Code, Cursor, VS Code ou un autre assistant compatible Model Context Protocol (MCP) installé sur votre ordinateur : il peut créer des projets, lancer des simulations et en lire les résultats pour vous. Vous vous connectez et l'autorisez depuis une page pvSpline, ses calculs sont décomptés de votre quota mensuel de simulation et ses requêtes du quota d'API cloud, et vous pouvez le déconnecter à tout moment depuis /account. (Assistants IA)

Les trois éléments avec lesquels vous interagissez

pvSpline ressemble à une seule application et, au quotidien, se comporte comme telle. En dessous, il y a trois éléments, et savoir ce que fait chacun explique l'essentiel de ce que vous verrez.

L'application navigateur

La page que vous avez ouverte : le rail de navigation, la carte, les formulaires, le catalogue, les graphiques et l'aperçu du rapport. Elle porte votre projet de travail, votre historique d'annulation et vos modifications, et c'est là qu'aboutit chaque geste. Tout ce manuel tourne autour d'elle. Elle n'exige ni plug-in ni extension : n'importe quel navigateur actuel convient.

Le moteur de simulation

Un programme distinct, sans interface, qui détient la physique et l'argent. Le navigateur lui envoie le projet entier et lui demande de le vérifier, de placer les modules, de générer le schéma ou d'exécuter une simulation complète ; il renvoie des chiffres, des images et des documents. Rien n'est calculé deux fois : ce que vous voyez sur un graphique ou dans un PDF vient de ce moteur. Le moteur s'exécute sur le service de calcul cloud de pvSpline (voir Où s'exécute le moteur de simulation).

La visionneuse Terre 3D « Earth »

Un moteur de rendu Unreal Engine 5 haute fidélité qui reconstruit votre site en 3D photoréaliste à partir du terrain, des bâtiments et de l'imagerie de l'IGN (France métropolitaine). Sur le web, il est diffusé : le rendu s'exécute sur un hôte graphique cloud et son image arrive dans la page sous forme de vidéo en direct ; votre propre machine n'a donc besoin d'aucun matériel particulier. Vous démarrez une session avec Démarrer la session sur Vue 3D, vous la pilotez comme n'importe quelle autre vue et vous la terminez avec Terminer la session. Elle exige un compte cloud connecté et puise dans le quota mensuel distinct de streaming 3D de votre formule, décompté en secondes dès la première image : la session, ses captures et ses vidéos sont toutes prélevées sur ce seul quota, sans frais séparés par rendu ou par export. Comme ces secondes s'écoulent tant qu'une session est ouverte, un petit panneau reste à l'écran avec le compteur et le bouton Terminer la session dès que vous quittez l'onglet 3D. Voir La vue Terre 3D du site pour la configurer et l'utiliser.

Où s'exécute le moteur de simulation

Le service de calcul cloud

Les calculs sont mis en file sur le service de calcul de pvSpline et décomptés de votre propre quota mensuel. Rien à installer ; vos projets, vos calculs et vos résultats vous suivent sur toute machine depuis laquelle vous vous connectez.

Ce que cela signifie pour vous :

Vitesse

Les calculs cloud sont mis en file : l'onglet Résultats vous dit honnêtement où en est la tâche. Avec l'offre gratuite, les calculs des clients payants passent d'abord (Le travail des clients payants passe d'abord).

Quota

Le calcul cloud est décompté en secondes-moteur sur un quota mensuel, avec le compteur sur la page Compte : avec un abonnement, chaque membre de la société a le sien, et avec l'offre gratuite toute la société en partage un seul, quel que soit son nombre de membres. Lorsque le quota est épuisé, un calcul est refusé au lieu d'être mis en file, et le message le dit. Un calcul, un balayage par lots ou un dimensionnement automatique qui échoue est décompté du temps moteur qu'il a consommé avant d'échouer, comme un calcul qui aboutit ; seul le temps passé en file est gratuit. Le streaming 3D, les constructions de tuiles et l'API cloud ont leurs propres quotas mensuels, eux aussi décomptés en secondes, et les imports de fichiers un quota en mégaoctets, propres à chaque membre ou partagés de la même façon. Avec l'offre gratuite, ces quotas restent petits tant que votre compte n'est pas vérifié. Voir Votre compte, votre équipe & vos calculs cloud.

Plafonds de taille de fichier

Chaque sélecteur de fichier contrôle la taille avant de lire quoi que ce soit et refuse d'emblée un fichier trop gros, en nommant le fichier et les deux valeurs. Le plafond est d'environ 25 Mo par fichier. Les fichiers qui ne quittent jamais le navigateur (un projet, un CSV de lot, un thème) ont une limite bien plus élevée, liée à la sécurité du navigateur.

Recalcul automatique

C'est vous qui lancez chaque calcul, car chaque calcul coûte du budget.

Où sont stockés les projets

Les projets sont enregistrés sur votre compte avec un historique des versions ; un compte Utilisateur voit les siens, un compte Direction tous les projets de la société. Vous pouvez aussi exporter n'importe quel projet dans un fichier portable et l'importer à nouveau.

Le rail de navigation et ses vues

La navigation se fait par un rail d'icônes vertical sur le bord gauche de la fenêtre. Chaque entrée est une icône sans libellé texte, pour garder le rail compact ; survolez-en une pour voir son nom en infobulle. Les vues du projet sont rangées dans l'ordre du flux de travail, depuis le haut ; Catalogue, qui relève de l'application et non du projet ouvert, se tient à part au pied du rail, sous un trait fin. Cliquer sur une entrée remplace toute la zone de travail à droite et change aussi l'URL, si bien que le bouton retour du navigateur, un rechargement et un favori se comportent tous comme vous l'attendez.

Projet

(symbole en graphe ramifié, /project) Votre bibliothèque de projets et, une fois un projet ouvert, ses cartes identité, dimensionnement, tarifs, financement, carbone, stockage et systèmes spécialisés. Sans projet ouvert, les tutoriels guidés se trouvent sous la bibliothèque. (L'onglet Projet, Stockage, VE & systèmes spécialisés, Tutoriels guidés & prise en main)

Consommation

(symbole en éclair, /consumption) La charge que le système doit couvrir : courbes Enedis importées, factures téléversées, profils synthétiques, et un onglet par source supplémentaire, dont la recharge de véhicules électriques. (L'onglet Consommation)

Carte

(symbole en carte pliée, /map) La carte aérienne où vous dessinez le champ, remplissez automatiquement les modules et peignez les chaînes. (L'onglet Carte & conception du site)

Lots

(symbole en coche à traînées, /batch) Études de paramètres, matrices et dimensionnement automatique sur le projet chargé. (Simulation par lots & balayages de scénarios)

Production

(symbole en panneau et soleil, /production) Le calcul de référence : lisez son productible, la cascade de pertes, les plannings, la courbe probabiliste et la validation mesuré/simulé. (Lancer une simulation & l'onglet Production)

Schéma

(symbole en grille croisée, /diagram) Le schéma unifilaire généré automatiquement et l'inspecteur de câblage, de dimensionnement et de conformité. (Conception électrique & schéma unifilaire)

Vue 3D

(symbole « 3D », /earth) La vue Terre photoréaliste diffusée de votre site. (La vue Terre 3D du site)

Vidéo

(symbole en triangle de lecture, /video) Lit les clips de course du soleil enregistrés depuis la vue 3D. Son infobulle indique « Vidéo : regardez les clips réalisés dans la vue 3D, qui montrent la course du soleil et le déplacement des ombres sur le site ». (La vue Terre 3D du site)

Résultats

(symbole en histogramme, /results) Les graphiques et le rapport : la liste de graphiques à côté du rapport PDF, avec son aperçu, son sélecteur de thème, l'export et l'impression. (Graphiques, cartes de chaleur & tableaux, Rapports & export)

Catalogue

(symbole en presse-papiers, /catalogue) La bibliothèque de composants avec ses dix catégories et les importateurs .PAN / .OND / .BTR. Les favoris que vous y définissez alimentent toutes les autres vues. (Le catalogue de composants)

Les tutoriels guidés n'ont pas d'entrée propre dans le rail : ce sont des cartes de l'onglet Projet, sous la bibliothèque de projets, et l'ancienne adresse /tutorials y aboutit. Commencez par là lors de votre première visite (Tutoriels guidés & prise en main).

Sous Catalogue, le pied du rail porte trois contrôles de plus : un avatar de compte circulaire affichant vos initiales (un ? lorsque vous êtes déconnecté), qui ouvre la page Compte à /account, avec votre équipe et ses postes, votre utilisation et vos calculs cloud, votre formule et sa facturation, la sécurité de votre connexion et vos préférences (apparence, langue et fichier de préférences, Votre compte, votre équipe & vos calculs cloud, Préférences, tarifs & thèmes) ; un lien ? qui ouvre ce manuel au chapitre de la vue affichée ; et un lien § mentions légales vers /legal, où le contrat de licence, le mandat Enedis, les mentions relatives aux tiers, la déclaration d'accessibilité, l'accord de traitement des données, les conditions générales de vente, les avertissements simulation et financier et les mentions légales restent consultables, connecté ou non, une fois le contrat de licence accepté dans ce navigateur. Pour la direction, un nombre sur l'avatar compte les postes à court d'un quota et les personnes qui attendent un poste ; survolez-le pour le détail (La section Équipe et postes).

Quand les entrées se déverrouillent

Sans projet ouvert, seules deux entrées sont actives : Projet et Catalogue, à côté de l'avatar de compte et des liens ? et § au pied du rail. Toutes les autres entrées sont grisées et ne répondent pas au clic, car chacune modifie ou restitue le projet chargé. Ouvrez ou créez un projet sur Projet et tout le rail s'allume.

Deux règles supplémentaires méritent d'être connues :

• Pendant qu'un tutoriel guidé est en cours, le rail est entièrement déverrouillé pour que la visite puisse vous y promener.

• Si votre déploiement impose la connexion, toutes les entrées du rail, sans exception, restent grisées tant que vous n'avez pas de session. L'avatar de compte, au pied du rail, est votre porte d'entrée.

Ce que le rail vous dit pendant que vous travaillez

Le rail n'est pas seulement une navigation ; c'est aussi un afficheur d'état.

Un symbole coloré

Une entrée dont l'écran présente un problème change de teinte : orange pour un avertissement, rouge pour une erreur. Survolez-la et l'infobulle liste chaque problème sous le nom de l'entrée, une ligne par problème avec le champ et le message. Corrigez-les et la couleur disparaît. Résultats n'a qu'une vérification, Calcul : Le calcul n’a pas été effectué : l'entrée reste rouge tant que le projet ouvert n'a pas eu de calcul réussi dans ce navigateur, et redevient rouge quand vous ouvrez ou créez un projet qui n'en a aucun. Rien n'est vérifié tant qu'aucun projet n'est chargé ou qu'un tutoriel est en cours.

Un faisceau en mouvement

Un symbole que la lumière balaie ou traverse de bas en haut signale un travail en cours pour cet écran : un téléchargement Enedis anime Consommation, une récupération météo anime Carte, et une simulation anime Résultats.

L'entrée sélectionnée

reste en surbrillance pour chaque adresse qui lui appartient : Résultats demeure donc allumé que vous soyez sur /results, sur un calcul précis ou sur un calcul cloud.

Comment ce manuel correspond au flux de travail

Le manuel suit le même arc de haut en bas que le rail, vous pouvez donc le lire d'un bout à l'autre en construisant votre premier projet, ou sauter à la vue où vous êtes :

• Prise en main : ouvrir l'application, se connecter, la fenêtre, et créer votre premier projet.

• L'onglet Projet à Rapports & export : un chapitre par vue majeure, dans l'ordre du flux de travail (projet, consommation, carte, catalogue, électrique, stockage, production, la vue Terre, graphiques et rapports).

• Simulation par lots & balayages de scénarios et Automatiser les calculs cloud : l'automatisation, à savoir les études de scénarios par lots dans l'interface, et l'API HTTP pour les calculs sans interface.

• Préférences, tarifs & thèmes : les réglages applicables à toute l'application.

• Tutoriels guidés & prise en main : les visites guidées intégrées.

• Votre compte, votre équipe & vos calculs cloud : votre compte, l'équipe et les postes de votre société, les formules et le quota, et l'historique des calculs cloud.

• Assistants IA : connecter un assistant IA à votre compte, ce qu'il sait faire, l'entrée à ajouter pour chaque client et ce sur quoi son travail est décompté.

• Physique de simulation & référence des données et Référence : glossaire, formats de fichiers & dépannage : le matériel de référence, à savoir la physique et les modèles de pertes, les unités, les raccourcis clavier et le glossaire.

Un mot sur PVsyst

Si vous venez de PVsyst, deux choses vous seront familières d'emblée. pvSpline lit directement vos fichiers de composants PVsyst existants (modules .PAN, onduleurs .OND et batteries .BTR) ; vous gardez donc vos composants sans ressaisie (un import nécessite le rôle Direction ou Admin ; voir Le catalogue de composants). Et vous reconnaîtrez le vocabulaire des résultats : une cascade de pertes, de l'irradiance dans le plan des modules jusqu'à l'énergie au compteur, et des productibles de dépassement P50/P90 (Lancer une simulation & l'onglet Production).

Référence des champs

Le chapitre Introduction n'a pas de champs de saisie propres : c'est votre carte de l'application. Ce qui suit est le tableau d'orientation : chaque entrée du rail de navigation, son adresse, ce que vous y faites et où elle est documentée.

Le rail de navigation

Les entrées sont listées dans l'ordre d'affichage. Les noms du rail sont les infobulles que vous voyez au survol, puisque le rail est uniquement iconographique. « Déverrouillé » indique si l'entrée fonctionne avant l'ouverture d'un projet.

Les adresses qui ne sont pas des entrées du rail

Quelques écrans utiles s'atteignent depuis l'intérieur d'une vue plutôt que depuis le rail. Ce sont des adresses ordinaires : vous pouvez les mettre en favori et les partager.