Data Model

The Shamba oracle currently supports running two types of analytics on geospatial data. Below we describe each of these including their inputs and output.

Descriptive Statistics Analysis

This analysis aims at getting descriptive statistics. Given an area of interest and a dataset to reference, this analysis returns standard metrics such as maximum, minimum, mean, median and variance. These descriptive statistics are useful for setting thresholds and triggers in many parametric smart contracts. The required statistical metric is specified in the “agg_x” parameter.

Inputs:

  • “agg_x”: “string”,

  • “dataset_code”: “string”,

  • “selected_band”: “string”,

  • “geometry”: {json},

  • “start_date”: “string”,

  • “end_date”: “string”,

  • “image_scale”: integer,

Outputs:

  • int256

Fire Analysis

This analysis aims at determining if an area of interest falls within a detected fire. It performs a topology analysis to determine if a fire extends to a specified area of interest. Given an area of interest and a dataset to reference, this analysis returns a boolean indicating whether a fire was detected or not. Boolean values (1 - TRUE, 9 - FALSE).

Inputs:

  • “dataset_code”: “string”,

  • “selected_band”: “string”,

  • “geometry”: {json},

  • “start_date”: “string”,

  • “end_date”: “string”,

  • “image_scale”: integer,

Outputs:

  • uint256 (1 - TRUE, 9 - FALSE)

Thematic Areas & Dataset

The Shamba oracle uses regularly updated geospatial data from various global providers. Different providers use different algorithms to compute the same metric, so it is recommended that users go through the literature for each dataset. Normalization has been performed where necessary to standardize values from different datasets under a common theme.

Air Quality

_images/Shamba_Dataset_Flyers_021.png

Properties

Value

Pixel Size (metres)

1113.2

Image Capture Frequency

Daily

Dataset Code

SENTINEL_5_NRTI_CO_AIR

Bands

CO_column_number_density

Units

mol/m^2

Geographic Coverage

Global

Read More

Link_21

_images/Shamba_Dataset_Flyers_022.png

Properties

Value

Pixel Size (metres)

1113.2

Image Capture Frequency

Daily

Dataset Code

SENTINEL_5_OFFL_CO_AIR

Bands

CO_column_number_density

Units

mol/m^2

Geographic Coverage

Global

Read More

Link_22

_images/Shamba_Dataset_Flyers_023.png

Properties

Value

Pixel Size (metres)

1113.2

Image Capture Frequency

Daily

Dataset Code

SENTINEL_5_NRTI_SO2_AIR

Bands

SO2_column_number_density

Units

mol/m^2

Geographic Coverage

Global

Read More

Link_23

_images/Shamba_Dataset_Flyers_024.png

Properties

Value

Pixel Size (metres)

1113.2

Image Capture Frequency

Daily

Dataset Code

SENTINEL_5_OFFL_SO2_AIR

Bands

SO2_column_number_density

Units

mol/m^2

Geographic Coverage

Global

Read More

Link_24

_images/Shamba_Dataset_Flyers_025.png

Properties

Value

Pixel Size (metres)

1113.2

Image Capture Frequency

Daily

Dataset Code

SENTINEL_5_NRTI_NO2_AIR

Bands

NO2_column_number_density

Units

mol/m^2

Geographic Coverage

Global

Read More

Link_25

_images/Shamba_Dataset_Flyers_026.png

Properties

Value

Pixel Size (metres)

1113.2

Image Capture Frequency

Daily

Dataset Code

SENTINEL_5_OFFL_NO2_AIR

Bands

NO2_column_number_density

Units

mol/m^2

Geographic Coverage

Global

Read More

Link_26

_images/Shamba_Dataset_Flyers_033.png

Properties

Value

Pixel Size (metres)

1113.2

Image Capture Frequency

Daily

Dataset Code

SENTINEL_5_NRTI_AER_AIR

Bands

absorbing_aerosol_index

Units

NA

Geographic Coverage

Global

Read More

Link_33

_images/Shamba_Dataset_Flyers_034.png

Properties

Value

Pixel Size (metres)

1113.2

Image Capture Frequency

Daily

Dataset Code

SENTINEL_5_NRTI_CLOUD_AIR

Bands

cloud_fraction

Units

fraction

Geographic Coverage

Global

Read More

Link_34

_images/Shamba_Dataset_Flyers_035.png

Properties

Value

Pixel Size (metres)

1113.2

Image Capture Frequency

Daily

Dataset Code

SENTINEL_5_NRTI_HCHO_AIR

Bands

tropospheric_HCHO_column_number_density

Units

mol/m^2

Geographic Coverage

Global

Read More

Link_35

_images/Shamba_Dataset_Flyers_036.png

Properties

Value

Pixel Size (metres)

1113.2

Image Capture Frequency

Daily

Dataset Code

SENTINEL_5_NRTI_O3_AIR

Bands

O3_column_number_density

Units

mol/m^2

Geographic Coverage

Global

Read More

Link_36

_images/Shamba_Dataset_Flyers_027.png

Properties

Value

Pixel Size (metres)

1113.2

Image Capture Frequency

Daily

Dataset Code

SENTINEL_5_OFFL_CH4_AIR

Bands

CH4_column_volume_mixing_ratio_dry_air

Units

ppbV

Geographic Coverage

Global

Read More

Link_27

_images/Shamba_Dataset_Flyers_037.png

Properties

Value

Pixel Size (metres)

44528

Image Capture Frequency

Daily

Dataset Code

CAMS_AIR

Bands

various*

Units

kgm**-2 #excl. gems_total_column_ozone_surface

Geographic Coverage

Global

Read More

Link_37

Evapo-Transpiration

_images/Shamba_Dataset_Flyers_01.png

Properties

Value

Pixel Size (metres)

248.2

Image Capture Frequency

10 days

Dataset Code

WAPOR_I_ET

Bands

L1_AETI_D

Units

mm

Geographic Coverage

Africa

Read More

Link_1

_images/Shamba_Dataset_Flyers_02.png

Properties

Value

Pixel Size (metres)

18924

Image Capture Frequency

Daily

Dataset Code

WAPOR_R_ET

Bands

L1_RET_E

Units

mm

Geographic Coverage

Africa

Read More

Link_2

_images/Shamba_Dataset_Flyers_038.png

Properties

Value

Pixel Size (metres)

248.2

Image Capture Frequency

10 Days

Dataset Code

WAPOR_10_ET

Bands

L1_E_D

Units

mm

Geographic Coverage

Africa

Read More

Link_38

Fire

_images/Shamba_Dataset_Flyers_019.png

Properties

Value

Pixel Size (metres)

2000

Image Capture Frequency

5 - 15 minutes

Dataset Code

GOES_16_FIRE

Bands

Power

Units

MW

Geographic Coverage

Americas, West Africa

Read More

Link_19

_images/Shamba_Dataset_Flyers_020.png

Properties

Value

Pixel Size (metres)

2000

Image Capture Frequency

5 - 15 minutes

Dataset Code

GOES_17_FIRE

Bands

Power

Units

MW

Geographic Coverage

Americas, West Africa

Read More

Link_20

_images/Shamba_Dataset_Flyers_039.png

Properties

Value

Pixel Size (metres)

1000

Image Capture Frequency

Daily

Dataset Code

FIRMS_FIRE

Bands

T21

Units

K

Geographic Coverage

Global

Read More

Link_39

Precipitation

_images/Shamba_Dataset_Flyers_06.png

Properties

Value

Pixel Size (metres)

5566

Image Capture Frequency

Daily

Dataset Code

CHIRPS_PPT

Bands

Precipitation

Units

mm/day

Geographic Coverage

Global

Read More

Link_6

_images/Shamba_Dataset_Flyers_07.png

Properties

Value

Pixel Size (metres)

11132

Image Capture Frequency

Hourly

Dataset Code

GSMAP_PPT

Bands

hourlyPrecipRate

Units

NA

Geographic Coverage

Global

Read More

Link_7

_images/Shamba_Dataset_Flyers_028.png

Properties

Value

Pixel Size (metres)

4638.3

Image Capture Frequency

10 days

Dataset Code

GRIDMET

Bands

pdsi

Units

NA

Geographic Coverage

USA

Read More

Link_28

_images/Shamba_Dataset_Flyers_044.png

Properties

Value

Pixel Size (metres)

4638.3

Image Capture Frequency

Daily

Dataset Code

PRISM_PPT_TEMP

Bands

ppt, tmean

Units

mm, °C

Geographic Coverage

USA

Read More

Link_44

Soil Moisture

_images/Shamba_Dataset_Flyers_08.png

Properties

Value

Pixel Size (metres)

10000

Image Capture Frequency

Monthly

Dataset Code

SMAP_SM

Bands

ssm

Units

mm

Geographic Coverage

Global

Read More

Link_8

Temperature

_images/Shamba_Dataset_Flyers_044.png

Properties

Value

Pixel Size (metres)

4638.3

Image Capture Frequency

Daily

Dataset Code

PRISM_PPT_TEMP

Bands

ppt, tmean

Units

mm, °C

Geographic Coverage

USA

Read More

Link_44

_images/Shamba_Dataset_Flyers_049.png

Properties

Value

Pixel Size (metres)

27830

Image Capture Frequency

Daily

Dataset Code

ERA5_PPT_AIRTEMP

Bands

mean_2m_air_temperature, total_precipitation

Units

K, m

Geographic Coverage

Global

Read More

Link_49

_images/Shamba_Dataset_Flyers_047.png

Properties

Value

Pixel Size (metres)

4638.3

Image Capture Frequency

Daily

Dataset Code

GCOM_S_TEMP

Bands

SST_AVE

Units

°C

Geographic Coverage

Global

Read More

Link_47

_images/Shamba_Dataset_Flyers_048.png

Properties

Value

Pixel Size (metres)

4638.3

Image Capture Frequency

Daily

Dataset Code

GCOM_L_TEMP

Bands

LST_AVE

Units

°C

Geographic Coverage

Global

Read More

Link_48

Vegetation

_images/Shamba_Dataset_Flyers_04.png

Properties

Value

Pixel Size (metres)

10

Image Capture Frequency

5 days

Dataset Code

SENTINEL_2_VEG

Bands

NDVI, EVI

Units

NA

Geographic Coverage

Global

Read More

Link_4

_images/Shamba_Dataset_Flyers_060.png

Properties

Value

Pixel Size (metres)

1000

Image Capture Frequency

Daily

Dataset Code

VIIRS_VI

Bands

NDVI, EVI

Units

NA

Geographic Coverage

Global

Read More

Link_60

_images/Shamba_Dataset_Flyers_015.png

Properties

Value

Pixel Size (metres)

500

Image Capture Frequency

16 days

Dataset Code

VIIRS_16_VEG

Bands

NDVI, EVI, EVI2

Units

NA

Geographic Coverage

Global

Read More

Link_15

_images/Shamba_Dataset_Flyers_061.png

Properties

Value

Pixel Size (metres)

1000

Image Capture Frequency

Monthly

Dataset Code

VIIRS_VCI_VEG

Bands

VCI

Units

Percent

Geographic Coverage

Global

Read More

Link_61

_images/Shamba_Dataset_Flyers_056.png

Properties

Value

Pixel Size (metres)

5566

Image Capture Frequency

Daily

Dataset Code

AVHRR_NDVI_VEG

Bands

NDVI

Units

NA

Geographic Coverage

Global

Read More

Link_56

_images/Shamba_Dataset_Flyers_057.png

Properties

Value

Pixel Size (metres)

4000

Image Capture Frequency

Daily

Dataset Code

KBDI_VEG

Bands

KBDI

Units

NA

Geographic Coverage

Global

Read More

Link_57

Weather

_images/Shamba_Dataset_Flyers_059.png

Properties

Value

Pixel Size (metres)

2500

Image Capture Frequency

Daily

Dataset Code

RTMA_WEATHER

Bands

PRES, TMP, SPFH, WDIR, WIND, TCDC

Units

Pa, °C, kg/kg, deg true, m/s, percent

Geographic Coverage

Global

Read More

Link_59