.. _drive-structure:

How the drive is structured for data from and for test days
===========================================================

All big data from and for test days is saved into the ``Autonomous System`` drive of the CURE google drive.
Every season has its on testing directory where the data of the respective test days of this season are saved to.
For every test day there is a directory within the respective testing directory, called according to the date of the test day (YYYY-MM-DD).

For the newer test days there exist multiple directories in every test day directory:

1. Recorded Rosbag

   This directory contain all rosbag which have been recorded during the test day, during basic tests, real test runs or for calibration

   There are additional subdirectories for organizing the recorded rosbags further.  It makes sense to have a subdirectory for the calibration,
   one for the basic tests and multiple for all recorded test runs. It make sense to orientate at the test sheets of the :ref:`metadata-website` of the respective test day.

2. Drone footage
   
   This directory contain all videos and images recorded via drone during the test days.

   There are additional subdirectories which correspend to those of the recorded rosbags.

3. Processed rosbags
   
   This directory contain all rosbags which have been processed and are based on the recorded rosbags. For example migrated rosbags.

   There are additional subdirectories which correspend to those of the recorded rosbags.

4. Visualizations
   
   This directory contain any visualizations of the test day. For example rosbags contianing visualizations or system output visualized onto drone footage.

   There are additional subdirectories which correspend to those of the recorded rosbags.

.. code::

    season xy
    | - testing
    | --- YYYY-MM-DD
    |     -> containing all data for the test day of this date
    | ----- recorded rosbags
    | ------- test sheets, e.g. acceleration
    | ------- calibration
    |         -> subdirectory containing rosbags for camera calibration
    | ------- test sheets, e.g. acceleration
    |         -> subdirectory to organize all rosbags regarding a test sheet from the metadata website or something similiar
    | ----- processed rosbags
    | ------- test sheets, e.g. acceleration
    | ----- drone footage
    | ------- calibration
    |         -> subdirectory containing drone footage for camera calibration
    | ------- test sheets, e.g. acceleration
    | ----- visualizations
    | ------- test sheets, e.g. acceleration
    | ----- tbd
            -> various possible additional directories like for phone recordings.

How do I find the correct test day directory for a given test run?
------------------------------------------------------------------

Visit the :ref:`metadata-website` and search for the given test run and check on which date the test run has been executed on.
You will find the test day directory with the correspending date in the testing directory in the directory of the according season.