On Moveshelf you can automate the process of grouping multiple files into trials and multiple trials into conditions, by uploading a Vicon directory. For general information about how to upload a directory see the section directory upload.

Folder structure

The Vicon directory upload works with a Vicon session folder. A session folder usually is a direct child of the subject folder, and includes all data files for one session.

For the upload to work, the session folder should include:

• xxx.Session.enf file. This file is used to detect a Vicon session
• xxx.Trial.enf or xxx.Trialxx.enf files. This file is used to detect trials within the Vicon session
• .C3D files (optional)
• .avi files (optional)
• .mp4 files (optional)
• .PDF files (optional)
• image files (.jpeg, .png, .webp) (optional)
Please see the image on the right for the contents of an example Vicon session folder. The session folder can have subfolders. All files from all subfolders will be included for the directory upload.


Automatically categorize trials into conditions

Fill in the Description field in Vicon Nexus with the name of your condition. Moveshelf will read this and categorize your trials into these conditions (see image below).










Movement analysis data

This section describes how to set up your C3D file for visualization on Moveshelf.
• Data groups on Moveshelf
  
  • All data in the "ANGLES" group in the C3D file will be grouped under "Kinematics" on Moveshelf.
  • All data in the "MOMENTS" group in the C3D file will be grouped under "Moments" on Moveshelf.
  • All data in the "POWERS" group in the C3D file will be grouped under "Powers" on Moveshelf.
  • Force plate data added as a "Force platform" in the C3D file will be grouped under "Force plates" (Trial view) or "Forces" (Report view) on Moveshelf.
  • All data with "voltage" or "emg" in the C3D channel name will be grouped under "EMG" on Moveshelf. This can be raw and/or envelope EMG.
• Add gait events to a trial
  To be able to see gait events and gait cycle data on Moveshelf, you first have to add gait events (Foot Strike, Foot Off) to the C3D file of the trial. See Vicon Nexus Documentation for instructions on how to do this.
• Add spatiotemporal parameters to a trial
  To be able to see spatiotemporal parameters in a trial on Moveshelf, you first have to add these to the C3D file of the trial. This can be done by adding the 'Calculate Gait Cycle Parameters' operation to your data processing pipeline in Nexus. This operation calculates the parameters in the first complete gait cycle for each side in each trial, also if multiple gait cycles are defined in a trial (see Vicon Nexus Documentation). Seeing as this is single-cycle data and not an average, only one value will be shown for each parameter on Moveshelf in trial view.
• Only show valid kinetics on Moveshelf
  In Vicon Nexus there are standard columns for force plates (e.g., FP1 = force plate 1 and FP2 = force plate 2). For every trial, enter the information for a good hit on a force plate by 'Left' or 'Right', or input 'invalid' in the column (see image 1 below). This will generate clean and recognizable patterns in force data in case of a gait cycle analysis (see image 2 below). This information is also used by Vicon Nexus when calculating moments and powers, ensuring that moments and powers are only calculated for good hits. If all force plates have invalid data, no force plate graphs are shown.
  
  You can also edit the force plate context on Moveshelf without having to adjust the C3D again in Nexus. For more information, navigate to Add context force plates. Note that this only affects force data and not moments / powers.
  
  

  

  

  
  

  

  

  
  
• Normalize data to bodyweight or mass
  It is possible to visualize ground reaction force normalized to body weight (%BW) or body mass (N/kg). A data structure requirement for this optional report template setting is that the C3D file has to contain body mass information. The moments and powers are provided by default in the C3D as respectively Nm/kg and W/kg, and visualized on Moveshelf as such without the need of body mass information separately in the C3D. Alternatively, if the C3D did not contain the required information, you can manually add a bodyweight for the subject using add subject information. The date of the body weight should match the exact date of the session, or a warning icon will be shown for the concerning graphs.

Videos

Videos in .avi or .mp4 format can be added to the corresponding trial based on filename. More specifically, the video filename should start with the trial name, which is taken from the name of the .Trial.enf file.


Vicon Nexus 2.13 and higher exports videos with a new transcoder (H264). We recommend using this version of Nexus for shorter upload (processing) times on Moveshelf.



Additional files

An additional filter can be added to your Vicon directory upload settings to include alternative file types like PDF or images (.jpeg, .png, .webp) in your Vicon directory upload. These files will be automatically put into separate trials, in a condition called "Additional files". These alternative file types can be uploaded automatically as a child folder within the Vicon session or you can upload it as a separate folder after your Vicon session is done uploading.


Add trial information

• Automatically add a description to a trial
  Populate the Notes field in Vicon Nexus to fill the Moveshelf description field (Image 1 below, in orange).
• Automatically show information on the content of a trial
  Show the content of a trial (laterality/plane) next to the trial name in the navigation menu on the left side of the screen, by using custom colums named 'Side' and 'Plane' in Vicon Nexus (Image 1 below, in red). For example, populate these columns with 'L' (left) or 'R' (Right) to indicate the side, and 'fro' (frontal) or 'dor' (dorsal) for the plane. If the column Plane is empty, Moveshelf will assume the plane is sagittal. See Image 2 for the steps how to create the correct columns in Nexus.