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

Difference between revisions of "Devices pane Old"

(Replaced content with "#REDIRECT Device pane")
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Category:Motive UI]]
#REDIRECT [[Device pane]]
[[Motive Reference Guide|Back To Page References]]
The Devices pane can be accessed under the View tab in Motive or by clicking [[File:Toolbar_Device_Icon.png]] icon on the main toolbar.
=Camera Settings=
<div class="padded">
[[File:Camera_Pane.png|thumb|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.
<div class="padded">
{{Warning2|'''Note for Flex 3 Systems:'''
There is a known issue where adjusting system frame rates under the Devices pane does not modify the sampling rate. To adjust frame rates in Flex 3 camera systems, go to the [[Custom_Synchronization:_OptiHub#Synchronization_Control|Synchronization pane]], switch to custom synchronization mode, make sure '''Sync Mode &rarr; 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 [[Data_Recording#Reference_Videos|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.
: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=
Depending on which item is selected under the [[Devices pane]], corresponding properties will show up at the bottom of the pane.
{{Info2|All of the devices properties are persisted between different launches of Motive. These properties will be saved under the [[Motive Basics#Profile XML File|Profile XML]] file.}}
<div class="padded">
==Device Properties: Tracking Group==
[[Image:Reconstruction_2DObjectFilter_20.png|thumb|2D Object Filter section in the [[Reconstruction Settings]] pane.]]
<div class="padded">
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)===
<div class="padded">
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|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.
[[Image:Reconstruction_Size.png|thumb|300px|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.
[[Image:Reconstruction_Circle.png|thumb|300px|The circle filter omitting non-circular reflections from a 2D camera view.]]
:Default: 0.6
:This 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 setting sets a boundary region around each object and rejects if there is another reflection intruding into this boundary. Both intruding reflection and detected marker reflection will be filtered.
====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===
<div class="padded">
: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).
: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).
<div class="padded">
====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==
<div class="padded">
[[Image:Devices_SingleCameraProperties_20.png|thumb|400 px|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===
<div class="padded">
: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|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 / Force Plate Group==
<div class="padded">
[[Image:DevicesPane_FP_20.png|thumb|Force plate group configurable properties.]]
The following properties can be configured when a force plate or a  ''Force Plates'' group is selected from the [[Devices pane]].
===Device Properties: Force Plate===
<div class="padded">
[[Image:DevicesPane_FPgroup_20.png|thumb|Force plate group configurable properties.]]
====Record Trigger====
:Configures whether if the force plate is triggered at recording. Set this to ''Device'' only when synchronizing to force plate via the triggered sync or the free run sync.
====Use External Clock====
:Set this to true for force plates that are synchronized via external clock signal from the eSync.
====eSync Output Channel====
:Set this to the output port number of the eSync that the force plate amplifier is connected to.
===Device Properties: Force Plate Group===
<div class="padded">
: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==
<div class="padded">
The following properties can be configured when a NI-DAQ device is selected from the Devices pane.
{{#lsth:NI-DAQ Setup|NI-DAQ Device properties}}
<div class="padded">
====Samples Per Event====
:{{Advanced}} ''Modifying this value is not recommended''. The Samples Per Event property determines how many samples are collected from the NI-DAQ device onto the hardware buffer before it gets delivered and plotted on Motive. When a very large number of analog channels are integrated in Motive, this setting may need to be increased to prevent dropped samples, but in most cases, the default setting should work fine.
==Device Properties: NI-DAQ Channel==
<div class="padded">
The following properties can be configured a analog input channel under a NI-DAQ device is selected from the Devices pane.
{{#lsth:NI-DAQ Setup|NI-DAQ Device Channel properties}}

Latest revision as of 16:25, 7 August 2018

Redirect to: