The canonical location of this page is https://strawlab.org/schemas/flydra/1.0.

flydra v1.0 schema

Description

This is an HDF5 file for saving tracked 3D point data.

Two datasets are in this file:

• /trajectories - estimated 3D point trajectories
• /trajectory_start_times - the first timestamp for each tracked object

trajectories

The HDF5 description is:

  DATATYPE  H5T_COMPOUND {

     H5T_STD_U32LE "obj_id";

     H5T_STD_I64LE "framenumber";

     H5T_IEEE_F64LE "x";

     H5T_IEEE_F64LE "y";

     H5T_IEEE_F64LE "z";

  }

The columns are:

• obj_id (uint32) - an arbitrary identifier unique for each trajectory
• framenumber (int64) - the frame for which the estimate is made
• x (float64) and
• y (float64) and
• z (float64) - the (Kalman smoothed) estimated 3D positions.

trajectory_start_times

The HDF5 description is:

  DATATYPE  H5T_COMPOUND {

     H5T_STD_U32LE "obj_id";

     H5T_STD_U64LE "first_timestamp_secs";

     H5T_STD_U64LE "first_timestamp_nsecs";

  }

The columns are:

• obj_id (uint32) - an arbitrary identifier unique for each trajectory
• first_timestamp_secs (uint64) and
• first_timestamp_nsecs (uint64) - the time at which the trajectory started, in seconds and nanoseconds since 1 January 1970. Stored in UTC.

Note about user block in .h5 format

The first bytes of the file are an HDF5 user block that describe the schema of the file. (In other words, it's a descriptor that points to this page.) By putting the first bytes in this file, the freedesktop.org file identification machinery can automatically identify this file.