Formato de registro de vuelo CSV

Cada vuelo que guardas se escribe como un archivo CSV, una tabla de texto plano que puedes abrir en cualquier programa de hojas de cálculo o leer con tu propio código. Esta página describe ese formato en detalle. Cubre una placa de Revisión 4 o posterior, que registra el conjunto completo de datos de movimiento; una placa de Revisión 3 o anterior utiliza el mismo diseño con las columnas de movimiento omitidas, y hay una nota sobre las diferencias al final.

El archivo completo, el encabezado y cada lectura, es el resultado limpio de True Path, y está firmado para que pueda verificarse si hay manipulaciones. Hay más información sobre True Path y la página de apogeo y la página de seguridad.

El archivo tiene tres partes, en este orden:

Primero viene un encabezado de catorce filas con un resumen del vuelo y las condiciones exactas y configuración bajo la cual se registró. Luego una sola fila en blanco. Luego una fila de nombres de columna, seguida de los datos del vuelo, una fila por muestra registrada. En otras palabras, el encabezado ocupa dieciséis filas, y las lecturas comienzan en la fila diecisiete.

El encabezado se organiza como pares de etiqueta y valor uno al lado del otro en columnas, para que se lea de manera ordenada cuando se abre en una hoja de cálculo: un par a la izquierda, un par en el medio, y en Rev4 y posterior un par adicional a la derecha que contiene las cifras relacionadas con el movimiento. Si estás escribiendo un analizador, el enfoque más simple es leer las filas de encabezado para los campos que deseas, saltar la fila en blanco y tratar todo desde los nombres de columna en adelante como la tabla de datos.

El encabezado contiene todo lo que necesitas para entender el vuelo sin leer una sola fila de datos. Los campos se dividen en algunos grupos.

El resumen del vuelo da el apogeo en metros y el momento en que ocurrió, la altura de aterrizaje y el tiempo, la velocidad ascendente máxima, la velocidad de aterrizaje y el promedio de muestras por segundo. Los campos de identificación son tu etiqueta de dispositivo, tu etiqueta de competidor y el número de serie del altímetro, que son los detalles que utilizas para agregar un vuelo a tu cuenta en altimetercloud.com.

Las condiciones y configuración cubren la presión a nivel del mar y la temperatura estática utilizadas para calcular la altura, si se utilizó la temperatura del sensor, la temperatura de la placa al inicio y final del vuelo, el voltaje de la batería al inicio y final, la versión del firmware, la revisión de la placa y varios ajustes individuales como orientación, protección de lanzamiento, modo híbrido, velocidad de muestreo y parada de grabación. También hay un único campo de Cadena de configuración que empaqueta la configuración completa utilizada para el vuelo en una línea, y un campo de Registro ajustado que dice "no" para un vuelo original y te dice si el registro se ha vuelto a derivar con presión o temperatura diferentes.

Debido a que la Cadena de configuración se escribe en abreviado, aquí está lo que contiene cada clave. Los configurables coinciden con las opciones descritas en la página de configuración.

Finalmente, el hash de verificación es la firma HMAC-SHA256 que permite a Altimeter Cloud confirmar que el archivo no ha sido alterado. En Rev4 y posterior, el lado derecho del encabezado agrega un conjunto de estadísticas de movimiento: tiempos de burnout y eyección, velocidades de burnout y descenso, las aceleraciones máxima y promedio durante el ascenso, descenso y la quemadura, el lanzamiento de pitch, roll, yaw e inclinación, el eje dominante y detalles de tiempo.

Después de la fila en blanco y la fila de nombres de columna, cada fila es una muestra registrada. Las columnas aparecen en este orden:

Hay un par de cosas que vale la pena saber. El tiempo se mide desde el lanzamiento, así que el lanzamiento es cero; porque el Nano mantiene un búfer corto de muestras justo antes del despegue, las primeras filas pueden mostrar pequeños tiempos negativos. Los ejes de aceleración y giroscopio son los propios ejes de la placa, que se alinean con el cohete según tu configuración de orientación. Hay una fila por muestra hasta el máximo que configuraste, por lo que un registro completo puede ser decenas de miles de filas.

Un ejemplo breve usando datos de vuelo reales, mostrando los nombres de columna y algunas filas alrededor del momento del lanzamiento:

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,

Puedes ver las celdas de temperatura en blanco, el pequeño tiempo negativo justo antes del lanzamiento, y que cada fila de datos termina con una coma final, por lo que un analizador estricto verá un campo vacío al final de cada fila de datos.

Las placas sin el sensor de movimiento utilizan el mismo archivo en la misma forma, solo más simple. Las columnas de movimiento, es decir, las tres columnas de aceleración, la aceleración total, las tres columnas de giroscopio y el pitch, roll, yaw e inclinación, están todas ausentes, y el encabezado no lleva las estadísticas de movimiento en su lado derecho.

Hay una adición más bien que una eliminación: estas placas incluyen una columna Pressure(hPa), escrita a seis decimales, justo después de Altitude. Entonces un registro de Revisión 3 o anterior tiene solo cinco columnas, en este orden: Time(ms), Altitude(m), Pressure(hPa), Velocity(m/s) y Board temp(C). Todo lo demás en esta página, los grupos de encabezado, el tiempo que se mide desde el lanzamiento y la temperatura que se escribe aproximadamente una vez por segundo, se aplica de la misma manera.