🍾 Xarray is now 10 years old! 🎉

xarray.Dataset.chunk

Contents

xarray.Dataset.chunk#

Dataset.chunk(chunks={}, name_prefix='xarray-', token=None, lock=False, inline_array=False, chunked_array_type=None, from_array_kwargs=None, **chunks_kwargs)[source]#

Coerce all arrays in this dataset into dask arrays with the given chunks.

Non-dask arrays in this dataset will be converted to dask arrays. Dask arrays will be rechunked to the given chunk sizes.

If neither chunks is not provided for one or more dimensions, chunk sizes along that dimension will not be updated; non-dask arrays will be converted into dask arrays with a single block.

Parameters:
  • chunks (int, tuple of int, "auto" or mapping of hashable to int, optional) – Chunk sizes along each dimension, e.g., 5, "auto", or {"x": 5, "y": 5}.

  • name_prefix (str, default: "xarray-") – Prefix for the name of any new dask arrays.

  • token (str, optional) – Token uniquely identifying this dataset.

  • lock (bool, default: False) – Passed on to dask.array.from_array(), if the array is not already as dask array.

  • inline_array (bool, default: False) – Passed on to dask.array.from_array(), if the array is not already as dask array.

  • chunked_array_type (str, optional) – Which chunked array type to coerce this datasets’ arrays to. Defaults to ‘dask’ if installed, else whatever is registered via the ChunkManagerEntryPoint system. Experimental API that should not be relied upon.

  • from_array_kwargs (dict, optional) – Additional keyword arguments passed on to the ChunkManagerEntrypoint.from_array method used to create chunked arrays, via whichever chunk manager is specified through the chunked_array_type kwarg. For example, with dask as the default chunked array type, this method would pass additional kwargs to dask.array.from_array(). Experimental API that should not be relied upon.

  • **chunks_kwargs ({dim: chunks, ...}, optional) – The keyword arguments form of chunks. One of chunks or chunks_kwargs must be provided

Returns:

chunked (xarray.Dataset)