{"id":13735951,"url":"https://github.com/actinia-org/actinia-core","last_synced_at":"2026-01-12T01:08:46.943Z","repository":{"id":30489323,"uuid":"125061415","full_name":"actinia-org/actinia-core","owner":"actinia-org","description":"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 (DOI: https://doi.org/10.5281/zenodo.5879231) | Tutorial: https://actinia-org.github.io/actinia-core/ | Docker: https://hub.docker.com/r/mundialis/actinia-core","archived":false,"fork":false,"pushed_at":"2024-10-29T11:06:17.000Z","size":11143,"stargazers_count":80,"open_issues_count":64,"forks_count":23,"subscribers_count":13,"default_branch":"main","last_synced_at":"2024-10-29T13:10:32.018Z","etag":null,"topics":["actinia","earth-observation","geospatial","geospatial-analysis","gis","grass-gis","hacktoberfest","opensource","rest-api"],"latest_commit_sha":null,"homepage":"https://actinia.mundialis.de/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/actinia-org.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.rst","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-13T14:07:32.000Z","updated_at":"2024-10-25T21:10:25.000Z","dependencies_parsed_at":"2023-02-17T10:45:48.249Z","dependency_job_id":"d5dbd1e6-72a5-4ba6-ba43-6c6f27a1ce6e","html_url":"https://github.com/actinia-org/actinia-core","commit_stats":{"total_commits":774,"total_committers":32,"mean_commits":24.1875,"dds":0.8074935400516796,"last_synced_commit":"4f13eebf57f49b29798551aa8104c411a3075a88"},"previous_names":["actinia-org/actinia_core"],"tags_count":107,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/actinia-org%2Factinia-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/actinia-org%2Factinia-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/actinia-org%2Factinia-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/actinia-org%2Factinia-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/actinia-org","download_url":"https://codeload.github.com/actinia-org/actinia-core/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224732131,"owners_count":17360416,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actinia","earth-observation","geospatial","geospatial-analysis","gis","grass-gis","hacktoberfest","opensource","rest-api"],"created_at":"2024-08-03T03:01:13.348Z","updated_at":"2026-01-12T01:08:41.900Z","avatar_url":"https://github.com/actinia-org.png","language":"Python","funding_links":[],"categories":["`Python` processing of optical imagery (non deep learning)"],"sub_categories":["Python libraries related to EO"],"readme":"# Actinia — The GRASS GIS REST API\n\nSoftware [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.5879231.svg)](https://doi.org/10.5281/zenodo.5879231)\nArticle [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.2631917.svg)](https://doi.org/10.5281/zenodo.2631917)\n[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Docker pulls](https://img.shields.io/docker/pulls/mundialis/actinia-core.svg)](https://hub.docker.com/r/mundialis/actinia-core)\n\n**[Actinia](https://actinia.mundialis.de/)** is an open source REST API for scalable, distributed, high performance\nprocessing of geographical data that mainly uses [GRASS GIS](https://grass.osgeo.org/) for computational tasks.\n\nIt provides a REST API to process satellite images, time series of satellite images,\narbitrary raster data with geographical relations and vector data.\n\nThe REST interface allows to access, manage and manipulate the GRASS GIS\ndatabase via HTTP GET, PUT, POST and DELETE requests and to process raster, vector and\ntime series data located in a persistent GRASS GIS database.\n**Actinia** allows the processing of cloud-based data, for example all Landsat 4-8 scenes as well as all\nSentinel-2 scenes in ephemeral databases. The computational results of ephemeral processing\nare available via object storage as GeoTIFF files.\n\n## API documentation\n\n\u003c!---\na more complete API documentation generated with Spinx was here: https://actinia.mundialis.de/api_docs\nbut no longer exists\n---\u003e\n\nThe full API documentation is available [here](https://redocly.github.io/redoc/?url=https://actinia.mundialis.de/latest/swagger.json\u0026nocors)\n\n## actinia command execution - actinia shell\n\nThere is also an option to interactively control actinia. For details,\nsee [here](https://github.com/actinia-org/ace).\n\n## Installation\n\nRequired system packages:\n\n- alpine: `apk add python3 py3-pip`\n  As not all python packages are pre-build for alpine, they need to be build during installation. For this some system packages are required:\n  `apk add python3 py3-pip python3-dev gcc musl-dev linux-headers build-base gdal gdal-tools gdal-dev proj proj-util proj-dev geos-dev py3-numpy-dev`\n- ubuntu: `apt install -y python3 python3-pip`\n\nAnd then install from pypi:\n\n```bash\npip install actinia-core\n```\n\n## Installation with Docker\n\nDocker images are available from https://hub.docker.com/r/mundialis/actinia-core\n\n```bash\ndocker pull mundialis/actinia-core\n```\n\nFor own deployments or local dev-setup, see the `docker/` subfolder.\n\nActinia is also available on [OSGeoLive](https://live.osgeo.org/en/overview/actinia_overview.html).\n\n## Examples\n\n### Data management\n\n- List all projects that are available in the actinia persistent database:\n\n```bash\ncurl -u 'demouser:gu3st!pa55w0rd' -X GET \"https://actinia.mundialis.de/api/v3/projects\"\n```\n\n- List all mapsets in the project latlong_wgs84:\n\n```bash\ncurl -u 'demouser:gu3st!pa55w0rd' -X GET \"https://actinia.mundialis.de/api/v3/projects/latlong_wgs84/mapsets\"\n```\n\n- List all space-time raster datasets (STRDS) in project latlong_wgs84 and mapset Sentinel_timeseries:\n\n```bash\ncurl -u 'demouser:gu3st!pa55w0rd' -X GET \"https://actinia.mundialis.de/api/v3/projects/latlong_wgs84/mapsets/modis_ndvi_global/strds\"\n```\n\n- List all raster map layers of the STRDS:\n\n```bash\ncurl -u 'demouser:gu3st!pa55w0rd' -X GET \"https://actinia.mundialis.de/api/v3/projects/latlong_wgs84/mapsets/modis_ndvi_global/strds/ndvi_16_5600m/raster_layers\"\n```\n\n### Landsat and Sentinel-2 NDVI computation\n\n- Compute the NDVI of the top of athmosphere (TOAR) corrected Landsat4 scene LC80440342016259LGN00:\n\n```bash\ncurl -u 'demouser:gu3st!pa55w0rd' -X POST \"https://actinia.mundialis.de/api/v3/landsat_process/LC80440342016259LGN00/TOAR/NDVI\"\n```\n\n- NDVI computation of Sentinel-2A scene S2A_MSIL1C_20170212T104141_N0204_R008_T31TGJ_20170212T104138:\n\n```bash\ncurl -u 'demouser:gu3st!pa55w0rd' -X POST \"https://actinia.mundialis.de/api/v3/sentinel2_process/ndvi/S2A_MSIL1C_20170212T104141_N0204_R008_T31TGJ_20170212T104138\"\n```\n\nThe results of the asynchronous computations are available as GeoTIFF file in a cloud storage for download.\n\n### List of available endpoints\n\nTo see a simple **list of endpoints** (and more), consult the \"paths\" section in the [API JSON](https://actinia.mundialis.de/api/v3/swagger.json); or, to list the available endpoints on command line, run:\n\n```bash\n# sudo npm install -g json\ncurl -u 'demouser:gu3st!pa55w0rd' -X GET https://actinia.mundialis.de/api/v3/swagger.json | json paths | json -ka\n```\n\n## Development\n\n### Use pre-commit\n\nIt is highly recommended to install and use [pre-commit](https://pre-commit.com)\nbefore submitting any new or modified code or any other content. The pre-commit\nGit hooks set checks validity and executes automated formatting for\na range of file formats, including Python. Pre-commit installs\nall necessary tools in a virtual environment upon first use.\n\nIf you never used pre-commit before, you must start by installing it on your\nsystem. You only do it once:\n\n```bash\npython -m pip install pre-commit\n```\n\nPre-commit must then be activated in the code repository. Change the directory\nto the root folder and use the `install` command:\n\n```bash\ncd \u003cactinia-core_source_dir\u003e\n\n# once per repo\npre-commit install\n```\n\nPre-commit will then be automatically triggered by the `git commit` command. If\nit finds any problem it will abort the commit and try to solve it automatically.\nIn that case review the changes and run again `git add` and\n`git commit`.\n\nIt is also possible to run pre-commit manually, e.g:\n\n```bash\npre-commit run flake8 --all-files\npre-commit run black --all-files\n# pre-commit run yamllint --all-files\n# pre-commit run markdownlint --all-files\n```\n\nOr to target a specific set of files:\n\n```bash\npre-commit run --files src/*\n```\n\nThe pre-commit hooks set is defined in\n[.pre-commit-config.yaml](.pre-commit-config.yaml).\n\nIt is possible to temporally disable the pre-commit hooks in the repo, e.g. while\nworking on older branches:\n\n```bash\npre-commit uninstall\n```\n\nAnd to reactivate pre-commit again:\n\n```bash\ngit switch main\npre-commit install\n```\n\n## Thanks to all contributors ❤\n\n[![actinia-core contributors](https://contrib.rocks/image?repo=actinia-org/actinia-core \"actinia-core contributors\")](https://github.com/actinia-org/actinia-core/graphs/contributors)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factinia-org%2Factinia-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Factinia-org%2Factinia-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Factinia-org%2Factinia-core/lists"}