chunk

UnitsAwareDataArray.chunk(chunks: T_Chunks = {}, *, name_prefix: str = 'xarray-', token: str | None = None, lock: bool = False, inline_array: bool = False, chunked_array_type: str | ChunkManagerEntrypoint | None = None, from_array_kwargs=None, **chunks_kwargs: Any) Self

Coerce this array’s data into a dask arrays with the given chunks.

If this variable is a non-dask array, it will be converted to dask array. If it’s a dask array, it 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, "auto", tuple of int or mapping of Hashable to int, optional) – Chunk sizes along each dimension, e.g., 5, "auto", (5, 5) or {"x": 5, "y": 5}.

  • name_prefix (str, optional) – Prefix for the name of the new dask array.

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

  • 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 the underlying data array 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

Return type:

xarray.DataArray

See also

DataArray.chunks, DataArray.chunksizes, xarray.unify_chunks, dask.array.from_array