GoPro AutoSync ********************************************************** Examples ========================================================== For getting examples how video data can be used in 2D Analyzer click :doc:`here `! Description ========================================================== Automatically link a video to a measurement by calculating the video offset from the GPS time stamps of a 2D GPS module and the GPS time stamps of the GoPro\ **:sup:`®`** to extend the measurement data by an audiovisual component with frame by frame analysis! .. raw:: html .. .. important:: At the moment, the software is able to process *twelve* videos each from *four* cameras! If you want to use more cameras, please contact 2D Datarecording via our `website `__! .. .. figure:: /Images/GoProAutoSync/Theory.png :scale: 100% :align: center GoPro® AutoSync theory .. .. attention:: GPS-channels provided by GPS2CAN or serial GPS are required to use the *GoPro® AutoSync* feature! Ensure to record the GPS-channels, especially #SSHH, #HHMM and #MMDD With different license levels, videos from a different amount of GoPro®\ ’s can be synchronized to a measurement. With license level *TEAM* four GoPro®\ s with each 16 videos can be synchronized. .. admonition:: Addtional manual Detailed information about licenses can be at http://2d-datarecording.com/downloads/manuals/ Preparations ========================================================== Important instructions ---------------------------------------------------------- Since the alignment accuracy of the GoPro® video for the 2D measurement data depends to a large extent on the GPS reception of *all* devices, it is important to ensure that all devices involved have received very good GPS at least at the start of the measurement! .. attention:: Only if all preparation steps are carried out conscientiously, an alignment accuracy of far less than 1 second can be achieved! GoPro® ---------------------------------------------------------- GoPro®-Quik-software ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If the GoPro® Quik software is installed on your computer, please ensure that this software does not start automatically when a data carrier with GoPro® content is inserted. With a special setting, this software would automatically delete the content after importing. GoPro® Player ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The GoPro® Player is only required if GoPro® MAX 360° videos must be edited! Click `here `__ to download GoPro® Player. Hardware ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ In the following you will find a list that shows with which GoPro® the automatic synchronization works. Ensure that your camera is updated to the latest firmware! +---------------------+-----------+----+--------+ | Overview GoPro®`s | +=====================+===========+====+========+ | Hero\ :sup:`®` 5 | Session |YES | 2016 | + +-----------+----+--------+ | | Session | NO | 2016 | +---------------------+-----------+----+--------+ | Hero\ :sup:`®` 6 | Black |YES | 2017 | + +-----------+----+--------+ | | Fusion | NO | 2017 | + +-----------+----+--------+ | | HERO | NO | 2018 | +---------------------+-----------+----+--------+ | Hero\ :sup:`®` 7 | White | NO | 2018 | + +-----------+----+--------+ | | Silver |YES | 2018 | + +-----------+----+--------+ | | Black |YES | 2018 | +---------------------+-----------+----+--------+ | Hero\ :sup:`®` 8 | Black |YES | 2019 | +---------------------+-----------+----+--------+ | MAX\ :sup:`®` |YES | 2019 | +---------------------+-----------+----+--------+ | Hero\ :sup:`®` 9 | Black |YES | 2020 | +---------------------+-----------+----+--------+ | Hero\ :sup:`®` 10 | Black |YES | 2021 | +---------------------+-----------+----+--------+ .. attention:: Please familiarize yourself with the use of the GoPro®, especially with the video settings, as well as the activation of the GPS and display of a GPS connection of the camera. .. figure:: /Images/GoProAutoSync/GPS_Pin_Off.png :scale: 100% :align: center No GPS-connection of GoPro® .. .. figure:: /Images/GoProAutoSync/GPS_Pin_On.png :scale: 85% :align: center GPS-connection of GoPro® .. important:: With *GoPro® AutoSync* toolchain is also possible to process 360° of the GoPro® MAX! .. important:: HERO-mode videos from GoPro® MAX are processed normally. 2D-Datarecording modules ---------------------------------------------------------- | GoPro® videos can only be automatically synchronized to measurements that use a GPS module. | It does not matter whether a GPS2CAN receiver or a serial GPS receiver is used. .. attention:: Ensure to record the GPS-channels, especially #SSHH, #HHMM and #V\_Sat are important! .. attention:: When using a 2D GPS module, it is important that the module has received GPS reception for at least 13 minutes, at best 26 minutes, before a measurement, to receive the latest GPS-Almanac data and thus the alignment accuracy can be guaranteed. .. attention:: During this time, the measurement system must only be switched on, no active record is required. Computer ---------------------------------------------------------- VLC-Player ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ To play the videos via the Analyzer’s plugins, the VLC Player must be installed in its *32*-Bit-Windows version. Click `here `__ to download the VLC-Player! .. attention:: 32-Bit-Windows version must be used! .. attention:: Select “Windows” at dropdown menu for downloading 32-Bit-Windows version! .. attention:: Please ensure that VLC-Player is always updated to its latest version! HEVC-Codec ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Certain resolution and framerate combinations lead to a HEVC-coded video. For more information please see: Click `here `__ for additional information about HEVC-codec! .. attention:: Please ensure if your computer can display HEVC-coded videos! .. attention:: Follow the instructions of the GoPro® camera! How to automatically attach videos ========================================================== .. attention:: Do *not* import the measurement and the videos *at the same time*! Import one behind the other. The order you do that is not important! .. attention:: The videos must be on a data carrier called "2D-Stick" or on a stick of any name with a directory “DCIM”! .. attention:: Make sure only videos from the respective event are on your data carrier 1. Insert the USB stick with the measurement as usual with *WinARace* open with the correctly selected event and have the measurement automatically downloaded into the selected event. .. 2. If a data carrier with videos is connected to the PC and *WinARace* is open **or** if a data carrier with videos is already connected and *WinARace* is then started, the videos are automatically copied to the current event in the folder *Videos*. .. important:: Only videos that are not already in the *Videos* event folder are copied! .. important:: When copying, information about length, framerate, timestamps (SecondOfDay SOD) and camera are extracted automatically from the videos and stored in AvailableVideos.ini. This ini-file can be found inside the respective event folder inside the folder *Videos* (*\\Videos\\*) and can be opened with a text editor. The video files are also renamed in the *Video* event folder (*\\Videos\\*) according to the following schema: .. figure:: /Images/GoProAutoSync/RenamingFiles.png :scale: 100% :align: center Renaming files when copying from SD-card to computer .. 3. Open *WinARace* and select the measurement to which you want to attach the videos .. 4. Click following icon from Toolbar to open *VideoCMDLine.exe* .. figure:: /Images/GoProAutoSync/Toolbar_normal.png :scale: 100% :align: center *VideoCMDLine.exe* toolbar icon .. 5. By clicking on *Automatic* all GoPro® videos are automatically attached that correspond to the measurement. The offset is calculated automatically for the respective videos. .. figure:: /Images/GoProAutoSync/AutomaticButton.png :scale: 30% :align: center *VideoCMDLine.exe* *Automatic* button In the following figure you can see that all videos except Camera 2 video 2 (Video\_File\_Index\_2=2) would coincide in time with the measurement and therefore all but Camera 2 video 2 would be attached. .. figure:: /Images/GoProAutoSync/SelectedVideos.png :scale: 50% :align: center For synchronization loaded videos 6. By clicking on button *OK* all loaded videos are synchronized successfully to the measurement and video channels are created according to the following pattern: .. figure:: /Images/GoProAutoSync/Button_OK.png :scale: 70% :align: center Button *OK* .. important:: A video\_file\_index channel is created for each camera, showing which video of the camera is currently active .. important:: Only one video\_time channel is created for each camera. Channel Video\_Time\_3 contains the Video\_Times of all videos of camera 3 Attach videos to multiple measurements ---------------------------------------------------------- With the previous description videos can be synchronized to one, selected measurement only. Because often videos must be synchronized to multiple measurements since Race\ **2022** a new *WinARace* toolbar button was implemented. By clicking on following toolbar icon for all in *WinARace* **currently selected** measurements videos are synchronized. .. figure:: /Images/GoProAutoSync/Toolbar_Event.png :scale: 70% :align: center *VideoCMDLine.exe* toolbar EVENT SYNC icon .. .. figure:: /Images/GoProAutoSync/WinARace_SelectedMES.png :scale: 30% :align: center In WinARace currently selected measurements By clicking on following WinARace-icon multiple measurements can be selected via holding [CTRL]-key and selection measurements. .. figure:: /Images/GoProAutoSync/Button_MES.png :scale: 70% :align: center WinARace button for selecting multiple measurements Assign camera name ========================================================== For a better allocation of the cameras, a camera name can be set individually via entries in the event.ini in the respective event directory. .. figure:: /Images/GoProAutoSync/Eventini.png :scale: 100% :align: center Event.ini entry for allocating camera name Open Plugins ========================================================== Open *Analyzer* with the desired videos and then the *Plugins* which can be found under *Plugins* *2D Video Functions* and then *Video VLC link Camera*. .. figure:: /Images/GoProAutoSync/OpenPlugin.png :scale: 70% :align: center Opening video plugin in Analyzer .. important:: If a camera name was assigned the respective camera name is shown at plugin list instead of camera Evaluation ========================================================== The alignment accuracy strongly depends on the conscientious execution of the steps described in the section *Preparations*. The processing time of the camera used also plays a role. .. admonition:: Addtional manual If the video offset must be adjusted manually, please click `here `__ for link to 2D YouTube tutorial! Appendix ========================================================== Possible setup ---------------------------------------------------------- Due to the temporal assignment of the videos to the measured data, the following scenario is possible: - Rider 1 has installed a 2D logger on his motorcycle and is wearing a camera with chest strap - Rider 2 films with a camera on the helmet Rider 1 from behind - Camera 3 was set up stationary in corner 5 - Camera 4 is attached to a drone and films from a bird's eye view During evaluation, the driver can then access videos from 4 different perspectives in addition to the 2D measurement data and thus improve his performance with the various tools of the 2D Datarecording software. .. important:: At the moment, the software is able to process *twelve* videos each from *four* cameras! If you want to use more cameras, please contact 2D Datarecording via our `website `__! .. important:: By using GoPro® MAX camera, with one camera different perspectives of one rider can be achieved, when e.g., creating *multiple* videos with different views from only *one* 360-file! **If required, please contact 2D Datarecording via our** `website `__! GoPro® MAX 360° Videos ---------------------------------------------------------- In comparison to other GoPro® cameras, the GoPro® MAX is saving its 360° videos in 360-format on SD-card. Since January 2021, the *2D GoPro*\ :sup:`®` *AutoSync* feature is also able to handle videos in 360-format! .. attention:: Videos in 360 format can be played by the VLC player but cannot be used in any meaningful way. After editing with GoPro Player the videos are exported as mp4-files When inserting an SD card with videos in 360 format into a computer, these videos are treated completely like mp4 files, i.e. when copying from the SD card into the video event folder (*\\Videos\\*), GPS timestamps are also extracted and saved in *AvailableVideos.ini*. In addition, the copied 360 files are renamed according to the previously described pattern with camera serial number and time information. **Before using the 360-videos in 2D-Analyzer, the renamed 360-files must be opened and edited in GoPro® Player where the desired views can be chosen! More information about editing in GoPro® Player can be found** `**here** `__! .. attention:: After editing the video, the file must be exported to the *video event folder* (\\Videos\\) with the same name as the respective 360 file was called! **Afterwards, the mp4 file can be used like any other GoPro® video in chapter 5, but steps 1 and 2 must not be carried out.** Interpretation of the AvailableVideo.ini entries ---------------------------------------------------------- +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | [490577\_20200407113745.MP4] | [754000\_20200502133702.MP4] | [490577\_20200407103406.MP4] | [490577\_20200511135013.MP4] | **Filename** | +======================================================================================================================================================================+=========================================================================================================================================================================================================================+===========================================================================================================================================================================+=============================================================================+============================================================+ | FrameRate=119.880 | FrameRate=119.880 | FrameRate=119.880 | FrameRate=119.880 | **Video-framerate** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | Length=9.902 | Length=294.127 | Length=6.807 | Length=10.093 | **Length of video** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | Model=HERO8 Black | Model=HERO5 Black | Model=HERO8 Black | Model=HERO8 Black | **Camera-model** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | Version=HD8.01.01.60.00 | Version=HD5.02.02.70.00 | Version=HD8.01.01.60.00 | Version=HD8.01.01.60.00 | **Camera-firmware** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | Serial=C3331350490577 | Serial=C3161325754000 | Serial=C3331350490577 | Serial=C3331350490577 | **Serialnumber of camera** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | Copy\_Date\_UTC=20200511 | Copy\_Date\_UTC=20200511 | Copy\_Date\_UTC=20200511 | Copy\_Date\_UTC=20200511 | **Time when video was copied to PC** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | Copy\_Time\_UTC=13:49:53 | Copy\_Time\_UTC=13:49:08 | Copy\_Time\_UTC=13:50:11 | Copy\_Time\_UTC=13:50:13 | **Date when video was copied to PC** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | GPS\_SOD=41865.714 | GPS\_SOD=49022.140 | GPS\_SOD=38046.515 | GPS\_SOD=0 | **GPS-Time in SOD-format** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | GPS\_Time=11:37:45.714 | GPS\_Time=13:37:02.140 | GPS\_Time=10:34:06.515 | | **GPS-Time** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | GPS\_Date=20200407 | GPS\_Date=20200502 | GPS\_Date=20200407 | | **GPS-Date** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | Precision=9999 | Precision=493 | Precision=220 | | **Precision-value** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | ExtrapolDiff=0 | ExtrapolDiff=54.002 | ExtrapolDiff=0 | | **Time after precision became smaller than limit value** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | First latitude=49.003264 | First latitude=49.003264 | First latitude=49.003264 | | **First Latitude** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | First longitude=8.461552 | First longitude=8.461552 | First longitude=8.461552 | | **First Longitude** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ | **This combination indicates that the GPS was on (Precision entry), but the camera had no GPS reception during the whole video (Precision=9999 & ExtrapolDiff=0)** | **This combination indicates that the GPS was switched on (Precision entry), but the video started with bad GPS reception, which was then getting better (Precision=493) after 54.002 seconds (ExtrapolDiff=54.002)** | **This combination indicates that the GPS was switched on (Precision entry), the camera had good GPS reception (Precision=220) from the first sample (ExtrapolDiff=0)** | **This combination indicates that the camera's GPS was off (GPS\_SOD=0)** | **Interpretation** | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------+------------------------------------------------------------+ Dashware Data overlay ---------------------------------------------------------- The software Dashware can be used in conjunction with the 2D software to create a measurement data overlay. The recorded data is displayed during the video using various, freely configurable display options. Due to the improved usability of the Dashware feature and the automatic synchronization of GoPro videos in the 2D software, only the channels need to be selected and a toolbar button pressed to export the measurement data. Only the part of the measurement data that actually corresponds to the video is then exported to a csv file. This csv file is then loaded together with the video in the Dashware software. .. raw:: html .. admonition:: Addtional manual Detailed information about *Dashware Data overlay* can be at http://2d-datarecording.com/downloads/manuals/ |