This wiki is intended for older versions of Motive. For the latest documentation, please refer to
docs.optitrack.com

Devices pane Old

Back To Page References


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


Camera Settings


Devices pane in Motive.

Frame Rate (FPS)

The number of frames the camera or camera group will capture per second. The minimum and maximum values for frame rate depend on the model of camera that you are using. A higher frame rate will allow for more frames per second of data, and help prevent motion blur. A lower frame rate will allow for higher exposure values (and brighter images) and will also reduce the bandwidth required to transmit data, which can help in systems with high network or USB traffic.

Warning2.png

Note for Flex 3 Systems: There is a known issue where adjusting system frame rates under the Devices pane is not working properly. To adjust frame rates in Flex 3 camera systems, go to the Synchronization pane, switch to custom synchronization mode, make sure Sync Mode → OptiSync is set, input desired frame rate under the Internal Sync Freq (Hz) entry, and apply the customized sync configuration.

Exposure (EXP)

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 markers, larger marker blooms, and marker blurring--all of which can negatively impact marker data quality. Exposure value is measured in scanlines for V100 and V120 series cameras, and in microseconds for Flex13, S250e and Prime Series cameras.

Threshold (THR)

Defines the minimum brightness for a pixel to be seen by a camera, with all pixels below the threshold being ignored. Increasing the threshold can help filter interference by non-markers (e.g. reflections and external light sources), while lowering the threshold can allow dimmer markers to be seen by the system (e.g. smaller markers at longer distances from the camera).

LED Illumination (LED)

Sets brightness level for the camera IR LED ring. Higher LED values allow the camera to emit more IR light, which can allow for better marker detection at longer ranges. However, a value that is too high may cause reflection off of non-marker objects, which can destabilize data. Generally, the value should be higher for larger volumes and lower for smaller volumes. Default is dependent on camera model.

Tracking Mode

This icon indicates that the camera or camera group is in Tracking mode. Clicking on this will change the camera or camera group to Reference mode.

Reference Mode

This icon indicates that the camera or camera group is in Reference mode, while it is recording video, will not be tracking markers. Clicking on this will set the camera or camera group to Tracking mode.

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 very large setup areas, when changing illumination, exposure, and threshold are not sufficient.

Device Properties


File:Devices Properties.png
Properties section of the Devices pane

Depending on which item is selected under the Devices pane, corresponding properties will show up at the bottom of the pane.

Info2.png

Devices properties are persisted between different launches of Motive. These properties will be saved under the Profile XML file.

Device Properties: Tracking Group

2D Object Filter section in the Reconstruction Settings pane.

The following properties can be configured when the Tracking group is selected from the Devices pane. This properties section configures properties for the whole camera system.

Filters (2D Object Filter)

When a frame of image is captured by a camera, the 2D Object Filter is applied. By judging on sizes and shapes of the detected reflections, this filter determines which of them can be accepted as marker reflections. Parameters for the 2D Object filter are configured in the Devices pane under the Filters section.

Info2.png

For Motive 2.0 and above. The 2D Object filter settings in the Reconstruction Settings pane have been moved over to the Devices pane.

Filter Type

Default: Size and Roundness
Toggles 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.
The size filter applied with a maximum size limit of 200 pixels. Any reflections bigger than 200 pixel-size is omitted from the Point Cloud reconstruction calculation.

Min Thresholded Pixels (pixels)

Default: 4 pixels
The 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 more than 4 pixels need a group of pixels needs to be greater than 4 for a ray to be generated.

Max Thresholded Pixels (pixels)

Default: 2000 pixels
The 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.
The circle filter omitting non-circular reflections from a 2D camera view.

Circularity

Default: 0.6
The circularity value sets the 2D object filter sensitivity to the roundness of detected reflections. Valid range is between 0 and 1, with 0 being not round and 1 being perfectly round. This setting is relative to the resolution of the camera you are using. If you have lower resolution cameras, a marker will appear more pixelated and non-circular. If a marker is detected in only 5 pixels in a lower resolution camera at a set distance, the same marker will appear with more pixels from a high resolution camera and the captured reflection will have more circular perimeters.
When using lower resolution cameras to capture smaller markers at a long distance, 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 Detection

Default: Normal
The intrusion detection feature allows cameras to recognize merged reflections and filter them out from the image. Merged reflections are susceptible to inaccurate centroid calculation and may result in jittering of the reconstructed markers. From 2D object images, both of the intruding and detected marker reflection will be omitted whenever there is an extraneous reflections in the vicinity, within the intrusion boundary. Available detection modes are None, Normal, and Aggressive, and by default, Normal intrusion detection mode is recommended.
  • None: Intrusion detection is disabled.
  • Normal (Default): Creates a circular boundary, an Intrusion Band, around the detected marker centroids. If any reflection intrudes the boundary, the marker is filtered out.
  • Aggressive: Uses a bigger intrusion boundary. More specifically, the marker is filtered out, whenever there is any extraneous reflection detected when marker reflection cells are extracted for the image mode processing.

Intrusion Band

Default: 0.5(pixels)
Sets the size of the intrusion boundary for the Normal intrusion detection mode. More specifically, 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.

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 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 FOV

Selects whether camera FOVs are displayed in the viewport. Camera FOV accurately depicts the frustum angles, while depth is artificially capped. Actual depth may vary depending on camera settings and marker size. Enabling this feature can be beneficial in volume visualization for creation and adjustment. Valid options are True (default), False.

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).

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).

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).

Advanced

Point Cloud

Indicates which point cloud engine is being used for reconstruct 3D points. Point cloud engine v4.0 provides high quality 3D reconstruction outputs with fast speed computation.

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.

Fan Mode

Provides an option to turn off the camera fan during recording, for S250e cameras only.

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.

Device Properties: Camera

Single camera configurable properties.

The following properties can be configured when a Camera is selected from the Devices pane. Please note that the available properties might be slight different on different camera models.

Camera Settings

Gain

Sets the imager gain level for the selected cameras. Gain settings can be adjusted to amplify or diminish the brightness of the image. This setting can be beneficial when tracking at long ranges. However, note that increasing the gain level will also increase the noise in the image data and may introduce false reconstructions. Thus, before deciding to change the gain level, adjust the camera settings first to optimize the image clarity.

Video Type

Sets the video type of the selected camera.

Illumination Type

Sets the illumination to either Strobed or Continuous. Strobed illumination will output more light with equivalent power when compared to Continuous and is the ideal choice for standard motion capture volumes. Continuous is ideal for volumes where external IR interference is potentially an issue (e.g. with IR actuated stereovision systems that cannot synchronize to the OptiTrack cameras, or when other volumes may be within line of sight).

Filter Switch

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.

Automatic Exposure Control

(Default: False) Enables cameras to automatically adjust its camera exposure setting depending on the contrast level within the detected image. This feature is available only in Flex 3's and Duo/Trio tracking bars.

Automatic Gain Control

(Default: False) Thisl feature adjust the camera gain level automatically for best tracking. This feature is available only in Flex 3's and Duo/Trio tracking bars.

Device Properties: Force Plate Group

Force plate group configurable properties.

The following properties can be configured when Force Plates group is selected from the Devices pane.

Threshold

Minimum threshold, in N, force required for the resultant force to be displayed in the view port.

Baseline (frames)

Sets the length of initial recording, baseline, frames to be used as the reference zero samples in C3D files. During the initial frames, no load should be applied to the plates.

Force Display Scale

Adjusts the size of the resultant force vector displayed in the 3D viewport.

Device Properties: NI-DAQ Device

The following properties can be configured when a NI-DAQ device is selected from the Devices pane.

Device Properties: NI-DAQ Channel

The following properties can be configured a analog input channel under a NI-DAQ device is selected from the Devices pane.