Examples for S3SLSTR

To request data using any of the request below, you will need to replace the string <your access token> with your Sentinel Hub access token. Sentinel Hub access token will look something like this:

ayJhbGciOiJSUzI1NiJ9.ayJzdWIiOiI0MmYwODZjCy1kMzI3LTRlOTMtYWMxNS00ODAwOGFiZjI0YjIiLCJhdWQiOiJlY2I1MGM1Zi1i
MWM1LTQ3ZTgtYWE4NC0zZTU4NzJlM2I2MTEiLCJqdGkiOiI5MzYxMWE4ODEyNTM4Y2M0MmU0NDJjYjUyMTY0YmJlNyIsImV4cCI6MTU1N
TQyMzk3MiwibmFtZSI6ImFuamEudnJlY2tvQHNpbmVyZ2lzZS5jb20iLCJlbWFpbCI6ImFuamEudnJlY2tvQHNpbmVyZ2lzZS5jb20iLC
JzaWQiOiIzZjVjZDVkNS04MjRiLTQ3ZjYtODgwNy0wNDMyNWY4ODQxZmQifQ.U7FPOy_2jlEOFxXSjyN5KEdBROna3-Dyec0feShIbUOY
1p9lEXdNaMmR5euiINi2RXDayX9Kr47CuSTsvq1zHFvZs1YgkFr1iH6kDuX-t_-wfWpqu5oPjoPVKZ4Rj0Ms_dxAUTQFTXR0rlbLuO-KS
gnaeLVb5iiv_qY3Ctq2XKdIRcFRQLFziFcP4yZJl-NZMlwzsiiwjakcpYpI5jSYAdU2hpZLHRzceseeZt5YfZOe5Px1kZXro9Nd0L2GPC
-qzOXw_V1saMGFa2ov8qV6Dvk92iv2SDDdGhOdII_JOf8XkK4E3g2z0EEFdWhG9F4Iky4ukNsqBPgE8LRb31s0hg

and can be obtained as described in the Authentication chapter.

A Postman collection with examples can be downloaded here.

False Color

curl -X POST \
https://creodias.sentinel-hub.com/api/v1/process \
-H 'Authorization: Bearer <your access token>' \
-F 'request={
"input": {
"bounds": {
"bbox": [
8.558382,
41.359678,
9.579525,
43.055688
],
"properties": {
"crs": "http://www.opengis.net/def/crs/EPSG/0/4326"
}
},
"data": [
{
"type": "S3SLSTR",
"dataFilter": {
"timeRange": {
"from": "2020-06-20T00:00:00Z",
"to": "2020-06-20T23:59:59Z"
},
"orbitDirection": "DESCENDING"
}
}
]
},
"output": {
"width": 512,
"height": 512,
"responses": [
{
"format": {
"type": "image/png"
}
}
]
}
}' \
-F 'evalscript=//VERSION=3
function setup() {
return {
input: ["S3", "S2", "S1"],
output: {
bands: 3,
sampleType: "AUTO"
}
}
}
function evaluatePixel(sample) {
return [2 * sample.S3, 2 * sample.S2, 2 * sample.S1]
}'

False Color (EPSG 32632)

curl -X POST \
https://creodias.sentinel-hub.com/api/v1/process \
-H 'Authorization: Bearer <your access token>' \
-F 'request={
"input": {
"bounds": {
"bbox": [
444170, 4574059, 557052, 4767386 ],
"properties": {
"crs": "http://www.opengis.net/def/crs/EPSG/0/32632"
}
},
"data": [
{
"type": "S3SLSTR",
"dataFilter": {
"timeRange": {
"from": "2020-06-20T00:00:00Z",
"to": "2020-06-20T23:59:59Z"
},
"orbitDirection": "DESCENDING"
}
}
]
},
"output": {
"width": 512,
"height": 512,
"responses": [
{
"format": {
"type": "image/png"
}
}
]
}
}' \
-F 'evalscript=//VERSION=3
function setup() {
return {
input: ["S3", "S2", "S1"],
output: {
bands: 3,
sampleType: "AUTO"
}
}
}
function evaluatePixel(sample) {
return [2 * sample.S3, 2 * sample.S2, 2 * sample.S1]
}'

False Color, resolution (EPSG 32632)

curl -X POST \
https://creodias.sentinel-hub.com/api/v1/process \
-H 'Authorization: Bearer <your access token>' \
-F 'request={
"input": {
"bounds": {
"properties": {
"crs": "http://www.opengis.net/def/crs/EPSG/0/32632"
},
"bbox": [
444170,
4574059,
557052,
4767386
]
},
"data": [
{
"type": "S3SLSTR",
"dataFilter": {
"timeRange": {
"from": "2020-06-20T00:00:00Z",
"to": "2020-06-20T23:59:59Z"
},
"orbitDirection": "DESCENDING"
}
}
]
},
"output": {
"resx": 250,
"resy": 250,
"responses": [
{
"format": {
"type": "image/png"
}
}
]
}
}' \
-F 'evalscript=//VERSION=3
function setup() {
return {
input: ["S3", "S2", "S1"],
output: {
bands: 3,
sampleType: "AUTO"
}
}
}
function evaluatePixel(sample) {
return [2 * sample.S3, 2 * sample.S2, 2 * sample.S1]
}'

Thermal IR fire emission band, gradient visualizer (K)

curl -X POST \
https://creodias.sentinel-hub.com/api/v1/process \
-H 'Authorization: Bearer <your access token>' \
-F 'request={
"input": {
"bounds": {
"bbox": [
-120.1410,
37.5282,
-119.4131,
37.8716
],
"properties": {
"crs": "http://www.opengis.net/def/crs/EPSG/0/4326"
}
},
"data": [
{
"type": "S3SLSTR",
"dataFilter": {
"timeRange": {
"from": "2018-08-06T00:00:00Z",
"to": "2018-08-06T23:59:59Z"
},
"orbitDirection": "DESCENDING"
}
}
]
},
"output": {
"width": 512,
"height": 512,
"responses": [
{
"format": {
"type": "image/png"
}
}
]
}
}' \
-F 'evalscript=//VERSION=3
function setup() {
return {
input: ["F1"],
output: {
bands: 3,
}
}
}
// Create a Red gradient visualiser from 274-450 K
var viz = ColorGradientVisualizer.createRedTemperature(274,450)
function evaluatePixel(sample) {
return viz.process(sample.F1);
}'

False Color and metadata (multi-part GeoTIFF and json)

curl -X POST \
https://creodias.sentinel-hub.com/api/v1/process \
-H 'Authorization: Bearer <your access token>' \
-H 'Accept: application/tar' \
-F 'request={
"input": {
"bounds": {
"bbox": [
8.558382,
41.359678,
9.579525,
43.055688
],
"properties": {
"crs": "http://www.opengis.net/def/crs/EPSG/0/4326"
}
},
"data": [
{
"type": "S3SLSTR",
"dataFilter": {
"timeRange": {
"from": "2020-06-20T00:00:00Z",
"to": "2020-06-20T23:59:59Z"
},
"orbitDirection": "DESCENDING"
}
}
]
},
"output": {
"width": 512,
"height": 512,
"responses": [
{
"identifier": "default",
"format": {
"type": "image/tiff"
}
},
{
"identifier": "userdata",
"format": {
"type": "application/json"
}
}
]
}
}' \
-F 'evalscript=//VERSION=3
function setup() {
return {
input: ["S3", "S2", "S1"],
output: {
id:"default",
bands: 3,
sampleType: "INT16"
},
mosaicking: "TILE"
}
}
function updateOutputMetadata(scenes, inputMetadata, outputMetadata) {
outputMetadata.userData = { "metadata": JSON.stringify(scenes) }
}
function evaluatePixel(sample) {
return [sample[0].S3 * 10000, sample[0].S2 * 10000, sample[0].S1 * 10000] //the values are multiplied by 10000 because output sampleType is UINT16
}'

NDVI as jpeg image with bouds given as polygon

curl -X POST \
https://creodias.sentinel-hub.com/api/v1/process \
-H 'Authorization: Bearer <your access token>' \
-F 'request={
"input": {
"bounds": {
"properties": {
"crs": "http://www.opengis.net/def/crs/EPSG/0/32632"
},
"geometry": {
"type": "Polygon",
"coordinates": [ [ [ 535547.72908976720646, 4767538.771691742353141 ], [ 542559.687229646136984, 4744749.907737135887146 ], [ 550448.140137009788305, 4660606.410058589652181 ], [ 521523.812810009520035, 4570327.449007648974657 ], [ 474193.09536582720466, 4600128.271102134138346 ], [ 461045.673853554355446, 4630805.587964104488492 ], [ 453157.220946190645918, 4698295.68506043870002 ], [ 497858.454087918333244, 4741243.928667196072638 ], [ 520647.318042524624616, 4744749.907737135887146 ], [ 525906.286647433764301, 4771044.750761681236327 ], [ 525906.286647433764301, 4771044.750761681236327 ], [ 525906.286647433764301, 4771044.750761681236327 ], [ 535547.72908976720646, 4767538.771691742353141 ] ] ]
}
},
"data": [
{
"type": "S3SLSTR",
"dataFilter": {
"timeRange": {
"from": "2020-06-20T00:00:00Z",
"to": "2020-06-20T23:59:59Z"
},
"orbitDirection": "DESCENDING"
}
}
]
},
"output": {
"width": 512,
"height": 512,
"responses": [
{
"format": {
"type": "image/jpeg"
}
}
]
}
}' \
-F 'evalscript=//VERSION=3
function setup() {
return {
input: ["S2", "S3"],
output: {
bands: 3,
}
}
}
function evaluatePixel(sample) {
let NDVI = index(sample.S3, sample.S2)
const viz = ColorGradientVisualizer.createWhiteGreen(-0.1, 1.0)
return viz.process(NDVI)
}'

NDVI image and value (multi-part response png and GeoTIFF)

curl -X POST \
https://creodias.sentinel-hub.com/api/v1/process \
-H 'Authorization: Bearer <your access token>' \
-H 'Accept: application/tar' \
-F 'request={
"input": {
"bounds": {
"properties": {
"crs": "http://www.opengis.net/def/crs/EPSG/0/32632"
},
"geometry": {
"type": "Polygon",
"coordinates": [ [ [ 535547.72908976720646, 4767538.771691742353141 ], [ 542559.687229646136984, 4744749.907737135887146 ], [ 550448.140137009788305, 4660606.410058589652181 ], [ 521523.812810009520035, 4570327.449007648974657 ], [ 474193.09536582720466, 4600128.271102134138346 ], [ 461045.673853554355446, 4630805.587964104488492 ], [ 453157.220946190645918, 4698295.68506043870002 ], [ 497858.454087918333244, 4741243.928667196072638 ], [ 520647.318042524624616, 4744749.907737135887146 ], [ 525906.286647433764301, 4771044.750761681236327 ], [ 525906.286647433764301, 4771044.750761681236327 ], [ 525906.286647433764301, 4771044.750761681236327 ], [ 535547.72908976720646, 4767538.771691742353141 ] ] ]
}
},
"data": [
{
"type": "S3SLSTR",
"dataFilter": {
"timeRange": {
"from": "2020-06-20T00:00:00Z",
"to": "2020-06-20T23:59:59Z"
},
"orbitDirection": "DESCENDING"
}
}
]
},
"output": {
"width": 512,
"height": 512,
"responses": [
{
"identifier": "ndvi_image",
"format": {
"type": "image/png"
}
},
{
"identifier": "default",
"format": {
"type": "image/tiff"
}
}
]
}
}' \
-F 'evalscript=//VERSION=3
function setup() {
return {
input: [{
bands:["S2", "S3"],
}],
output: [{
id: "default",
bands: 1,
sampleType: "INT16"
},
{
id: "ndvi_image",
bands: 3,
sampleType: "AUTO"
}
]
}
}
function evaluatePixel(sample) {
let NDVI = index(sample.S3, sample.S2)
const viz = ColorGradientVisualizer.createWhiteGreen(-0.1, 1.0)
return {
default: [ NDVI * 10000 ],
ndvi_image: viz.process(NDVI)
}
}'

VNIR and SWIR bands as a GeoTIFF, no normalization (EPSG 32632)

curl -X POST \
https://creodias.sentinel-hub.com/api/v1/process \
-H 'Authorization: Bearer <your access token>' \
-F 'request={
"input": {
"bounds": {
"properties": {
"crs": "http://www.opengis.net/def/crs/EPSG/0/32632"
},
"bbox": [
444170,
4574059,
557052,
4767386
]
},
"data": [
{
"type": "S3SLSTR",
"dataFilter": {
"timeRange": {
"from": "2020-06-20T00:00:00Z",
"to": "2020-06-20T23:59:59Z"
},
"orbitDirection": "DESCENDING"
}
}
]
},
"output": {
"resx": 500,
"resy": 500,
"responses": [
{
"format": {
"type": "image/tiff"
}
}
]
}
}' \
-F 'evalscript=//VERSION=3
function setup() {
return {
input: [{
bands: ["S1", "S2", "S3", "S4", "S5", "S6"],
units: "REFLECTANCE"
}],
output: {
bands: 6,
sampleType: "UINT16"
}
}
}
function multiplyband(sample){
// Multiply by 10000 and round
return Math.round(10000 * sample);
}
function evaluatePixel(sample) {
// Return the bands multiplied by 10000 as integers to save processing units. To obtain reflectance or BT values, simply divide the resulting pixel values by 10000.
return [multiplyband(sample.S1), multiplyband(sample.S2), multiplyband(sample.S3),
multiplyband(sample.S4), multiplyband(sample.S5), multiplyband(sample.S6)]
}'

TIR bands as a GeoTIFF, no normalization (EPSG 32632)

curl -X POST \
https://creodias.sentinel-hub.com/api/v1/process \
-H 'Authorization: Bearer <your access token>' \
-F 'request={
"input": {
"bounds": {
"properties": {
"crs": "http://www.opengis.net/def/crs/EPSG/0/32632"
},
"bbox": [
444170,
4574059,
557052,
4767386
]
},
"data": [
{
"type": "S3SLSTR",
"dataFilter": {
"timeRange": {
"from": "2020-06-20T00:00:00Z",
"to": "2020-06-20T23:59:59Z"
},
"orbitDirection": "DESCENDING"
}
}
]
},
"output": {
"resx": 500,
"resy": 500,
"responses": [
{
"format": {
"type": "image/tiff"
}
}
]
}
}' \
-F 'evalscript=//VERSION=3
function setup() {
return {
input: [{
bands: ["S7", "S8", "S9", "F1", "F2"]
}],
output: {
bands: 5,
sampleType: "UINT16"
}
}
}
function multiplyband(sample){
// Multiply by 100
return 100 * sample;
}
function evaluatePixel(sample) {
// Return the bands multiplied by 100 as integers to save processing units.
// To obtain reflectance or BT values, simply divide the resulting pixel values by 100.
return [multiplyband(sample.S7), multiplyband(sample.S8), multiplyband(sample.S9),
multiplyband(sample.F1), multiplyband(sample.F2)]
}'