# xarray
> # xarray: N-D labeled arrays and datasets
>
> [](https://xarray.dev)
> [](https://pixi.sh)
> [](https://github.com/pydata/xarray/actions/workflows/ci.yaml?query=branch%3Amain)
> [](https://codecov.io/gh/pydata/xarray)
> [](https://docs.xarray.dev/)
> [](https://asv-runner.github.io/asv-collection/xarray/)
> [](https://github.com/astral-sh/ruff)
> [](https://mypy-lang.org/)
> [](https://pypi.python.org/pypi/xarray/)
> [](https://pypistats.org/packages/xarray)
> [](https://anaconda.org/anaconda/xarray)
> [](https://doi.org/10.5281/zenodo.598201)
> [](https://mybinder.org/v2/gh/pydata/xarray/main?urlpath=lab/tree/doc/examples/weather-data.ipynb)
> [](https://x.com/xarray_dev)
>
> **xarray** (pronounced "ex-array", formerly known as **xray**) is an open source project and Python
> package that makes working with labelled multi-dimensional arrays
> simple, efficient, and fun!
>
> Xarray introduces labels in the form of dimensions, coordinates and
> attributes on top of raw [NumPy](https://www.numpy.org)-like arrays,
> which allows for a more intuitive, more concise, and less error-prone
> developer experience. The package includes a large and growing library
> of domain-agnostic functions for advanced analytics and visualization
> with these data structures.
>
> Xarray was inspired by and borrows heavily from
> [pandas](https://pandas.pydata.org), the popular data analysis package
> focused on labelled tabular data. It is particularly tailored to working
> with [netCDF](https://www.unidata.ucar.edu/software/netcdf) files, which
> were the source of xarray\'s data model, and integrates tightly with
> [dask](https://dask.org) for parallel computing.
>
> ## Why xarray?
>
> Multi-dimensional (a.k.a. N-dimensional, ND) arrays (sometimes called
> "tensors") are an essential part of computational science. They are
> encountered in a wide range of fields, including physics, astronomy,
> geoscience, bioinformatics, engineering, finance, and deep learning. In
> Python, [NumPy](https://www.numpy.org) provides the fundamental data
> structure and API for working with raw ND arrays. However, real-world
> datasets are usually more than just raw numbers; they have labels which
> encode information about how the array values map to locations in space,
> time, etc.
>
> Xarray doesn\'t just keep track of labels on arrays \-- it uses them to
> provide a powerful and concise interface. For example:
>
> - Apply operations over dimensions by name: `x.sum('time')`.
> - Select values by label instead of integer location:
> `x.loc['2014-01-01']` or `x.sel(time='2014-01-01')`.
> - Mathematical operations (e.g., `x - y`) vectorize across multiple
> dimensions (array broadcasting) based on dimension names, not shape.
> - Flexible split-apply-combine operations with groupby:
> `x.groupby('time.dayofyear').mean()`.
> - Database like alignment based on coordinate labels that smoothly
> handles missing values: `x, y = xr.align(x, y, join='outer')`.
> - Keep track of arbitrary metadata in the form of a Python dictionary:
> `x.attrs`.
>
> ## Documentation
>
> Learn more about xarray in its official documentation at
> .
>
> Try out an [interactive Jupyter
> notebook](https://mybinder.org/v2/gh/pydata/xarray/main?urlpath=lab/tree/doc/examples/weather-data.ipynb).
>
> ## Contributing
>
> You can find information about contributing to xarray at our
> [Contributing
> page](https://docs.xarray.dev/en/stable/contributing.html).
>
> ## Get in touch
>
> - Ask usage questions ("How do I?") on
> [GitHub Discussions](https://github.com/pydata/xarray/discussions).
> - Report bugs, suggest features or view the source code [on
> GitHub](https://github.com/pydata/xarray).
> - For less well defined questions or ideas, or to announce other
> projects of interest to xarray users, use the [mailing
> list](https://groups.google.com/forum/#!forum/xarray).
>
> ## NumFOCUS
>
> 
>
> Xarray is a fiscally sponsored project of
> [NumFOCUS](https://numfocus.org), a nonprofit dedicated to supporting
> the open source scientific computing community. If you like Xarray and
> want to support our mission, please consider making a
> [donation](https://numfocus.org/donate-to-xarray) to support
> our efforts.
>
> ## History
>
> Xarray is an evolution of an internal tool developed at [The Climate
> Corporation](https://climate.com/). It was originally written by Climate
> Corp researchers Stephan Hoyer, Alex Kleeman and Eugene Brevdo and was
> released as open source in May 2014. The project was renamed from
> "xray" in January 2016. Xarray became a fiscally sponsored project of
> [NumFOCUS](https://numfocus.org) in August 2018.
>
> ## Contributors
>
> Thanks to our many contributors!
>
> [](https://github.com/pydata/xarray/graphs/contributors)
>
> ## License
>
> Copyright 2014-2024, xarray Developers
>
> Licensed under the Apache License, Version 2.0 (the "License"); you
> may not use this file except in compliance with the License. You may
> obtain a copy of the License at
>
>
>
> Unless required by applicable law or agreed to in writing, software
> distributed under the License is distributed on an "AS IS" BASIS,
> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
> See the License for the specific language governing permissions and
> limitations under the License.
>
> Xarray bundles portions of pandas, NumPy and Seaborn, all of which are
> available under a "3-clause BSD" license:
>
> - pandas: `setup.py`, `xarray/util/print_versions.py`
> - NumPy: `xarray/compat/npcompat.py`
> - Seaborn: `_determine_cmap_params` in `xarray/plot/utils.py`
>
> Xarray also bundles portions of CPython, which is available under the
> "Python Software Foundation License" in `xarray/namedarray/pycompat.py`.
>
> Xarray uses icons from the icomoon package (free version), which is
> available under the "CC BY 4.0" license.
>
> The full text of these licenses are included in the licenses directory.
2014-2026, xarray Developers
## Pages in this subsection
- [Toy weather data](weather-data.html.md): Here is an example of how to easily manipulate a toy weather dataset using
- [Calculating Seasonal Averages from Time Series of Monthly Means](monthly-means.html.md): Author: Joe Hamman
- [Compare weighted and unweighted mean temperature](area_weighted_temperature.html.md): <h1>Table of Contents<span class="tocSkip"></span></h1>
- [Working with Multidimensional Coordinates](multidimensional-coords.html.md): Author: Ryan Abernathey
- [Visualization Gallery](visualization_gallery.html.md): This notebook shows common visualization issues encountered in xarray.
- [ROMS Ocean Model Example](ROMS_ocean_model.html.md): The Regional Ocean Modeling System (ROMS) is an open source hydrodynamic model that is used for simu...
- [GRIB Data Example](ERA5-GRIB-example.html.md): GRIB format is commonly used to disseminate atmospheric model data. With xarray and the cfgrib engin...
- [Applying unvectorized functions with `apply_ufunc`](apply_ufunc_vectorize_1d.html.md): This example will illustrate how to conveniently apply an unvectorized function `func` to xarray obj...
- [Blank template](blank_template.html.md): Use this notebook from Binder to test an issue or reproduce a bug report
## Optional
- [Top-level llms.txt](../llms.txt): Complete documentation index.