Download OpenAPI specification:Download
The Tesseract API is a service to get spatiotemporal data in an analysis ready format and to run arbitrary models on combinations of this data.
A Tesseract is the 4 dimensional generalization of a cube. A tesseract
as returned by this service has 4 dimensions: (time, feature/band, x, y). Within the SeerAI view of the connected spatiotemporal world, this is a common way of looking at data.
Builds a TesseractJob, returning the dataset object created, a STAC item, and some status about the job.
Description of the tesseract requested. Can be derived from multiple datasets.
name | string Tesseract creates a dataset in |
alias | string The alias of the dataset created by this job. |
description | string A text description of the Job. This description is text-searchable in Entanglement. |
domain | string Default: "*" The domain qualifier of the output dataset when it gets added to the graph |
category | string Default: "*" The category qualifier of the output dataset when it gets added to the graph |
type | string Default: "*" The type qualifier of the output dataset when it gets added to the graph |
bbox | Array of numbers [ 4 .. 6 ] items The spatial extent of the job. Entire area will be processed if there is data. This can be refined further by providing a geometry in addition to or instead of the bbox. The output extent of the dataset will become the bbox, if provided regardless of whether the geometry is smaller or not. |
bbox_epsg | integer The spatial reference EPSG code for the bbox |
output_epsg | integer The spatial reference EPSG code for the output. Pixel sizes will be in this spatial reference |
pointGeoJSON (object) or multipointGeoJSON (object) or linestringGeoJSON (object) or multilinestringGeoJSON (object) or polygonGeoJSON (object) or multipolygonGeoJSON (object) or geometrycollectionGeoJSON (object) (geometryGeoJSON) | |
project | string The project that this job will be created in. The resulting Dataset will be accessible from that project. The user must have write access for the specified project (can be either the project name for project id). |
dry_run | boolean Perform a dry run instead of submitting the job. Good to check for errors that crop up before executing a large job. (default False) |
workers | integer The number of workers to use for this job (default 1) |
object (bucket) | |
Array of objects (step) This is where the bulk of a job should be specified. An arbitrary DAG can be specified here which can be composed of | |
Array of objects (hook) | |
object Deprecated | |
Array of objects (asset_spec) Deprecated |
{- "bbox": [
- -50,
- -13,
- -49,
- -12
], - "bbox_epsg": 4326,
- "output_epsg": 3857,
- "steps": [
- {
- "name": "create_assets_example",
- "type": "create-assets",
- "inputs": [
- {
- "dataset": "modis-mcd43a4",
- "dataset_project": "global",
- "asset_bands": [
- {
- "asset": "B1",
- "bands": [
- 0
]
}, - {
- "asset": "B2",
- "bands": [
- 0
]
}, - {
- "asset": "B3",
- "bands": [
- 0
]
}
], - "no_data": 32767,
- "datetime": "2020-01-01T00:00:00Z/2021-01-01T00:00:00Z"
}
], - "outputs": [
- {
- "asset_name": "modis",
- "type": "tensor",
- "pixel_dtype": "<i2",
- "fill_value": 0,
- "output_time_bins": {
- "strided": {
- "from": {
- "datetime": "2020-01-01T00:00:00Z"
}, - "duration": "1D",
- "stride": "14D",
- "count": 25
}
}, - "chip_size": 1024,
- "pixels_options": {
- "pixel_size": [
- 500,
- 500
], - "resample": "BILINEAR"
}
}
]
}, - {
- "name": "run_model",
- "type": "model",
- "container": {
- "repo": "docker.io",
- "image": "vegetation-health",
- "tag": "v0.1.2"
}, - "inputs": [
- {
- "asset_name": "modis",
- "spatial_chunk_shape": [
- 256,
- 256
], - "overlap": 32,
- "bands": [
- 0,
- 1,
- 2
]
}
], - "outputs": [
- {
- "asset_name": "vegetation_health",
- "chunk_shape": [
- 1,
- 1,
- 256,
- 256
], - "trim": 32,
- "output_bands": [
- "vegetation-health"
]
}
]
}
]
}
{- "job_id": "string",
- "dataset": { },
- "item": {
- "stac_version": "1.0.0",
- "type": "Feature",
- "id": "CS3-20160503_132131_05",
- "bbox": [
- -122.59750209,
- 37.48803556,
- -122.2880486,
- 37.613537207
], - "geometry": {
- "type": "Polygon",
- "coordinates": [
- [
- [
- -122.308150179,
- 37.488035566
], - [
- -122.597502109,
- 37.538869539
], - [
- -122.576687533,
- 37.613537207
], - [
- -122.2880486,
- 37.562818007
], - [
- -122.308150179,
- 37.488035566
]
]
]
}, - "properties": {
- "datetime": "2016-05-03T13:22:30.040Z",
- "title": "A CS3 item",
- "license": "PDDL-1.0",
- "view:sun_azimuth": 168.7,
- "eo:cloud_cover": 0.12,
- "view:off_nadir": 1.4,
- "platform": "coolsat2",
- "instruments": [
- "cool_sensor_v1"
], - "eo:bands": [ ],
- "view:sun_elevation": 33.4,
- "eo:gsd": 0.512
}, - "collection": "CS3",
- "links": [
], - "assets": {
- "analytic": {
- "title": "4-Band Analytic"
}, - "thumbnail": {
- "title": "Thumbnail"
}
}
}, - "warnings": [
- {
- "title": "string",
- "detail": "string",
- "severity": "LOW"
}
]
}
get the status for a job
job_id required | string |
project required | string the project to search for jobs in |
return_quark_status | boolean Returns the status of the individual quarks. Note that on large jobs this can create a large response |
return_quark_geoms | boolean Returns the geometry of the quarks |
return_alerts | boolean Returns any alerts the job may have produced during planning or execution since the last submit |
{- "job_status": {
- "job_id": "string",
- "state": "string",
- "n_quarks": 0,
- "n_quarks_completed": 0,
- "quark_status": {
- "property1": "string",
- "property2": "string"
}, - "features": {
- "type": "FeatureCollection",
- "features": [
- {
- "type": "Feature",
- "geometry": {
- "type": "Point",
- "coordinates": [
- 0,
- 0
]
}, - "properties": { }
}
]
}
}
}
Get the Dataset definition for this job. This is stored separately from entanglement and only refers to the current version.
job_id required | string |
project required | string the project to search for jobs in |
{- "dataset": { }
}
Get the STAC item representing this job and its outputs.
job_id required | string |
project required | string the project to search for jobs in |
{- "item": {
- "stac_version": "1.0.0",
- "type": "Feature",
- "id": "CS3-20160503_132131_05",
- "bbox": [
- -122.59750209,
- 37.48803556,
- -122.2880486,
- 37.613537207
], - "geometry": {
- "type": "Polygon",
- "coordinates": [
- [
- [
- -122.308150179,
- 37.488035566
], - [
- -122.597502109,
- 37.538869539
], - [
- -122.576687533,
- 37.613537207
], - [
- -122.2880486,
- 37.562818007
], - [
- -122.308150179,
- 37.488035566
]
]
]
}, - "properties": {
- "datetime": "2016-05-03T13:22:30.040Z",
- "title": "A CS3 item",
- "license": "PDDL-1.0",
- "view:sun_azimuth": 168.7,
- "eo:cloud_cover": 0.12,
- "view:off_nadir": 1.4,
- "platform": "coolsat2",
- "instruments": [
- "cool_sensor_v1"
], - "eo:bands": [ ],
- "view:sun_elevation": 33.4,
- "eo:gsd": 0.512
}, - "collection": "CS3",
- "links": [
], - "assets": {
- "analytic": {
- "title": "4-Band Analytic"
}, - "thumbnail": {
- "title": "Thumbnail"
}
}
}
}