Configuring the Arbitrary2D Environment in AntilatencyService

Configuring the Arbitrary2D Environment in AntilatencyService

The layout of Arbitrary2D Environment is configured after the IR markers are physically placed on the working plane. Use the Environments tab in the AntilatencyService app to create or edit an Environment.

Configuration steps

  1. Place markers on the working plane.
  2. Create a layout of IR markers in AntilatencyService.
  3. Place markers on the layout as they are approximately located in the room.
  4. Align IR markers placement on the layout by setting constraints and optimization.
  5. Calibrate the layout.

IR Markers physical placement

Let's take a look at the Arbitrary2D Environment configuration. It is assumed that the IR markers are already physically placed in the room and they are strictly in the same horizontal plane.
Try to keep a balance between the asymmetry and evenness of the marker distribution. This affects the main parameters of the Environment, you can read more about it in the Environment article.

Creating an IR markers' layout in AntilatencyService

To create a new Environment in the AntilatencyService app, click on the + button in the lower right corner and select the New environmentmenu item. Then select the Arbitrary2D type and specify an Environment name.
Then you should configure the Environment parameters:
By default, the camera in AntilatencyService looks at the layout from above, as if at a room plan. There are usually no difficulties in transferring the location of the markers on the floor to the layout, but you should watch out for the default camera view when copying a ceiling placement.
Controls in AntilatencyService:
  • use the mouse scroll wheel to zoom the layout in/out;
  • click and hold the middle mouse button to move the visible part of the layout;
  • hold the right mouse button to change the layout tilt angle (camera movement);
  • double-click the right mouse button to return to the default view.
If you are looking at the ceiling placement of markers from below, you can move the camera under the plane to check them on the layout in AntilatencyService. To do this, click and hold the right mouse button and move the layout as shown in the animation:

Placing the IR markers in the editor

The origin of the coordinate system is located between the first two markers. The step of the coordinate grid is 1 meter. These markers move synchronously along the X-axis only. They can be used to set the center or the edge of the layout.
Next, add the remaining IR markers to the layout. The order is not important, but try to keep their approximate relative position. There are two ways to add markers and change their position:
The top two rows in the Environment data text block are the coordinates of the first pair of markers. The rest are the green markers in random order. After making adjustments, click on the Apply Data button.

Setting constraints and optimization

To align marker positions in the editor to their physical positions, optimize the layout. In order to do this, use the Constraints tool for marker pairs.
To create a Constraint, follow these steps:
  1. Measure the physical distance between 2 adjacent IR markers placed in the room. You may do so by using a regular or a laser measuring tape. The measurements should be made in the centers of the markers.
  2. Select these markers in the editor window (using the mouse area selection or the Shift + left mouse button shortcut).
    In the Android version of AntilatencyService, press the Ctrl button, and then tap the required markers.
  3. Press the ADD CONSTRAINT menu button (or the Ctrl + Q keyboard shortcut).
  4. Set the measured distance between the centers of these markers in meters (ex. 1.275).
An arrow with dimensions between the markers will appear. The upper number is the measured distance between the markers, and the lower number is the distance on the layout.
Repeat the process for the remaining pairs of IR markers. For optimization to be effective, the Constraints' lines must form a rigid shape. The more measurements there are, the better; we recommend at least three for each marker.
Measure the distances between the markers, which correspond to the different colored markers on the layout as accurately as possible!
After you have made all the measurements and added them to the Constraints on the layout, click OPTIMIZE to automatically correct the position. Make sure that all the Constraint lines have turned green.
Remember to save the layout changes (the SAVE button in the upper right corner).

Calibrating Environment

Calibration can’t be used instead of layout optimization! It corrects the position of the IR markers on the layout only if they slightly deviate from their actual location.
To perform an Environment calibration you will need: an Alt, a Universal Radio Socket and a Tag or a Bracer.
  1. Click the DEVICE NETWORK tab in AntilatencyService.
  2. Turn on the devices, check they are displayed in the device tree. If they don't appear, use the instructions: How to configure Antilatency wireless devices.
  3. Go back to the ENVIRONMENTS tab, select your layout, click Edit.
  4. Click the CALIBRATE button.
Next, take a Tag or a Bracer with an Alt and prepare to walk around the tracking area while calibrating. You must move the socket so that the Alt sees the tracking area from as many angles as possible (different positions and rotations).
  1. Press the BEGIN COLLECTING button.
  2. Turn on the socket with an Alt, walk around the tracking area until you get about a 1000 frames (Frames count field).
  3. Press the STOP COLLECTING button.
  4. Use the selected sample field to select positions that look like tracking errors (incorrect peak points in the tracker path) and delete them (REMOVE SELECTED button).
  5. Now pay attention to the Mean sqr error field. Press the CALIBRATE button and then the value of Mean sqr error should decrease at least by an order of magnitude, and preferably to 0.
  6. If the Mean sqr error is still greater than 0, press CLEAR DATASET and repeat the calibration algorithm.
You can see how accurately the beams from the Alt tracker hit the markers by moving the slider along the selected sample line. If no beam hits a marker, then the distances between this and other markers should be measured again.
If no tracking data has been captured during calibration, try to measure the distances between markers more accurately or inspect the layout for features. If the measurements were carried out with a lot of errors, the Alt tracker will not be able to match the layout and the actual location of the markers.
The calibration is successful if most of the beams enter the markers accurately and without deviations when approaching, and the Mean sqr error value has significantly decreased or is equal to 0. After successful calibration, click the back arrow and the APPLY button in the pop-up window. Then save the changes (SAVE button).
Now the Arbitrary2D Environment layout corresponds to the actual location of the IR markers in the room. The configuration of this Environment is completed.
Remember to set your layout as a default Environment. You can see the instructions in Environments.