A gentle introduction to actinia

Authors: Markus Neteler, Carmen Tawalika, Anika Weinmann, Guido Riembauer, Markus Metz, mundialis GmbH & Co. KG, Bonn

Fork Me On GitHub

URL of this dcument: https://metzm.github.io/actinia-introduction/

This workshop is a fork of https://mmacata.github.io/actinia-introduction/. The initial workshop has more exercises. This workshop focuses on the "bare" HTTP API from actinia and jupyter notebooks to interact with actinia.

Last update: 13 jun 2022

Abstract

Actinia (https://actinia.mundialis.de/) is an open source REST API for processing of geographical data in cloud computing systems that uses mainly GRASS GIS for computational tasks. Core functionality includes the processing of single scenes and time series of satellite images, of raster and vector data. With the existing big geodata pools growing day by day (e.g. Landsat and the Sentinel family), actinia is designed to follow the paradigm of bringing algorithms to the cloud stored geodata.

Actinia is an OSGeo Community Project since 2019.

In this course we will give a short introduction to REST API and cloud processing concepts. This is followed by an introduction to actinia processing along with hands-on to get more familiar with the topic by means of exercises.

Required software for this tutorial

We will use an HTTP client to try out some REST commands. This can be a command line tool, code editor plugin or browser plugin. This requires some software to be installed:

• REST client (one of the options below):

  • Command line tool: cURL, to be used on command line
  • Extensions for Chrome/Chromium browser:
    • RESTman extension
    • and a nice JSON Formatter
  • Extension for code editor, here for VS Code
    • Thunderclient plugin
    • If you use a different editor, a similar plugin might exist

• Not required for this workshop but nice to have:

  • jq, a lightweight and flexible command-line JSON processor
  • QGIS

The "ace - actinia command execution" section is a demonstration only. To dive deeper into this topic, you can follow these installation instructions.

Note: We will use the demo actinia server at https://actinia.mundialis.de/ - hence Internet connection is required.

actinia tutorial overview

Content

• Concepts of actinia, cloud computing, REST API
  • Why cloud computing?
  • Overview actinia
  • REST API and geoprocessing basics
• Explore
  • First Hand-on: working with REST API requests
  • Exploring the API: finding available actinia endpoints
• Client implementations
  • ACE - Controlling actinia from a running GRASS GIS session
  • actinia Connector - a QGIS plugin
  • actinia python client
• actinia with jupyter notebooks
  • Getting started with jupyter notebooks
  • actinia jupyter notebooks
• Conclusions and future
• About the trainers