# Top-level functions

## Computation

#### NOTE
For worked examples and advanced usage of `apply_ufunc`, see the
[User Guide on Computation](../user-guide/computation.html.md), and the
[apply_ufunc tutorial](https://tutorial.xarray.dev/advanced/apply_ufunc/apply_ufunc.html).

| [`apply_ufunc`](../generated/xarray.apply_ufunc.html.md#xarray.apply_ufunc)(func, \*args[, input_core_dims, ...])   | Apply a vectorized function for unlabeled arrays on xarray objects.        |
|-------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|
| [`cov`](../generated/xarray.cov.html.md#xarray.cov)(da_a, da_b[, dim, ddof, weights])                       | Compute covariance between two DataArray objects along a shared dimension. |
| [`corr`](../generated/xarray.corr.html.md#xarray.corr)(da_a, da_b[, dim, weights])                           | Compute the Pearson correlation coefficient between two DataArray objects. |
| [`cross`](../generated/xarray.cross.html.md#xarray.cross)(a, b, \*, dim)                                      | Compute the cross product of two (arrays of) vectors.                      |
| [`dot`](../generated/xarray.dot.html.md#xarray.dot)(\*arrays[, dim])                                        | Generalized dot product for xarray objects.                                |
| [`map_blocks`](../generated/xarray.map_blocks.html.md#xarray.map_blocks)(func, obj[, args, kwargs, template])      | Apply a function to each block of a DataArray or Dataset.                  |
| [`polyval`](../generated/xarray.polyval.html.md#xarray.polyval)(coord, coeffs[, degree_dim])                    | Evaluate a polynomial at specific values.                                  |
| [`unify_chunks`](../generated/xarray.unify_chunks.html.md#xarray.unify_chunks)(\*objects)                            | Unify the chunk sizes of any number of Dataset and/or DataArray objects.   |
| [`where`](../generated/xarray.where.html.md#xarray.where)(cond, x, y[, keep_attrs])                           | Return elements from x or y depending on cond.                             |

## Combining Data

| [`align`](../generated/xarray.align.html.md#xarray.align)(\*objects[, join, copy, indexes, ...])               | Align any number of Dataset and/or DataArray objects.                           |
|--------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------|
| [`broadcast`](../generated/xarray.broadcast.html.md#xarray.broadcast)(\*args[, exclude])                           | Explicitly broadcast any number of DataArray or Dataset objects together.       |
| [`concat`](../generated/xarray.concat.html.md#xarray.concat)(objs, dim[, data_vars, coords, ...])               | Concatenate xarray objects along a new or existing dimension.                   |
| [`merge`](../generated/xarray.merge.html.md#xarray.merge)(objects[, compat, join, fill_value, ...])            | Merge any number of xarray objects into a single Dataset as variables.          |
| [`combine_by_coords`](../generated/xarray.combine_by_coords.html.md#xarray.combine_by_coords)([data_objects, compat, ...]) | Attempt to auto-magically combine the given datasets (or data arrays) into one. |
| [`combine_nested`](../generated/xarray.combine_nested.html.md#xarray.combine_nested)(datasets, concat_dim[, ...])       | Explicitly combine an N-dimensional grid of datasets into one.                  |

## Creation

| [`DataArray`](../generated/xarray.DataArray.html.md#xarray.DataArray)([data, coords, dims, name, attrs, ...])   | N-dimensional array with labeled coordinates and dimensions.                 |
|-----------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
| [`Dataset`](../generated/xarray.Dataset.html.md#xarray.Dataset)([data_vars, coords, attrs])                   | A multi-dimensional, in memory, array database.                              |
| [`DataTree`](../generated/xarray.DataTree.html.md#xarray.DataTree)([dataset, children, name])                  | A tree-like hierarchical collection of xarray objects.                       |
| [`full_like`](../generated/xarray.full_like.html.md#xarray.full_like)(other, fill_value[, dtype, ...])          | Return a new object with the same shape and type as a given object.          |
| [`zeros_like`](../generated/xarray.zeros_like.html.md#xarray.zeros_like)(other[, dtype, chunks, ...])            | Return a new object of zeros with the same shape and type as a given object. |
| [`ones_like`](../generated/xarray.ones_like.html.md#xarray.ones_like)(other[, dtype, chunks, ...])              | Return a new object of ones with the same shape and type as a given object.  |

## Miscellaneous

| [`decode_cf`](../generated/xarray.decode_cf.html.md#xarray.decode_cf)(obj[, concat_characters, ...])   | Decode the given Dataset or Datastore according to CF conventions.   |
|--------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------|
| [`infer_freq`](../generated/xarray.infer_freq.html.md#xarray.infer_freq)(index)                         | Infer the most likely frequency given the input index.               |
| [`show_backends`](../generated/xarray.show_backends.html.md#xarray.show_backends)([file, markdown])        | Print the available backends (engines) and information about them.   |
| [`show_versions`](../generated/xarray.show_versions.html.md#xarray.show_versions)([file, markdown])        | Print the versions of xarray and its dependencies.                   |
| [`set_options`](../generated/xarray.set_options.html.md#xarray.set_options)(\*\*kwargs)                  | Set options for xarray in a controlled context.                      |
| [`get_options`](../generated/xarray.get_options.html.md#xarray.get_options)()                            | Get options for xarray.                                              |