alsdb.TileDBProvider

class alsdb.TileDBProvider(storage_type: str = 'local', uri: str | None = None, url: str | None = None, region: str = 'eu-central-1', credentials: Dict[str, str] | None = None, s3_config_overrides: Dict[str, str] | None = None)

Base class for managing low-level interactions with TileDB arrays for ALS data.

Supports both local filesystem arrays and S3-backed arrays (including S3-compatible stores such as MinIO).

Parameters:

• storage_type – Either "local" or "s3".

• uri –

  Full URI for the TileDB array.

  • local: absolute or relative filesystem path (e.g. "/data/als_array").

  • s3: s3:// URI (e.g. "s3://my-bucket/als/pnoa_2021").

• url – S3 endpoint URL (required when storage_type="s3"). For AWS use "s3.amazonaws.com"; for MinIO use the host:port of your instance.

• region – S3 region (default "eu-central-1").

• credentials – Dictionary with S3 credentials keys: "AccessKeyId", "SecretAccessKey", and optionally "SessionToken". If None, unsigned (public) access is attempted.

• s3_config_overrides – Optional dictionary of raw TileDB vfs.s3.* config keys to override after the defaults are applied (useful for experiments).

__init__(storage_type: str = 'local', uri: str | None = None, url: str | None = None, region: str = 'eu-central-1', credentials: Dict[str, str] | None = None, s3_config_overrides: Dict[str, str] | None = None) → None

Methods

__init__([storage_type, uri, url, region, ...])
array_exists()	Return True if the TileDB array already exists.
open(mode)	Open the TileDB array in the given mode ("r" or "w").

Attributes

schema

Return (and cache) the array schema.