Awesome
AI Ecosystem Extension Specification
- Title: AI ecosystem
- Identifier: https://fiboa.github.io/ai-ecosystem-extension/v0.1.0/schema.yaml
- Property Name Prefix: ml
- Extension Maturity Classification: Proposal
- Owner: @hannah-rae @subash-khanal @yanglexie @jacobsn @eddiechoi00
This document explains the AI Ecosystem Extension to the Field Boundaries for Agriculture (fiboa) Specification.
This extension adds support for properties useful for integrating field boundary data with the AI/ML ecosystem.
Properties
Collection
The fields in the table below can be used in these parts of fiboa documents:
- Collection
- Feature Properties
| Property Name | Type | Description |
|---|---|---|
| ml:creation_date | datetime | REQUIRED. Date the collection was created or published |
Features
The fields in the table below can be used in these parts of fiboa documents:
- Collection
- Feature Properties
| Property Name | Type | Description |
|---|---|---|
| ml:boundary_type | string | REQUIRED. Whether the boundary is for a field, ownership parcel, hedge, or other boundary |
| ml:creation_date | datetime | REQUIRED. Date collection was created or published |
| ml:verified_from | datetime | REQUIRED. The first date for which the boundary is verified to be present on ground (e.g. through ground-truth or remote sensing image verification) |
| ml:author | string | REQUIRED. Name of individual or organization who created this. |
| ml:country_code | string | REQUIRED. ISO 3166-1 alpha-3 country code. Three-letter country code for the country that contains the field, e.g. SDN for Sudan. Can be found at https://www.iso.org/obp/ui/#search under the Alpha-3 code column. |
| ml:admin1 | string | REQUIRED. Modified ISO 3166-2 codes for identifying the principal subdivisions (e.g., provinces or states) of a country (i.e. admin1) that contains the field. The feature only contains the second part of the ISO 3166-2 code, to reduce redundancy. |
| ml:admin2 | string | A unique admin2 (county) name for the administrative region that contains the field. The feature contains the last part of the HASC 2 codes. The HASC 2 codes can be found here. |
Additional Properties
Additionally, the following properties from from the core specification are required for AI usecases:
- determination_method
- determination_datetime
Lastly, the following properties from from the Administrative Division extension are required:
- admin:country_code
- admin:subdivision_code
[!NOTE]
Country Code, Subdivision Code and admin2 can be derived from GADM boundaries.
Contributing
See the contributing guideline for more details.