Non-satellite Imagery Formats

Updated May 9, 2015
This document describes the details of how Climate FieldView expects images to be formatted for ingestion into the FieldView platform. While FieldView may accept variations from this specification, partners should not expect or rely upon support for anything other than what is documented here.
Metadata Format

Items listed in this specification as metadata should be provided in the geotiff file using the non­standard tag 42112 which identifies GDAL metadata. The data associated with this tag should be in XML format where the root element is named GDALMetadata. GDALMetadata may have any number of child elements named Item. Each Item element should have an attribute called "name" identifying the name of the metadata item. The content of the Item element should be the data. Here is part of the output of the tiffinfo utility for a conforming file:

Tag 42112: <GDALMetadata>
    <Item name="acquisitionEndDate">2016-09-08T15:53:00+05:00</Item>
    <Item name="acquisitionStartDate">2016-09-08T15:56:00+05:00</Item>
    <Item name="boundaryId">5ccaf275­9350­4784­b1a8­0ea7b20815be</Item>
    <Item name="brandId">53f3831b­2ca7­47f6­a805­c6d0712fcf13</Item>
    <Item name="fieldId">a0f9c35f­105f­4fbc­a63c­51b6df37fc20</Item>
    <Item name="isCalibrated">True</Item>
    <Item name="sourceId">5916fc4b­51aa­44e2­98af­ca7ff6bef1d4</Item>
</GDALMetadata>
Compression

Climate FieldView does not support compressed geotiff files at this time.

No-data Values

Any pixel for which no valid data is available must be set to the no data value indicated by the TIFFTAG_GDAL_NODATA tag (code 42113). This includes both no data values within the field boundary and any areas outside the field boundary that do not contain valid data. Note that this does not mean you must clip your images to field boundaries, only that if you do clip to field boundaries, please use the no data value to fill areas outside the boundaries.

Single Band Uploads
image/vnd.climate.
thermal.geotiff
IMAGE DATA
  • format: 64 bit signed floating point
  • coordinate reference systems supported: UTM with WGS84 datum
  • units: degrees Celsius
METADATA
  • acquisitionStartDate
    • type: String
    • format: ISO­-8601
  • acquisitionEndDate
    • type: String
    • format: ISO­-8601
  • sourceId
    Optional — ­ id of the asset in the partner system
    • type: String
    • format: uuid
  • fieldId
    Optional — Climate field id available via API
    • type: String
    • format: uuid
  • boundaryId
    Optional — ­ Climate boundary id available via API
    • type: String
    • format: uuid
  • brandId
    Optional — id referencing the partner’s branding assets stored by Climate
    • type: String
    • format: uuid
  • isCalibrated
    • type: Boolean
image/vnd.climate.
ndvi.geotiff
IMAGE DATA
  • format: 64 bit signed floating point
  • coordinate reference systems supported: UTM with WGS84 datum
  • range: -1 to 1
METADATA
  • acquisitionStartDate
    • type: String
    • format: ISO­-8601
  • acquisitionEndDate
    • type: String
    • format: ISO­-8601
  • sourceId
    Optional — ­ id of the asset in the partner system
    • type: String
    • format: uuid
  • fieldId
    Optional — Climate field id available via API
    • type: String
    • format: uuid
  • boundaryId
    Optional — ­ Climate boundary id available via API
    • type: String
    • format: uuid
  • brandId
    Optional — id referencing the partner’s branding assets stored by Climate
    • type: String
    • format: uuid
Multi Band Uploads
image/vnd.climate.
rgb.geotiff
IMAGE DATA
  • format: 24­-bit composite
  • coordinate reference systems supported: UTM with WGS84 datum
  • range: 0­-255 per band
  • 3 bands, in order: Red, Green, Blue
  • 8 bit color values
METADATA
  • acquisitionStartDate
    • type: String
    • format: ISO­-8601
  • acquisitionEndDate
    • type: String
    • format: ISO­-8601
  • sourceId
    Optional — ­ id of the asset in the partner system
    • type: String
    • format: uuid
  • fieldId
    Optional — Climate field id available via API
    • type: String
    • format: uuid
  • boundaryId
    Optional — ­ Climate boundary id available via API
    • type: String
    • format: uuid
  • brandId
    Optional — id referencing the partner’s branding assets stored by Climate
    • type: String
    • format: uuid
  • isCalibrated
    • type: Boolean
  • reflectanceComputeMethod
    Optional — method used for computing reflectance
    Please let us know if you utilize a different method than below and we'll add new enum values to represent it.
    • type: enum, values {TOA, GROUND}
image/vnd.climate.
raw.geotiff
IMAGE DATA
  • format: 8 or 64 bit signed floating point
  • coordinate reference systems supported: UTM with WGS84 datum
  • range: 0­-65k 64 bit, 0-­255 8 bit
  • band start range: 0­-10,000
  • band end range: 0-­10,000
  • 5 bands, in order: Red, Green, Blue, NIR, Red_Edge
METADATA
  • acquisitionStartDate
    • type: String
    • format: ISO­-8601
  • acquisitionEndDate
    • type: String
    • format: ISO­-8601
  • sourceId
    Optional — ­ id of the asset in the partner system
    • type: String
    • format: uuid
  • fieldId
    Optional — Climate field id available via API
    • type: String
    • format: uuid
  • boundaryId
    Optional — ­ Climate boundary id available via API
    • type: String
    • format: uuid
  • brandId
    Optional — id referencing the partner’s branding assets stored by Climate
    • type: String
    • format: uuid
  • isCalibrated
    • type: Boolean
  • reflectanceComputeMethod
    Optional — method used for computing reflectance
    Please let us know if you utilize a different method than below and we'll add new enum values to represent it.
    • type: enum, values {TOA, GROUND}