CSV-vluchtlogformaat

Elke vlucht die u opslaat, wordt geschreven als een CSV-bestand, een platte teksttabel die u in elk spreadsheetprogramma kunt openen of met uw eigen code kunt lezen. Deze pagina beschrijft dat formaat in detail. Het gaat om een Revision 4 of later bord, dat de volledige set bewegingsgegevens opneemt; een Revision 3 of eerder bord gebruikt dezelfde indeling met de bewegingskolommen weggelaten, en daar is een opmerking over de verschillen aan het eind.

Het hele bestand, de koptekst en elke meting, is het gereinigde True Path-resultaat, en het is ondertekend zodat het kan worden gecontroleerd op manipulatie. Er is meer informatie hierover op de True Path en apogee-pagina en de beveiligingspagina.

Het bestand bestaat uit drie delen, in deze volgorde:

Eerst komt een koptekst van veertien rijen met een samenvatting van de vlucht en de exacte omstandigheden en instellingen waaronder deze werd opgenomen. Vervolgens een enkele lege rij. Daarna één rij met kolomnamen, gevolgd door de vluchtgegevens zelf, één rij per opgenomen monster. Met andere woorden, de koptekst neemt zestien rijen in beslag en de aflezingen beginnen op rij zeventien.

De koptekst is ingedeeld als label- en waardepaarsgewijze naast elkaar in kolommen, zodat het netjes leest wanneer geopend in een spreadsheet: een paar aan de linkerkant, een paar in het midden, en op Rev4 en later een verder paar aan de rechterkant met de bewegingsgerelateerde cijfers. Als u een parser schrijft, is de eenvoudigste benadering het lezen van de koptekstrijen voor de velden die u wilt, het overslaan van de lege rij en het behandelen van alles vanaf de kolomnamen als de gegevenstabel.

De koptekst bevat alles wat u nodig hebt om de vlucht te begrijpen zonder een enkel gegevensrij te lezen. De velden vallen in een paar groepen.

De vluchtoverzicht geeft de apogee in meters en het moment waarop deze plaatsvond, de landingshoogte en het moment, de maximale opwaartse snelheid, de landingssnelheid en het gemiddelde aantal monsters per seconde. De identificatievelden zijn uw apparaattag, uw concurrentententag en het serienummer van de altimeter, dit zijn de gegevens die u gebruikt om een vlucht aan uw account op altimetercloud.com toe te voegen.

De omstandigheden en instellingen omvatten de druk op zeeniveau en de statische temperatuur die wordt gebruikt om de hoogte te bepalen, of sensortemperatuur werd gebruikt, de bordtemperatuur aan het begin en eind van de vlucht, de batterijspanning aan het begin en eind, de firmwareversie, de bordrevise en een aantal individuele instellingen zoals oriëntatie, lanceerbescherming, hybride modus, bemonsteringssnelheid en opnamestopping. Er is ook een enkel Instellingstekenreeksveld dat de volledige configuratie die voor de vlucht wordt gebruikt in één regel verpakt, en een Aangepast logboek-veld dat "nee" aangeeft voor een originele vlucht en u vertelt of het logboek sindsdien opnieuw is afgeleid met andere druk of temperatuur.

Omdat de instellingstekenreeks in afkorting wordt geschreven, hier is wat elke sleutel bevat. De configureerbare sleutels komen overeen met de opties die op de instellingenpagina worden beschreven.

Tot slot is de verificatiehash de HMAC-SHA256-handtekening waarmee Altimeter Cloud kan bevestigen dat het bestand niet is gewijzigd. Op Rev4 en later voegt de rechterkant van de koptekst een set bewegingsstatistieken toe: brandstofdoorbranding en uitwerpingstijden, brandstofdoorbranding en afdalingssnelheden, de maximale en gemiddelde versnellingen tijdens stijging, afdaling en de brand, de lanceerhoek, rol, gier en helling, de dominante as, en tijdingdetails.

Na de lege rij en de rij met kolomnamen, is elke rij één opgenomen monster. De kolommen verschijnen in deze volgorde:

Een paar dingen zijn het waard om te weten. Tijd wordt gemeten vanaf lancering, dus lancering is nul; omdat de Nano een korte buffer van monsters van vlak voor het opstijgen bewaart, kunnen de eerste rijen kleine negatieve tijden tonen. De versnellings- en gyro-assen zijn de eigen assen van het bord, die zijn uitgelijnd met de raket volgens uw oriëntatie-instelling. Er is één rij per monster tot het maximum dat u hebt ingesteld, dus een volledig logboek kan tienduizenden rijen zijn.

Een kort voorbeeld met echte vluchtgegevens, met de kolomnamen en enkele rijen van rond het moment van lancering:

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,

U kunt de lege temperatuurcellen zien, de kleine negatieve tijd vlak voor lancering, en dat elke gegevensrij eindigt met een spoor komma, dus een strikte parser ziet één leeg veld aan het eind van elke gegevensrij.

Borden zonder de bewegingssensor gebruiken hetzelfde bestand in dezelfde vorm, gewoon eenvoudiger. De bewegingskolommen, dat wil zeggen de drie versnellingskolommen, de totale versnelling, de drie gyro-kolommen en de pitch, roll, yaw en tilt, zijn allemaal afwezig, en de koptekst bevat niet de bewegingsstatistieken aan de rechterkant.

Er is één toevoeging in plaats van een verwijdering: deze borden hebben een Pressure(hPa)-kolom, geschreven naar zes decimalen, direct na Altitude. Dus een Revision 3 of eerder logboek heeft slechts vijf kolommen, in deze volgorde: Time(ms), Altitude(m), Pressure(hPa), Velocity(m/s) en Board temp(C). Alles anders op deze pagina, de kopgroepen, de tijd gemeten vanaf lancering en de temperatuur ongeveer eenmaal per seconde geschreven, is op dezelfde manier van toepassing.