A list of the default rigid body creation properties is listed under the Rigid Bodies tab. Thes properties are applied to only rigid bodies that are newly created after the properties have been modified. For descriptions of the rigid body properties, please read through the Properties: Rigid Body page.

Skeleton Display Properties

A list of the default Skeleton display properties for newly created skeletons is listed under the Skeletons tab. These properties are applied to only skeleton assets that are newly created after the properties have been modified. For descriptions of the skeleton properties, please read through the Properties: Skeleton page.

Advanced Properties

Skeleton Creation Pose

Chooses which Skeleton calibration pose to be used for creation. (T-pose, A-pose Palms Downward, A-pose Palms Forward, and A-pose Elbows Bent)

Head Upright

Creates the skeleton with heads upright irrespective of head marker locations.

Straight Arms

Creates the skeleton with arms straight even when arm markers are not straight.

Straight Legs

Creates the skeleton with straight knee joints even when leg markers are not straight.

Feet On Floor

Creates the skeleton with feet planted on the ground level.

Height Marker

Force the solver so that the height of the created skeleton aligns with the top head marker.

The real-time reconstruction settings can be accessed in the Reconstruction tab under the Application Settings pane.

Reconstruction in motion capture is a process of deriving 3D points from 2D coordinate information obtained from captured images, and the Point Cloud is the core engine that runs the reconstruction process. The reconstruction settings define the parameters of the point cloud engine, and they can be modified to optimize the acquisition of 3D data points.

For more information on how to utilize the reconstruction settings, visit Reconstruction and 2D Mode page.

Point Cloud

Due to inherent errors in marker tracking, rays generally do not converge perfectly on a single point in 3D space, so a tolerance value is defined. This tolerance, called the residual, represents one of the reconstruction constraints. If a ray could be defined as an infinite series of points aligned in a straight line, two or more rays that have points within the defined residual range (in mm) will form a marker.

Enable Point Cloud Reconstruction

Default: ON

This toggles real-time 3D reconstruction on and off. It is recommended to turn this off if computer resource need to be dedicated to 2D recording. When disabled, you will not be able to see 3D data from the Live mode nor from the recorded 2D data.

Reconstruction Settings

Maximum Residual (mm)

Default: 10.00 mm

The residual value sets the maximum allowable offset distance (in mm) between rays contributing to a single 3D point.

When the residual value is set too high, unassociated marker rays may contribute to marker reconstruction, and non-existing ghost markers may be reconstructed. When this value is set too low, the contributing rays within a marker could reconstruct multiple markers where there should only be one.

Choosing a good Residual Value

Depending on the size of markers used, the contributing rays will converge with a varying tolerable offset. If you are working with smaller markers, set the residual value lower. If you're working with larger markers, set this value higher because the centroid rays will not converge as precisely as the smaller markers. A starting point is to set the residual value to the diameter of the smallest marker and go down from there until you start seeing ghost markers. For example, when 3 mm and 14 mm markers are captured in a same volume, set the residual value to less than 3 mm. The ghost markers can appear on larger markers if this value is set too low.

The residual can also be viewed as the minimum distance between two markers before they begin to merge. If two markers have a separation distance smaller than the defined residual (in mm), the contributing rays for each marker will be merged and only one marker will be reconstructed, which is undesirable. Remember that for a 3D point to be reconstructed, it needs to have at least two rays contributing to a marker depending on the Minimum Rays setting.

If calibration quality is not very good, you may need to set this value higher for increased tolerance. This will work only if your markers are further apart in the 2D views throughout the given marker motion. This is because there is more errors in the system. However, for best results, you should always work with a calibration with minimal error (See Calibration).

Maximum Ray Length (m)

Default: None — the calibration solver will set a suggested distance based on the wanding results, but this can still be adjusted by the user after calibration.

This sets the maximum distance, in meters, a marker can be from the camera to be considered for 3D reconstruction. In very large volumes with high resolution cameras, this value can be increased for a longer tracking range or to allow contributions from more cameras in the setup. This setting can also be reduced to filter out longer rays from reconstruction. Longer rays generally produce less accurate data than shorter rays.

When capturing in a large-size volume with a medium-size – 20 ~ 50 cameras – camera system, this setting can be adjusted for better tracking results. Tracking rays from cameras at the far end of the volume may be inaccurate for tracking markers on the opposite end of the volume, and the unstable rays may contribute to ghost marker reconstructions. In this case, lower the maximum ray length to restrict reconstruction contributions from cameras tracking at long distances. For captures vulnerable to frequent marker occlusions, adjusting this constraint is not recommended since more camera coverage is needed for preventing the occlusions. Note that lowering this setting can take a toll on performance at higher camera counts and marker counts because the solver has to perform numerous calculations per second to decide which rays are good.

Minimum Ray Length (m)

Default: 0.2 m

This sets the minimum distance, in meters, between a marker and a camera for the camera to contribute to the reconstruction of the marker. When ghost markers appear close to the camera lens, increase this setting to restrict the unwanted reconstructions in the vicinity. But for close-range tracking applications, this setting must be set low.

Minimum Ray Count

Default: 2 rays

This sets the required minimum number of cameras that must see a marker for it to be reconstructed.

For a marker to be reconstructed, at least two or more cameras need to see the marker. The minimum rays setting defines the required number of cameras that must see a marker for it to be reconstructed. If you have 4 cameras and set this to 4, all cameras must see the marker; otherwise, the marker will not be reconstructed and the contributing rays will become the untracked rays.

When more rays are contributing to a marker, more accurate reconstruction can be achieved, but generally, you don't need all cameras in a setup to see a marker. If you have a lot of cameras capturing a marker, you can safely increase this setting to prevent false reconstructions which may come from 2 or 3 rays that happen to connect within the residual range. However, be careful when increasing this setting because a high number of minimum rays requirement may decrease the effective capture volume and increase the frequency of marker occlusions during capture.

Marker Labeling Mode

Default: Passive

Configures Motive for tracking either the passive markers, the synchronized active markers, or both. See Active Marker Tracking for more information.

Active Patten Depth

Default: 12

This setting is available only if marker labeling mode is set to one of the active marker tracking modes. This setting sets the complexity of the active illumination patterns. When tracking a high number of rigid body, this may need to be increased to allow for more combinations of the illumination patterns on each marker. When this value is set too low, the active labeling will not work properly.

Continuous Calibration

Default: Disabled

Enable or disable continuous calibration. When enabled, Motive will continuously monitor the calibration quality and update it as necessary. For more information, refer to the Continuous Calibration page.

Performance/Quality

Default: 4

This setting enables the Ray Ranking, which calculates quality of each ray to potentially improve the reconstruction. Setting this to zero means that ray ranking is off, while 1 through 4 set the number of the evaluation iterations; 4 being 4 iterations. Setting this value to the max of 4 will slow down the reconstruction process but will produce more accurate results.

The Ray Ranking increases the stability of the reconstruction but at a heavy performance cost. The ray quality is analyzed by comparing convergence of rays that are contributing to the same marker. An average converging point is calculated, and each ray is ranked starting from the one closest to the converging point. Then, each ray is weighed differently in the Point Cloud reconstruction engine according to the assigned rankings.

This setting is useful especially when there are multiple rays contributing to a marker reconstruction. If you're working with small to medium marker counts, enabling this will not have an evident improvement on performance. Also, when precise real-time performance is required, disable this setting especially for a setup with numerous cameras.

Pixel Gutter (pixels)

Default: 0 pixels

Establishes a dead zone, in pixels, around the edge of the 2D camera image. Any 2D objects detected within this gutter will be discarded before calculating through the point cloud. In essence, it is a way of getting only the best data of the captured images, because markers seen at the edges of the camera sensor tend to have higher errors.

This setting can be increased in small amounts in order to accommodate for cases where lens distortions are potentially causing problem with tracking. Another use of the setting for limiting the amount of data going to the reconstruction solver, which may help when you have a lot of markers and/or cameras. Be careful adjusting this setting as the trimmed data can't be reacquired in post-processing pipelines.

Minimum Angle (degrees)

Default: 5 degrees

The minimum allowable angle – in degrees from the marker's point of view – between the rays to consider them valid for marker reconstruction. This separation also represents the minimum distance required between the cameras. In general, cameras should be placed with enough distance in between in order to capture unique views on the target volume. For example, if there are only two cameras, an ideal reconstruction would occur when the cameras are separated far enough so the rays converge with a 90 degree of an incident angle from the perspective of the reconstructed marker(s).

When working with a smaller-sized system with a fewer number of cameras, there will be only a limited number of markers rays that can be utilized for reconstruction. In this case, lower this setting to allow reconstruction contributions from even the cameras that are in close vicinity to each other.

On the other hand, when working with a large system setup with a lot of cameras, you can set this value a bit higher to limit marker rays that are coming from the cameras that are too close together. Similar vantages obtained by the cameras within vicinity do not necessarily contribute unique positional data to the reconstruction, but they only increase the required amount of computation. Rays coming from very close cameras may increase the error in the reconstruction. Better reconstruction can only be achieved with a good, overall camera coverage (See Camera Placements).

Rigid Body Markers Override

Default: False

When the Rigid Body Marker Override is set to True, Motive will replace observed 3D markers with the rigid body's solution for those markers. 3D tracking data of reconstructed and labeled trajectories will be replaced by the expected marker locations of the corresponding rigid body solve.

This is applicable only for rigid bodies using Ray-Based tracking, and when the Use Smart Markers is enabled.

Use Smart Markers

Default: True

When this feature is enabled, Motive uses expected marker locations from both the model solve and the trajectory history to create virtual markers. These virtual markers are not direct reconstructions from the Point Cloud engine. When the use of smart markers is enabled, rigid body and skeleton asset definitions will also be used in conjunction with 2D data and reconstructed 3D data to facilitate reconstruction of additional 3D marker locations to improve tracking stability. These virtual markers are created to make live data match recorded data in situations where model and history data helped to improve the live solve

More specifically, for rigid body tracking, Motive will utilize untracked rays along with the rigid body asset definition to replace the missing markers in the 3D data. In order to compute these reconstructions, the rigid body must be using the Ray-Based tracking algorithm. For skeleton tracking, only the asset definitions are used to approximate virtual reconstruction at the location where the occluded marker was originally expected according to the corresponding skeleton asset.

Using the asset definitions in obtaining the 3D data could be especially beneficial for accomplishing stable tracking of the assets in low camera count systems where all of the reconstructions may not always meet the minimum required tracked ray requirements.

Utilize Active Labels

Default: true

When set to true, Motive will recognize the unique illuminations from synchronized active markers and perform active labeling on its reconstructions. If you are utilizing our active marker solution, this must be set to true. For more information about active labeling, read through the Active Marker Tracking page.

Max Gap Span

Default: 20

Sets the required minimum number of frames without occlusion for a tracked marker to be recognized as the same reconstruction to form a trajectory. If a marker is hidden, or occluded, longer than the defined number of frames, then the trajectory will be truncated and the marker will become unlabeled.

Max Search Radius (m)

Default: 0.06 m

To identify and label a marker from one frame to the next, a prediction radius must be set. If a marker location in the subsequent frame falls outside of the defined prediction radius, the marker will no longer be identified and become unlabeled.

For capturing relatively slow motions with tight marker clusters, limiting the prediction radius will help maintaining precise marker labels throughout the trajectory. Faster motions will have a bigger frame to frame displacement value and the prediction radius should be increased. When capturing in a low frame rate settings, set this value higher since there will be bigger displacements between frames.

Advanced Options

Reconstruction Bounds

Bound Reconstrutction

(Default: False) When set to true, the 3D points will be reconstructed only within the given boundaries of the capture volume. The minimum and maximum boundaries of X/Y/Z axis are defined in the below properties.

Visible Bounds

Visualize the reconstruction bounds in the 3D viewport.

Bounds Shape

(Default: Cuboid) This setting selects the shape of the reconstruction bound. You can select from cuboid, cylinder, spherical, or ellipsoid shapes and the corresponding size and location parameters (e.g. center x/y/z and width x/y/z) will appear so that the bound can be customized to restrict the reconstruction to a certain area of the capture volume.

Auto-labeler

After markers have been reconstructed in Motive, they must be labeled. Individual markers can be manually labeled, but the auto-labeler simplifies this process using the Assets. Rigid body and skeleton assets, created in Motive, saves their marker arrangement definitions and uses them to auto-label corresponding marker sets within the Take. The auto-labeling, is a process of associating 3D marker reconstructions in multiple captured frames by assigning marker labels within the defined constraints. After the labeling process, each of the labeled markers provides respective 3D trajectories throughout the Take.

Pose Detection

Default: TruePose detection improves the stability of skeleton tracking by detecting standing poses. For multi-skeleton captures, this feature may increase the skeleton solve latency.

Minimum Key Frames

Default: 2This setting sets the required minimum number of frames for each trajectory in the recorded 3D data. Any trajectories with a length less than the required minimum will be discarded from the 3D data after running the auto-labeling pipeline.

Auto-labeler Passes

Default: 1The number of iterations for analyzing detected marker trajectories for maintaining constant marker labels. Increasing this setting can improve the marker auto-labeling, but more iterations will require more time and computation effort to complete the auto-labeling.

Rigid Body Assisted Labeling

Rigid Body Assisted Labeling can be used to optimize the labeling of markers within a region defined by a rigid body. The first step in using this feature is to create a rigid body from markers that are visible and rigidly connected. The example shown in the figure below demonstrates this for hand tracking. Five white markers are selected on the top of the wrist - which is rigidly defined. The black markers on the fingers are not rigidly defined in any fashion but are within the boundary of the Rigid Body Assisted Labeler. Labeling continuity is improved for the markers on the fingers which are given automatic labels.Tracking of organic or flexible objects - that do not have a tracking models like the face and hand, are good candidates for Rigid Body Assisted Labeling.

Rigid Body-Assisted Labeling

Default: FalseEnable or disable rigid body assisted labeling feature.

Rigid Body Volume Radius

Default: 300 mmThe rigid body volume radius defines the region of space where the rigid body assisted labeling is applied. Increasing this radius will increase time needed for the auto-labeling so care should be made when setting this property.

Prediction Radius (mm)

Default: 10 mmThe prediction radius defines the size of the bounding region used to label markers. When labeling a marker from one frame to the next, a bounding region, relative to the rigid body, is created around each labeled marker. The labeling continuity is restricted to the bounding region from frame to frame. Increasing this can allow markers to swap if there are occlusions in the data. Decreasing this restricts labeling from frame to frame but may lead to an increase in broken trajectories.

Maximum Assisted Labeling Gap

Default: 30 framesThe maximum gap frames property defines the maximum number of frames a marker can be hidden before it is truncated or unlabeled. Increase this value if larger gaps are to be anticipated. Increasing the assisted labeling gap will increase the processing time of reconstruction.

Discard External Markers

Default: FalseDiscards markers outside of rigid body volume. Enabling this property will eliminate marker reconstructions outside of the region defined by the Rigid Body Volume.

Dynamic Constraints

Default: NonePrevents the rigid body from moving/rotation more than specified amount per frame.

Max Translation (mm)

Default: 100Distance for Dynamic Translation Constraint option.

Max Rotation (deg)

Default: 30Angle for the Dynamic Rotation Constraint option.

Minimum Tracking Frames

Default: 20Dynamic constraints are enabled when the rigid body is consecutively tracking more than this frame count.

Marker Filter Diameters

Default: FalseMarkers less than this diameter will not be used for rigid body tracking.

Minimum Diameter (mm)

Default: 10Diameter used for Marker Filter Diameter option.

2D Display Options

Camera Health Info

Displays various assessments of camera health over the 2D camera views, for troubleshooting performance issues. If any performance issues is detected, corresponding problem will be listed at the bottom of the 2D camera view.

Reticles

When enabled, renders a crosshair on top of the 2D camera views, which can be useful for camera aiming.

Masks

Enables displaying masked area on the 2D camera views, in red.

Backproject Markers

Enables markers selected from the 3D Perspective View to be also highlighted with yellow crosshairs in the 2D camera view, based on calculated position. Crosshairs that are not directly over the marker tend to indicate occlusion or poor camera calibration.

Marker Filter

When enabled, filtered reflections will be labeled with the corresponding object filters in the 2D camera view.

Marker Coordinates

Displays 2D coordinate of the detected object centroids within the captured image, in pixels.

Marker Centroids

Displays crosshairs on marker centroids in the 2D view.

Marker Boundaries

Displays a box around each marker, indicating its calculated edges after the brightness threshold.

Marker Circularity

Displays the roundness of an object. A value of 1 indicates maximum roundness, while a value of 0 indicates no roundness.Pixel inspector enabled in 2D view

Marker Aspect Ratio

Displays the ratio of object width to object height as a decimal, resolved to .01 pixel.

Marker Size

Displays the area of the object in pixels, accurate to .01 pixel.

Marker Label

Displays the pre-identified labels assigned to 2D objects for initial tracking from frame to frame.

Pixel Inspection

Displays X,Y coordinates for cursor location when hovering over a camera, and pixel brightness for selected pixels when a region is drag-selected. Inspecting pixel brightness can be useful during camera focusing, tuning, and aiming.

Texture Streaming

Disables or enables texture streaming of reference videos on the 2D camera viewport.

Visual FPS Target

Sets a maximum frame display rate for the 2D camera view.

Background Color

Selects the color to display in the viewport between camera panes.

Camera Info

Enables text overlay of pertinent camera information on the 2D Multi Camera view panes. Displayed information includes image mode, time, data rate, frame ID, visual FPS, number of objects, camera serial, exposure value, threshold value, IR intensity value, internal temperature, and camera sync mode.

Distortion Map

Show Distortion

Displays each camera’s lens distortion map.

Overlay Color

Selects the color of the lens distortion map display.

Overlay Transparency

Selects the transparency percentage for the lens distortion map.

Overlay Resolution

Selects the level of details for displaying the lens distortion. More specifically, it sets number of distortion grids on the width and height of the distortion map.

Show as Predistortion

Selects whether the map is shown as pre-distorted or distorted.

Multi-Camera 2D Display

Display Mode

Sets levels of details for the markers displayed in the multi-camera 2D view. Available modes are Frame Buffer, Marker Centers, and Automatic LOD modes. Default is Automatic LOD.

• Automatic LOD switches between Frame Buffer mode and Marker Centers mode depending on the zooming of the 2D camera view, or the LOD threshold setting.

• Frame Buffer mode pushes the entire camera frame to the video card for scaling and display. It provides verbose information on detected reflections and centroids, but it is data intensive at the same time.

• Marker centers mode merely defines a white circle of the rough size and shape of the marker as it would appear. More specifically, it displays the reflections by its size and location and is significantly less hardware intensive.

Pane Gap

The distance between 2D Multi View camera panes, in pixels.

LOD Threshold

The size, zoom percentage, at which the system switches between Marker Centers and Frame Buffer mode.

Raster Priority

Defines the update rate for the camera pixel data shown in the 2D camera views. The priority value ranges from 1 - 6, and a higher priority indicates a higher rate of update.

3D Display Options

Camera Names

Displays the camera model, serial, and master/slave status above and below camera objects.

Text Size

Adjusts the size of the camera name text.

Solid Cameras

Setting this to true disables camera object transparency in the 3D Perspective View.

Labeled Marker Color

Sets the color for labeled markers in the 3D view port.

Active Marker Color

Sets the color for active markers in the 3D viewport.

Unlabeled Marker Color

Sets the color for Unlabeled markers in the 3D view port.

Selection Color

Sets the color of selections in the 3D view port.

Marker History

Displays a history trail of marker positions over time.

Selected History Only

Determines whether marker history will be shown for selected markers or all markers.

Assigned Markers

Enables or disables display of assigned markers (also called solved, expected marker positions) on rigid body or skeleton assets

Show Marker Count

Displays the number of markers detected by the system as well as the number of markers selected at the bottom right corner of the perspective view.

Show Marker Labels

Displays marker labels for selected markers in the perspective view.

Show Timecode

Enables or disables timecode values displayed on the 3D viewport. Timecode will be available only when the timecode signal is inputted through the eSync.

Show Marker Infos

When this is set to true. 3D positions and estimated diameter of selected markers will be displayed on the 3D viewport.

Display mode

Toggles camera numbers on and off in the 3D Perspective View.

Marker Diameter

Determines whether marker sizes in the 3D Perspective View are represented by the calculated size or overwritten with a set diameter.

Diameter (mm)

Sets the diameter in millimeters for marker sizes in the 3D Perspective View, if Marker Diameter is set to Set Diameter.

Background Color

Selects the background color displayed in the 3D Perspective View.

Fog Effect

Turns a gradient “fog” effect on in the 3D Perspective View.

OptiTrack Logo

Overlays the OptiTrack logo over top of the 3D Perspective View.

Grid Color

Selects the color of the ground plane grid in the 3D Perspective View.

Grid Transparency

Selects the level of transparency applied to the ground plane grid in the 3D Perspective View.

Grid Size

Selects the size of the ground plane grid in the 3D Perspective View. Specifically, it sets the number of grids (20cm x 20cm) along the positive and negative direction in both the X and Z axis.

Coordinate Axis

Displays the coordinate axis in the 3D view port.

Video Overlay Display FPS

Controls of often scene video overlays are updated for display.

Undistort Video Overlay

Removes distortions from the grid when displaying the video distortion overlay in the reference video.

Show Tracked Rays

Displays tracked rays in the view port. Tracked rays are marker rays with residual values less than the Maximum Residual setting from the reconstruction pane. In other words, tracked rays are marker rays that are contributing to 3D reconstructions.

Show Untracked Rays

Displays the untracked rays in the view port. Untracked rays are the rays which start from each camera and goes through the detected 2D centroids, but fails to be reconstructed in the 3D space. When there are several untracked rays in the capture, it is usually a sign of bad calibration or extreme reconstruction settings.

Show Missing Rays

Displays the missing rays in the view port. Missing rays form when tracking a rigid body or a skeleton, and it indicates expected marker rays that are not detected from the camera view but expected from the rigid body or the skeleton solve.

Show Two Marker Distance

Enabling this will display distance between two markers in the Perspective View pane. Two markers must be selected to calculate the distance.

Show Three Marker Angle

Enabling this will measure an angle formed by three markers in the Perspective View pane. Three markers must be selected, and the calculated angle will follow the selection order. When all three markers are selected at once, the widest angle will be measured.

Show Marker Colors

When labeled, each skeleton marker is colored as defined in the corresponding markerset template. Enabling this setting will color the markers for better identification of the marker labels.

Show Marker Sticks

Setting this to true will show marker sticks on skeleton assets for clearer identification of skeleton markers and segments in each individual actor. Setting this to true will reveal marker sticks in 3D data.

Ray Options

Show Selected Residual

Displays the offset distance between rays converging into a marker. The residual value will be displayed on top of the view pane. Note that ray information will be displayed only in the 2D data.

Tracked Ray Color

Sets the color for Tracked Rays in the 3D Perspective View.

Untracked Ray Color

Sets the color for untracked Rays in the 3D Perspective View.

Missing Ray Color

Sets the color for Missing Rays in the 3D Perspective View.

Tracked Ray Transparency

Sets the level of transparency for Tracked Rays.

Untracked Ray Transparency

Sets the level of transparency for Untracked Rays.

Missing Ray Transparency

Sets the level of transparency for Missing Rays.

Missing Ray Threshold

Sets the distance in millimeters that a 2D marker must be from an expected location before declaring the marker missing.

Graphs

Color Scheme

Toggles the theme for the timeline playback graph between light and dark.

Background Color

Specifies the background color for the timeline playback graph.

Autoscale

Automatically scales trajectory graphs in the Timeline pane.

Preferred Live Layout

Preferred Layout to be used for the Live mode graph pane.

Preferred Edit Layout

Preferred Layout to be used for the Edit mode graph pane.

Scope Duration

This setting sets the time scope of the plotted graphs in Live mode. By default, this is set to 1000, which means 1000 captured frames of past tracking history will be plotted in Live mode. You can increase this to plot more history data or decrease it to zoom into the tracking history.

Reference View Options

Show Markers

Overlays markers in the reference video when this setting is set to true.

Show Skeletons

Overlays skeletons in the reference video when this setting is set to true.

Show Rigid Bodies

Overlays rigid bodies in the reference video when this setting is set to true.

Show Distortion Grid

Displays reference camera distortion grid in the reference view.

Lock Aspect Ratio

Keeps the aspect ratio constant for reference videos.

Split Horizontal

When set to true, multiple reference view is divided into multiple columns in the reference view pane.

Devices Pane

Maximum Exposure Display

Controls the maximum value of the exposure slider in Devices pane.

Calibration Pane Options

This section covers through the display options for the calibration features. In previous releases, these options existed in the Calibration pane.

Panel Output

Default: Standard. Decides whether the calibration process is displayed in a list format or a grid format. Grid format allows more camera progresses to be seen in the pane.

Status Ring

Default: Visualize. Enables the Status Indicator Ring to glow during calibration in order to display the wanding process.

Solver Visualizations

Default: Show. This toggles the display of wand samples and point cloud calibration visuals in the 2D and 3D view. If you're running on a lower end machine or graphics card with a large system, it is best to turn this feature off. The visual display will in fact eat up some computing power you may want reserved for getting quicker calibration results.

Lens Distortion

Default: Show. Use this to toggle the display of the lens distortion solution results in the 2D view. The lens distortion will be represented by a square grid that maps the distortion.

Cameras

Default: Show. This toggles the display of the cameras during the solve.

Wanding Projection

Default: Show. This toggles the display of wand samples projected in the 3D view. Turn this off if you're calibrating a very large system.

Projection Error

Default: Show. This toggles the display of error, reported as a color in the projected wand samples and markers. The wand samples will have a color between blue (good sample) and red (poor sample). Make sure the samples you collect are mostly good samples. As will all visual feedback, it may be a good idea to turn this off if you're calibrating a larger system.

Residual Error

Default: 6 mm. Set the tolerance for the reported error in the projected marker sample during calibration.

Wand Error

Default: 8 mm. This sets the tolerance for the reported error in the projected wand sample.

Sample Spacing

Default: 1. Use this to increase the spacing between displayed samples that are projected in the 3D view. Increasing this will skip more samples but will make the visual wand projections easier to see.

In Motive, the Application Settings can be accessed under the View tab or by clicking icon on the main toolbar.

Default Application Settings can be recovered by Reset Application Settings under the Edit Tools tab from the main Toolbar.

Live Reconstruction

Reconstruction tab contains a list of parameters for the real-time Point Cloud reconstruction engine.

Reconstruction in motion capture is a process of deriving 3D points from 2D coordinate information obtained from captured images, and the Point Cloud is the core engine that runs the reconstruction process. The reconstruction settings in the Application Settings modifies the engine's parameters for real-time reconstructions. These settings can be modified to optimize the quality of reconstructions in Live mode depending on the conditions of the capture and what you're trying to achieve. Use the 2D Mode to live-monitor the reconstruction outcomes from the configured settings.

General

Misc

Take Suffix Format String

Sets the separator (_) and string format specifiers (%03d) for the suffix added after existing file names.

Numeric LEDs

Enable or disable the LED panel in front of cameras that displays assigned camera numbers.

Auto Archive Takes

Enable/Disable auto-archiving of Takes when trimming Takes

Save Data Folder

Motive persists all of the session folders that are imported into the Data pane so that the users don't have to re-import them again after closing out of the application. If this is set to false, the session folders will no longer be persisted, and only the default session folder will always be loaded.

Startup Options

Restore Calibration

Automatically loads the previous, or last saved, calibration setting when starting Motive.

Camera ID

Sets how Camera IDs are assigned for each camera in a setup. Available options are By Location and By Serial Number. When assigning by location, camera IDs will be given following the positional order in clockwise direction, starting from the -X and -Z quadrant in respect to the origin.

Device Profile

Sets the default device profile, XML format, to load onto Motive. The device profile determines and configures the settings for peripheral devices such as force plates, NI-DAQ, or navigation controllers.

Aim Assist Button

Switch to MJPEG

Configures the Aim Assist button. Sets whether the button will switch the camera to MJPEG mode and back to the default camera group record mode. Valid options are: True (default) and False.

Aiming Crosshairs

Sets whether the camera button will display the aiming crosshairs on the MJPEG view of the camera. Valid options are True (default), False.

Aiming Button LED

Enables or disables LED illumination on the Aim Assist button behind Prime Series cameras.

Camera Status Ring

Controls the color of the RGB Status Indicator Ring (Prime Series cameras only). Options include distinct indications for Live, Recording, Playback, Selection and Scene camera statuses, and you can choose the color for the corresponding camera status.

Live Color

(Default: Blue) Sets the indicator ring color for cameras in Live mode. Default: Blue

Recording Color

(Default: Red) Sets the indicator ring color for cameras when recording a capture.

Playback Color

(Default: Black) Sets the indicator ring color for cameras when Motive is in playback mode.

Selection Color

(Default: Yellow) Sets the indicator ring color for cameras that are selected in Motive.

Scene Camera

(Default: Orange) Sets the indicator ring color for cameras that are set as the reference camera in Motive.

Networking

LLDP (PoE+) Detection

Enables detection of PoE+ switches by High Power cameras (Prime 17W and Prime 41). LLDP allows the cameras to communicate directly with the switch and determine power availability to increase output to the IR LED rings. When using Ethernet switches that are not PoE+ Enabled or switches that are not LLDP enabled, cameras will not go into the high power mode even with this setting enabled.

Strobe On During Playback

Keeps the camera IR strobe on at all times, even during the playback mode.

In Motive, the Application Settings can be accessed under the View tab or by clicking icon on the main toolbar. Default Application Settings can be recovered by Reset Application Settings under the Edit Tools tab from the main Toolbar.

Mouse

Customizing Mouse Actions

The Mouse tab under the application settings is where you can check and customize the mouse actions to navigate and control in Motive.

Basic Controls

The following table shows the most basic mouse actions:

Preset Profile

You can also pick a preset mouse action profiles to use. The presets can be accessed from the below drop-down menu. You can choose from the provided presets, or save out your current configuration into a new profile to use it later.

Keyboard

Customizing Hotkeys

The Keyboard tab under the application settings allows you to assign specific hotkey actions to make Motive easier to use. List of default key actions can be found in the following page also: Motive Hotkeys

Hotkey Profiles

Configured hotkeys can be saved into preset profiles to be used on a different computer or to be imported later when needed. Hotkey presets can be imported or loaded from the drop-down menu:

In Motive, the Application Settings can be accessed under the View tab or by clicking icon on the main toolbar.

Default Application Settings can be recovered by Reset Application Settings under the Edit Tools tab from the main Toolbar.

Overview

The Application Settings consists of several tabs, all of which we'll go into further details on their respective pages. Below is the list of the Application Settings tabs in Motive 2.3.

Live Reconstruction

General

Views

Skeletons

Rigid Bodies

Cameras

Overview

In Live Mode

In Edit Mode

Timeline Frame Range Indicator

• Scrubber: Current frame.

• Green: Working frame range.

• Yellow: Selected frame range.

Live and Edit mode

There are two different modes in Motive: Live mode and Edit mode. You can toggle between two modes from the Control Deck or by using the (~) hotkey.

Live Mode

The Live mode is mainly used when recording new Takes or when streaming a live capture. In this mode, all of the cameras are continuously capturing 2D images and reconstructing the detected reflections into 3D data in real-time.

Edit Mode

The Edit Mode is used for playback of captured Take files. In this mode, you can playback, or stream, recorded data. Also, captured Takes can be post-processed by fixing mislabeling errors or interpolating the occluded trajectories if needed.

Status Monitor

Located on the right corner of the control deck, the status monitor can be used to monitor specific operational parameters in Motive. Click on up/down arrows to switch the displayed status. You can also click on the status monitor to open a popup for displaying all available status.

The following status parameters will be available:

Status Definitions

Residual

Data

Current incoming data transfer rate (KB/s) for all attached cameras.

Point Cloud

Measured latency of the point cloud reconstruction engine.

Rigid Body

Measured latency of the rigid body solver.

Skeleton

Measured latency of the skeleton solver.

Software

Measured software latency. It represents the amount of time it takes Motive to process each frame of captured data. This includes the time taken for reconstructing the 2D data into 3D data, labeling and modeling the trackable assets, displaying in the viewport, and other processes configured in Motive.

System

Available only on Ethernet Camera systems (Prime series and Slim13E). Measured total system latency. This is the time measured from the middle of the camera exposures to when Motive has fully solved all of the tracking data.

Streaming

The rate at which the tracking data is streamed to connected client applications.

Cameras

Available only on Ethernet Camera systems (Prime series or Slim 13E). Average temperature, in Celsius, on the imager boards of the cameras in the system.

Notifications

Overview

The Assets tab in the application settings panel is where you can configure the creation properties for Rigid Body and Skeleton assets. In other words, all of the settings configured in this tab will be assigned to the Rigid Body and Skeleton that are newly created in Motive.

Rigid Bodies Basic Settings

Rigid Body Creation Properties

Default Name (Default: RigidBody)

You can change the naming convention of Rigid Bodies when they are first created. For instance, if it is set to RigidBody, the first Rigid Body will be named RigidBody when first created. Any subsequent Rigid Bodies will be named RigidBody 001, RigidBody 002, and so on.

Streaming ID

User definable ID. When streaming tracking data, this ID can be used as a reference to specific Rigid Body assets.

Minimum Markers to Boot

The minimum number of markers that must be labeled in order for the respective asset to be booted.

Minimum Markers to Continue

The minimum number of markers that must be labeled in order for the respective asset to be tracked.

Smoothing

Applies double exponential smoothing to translation and rotation. Disabled at 0.

Forward Prediction

Compensate for system latency by predicting movement into the future.

Visuals

Label

Toggle 'On' to enable. Displays asset's name over the corresponding skeleton in the 3D viewport.

Creation Color

Select the default color a Rigid Body will have upon creation. Select 'Rainbow' to cycle through a different color each time a new Rigid Body is created.

Bone Position History

When enabled this shows a visual trail behind a Rigid Body's pivot point. You can change the History Length, which will determine how long the trail persists before retracting.

Visual

Shows a Rigid Body's visual overlay. This is by default Enabled. If disabled, the Rigid Body will only appear as individual markers with the Rigid Body's color and pivot marker.

Bones

When enabled for Rigid Bodies, this will display the Rigid Body's pivot point.

Asset Model Markers

Shows the transparent sphere that represents where an asset first searches for markers, i.e. the asset model marker.

Replace Geometry

When enabled and a valid geometric model is loaded, the model will draw instead of the Rigid Body.

Rigid Bodies Advanced Settings

Rigid Body Creation Properties

Deflection Ratio

Allows the asset to deform more or less to accommodate markers that don't fix the model. High values will allow assets to fit onto markers that don't match the model as well.

Skeletons Basic Settings

Skeleton Creation Properties

Straight Arms

Creates the Skeleton with arms straight even when arm markers are not straight.

Straight Legs

Creates the Skeleton with straight knee joints even when leg markers are not straight.

Feet On Floor

Creates the Skeleton with feet planted on the ground level.

Head Upright

Creates the Skeleton with heads upright irrespective of head marker locations.

Height Marker

Force the solver so that the height of the created Skeleton aligns with the top head marker.

Vertical Hand Adjustment

Height offset applied to hands to account for markers placed above the write and knuckle joints.

Visuals

Same as the Rigid Body visuals above:

• Label

• Creation Color

• Bones

• Asset Model Markers

Quality Visual

Changes the color of the skeleton visual to red when there are no markers contributing to a joint.

Skeleton Advanced Settings

Visuals

Bone Orientation

Display Coordinate axes of each joint.

Asset Model Lines

Displays the lines between labeled skeleton markers and corresponding expected marker locations.

Marker Lines

Displays lines between skeleton markers and their joint locations.

The Assets pane in Motive lists out all of the assets involved in the Live, or recorded, capture and allows users to manage them. This pane can be accessed under the in Motive or by clicking icon on the main toolbar.

Overview

Assets (Current Take)

A list of all assets associated with the take is displayed in the Assets pane. Here, view the assets and you can right click on an asset to export, remove, or rename selected asset from the current take.

Context Menu Options

All Assets

Export Rigid Body / Export Skeleton

Exports selected rigid body into Motive trackable files (TRA). Exports selected skeleton into either Motive skeleton file (SKL) or a FBX file.

Remove Asset

Removes the selected asset from a project.

Rename Asset

Renames the selected asset.

For Skeleton Assets

Export Markers

Rename Markers

Imports skeleton marker template XML file onto the selected asset. If you wish to apply the imported XML for labeling, all of the skeleton markers need to be unlabeled and auto-labeled again.

Update Markers

Recalibrate From Markers

For Marker Sets

Generate Markers

The Devices pane can be accessed under the View tab in Motive or by clicking icon on the main toolbar.

Overview

In Motive, all of the connected devices get listed in the Devices pane, including tracking cameras, synchronization hubs, color reference cameras, and other supported peripheral devices such as force plates and data acquisition devices. Using this pane, core settings of each component can be adjusted; which includes sampling rates and camera exposures. Cameras can be grouped to control the system more quickly. You can also select individual devices to view and modify their properties in the . Lastly, when specific devices are selected in this pane, their respective properties will get listed under , where you can also make changes to the settings.

Interface

At the very top of the devices pane, the master camera system frame rate is indicated. All synchronized devices will be capturing at a whole multiple or a whole divisor of this master rate.

Camera Framerate

The master camera frame rate is indicated at top of the Devices pane. This rate sets the framerate which drives all of the tracking cameras. If you wish to change this, you can simply click on the rate to open the drop-down menu and set the desired rate.

Device Group

By clicking on the down-arrow button under the camera frame rate, you can expand list of grouped devices. At first, you may not have any grouped devices. To create new groups, you can select multiple devices that are listed under this panel, right-click to bring up the context menu, and create a new group. Grouping the cameras allows easier control over multiple devices in the system.

Tracking Cameras

Under the tracking cameras section, it lists out all of the motion capture cameras connected to the system. Here, you can configure and control the cameras. You can right-click on the camera setting headers to show/hide specific camera settings and drag them around to change the order. When you have multiple cameras selected, making changes to the settings will modify them for all of the selected cameras. You can also group the cameras to easily select and change the settings quickly. The configurable options include:

• Framerate multiplier

• Exposure length (microseconds)

• IR LED ring on/off

• Real-time reconstruction contribution

• Imager Gain

• IR Filter on/off

Settings

Multiplier

Mode

Exposure

Sets the amount of time that the camera exposes per frame. The minimum and maximum values will depend on both the type of camera and the frame rate. Higher exposure will allow more light in, creating a brighter image that can increase visibility for small and dim markers. However, setting exposure too high can introduce false reflections, larger marker blooms, and marker blurring--all of which can negatively impact marker data quality.

LED

This setting enables or disables illumination of the LEDs on the camera IR LED ring. In certain applications, you may want to disable this setting to stop the IR LEDs from strobing. For example, when tracking active IR LED markers, there is no need for the cameras to emit IR lights, so you may want to disable this to stop the IR illuminations which may introduce additional noise in the data.

The IR intensity setting is now a on/off setting. Please adjust the exposure setting to adjust the brightness of the image in the IR spectrum.

Reconstruction

In most applications, you can have all of the cameras contributing to the 3D reconstruction engine without any problem. But for a very high-camera count systems, having all camera to contribute to the reconstruction engine can slow down the real-time processing of point cloud solve and result in dropped frames. In this case, you can have a few cameras disabled from real-time reconstruction to prevent frame drops and use the collected 2D data later in post-processing.

Gain

Increasing a camera’s gain will brighten the image, which can improve tracking range at very long distances. Higher gain levels can introduce noise into the 2D camera image, so gain should only be used to increase range in large setup areas, when increasing exposure and decreasing lens f-stop does not sufficiently brighten up the captured image.

IR Filter

Sets the camera to view either visible or infrared light on cameras equipped with a Filter Switcher. Infrared Spectrum should be selected when the camera is being used for marker tracking applications. Visible Spectrum can optionally be selected for full frame video applications, where external, visible spectrum lighting will be used to illuminate the environment instead of the camera’s IR LEDs. Common applications include reference video and external calibration methods that use images projected in the visible spectrum.

Color Cameras

Image Resolution

This property sets the resolution of the images that are captured by selected cameras. Since the amount of data increases with higher resolution, depending on which resolution is selected, the maximum frame rate allowed by the network bandwidth will vary.

Bit-rate

Bit-rate setting determines the transmission rate outputted from the selected color camera. This is how you can control the data output from color cameras to avoid overloading the camera network bandwidth. At a higher bit-rate setting, more amount of data is outputted and the image quality is better since there is less amount of image compression being done. However, if there is too much data output, it may overload the network bandwidth and result in frame drops. Thus, it is best to minimize this while keeping the image quality at a acceptable level.

Sync Hub

Force Plates / Data Acquisition

Detected force plates and NI-DAQ devices will get listed under the Devices pane as well. You can apply multipliers to the sampling rate if the they are synchronized through trigger. If they are synchronized via a reference clock signal (e.g. Internal Clock), their sampling rate will be fixed to the rate of that signal.

This section of the application settings is used for configuring the properties for all of the cameras in the tracking group. The settings include display options, masking properties, but most importantly, the 2D Filter settings for the camera system which basically determines which reflections are considered as marker reflections from the camera view.

Filters (2D Object Filter)

Filter Type

Default: Size and RoundnessToggles 2D object (Size and Roundness) filtering on or off.This filter is very useful for filtering out extraneous reflections according to their characteristics (size and roundness) rather than blocking pixels using the masking tool or the Block Visible feature. Turn off this setting only when you want to use every 2D pixels above the brightness threshold from camera views. When there are extraneous or flickering reflections in the view, turn on the filter to specify and consider reflections only from markers. There are multiple filtering parameters to distinguish the marker reflections. Given that there are assumed marker characteristics, filtering parameters can be set. The size parameters can be defined to filter out extra-small or extra-large reflections that are most likely from extraneous sources other than markers. Non-circular reflections can be ignored assuming that all reflective markers have circular shapes. Note that even when applying the size and roundness filter, you should always Block Visible when you calibrate.

Min Thresholded Pixels (pixels)

Default: 4 pixelsThe minimum pixel size of a 2D object, a collection of pixels grouped together, for it to be included in the Point Cloud reconstruction. All pixels must first meet the brightness threshold defined in the Cameras pane in order to be grouped as a 2D object. This can be used to filter out small reflections that are flickering in the view. The default value for the minimum pixel size is 4, which means that there must be 4 or more pixels in a group for a ray to be generated.

Max Thresholded Pixels (pixels)

Default: 2000 pixelsThe maximum size of a 2D object, in pixels, in order for it to be included in point cloud reconstruction. Default is 2000 pixels which basically means that all of detected large reflections smaller than 2000 pixel-size will be included as a 2D object. Use this to filter out larger markers in a variable marker capture. For instance, if you have 4 mm markers on an actor's face and 14 mm markers on their body, use this setting to filter out the larger markers if the need arises.

Circularity

Default: 0.6This setting sets the threshold of the circularity filter. Valid range is between 0 and 1; with 1 being a perfectly round reflection and 0 being flat. Using this 2D object filter, the software can identify marker reflections using the shape, specifically the roundness, of the group of thresholded pixels. Higher circularity setting will filter out all other reflections that are not circular. It is recommended to optimize this setting so that extraneous reflections are efficiently filtered out while not filtering out the marker reflections. When using lower resolution cameras to capture smaller markers at a long distance, the marker reflection may appear to be more pixelated and non-circular. In this case, you may need to lower the circularity filter value for the reflection to be considered as a 2D object from the camera view. Also, this setting may need to be lowered when tracking non-spherical markers in order to avoid filtering the reflections.

Intrusion Band

Default: 0.5 (Pixels)The intrusion band feature allows cameras to recognize reflections that are about to be merged and filter them out before it happens. This filter occurs before the circularity filter, and these reflections are rejected before the thresholded pixels merge. This is useful for improving the accuracy of the tracking, because bright pixels from close by reflections may slightly shift the centroid locations. The intrusion band value is added to the calculated radius of detected markers to establish a boundary, and any extraneous reflections intruding the boundary is considered as the intrusion and gets omitted. When an intrusion happens, both intruding reflection and detected marker reflection will be filtered out.

Garyscale Floor

Default: 48The grayscale floor setting further darkens pixels with lower brightness intensity values.

Object Margin

Default: 2 (Pixels)The object margin adds an additional margin on top of the intrusion band for filtering out merged reflections. Lowering this value will better detect close-by reflections, but may decrease the accuracy of the centroid positions as a tradeoff.

Display Options

Name

Sets the name for the selected camera group.

Camera Color

Sets the color for camera group members as they appear in the 3D viewport. Color values are input as standard RGB triplets.

Visible Cameras

Selects whether cameras in the group are displayed in the viewport.

Show All Color Camera

Show Capture Volume

Selects whether the capture volume (defined as capable of tracking a single marker) is displayed in the viewport. Enabling this will allow the volume to be displayed as a wire cage around the ground plane where multiple cameras fields of view intersect. Valid options are True, False (default).

Camera Overlap

Sets the minimum camera overlap necessary for a region to be visualized as part of the capture volume. Higher numbers represent more camera coverage, but they will tend to reduce the size of the visualized capture volume. Valid range is 1 to 25 (default 3).

Volume Resolution

Sets the resolution of the capture volume visualization. A higher number represents a more detailed visualization. Valid range is 1 to 120 (default 50).

FOV Intensity

Sets the opacity of the FOV visualization. A higher value represents a more opaque volume visualization. Valid range is 1 to 100 (default 50).

Opacity

Sets the opacity of the volume visualization. A value of 1 is transparent and 100 is opaque. Valid range is 1 to 100 (default 100).

Advanced

Synchronization Control

Determines how late camera frames are dealt with. Timely Delivery will drop late frames, which is ideal for real-time applications where data completeness is secondary to timeliness. Complete Delivery will hold up processing of frames when a frame is late. Automatic, which is the default and recommended setting, runs in Timely Delivery mode until it gets a non-trivial percentage of late frames, at which point it will automatically switch to Complete Delivery.

Shutter Offset

Delays the shutter timing of selected tracking camera group for N microseconds.

Mask Regions

Mask Width (pixels)

Sets the extra pixel coverage (width) for masking visible markers when the mask visible function is used. A larger number will block a wider grouping of pixels simultaneously. Valid range is determined by the resolution of the cameras.

Mask Height (pixels)

Sets the extra pixel coverage (height) for masking visible markers when the mask visible function is used. A larger number will block a wider grouping of pixels simultaneously. Valid range is determined by the resolution of the cameras.

Overview

The Builder pane is used for creating and editing trackable models, also called trackable assets, in Motive. In general, rigid body models are created for tracking rigid objects, and skeleton models are created for tracking human motions.

When created, trackable models store the positions of markers on the target object and use the information to auto-label the reconstructed markers in 3D space. During the auto-label process, a set of predefined labels gets assigned to 3D points using the labeling algorithms, and the labeled dataset is then used for calculating the position and orientation of the corresponding rigid bodies or skeleton segments.

The trackable models can be used to auto-label the 3D capture both in Live mode (real-time) and in the Edit mode (post-processing). Each created trackable models will have its own properties which can be viewed and changed under the . If new skeletons or rigid bodies are created during post-processing, the Take will need to be auto-labeled again in order to apply the changes to the 3D data.

Interface Overview

On the Builder pane, you can either create a new trackable asset or modify an existing one. Select either rigid body or skeleton at the bottom of the pane, and then select whether you wish to create or edit. Each feature will be explained in the sections below.

Rigid Body: Create

For creating rigid bodies, select the rigid body option at the bottom and access the Create tab at the top. Here, you can create rigid body asset and track any markered-objects in the volume. In addition to standard rigid body assets, you can also create rigid body models for head-mounted displays (HMDs) and measurement probes as well.

Creating Rigid Body

Step 1.

Step 2.

On the Builder pane, confirm that the selected markers match the markers that you wish to define the rigid body from.

Step 3.

Click Create to define a rigid body asset from the selected markers.

Step 4.

Creating HMD Rigid Body

For using OptiTrack system for VR applications, it is important that the pivot point of HMD rigid body gets placed at the appropriate location, which is at the root of the nose in between the eyes. When using the HMD clips, you can utilize the HMD creation tools in the Builder pane to have Motive estimate this spot and place the pivot point accordingly. It utilizes known marker configurations on the clip to precisely positions the pivot point and sets the desired orientation.

Steps

3. Under the Type drop-down menu, select HMD. This will bring up the options for defining an HMD rigid body.

4. If the selected marker matches one of the Active clips, it will indicate which type of Active Clip is being used.

6. Hold the HMD at the center of the tracking volume where all of the active markers are tracked well.

8. Click Create. An HMD rigid body will be created from the selected markers and it will initiate the calibration process.

9. During calibration, slowly rotate the HMD to collect data samples in different orientations.

10. Once all necessary samples are collected, the calibrated HMD rigid body will be created.

Creating Measurement Probe Rigid Body

For using OptiTrack system for VR applications, it is important that the pivot point of HMD rigid body gets placed at the appropriate location, which is at the root of the nose in between the eyes. When using the HMD clips, you can utilize the HMD creation tools in the Builder pane to have Motive estimate this spot and place the pivot point accordingly. It utilizes known marker configurations on the clip to precisely place the pivot point set the desired orientation.

Steps: Probe Calibration

3. Under the Type drop-down menu, select Probe. This will bring up the options for defining a rigid body for the measurement probe.

4. Select the rigid body created in step 2.

5. Place and fit the tip of the probe in one of the slots on the provided calibration block.

6. Note that there will be two steps in the calibration process: refining rigid body definition and calibration of the pivot point. Click Create button to initiate the probe refinement process.

7. Slowly move the probe in a circular pattern while keeping the tip fitted in the slot; making a cone shape overall. Gently rotate the probe to collect additional samples.

8. After the refinement, it will automatically proceed to the next step; the pivot point calibration.

9. Repeat the same movement to collect additional sample data for precisely calculating the location of the pivot or the probe tip.

10. When sufficient samples are collected, the pivot point will be positioned at the tip of the probe and the Mean Tip Error will be displayed. If the probe calibration was unsuccessful, just repeat the calibration again from step 4.

Steps: Sample Collection

2. Place the probe tip on the point that you wish to collect.

3. Click Take Sample on the Measurement pane.

4. A virtual reconstruction will be created at the point, and the corresponding information will be displayed over the measurement pane. The sampled points will also be saved in the exported onto the project directory.

5. Collecting additional samples will provide distance and angles between collected samples.

Sampling 3D points using the measurement probe.

Rigid Body: Edit

Using the Builder pane, you can also modify existing rigid body assets. For editing rigid bodies, select the rigid body option at the bottom of the Builder pane and access the Edit tab at the top. This will bring up the options for editing a rigid body.

Refine

Using the Rigid Body Refinement tool for improving asset definitions.

This feature is supported in Live Mode only.

Rigid body refinement tool improves the accuracy of rigid body calculation in Motive. When a rigid body asset is initially created, Motive references only a single frame for defining the rigid body definition. The rigid body refinement tool allows Motive to collect additional samples in the live mode for achieving more accurate tracking results. More specifically, this feature improves the calculation of expected marker locations of the rigid body as well as position and orientation of the rigid body itself.

Steps

2. Select the Rigid Bodies option at the bottom of the pane and go to the Edit tab.

4. Hold the selected rigid body at the center of the capture volume so that as many cameras as possible can clearly capture the markers on the rigid body.

5. Press Start Refine in the Builder pane and the

6. Slowly rotate the rigid body to collect samples at different orientations.

7. Once all necessary samples are collected, the refinement results will be displayed.

Probe Calibration

The Probe Calibration feature under the rigid body edit options can be used to re-calibrate a pivot point of a measurement probe or a custom rigid body. This step is also completed as one of the calibration steps when first creating a measurement probe, but you can re-calibrate it under the Edit tab.

Steps

1. In Motive, select the rigid body or a measurement probe.

2. Bring out the probe into the tracking volume where all of its markers are well-tracked.

3. Place and fit the tip of the probe in one of the slots on the provided calibration block.

4. Click Start

5. Once it starts collecting the samples, slowly move the probe in a circular pattern while keeping the tip fitted in the slot; making a cone shape overall. Gently rotate the probe to collect additional samples.

6. When sufficient samples are collected, the mean error of the calibrated pivot point will be displayed.

7. Click Apply to use the calibrated definition or click Cancel to calibrate again.

Location/Orientation

Options for translating and rotating the rigid body pivot point.

The Edit tab is used to apply translation or rotation to the pivot point of a selected rigid body. A pivot point of a rigid body represents both position (x, y, z) and orientation (pitch, roll, yaw) of the corresponding asset.

Location

Use this tool to translate a pivot point in x/y/z axis (in mm). You can also reset the translation to set the pivot point back at the geometrical center of the rigid body.

Orientation

Use this tool to apply rotation to the local coordinate system of a selected rigid body. You can also reset the orientation to align the rigid body coordinate axis and the global axis.When resetting the orientation, the rigid body must be tracked in the scene.

OptiTrack Clip Tool

The OptiTrack Clip Tool basically recalibrates HMDs with OptiTrack HMD Clips to position its pivot point at an appropriate location. The steps are basically the same as when first creating the HMD rigid body.

Spherical Pivot Placement

This feature is useful when tracking a spherical object (e.g. ball). It will assume that all of the markers on the selected rigid body are placed on a surface of a spherical object, and the pivot point will be calculated and re-positioned accordingly. Simply select a rigid body in Motive, open the Builder pane to edit rigid body definitions, and then click Apply to place the pivot point at the center of the spherical object.

Skeleton: Create

Creating Skeleton

Defining skeleton from a skeleton Marker Set.

Step 1.

From the skeleton creation options on the Builder pane, select a skeleton marker set from the Marker Set drop-down menu. This will bring up a skeleton avatar displaying where the markers need to be placed on the subject.

Step 2.

Step 3.

Step 4.

In the Builder pane, make sure the numbers under the Markers Needed and Markers Detected sections are matching. If the skeleton markers are not automatically detected, manually select the skeleton markers from the 3D perspective view.

Step 5.

Step 6.

Next step is to select the skeleton creation pose settings. Under the Pose section drop-down menu, select the desired calibration post you want to use for defining the skeleton. This is set to the T-pose by default.

Step 7.

Step 8.

Click Create to create the skeleton. Once the skeleton model has been defined, confirm all skeleton segments and assigned markers are located at expected locations. If any of the skeleton segment seems to be misaligned, delete and create the skeleton again after adjusting the marker placements and the calibration pose.

Skeleton: Edit

To create skeletons in Motive, you need to select the skeleton option at the bottom of the Builder pane and access the Edit tab at the top.

Recalibrate From Markers

Existing skeleton assets can be recalibrated using the existing skeleton information. Basically, the recalibration recreates the selected skeleton using the same skeleton markerset. This feature recalibrates the skeleton asset and refreshes expected marker locations on the assets.

The Data pane is used for managing the Take files. This pane can be accessed under the in Motive or by clicking the icon on the main toolbar.

Overview

Pane menu

List of Session Folders

Action Items

Context Menu Options

Set as Current

Set the selected session as the current session.

Rename

Rename the session folder.

Create Sub-folder

This creates a folder under the selected directory.

Show Folder Location

Opens the session folder from the file explorer

Delete

Delete the session folder. All of its contents will be deleted as well.

List of Takes

When a session folder is selected, associated Take files and their descriptions are listed in a table format on the right-hand side of the Data pane. For each Take, general descriptions and basic information are shown in the columns of the respective row. To view additional descriptions, click on the pane menu, select the Advanced option, and all of the descriptions will be listed. For each of the enabled columns, you can click on the arrow next to it to sort up/down the list of Takes depending on the category.

Take Information

Search Bar

A search bar is located at the bottom of the Data pane, and you can search a selected session folder using any number of keywords and search filters. Motive will use the text in the input field to list out the matching Takes from the selected session folder. Unless otherwise specified, the search filter will scope to all of the columns.

Search for exact phrase

• Wrap your search text in quotation marks.

• e.g. Search "shooting a gun" for searching a file named Shooting a Gun.tak.

Search specific fields

• To limit the search to specific columns, type field:, plus the name of a column enclosed with quotation marks, and then the value or term you're searching for.

• Multiple fields and/or values may be specified in any order.

• e.g. field:"name" Lizzy, field:"notes" Static capture.

Search for true/false values

• To search specific binary states from the Take list, type the name of the field followed by a colon (:), and then enter either true ([t], [true], [yes], [y]) or false ([f], [false], [no], [n]).

• e.g. Best:[true], Solved:[false], Video:[T], Analog:[yes]

Customizing Table Layout

The table layout can also be customized. To do so, go to the pane menu and select New or any of the previously customized layouts. Once you are in a customizable layout, right-click on the top header bar and add or remove categories from the table.

Importing a List of Empty Takes

A list of take names can be imported from either a CSV file or carriage return texts that contain a take name on each line. Using this feature, you can plan, organize, and create a list of capture names ahead of actual recording. Once take names have been imported, a list of empty takes with the corresponding names will be listed for the selected session folder.

From a Text

Take lists can be imported by copying a list of take names and pasting them onto the Data pane. Take names must be separated by carriage returns; in other words, each take name must be in a new line.

From a CSV File

Take Menu

Context Menu Options

Save

Saves the selected take

Revert

Reverts any changes that were made. This does not work on the currently opened Take.

Make Current

Selects the current take and loads it for playback or editing.

Rename

Allows the current take to be renamed.

Show File Location

Opens an explorer window to the current asset path. This can be helpful when backing up, transferring, or exporting data.

Reconstruct

Separate reconstruction pipeline without the auto-labeling process. Reconstructs 3D data using the 2D data.

Auto-label

Separate auto-labeling pipeline that labels markers using the existing tracking asset definitions. Available only when 3D data is reconstructed for the Take.

Reconstruct and Auto-label

Combines 2D data from each camera in the system to create a usable 3D take. It also incorporates assets in the Take to auto-label and create rigid bodies and skeletons in the Take. Reconstruction is required in order to edit or export the skeleton or the rigid body data in the Take.

Solve All Assets

Solves 6 DoF tracking data of skeletons and rigid bodies and bakes them into the TAK recording. When the assets are solved, Motive reads from recorded Solve instead of processing the tracking data in real-time.

Reconstruct, Auto-label, and Solve

Performs all three reconstruct, auto-label, and solve pipelines in consecutive order. This basically recreates 3D data from recorded 2D camera data.

Export Tracking Data

Opens the Export dialog window to select and initiate file export. Valid formats for export are CSV, C3D, FBX, BVH.

Export Video

Opens the export dialog window to initiate scene video export to AVI.

Export Audio

Exports an audio file when selected Take contains audio data.

Delete 2D / Video / Audio Data

Delete 3D Data

Permanently deletes the 3D data from the take. This option is useful in the event reconstruction or editing causes damage to the data.

Delete Marker Labels

Unlabels all existing marker labels in 3D data. If you wish to re-auto-label markers using modified asset definitions, you will need to first unlabel markers for respective assets.

Delete All Solved Asset Data

Deletes 6 DoF tracking data that was solved for skeleton and rigid bodies. If Solved data doesn't exist, Motive instead calculates tracking of the objects from recorded 3D data in real-time.

Archive Take

Archives the original take file and creates a duplicate version, minus any 3D data. Archiving a take will reduce size of the active take file while preserving the 2D camera data in a backup sub-directory for later use, if necessary.

Delete Takes

Opens a dialog box to confirm permanent deletion of the take and all associated 2D, 3D, and Joint Angle Data from the computer. This option cannot be undone.

Delete All Assets from Take

Deletes all assets that were recorded in the take.

Copy Assets to Take

Copies the assets from the current capture to the selected Takes.

The Info pane in Motive displays real-time tracking information of a rigid body selected in Motive. This pane can be accessed under the View tab in Motive or by clicking icon on the main toolbar. This pane lists out real-time tracking information for a selected rigid body in Motive. Reported data includes a total number of tracked rigid body markers, mean errors for each of them, and the 6 Degree of Freedom (position and orientation) tracking data for the rigid body.

The Graph View pane is used to visualize the tracking data in Motive. This pane can be accessed from the command bar (View tab > Graph) or simply by clicking on the icon. This page provides instructions and tips on how to efficiently utilize the Graph View pane in Motive.

Overview

Using the Graph View pane, you can visualize and monitor multiple data channels including 3D positions of reconstructed markers, 6 Degrees of Freedom (6 DoF) data of trackable assets, and signals from integrated external devices (e.g. force plates or NI-DAQ). Graph View pane offers a variety of graph layouts for the most effective data visualization. In addition to the basic layouts (channel, combined, gapped), custom layouts can also be created for monitoring specific data channels only. Up to 9 graphs can be plotted in each layout and up to two panes can be opened simultaneously in Motive.

Graphs can be plotted in both Live and Edit mode.

• In Live Mode, the following data can be plotted in real-time:

  • Rigid body 6 DoF data (Position and Orientation)

  • Force Plate Data (Force and Moment)

  • Analog Data

• In Edit Mode, the graphs can be used to review and post-process the captured data:

  • 3D Positions of reconstructed markers

  • Rigid body 6 DoF data (Position and Orientation)

  • Force Plate Data (Force and Moment)

  • Analog Data

Toolbar

Pane Menu Options

Create Layout

Creates a new graph layout.

Delete Layout

Deletes current graph layout.

Update Layout

Saves the changes to the graph layout XML file.

Particularize Layout

Takes an XML snapshot of the current graph layout. Once a layout has been particularized, both the layout configuration and the item selection will be fixed and it can be exported and imported onto different sessions.

Edit Layout

Opens the layout XML file of the current graph layout for editing.

Show Layout

Opens the file location of where the XML files for the graph layouts are stored.

Graph Navigation

Basic Navigation

On the Graph

Navigate Frames (Alt + Left-click + Drag)

Alt + left-click on the graph and drag the mouse left and right to navigate through the recorded frames. You can do the same with the mouse scroll as well.

Panning (Scroll-click + Drag)

Scroll-click and drag to pan the view vertically and horizontally throughout plotted graphs. Dragging the cursor left and right will pan the view along the horizontal axis for all of the graphs. When navigating vertically, scroll-click on a graph and drag up and down to pan vertically for the specific graph.

Zooming (Right-click + Drag)

Selecting Frame Range (Left-click + Drag)

The frame range selection is used when making post-processing edits on specific ranges of the recorded frames. Select a specific range by left-clicking and dragging the mouse left and right, and the selected frame ranges will be highlighted in yellow. You can also select more than one frame ranges by shift-selecting multiple ranges.

On the Navigation Bar

Navigate Frames (Left-click)

Left-click and drag on the nav bar to scrub through the recorded frames. You can do the same with the mouse scroll as well.

Pan View Range

Scroll-click and drag to pan the view range range.

Frame Range Zoom

Zoom into a frame range by re-sizing the scope range using the navigation bar handles. You can also easily do this by Alt + right-clicking on the graph and selecting a specific range to zoom into.

Navigation Bar

Working Range / Playback range

The working range (also called the playback range) is both the view range and the playback range of a corresponding Take in Edit mode. Only within the working frame range, recorded tracking data will be played back and shown on the graphs. This range can also be used to output a specific frame ranges when exporting tracking data from Motive.

The working range can be set from different places:

• In the navigation bar of the Graph View pane, you can drag the handles on the scrubber to set the working range.

• You can also use the navigation controls on the Graph View pane to zoom in or zoom out on the frame ranges to set the working range.

• Start and end frames of a working range can also be set from the Control Deck when in the Edit mode.

Selection Range

The selection range is used to apply post-processing edits only onto a specific frame range of a Take. Selected frame range will be highlighted in yellow on both Graph View pane as well as Timeline pane.

Gap indication

When playing back a recorded capture, the red colors on the navigation bar indicate the amount of occlusions from labeled markers. Brighter red means that there are more markers with labeling gaps.

Frame Range Selection

Left-click and drag on the graph to select a specific frame range. Frame range selection can be utilized for the following workflows:

• Tracking Data Export: Exporting tracking data for selected frame ranges.

• Reconstruction: Performing the post-processing reconstruction (Reconstructing / Reconstruct and Auto-labeling) pipeline on selected frame ranges.

• Labeling: Assigning marker labels, modifying marker labels, or running the auto-label pipeline on selected ranges only.

• Post-processing data editing: Applying the editing tools on selected frame ranges only. Read more: Data Editing

• Data Deleting: Deleting 3D data or marker labels on selected ranges.

Layouts

System Layouts

The layouts feature in the Graphs View pane allows users to organize and format graph(s) to their preference. The graph layout is selected under the drop-down menu located at top-right corner of the Graph View pane.

In addition to default graph layouts (channels view, combined view, and tracks view) which have been migrated from the previous versions of Motive, custom layouts can also be created. With custom layouts, users can specify which data channels to plot on each graph, and up to 9 graphs can be configured on each layout. Furthermore, asset selections can be locked to labeled markers or assets.

Channel View

The Channel View provides X/Y/Z curves for each selected marker, providing verbose motion data that highlights gaps, spikes, or other types of noise in the data.

Combined View

The Combined View provides X/Y/Z curves for each selected markers at same plot. This mode is useful for monitoring positions changes without having to translate or rescale the y-axis of the graph.

Tracks View

Custom Layouts

Graph layout customization is further explained on the later section: Customizing Layout.

Customizing Graph Layout

General Steps

Step 1. Create New Layout

Step 2. Set the number of graphs

Right-click on the graph, go to the Grid Layout, and choose the number of rows and columns that you wish to put in the grid. (max 9 x 9)

Step 3. Open the Graph Editor

Step 4. Select a graph

Click on a graph from the grid. The graph will be highlighted in yellow. Within the grid, only the selected graph will be edited when making changes using the Graph Editor.

Step 5. Pick Data Channels

Next, you need to pick data channels that you wish to plot. You can do this by checking the desired channels under the data tab while a graph is selected. Only the checked channels will be plotted on the selected graph. Here, you can also specify which color to use when plotting corresponding data channels.

Step 6. Format visuals

Then under the Visual tab, format the style of the graph. You can configure the graph axis, assign name for the graph, display values, and etc. Most importantly, configure the View Style to match desired graph format.

Step 7. Repeat

Repeat the above steps 5 ~ 6 and configure each of the graphs in the layout.

Step 8. Make selection

Select an asset (marker, Rigid Body, Skeleton, force plate, or NI-DAQ channel) that you wish to monitor.

Step 9. Lock selection to graph(s)

Step 10. Repeat lock selection

Once all related graphs are locked, move onto next selection and lock the corresponding graphs.

Step 11. Update the layout

When you have the layout configured with the locked selections you can save the configurations as well as the implicit selections temporarily to the layout. Until the layout is particularized onto the explicit selections, you will need to select the related items in Motive to plot the respective graphs.

Step 12. Particularize the layout

Particularizing a Layout

It is important to particularize the customized layout once all of the graphs are configured. This action will save and explicitly fix the locked selections that the graphs are locked onto. Once the layouts have been particularized, you can re-open the same layout on different sessions and plot the data channels from the same subject with out locking the selection again. Specifically, the particularized layout will try to look for items (labeled marker, Rigid Body, Skeleton, force plate, or analog channels) with the same names that the layout is particularized onto.

Graph Editor Sidebar

Data tab

Only enabled, or checked, data channels will be plotted on the selected graph using the specified color. Once channels are enabled, an asset (marker, Rigid Body, Skeleton, force plate, or DAQ channel) must be selected and locked.

Marker

Plot 3D position (X/Y/Z) data of selected, or locked, marker(s) onto the selected graph.

Rigid Body

Plot pivot point position (X/Y/Z), rotation (pitch/yaw/roll), or mean error values of selected, or locked, Rigid Body asset(s) onto the selected graph.

Device

Plot analog data of selected analog channel(s) from a data acquisition (NI-DAQ) device onto the selected graph.

Force Plate

Plot force and moment (X/Y/Z) of selected force plate(s). Plotted graph respects coordinate system of the force platforms (z-up).

Visual tab

Graph Name

Labels the selected graph.

View Style

Configures the style of the selected graph:

• Channel: Plots selected channels onto the graph.

• Combined: Plots X/Y/Z curves for each selected markers fixed on the same plot.

• Gap: The Tracks View style allows you to easily monitor the occluded gaps on selected markers.

• Live: The Live mode is used for plotting the live data.

Range Handles

Enables/disables range handles that are located at the bottom of the frame selection.

Row Stretch

Sets the height of the selected row in the layout. The height will be determined by a ratio to a sum of all stretch values: (row stretch value for the selected row)/(sum of row stretch values from all rows) * (size of the pane).

Column Stretch

Sets the width of the selected column in the layout. The width size will be determined by a ratio to a sum of all values: (column stretch value for the selected column)/(sum of column stretch values from all columns) * (size of the pane).

Show Values

Display current frame values for each data set.

Show Labels

Display name of each plotted data set.

Show Primary Selection Only

Plots data from the primary selection only. The primary selection is the last item selected from Motive.

Show X Grid

Shows/hides x grid-lines.

Show Y Grid

Shows/hides y grid-lines.

Major Y

Sets the size of the major grid lines, or tick marks, on the y-axis values.

Minor Y

Sets the size of the minor grid lines, or tick marks, on the y-axis values.

Min Y

Sets the minimum value for the y-axis on the graph.

Max Y

Sets the maximum value for the y-axis on the graph.

In Motive, the Edit Tools pane can be accessed under the View tab or by clicking icon on the main toolbar.

The Edit Tools pane contains the functionality to modify 3D data. Four main functions exist: trimming trials, filling gaps, smoothing trajectories and swapping data points. Trimming trials refers to the clearing of data points before and after a gap. Filling gaps is the process of filling in a markers trajectory for each frame that has no data. Smoothing trajectories filters out unwanted noise in the signal. Swapping allows two markers to swap their trajectories.

Read through the Data Editing page to learn about utilizing the edit tools.

Trim Tails

Trim on Selected

Trim on Selected trims selected trajectories within the selected time region. Gaps outside the selected time region are not trimmed. Trajectories that are not selected are untouched.

Trim on All

Trim on All trims all trajectories within the selected time region. Gaps outside the selected time region are not trimmed.

Trim Size

Leading

Default: 3 frames. The Trim Size Leading defines how many data points will be deleted before a gap.

Trailing

Default: 3 frames. The Trim Size Trailing defines how many data points will be deleted after a gap.

Smart Trim

Default: OFF. The Smart Trim feature automatically sets the trimming size based on trajectory spikes near the existing gap. It is often not needed to delete numerous data points before or after a gap, but there are some cases where it's useful to delete more data points in case jitters are introduced from the occlusion. When enabled, this feature will determine whether each end of the gap is suspicious with errors, and delete an appropriate number of frames accordingly. Smart Trim feature will not trim more frames than the defined Leading and Trailing value.

Minimum segment size

Default: 5 frames. The Minimum Segment Size determines the minimum number of frames required by a trajectory to be modified by the trimming feature. For instance, if a trajectory is continuous only for a number of frames less than the defined minimum segment size, this segment will not be trimmed. Use this setting to define the smallest trajectory that gets.

Gap size threshold

Default: 2 frames. The Gap Size Threshold defines the minimum size of a gap that is affected by trimming. Any gaps that are smaller than this value are untouched by the trim feature. Use this to limit trimming to only the larger gaps. In general it is best to keep this at or above the default, as trimming is only effective on larger trajectories.

Fill Gaps

Find Previous

Find Previous searches through the selected trajectory and highlights the range and moves the cursor to the center of a gap before the current frame.

Find Next

Find Next searches through the selected trajectory and highlights the range and moves the cursor to the center of a gap after the current frame.

Fill Selected

Fills the currently selected gap.

Fill All

Fills all gaps in the currently selected track.

Fill Everything

Fills all gaps in all tracks of the timeline.

Settings

Max Gap Size

The maximum size, in frames, that a gap can be for Motive to fill. Raising this will allow larger gaps to be filled. However, larger gaps may be more prone to incorrect interpolation.

Interpolation

Sets which interpolation method to be used. Available patterns are constant, linear, cubic, pattern-based, and model-based. For more information, read Data Editing page

Fill Target

When using the pattern-base interpolation to fill gaps on a marker's the trajectory, Other reference markers are selected alongside the target marker to interpolate. This Fill Target drop-down menu specifies which marker among the selected markers to set as the target marker to perform the pattern-base interpolation.

Smooth Selection

Applies smoothing to the selected portion of the track.

Smooth Track

Applies smoothing to all frames of the track.

Smooth All Tracks

Applies smoothing to all frames on all tracks of the current selection in the timeline.

Filter Cutoff Frequency

Max. Freq (Hz)

Determines how strongly your data will be smoothed. The lower the setting, the more smoothed the data will be. High frequencies are present during sharp transitions in the data, such as foot-plants, but can also be introduced by noise in the data. Commonly used ranges for Filter Cutoff Frequency are 7-12 Hz, but you may want to adjust that up for fast, sharp motions to avoid softening transitions in the motion that need to stay sharp.

Swap Fix

Find Previous

Jumps to the most recent detected marker swap.

Find Next

Jumps to the next detected marker swap.

Markers to Swap

Selects the markers to be swapped.

Apply Swap

Swaps two markers selected in the Markers to Swap

Accuracy Tool

The Accuracy Tool is used to check calibration quality and tracking accuracy of a given volume. There are two tools in this tab: the Volume Accuracy tool and the Marker Measurement tool. The Accuracy tools are available under the Accuracy Tools tab in the Measurements pane.

Wand Measurement Tool

This tool works only with a fully calibrated capture volume and requires the calibration wand that was used during the process. It compares the length of the captured calibration wand to its known theoretical length and computes the percent error of the tracking volume. You can analyze the tracking accuracy from this.

Steps

• In Live mode, open the Measurements pane under the Tools tab.

• Access the Accuracy tools tab.

• Under the Wand Measurement section, it will indicate the wand that was used for the volume calibration and its expected length (theoretical value). The wand length is specified under the Calibration pane where you can set the theoretical length to the desired value.

• Bring the calibration wand into the volume.

• Once the wand is in the volume, detected wand length (observed value) and the calculated wand error will be displayed accordingly.

Marker Measurement Tool

This tool calculates measured displacement of a selected marker. You can use this tool to compare the calculated displacement in Motive against how much the marker has actually moved to check the tracking accuracy of the system.

Steps

• Place a marker inside the capture volume.

• Select the marker in Motive.

• Under the Marker Measurement section, press Reset Measurement. This zeroes the position of the marker.

• Slowly translate the marker, and the absolute displacement will be displayed.

Probe

The Probe tab is used with the Measurement Probe Tool Kit. See Measurement Probe Kit Guide for specific instructions.

Probe Calibration

Calibration Frames

Number of frames to sample when calibrating the measurement probe.

Start Calibration

Initiates the probe calibration process.

Sampling Settings

Sample Frames

A total number of frames to collect for calculating the 3D location of the probe tip in respect to the markers on the probe.

Take Sample

Samples 3D location of the probe tip.

Clear All

Clears all collected probe samples.

Set Origin

Re-positions the global coordinate origin to where the probe tip is located

Set Orientation

Re-orients the global coordinate system to three of the sampled points.

Additional Settings

Sound

Enable/disable the beeping sound each time a sample is collected.

Real-Time Probe Measurement

This section of the pane displays tracking information of the probe. It displays both the real-time tracking and recorded samples. If multiple samples are collected, the distance and angle between the sampled points will be calculated and displayed.

In Motive, the Labeling pane can be accessed under the View tab or by clicking icon on the main toolbar.

For more explanation on the labeling workflow, read through the Labeling workflow page.

Overview

Marker Labels

White Label

The assigned label is assigned to a marker in the current frame

Orange Label

The marker exists in the current frame, but it is unlabeled.

Red Label

The marker is not tracked in the current frame.

Labeling Settings

Labeling Range Settings

All/Selected

Assign labels to a selected marker for all, or selected, frames in a capture.

Spike/Fragment

Applies labels to a marker within the frame range bounded by trajectory gaps and spikes (erratic change). The Max Spike value sets the threshold for spikes which will be used to set the labeling boundary. The Max Gap size determines the tolerable gap size in a fragment, and trajectory gaps larger than this value will set the labeling boundary. This setting is efficient when correcting labeling swaps.

Max Gap

This sets the tolerable gap sizes for both gap ends of the fragment labeling.

Max Spike

Sets the max allowable velocity of a marker (mm/frame) for it to be considered as a spike.

This page goes over the features available on the Markersets pane. Markersets pane can be accessed by clicking on the icon on the toolbar.

Marker Set

The Marker Set is a type of assets in Motive. It is the most fundamental method of grouping related markers, and this can be used to manually label individual markers in post-processing of captured data using the Labeling pane. Note that Marker Sets are used for manual labeling only. For automatic labeling during live mode, a Rigid Body asset or a Skeleton asset is necessary.

Since creating rigid bodies, or skeletons, groups the markers in each set and automatically labels them, Marker Sets are not commonly used in the processing workflow. However, they are still useful for marker-specific tracking applications or when the marker labeling is done in pipelines other than auto-labeling. Also, marker sets are useful when organizing and reassigning the labels.

Create MarkerSet

Adding Labels

Context Menu Options

Move to Top

Move the selected label to the top of the labels list.

Move Up

Move the selected label one level higher on the list.

Move Down

Move the selected label one level lower on the list.

Move to Bottom

Move the selected label to the bottom of the labels list.

Rename

Rename the selected label

Delete

Delete the seleted label

This page includes detailed step-by-step instructions on customizing the marker name XML files for skeletons and Marker Set assets.

In order to customize the skeleton marker labels, marker colors, and marker sticks, a Marker XML file needs be exported, customized, and loaded back in. For skeletons, modified Marker XML files can only be used with the same Marker Set template. In other words, if you exported a Baseline (41) skeleton and modified the labeling XML file, same Baseline (41) Marker Set needs to be created in order to import the customized XML file. The following section describes the steps for customizing skeleton XML templates.

Steps

1. Export a Marker XML

a) First, choose a Marker Set from the Builder pane, and create a skeleton.

b) Right-click on a skeleton asset in the Assets pane, and select Export Markers.

c) In the export dialog window, select a directory to save the Marker Name Template (.xml) file. Click Save to export.

2. Customize the XML

Customize Marker Labels

a) Open the exported XML file using a text editor. It will contain corresponding marker label information under the MarkerNameMap section.

b) Customize the marker labels from the XML file. Under the MakerNames section of the XML, modify labels for the name variables with the desired name, but do not change labels for oldName variables. The order of the markers should remain the same.

c) If you changed marker labels, the corresponding marker names must also be renamed within the Marker and Marker Sticks definitions as well. Otherwise, the marker colors and marker sticks will not be defined properly.

Customize Marker Sticks and Colors

a) To customize the Marker Colors and Sticks, open the exported XML file using a text editor and scroll down to the Markers and Marker Sticks section. If the Markers and Marker Sticks section does not exist in the exported XML file, you could be using an old skeleton created before Motive 1.10. Updating and exporting old skeleton will provide these sections in the XML.

b) Here, you can customize the marker colors and the marker sticks. For each marker name, you must use exactly same marker labels that were defined by the MarkerNames section of the same XML file. If any marker label was changed in the MarkerNames section, the changed name must be reflected in the respective colors and sticks definitions as well. In other words, if a Custom_Name was assigned under name for a label in the MarkerNameMap section <Marker name="Custom_Name" oldName="Original_Name" />, the same Custom_Name must be used to rename all the respective marker names within Marker and MarkerSticks elements of the XML.

• Marker Colors: For each marker in a skeleton, there will be a respective name and color definitions under the Markerssection of the XML. To change corresponding marker colors for the template, edit the RGB parameter and save the XML file.

• Marker Sticks: A marker stick is simply a line interconnecting two labeled markers within the skeleton. Each marker stick definition consists of two marker labels for creating a marker stick and a RGB value for its color. To modify the marker sticks, edit the marker names and the color values. You can also define additional marker sticks by copying the format from the other marker stick definitions.

3. Import Skeleton XML

Creating new skeletons

Now that you have customized the XML file, it can be loaded each time when creating new skeletons. In the Builder pane under skeleton creation options, select the corresponding Marker Set. Then, under the Marker Names drop down menu, choose (…) to browse to import the XML file. When you Create the skeleton, the custom marker labels, marker sticks, and marker labels will be applied. You will need to auto-label the take again if you are working on a recorded TAK file.

If you manually added extra markers to a skeleton, you must rename the skeleton after creating it. See more at the Added Markers section.

Renaming Markers on existing Skeleton

You can also apply customized XML into an existing skeleton using the renaming feature. Right-click on a skeleton asset in the Project pane and select the Rename Markers from the context menu, and this will bring up a dialog window for importing a skeleton XML template. Import the customized XML template and modified labels will be applied to the asset. This feature must also be used if extra markers were added to the default XML template.

In order to replace the existing labels with the modified labels, you will need to first delete the existing markers labels and auto-label the skeleton asset again with the renamed markers, or you can Reconstruct and Auto-label the entire Take again.

Notes for added Markers

XML definitions can also be applied to added markers on a skeleton asset. When extra markers were added to a skeleton, its exported XML file will have the corresponding marker labels logged at the end of the MarkerNames section, and the labels for these markers can be customized from the exported XML file. The marker color and sticks definitions for extra markers will not be created automatically. To assign the marker colors and sticks for the extra markers, you will need to type additional instances which exactly copies the format that is used in other instances.

A newly created skeleton will not contain the added markers within the asset. To apply the customized XML for the extra markers, you must first create a skeleton of the same markerset and add the extra markers before importing the XML. When adding multiple markers, it is important that they are added in exactly the same order that it was added on the skeleton which was exported; Otherwise, the extra labels will be assigned incorrectly. After adding the corresponding markers, use the Rename Markers feature to apply the customized XML file. Lastly, auto-labeled the Take to assign the corresponding marker definitions onto the skeleton.

Applying Customized XML with Added Markers

1. [Motive: Builder pane] Create the skeleton using the markers without including the extra markers that were added. These markers will be added on the next step.

2. [Motive: Perspective View pane] Add the extra markers onto the selected skeleton asset. See how to add markers.

3. [Motive:Assets pane] Select the skeleton and click Rename Markers to import the customized skeleton XML template.

4. [Motive:Assets pane] When working with a recorded Take, first delete the existing marker labels using the Delete Marker Labels from the Assets pane, and auto-label the Take to label the markers using the imported XML file.

In Motive, the Status Log pane can be accessed under the or by clicking the icon on the main toolbar.

The Status Log pane logs important events or statuses of the system operation. Actively occurring events are listed under the Current section and all of the events are logged under the History section for the record. The log can be exported into a text file for troubleshooting references.

In general, when there are no errors in the system operation, the Current section of the log will remain free of warning or error messages. Occasionally during system operations, however, the error/warning messages (e.g. Dropped Frame, Discontinuous Frame ID) may pop-up momentarily and disappear afterward. This could occur when Motive is changing its configurations; for example, when switching between Live and Edit modes or when re-configuring the synchronization settings. This is a common behavior, and this does not necessarily indicate system errors as long as the messages do not persist in the Current section. If the error message is continuously persisting under the Current section or have a high number of event counts, it is indicating an issue with the system operation.

Status Messages

Status messages are categorized into three categories: Informational, Warning, and Error. Logged status messages on the history list can be filtered through choosing a specific category under the Display Filter section. Status messages will appear in a chronological order with corresponding timestamps, which indicate the number of seconds past since the software start.

Symbol Convention

Messages

Note: This table is not an exhaustive list of messages in the Log pane.

This page provides information on the Probe pane, which can be accessed under the Tools tab or by clicking on the icon from the toolbar.

Overview

This section highlights what's in the Probe pane. For detailed instructions on how to use the Probe pane to collect measurement samples, read through .

Probe Calibration

The Probe Calibration feature under the Rigid Body edit options can be used to re-calibrate a pivot point of a measurement probe or a custom Rigid Body. This step is also completed as one of the calibration steps when first creating a measurement probe, but you can re-calibrate it under the Modify tab.

Steps

1. In Motive, select the Rigid Body or a measurement probe.

2. Bring out the probe into the tracking volume where all of its markers are well-tracked.

3. Place and fit the tip of the probe in one of the slots on the provided calibration block.

4. Click Start

5. Once it starts collecting the samples, slowly move the probe in a circular pattern while keeping the tip fitted in the slot; making a cone shape overall. Gently rotate the probe to collect additional samples.

6. When sufficient samples are collected, the mean error of the calibrated pivot point will be displayed.

7. Click Apply to use the calibrated definition or click Cancel to calibrate again.

Digitized Points

The Digitized Points section is used for collecting sample coordinates using the probe. You can select which Rigid Body to use from the drop-down menu and set the number of frames used to collect the sample. Clicking on the Sample button will trigger Motive to collect a sample point and save it into the C:\Users\[Current User]\Documents\OptiTrack\measurements.csv file.

When needed, export the measurements of the accumulated digitized points into a separate CSV file, and/or clear the existing samples to start a new set of measurements

Live Position

Shows the live X/Y/Z position of the calibrated probe tip.

Last Point

Shows the live X/Y/Z position of the last sampled point.

Live Distance

Shows the distance between the last point and the live position of the probe tip.

Distance

Shows the distance between the last two collected samples.

Angle

Shows the angle between the last three collected samples

When an NI-DAQ device is selected in Motive, its device information gets listed under the . Just basic information on the used device will be shown in the . For configuring properties of the device, use the .

For more information, read through the NI-DAQ setup page: .

Settings

Enabled

Only enabled NI-DAQ devics will be actively measuring analog signals.

Trigger Sync

This setting determines how the recording of the selected NI-DAQ device will be triggered. This must be set to None for reference clock sync and to Device for recording trigger sync.

• None: NI-DAQ recording is triggered when Motive starts capturing data. This is used when using the reference clock signal for synchronization.

• Device: NI-DAQ recording is triggered when a recording trigger signal to indicate the record start frame is received through the connected input terminal.

Trigger Terminal

(available only when Trigger Sync is set to Device) Name of the NI-DAQ analog I/O terminal where the recording trigger signal is inputted to.

Reference Clock Sync

This setting sets whether an external clock signal is used as the sync reference. For precise synchronization using the internal clock signal sync, set this to true.

• True: Setting this to true will configure the selected NI-DAQ device to synchronize with an inputted external sample clock signal. The NI-DAQ must be connected to an external clock output of the eSync on one of its digital input terminals. The acquisition rate will be disabled since the rate is configured to be controlled by the external clock signal.

• False: NI-DAQ board will collect samples in 'Free Run' mode at the assigned Acquisition Rate.

Reference Clock Terminal

(available only when Reference Clock Sync is set to True) Name of the NI-DAQ digital I/O terminal that the external clock (TTL) signal is inputted to.

eSync Output

Set this to the output port of the eSync where it sends out the internal clock signal to the NI-DAQ.

Rate

Shows the acquisition rate of the selected NI-DAQ device(s).

Device Channel Properties

Depending on the model, NI-DAQ devices may have different sets of allowable input types and voltage ranges for their analog channels. Refer to your NI-DAQ device User's Guide for detailed information about supported signal types and voltage ranges.

Min Voltage

(Default: -10 volts) Configure the terminal's minimum voltage range.

Max Voltage

(Default: +10 volts) Configure the terminal's maximum voltage range.

Terminal Type

• Terminal: RSE Referenced single ended. Measurement with respect to ground (e.g. AI_GND) (Default)

• Terminal: NRSE NonReferenced single ended. Measurement with respect to single analog input (e.g. AISENSE)

• Terminal: Diff Differential. Measurement between two inputs (e.g. AI0+, AI0-)

• Terminal: PseudoDiff Differential. Measurement between two inputs and impeded common ground.

Details

Name

[Advanced] Name of the selected device.

Model

Device model ID, if available.

Serial

Device serial number of the selected NI-DAQ assigned by the manufacturer.

GroupName

Type of device.

Channels

Total number of available channels on the selected NI-DAQ device.

Run Mode

[Advanced]What mode of Motive playback being used.

State

Whether the device is ready or not.

SyncState

Tristate status of either Need Sync, Ready for Sync, or Synced. Updates the "State" icon in the Devices pane.

DeviceType

[Advanced] Internal device number.

DisplayName

User editable name of the device.

By modifying the device properties of the OptiHub, users can customize the sync configurations of the camera system for implementing external devices in various sync chain setups. This page directly lists out the properties of the OptiHub. For general instructions on customizing sync settings for integrating external devices, it is recommended to read through the guide.

While the OptiHub is selected under the , use the to view and configure its properties. By doing so, users can set the parent sync source for the camera system, configure how the system reacts to input signals, and also which signals to output from the OptiHub for triggering other external acquisition devices.

Synchronization Control

Internal Sync Freq (Hz)

This option is only valid if the Sync Input: Source is set to Internal Sync. Controls the frequency in Hertz (Hz) of the OptiHub 2's internal sync generator. Valid frequency range is 8 to 120 Hz.

Global Sync Offset (us)

This option is only valid if the Sync Input: Source is set to Sync In or USB Sync. Controls synchronization delay in microseconds (us) between the chosen sync source signal and when the cameras are actually told to expose. This is a global system delay that is independent of, and in addition to, an individual camera's exposure delay setting. Valid range is 0 to 65862 us, and should not exceed one frame period of the external signal.

Sync Input Settings

To setup the sync input signals, first define a input Source and configure desired trigger settings for the source:

• Internal/Wired sets the OptiHub 2 as the sync source. This is the default sync configuration which uses the OptiSync protocol for synchronizing the cameras. The Parent OptiHub 2 will generate an internal sync signal which will be propagated to other (child) OptiHub 2(s) via the Hub Sync Out Jack and Hub Sync In Jack. For V100:R1(legacy) and the Slim 3U cameras, Wired Sync protocol is used. In this mode, the internal sync signal will still be generated but it will be routed directly to the cameras via daisy-chained sync cables.

• Sync In sets an external device as the sync source.

Source: Internal/Wired

Internal Sync Freq (Hz)

This option is only valid if the Sync Input: Source is set to Internal Sync. Controls the frequency in Hertz (Hz) of the OptiHub 2's internal sync generator, and the this frequency will control the camera system frame rate. Valid frequency range is 8 to 120 Hz.

Source: Sync In

Source Frequency

Detects and displays the frequency of the sync signal that's coming through the input port of the parent OptiHub 2, which is at the very top of the RCA sync chain. When sync source is set to Sync In, the camera system framerate will be synchronized to this input signal. Please note that OptiHub 2 is not designed for precise sync, so there may be slight sync discrepancies when synchronizing through OptiHub 2.

Sync Offset

Manually adds global sync time offset to how camera system reacts to the received input signal. The input unit is measured in microseconds.

Input Trigger

Can select from Either Edge, Rising Edge, Falling Edge, Low Gated, or High Gated signal from the connected input source.

Input Divider

Allows a triggering rate compatible with the camera frame rate to be derived from higher frequency input signals (e.g. 300Hz decimated down to 100Hz for use with a V100:R2 camera). Valid range is 1 (no decimation) to 15 (every 15th trigger signal generates a frame).

Source: USB Sync

Source Frequency

Detects and displays the frequency of the parent source.

USB Sync-In Control

Allows the user to allow or block trigger events generated by the internal sync control. This option has been deprecated for use in the GUI. Valid options are Gate-Open and Gate-Closed.

Input Divider

Allows a triggering rate compatible with the camera frame rate to be derived from higher frequency input signals (e.g. 360Hz decimated down to 120Hz for use with a Flex 13 camera). Valid range is 1 (no decimation) to 15 (every 15th trigger signal generates a frame).}}

Input Trigger Options

External Sync Output

Pulse Type

Selects condition and timing for a pulse to be sent out over the External Sync Out jack. Available Types are: Exposure Time, Pass-Through, Recording Level, and Recording Pulse.

External Sync Output Options

Polarity

Selects output polarity of External Sync Out signal. Valid options are: Normal and Inverted. Normal signals are low and pulse high and inverted signals are high and pulse low.

The Properties pane can be accessed by clicking on the icon on the toolbar.

The Properties pane lists out the settings configured for selected objects. In Motive, each type of asset has a list of associated properties, and you can access and modify them using the Properties pane. These properties determine how the display and tracking of the corresponding items are done in Motive. This page will go over all of the properties, for each type of asset, that can be viewed or configured in Motive.

Overview

Properties

Properties will be listed for recorded Takes, Rigid Body assets, Skeleton assets, force plate device, and NI-DAQ device. Detailed descriptions on each corresponding properties are documented on the following pages:

Selected Items

Advanced Settings

Advanced Settings

The Properties pane contains advanced settings that are hidden by default. Access these settings by going to the menu on the top-right corner of the pane and clicking Show Advanced and all of the settings, including the advanced settings, will be listed under the pane.

The list of advanced settings can also be customized to show only the settings that are needed specifically for your capture application. To do so, go the pane menu and click Edit Advanced, and uncheck the settings that you wish to be listed in the pane by default. One all desired settings are unchecked, click Done Editing to apply the customized configurations.

When a force plate is selected in Motive, its device information gets listed under the . For configuring force plate properties, use the and modify the corresponding device properties.

For more information, read through the force plate setup pages:

Settings

Enabled

Enables or disables selected force plate. Only enabled force plates will be shown in Motive and be used for data collection.

Triggered Sync

Select whether the force plate is synchronized through a recording trigger. This must be set to Device when force plates are synchronized through recording trigger signal from the eSync. This must be set to None when synchronizing through a clock signal.

Reference Clock Sync

When set to true, the force plate system synchronizes by reference to an external clock signal. This must be enabled for the reference clock sync. When two systems syncs using the recording trigger, this must be turned off.

eSync Output

Indicates the output port on the eSync that is used for synchronizing the selected force plate. This must match the output port on the eSync that is connected to the force plate amplifier and sending out the synchronization signal.

Multiple

Rate

Resulting data acquisition rate of the force plates. For reference clock sync setups, it will match the frequency of the clock signal. For triggered sync setups, this will match the multiple of the camera system frame rate.

Order

Assigned number of the force plates.

Device Asset

Name of the Motive asset associated with the selected device. For Manus Glove integration, this must match the name of the Skeleton.

Details

Name

Name of the selected force plate.

Model

Model number of the force plate

Serial

Force plate serial number.

Channels

Number of active channels available in the selected device. For force plates, this defaults to 6 with channels responsible for measuring 3-dimensional force and moment data.

State

Indicates the state that the force plate is in. If the force plate is streaming the data, it will be indicated Receiving Data. If the force plate is on standby for data collection, it will be indicated Ready.

Scale

Size scale of the resultant force vector shown in the 3D viewport.

Length

Length of the force plate.

Width

Width of the force plate.

ElectricalOriginOffset

Manufacturer defined electrical-to-mechanical offset values.

Corners

Lists out positions of the four force plate corners. Positions are measured with respect to the global coordinate system, and this is calibrated when you Set Position using the CS-400 calibration square.

When a is selected from the , related information will be displayed in the .

From the Properties pane, you can get the general information about the Take, including the total number of recorded frames, capture data/time, and the list of assets involved in the recording. Also, when needed, the solver settings that were used in the recorded TAK can be modified, and these changes will be applied when performing post-processing reconstruction.

General

Name

Take name

Frame Rate

The camera frame rate in which the take was captured. The Take file will contain the corresponding number of frames for each second.

Start Frame

The frame ID of the first frame saved on the Take.

End Frame

The frame ID of the last frame saved on the Take.

Start Time

A timestamp of when the recording was first captured started.

End Time

A timestamp of when the recording was ended.

Assets

Names of assets that are included in the Take

Notes

Comments regarding the take can be noted here for additional information.

Best

Capture Data/Time

Date and time when the capture was recorded.

Captured in Version

The version of Motive which the Take was recorded in. (This applies only to Takes that were captured in versions 1.10 or above)

Captured in Build

The build of Motive which the Take was recorded in.

Health State

The data quality of the Take which can be flagged by users.

Progress

Progress indicator for showing how into the post-processing workflow that this Take has made.

Calibration Info

Camera system calibration details for the selected Take. Takes recorded in older versions of Motive may not contain this data.

Calibration Time Stamp

Shows when the cameras were calibrated.

Residual Mean Error

Residual 50/95/99 Percentile Error

Wand Mean Error

Displays a mean error value of the detected wand length samples throughout the wanding process.

Wand 50/95/99

Displays percentile distribution of the wand errors.

Calibration Wand

Shows what type of wand was used: Standard, Active, or Micron series.

Wand Length

Displays the length of the calibration wand used for the capture.

Wand Center Offset

Distance from one of the end markers to the center marker, specifically the shorter segment.

Camera Filters - Software

Solver/Reconstruction Settings

The Reference View pane is used to monitor captured videos from the reference cameras. Up to two reference cameras can be monitored on each pane. This pane can be accessed under the View tab → Reference Overlay or simply by clicking on one of the reference view icons from the main toolbar ().

Cameras can be set to a reference view from the or by configuring video type to grayscale modes.

Assets Overlay

In this pane, cameras, markers, and trackable assets can be overlayed over the reference view. This is a good way of monitoring events during the capture. All of the assets and trajectory histories under the Perspective view pane can be overlayed on the reference videos from this pane.

Note: that the overlayed assets will not be rendered into exported reference videos.

The status panel lists out the system parameters for monitoring the live status of system operations. Click on the displayed status at the bottom right corner of Motive, and the Status Panel will pop up. You can drag and place the Status Panel anywhere.

Status Panel

Residual

Data

Current incoming data transfer rate (KB/s) for all attached cameras.

Point Cloud

Measured latency of the point cloud reconstruction engine.

Assets

Measured latency of the Rigid Body solver and the Skeleton solver combined.

Software

Measured software latency. It represents the amount of time it takes Motive to process each frame of captured data. This includes the time taken for reconstructing the 2D data into 3D data, labeling and modeling the trackable assets, displaying in the viewport, and other processes configured in Motive.

System

Available only on Ethernet Camera systems (Prime series and Slim13E). Measured total system latency. This is the time measured from the middle of the camera exposures to when Motive has fully solved all of the tracking data.

Streaming

The data rate at which the tracking data is streamed to connected client applications.

Cameras

Available only on Ethernet Camera systems (Prime series or Slim 13E). Average temperature, in Celsius, on the imager boards of the cameras in the system.

Status Panel: Latency

When there is an increased latency on any of the processing pipeline that needs an attention, it will be highlighted in purple. Increase processing latency may result in dropped frames when real-time processing the data in live-captures or in 2D Mode. Increased latency usually occurs due to the CPU not being fast enough to process the data in real-time. If you perform post-processing reconstructions, you will be accessing the recorded 3D data or solved data (rigid bodies), and there will be no processing required for the corresponding pipeline and they will be indicated as inactive.

Real-time Point Cloud Latency

Calibration Pane is used for calibrating the mocap system through the calibration wanding process. This page provides descriptions on the fields and settings included on the calibration pane. Read through the Calibration workflow page to learn about the calibration process in detail.

In Motive, the Calibration pane can be accessed under the View tab or by clicking icon on the main toolbar.

Calibration

Mask Visible

This masks all pixels that are above the set threshold. By default, the threshold is set to 200 but this can be changed by the user in the cameras pane. Pixels in a camera image will have a grayscale value between 0 and 255 inclusively. If the default threshold is used, a pixel that is above 200 will be blocked along with the surrounding pixels.

This feature is a quick way to block data that is not needed and can be used in tandem with manual masking.

Start Wanding

This will start recording wand samples. After masking the cameras, press the start wanding button to begin your wand wave.

Reset

This will stop wand acquisition and the calibration solver.

Calibration Options

Calibration Type

You can selected different calibration types before wanding: Full, Refine, Refine Extrinsic Only, Visualize Only.

• Full: Calibrate cameras from scratch, discarding any prior known position of the camera group or lens distortion information. A Full calibration will also take the longest time to run.

• Refine: Adjusts slight changes on the calibration of the cameras based on prior calibrations. This will solve faster than a Full calibration. Only use this if your previous calibration closely reflects the placement of cameras. In other words, Refine calibration only works if you do not move the cameras significantly from when you last calibrated them. Only slight modifications can be allowed in camera position and orientation, which often occurs naturally from the environment such as mount expansion.

• Visual: Only render the calibration solution visual and will not calibrate your cameras. This can be used to validate the quality of existing calibration by comparing position and orientation of the cameras.

OptiWand

This options allows the user to select which calibration wand their using. The dimension must match the wand exactly in order for the system to be properly calibrated.

Wand Length (mm)

This can be set when creating a custom wand and is the measure of the distance between the two outer marker centers. The accuracy of this measurement will directly impact camera calibration results, so be careful when creating and setting a custom wand.

Center Distance (mm)

Defines the distance in millimeters between the outer post and the center post (use the shorter of the two center offset distances). For use with custom calibration wands.

Calibration Engine

Calculate

Initiates the calibration solver. Press this button after collecting enough wand samples.

Apply Result

Applies the calibration results to the cameras. Once pressed, this button will bring up a calibration result box. If the calibration result is satisfactory, press Apply. After you save the wanding the camera calibration pane will switch over to the Ground Plane tab so you can set the global origin.

Wanding Table

While wanding the bottom part of the Camera Calibration Pane will show a table of the number of samples collected for each camera in the system. The samples will increase as the wand is waved in the capture volume.

Calibration Results Table

The calibration results will show in the Calibration Engine portion of the Calibration pane. The elapsed time of the calibration solver is shown at the bottom of the list. If no calibration is being processed this area will remain blank. However, when a wanding or a calibration solver is underway, this field will be populated with a table showing the live results of the solution. The components of that table are described below.

As the calibration proceeds through the various phases of the solution you may notice the results slowing when a phases is finishing. Let the calibration finish all phases of the calibration. Once the solver converges on an appropriate solution, press the Apply Result button to apply the solution to the cameras. If you are unsatisfied with the results, hit reset near the top of the pane to cancel the results.

Ground Plane

Ground plane tab under the calibration pane

Set Ground Plane

Set the location of the global origin. Use an 'L' Frame or 3 markers in the shape of an 'L'. If only 3 markers are seen by the cameras, you can simply press 'Set Ground Plane'. If more markers are in view then you can select the 3 markers you want to use in the 3D viewport and then press 'Set Ground Plane'.

Motive 1.6 and earlier : L-Frame long (marked Z) "leg" interpreted as -Z, L-Frame short (unlabeled) leg interpreted as +X Motive 1.7 : L-Frame long (marked Z) "leg" interpreted as +Z, L-Frame short (unlabeled) leg interpreted as -X

Vertical Offset

In this section you can assign the Vertical Offset value. The Vertical Offset (mm) is the difference in height (y-direction) between the L frame vertex marker and the actual ground plane. Use positive values to set the global origin below the 3 marker vertex and negative values to set the global origin above the 3 marker vertex. Motive will recognize calibration squares, unless custom designed, and will ask to correct the offset value before the calibration process. However, the global origin is arbitrary and can be placed anywhere the user desires.

Ground Plane Refinement

The Ground Plane Refinement feature can be used to refine the ground plane. You can select multiple reconstructions and use the corresponding 3D points to level the ground plane. This refinement feature assumes that the selected markers are all placed on the ground with a given vertical offset (mm) between the marker centroids to the ground surface, and then they use the selected samples to refine the ground plane.

Especially in large-scale volumes where the floor is not uniform, defining a ground plane using the calibration square may not be sufficient because it would be referencing just a local part of the volume. For such cases, this feature allows users to further refine the ground plane.

For example, you can evenly spread out 4 or more spherical markers throughout the floor. Specify the marker centroid to ground vertical offset distance, which would be the radius of the marker in this case. Then press the Ground Refinement button. This will change the vertical location of the floor, ensuring all of the markers are above the floor.

Capture Volume Translation

The Volume Translation modifies the global origin after it has been set.

Simply enter the amounts you want to translate the origin in the X, Y and/or Z direction and press the Apply Translation button. There is no limit to the number of translations that can be applied and there is no memory once a translation is applied. To revert a translation, simply translate the origin be an equivalent amount in the opposite direction. If there is existing 3D data in the Take, you will need to reconstruct a new set of 3D data from recorded 2D data after the translation has been applied.

Capture Volume Rotation

The Volume Rotation is use to apply a rotational offset to the current global origin. If there is existing 3D data in the Take, you will need to reconstruct a new set of 3D data from recorded 2D data after the rotation has been applied.