Skip to main content

xarray (formerly 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-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, the popular data analysis package focused on labelled tabular data. It is particularly tailored to working with netCDF files, which were the source of xarray’s data model, and integrates tightly with dask 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 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.

Learn more

Metadata

Release files for xarray 0.14.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xarray 0.14.1
File Size Uploaded
xarray-0.14.1.tar.gz 1.9 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for xarray 0.14.1
File Interpreter ABI Platform
xarray-0.14.1-py3-none-any.whl Python 3 none any Details

Total release size: 2.5 MB

Release files / xarray-0.14.1.tar.gz

Download URL xarray-0.14.1.tar.gz
Size 1.9 MB
Tags Source
SHA-256 checksum
How to use checksums
04b2f4d24707b8871a7ffa37328d0a2de74e81bd30791c9608712612601abd23
BLAKE2b-256 checksum
How to use checksums
fcb05363ea996581c1f534dc0eb3e1138fb351b26f44e76e71f55b229394de3e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.5

Release files / xarray-0.14.1-py3-none-any.whl

Download URL xarray-0.14.1-py3-none-any.whl
Size 634.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
66286fce27a51953dfc6c6a67ea50bed80fe3425f4921b03b70b1b6ca91e8f23
BLAKE2b-256 checksum
How to use checksums
a8524a561281f536d0902d6279f47fd48894c2c7b7fb078816f18367e9ef46be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.5

Release history Release notifications | RSS feed

0.21.0

2 release files

0.20.2

2 release files

0.19.0

2 release files

0.18.2

2 release files

0.18.1

2 release files

0.17.0

2 release files

0.16.2

2 release files

0.16.1

2 release files

0.16.0

2 release files

0.15.1

2 release files

0.15.0

2 release files

This release

0.14.1 This release

2 release files

0.14.0

2 release files

0.13.0

2 release files

0.12.3

2 release files

0.12.2

2 release files

0.12.0

2 release files

0.11.3

2 release files

0.11.1

2 release files

0.10.9

2 release files

0.10.8

2 release files

0.10.5

1 release file

0.10.4

2 release files

0.10.3

2 release files

0.10.2

2 release files

0.10.1

2 release files

0.10.0

2 release files

0.9.6

2 release files

0.9.5

2 release files

0.9.4

2 release files

0.9.3

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page