healpix_convert.create_staging_cache#

healpix_convert.create_staging_cache(input_paths, settings, *, groups=None, output_extent=None)[source]#

Create a temporary (staging) conversion data cache by parsing input dataset(s) and conversion settings.

Useful for testing and debugging or for multi-stage conversion workflows.

Parameters:

  • input_paths (list of paths) – Path(s) to the input Zarr dataset(s) to convert to HEALPix.

  • settings (dict or object) – Healpix conversion settings.

  • groups (str or list, optional) – Groups (paths) in the input datasets to process. It can be either a string (single group or unix-like pattern) or a list of groups. By default, all groups found in input datasets are processed.

  • output_extent (dict or shapely.Polygon, optional) – Spatial extent of the output HEALPix dataset, given as a (GEOJSON-like or object) polygon with lat-lon coordinates. If not given (default), the spatial extent will be the union of the spatial extents of the input datasets (single polygon).

Returns:

ConvertStagingCache – A reusable data cache that contains information extracted from the input dataset(s) and/or pre-computed for the output dataset.