terrapi: a terrabyte client library

The terrabyte client library terrapi is a small command line interface to help users interact with terrabyte APIs. It encompasses support for user authentication via 2FA login and caches the resulting authentication token for use in further API calls. On terrabyte the library can be activated from the module system or it can be installed outside of terrabyte (see install terrapi)

terrapi STAC

One main usage of the terrapi cli is the management of private or shared user STAC Collections analog to the curated datasets (see STAC Collections).

private collections

Every user has the possibility to create/update/delete/query their own private STAC Collections. All datasets registered here are only visible to you and cannot be queried by anybody else. This allows users to register their intermediate datasets as input for futher computations. To mark a collection as private prepend the name of the collection with your LRZ username, e.g., something like "di99abc.Sentinel2Classification"

shared collections

Next to private collections there are also shared collections. Access to shared collections is controlled by the DSS Containers a user has access to. Being able to query the STAC Collections where a user does not also have (at least) read access, is not beneficial as he will not be able to access the actual raster data referenced by its path. All users that have rw access to a DSS Container and are also allowed to create/update/delete the corresponding collections, while users with ro access can query them.