Skip to content
Actinia Core is an open source REST API for scalable, distributed, high performance processing of geographical data that uses mainly GRASS GIS for computational tasks.
Python Shell Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docker
docs
scripts
src/actinia_core
tests
.coveragerc
.gitignore
AUTHORS.rst
CHANGELOG.rst
CONTRIBUTING.md
LICENSE.txt
Makefile
README.md
requirements.txt
setup.cfg
setup.py

README.md

Actinia — The GRASS GIS REST API

DOI License: GPL v3 Docker Automated build

Actinia is an open source REST API for scalable, distributed, high performance processing of geographical data that uses GRASS GIS for computational tasks.

It provides a REST API to process satellite images, time series of satellite images, arbitrary raster data with geographical relations and vector data.

The REST interface allows to access, manage and manipulate the GRASS GIS database via HTTP GET, PUT, POST and DELETE requests and to process raster, vector and time series data located in a persistent GRASS GIS database. Actinia allows the processing of cloud based data, for example all Landsat 4-8 scenes as well as all Sentinel-2 scenes in an ephemeral databases. The computational results of ephemeral processing are available via object storage as GeoTIFF files.

API documentation

The full API documentation is available here: https://actinia.mundialis.de/api_docs/

actinia command execution - actinia shell

There is also an option to interactively control actinia. For details, see here.

Installation

Please see the docker/ subfolder for details.

Examples

Data management

  • List all locations that are available in the actinia persistent database:
curl -X GET "https://actinia.mundialis.de/api/v1/locations" -H "authorization: Basic …"
  • List all mapsets in the location latlong_wgs84:
curl -X GET "https://actinia.mundialis.de/api/v1/locations/latlong_wgs84/mapsets" -H "authorization: Basic …"
  • List all space-time raster datasets (STRDS) in location latlong_wgs84 and mapset Sentinel_timeseries:
curl -X GET "https://actinia.mundialis.de/api/v1/locations/latlong_wgs84/mapsets/Sentinel_timeseries/strds" -H "authorization: Basic …"
  • List all raster map layers of the STRDS:
curl -X GET "https://actinia.mundialis.de/api/v1/locations/latlong_wgs84/mapsets/Sentinel_timeseries/strds/S2A_B04/raster_layers" -H "authorization: Basic …"

Landsat and Sentinel-2 NDVI computation

  • Compute the NDVI of the top of athmosphere (TOAR) corrected Landsat4 scene LC80440342016259LGN00:
curl -X POST "https://actinia.mundialis.de/api/v1/landsat_process/LC80440342016259LGN00/TOAR/NDVI" -H "authorization: Basic …"
  • NDVI computation of Sentinel-2A scene S2A_MSIL1C_20170212T104141_N0204_R008_T31TGJ_20170212T104138:
curl -X POST "https://actinia.mundialis.de/api/v1/sentinel2_process/ndvi/S2A_MSIL1C_20170212T104141_N0204_R008_T31TGJ_20170212T104138" -H "authorization: Basic …"

The results of the asynchronous computations are available as GeoTIFF file in a cloud storage for download.

You can’t perform that action at this time.