Chaque vol que vous enregistrez est sauvegardé sous forme de fichier CSV, un tableau en texte brut que vous pouvez ouvrir dans n'importe quel programme de feuille de calcul ou lire avec votre propre code. Cette page décrit ce format en détail. Elle couvre une carte Révision 4 ou ultérieure, qui enregistre l'ensemble complet des données de mouvement ; une carte Révision 3 ou antérieure utilise la même disposition sans les colonnes de mouvement, et il y a une note sur les différences à la fin.
Le fichier entier, l'en-tête et chaque lecture, est le résultat nettoyé de True Path, et il est signé pour pouvoir être vérifié contre la falsification. Il y a plus d'informations à ce sujet sur la page True Path et apogée et sur la page de sécurité.
iCONSEIL
Le moyen le plus facile de consulter un vol est de télécharger le fichier directement sur Altimeter Cloud. Vous n'avez pas besoin de comprendre vous-même le CSV brut : le site web présente votre vol dans des graphiques et des chiffres clairs et faciles à lire. Cette page s'adresse vraiment à ceux qui veulent travailler directement avec les données brutes. Il y a une explication complète sur la page Altimeter Cloud.
Le fichier comporte trois parties, dans cet ordre :
Tout d'abord vient un en-tête de quatorze lignes contenant un résumé du vol et les conditions exactes et les paramètres sous lesquels il a été enregistré. Puis une seule ligne vide. Puis une ligne de noms de colonnes, suivie des données de vol elle-même, une ligne par échantillon enregistré. En d'autres termes, l'en-tête occupe seize lignes, et les lectures commencent à la ligne dix-sept.
L'en-tête est organisé sous forme de paires d'étiquettes et de valeurs côte à côte dans les colonnes, de sorte qu'il se lit proprement lorsqu'il est ouvert dans une feuille de calcul : une paire à gauche, une paire au milieu, et sur Rev4 et ultérieur une autre paire à droite contenant les chiffres liés au mouvement. Si vous écrivez un analyseur, l'approche la plus simple est de lire les lignes d'en-tête pour les champs que vous voulez, ignorer la ligne vide, et traiter tout ce qui suit les noms de colonnes comme le tableau de données.
L'en-tête contient tout ce dont vous avez besoin pour comprendre le vol sans lire une seule ligne de données. Les champs se divisent en plusieurs groupes.
Le résumé du vol donne l'apogée en mètres et l'heure à laquelle il s'est produit, la hauteur d'atterrissage et l'heure, la vitesse ascendante maximale, la vitesse d'atterrissage, et la moyenne d'échantillons par seconde. Les champs d'identification sont votre balise d'appareil, votre balise de concurrent, et le numéro de série de l'altimètre, qui sont les détails que vous utilisez pour ajouter un vol à votre compte sur altimetercloud.com.
Les conditions et paramètres couvrent la pression au niveau de la mer et la température statique utilisées pour calculer la hauteur, si la température du capteur a été utilisée, la température de la carte au début et à la fin du vol, la tension de la batterie au début et à la fin, la version du micrologiciel, la révision de la carte, et un certain nombre de paramètres individuels tels que l'orientation, la protection au lancement, le mode hybride, la vitesse d'échantillonnage et l'arrêt de l'enregistrement. Il y a aussi un seul champ Chaîne de paramètres qui compacte la configuration complète utilisée pour le vol en une seule ligne, et un champ Journal ajusté qui lit « non » pour un vol original et vous indique si le journal a depuis été redérivé avec une pression ou une température différente.
Parce que la Chaîne de paramètres est écrite en sténographie, voici ce que chaque clé contient. Les clés configurables correspondent aux options décrites sur la page des paramètres.
| Clé | Contient |
|---|---|
| fp | Pression au niveau de la mer utilisée pour calculer la hauteur (hPa) |
| ft | Température statique utilisée (°C) |
| ut | Si la température du capteur a été utilisée (0 ou 1) |
| ss | Vitesse d'échantillonnage (Hz) |
| sr | Ratio d'échantillonnage |
| ms | Échantillons maximaux |
| ld | Seuil de détection du lancement (m) |
| lp | Protection au lancement (mG) |
| sl | Verrou de démarrage |
| rs | Arrêt de l'enregistrement |
| mp | Maintenir l'alimentation |
| hm | Mode hybride |
| or | Orientation |
| se | Synchronisation activée (Rev4 et ultérieur) |
| os, ii, kf | Paramètres internes de gestion de la pression (sur-échantillonnage et paramètres de filtre) |
| rcp | La référence de sol capturée au lancement |
| rmi | Heure de lancement, en millisecondes |
| cgx, cgy, cgz | Décalages de calibrage du gyroscope stockés (Rev4 et ultérieur) |
| cax, cay, caz | Décalages de calibrage de l'accéléromètre stockés (Rev4 et ultérieur) |
Enfin, le hachage de vérification est la signature HMAC-SHA256 qui permet à Altimeter Cloud de confirmer que le fichier n'a pas été modifié. Sur Rev4 et ultérieur, le côté droit de l'en-tête ajoute un ensemble de statistiques de mouvement : heures de burnout et d'éjection, vitesses de burnout et de descente, accélérations maximales et moyennes pendant l'ascension, la descente et la combustion, le tangage, le roulis, la lacet et l'inclinaison au lancement, l'axe dominant, et les détails de synchronisation.
!IMPORTANT
Ne modifiez pas un journal de vol si vous voulez le garder valide. La signature de vérification est calculée à partir du contenu exact du fichier, donc changer quoi que ce soit, même un seul nombre ou un espace ajouté, signifie qu'elle ne correspond plus. Altimeter Cloud n'accepte que les journaux originaux et non modifiés, donc un fichier modifié ne pourra pas être vérifié et ne pourra pas être téléchargé. Si vous voulez travailler avec les données, copiez d'abord le fichier et modifiez la copie, et gardez l'original en sécurité.
Après la ligne vide et la ligne de noms de colonnes, chaque ligne est un échantillon enregistré. Les colonnes apparaissent dans cet ordre :
| Colonne | Unités | Format | Ce que c'est |
|---|---|---|---|
| Time(ms) | ms | nombres entiers | Temps depuis le lancement, avec le lancement à zéro |
| Altitude(m) | m | 3 décimales | Hauteur au-dessus du point de lancement |
| Velocity(m/s) | m/s | 2 décimales | Vitesse verticale, calculée à partir de la trace d'altitude |
| acceleration_x(mG) | mG | nombres entiers | Accélération selon l'axe X de la carte |
| acceleration_y(mG) | mG | nombres entiers | Accélération selon l'axe Y |
| acceleration_z(mG) | mG | nombres entiers | Accélération selon l'axe Z |
| acceleration_total(mG) | mG | 1 décimale | Magnitude d'accélération globale avec le 1 G de gravité soustrait, de sorte qu'elle reste proche de zéro au repos |
| gyro_x | °/s | nombres entiers | Taux de rotation autour de l'axe X |
| gyro_y | °/s | nombres entiers | Taux de rotation autour de l'axe Y |
| gyro_z | °/s | nombres entiers | Taux de rotation autour de l'axe Z |
| Board temp(C) | °C | 2 décimales | Température du capteur, écrite environ une fois par seconde et laissée vide sur les lignes intermédiaires |
| pitch | degrés | 2 décimales | Angle d'orientation du filtre de fusion |
| roll | degrés | 2 décimales | Angle d'orientation du filtre de fusion |
| yaw | degrés | 2 décimales | Angle d'orientation du filtre de fusion |
| tilt | degrés | 2 décimales | Angle par rapport à la verticale |
Quelques points méritent d'être connus. Le temps est mesuré à partir du lancement, donc le lancement est zéro ; parce que le Nano maintient un court tampon d'échantillons juste avant le décollage, les premières lignes peuvent montrer de petits temps négatifs. Les axes d'accélération et de gyroscope sont les axes propres de la carte, qui s'alignent avec la fusée selon votre paramètre d'orientation. Il y a une ligne par échantillon jusqu'au maximum que vous avez défini, donc un journal complet peut avoir des dizaines de milliers de lignes.
Un court exemple utilisant des données de vol réel, montrant les noms de colonnes et quelques lignes du moment du lancement :
Time(ms),Altitude(m),Velocity(m/s),acceleration_x(mG),acceleration_y(mG),acceleration_z(mG),acceleration_total(mG),gyro_x,gyro_y,gyro_z,Board temp(C),pitch,roll,yaw,tilt -10,0.085,4.54,-993,35,76,-3.5,376,-12,-68,,3.40,-26.21,38.18,26.41, 0,0.141,5.76,-994,37,74,-2.6,330,-22,-74,,1.63,-26.97,35.28,27.02, 10,0.224,7.07,-992,36,75,-4.5,299,-28,-71,,-0.06,-27.61,32.71,27.61, 20,0.334,8.44,-1376,99,120,384.8,256,-29,-68,,-1.59,-28.15,30.55,28.19,
Vous pouvez voir les cellules de température vides, le petit temps négatif juste avant le lancement, et que chaque ligne de données se termine par une virgule finale, de sorte qu'un analyseur strict verra un champ vide à la fin de chaque ligne de données.
Les cartes sans capteur de mouvement utilisent le même fichier dans la même forme, juste plus simple. Les colonnes de mouvement, c'est-à-dire les trois colonnes d'accélération, l'accélération totale, les trois colonnes de gyroscope et le tangage, le roulis, la lacet et l'inclinaison, sont tous absents, et l'en-tête ne porte pas les statistiques de mouvement sur son côté droit.
Il y a un ajout plutôt qu'une suppression : ces cartes incluent une colonne Pressure(hPa), écrite avec six décimales, juste après Altitude. Donc un journal Révision 3 ou antérieur n'a que cinq colonnes, dans cet ordre : Time(ms), Altitude(m), Pressure(hPa), Velocity(m/s) et Board temp(C). Tout le reste de cette page, les groupes d'en-tête, le temps étant mesuré à partir du lancement et la température étant écrite environ une fois par seconde, s'applique de la même manière.