POIStudio Dokumentation
Hinweis: diese Seite befindet sich im Aufbau.
Grayscale Value Settings
To the right of the currently selected thermal image of a flight, you will find the histogram showing the distribution of color values within the image. The slider allows you to adjust and narrow down the displayed range, so that only a specific range of grayscale values is shown. Depending on the range setting, bright or warm objects are thus much more clearly delineated from their surroundings. This process is further illustrated in the video.
The dot below the histogram is the reference point. It indicates the expected size of animals (e.g., fawns) or objects. It adapts to the zoom level of the currently displayed thermal image and can be configured in the settings depending on the application area.
Clicking this icon allows you to import images from one or more flight mission(s) into POIStudio. To do this, either the drone must first be connected to the PC via USB, or, if the images are stored on an external SD card, this memory card must also be read out by the PC.
In the window that now opens, you can select the appropriate drone model to make preliminary settings for sorting the images to be imported. By default, the DJI Mavic Enterprise 3T is selected. To import a flight, first select the correct file path where the flight images are stored. This can be done by clicking Browse… (1). By pressing the Select Folder (2) button, the current folder is set as the upload directory, and the flight appears in the previous selection window. Clicking OK (3) and confirming the question of whether VIS images should be imported into the local file folder (4) starts the file import.
This function allows you to run an AI detector over the thermal images. This is currently primarily available for fawn rescue. After selecting the function, the detector window appears, where settings for the corresponding AI model can be made. An external model can be added via the Browse… button (1). In the default configuration, there are the categories “no_fawn” and “fawn”, for which a threshold (Threshold) and a display color (Color) can be selected. The visibility of points found by the AI on the thermal images can be activated/deactivated using the checkmark symbol in the Visible field.
Clicking OK (2) starts the AI detector, which evaluates the individual thermal images and marks findings in the specified color.
Attention: Prior registration on POICloud is required! Simply click the Login button (1) and enter your login details. After successful login, you can upload POIs to POICloud. In the now open window, select which Team (2) and which active Field (3) the POIs should be added to. For the latter, you have the option to either add the markings to an existing field (4) or create a new field with the selected POIs (5). When creating a new field, it is necessary to enter a field name in the corresponding input window (6). If required, a flight description (7) can be added.
By checking the Upload Images (8) box, the thermal image on which each POI is marked will be added to it.
Clicking OK (9) starts the upload to POICloud.
This allows you to export selected thermal images of the current flight, including any markings. After clicking the icon, the export window opens. First, the export path is defined. By default, the export folder within the POIStudio installation directory is selected. The file path can be customized as desired via Browse (1).
Subsequently, you can specify whether the original file name (2) should be retained during export or if an individual name prefix should be used. This can be adjusted via the corresponding text field (3).
Under File Format (4), the export format for the image(s) is set. Available file formats are JPG and TIFF.
Clicking OK (5) starts the export.
The flight plan converter can be used to generate flight paths either with POIs from the current flight (1) or from existing QGroundControl files (2). When creating a flight path from set POIs, the approach altitude and hover altitude must be specified.
When importing a QGroundControl file, the file path where the file is located must be selected.
Next, the appropriate drone model is selected from the list of aircraft. By default, the DJI Mavic 3T is set.
After defining the target directory and clicking Convert (4), the flight plan conversion begins.
When this icon is selected, POIStudio converts the image file from 8-bit to 14-bit. This means the image contains much more information and allows for a significantly better representation of contrasts. In addition, the three adjacent image optimization functions are unlocked:
Applies a high-pass filter to the selected thermal image. This allows deeper localized frequencies to be better represented.
Homogenization is particularly helpful when wide, warmer objects (e.g., roads) are present in the image. The warmer areas are filtered out, providing more values for increased contrast and enabling better differentiation between white and black values.
This is a classic image optimization algorithm that redistributes color values in the histogram. This primarily provides stronger contrasts in scenarios not necessarily related to wildlife rescue.
This allows you to show or hide all set POIs on the selected image.
This allows you to show or hide reprojected POIs – meaning all POIs that appear in multiple images.
If the AI function is used, it automatically creates markings around the detected objects. (See Apply AI). These can be shown or hidden using the button.
When importing thermal images, the option Import VIS Images can be selected as yes or no. If yes is selected, the corresponding color image can be displayed for each thermal image. The slider next to the button allows for adjustment of the blending. Especially in the area of breeding bird protection, this function is very helpful for checking a clutch.
By clicking the camera icon, the view can be switched between IR and VIS images.
Left Workspace
Flight
This table overview lists all imported flights. All basic information is also available here. This includes, for example, the name of the flight mission, the number of currently set POIs, or the flight date.
Furthermore, the flown area and the number of images contained in the flight can be read.
In the Terrain tab, a checkbox can be clicked to enable the display of a terrain model.
Under the Upload tab, it is noted whether the flight has already been uploaded to the cloud or not.
Image List
The image list displays all imported thermal images of a flight. Individual images can be selected either by left-clicking on the respective image or by pressing the arrow keys on the keyboard.
The display size within the list can be adjusted by clicking one of the three following icons:
Right Workspace
Map
The map view allows you to track the flight path. The drone’s position on the map always corresponds to the coordinates of the currently selected image. Clicking the Aircraft icon (1) zooms the map to the current drone position. Clicking the zoom-to-fit icon (2) adjusts the map to the current flight.
In the adjacent Drawer Menu (3), the map view can be changed. The desired display variant can be selected here from a list of different providers.
Offline maps can be downloaded via the Map icon (4). To do this, follow the steps provided in the window that opens: First, enter the desired location and then click the Draw Rectangle button. You can now select the desired area on the map. If necessary, a Grid Preview can also be created. In the next step, the map can be configured. In addition to the map data source and a map name, the zoom range for the selected section can be chosen.
Clicking Download will download the map. Depending on the size of the selected area, the download may take a little longer.
Set POIs appear as green flags in the map view. If the POI is selected in the list, the flag on the map turns red.
Info
The Info tab lists all captured information for the selected image at the time of capture. This includes, among other things, the drone model, image number, image resolution, associated coordinates, and gimbal position.
POIs
All set POIs appear here, sorted by creation time. Double-clicking the POI section allows you to customize the name. This name will also appear in the corresponding field view in POICloud and POIApp after uploading to the cloud. Additionally, information such as the associated coordinates or the number of the image in which the POI is located is stored here. A comment can be added if required.
QR
If a POI is selected from the list, a QR code is generated for it in the QR Code tab. This can then be scanned with the POIApp to capture the POI’s coordinates and navigate to it.
Data Upload
If you wish to contribute to the further development of our software and the training of POIStudio’s AI, you have the option to upload and share the thermal images with us.
This is possible in this tab. Here, either the currently selected flight or an external folder directory can be chosen for the upload.
Upload Selected Flight
First, the Flights upload (1) field must be selected. Afterwards, all previously marked flights with their associated thermal images can be uploaded. The upload begins by clicking Start (2).
Upload External Flight Directory
To upload an external flight that has not been imported into POIStudio, you must first click the Directory Upload option (1). Pressing the Search… button (2) opens a window to select the corresponding file path where the image data of the flight to be uploaded is located. To confirm the selection, simply click on Select Folder (3). Clicking Start (4) starts the file upload.
Further actions
In addition to the functions of the action bar, further setting options can be accessed via the individual categories of the ribbon.
File
View
In the View tab, the user interface of POIStudio can be customized. The individual elements can be shown or hidden as required. This means that only the information that is actually required is displayed.
Settings
All general settings for POIStudio can be made here. This concerns, for example, the application language or the display colors for POIs.
General
In the first tab, you can set the application language, among other things. Currently, German and English are available for selection. Furthermore, the Expert Mode can be activated by clicking on the corresponding box. This unlocks the options for image optimization (see above).
If the Inform about updates box is selected, information about new versions will appear when the application is started.
In the Database section, the Show archive option can be selected. If this option is active, all POIs that have been archived will be displayed again. In addition, the file path for the application database can be specified and adjusted here.
In the section for the thermal DRONES app or POIApp, the options for uploading thermal images for POIs can be adjusted.
Image
In the image settings, it is possible to adjust the reference object radius, among other things. This serves as an indicator for objects to be identified on the thermal image. For example, we recommend a radius of 15 cm for fawns. This value varies depending on the application.
In addition, the maximum file size of the imported thermal images can be adjusted.
Note: In order to access the full information content of the images, the Use raw data option should definitely be activated!
Under the Cloud Upload section, you can specify the image section around the POIs that you want to transfer to the POICloud. To avoid large amounts of data, we recommend keeping the default values.
POIs
Here you can adjust the settings for POIs. Among other things, the UAV yawing option can be activated/deactivated for camera calibration. If the src tag is to be saved when exporting the POIs as a gpx file, this option can be selected in the GPX section.
Under the Map item, the number of POIs that can be displayed is adjustable.
If different display colors are desired for the individual POI categories, these can be adjusted in the Colors area.
Import
In this section, the image import settings can be adjusted.
Under the All item, the maximum distance between images of a flight can be adjusted. If the specified value exceeds the default value of 500 m, it is recommended to split the flight.
Under VIS, the import of color images in addition to the IR images can be activated/deactivated. If the question of whether VIS images should be imported should no longer appear during import, the option can be deselected here.
When importing images taken with a DJI Mavic 2, a restructuring of the directory structure is required during import. The parameters under which this should be carried out can be specified in the Mavic 2 area.
Median
If the geometric median is to be applied to the image view, activation is possible in this window.
After successful activation, the following symbol appears in the action bar:
In this settings menu, the display parameters of the imported color images can be adjusted.
To show the color images, the box in the enable VIS field (1) must first be checked.
Under Image Size, the resolution of the respective color images is adjusted. By default, a resolution of 4000 x 3000 pixels (12MP) is set here. The image center can also be varied by specifying the pixels under CenterPixel.
The display scaling of the color images can be changed by specifying the scaling factor. The default value here is 0.25.
In the Drone Model tab (2), the appropriate drone can be selected from a list of supported models. To do this, simply open the adjacent drop-down menu.
If the values of the respective parameters are to be reset, this can be done by clicking on reset (3).
The set parameters are applied by selecting the apply button (4) and the window closes again with Ok (5).
Within this menu, it is possible to select various options for sensor correction. The following corrections can be made in the current version:
SDCardDelay
Compensates for any delays that may occur during write and read processes on the SD card.
GimbalYaw
Corrects any errors that may occur in the gimbal yaw.
CorruptedGimbalData
In the case of flights carried out with the DJI M4T, faulty gimbal data often appears. The values for roll and yaw are given as 180° each, although they should be at 0°. As a result, set POIs appear to float in the air and the following error message appears:
When importing flights with faulty gimbal data, a dialog window appears asking whether the flight data should be corrected. The correction is carried out by clicking on Yes:
Here, too, it is possible to reset the corrections made using the reset button (1). The selected corrections are carried out and applied to the current flight by clicking on apply (2). To close the window, either the cross or the Ok button (3) can be used.
After selecting the apply button, a new window appears to adjust the gimbal correction. This sets the faulty values to the default values and POIs can be set and marked as usual again. The correction is applied to all images within a flight where the roll and yaw values are within the selected range. We recommend keeping the default settings here.
The correction is carried out by clicking on Ok.
In the camera calibration, various settings can be made to configure the drone camera and the display within POIStudio. The calibration is divided into 3 blocks: General, inner orientation and outer orientation.
General:
Information on the drone currently in use is stored here. This includes, for example, the model name and the serial number. In addition, it is possible to see on which date and at what time the flight was imported. In the Description field, a note on the settings that concern the drone can be made if required.
Inner Orientation:
All settings relating to the drone camera are stored here. If the Expert mode (1) is activated, the image width and height can be adjusted here, among other things. The image center can also be changed. In normal mode, only the orientation can be adjusted.
Outer Orientation:
In this area, the settings relating to the drone’s gimbal can be adjusted. These include, for example, the degree of offset when yawing or tilting the gimbal. When the UseFlightYaw box (2) is selected, the values of the flight are adopted.
The default settings are restored by clicking on Reset (3).
To apply the entries, the Apply button (4) must be clicked.
