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

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

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

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

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

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

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

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

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

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

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

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

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

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

Bands

L1_RET_E

Units

mm

Geographic Coverage

Africa

Read More

Link_2

_images/Shamba_Dataset_Flyers_03.png

Properties

Value

Pixel Size (metres)

500

Image Capture Frequency

8 days

Bands

ET, PET

Units

kg/m^2/8day

Geographic Coverage

Global

Read More

Link_3

_images/Shamba_Dataset_Flyers_038.png

Properties

Value

Pixel Size (metres)

248.2

Image Capture Frequency

10 Days

Bands

L1_E_D

Units

mm

Geographic Coverage

Africa

Read More

Link_38

Fire

_images/Shamba_Dataset_Flyers_017.png

Properties

Value

Pixel Size (metres)

1000

Image Capture Frequency

Daily

Bands

MaxFRP

Units

Megawatts

Geographic Coverage

Global

Read More

Link_17

_images/Shamba_Dataset_Flyers_018.png

Properties

Value

Pixel Size (metres)

1000

Image Capture Frequency

Daily

Bands

MaxFRP

Units

Megawatts

Geographic Coverage

Global

Read More

Link_18

_images/Shamba_Dataset_Flyers_019.png

Properties

Value

Pixel Size (metres)

2000

Image Capture Frequency

5 - 15 minutes

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

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

Bands

T21

Units

K

Geographic Coverage

Global

Read More

Link_39

_images/Shamba_Dataset_Flyers_040.png

Properties

Value

Pixel Size (metres)

463.313

Image Capture Frequency

Daily

Bands

BAI

Units

NA

Geographic Coverage

Global

Read More

Link_40

_images/Shamba_Dataset_Flyers_041.png

Properties

Value

Pixel Size (metres)

463.313

Image Capture Frequency

Daily

Bands

BAI

Units

NA

Geographic Coverage

Global

Read More

Link_41

Precipitation

_images/Shamba_Dataset_Flyers_042.png

Properties

Value

Pixel Size (metres)

463.313

Image Capture Frequency

Daily

Bands

NDSI

Units

NA

Geographic Coverage

Global

Read More

Link_42

_images/Shamba_Dataset_Flyers_043.png

Properties

Value

Pixel Size (metres)

463.313

Image Capture Frequency

Daily

Bands

NDSI

Units

NA

Geographic Coverage

Global

Read More

Link_43

_images/Shamba_Dataset_Flyers_06.png

Properties

Value

Pixel Size (metres)

5566

Image Capture Frequency

Daily

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

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

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

Bands

ppt

Units

mm

Geographic Coverage

USA

Read More

Link_44

_images/Shamba_Dataset_Flyers_045.png

Properties

Value

Pixel Size (metres)

500

Image Capture Frequency

Daily

Bands

NDSI_Snow_Cover

Units

NA

Geographic Coverage

Global

Read More

Link_45

_images/Shamba_Dataset_Flyers_046.png

Properties

Value

Pixel Size (metres)

500

Image Capture Frequency

Daily

Bands

NDSI_Snow_Cover

Units

NA

Geographic Coverage

Global

Read More

Link_46

Soil Moisture

_images/Shamba_Dataset_Flyers_08.png

Properties

Value

Pixel Size (metres)

10000

Image Capture Frequency

Monthly

Bands

ssm

Units

mm

Geographic Coverage

Global

Read More

Link_8

Temperature

_images/Shamba_Dataset_Flyers_09.png

Properties

Value

Pixel Size (metres)

1000

Image Capture Frequency

Daily

Bands

LST_Day_1km

Units

Kelvin

Geographic Coverage

Global

Read More

Link_9

_images/Shamba_Dataset_Flyers_010.png

Properties

Value

Pixel Size (metres)

1000

Image Capture Frequency

Daily

Bands

LST_Day_1km

Units

Kelvin

Geographic Coverage

Global

Read More

Link_10

_images/Shamba_Dataset_Flyers_044.png

Properties

Value

Pixel Size (metres)

4638.3

Image Capture Frequency

Daily

Bands

tmean

Units

°C

Geographic Coverage

USA

Read More

Link_44

_images/Shamba_Dataset_Flyers_049.png

Properties

Value

Pixel Size (metres)

27830

Image Capture Frequency

Daily

Bands

mean_2m_air_temperature

Units

K

Geographic Coverage

Global

Read More

Link_49

_images/Shamba_Dataset_Flyers_047.png

Properties

Value

Pixel Size (metres)

4638.3

Image Capture Frequency

Daily

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

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

Bands

NDVI, EVI

Units

NA

Geographic Coverage

Global

Read More

Link_4

_images/Shamba_Dataset_Flyers_011.png

Properties

Value

Pixel Size (metres)

500

Image Capture Frequency

4 days

Bands

Fpar, Lai

Units

NA

Geographic Coverage

Global

Read More

Link_11

_images/Shamba_Dataset_Flyers_012.png

Properties

Value

Pixel Size (metres)

250

Image Capture Frequency

16 days

Bands

NDVI, EVI

Units

NA

Geographic Coverage

Global

Read More

Link_12

_images/Shamba_Dataset_Flyers_013.png

Properties

Value

Pixel Size (metres)

250

Image Capture Frequency

16 days

Bands

NDVI, EVI

Units

NA

Geographic Coverage

Global

Read More

Link_13

_images/Shamba_Dataset_Flyers_014.png

Properties

Value

Pixel Size (metres)

500

Image Capture Frequency

8 days

Bands

Fpar_500m, Lai_500m

Units

Percent, sq. meter/sq. meter

Geographic Coverage

Global

Read More

Link_14

_images/Shamba_Dataset_Flyers_015.png

Properties

Value

Pixel Size (metres)

500

Image Capture Frequency

16 days

Bands

NDVI, EVI, EVI2

Units

NA

Geographic Coverage

Global

Read More

Link_15

_images/Shamba_Dataset_Flyers_050.png

Properties

Value

Pixel Size (metres)

463.313

Image Capture Frequency

Daily

Bands

EVI

Units

NA

Geographic Coverage

Global

Read More

Link_50

_images/Shamba_Dataset_Flyers_051.png

Properties

Value

Pixel Size (metres)

463.313

Image Capture Frequency

Daily

Bands

NDVI

Units

NA

Geographic Coverage

Global

Read More

Link_51

_images/Shamba_Dataset_Flyers_052.png

Properties

Value

Pixel Size (metres)

463.313

Image Capture Frequency

Daily

Bands

EVI

Units

NA

Geographic Coverage

Global

Read More

Link_52

_images/Shamba_Dataset_Flyers_053.png

Properties

Value

Pixel Size (metres)

463.313

Image Capture Frequency

Daily

Bands

NDVI

Units

NA

Geographic Coverage

Global

Read More

Link_53

_images/Shamba_Dataset_Flyers_054.png

Properties

Value

Pixel Size (metres)

463.313

Image Capture Frequency

Daily

Bands

NDWI

Units

NA

Geographic Coverage

Global

Read More

Link_54

_images/Shamba_Dataset_Flyers_055.png

Properties

Value

Pixel Size (metres)

463.313

Image Capture Frequency

Daily

Bands

NDWI

Units

NA

Geographic Coverage

Global

Read More

Link_55

_images/Shamba_Dataset_Flyers_056.png

Properties

Value

Pixel Size (metres)

5566

Image Capture Frequency

Daily

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

Bands

KBDI

Units

NA

Geographic Coverage

Global

Read More

Link_57

_images/Shamba_Dataset_Flyers_031.png

Properties

Value

Pixel Size (metres)

500

Image Capture Frequency

8 days

Bands

Gpp

Units

kg*C/m^2

Geographic Coverage

Global

Read More

Link_31

_images/Shamba_Dataset_Flyers_032.png

Properties

Value

Pixel Size (metres)

500

Image Capture Frequency

8 days

Bands

Gpp

Units

kg*C/m^2

Geographic Coverage

Global

Read More

Link_32

_images/Shamba_Dataset_Flyers_058.png

Properties

Value

Pixel Size (metres)

250

Image Capture Frequency

Monthly

Bands

VCI

Units

Percent

Geographic Coverage

Global

Read More

Link_58

Weather

_images/Shamba_Dataset_Flyers_059.png

Properties

Value

Pixel Size (metres)

2500

Image Capture Frequency

Daily

Bands

PRES, TMP, SPFH, WDIR, WIND, TCDC

Units

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

Geographic Coverage

Global

Read More

Link_59