Full UI - Camera Bar to Main

this page describes how to calculate the witness to main calibration when using the full ui there are two different methods available, the liveupdate method and the chart based method the liveupdate method generally gives better results and is recommended liveupdate method the liveupdate technique is the preferred method of calculating the witness to main relationship it works by using the features detected in the tracking environment as well as any fiducial anchors that are present to align the camera bar and main camera the technique will work without a fiducial anchor being present, but it is strongly recommended to use one as it will vastly simplify the procedure process start the system tracking position a fiducial anchor in the environment and make sure it is detected by the camera bar pan/tilt the camera or translate it, this allows it to generate some additional tracking points position the main camera so that it can now view the fiducial anchor from the top menu bar choose devices>main camera>liveupdate in the augmented reality view the point cloud will be displayed over the main camera image if the step is successful return to the devices>main camera>liveupdate option and disable it the following video covers the entire process chart based method legacy this is an alternative technique that utilises a calibration chart it involves taking a series of pictures of the chart while it is in view of both the main and witness cameras to calculate how the cameras are positioned relative to each other while this method is perfectly valid we typically advise to use the liveupdate method as it allows more flexibility in the mounting of the ncam camera bar, the chart based method requires the chart to be visible in both cameras at the same time, meaning this technique won't work if the camera bar is tracking the ceiling for example process from the top menu bar select devices>main camera>camera bar to main relation the camera relations view will displayed from the dropdown select the chart you are using, the a3 1 is recommended press start position the chart so that it is seen by both cameras and the coloured pattern overlay is displayed on the chart press f12 or click the use current button, to take a picture, repeat this until you have around 10 pictures the number of images taken will be displayed in the "images" field press calibrate a calibration error value will be displayed, it will be colour coded depending on quality press save to confirm the calibration, pressing cancel will exit without saving if a mistake has been made, pressing " reset " will set the picture count back to zero saved values the values generated from the calibration are displayed within the system status tab of the gui they are nested under the witness main relation > rigid transform drop down the values are user editable, so some care should be taken to not accidentally alter them a save and load button are provided here also, these allow the current values to be saved as a global default checking the calibration it is generally good practice to check the result of the witness to main calibration after conducting any of the methods for calibrating it how does a bad calibration appear the most obvious feature of a bad witness to main calibration is the ncam cube not being correctly aligned with the selected zero point, when the zero point is in the centre of frame additionally the ncam cube will move inconsistently with the camera observe how in the above image the axis of the zero point are not consistent between each image how does a good calibration appear how to check the most straightforward way of doing this is by using the “ image modelling view ” (shortcut f8) the image modelling view allows the user to view the position of the zero point from both the witness camera perspective and also the main camera perspective this means that if there is a discrepancy between the two views then the calibration has not been successful to see a view from the main camera in the image modelling view, press f this will take a snapshot from the main camera which can be viewed in the main camera tab of the filmstrip a quick, but less accurate way of checking the witness to main relationship is by using the 3d view (shortcut f6) in this view the camera bar and main camera are represented in 3d, their positioning should be correct relative to each other this technique while convenient does not provide a very accurate way of checking the alignment, and should not be relied on