Follow

Access Command Line Overview for MVN

Command Lines are a helpful way to quickly Process, Export or Trim your recordings without needing to launch MVN itself. This can be useful for those wanting to setup up a pipeline for processing a large number of recordings. 

 

1. How to Access the Overview

For the Command Line Overview, which gives details on the current commands available for MVN follow the steps below: 

1. Open Command Prompt from the start menu

2. Find the path to where your mvn_studio64.exe is located. This is typically ''C:\Program Files\Xsens\Xsens MVN 20XX.xx\MVN Studio''

Screen_Shot_23-8-2019_at_12.32.png

3. In Command Prompt enter cd C:\LOCATIONOFXSENS\Xsens\Xsens MVN 2019.xx\MVN Studio, Make sure to use the correct path to this folder on your own machine. 

Screen_Shot_23-8-2019_at_12.27.png

4. Now we are ready to enter our first command: mvn_studio64.exe -h

Screen_Shot_23-8-2019_at_12.28.png

5. After a few moments the Overview will open up in Command Prompt and you can begin integrating command lines for MVN into your pipeline!

Screen_Shot_23-8-2019_at_12.29.png

 

2. Usage

C:\Program Files\Xsens\Xsens MVN 2020.0\MVN Studio>Usage:
mvn_studio64.exe --help
mvn_studio64.exe [<filename>]
mvn_studio64.exe <filename> [--reprocess]
mvn_studio64.exe <filename> [--reprocess] --output=<outputFileName> [--trim=<type>,<start>,<end>] [-s<customSetting>=<value>]

TIP: Use "start /w mvn_studio64.exe <commands>" to start from the command-line and wait for MVN to complete.

 

3. Examples

Show this help and wait for it to print before returning to the console:
start /w mvn_studio64.exe --help

Run the Xsens MVN graphical application and load input.mvn:
mvn_studio64.exe input.mvn

Reprocess input.mvn and output it to the same file:
start /w mvn_studio64.exe input.mvn --reprocess

Export input.mvn to output.fbx in skeleton mode:
start /w mvn_studio64.exe input.mvn --output=output.fbx -soutputPreset=Skeleton

Copy the first 3 seconds of input.mvn to output.mvn:
start /w mvn_studio64.exe input.mvn --trim=reltime,00:00:00:00,00:00:03:00 --output=input.mvn

Trim seconds 2 to 10 from input.mvn, reprocess and export to output.mvnx while reducing frame rate by 2/3rd:
start /w mvn_studio64.exe input.mvn --reprocess --trim=reltime,00:00:02:00,00:00:10:00 --output=output.mvnx -sframeSkip=2

Export files in a batch from an input path to an output path.
start /w mvn_studio64.exe --batch --reprocess --inputpath=C:\inputpath\ --outputpath=D:\outputpath\ --exporter=fbx

 

4. Options

-h, --help
Print this help message

--fresh
Use a fresh MVN instance for opening files

--processes=<processes>
Number of parallel processes to use for exporting and reprocessing (default 1)

-o, --output=
Output to outputFileName. The exporter is chosen based on the file extension.
Not all exporters are available through the command line.

-b, --batch
Exports files in the supplied format from a specified folder to another specified folder.

--reprocess
Reprocess files that need reprocessing before exporting. If --force is also set, all files will be reprocessed. Without --force only files that are of a lower processing quality will be reprocessed.

--force
Force the files to be reprocessed.


--inputpath=
The folder to import from, only used when --batch is supplied.


--outputpath=
The folder to export to, only used when --batch is supplied.


--exporter=
The exporter to use. Supported exporters: bvh,fbx,mvnx


-t, --trim=
Trim the file down. Does not change the original file.
Trim takes three arguments:
<type>: abstime | reltime | framenr

<start>: Depending on <type>:
- <type>=abstime: The absolute start time. Syntax: HH:MM:SS:frame or HH:MM:SS.sss.
- <type>=reltime: The relative start time. Syntax: HH:MM:SS:frame or HH:MM:SS.sss.
00:00:00:00 is the start of the file.
- <type>=framenr: The start frame number.

<end>: Depending on <type>:
- <type>=abstime: The absolute end time. Syntax: HH:MM:SS:frame or HH:MM:SS.sss.
- <type>=reltime: The relative end time. Syntax: HH:MM:SS:frame or HH:MM:SS.sss.
00:00:00:00 is the start of the file.
- <type>=framenr: The end frame number.


--scenario=
Set the scenario for the file (single file processing only).
Options vary, typical options: singleLevel | multiLevel | noLevel

--save
Save the processed MVN file. This will overwrite the original file if it is reprocessed. Note that --save is implied if no output is specified.

--positionaiding=
Explicitly turn on/off the 3d position aiding, overriding the settings in the file.
Options: on/off

--quality=
Set the quality for the reprocessed file.
Options fast | full

--resetposition
Reset the position at the start of reprocessing (single file processing only)

--resetheading
Reset the heading at the start of reprocessing (single file processing only)

--resetengine
Reset the motion capture engine at the start of reprocessing (single file processing only),
implies  --resetposition

--noreset
Remove all of the above resets from the file if already in there (single file processing only), implied by any of the above resets.

--logStatus
Log debugging connectivity and battery status to separate logfile

-s, --set
Pass a custom setting to the exporter.
Custom settings are always in the key=value form.
Settings not mentioned on the command line are set to their default value.

 

5. Arguments

filename
The file to open.
If no options are given, the file is opened in the GUI version of mvn_studio64.exe

 

Custom settings (use --set) for BVH Exporter (.bvh)

debug
Enable debugging

frameSkip
The number of frames to skip between exported frames, use for downsampling.

outputPreset
Choose the output preset. Supported values are "Motion Builder", "Poser 6" and "3D Studio Max"

outputScale
Set the output scaling

useCalibrationPose
Use the calibration pose (identity-pose) for the first frame

Custom settings (use --set) for FBX Exporter (.fbx)


frameSkip
The number of frames to skip between exported frames, use for downsampling.

outputPreset
How the output is rigged. Supported values are "Skeleton", "Nodes".

outputScale
The scale of the output. Typically FBX is in cm, while MVN uses m so the default scale is 100

timeIncrementMode
How the frames are timestamped, options are 0: Fixed (constant intervals) and 1: Dynamic (individually timestamped frames)

timeStart
Start timestamps from 0 (option 0, default) or start timestamps from recorded first timestamp (option 1)

useCalibrationPose
Whether to replace the first frame with a T-pose for calibration. Defaults to true.

walkOnTheSpot
Keep the Pelvis X and Y fixed in the export.

Custom settings (use --set) for MVNX Exporter (.mvnx)


frameSkip
The number of frames to skip between exported frames, use for downsampling.

includeAcceleration
Include acceleration data. Defaults to false.

includeAngularAcceleration
Include angular acceleration data. Defaults to false.

includeAngularVelocity
Include angular velocity data. Defaults to false.

includeCenterOfMass
Include center of mass data. Defaults to false.

includeContacts
Include contact data. Defaults to false.

includeGlobalPosition
Include Global Position (GNSS) data as Latitude, Longitude, Altitude of the Pelvis segment. Defaults to false.

includeJointAngle
Include joint angle data. Defaults to false.

includeOrientation
Include orientation data. Defaults to true.

includePosition
Include position data. Defaults to true.

includeSensorAcceleration
Include sensor acceleration data. Developers license required. Defaults to false.

includeSensorAngularVelocity
Include sensor angular velocity data. Developers license required. Defaults to false.

includeSensorFreeAcceleration
Include sensor free acceleration data. Extended license required. Defaults to false.

includeSensorMagneticField
Include sensor magnetic field data. Extended license required. Defaults to false.

includeSensorOrientation
Include sensor orientation data. Extended license required. Defaults to false.

includeTimeCode
Include time code timestamps. Defaults to false.

includeVelocity
Include velocity data. Defaults to false.

mvnxVersion
The MVNX version to use.

Was this article helpful?
0 out of 0 found this helpful
Do you have a question? Please post your question in our Community Forum