Non-satellite Imagery Formats

Updated May 9, 2015

This document describes the preferred image format for ingestion into the Climate FieldView platform. Although FieldView may accept variations from this specification, we can’t support such variations. We offer support only for the format documented here.

Metadata Format

Items listed as metadata in this specification are provided in the geotiff file using the non­standard tag 42112, which identifies Geospatial Data Abstraction Library (GDAL) metadata. The data associated with this tag should be formatted in XML, with the root element named GDALMetadata. GDALMetadata can have any number of child elements named Item. Each Item element should be identified by an attribute called name. The item content is the data itself:

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>
    <Item name="name">Example</Item>
</GDALMetadata>
Compression

Climate FieldView does not support compressed geotiff files.

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 no-data values within the field boundary as well as any areas outside the boundary that contain no valid data.  You need not clip your images to field boundaries; if you do, though, 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 value
  • Coordinate reference systems supported: UTM with WGS84 datum
  • Units: ℃
METADATA
  • acquisitionStartDate
    • Type: String
    • Format: ISO­ 8601
  • acquisitionEndDate
    • Type: String
    • Format: ISO­ 8601
  • boundaryId
    Optional—­Partner's asset ID
    • 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 branding assets that belong to the partner but are stored by Climate
    • Type: String
    • Format: UUID
  • isCalibrated
    • Type: Boolean
  • name
    Optional — name of the layer. The maximum number of characters that will be accepted as input is 20.
    • Type: String
image/vnd.climate.
ndvi.geotiff
IMAGE DATA
  • Format: 64 bit signed floating point
  • Coordinate reference systems supported: UTM with a WGS84 datum
  • Range: -1 to 1
METADATA
  • acquisitionStartDate
    • Type: String
    • Format: ISO­-8601
  • acquisitionEndDate
    • Type: String
    • Format: ISO­-8601
  • sourceId
    Optional — ­ ­Partner's asset ID
    • 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 branding assets that belong to the partner but are stored by Climate
    • Type: String
    • Format: UUID
  • name
    Optional — name of the layer. The maximum number of characters that will be accepted as input is 20.
    • type: String
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
  • Bands: Three, in order: red, green, blue
  • Color values: 8 bits
METADATA
  • acquisitionStartDate
    • Type: String
    • Format: ISO­-8601
  • acquisitionEndDate
    • Type: String
    • Format: ISO­-8601
  • sourceId
    Optional — ­ Partner's asset ID
    • 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 use a different method than the one outlined here, and we'll add new enum values to represent it.
    • type: enum
    • Values: TOA, GROUND
  • name
    Optional — name of the layer. The maximum number of characters that will be accepted as input is 20.
    • Type: String