OmniCal Capture
Capture is the process of projecting structured light patterns and taking images of these to later use in the calibration process.
Overview
Capture is the process of projecting structured light patterns, taking images of these and detecting blobs within these images.
- Define the position & properties of cameras and projectors.
- Setup the Capture.
- Perform the Capture.
Workflow Example
Defining cameras & projectors
- Left-click the calibration editor from the stage editor to open it.
- Create a new Capture Plan by right clicking the capture plan to openthe capture plan manager, entering a name in the new plan field and clicking OK.
- Right-click the newly created capture plan.
- At this point, if you wish to do a simulated capture, set Use simulated cameras to Yes.
- Click the + icon to add each of your cameras to the plan.
- Right-click on each of the plan cameras. This will open up the Camera plan editor.
- Left click Mobile Camera and select the required camera from the list of available cameras.
- If you are doing a simulation, you can choose your virtual camera settings here.
- Click the + icon to add your projectors to the plan.
Setup capture
- Left click Setup Capture to open the Capture editor
- Set the blob size and the grid size.
- The blob is the size of the blobs we are projecting in pixels.
- The grid size is the number of blobs projected horizontally.
- Left-click Grid to see how many blobs are projected, and how well they cover the surfaces you are calibrating.
- Left-click on Blobs. A test blob detection will be performed highlighted in the camera views. The colour coding of the blobs is based on the colour of the projector wireframe. The blobs should be made as small as possible, whilst still being detected in this view.
- At this stage, you may need to adjust camera exposure for better blob detection.
- To adjust exposure, left click on the camera name and adjust exposure time in the camera plan editor.
- Ensure your Alignment level in the Capture setup is at a level where you can see the detail on your models clearly, as this image is the one that will be shown in Alignment.
Performing a capture
The stage should be clear.
No changing light levels.
No people walking across stage.
- Click Capture from the plan editor
- The system will perform a capture, the time taken will depend on number of projectors & cameras and whether projectors are converging or not. For example, 4 cameras & 4 projectors non converging takesroughly a minute.
- Verify the results of the capture by clicking View Capture.
- Left-click Blobs from the View Capture Editor.
- Verify the blob detection results are as expected. These results should be consistent with what you saw in the capture setup. If something went wrong with the capture (change in light levels, people walking across stage), then perform the Capture process again.
Camera Diagnostics
Available in the camera collapsible widget.
- This will only be enabled if there is a plan and there are plan cameras mapped to MV cameras.
The following is shown for info:
- Right-click heade to show columns:
- This displays camera stats and feedback of settings (such as IP, name). only displays plan cameras.
- Click Start Per Cam to enable stats feedback.
Visit this link for additional information about each of the specific stats.
Column descriptions
-
Frames incomplete is the only one measured by and provides some feedback to the user as to the stability of the cameras in vimbacamserver.This setting indicates that failed to validate the frame data or there may have been an exception when handling frame data from vimba api.
-
Green means cameras are ok and receiving data from vimbacamserver (with respect to the stats measuring incomplete frames between each receipt of stats).
-
Red means there have been incomplete frames between the last read and the current read. The count of incomplete frames will continue to increase. The red colour will reset if there have been no incomplete frames between each read of the stats.
-
Grey indicates the camera has been disabled.
-
Brown indicates the camera is disconnected/ offline.
-
Change mv camera BW to adjust bw per camera. This is split between cameras.
-
The graph button will show the stats in graph format.
-
Bandwidth allocation can be adjusted while diagnostics are running.
-
Dropped packets means you need to lower the bandwidth settings or there is a physical problem like a bad cable
Managing Plan data on disk
OmniCal’s Plan workflow stores a mix of data on the hard disk, rather than in the .d3 project itself.
This includes:
- OmniCal settings
- captured images
- calculated blob detection results
- calibration results
- alignment data
This data is stored in subfolders of the d3 project’s internal/opticalstageplan/ folder.
Every Plan has its own set of data, and its subfolder has the same name as the associated Plan object in d3.
The data in the internal folder is managed together with the d3 plan object: When the Plan object is deleted, and the d3 trash is cleared, any associated folder is also deleted from the harddisk.
If users want to compare the impact of different Plan setups or settings, it is advised to make a copy of the relevant Plan, make any desired changes to it, and then start a new Capture for this plan copy. This will allow users to switch between the two plans to understand the impact of their changes.