API reference

Public entry points for building lazy mosaics, configuring services, and handling failures.

Array

create_array	Create an xarray DataArray backed by Dask from a remote service.
load_array	Convenience wrapper around create_array().
compute_with_policy	Compute a Dask-backed xarray or dask object with fetch-aligned thread workers.
array.compute_thread_pool_size	Thread-pool size for Dask's threads scheduler when computing tile arrays.

create_array builds a lazy Dask-backed xarray.DataArray. Prefer compute_with_policy() over plain .compute() on multi-tile mosaics so Dask workers match the fetch ceiling. Pass a service config (or URL where supported) as the first argument — not only a bare string for every service type.

Configs

ServiceConfig	Serializable configuration describing how to build a service instance.
WCSConfig	Configuration helper for Web Coverage Services.
WMSConfig	Configuration helper for Web Map Services.
WMTSConfig	Configuration helper for Web Map Tile Services.
XYZConfig	Configuration helper for XYZ / slippy-map tile templates.

Presets: WCSConfig.for_ea_dsp, XYZConfig.for_openstreetmap. Custom hosts: each config’s from_url. WCSConfig.build_service() validates coverage via live DescribeCoverage (network on first create_array path that needs capabilities, not only at import time).

Types

types.CRS	Common Coordinate Reference Systems.
types.Format	Supported output formats.
types.BoundingBox	Bounding box representation.
types.TileRequest	Generic tile request parameters.
types.TileResponse	Response from tile request.

Errors

TileArrayError	Base exception for TileArray library.
ServiceError	Errors related to geospatial service interactions.
ValidationError	Data validation errors.
NetworkError	Network-related errors.
ParseError	Data parsing errors.
ConfigurationError	Configuration and setup errors.

NetworkError means a tile failed after retries — mosaics do not leave silent NaN holes.

Fetch

fetch.FetchPolicy

Configuration for TileFetcher.

FetchPolicy controls concurrency, retries, timeouts, rate limits, and optional AIMD / circuit-breaker behaviour. Service configs expose the same knobs and build a policy via .fetch_policy().

Registry / services

get_service	Instantiate the appropriate service implementation for url.
register_service	Decorator for registering service implementations.
detect_service_type	Infer the service type from the URL or query string.
WCSService	Client for interacting with WCS endpoints.
WMSService	Client for WMS GetMap endpoints.
WMTSService	Client for WMTS GetTile endpoints (REST template or KVP).
XYZService	Client for XYZ / slippy-map tile endpoints.

Lower-level clients and parsers also live under tilearray.service. Arrays from create_array are north-up (row 0 = north).