Export de données — Questions fréquentes

Les questions que l'on se pose en exportant des données depuis Mirox. Pour le fonctionnement de l'export, voir Metric Export ; pour les paramètres des liens d'export, voir l'API Metric Export.

1. Puis-je exporter mes indicateurs sous forme de série temporelle ?

Oui. La page Export de données et les rapports lisent la même collection d'indicateurs, qui comprend les indicateurs que votre organisation a définis sous Indicateurs. Ouvrez Export de données, cliquez sur Ajouter des indicateurs et choisissez-les sous Mes indicateurs. Un indicateur peut être exporté de sa Résolution la plus fine jusqu'à l'année, mais jamais plus finement que 15 minutes. Un indicateur marqué Non validé ne peut pas être exporté tant que son expression n'est pas validée. Voir Exporter un indicateur.

2. Quelles données puis-je exporter ?

Chaque indicateur de la collection : les valeurs de centrale comme l'injection, l'irradiation, la disponibilité, les pertes et l'écrêtement, et les valeurs de chaque onduleur, boîte de jonction, string, éolienne, capteur, compteur ainsi que de chaque conteneur, rack, module, cellule et convertisseur de batterie, auxquelles s'ajoutent la météo, les prix de marché et les montants. Le sélecteur de l'onglet Métriques les liste par niveau, et Explications propose toute la liste sous forme de fichier de glossaire. Voir Indicateurs disponibles.

3. Puis-je exporter chaque capteur d'irradiance séparément ?

Oui. Ajoutez l'indicateur Éclairement par capteur ou Irradiation par capteur. Chaque capteur devient une colonne à part, sans moyenne. Le modèle système Capteurs d'irradiance exporte tous les capteurs à 15 minutes sur la journée d'hier. Voir Choisir des composants.

4. Pourquoi « par intervalle » n'est-il proposé que pour l'énergie ?

Par intervalle désigne la quantité dans chaque intervalle, et seule une grandeur comptée a une quantité. Une puissance, une température ou un ratio est un état à un instant : il est exporté Tel que mesuré, sous forme de moyenne ou de dernière valeur de l'intervalle. Les autres grandeurs comptées, comme les heures d'ensoleillement ou les précipitations, proposent Tel que mesuré et Cumul. Voir Valeurs.

5. Pourquoi un avertissement s'affiche-t-il à 1 ou 5 minutes ?

Un compteur compte l'énergie par paliers entiers, souvent 1 kWh. En une minute, une centrale produit rarement un palier entier : une énergie par intervalle à 1 ou 5 minutes saute donc entre zéro et un palier au lieu de dessiner une courbe. Pour une courbe, utilisez l'indicateur de puissance correspondant ; pour l'énergie, utilisez 15 minutes ou plus. Vous pouvez aussi conserver la sélection si ce sont les paliers du compteur que vous voulez voir. Voir L'avertissement en dessous de 15 minutes.

6. Pourquoi la puissance n'est-elle pas proposée par heure ou par jour ?

La puissance est proposée à 15 minutes ou plus fin. Une puissance moyenne sur une journée masque ce qui s'est passé pendant la journée et est rarement la valeur recherchée. Pour des valeurs horaires, journalières ou mensuelles, utilisez l'indicateur d'énergie, par exemple Injection réseau au lieu de Puissance d'injection réseau. Voir Les pas et leurs limites.

7. Pourquoi y a-t-il une colonne Décalage UTC ?

Les lignes suivent l'heure locale de la centrale. Le jour du passage à l'heure d'hiver, l'heure entre 2 et 3 heures se produit deux fois. La colonne Décalage UTC permet de les distinguer et permet à n'importe quel programme de convertir une ligne en UTC. Elle n'apparaît qu'aux pas inférieurs à un jour et peut être désactivée dans le lien avec offset_column=false. Voir Heure locale de la centrale et UTC.

8. Pourquoi mon export est-il en UTC alors que j'ai choisi l'heure locale de la centrale ?

Parce que les centrales choisies se trouvent dans des fuseaux horaires différents. Un fichier a une seule colonne de temps ; un tel export est donc toujours en UTC, et une remarque le signale. Exportez séparément les centrales de chaque fuseau horaire pour obtenir l'heure locale.

9. Pourquoi une cellule est-elle vide au lieu de contenir zéro ?

Une cellule vide signifie qu'il n'y a pas de valeur pour cet intervalle. Zéro signifie que la valeur a été mesurée et qu'elle est nulle. L'export par modèle précédent écrivait 0 dans les deux cas. Si un programme a besoin d'un nombre dans chaque cellule, ajoutez empty=zero au lien.

Oui. Chaque lien des exports précédents continue de fonctionner et de fournir les mêmes colonnes. Ils sont marqués comme anciens et n'ont aucune date de suppression. Les favoris de l'ancien onglet Données brutes ouvrent l'onglet Métriques avec la même sélection. Voir l'API de l'ancien export et le guide de migration.

11. Qu'est-ce qu'un modèle « Ancien » ?

Un modèle créé avant le Metric Export. Il repose sur l'ancien jeu d'indicateurs, et son lien continue de fonctionner sans changement. Convertir en nouveau modèle crée à partir de lui un nouveau modèle sur la collection d'indicateurs et laisse l'ancien modèle tel quel. Les nouveaux modèles reposent toujours sur la collection d'indicateurs. Voir Anciens modèles et conversion.

12. Pourquoi les chiffres diffèrent-ils légèrement de mon export précédent ?

Surtout parce qu'un jour est désormais le jour local de la centrale, alors que l'export précédent utilisait des jours UTC. L'énergie est en kWh partout, alors que l'export brut précédent utilisait des Wh. Certains indicateurs sont lus d'une meilleure façon qu'auparavant, par exemple l'état de charge de la batterie pondéré par la capacité des conteneurs. Le guide de migration marque ces indicateurs comme approchés et nomme la différence.

13. Pourquoi des colonnes de mon export précédent contiennent-elles des valeurs alors qu'elles étaient vides ?

Deux groupes de colonnes de l'export de données brutes précédent ont été corrigés : les colonnes de disponibilité (raw_availability_…) et les colonnes d'écrêtement éolien (raw_curtailment_…_nacelle, _windref et _windfixed). Elles étaient vides et contiennent désormais des valeurs. Dans une colonne de disponibilité, chaque ligne est la disponibilité sur une durée égale à celle de la période exportée, se terminant à cette ligne. Voir Corrections.

14. Pourquoi mon export est-il refusé comme trop volumineux ?

Un export est servi en une seule requête ; il est donc borné : 50 centrales, 20 indicateurs, 400 colonnes, 180 000 valeurs par colonne et 1,8 million de valeurs au total. Le message nomme un pas plus grossier ou une période plus courte qui convient. Pour obtenir davantage, scindez l'export par période, par centrale ou par indicateur. Les indicateurs que Mirox détermine à partir de plusieurs sources, comme la production résolue, coûtent plus qu'un simple relevé de compteur. Voir Quand un export est trop volumineux.

15. De quel jeton d'API ai-je besoin pour Excel ou un script ?

D'un jeton du groupe Metric Export. Il lit chaque lien d'export, y compris les précédents, et ne peut rien modifier. Le groupe s'appelait Reporting auparavant ; les jetons de ce groupe continuent de fonctionner. Dans Excel Power Query, le jeton se place dans l'en-tête Authorization, et la connexion est réglée sur Anonyme. Voir Excel avec Power Query.

16. Où est passé l'éditeur de formules ?

L'éditeur de formules MiroxQL a été retiré de l'application. Les formules existantes continuent d'être évaluées dans les anciens modèles, et les formules peuvent toujours être gérées via l'API. Pour une valeur que vous définissez vous-même, utilisez Indicateurs sur la page Rapports : un indicateur travaille sur les valeurs à 15 minutes, apparaît dans les rapports et peut être exporté. Voir Formules MiroxQL.

17. Quelle est la différence entre l'Export de données et l'Export complet des données d'un rapport ?

L'Export complet des données fournit les tableaux d'un rapport publié, exactement tels que le rapport les a figés. L'Export de données fournit n'importe quel indicateur sous forme de série temporelle, pour n'importe quelles centrales et n'importe quelle période, lu au moment où vous le demandez, et aussi sous forme de lien pour Excel ou un script. Les deux lisent la même collection d'indicateurs. Voir Téléchargements.

18. Qui peut exporter des données ?

Toute personne qui peut lire les mesures d'une centrale : les rôles de fonction Exploitant, Technical Manager, Asset Manager et Spectateur. Les montants exigent en plus l'accès à la comptabilité, dont disposent Exploitant et Asset Manager. Les modèles sont créés, modifiés et supprimés par le rôle d'organisation Admin ; tous les membres de l'organisation peuvent les utiliser. Voir Qui peut exporter quoi.

19. Puis-je exporter une requête MetricsQL brute ?

Oui. Dans l'onglet Métriques, MetricsQL, sous les indicateurs, ouvre un champ de requête : Entrée exécute la requête, Tab accepte ce que le champ propose. Mirox ajoute la centrale à chaque sélecteur, la requête ne nomme donc jamais une centrale ni une organisation. Chaque série renvoyée par la requête devient une colonne avec l'en-tête MetricsQL et la requête, et le lien la porte comme expr. Un export contient jusqu'à 5 requêtes avec au plus 500 séries par centrale ; les requêtes ne sont pas enregistrées dans les modèles. Voir Requêtes MetricsQL.

20. Pourquoi une colonne n'a-t-elle des valeurs que sur certaines lignes ?

Parce que l'indicateur a un pas plus grossier que le fichier, par exemple un ratio de performance journalier dans un fichier à 15 minutes. Sa valeur se trouve sur la première ligne de chacun de ses intervalles, les lignes intermédiaires restent vides et le graphique le dessine sous forme de points. La remarque orange au-dessus de l'aperçu nomme ces indicateurs et propose Exporter séparément, un lien par pas. Un lien écrit à la main obtient la même chose avec mismatch=sparse. Voir Indicateurs à pas différents.

21. Pourquoi le graphique affiche-t-il une résolution plus grossière que celle choisie ?

Une longue période à un pas fin a plus de points qu'un navigateur ne peut en dessiner. Le graphique affiche alors un pas plus grossier, ou regroupe plusieurs lignes en un point, et le dit dans une remarque orange. Seul le graphique change : le tableau, le téléchargement et le lien gardent le pas que vous avez choisi. Voir Vérifier l'aperçu et télécharger.