Open navigation

Field Inventory Analytics provides analytics to manage inventories in crops, plantations and forestry plots. Some features are related to the vectorization of asset (microplots, rows) in order to compute further analytics. This tutorial details how to run these analytics and read their results.

1. Required Inputs

This table shows what analytics shall be preliminarily calculated, plus field design information and other user input, that shall be provided to vectorize the agriculture assets, run inventories and calculate traits :

VECTORIZATIONSMicroplot Vectorization1. Base Scouting Maps2. Experimental design plan
Row Vectorization2. Field boundaries3. Row spacing
2. Microplots boundaries
2. Field Boundaries3. Interplant spacing and canopy diameter
NB: Row Vectorization is required and generated when running Gap & Count
Plant Height2. DTM (bare soil)3. Optional Field boundaries
Emergence Characterization2. Field or microplots boundaries3. Gaps & Count
Flowering Characterization2. Field or microplots boundaries
Stay Green

Read about currently supported agriculture assets :

2. Vectorizations

2.1. Microplot Vectorization

This analytic digitalizes and georeferences microplot boundaries, to delineate microplots to then measure, benchmark and monitor traits of varieties, evaluate trial responses at microplot level. Microplot customer id is linked to each microplot to enable seamless data analysis. It serves as the reference file for traits and trial responses data storage.

2.1.1. Inputs

  • Scouting Maps shall be computed first
  • Additional Input required from the customer is the experimental design plan (.xlsx format).

All microplots must have same design. The experimental design plan shall provide the trial breakdown :

block_row_idcustomer row id of the microplot, within a block or a field
block_col_idcustomer column id of the microplot, within a block or a field
block_plot_idcustomer id of the microplot
block_idcustomer block or field name (optional)
number of rows per microplots
number of rows of analysis
plant spacing
row spacing
row length
alley size



You have to indicate in your file the location of the field trial start. In the process to run the analytic (steps detailed at 2.1.6), you will have at some point to create an annotation on the RGB map that will correspond to this field trial start position :

2.1.2. Output File Formats

The microplot customer id is linked to each microplot to enable seamless data analysis ; linkage of traits and outcomes. Output formats are :

  • .geojson
  • .shp

2.1.3. Deliverables

The output contains these fields :

parent_idblock or field Id
block_idcustomer -block or field name
block_row_idcustomer -row id of the microplot, within a block or a field
block_col_idcustomer column id of the microplot, within a block or a field
block_plot_idcustomer id of the microplot

2.1.4. Display

From layers left panel, select Microplot layer from SURVEY DATA section, inside Contours subgroup :

Outputs (id's) can be browsed from the information panel on right side :

2.1.5. How to run the analytic ?

Microplot vectorization can be run using either :

  • A field trial experimental plan from an excel file (standard workflow)
  • or a vector file (shapefile or geojson format) containing the microplots. With this alternative, it is highly recommended to also upload an experimental plan, if any, as some adjustments may be required) Standard Workflow

Step 1/9 - Ensure to have the base scouting maps processing completed in your site.

Step 2/9 - Open your site and start to upload of your experimental plan from UPLOAD FILES button on top bar :

Step 3/9 - Select to attach the experimental plan to All surveys of this site ; this will mount the experimental plan as a reference file :

Step 4/9 - Drag-and-drop or browse your experimental plan file :

Step 5/9 - Edit file Name if necessary, select Type : File and Category : Microplots / Plots. Then press UPLOAD :

Your experimental plan will be stored and made available under Downloads section :

Step 6/9 - Display the RGB layer from the layers panel at BASE LAYERS section. Create on this RGB map a point annotation to mark the position of the field trial start. Reminder : the field trial start should also have been marked in your experimental plan excel file (cf. 2.1.2.). You can optionally modify the annotation icon from the STYLE section :

Step 7/9 - Rename this point annotation to "Start of field trial" :

Step 8/9 - Go to Analytics section from the left panel, scroll to find Microplot Vectorization section, and press Run :

Step 9/9 - Select your experimental plan among the listed reference files then press Launch microplot vectorization button :

Once process is complete vectorization results becomes viewable as shown at section 2.1.5. Alternative Workflow using a vector file

This method uses a vector file that contains the microplots, in one of these formats :

  • Shapefile (.shp)
  • GeoJSON (.geojson ; .json)

Step 1/16 - Ensure Scouting Maps analytics have been calculated first.

Step 2/16 - Upload the shape files set (compressed in a zip file : one set only containing the .dbf, .mgm, .shp, .shx files ) or the GeoJSON file. From the survey page click on UPLOAD FILES.

Step 3/16 - Select to attach the file to A specific survey of this site and select the survey.

Step 4/16 - Drag-and-drop or browse to locate the vector file and click on NEXT.

Step 5/16 - Change the name if necessary, select Microplots in Category, select the CRS of the file (If no .prj file is included in the set of shape files) of the file and click on UPLOAD. We recommend to use the same CRS for the project and shape file.

Step 6/16 - After uploading, the file will be stored in the Download section.

Step 7/16 - We highly recommend to upload the experimental plan as well. Indeed in some case, adjustments may be required on the Shapefile or GeoJSON.

Step 8/16 - Click on UPLOAD FILES.

Step 9/16 - Select A specific survey of this site.

Step 10/16 - Drag-and-drop or browse to locate the file and click on NEXT.

Step 11/16 - Change the name if necessary, select File in Type and Microplots in Category and click on UPLOAD.

Step 12/16 - After the uploading, the file will be stored in the Download section where you can delete or download the document if necessary.

Step 13/16 - On the RGB map, create a point annotation where the field trial start. 

  • Click on Point
  • Change the name (Start of field trial)
  • Click on Enter to validate. You can change the icon (green flag for example)

The field trial start should also be visible on the experimental plan uploaded previously.

Step 14/16 - From the survey page, click on Analytics , scroll down to Microplot vectorization on left panel, and click on Launch.

Step 15/16 - Select the experimental plan file uploaded previously and click on Launch microplot vectorization.

NB : This request will trigger an adjustment of the microplot boundaries so that it perfectly fits the orthophoto.

Step 16/16 - When the process is finished, the vectorized microplots will appear on the survey page.

2.2. Row Vectorization

This analytic automatically identifies rows within fields in order to assist with field counting or help guide farming equipment. It detects, digitizes and measures rows.

2.2.1. Inputs

This analytic is available for crops planted in row and where bare soil is visible in between the rows. Base scouting maps have to be computed first, theoretical field boundaries and row spacing must be provided.

2.2.2. Outputs File Formats

  • .geojson
  • .shp
  • .csv

2.2.3. Deliverables

Rows digitization with the following attributes :

  • row id
  • parent id (microplots) and vegetation length in case of microplots

2.2.4. Display

Open Contours belonging to SURVEY DATA section on left panel. Click any row on map to open its information panel on right side and read row id and parent id :

3. Statistics by plots

This analytic automatically extracts statistics metrics of scouting maps and traits at the microplot or plot level.

3.1. Inputs

The basic scouting maps have to been computed first, plus the microplots boundaries defined. Quantitative scouting maps, as CIR and RGB are out of scope.

3.2. Output File Formats

  • .geojson
  • .shp
  • .mbtiles
  • .csv

3.3. Deliverables

Statistics per microplots or plots are delivered for each selected scouting maps with the following attributes :

  • min
  • max
  • average
  • standard deviation 
  • variance

3.4. Display

Enable the statistic to be displayed from the Layers panel, and open right panel displaying properties.

4. Gaps & Count

This analytic automatically determines plant count and gaps through detection.

4.1. Inputs

  • Base scouting maps
  • Field or microplots boundaries
  • Rows for row crops and orchard and vineyards planted in rows
  • Interplant spacing
  • Canopy diameter (from above) 

It is mandatory to see bare ground in between two plants on the map, otherwise only visible gaps will be detected.

For row crops, with 6cm of GSD and a multispectral camera, optimal corn stage will be 4 leaves, and starbud for sunflower.

With enhanced resolution, earlier stages can be targeted. The basic rule is : size of GSD <= half canopy size (from above) 

For orchards and vineyards plants must be planted in rows. If canopy is closed, only gaps will be detected. Height of the plant must be > 50cm.

For palm trees, plant must be > 50 cm as well.

4.2. Output File Formats

  • .geojson
  • .shp
  • .csv

4.3. Deliverables

Gaps are only for plants in rows and are delivered with the following attributes : 

  • Gap length
  • Position of gaps at line end or not

Plant count are delivered with the following attributes:

  • Number of plant per microplot or per field
  • Number of missing plant per microplot or per field

4.4. Display

From layers panel, select Inventory layer from SURVEY DATA section , and select which count or gaps layers to display :

Opening the layer information panel on right side enables to modifiy the view for certain attributes. In example below we discriminate gaps that are inside the rows or located at their ends :

Continue here to Traits Analytics.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.