/timestamps-extension

Timestamps for the whole lifetime of field boundaries.

Apache License 2.0Apache-2.0

Timestamps Extension Specification

This document explains the Timestamps Extension to the Field Boundaries for Agriculture (fiboa) Specification.

Timestamps for the lifetime of a field boundary in the categories:

  • Seasonal Activity
  • Determination
  • Derivatives
  • Administrative
  • Data Management

Properties

The properties in the tables below can be used in these parts of fiboa documents:

  • Collection
  • Feature Properties

All properties must be provided in UTC!

Seasonal Activity

Property Name Type Description
datetime:season_start datetime Start of the season
datetime:tillage datetime Seasonal: Tillage
datetime:first_harvest datetime Seasonal: First harvest
datetime:last_harvest datetime Seasonal: Last harvest
datetime:season_end datetime End of the season

Determination

Property Name Type Description
datetime:first_determination datetime The first time at which the field did exist and was observed
determination_datetime datetime From fiboa core for completeness - The last time at which the field did exist and was observed

The extensions assumes that the provided determination timestamps are homogenously captured, i.e. determination_method applies to all activity-related timestamps above.

Derivatives

Datetimes related to field boundaries that were derived from other sources, e.g. through machine learning from satellite imagery.

Property Name Type Description
datetime:processed datetime Algorithm runtime
determination_datetime datetime From fiboa core for completeness - Time the source data was measured

Administrative

Property Name Type Description
datetime:planned datetime Planning started
datetime:introduced datetime Field was physically layed out
datetime:ceased datetime Field is physically not present any longer

Data Management

Property Name Type Description
datetime:created datetime Field boundary was added to dataset
datetime:updated datetime Field boundary was last modified in the dataset
datetime:valid_from datetime Field boundary in dataset is valid from
datetime:valid_until datetime Field boundary in dataset is valid until / expires
datetime:deleted datetime Field boundary has will be (or has been) deleted from the dataset

Contributing

See the contributing guideline for more details.