Demo Training Data Project

An overview of Demo Train Dataset.

The Demo Train Dataset project is available for all users and can be found in the main menu under Edit projects. This project does not count towards your license.

This project is intended for people who are working in fields such as AI, remote sensing, data analysis, and urban planning.

This project showcases a method in the Tygron Platform to export a dataset for training a Mask R-CNN model..

The demo is a working project in which a number of areas are drawn, using a satellite overlay as underlay. These areas are marked with specific attributes, making it easy to export them as a training or test set using an export option in the Tygron Platform.

Train Dataset

Demo Train Dataset is a project that contains shapes of foliage, drawn as areas on top of a satellite image. These areas, in combination with satellite images, can be exported as a dataset for training a Mask R-CNN model. Such a model can then be applied to a different project location to detect foliage. A specific use-case is detecting foliage on private property, such as gardens and private yards.

• 
• 

Export a dataset

This how-to explains how to generate an AI Training Data using the Tygron Platform. This data can be used to train your own AI model.

Demo Training Data Project:

1. Open a project in editor mode using the Tygron Client Application
2. Optionally add a Satellite Overlay. This overlay will be used to export train images for the dataset.
3. Determine what [item] type will be used to export a dataset for. For example Foliage areas drawn on top of the satellite overlay.
4. Select the Export Geo Data option in the Ribbon bar popup of the selected item type. For example: Hover over Areas and select Export Geo Data
5. Under Format, select the option AI Training Data PNG
6. Filter items with an attribute, such as FOLIAGE
7. Optionally select a prepared Intersection Area, for example a TRAIN_LIMIT_AREA.
8. For the Overlay, select the preferred Overlay, for example the Satellite Overlay.
9. The image size can increased, as long as the amount of expected features within the image does not exceed the maximum amount of 250.
10. The stride can be kept at 50%
11. Click on the Export Files button
12. Select a suitable folder for the generated dataset.
13. Wait until the dataset is fully generated.

• 
  Configuration of the Export AI Training Data as PNG's for Foliage Areas on a Satellite Overlay, with an intersecting area.

Notes

• In case the export folder is not empty, a confirmation popup will appear on overriding the existing image, label, mask and bounding box files.
• In case a region intersects the limit area, but does not contain any features, it is still exported as a dataset-entry (image-, label-, mask- and bbox-file) but without labels, mask pixels or bounding box entries.
• In case the feature density is low, the image size can be increased.
• In case the feature sizes are small compared to the image size, the stride can be increased.
• A dataset can also be generated as AI Training Data CSV, which allows users to directly train on float matrices instead of color images.
• When the intended background image is not the satellite image provided by default but some other image or set of data, it is also possible to select a WMS Overlay referencing an external map service, or a Combo Overlay, the COLOR function of which can be used to compute a custom image with.

How-to's

• How to train your own AI model for an Inference Overlay

See also

• Demo Training Data Project
• PyTorch
• Satellite Overlay

Train your own model

A Tygron AI Suite is available at github. This repository contains the necessary files to configure a Conda environment to train a new Mask R-CNN AI model.

Conda-forge's Miniforge will be used to manage a Conda environments and run Jupyter Notebooks with python.

Example notebooks provided in the repository can be used as a basis to train your own model.

TygronAI yml-file provided in the repository can be used initialize a Conda Environment. It includes Pytorch and Jupyter Notebook.

Demo Training Data Project:

1. If you are not familiar with github, you can download the zip containing all the files that you need. Otherwise, clone the git repository
2. Optionally unzip and open the folder containing the downloaded files; the local repository. Copy the path to this directory.
3. Download and install Miniforge.
4. Open the Miniforge Prompt application.
5. Change the directory to the path of the local repository. For example

   cd user/git/tygronai/

   This directory should contain the tygronai.yml file.
6. Create and initialize a new conda envirmonment with the tygronai.yml file using:

   conda env create -n tygronai -f tygronai.yml

   and press enter to confirm.
7. Wait for the downloads and unpacking to complete.
8. Activate the create tygronai environment using:

   conda activate tygronai

   The name (tygronai) should now have appeared in place of (base) in front of the prompt.
9. Start the Jupyter Notebook application by typing:

   jupyter notebook

10. A browser will open with the Jupyter Notebook application.
11. The application should open in the tygron ai repository folder. If not, browse to the folder of the tygron-ai-suite repository.
12. Once in the correct folder, select the "example_config.ipynb".
13. Adjust the following parameters:

    trainDirectory = "PATH TO TRAIN FILES"

    testDirectory = "PATH TO TEST FILES"

    to the folders containing the exported datasets. See how to export AI datasets for more information.
14. Press the double arrow button named Restart kernel and execute all cells to run the Jupyter Notebook. See the images below of what to expect.
15. Eventually an ONNX file will be created.

• 
• 
• 
• 
• 
• 
• 

How-to's

• How to export AI Training Data
• How to train your own AI model for an Inference Overlay