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

Difference between revisions of "Devices pane Old"

Line 155: Line 155:
  
  
== Property Reference ==
+
==Properties: NIDAQ==
 
=== NI-DAQ Device properties ===
 
=== NI-DAQ Device properties ===
 
{{Indent|
 
{{Indent|

Revision as of 01:09, 4 March 2016

Back To Page References

The Cameras pane can be accessed under the View tab in Motive.

Devices

Camera Pane

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.

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. Exposure is measured in scanlines for V100 and V120 series cameras, and in microseconds for Flex13, S250e and Prime Series cameras. 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.

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.


Properties: Tracking Group

Camera Settings

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 Gain Control

Default: False

Video Type

Several modes are available for efficient on-camera image processing. Available modes vary slightly, depending on camera model:

  • Object: Performs on-camera detection of marker location, size, and roundness using methods similar to Precision Grayscale (except for V100 and V120 cameras, which use methods similar to Segment). Provides the smallest CPU footprint of all available modes. Recommended for Prime Series cameras, as well as Flex 13 and S250e cameras when CPU performance is taxed by Precision Grayscale mode (e.g. high camera counts using a less powerful CPU).
  • Precision Grayscale: Sends thresholded grayscale images of markers to the PC for calculation of object data. Provides the most verbose marker information, but requires the most CPU resources to process. Recommended for Flex 13, V100, V120, and S250e cameras.
  • Segment: Like precision grayscale processing, segment mode divides processing between the camera and CPU, providing a balance between precision and processing load. Recommended for V100 and V120 cameras when CPU performance is taxed by Precision Grayscale mode (e.g. high camera counts using a less powerful CPU).
  • MJPEG-compressed grayscale: Full resolution grayscale frames, compressed on-camera for scalable reference video capabilities.
  • Raw grayscale: Full resolution, uncompressed grayscale.
CameraPane ImageMode.PNG

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


Display Options

Camera Settings

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

Selects which point cloud engine will be used to reconstruct 3D points.

Point Cloud Description
v1.0 Point cloud engine v1.0 is particularly well suited for high marker counts and fast movements.
v2.0 Point cloud engine v2.0 is more CPU intensive, and is accordingly more susceptible to latency when tracking complex point clouds, but it can produce cleaner data than v1.0 in smaller scale applications.
v4.0 Point cloud engine v4.0 is recommended for most applications. It combines the high quality reconstruction output of v2.0 with the speed of v1.0 to provide balanced reconstruction speed and performance.

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.


Properties: Camera

Gain Sets the gain setting for the selected camera.

Video Type Sets the video type of the selected camera.


Properties: Force Plate Group

  • DevicesPane FP.png
  • TEMP SCREENSHOT. NIDAQ device properties in the Devices Pane

Units: Default: Metric. Sets the units for displaying force and moment data on the timeline graph.

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.

Sync Source: Sets the Sync source for the force plates. For now, the force plates (AMTI) only support Free Run mode with manufacture defined sampling rates, read more at Quick Start Guide: Force Plate Setup.

Force Display Scale: Adjusts the size of the resultant force vector displayed in the 3D viewport.


Properties: NIDAQ

NI-DAQ Device properties

Record Trigger: True to indicates record start frame flag will come from hardware data packet. False indicates Motive will control first recorded frame

Acquisition Rate: NI-DAQ sample acquisition rate. Must be a whole multiple/divisor of the camera framerate. Disabled if using an external clock.

Use External Clock: Sets whether an external clock signal is integrated.

  • True: NI-DAQ board is connected to an external clock on one of it's digial I/O terminals, and will use this signal to control sampling. Acquisition rate is disabled since the rate is now controlled by the external clock.
  • False: NI-DAQ board will collect samples in 'Free Run' at the Acquisition Rate specified.

External Clock Channel: Name of the NI-DAQ digital I/O terminal that is connected to the external clock (TTL) signal.


NIDAQ Device Channel Properties

Refer to your NI-DAQ boards User's Guide for detailed information about supported signal types and voltage ranges.

Min Voltage: Configure the terminal's minimum voltage range (default is -10 volts)

Max Voltage: Configure the terminal's maximum voltage range (default is +10 volts)

Terminal Type: Channel physical signal 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.



Back to Top