The following pages deal with the Dragonfly Java application. It assumes that the reader already had a basic experience with Dragonfly, by experiencing one of the 3 Dragonfly Demo Applications listed inside the left sidebar.

In order to use the Dragonfly Java application, you have to ensure that some requirements are met:

1 – Accuware account

In order to run the Dragonfly engine you need a valid set of Accuware credentials (username, password and a Site ID) . To get a new set of credentials and a Site ID, please open a Dragonfly free evaluation site filling the form at this link.

2 – Hardware

In order to run the Dragonfly engine with proper performances, the camera and the computing unit on which the Dragonfly Java Application will run must meet the following specifications.

2.1 – Computing unit

The MINIMUM hardware requirements to properly run the Dragonfly engine are these:

CPUmodern 64 bits CPU with at least 4 physical cores (e.g. AMD Ryzen 3, Intel Core i5-8250U or a generation below if it has 4 cores). WARNING: a processor with 2 cores and 4 threads is NOT considered as a 4 physical cores CPU
OS -Ubuntu 18.04
-Ubuntu 16.04
-macOS 10.13
Please don’t use Virtual Machines unless you are sure that you will keep a high a level of performances (no CPU emulation).
Storageat least 20 GB of free space for the installation of the Dragonfly Java App + the additional space function of the size of the environments mapped
GPUnot used at present

Different OS: the Dragonfly Java Application is meant to run on Linux and macOs versions listed above:

  • If you want to try the Dragonfly Java Application on different Ubuntu and macOS versions feel free to do it and to share your results with us using this form.
  • If you need the Dragonfly Java Application to run on other OS (different from Linux and macOS), please contact us using this form and we can discuss the custom development costs of a specific Dragonfly version for your OS.

2.2 – Camera

2.2.1 – Monocular or stereo camera?

Here are some recommendations stating when stereo or monocular cameras should be used:

We recommend a monocular camera when:

  • the machine running the Dragonfly Java App has a relatively weak computing power (see table above);
  • the environment can be mapped in advanced;
  • the relocation potential in the venue is high;
  • the camera will be pointed upward (to the ceiling). Pointing the camera to the ceiling is a very effective way to do navigation in populated locations. Like shown in this video of Dragonfly used in production on a forklift inside a warehouse.
  • the device has to perform pure rotations ONLY on the camera optical axis (a.k.a ROLL rotation). In the monocular case, pure PITCH and YAW rotations must avoided. This is a mathematical limit that affects every pure vSLAM system (not only Dragonfly). It is not possible to triangulate the features seen by the camera if the images of the camera are taken from the same location and different angles. These are the possible options to overcome this limitation:
    1. Use a wide angle camera – this does not solve the problem but allows to perform much bigger turns before the system gets lost (because the already triangulated features stay longer in sight of the camera).
    2. Point the camera to the ceiling – this works much better if this camera is wide angle, if the ceiling height is low or of a uniform color.
    3. Perform turns with a non-zero bending radius (like a car) – because in this case the camera translates while it turns.
    4. Use a stereoscopic camera.

We recommend a stereoscopic camera when:

  • the machine running the Dragonfly Java App has a decent computing power (see table above);
  • the navigation is NOT always going to happen in a previously mapped venue;
  • the camera can be pointed forward or backward;
  • the device has to perform pure rotations on the 3 axis (PITCH, YAW and ROLL rotations). When using a stereoscopic camera, the baseline (i.e. the distance between the 2 cameras) allows Dragonfly to perform the triangulation of the features whatever happens;

2.2.2 – Which monocular or stereo camera?

The camera used to perform the positioning must have:

  • Resolution: any resolution above 640 x 480 at 60 Hz.
  • Color depth: RGB or grey-scale.
  • Focal length: constant.
  • Auto-focus: limited or disabled.
  • Field of view (FOV): from 70 degrees to 180 degrees (wide angles are preferable).
    • NOTE: a higher FOV allows the position to be more consistent and the device to move faster, but it decreases a little bit the accuracy of the position. That said, in our opinion, the loss in accuracy is negligible compared to the gain in positioning consistency. We would not recommend narrower FOV just with the goal of having an accuracy 1 cm better if it disallow the device to move at a proper speed and if the position is lost every 20 seconds because the camera doesn’t see enough features due to the narrow FOV.
WaterproofNoNoYes (IP66)No
FOV180º 180º 170º 180º
InterfaceUSB 2.0USB 2.0USB 2.0USB 3.0
Model nameELP-USBFHD01M-L180ELP-USBFHD01M-BL180Fisheye USB Camera with Waterproof caseCaliCam® Fisheye Stereo Camera
Recommended Price45 USD48.99 USD189.99 USD139 USD

If you have already a monocular or stereo camera please send us the exact model of your camera using this form and we can give you our feedback about that.

Stereo cameras made of 2 monocular cameras: it is possible to use 2 monocular cameras to create a stereo camera. In this case the 2 monocular cameras MUST remain fixed on a rigid body and NEVER move after the calibration process done with the Accuware Calibration tool.

3 – (OPTIONAL) Accuware Dragonfly Demonstration kit

To facilitate the evaluation of the Dragonfly Java Application, it is possible to purchase from Accuware a ready-to-use demonstration kit including all the required software (Dragonfly + camera calibration file) and hardware (mini PC + monocular or stereoscopic camera).

The advantage of purchasing this kit is that you will speed up the test process given that:

  • We will assemble for you the required hardware inside a mini PC.
  • We will install and configure for you the Dragonfly software.
  • We will perform the calibration of the monocular or stereoscopic camera sent with the kit.

This means that all what you will have to do:

  • proceed with the mapping of your environment.
  • enjoy the centimeter accuracy provided by Dragonfly!
Purchase your Dragonfly Kit inside our store

An example of the Accuware Dragonfly Demonstration kit with
a monocular Fish eye USB Camera with Waterproof case and a mini PC