Skip to content

Home

Jump to bottom
Markus Neteler edited this page Feb 4, 2022 · 51 revisions

Actinia - The GRASS GIS REST API

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 e.g. 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.

What does actinia mean?

Actinia is a beautiful sea creature and a genus of sea anemones in the family Actiniidae (see https://en.wikipedia.org/wiki/Actinia). While the sea creature is filtering the sea water, the actinia geoprocessing platform filters in large data oceans.

Tutorials

a) Actinia Documentation, Tutorial and Examples: Actinia - The GRASS GIS REST API, https://actinia.mundialis.de/tutorial/index.html

b) "A gentle introduction to actinia", https://neteler.gitlab.io/actinia-introduction/ (author: Markus Neteler, mundialis GmbH & Co. KG, Bonn):

  • This workshop introduces actinia and has a more detailed chapter about ace - the actinia command execution.

c) "A gentle introduction to actinia", https://mmacata.github.io/actinia-introduction/ (authors: Markus Neteler, Carmen Tawalika, Anika Weinmann, Guido Riembauer, mundialis GmbH & Co. KG, Bonn):

d) Jupyter Notebook to explore basic API calls: https://github.com/acoiman/actinia_jupyter (authors: Abraham Coiman)

How to contribute

Please see CONTRIBUTING.md

Actinia REST API documentation

Actinia is fully documented using the OpenAPI standard [1], better known as swagger [2]. The full API documentation is available on the mundialis testing environment here: API Docs.

The JSON definition of the API can be accessed here.
A more interactive API documentation generated with Redoc [3] from the OpenAPI definitions can be viewed here.
Also, the petstore swagger UI creator [4] can be used to show all available REST API calls and all response models in a convenient way.

For the releases and changelog, see https://github.com/mundialis/actinia_core/releases

Actinia and GRASS GIS Addons

In general, all GRASS GIS modules and addons (official and self-developed) can be used in actinia. Some certain modules provide dedicated functionality for actinia itself:

Actinia and openEO

Compared to the OpenEO API actinia targets a broader range of applications as it includes the entire range of GRASS GIS functionality and more which isn't reflected in the openEO API.

Here a short attempt to illustrate some differences:

  • actinia offerings (overview of actinia API):

  • openeo-grassgis-driver offerings

    • openEO compliant functionality for raster, vector, time series processing, and more
    • if the openEO use cases fit and are sufficient (mainly processing and analysis of earth observation data) and if the concept of data cubes fits well to the data to be processed, then using the openEO API would be a better approach because of interchangeability.

Actinia deployment

Actinia requires a running redis database, which can be easily deployed together with actinia. For a quick and straightforward deployment, navigate to the actinia_core/docker directory and run

docker-compose -f docker-compose.yml build  # you can also specify the desired actinia version in the docker-compose.yml

docker-compose -f docker-compose.yml up 
# or in detached mode:
docker-compose -f docker-compose.yml up -d

For more information see https://github.com/mundialis/actinia_core/tree/main/docker#readme

Actinia can also be installed in kubernetes or openshift via a helm chart: https://github.com/mundialis/helm-charts/tree/main/charts/actinia

actinia presentations and workshops

2021:

  • News from actinia (presentation), Tawalika, C. FOSS4G 2021, Buenos Aires, Argentina. Online, video
  • A gentle introduction to actinia: geoprocessing in the cloud (workshop), Tawalika, C. FOSS4G 2021, Buenos Aires, Argentina. Online, material
  • actinia: geoprocessamento nel cloud (workshop in italiano), Neteler, M., supported by Delucchi, L.
    • Corsi GEAM e GFOSS 2020-2021, Italy, March 12, 2021, 2:30-6:30 p.m., online, material, video

2020:

  • Geoprocessing in the cloud with actinia (presentation), Neteler, M.
    • DOI Open Source Geospatial Meeting, USA, October 29, 2020 7:00-8:00 p.m., online
  • actinia: geoprocessing in the cloud (presentation), Neteler, M.
    • FOSDEM 2020 Feb. 2020, video

2019:

  • Die Open Source Geoprozessierungsplattform actinia (presentation). Neteler, M.
    • Neue Perspektiven der Erdbeobachtung, 2. Symposium zur angewandten Satellitenerdbeobachtung, 12.-13. Nov. 2019, Köln, Germany
  • GRASS GIS in the cloud: actinia geoprocessing (presentation). Tawalika, C., Neteler, M.
    • FOSS4G 2019, Aug. 2019, Bucharest, Romania (slides and video)
  • Cloud based processing of geo and Earth observation data (workshop), Neteler, M.
    • GeoSTAT 2019, Sep 2019, Münster, Germany
  • Actinia: Cloud based geoprocessing (presentation). Neteler, M., Gebbert, S., Tawalika, C., Bettge, A., Benelcadi, H., Löw, F., Adams, T., Paulsen, H.
    • Big Data from Space (BiDS'19) - Turning Data into Insights. 19-21 Feb 2019, Munich, Germany (paper

2018:

  • Actinia Open Source – geoprocessing in the cloud (presentation), Adams, T.
    • FOSS4G 2018, Aug. 2018, Dar es Salaam, Tanzania

2017:

  • Processing and spatial analysis of multi-temporal remote sensing data (presentation), M. Neteler, C. Tawalika, T. Adams, H. Paulsen
    • Feld-Phänotypisierung - Merkmale von oben messen, 27. - 29. Juni 2017
  • actinia – API zur Prozessierung von Copernicus-Daten (presentation), T. Adams.
    • GeoIT round table, June 2017

Citing actinia

DOI

If you use this software, please cite it properly, depending on the version you use:

  • Tawalika, Carmen, Weinmann, Anika, Riembauer, Guido, Metz, Markus, Haas, Julia, Jansen, Marc, Herrera Maldonado, Jorge A., Gebbert, Sören, & Neteler, Markus. (2022). actinia-core (3.0.0). Zenodo. https://doi.org/10.5281/zenodo.5865317
  • Tawalika, Carmen, Weinmann, Anika, Riembauer, Guido, Metz, Markus, Haas, Julia, Jansen, Marc, Gebbert, Sören, & Neteler, Markus. (2021). actinia-core (2.0.0). Zenodo. https://doi.org/10.5281/zenodo.5865265
  • Gebbert, Sören, Tawalika, Carmen, Weinmann, Anika, Riembauer, Guido, Metz, Markus, Jansen, Marc, & Neteler, Markus. (2021). actinia-core (1.0.0). Zenodo. https://doi.org/10.5281/zenodo.5864848

Links:

[1] https://www.openapis.org/

[2] https://swagger.io

[3] https://redocly.github.io/redoc/

[4] https://petstore.swagger.io

Clone this wiki locally