Please read the following page but be aware that your Dragonfly Application has been already configured properly by our team. So very likely there is no need to make any change to the parameters.
Dragonfly is a powerful positioning and navigation system that can be customized in different ways. The Configuration tab inside the Dragonfly Web user interface displays several parameters grouped into 4 sections:
- General settings
- Driving mode settings
- Webserver settings
- Advanced settings
Below you can find an explanation about the most important parameters of some of the above sections. Please remember to click on the Save Config and Restart button in order for the changes to kick in. The Dragonfly App and Web user interface will take up to 5 seconds to restart and apply the changes. If the page is not refreshed properly please force a manual refresh.
These are the General settings that must be changed before using Dragonfly:
- Camera mode – choose mono or stereo, depending on what type of USB or network camera you would like to connect to Dragonfly.
- Camera source – inside this field you will have to set the source of the video stream. The value of this field is a function of the type of USB or network camera connected.
- You will find out the right value reading the next pages of this documentation.
- Calibration file – the camera calibration file is a JSON file that contains the rectification parameters of your specific camera. This means that the quality of the camera calibration file affects the overall accuracy provided by Dragonfly! This drop down menu shows all the calibration JSON files found by Dragonfly inside your CONFIG folder.
- The calibration file can be easily created reading the next pages of this documentation. Do not use Dragonfly without a calibration file specific for your camera!
- Camera field of View (FOV) – inside this field you will have to put the right field of view specific for your camera.
- You will find out the right value reading the next pages of this documentation. Do not use Dragonfly without having set the correct field of view for your camera!
- Calibration method – this parameter allows to choose how Dragonfly should compute the position of your camera. You can choose between 2 options:
- No markers used (direct view only, no WGS84 or metric coordinates possible) – choosing this mode the Dragonfly Web User Interface will visualize the position of your camera as a drone moving inside a 3D space and will provide the position of your camera as un-dimensioned raw coordinates. Choose this option if you are running Dragonfly for your first time!
- Three markers used (either printed or virtual) – choosing this method you will be able to perform the geo-referencing of the map (using a floor plan + visual/virtual markers) and then the Dragonfly Web User Interface will visualize the position of your camera as a blue dot over your floor plan and will provide the position of your camera as metric coordinates (distance from the center of the floor plan) and as WGS84 coordinates (latitude, longitude). In addition to this Dragonfly provides the altitude in meters from the ground.
These are the settings useful when Dragonfly is used in production:
- Start on init – when checked, Dragonfly automatically starts the POSITIONING as soon as the Dragonfly App is launched.
- Override default map – this field allows to choose the default map (usually the best geo-referenced map) that will be loaded automatically when the POSITIONING is started or when “LOST STATE THRSHOLD” is reached.
- Override last loaded map as default map – this checkbox allows Dragonfly to load, as default map, the last loaded map as soon as the Dragonfly App is launched.
- Lost state threshold – this field allows to set a maximum number of seconds during which Dragonfly can stays in LOST state. After this time has passed Dragonfly will reload the default map (or the last loaded map if the setting is active). We have added this options because it is easier for the Dragonfly to get back in NAVIGATION status from the MAP INIT status than from the LOST status.
These are the most important Advanced settings of Dragonfly:
- Position upload store – this enables to store the position computed by Dragonfly on the Onit Cloud server, thus allowing you to get access to the positions history. An Internet connection is required at all times when enabled. The historical device positions can be:
- retrieved with Onit Resources “History” API.
- seen inside the Dragonfly Cloud Dashboard under Dragonfly > History
- Position upload interval – Number of milliseconds between two consecutive uploads of positions to the Onit Cloud server. The value of this field MUST be superior to 1000 ms. An Internet connection is required at all times when enabled. The real-time device position can be:
- retrieved with Onit Resources “Devices” API.
- seen inside the Dragonfly Cloud Dashboard under Dragonfly > Map.
- Position log – this enables to store the positions history of the device locally inside CSV files. The files are located under
/application/data/logsand the CSV file of each day contains every position the Dragonfly engine has computed for that specific day. The CSV file for the current day grows as the positions are computed and appended to the CSV file.
- Map fusion – this is an experimental feature and might not work for your environment. Leave it DISABLED!
- Map sync – this allows a local saved map to be saved also on the Onit Cloud server. Doing so, a map created by one device can be shared among all the other devices running other Dragonfly instances and connected to the same Site ID. More info here.
- Video recording – this enables the recording of a video of what the camera sees during each positioning session. The Onit Support team might ask you to activate this option and provide the raw video for debugging purposes. Please note that the video is recorded at the speed of the position system and not at a fixed standard frame rate, so if the system was running at about 14 FPS, the frame rate of the video is 14 FPS. Videos are saved inside the directory
application/data/recordedand grouped by Site ID.
- Camera image width – set it to 640. Do not set other values (regardless of the maximum resolution that can be handled by your camera)!
- Camera image height- set it to 480. Do not set other values (regardless of the maximum resolution that can be handled by your camera)!
For a deeper knowledge about the other configuration parameters available, please refer to the full documentation available under the Documentation tab of the Dragonfly Web user interface or at this link.