Calibration
Detailed instructions for camera system calibration and information about the Calibration pane.
Last updated
Was this helpful?
v3.2
Detailed instructions for camera system calibration and information about the Calibration pane.
Last updated
Was this helpful?
Calibration is essential for high quality optical motion capture systems. During calibration, the system computes the position and orientation of each camera and number of distortions in captured images to construct a 3D capture volume in Motive. This is done by observing 2D images from multiple synchronized cameras and associating the position of known calibration markers from each camera through triangulation.
If there are any changes in a camera setup the system must be recalibrated to accommodate those changes. Additionally, calibration accuracy may naturally deteriorate over time due to ambient factors such as fluctuations in temperature. For this reason, we recommend recalibrating the system periodically.
Prepare and optimize the capture volume for setting up a motion capture system.
Apply masks to ignore existing reflections in the camera view.
Collect calibration samples through the wanding process.
Review the wanding result and apply calibration.
Set the ground plane to complete the system calibration.
Full: Calibrate all the cameras in the volume 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 in the calibration of the cameras based on prior calibrations. This will solve faster than a Full calibration. Use this only if the cameras have not moved significantly since they were last calibrated. A Refine calibration will allow minor modifications in camera position and orientation, which can occur naturally from the environment, such as due to mount expansion.
Refinement cannot run if a full calibration has not been completed previously on the selected cameras.
Cameras need to be appropriately placed and configured to fully cover the capture volume.
Each camera must be mounted securely so that it remains stationary during capture.
Motive's camera settings used for calibration should ideally remain unchanged throughout the capture. Re-calibration may be required if there are any significant modifications to the settings that influence the data acquisition, such as camera settings, gain settings, and Filter Switcher settings.
Before performing a system calibration, all extraneous reflections or unnecessary markers should be removed or covered so they are not seen by the cameras. When this isn't possible, extraneous reflections can be ignored by masking them in Motive.
Check the corresponding camera view to identify where the reflection is coming from, and if possible, remove it from the capture volume or cover it for the calibration.
The wanding process is Motive's core pipeline for collecting calibration samples. A calibration wand with preset markers is waved repeatedly throughout the volume, allowing all cameras to see the calibration markers and capture the sample data points from which Motive will compute their respective position and orientation in the 3D space.
For best results, the following requirements should be met:
At least two cameras must see all three of the calibration markers simultaneously.
Cameras should see only calibration markers. If any other reflection or noise is detected during wanding the sample will not be collected and may affect the calibration results negatively. For this reason, the person doing the wanding should not be wearing anything reflective.
The markers on the calibration wand must be in good quality. If the marker surface is damaged or scuffed, the system may struggle to collect wanding samples.
There are different types of calibration wands suited for different capture applications. In all cases, Motive recognizes the asymmetrical layout of the markers as a wand and applies the dimensions of the wand selected at the beginning of the wanding process in calculating the calibration.
Unless specified otherwise, the wands use retro-reflective markers placed in a line at specific distances. For optimal results, it is important to keep the calibration wand markers untouched and undistorted.
Confirm that masking was successful, and the volume is free of extraneous reflections. Return to the masking steps if necessary to mask any items that cannot be removed or covered.
To complete a full calibration, deselect any cameras that were selected during the previous steps so that no cameras are selected.
Set the Calibration Type. If you are calibrating a new capture volume, choose Full Calibration.
Under the Wand settings, specify the wand type you will use. Selecting the wrong wand type may result in scaling issues in Motive.
Double check the calibration setting. Once confirmed, press Start Wanding to start collecting wanding sample.
Bring your calibration wand into the capture volume and wave the wand gently across the entire volume. Slowly draw figure-eights repetitively with the wand to collect samples at varying orientations while covering as much space as possible for sufficient sampling.
Marker Labeling Mode
When performing calibration wanding, leave the Marker Labeling Mode at the default setting of Passive Markers Only. This setting is located in Application Settings → Live-Reconstruction tab → Marker Labeling Mode. There are known problems with wanding in one of the active marker labeling modes. This applies for both passive marker calibration wands and IR LED wands.
For Prime series cameras, the LED indicator ring displays the status of the wanding process.
When wanding is initiated, the LED ring turns dark.
When a camera detects all three markers on the calibration wand, part of the LED ring will glow blue to indicate that the camera is collecting samples. The location of the blue light will indicate the wand position in the respective camera view.
As calibration samples are collected by each camera, all the lights in the ring will turn green to indicate enough samples have been collected.
Cameras that do not have enough samples will begin to glow white as other cameras reach the minimum threshold to begin calibration. Check the 2D view to see where additional samples are needed.
When all of the cameras emit a bright green light to indicate enough samples have been collected, the Start Calculating button will become active.
Pess Start Calculating to calibrate. The length of time needed to calculate the calibration varies based on the number of cameras included in the system and the number of collected samples.
Click Show List to see the errors for each camera.
The result is determined by the mean error, resulting in the following ratings: Poor, Fair, Good, Great, Excellent, and Exceptional.
If the results are acceptable, press Continue to apply the calibration. If not, press Cancel and repeat the wanding process.
In general, if the results are anything less than Excellent, we recommend you adjust the camera settings and/or wanding techniques and try again.
The Mean Ray Error reports a mean error value on how closely the tracked rays from each camera converged onto a 3D point with a given calibration. This represents the preciseness of the calculated 3D points during wanding. Acceptable values will vary depending on the size of the volume and the camera count.
The Mean Wand Error reports a mean error value of the detected wand length compared to the expected wand length throughout the wanding process.
The final step of the calibration process is setting the ground plane and origin for the coordinate system in Motive. This is done using a Calibration Square.
Place the calibration square in the volume where you want the origin to be located, and the ground plane to be leveled.
If using a standard OptiTrack calibration square, Motive will recognize it in the volume and display it as the detected device in the Calibration pane.
Align the calibration square so that it references the desired axis orientation. Motive recognizes the longer leg on the calibration square as the positive z axis, and the shorter leg as the positive x axis. The positive y axis will automatically be directed upward in a right-hand coordinate system.
Use the level indicator on the calibration square to ensure the orientation is horizontal to the ground. If any adjustment is needed, rotate the nob beneath the markers to adjust the balance of the calibration square.
If needed, the ground plane can be adjusted later.
A custom calibration square can also be used to define the ground plane. All it takes to make a custom square is three markers that form a right-angle with one arm longer than the other, like the shape of the calibration square.
To use a custom calibration square, select Custom in the drop-down menu, enter the correct vertical offset and select the square's markers in the 3D Viewport before setting the ground plane.
Motive accounts for the vertical offset when using a standard OptiTrack calibration square, setting the origin at the bottom corner of the calibration square rather than the center of the marker.
When using a custom calibration square, measure the distance between the center of the marker and the lowest tip at the vertex of the calibration square. Enter this value in the Vertical Offset field in the Calibration pane.
To have the most control of the location of of the global origin, including placing it at the location of a marker, we recommend setting the origin to the pivot point of a rigid body.
Create the Rigid Body.
In the Calibration pane, select Rigid Body for the Ground Plane. Motive will set the origin to the selected Rigid Body's pivot point.
The Ground Plane Refinement feature improves the leveling of the coordinate plane. This is useful when establishing a ground plane for a large volume, because the surface may not be perfectly uniform throughout the plane.
To use this feature, place several markers with a known radius on the ground, and adjust the vertical offset value to the corresponding radius. Select these markers in Motive and press Refine Ground Plane. This will adjust the leveling of the plane using the position data from each marker.
To adjust the position and orientation of the global origin after the capture has been taken, use the capture volume translation and rotation tool.
To apply these changes to recorded Takes, you will need to reconstruct the 3D data from the recorded 2D data after the modification has been applied.
To rescale the volume, place two markers a known distance apart. Enter the distance, select the two markers in the 3D Viewport, and click Scale Volume.
Note: Whenever there is a change to the system setup (e.g. cameras moved) these calibration files will no longer be relevant and the system will need to be recalibrated.
Enabling/Disabling Continuous Calibration
When capturing throughout a whole day, temperature fluctuations may degrade calibration quality and create the need to recalibrate the capture volume at different times of the day. However, repeating the entire calibration process can be tedious and time-consuming especially for a system with a large number of cameras.
Instead of repeating an entire full calibration, you can record Takes while wanding and takes with the calibration square in the volume and use those takes to re-calibrate in the post-processing. This saves calibration calculation time on the capture day because you can apply the calibration from the recorded wanding take in the post-processing instead. Offline calibration allows time to inspect the collected capture data, re-calibrating from a recorded Take only when signs of degraded calibration quality are seen in the captures.
Capture wanding and ground plane Takes. At different times of the day, record wanding Takes that resemble the calibration wanding process. Also record corresponding ground plane Takes with the calibration square set in the volume to define the ground plane.
Open the Take to be recalibrated.
Browse to and select the wanding Take that was captured around the same time as the Take to be recalibrated.
From the Calibration pane, click New Calibration.
In Edit mode, click Start Wanding. Motive will import the wanding from the Take file selected in step 3 and display the results.
Click the Start Calculating button.
(Optional) Export the calibration results by selecting Export Camera Calibration from the File menu. The results will be saved as an .mcal file.
Click Apply Results to accept the calibration.
Motive will move to the next step in the calibration process, setting the ground plane. If the ground plane is in a separate Take, then click Done and proceed to step 10. If the ground plane is in the calibration Take already loaded, then move to step 13.
From the Calibration pane, click Load Calibration...
Browse to and select the Ground Plane Take that was captured around the same time as the Take to be recalibrated.
From the Calibration pane, click Change Ground Plane.
Motive will display a warning that any 3D data in the take will need to be reconstructed and auto-labeled. Click Continue to proceed.
Partial calibration updates the calibration for selected cameras in a system by updating their position relative to the already calibrated cameras. Use this feature:
In a high camera count systems where only a few cameras need to be adjusted.
To recalibrate the volume without resetting the ground plane. Motive will retain the position of the ground plane from the unselected cameras.
To add new cameras into a volume that has already been calibrated.
Select the camera(s) to be recalibrated in the Cameras Viewport.
Select the Calibration Type. In most cases you will want to set this to Full, such as when adding new cameras to a volume or adjusting several cameras. When the camera moved slightly, Refine works as well.
Specify the wand type.
From the Calibration Pane, click Start Wanding. A warning message will ask you to confirm that only the selected cameras will be calibrated. Click continue.
Wand in front of the selected cameras and at least one unselected camera. This will allow Motive to align the cameras being calibrated with the rest of the cameras in the system.
When you have collected sufficient wand samples, click Calculate.
Click Apply. The selected cameras will now be calibrated to the rest of the cameras in the system.
Notes:
This feature requires the unselected cameras to be in a good calibration state. If the unselected cameras are out of calibration, using this feature will return bad calibration results.
Partial calibration does not update the calibration of the unselected cameras. However, the calibration report that Motive provides does include all cameras that received samples, selected or unselected.
Cameras can be modified using the gizmo tool if the Settings Window > General > Calibration > "Editable in 3D View" property is enabled. Without this property turned on the gizmo tool will not activate when a camera is selected to avoid accidentally changing a calibration. The process for using the gizmo tool to fix a misaligned camera is as follows:
Select the camera you wish to fix, then view from that camera (Hotkey: 3).
Select either the Translate or Rotate gizmo tool (Hotkey: W or E).
Use the red diamond visual to align the unlabeled rays roughly onto their associated markers.
Right click and choose Correct Camera Position/Orientation. This will perform a calculation to place the camera more accurately.
The OptiTrack motion capture system is designed to track retro-reflective markers. However, active LED markers can also be tracked with appropriate customization. If you wish to use Active LED markers for capture, the system will ideally need to be calibrated using an active LED wand. Please contact us for more details regarding Active LED tracking.
Motive opens the calibration layout view by default, containing the necessary panes for the calibration process. This layout can also be accessed from the calibration layout button in the top-right corner, or by using the Ctrl+1 .
The will guide you through the calibration process. This pane can be accessed by clicking on the icon on the toolbar or by entering the calibration layout from the top-right corner . For a new system calibration, click the New Calibration button and Motive will walk you through the steps.
The default grid size for the 3D Viewport is 6 square meters. To change this to match the size of the capture volume, click the Settings button. On the Views / 3D tab, adjust the values for the Grid Width and Grid Length as needed.
are advanced properties on the tab.
When the cameras detect reflections in their view, a warning sign appears in the view for those cameras that see reflections; for Prime series cameras, the indicator LED ring will also light up in white.
Masks can be applied by clicking Mask in the , and Motive will apply red masks over all of the reflections detected in the 2D camera view. Once masked, the pixels in the masked regions will be entirely filtered out from the data. Please note that Masks are applied additively, so if there are already masks applied in the camera view, clear them out first before applying a new one.
The will display a warning for any cameras that see reflections or noise in their view.
In the , click Mask to apply masks over all reflections in the view that cannot be removed or covered, such as other cameras.
Masks can also be applied from the Cameras Viewport if needed. From the Cameras view, click the gear icon on the toolbar to see . You can also click on the icon to switch to to manually apply or erase masks.
Masked pixels are completely filtered from the , which means the data in masked regions will not be collected for computing the . For this reason, excessive use of masking may result in data loss or frequent marker occlusions.
Wanding trails will show in color in the for each camera. As you wand, consult the Cameras Viewport to evaluate individual camera coverage. Each camera should be thoroughly covered with wand samples (see image, below). If there are any large gaps, focus wanding on those areas to increase coverage.
The will display a table of the wanding status to monitor the progress. For best results, wand evenly and comprehensively throughout the volume, covering both low and high elevations.
Continue wanding until the camera squares in the turn from dark green (insufficient number of samples) to light green (sufficient number of samples). Once all the squares have turned light green the Start Calculating button will become active.
Press Start Calculating in the . Generally, 1,000-4,000 samples per camera are enough. Samples above this threshold are unnecessary and can be detrimental to a calibration's accuracy.
As Motive starts calculating, blue wanding paths will display in the view panes, and the will update with the calibration result from each camera.
Tip: Select a Take in the to see its related calibration results in the . This information is available only for Takes recorded in Motive 1.10 and above.
When the calculation is done the results will display in the .
Once the calibration square is properly placed and detected by the , click Set Ground Plane. You may need to manually select the markers on the ground plane if Motive fails to auto-detect the ground plane.
The Vertical Offset is the distance between the center of the markers on the and the actual ground and is a required value in setting the global origin.
Align the Rigid Body's pivot point to the location you would like to set as the global origin (0,0,0). To align the pivot point to a specific marker, shift-select the marker and the pivot point. From the , click the Modify tab and select Align to...Marker.
Select the Rigid Body in the before proceeding to set the ground plane.
On the main Calibration pane, Click Change Ground Plane... for additional tools to further refine your calibration. Use the page selector at the bottom of the pane to access the various page.
Calibration files are used to preserve calibration results. The information from the calibration is exported or imported as an . Calibration files eliminate the effort of calibrating the system every time you open Motive. Calibration files are automatically saved into the default folders after each calibration. In general, we recommend exporting the calibration before each capture session. By default, Motive loads the last calibration file that was created. This can be changed via the .
The continuous calibration feature continuously monitors and refines the camera calibration to its best quality. When enabled, minor distortions to the camera system setup can be adjusted automatically without wanding the volume again. In other words, you can calibrate a camera system once and no longer worry about external distortions such as vibrations, thermal expansion on camera mounts, or small displacements on the cameras. For detailed information, read the page.
Continuous calibration is enabled from the once a system has been calibrated. It will also show when the continuous calibration last updated and its current status.
From the , click Load Calibration...
Select Custom for the ground plane type, enter the distance, select the three markers of the ground plane from the 3D Viewport, then click Change Ground Plane.
If is not enabled and a camera is bumped, use Partial Calibration to adjust the camera that is now out of place.
Open the and select New Calibration.
The Calibration Pane will display the . Repeat steps 2-7 until the results are Excellent or Exceptional.
Turn on if not already done. Continuous calibration should finish aligning the camera into the correct location.
A: This can occur if the capture volume was calibrated with the wrong selected, or if the volume was incorrectly .
If markers on the calibration wand have been damaged, please to have them replaced.
