Docs
Forest Loop Documentation

Forest Loop Documentation

Guidance on how to run ForestLoop

ForestLoop is an architecture to train supervised classification models for land use land cover that are locally calibrated for a project area. The architecture enables a GIS expert to tag satellite imagery, run the classification, and iterate on that process until the classification is adequate.

1. Load & Configure Forest Loop

To load ForestLoop open the Analysis Modal and in the Land Cover section select "Land Cover (single year)". 01 - Find ForestLoop

This expands the computation options to configure including the start date, end date, data source, sample radius, and satellite composites. The configuration affects the timing of imagery selected, how the model chooses tagged points to include in training, and which data the model is trained from.

02 - ForestLoop Configuration The "Data Source" chooses which labeled points to include:

  • Auto: automatic algorithm without user tagged points
  • Polygon: your labeled points inside the polygon + sample radius
  • Crowd-sourced: all user-labeled points inside the polygon + sample radius
  • Global: use all verified global points

The "Sample Radius (km)" changes the search radius for fetching sample points from the database around the geometry centroid. This is applicable for "Data Source" types "Polygon" and "Crowd-sourced".

The Satellite Image Composites chooses which land composite map to run the algorithm on. Options include:

  • Landsat 8
  • Sentinel-2
  • Alpha Earth Embeddings

After making selections to configure the computation, click the "Run analyses" button to start the computation.

The computation will move through Queued -> Pending -> Completed. Once the computation is "Completed" then it is ready for use. 03 - Access ForestLoop

Click on the computation to enter ForestLoop. 04 - Enter ForestLoop

Upon entering ForestLoop, the left Summary panel will read "No widgets found" and the main map will display a classification. This classification is the default ForestLoop classification model. In some cases, this will be a sufficient land use land cover model. To start labeling points, select "ForestLoop" in the left panel.

05 - Toggle LULC model Toggle between the LULC classification and the high resoluiton basemap using the eye icon in the Map Settings, Active Layers, "Land Cover Map". This map will also contain the year that the computation was configured for.

2. Prepare Satellite Data

To label points, satellite imagery from a defined source and time period must be loaded. The basemap provides a high resolution reference but may not be from a time that is relevant to the classification. 06 - Prepare Satellite Data

To add the satellite imagery to the Active Layers, navigate to the Available Layers section and select the relevant imagery and time window.

3. Label Points

To start labeling points, toggle the satellite imagery to be used as the composite using the eye icon. In the map panel, click Edit Points. This opens the labeling toolbar. 07 - Label Classes The labeling toolbar contains 10 LULC classes:

  • Degraded
  • Forest
  • Water
  • Built
  • Savannah
  • Clouds
  • Degraded Forest
  • Bare
  • Grassland
  • Shrubland

The label sizes can also be customized with the second dropdown selector. Choose an LULC class and start labeling points. The user can shift between satellite composites and other datasets to assist with labeling. 08 - Label Points

After labeling points, click save points. The number of points labeled in each class will display in the left panel. To remove points, click back over a previously labeled point.

4. Retrain Model

When labeling is complete, retrain the model using the labeled data. This can be found at the bottom of the left panel "Update map classification". While the map classification updates, the map layer for "Land Cover Map" will not be accessible. After the classification updates, a new "Land Cover Map" will appear in the Active Layers. 09 - Update Classification

Iterate through the label and retraining steps until the LULC classification is adequate. Tagging points required specialized GIS expertise to recognize classes. Earthshot can provide customized pricing for our in house GIS team to label training points.

5. Access Results

Results export is done through the report builder page. To access the report builder, go back to the polygon view and select "Report". 10 - Export step 1 This load the empty Report Builder. Use the template for "Land Cover (single year)" in the templates dropdown or drag the widgets from the Available Widgets panel. Now the results are displayed in the Report Builder.

11 - Export step 2 Click "Save report" at the top and then open the dropdown beside "Download PDF report". Select "Land Cover Map" from the Export viewport data.

12 - Export step 3 Now the data gets prepared for export. This step can take several minutes.

13 - Export step 4 The Exports drawer on the right side of the screen tracks exports. Initially, this will have a blue dot for Processing. When the data is ready to download, the color will change to green and the geoTIFF is ready for download.

Tips

Tips to improve results:

  • Define LULC classes by overviewing the high resolution basemap and deciding what is important to map.
  • Overlay the canopy height models to detect certain forest presence.
  • Overlay the Sentinel-2 RGB and infrared false color layers. Try to detect the same LULC structures present in the high resolution basemap in the coarser resolution image.
  • When placing the samples it is important to pick up pixel groups that are as homogeneus a possible. Meaning its better to sample the core of a cover rather than its limits where it could be blending into another class.
  • It is also good to try to keep balance between classes in number and size of samples.