arcosparse

What it is and what it does

arcosparse is a Python library for querying and downloading subsets of sparse geospatial datasets that have been stored in ARCO (Analysis Ready Cloud Optimized) format and exposed via STAC (SpatioTemporal Asset Catalog) metadata. It wraps SQLite-backed data access with spatial, temporal, and variable filtering, returning results either as pandas DataFrames or as partitioned Parquet files for large extracts. The library handles authentication via bearer tokens for restricted datasets (particularly ECMWF data) and provides metadata introspection functions to explore available entities, variables, and coordinate ranges before subsetting.

The package is built on requests, pandas, pystac, pyarrow, and tqdm, and is explicitly marked as a low-level tool—the authors recommend using higher-level interfaces like the Copernicus Marine Toolbox or earthkit for typical workflows. It is actively maintained and supports Python 3.9 through 3.14.

Use it for:

• Extract a spatial and temporal subset of oceanographic data from a Copernicus Marine STAC catalog and load it into a DataFrame for analysis.
• Download a large regional climate dataset as partitioned Parquet files to avoid memory constraints, then read all partitions into a single DataFrame.
• Query available entities and metadata from a remote STAC dataset to understand its structure before requesting a subset.
• Authenticate to ECMWF STAC assets using a bearer token and retrieve a filtered subset of meteorological variables.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Downloads and subsets sparse geospatial datasets stored in ARCO format via STAC metadata and SQLite, returning results as pandas DataFrames or partitioned Parquet files.

Yes, if you are working directly with ARCO sparse datasets via STAC and need fine-grained subsetting control. The library is actively maintained, has low install friction, and carries no known vulnerabilities. However, the unclear license status should be resolved before use in production, and the authors explicitly recommend higher-level tools (Copernicus Marine Toolbox, earthkit) for most users—install this only if you have a specific need for low-level STAC subsetting.

Install

arcosparse on PyPI

pip install arcosparse

uv add arcosparse

poetry add arcosparse

Installing arcosparse

Before you install

Low install friction with a pure-Python wheel and five common dependencies. Active maintenance with recent release (158 days ago). Supports Python 3.9 through 3.14.

License in practice

License treatment is unclear—no SPDX identifier or raw license text is recorded in the package metadata, so the actual license terms cannot be verified from this fact sheet alone.

Quickstart

import arcosparse

df = arcosparse.subset_and_return_dataframe(
    url_metadata="https://example.com/metadata.json",
    minimum_latitude=10,
    maximum_latitude=20,
    minimum_longitude=30,
    maximum_longitude=40,
    variables=["temperature"]
)

Requires a valid STAC metadata URL; authentication token may be needed for ECMWF or other restricted datasets.

Verify before relying

• What is the actual license of arcosparse (SPDX identifier not recorded)?
• Are there known limitations or performance characteristics for very large subsets?
• Does the package work with all STAC catalogs or only specific implementations?

Package facts

Evidence: arcosparse-0.5.1-py3-none-any.whl

Tags

More Information Analysis packages