logo

For users

  • Getting Started
    • Overview: Why xarray?
    • Installation
    • Quick overview
    • Frequently Asked Questions
  • User Guide
    • Terminology
    • Data Structures
    • Indexing and selecting data
    • Interpolating data
    • Computation
    • GroupBy: split-apply-combine
    • Reshaping and reorganizing data
    • Combining data
    • Time series data
    • Weather and climate data
    • Working with pandas
    • Reading and writing files
    • Parallel computing with Dask
    • Plotting
    • Working with numpy-like arrays
  • Gallery
    • Toy weather data
    • Calculating Seasonal Averages from Time Series of Monthly Means
    • Compare weighted and unweighted mean temperature
    • Working with Multidimensional Coordinates
    • Visualization Gallery
    • ROMS Ocean Model Example
    • GRIB Data Example
    • Applying unvectorized functions with apply_ufunc
  • Tutorials & Videos
  • API Reference
    • xarray.apply_ufunc
    • xarray.align
    • xarray.broadcast
    • xarray.concat
    • xarray.merge
    • xarray.combine_by_coords
    • xarray.combine_nested
    • xarray.where
    • xarray.set_options
    • xarray.infer_freq
    • xarray.full_like
    • xarray.zeros_like
    • xarray.ones_like
    • xarray.cov
    • xarray.corr
    • xarray.dot
    • xarray.polyval
    • xarray.map_blocks
    • xarray.show_versions
    • xarray.set_options
    • xarray.Dataset
    • xarray.decode_cf
    • xarray.Dataset.dims
    • xarray.Dataset.sizes
    • xarray.Dataset.data_vars
    • xarray.Dataset.coords
    • xarray.Dataset.attrs
    • xarray.Dataset.encoding
    • xarray.Dataset.indexes
    • xarray.Dataset.get_index
    • xarray.Dataset.chunks
    • xarray.Dataset.nbytes
    • xarray.Dataset.__getitem__
    • xarray.Dataset.__setitem__
    • xarray.Dataset.__delitem__
    • xarray.Dataset.update
    • xarray.Dataset.get
    • xarray.Dataset.items
    • xarray.Dataset.keys
    • xarray.Dataset.values
    • xarray.Dataset.copy
    • xarray.Dataset.assign
    • xarray.Dataset.assign_coords
    • xarray.Dataset.assign_attrs
    • xarray.Dataset.pipe
    • xarray.Dataset.merge
    • xarray.Dataset.rename
    • xarray.Dataset.rename_vars
    • xarray.Dataset.rename_dims
    • xarray.Dataset.swap_dims
    • xarray.Dataset.expand_dims
    • xarray.Dataset.drop_vars
    • xarray.Dataset.drop_dims
    • xarray.Dataset.set_coords
    • xarray.Dataset.reset_coords
    • xarray.Dataset.equals
    • xarray.Dataset.identical
    • xarray.Dataset.broadcast_equals
    • xarray.Dataset.loc
    • xarray.Dataset.isel
    • xarray.Dataset.sel
    • xarray.Dataset.drop_sel
    • xarray.Dataset.drop_isel
    • xarray.Dataset.head
    • xarray.Dataset.tail
    • xarray.Dataset.thin
    • xarray.Dataset.squeeze
    • xarray.Dataset.interp
    • xarray.Dataset.interp_like
    • xarray.Dataset.reindex
    • xarray.Dataset.reindex_like
    • xarray.Dataset.set_index
    • xarray.Dataset.reset_index
    • xarray.Dataset.reorder_levels
    • xarray.Dataset.query
    • xarray.Dataset.isnull
    • xarray.Dataset.notnull
    • xarray.Dataset.combine_first
    • xarray.Dataset.count
    • xarray.Dataset.dropna
    • xarray.Dataset.fillna
    • xarray.Dataset.ffill
    • xarray.Dataset.bfill
    • xarray.Dataset.interpolate_na
    • xarray.Dataset.where
    • xarray.Dataset.isin
    • xarray.Dataset.map
    • xarray.Dataset.reduce
    • xarray.Dataset.groupby
    • xarray.Dataset.groupby_bins
    • xarray.Dataset.rolling
    • xarray.Dataset.rolling_exp
    • xarray.Dataset.weighted
    • xarray.Dataset.coarsen
    • xarray.Dataset.resample
    • xarray.Dataset.diff
    • xarray.Dataset.quantile
    • xarray.Dataset.differentiate
    • xarray.Dataset.integrate
    • xarray.Dataset.map_blocks
    • xarray.Dataset.polyfit
    • xarray.Dataset.curvefit
    • xarray.Dataset.transpose
    • xarray.Dataset.stack
    • xarray.Dataset.unstack
    • xarray.Dataset.to_stacked_array
    • xarray.Dataset.shift
    • xarray.Dataset.roll
    • xarray.Dataset.pad
    • xarray.Dataset.sortby
    • xarray.Dataset.broadcast_like
    • xarray.Dataset.plot.scatter
    • xarray.Dataset.plot.quiver
    • xarray.Dataset.plot.streamplot
    • xarray.DataArray
    • xarray.DataArray.values
    • xarray.DataArray.data
    • xarray.DataArray.coords
    • xarray.DataArray.dims
    • xarray.DataArray.sizes
    • xarray.DataArray.name
    • xarray.DataArray.attrs
    • xarray.DataArray.encoding
    • xarray.DataArray.indexes
    • xarray.DataArray.get_index
    • xarray.DataArray.assign_coords
    • xarray.DataArray.assign_attrs
    • xarray.DataArray.pipe
    • xarray.DataArray.rename
    • xarray.DataArray.swap_dims
    • xarray.DataArray.expand_dims
    • xarray.DataArray.drop_vars
    • xarray.DataArray.drop_duplicates
    • xarray.DataArray.reset_coords
    • xarray.DataArray.copy
    • xarray.DataArray.__getitem__
    • xarray.DataArray.__setitem__
    • xarray.DataArray.loc
    • xarray.DataArray.isel
    • xarray.DataArray.sel
    • xarray.DataArray.drop_sel
    • xarray.DataArray.drop_isel
    • xarray.DataArray.head
    • xarray.DataArray.tail
    • xarray.DataArray.thin
    • xarray.DataArray.squeeze
    • xarray.DataArray.interp
    • xarray.DataArray.interp_like
    • xarray.DataArray.reindex
    • xarray.DataArray.reindex_like
    • xarray.DataArray.set_index
    • xarray.DataArray.reset_index
    • xarray.DataArray.reorder_levels
    • xarray.DataArray.query
    • xarray.DataArray.isnull
    • xarray.DataArray.notnull
    • xarray.DataArray.combine_first
    • xarray.DataArray.count
    • xarray.DataArray.dropna
    • xarray.DataArray.fillna
    • xarray.DataArray.ffill
    • xarray.DataArray.bfill
    • xarray.DataArray.interpolate_na
    • xarray.DataArray.where
    • xarray.DataArray.isin
    • xarray.DataArray.equals
    • xarray.DataArray.identical
    • xarray.DataArray.broadcast_equals
    • xarray.DataArray.reduce
    • xarray.DataArray.groupby
    • xarray.DataArray.groupby_bins
    • xarray.DataArray.rolling
    • xarray.DataArray.rolling_exp
    • xarray.DataArray.weighted
    • xarray.DataArray.coarsen
    • xarray.DataArray.resample
    • xarray.DataArray.get_axis_num
    • xarray.DataArray.diff
    • xarray.DataArray.dot
    • xarray.DataArray.quantile
    • xarray.DataArray.differentiate
    • xarray.DataArray.integrate
    • xarray.DataArray.polyfit
    • xarray.DataArray.map_blocks
    • xarray.DataArray.curvefit
    • xarray.DataArray.str
    • xarray.DataArray.str.capitalize
    • xarray.DataArray.str.casefold
    • xarray.DataArray.str.cat
    • xarray.DataArray.str.center
    • xarray.DataArray.str.contains
    • xarray.DataArray.str.count
    • xarray.DataArray.str.decode
    • xarray.DataArray.str.encode
    • xarray.DataArray.str.endswith
    • xarray.DataArray.str.extract
    • xarray.DataArray.str.extractall
    • xarray.DataArray.str.find
    • xarray.DataArray.str.findall
    • xarray.DataArray.str.format
    • xarray.DataArray.str.get
    • xarray.DataArray.str.get_dummies
    • xarray.DataArray.str.index
    • xarray.DataArray.str.isalnum
    • xarray.DataArray.str.isalpha
    • xarray.DataArray.str.isdecimal
    • xarray.DataArray.str.isdigit
    • xarray.DataArray.str.islower
    • xarray.DataArray.str.isnumeric
    • xarray.DataArray.str.isspace
    • xarray.DataArray.str.istitle
    • xarray.DataArray.str.isupper
    • xarray.DataArray.str.join
    • xarray.DataArray.str.len
    • xarray.DataArray.str.ljust
    • xarray.DataArray.str.lower
    • xarray.DataArray.str.lstrip
    • xarray.DataArray.str.match
    • xarray.DataArray.str.normalize
    • xarray.DataArray.str.pad
    • xarray.DataArray.str.partition
    • xarray.DataArray.str.repeat
    • xarray.DataArray.str.replace
    • xarray.DataArray.str.rfind
    • xarray.DataArray.str.rindex
    • xarray.DataArray.str.rjust
    • xarray.DataArray.str.rpartition
    • xarray.DataArray.str.rsplit
    • xarray.DataArray.str.rstrip
    • xarray.DataArray.str.slice
    • xarray.DataArray.str.slice_replace
    • xarray.DataArray.str.split
    • xarray.DataArray.str.startswith
    • xarray.DataArray.str.strip
    • xarray.DataArray.str.swapcase
    • xarray.DataArray.str.title
    • xarray.DataArray.str.translate
    • xarray.DataArray.str.upper
    • xarray.DataArray.str.wrap
    • xarray.DataArray.str.zfill
    • xarray.DataArray.dt.year
    • xarray.DataArray.dt.month
    • xarray.DataArray.dt.day
    • xarray.DataArray.dt.hour
    • xarray.DataArray.dt.minute
    • xarray.DataArray.dt.second
    • xarray.DataArray.dt.microsecond
    • xarray.DataArray.dt.nanosecond
    • xarray.DataArray.dt.dayofweek
    • xarray.DataArray.dt.weekday
    • xarray.DataArray.dt.weekday_name
    • xarray.DataArray.dt.dayofyear
    • xarray.DataArray.dt.quarter
    • xarray.DataArray.dt.days_in_month
    • xarray.DataArray.dt.daysinmonth
    • xarray.DataArray.dt.season
    • xarray.DataArray.dt.time
    • xarray.DataArray.dt.date
    • xarray.DataArray.dt.is_month_start
    • xarray.DataArray.dt.is_month_end
    • xarray.DataArray.dt.is_quarter_end
    • xarray.DataArray.dt.is_year_start
    • xarray.DataArray.dt.is_leap_year
    • xarray.DataArray.dt.floor
    • xarray.DataArray.dt.ceil
    • xarray.DataArray.dt.isocalendar
    • xarray.DataArray.dt.round
    • xarray.DataArray.dt.strftime
    • xarray.DataArray.dt.days
    • xarray.DataArray.dt.seconds
    • xarray.DataArray.dt.microseconds
    • xarray.DataArray.dt.nanoseconds
    • xarray.DataArray.dt.floor
    • xarray.DataArray.dt.ceil
    • xarray.DataArray.dt.round
    • xarray.DataArray.transpose
    • xarray.DataArray.stack
    • xarray.DataArray.unstack
    • xarray.DataArray.to_unstacked_dataset
    • xarray.DataArray.shift
    • xarray.DataArray.roll
    • xarray.DataArray.pad
    • xarray.DataArray.sortby
    • xarray.DataArray.broadcast_like
    • xarray.DataArray.plot
    • xarray.DataArray.plot.contourf
    • xarray.DataArray.plot.contour
    • xarray.DataArray.plot.hist
    • xarray.DataArray.plot.imshow
    • xarray.DataArray.plot.line
    • xarray.DataArray.plot.pcolormesh
    • xarray.DataArray.plot.step
    • xarray.DataArray.plot.surface
    • xarray.open_dataset
    • xarray.load_dataset
    • xarray.open_mfdataset
    • xarray.open_rasterio
    • xarray.open_zarr
    • xarray.Dataset.to_netcdf
    • xarray.Dataset.to_pandas
    • xarray.Dataset.to_zarr
    • xarray.save_mfdataset
    • xarray.Dataset.to_array
    • xarray.Dataset.to_dataframe
    • xarray.Dataset.to_dask_dataframe
    • xarray.Dataset.to_dict
    • xarray.Dataset.from_dataframe
    • xarray.Dataset.from_dict
    • xarray.Dataset.close
    • xarray.Dataset.compute
    • xarray.Dataset.persist
    • xarray.Dataset.load
    • xarray.Dataset.chunk
    • xarray.Dataset.unify_chunks
    • xarray.Dataset.filter_by_attrs
    • xarray.Dataset.info
    • xarray.open_dataarray
    • xarray.load_dataarray
    • xarray.DataArray.to_dataset
    • xarray.DataArray.to_netcdf
    • xarray.DataArray.to_pandas
    • xarray.DataArray.to_series
    • xarray.DataArray.to_dataframe
    • xarray.DataArray.to_index
    • xarray.DataArray.to_masked_array
    • xarray.DataArray.to_cdms2
    • xarray.DataArray.to_iris
    • xarray.DataArray.from_iris
    • xarray.DataArray.to_dict
    • xarray.DataArray.from_series
    • xarray.DataArray.from_cdms2
    • xarray.DataArray.from_dict
    • xarray.DataArray.close
    • xarray.DataArray.compute
    • xarray.DataArray.persist
    • xarray.DataArray.load
    • xarray.DataArray.chunk
    • xarray.DataArray.unify_chunks
    • xarray.core.coordinates.DataArrayCoordinates
    • xarray.core.coordinates.DatasetCoordinates
    • xarray.core.groupby.DataArrayGroupBy
    • xarray.core.groupby.DataArrayGroupBy.map
    • xarray.core.groupby.DataArrayGroupBy.reduce
    • xarray.core.groupby.DatasetGroupBy
    • xarray.core.groupby.DatasetGroupBy.map
    • xarray.core.groupby.DatasetGroupBy.reduce
    • xarray.core.rolling.DataArrayRolling
    • xarray.core.rolling.DataArrayRolling.construct
    • xarray.core.rolling.DataArrayRolling.reduce
    • xarray.core.rolling.DatasetRolling
    • xarray.core.rolling.DatasetRolling.construct
    • xarray.core.rolling.DatasetRolling.reduce
    • xarray.core.rolling_exp.RollingExp
    • xarray.core.weighted.DataArrayWeighted
    • xarray.core.weighted.DataArrayWeighted.mean
    • xarray.core.weighted.DataArrayWeighted.sum
    • xarray.core.weighted.DataArrayWeighted.sum_of_weights
    • xarray.core.weighted.DatasetWeighted
    • xarray.core.weighted.DatasetWeighted.mean
    • xarray.core.weighted.DatasetWeighted.sum
    • xarray.core.weighted.DatasetWeighted.sum_of_weights
    • xarray.core.rolling.DataArrayCoarsen
    • xarray.core.rolling.DatasetCoarsen
    • xarray.core.resample.DataArrayResample
    • xarray.core.resample.DataArrayResample.asfreq
    • xarray.core.resample.DataArrayResample.backfill
    • xarray.core.resample.DataArrayResample.interpolate
    • xarray.core.resample.DataArrayResample.nearest
    • xarray.core.resample.DataArrayResample.pad
    • xarray.core.resample.DatasetResample
    • xarray.core.resample.DatasetResample.asfreq
    • xarray.core.resample.DatasetResample.backfill
    • xarray.core.resample.DatasetResample.interpolate
    • xarray.core.resample.DatasetResample.nearest
    • xarray.core.resample.DatasetResample.pad
    • xarray.core.accessor_dt.DatetimeAccessor
    • xarray.core.accessor_dt.TimedeltaAccessor
    • xarray.core.accessor_str.StringAccessor
    • xarray.CFTimeIndex
    • xarray.cftime_range
    • xarray.plot.FacetGrid
    • xarray.plot.FacetGrid.add_colorbar
    • xarray.plot.FacetGrid.add_legend
    • xarray.plot.FacetGrid.add_quiverkey
    • xarray.plot.FacetGrid.map
    • xarray.plot.FacetGrid.map_dataarray
    • xarray.plot.FacetGrid.map_dataarray_line
    • xarray.plot.FacetGrid.map_dataset
    • xarray.plot.FacetGrid.set_axis_labels
    • xarray.plot.FacetGrid.set_ticks
    • xarray.plot.FacetGrid.set_titles
    • xarray.plot.FacetGrid.set_xlabels
    • xarray.plot.FacetGrid.set_ylabels
    • xarray.tutorial.open_dataset
    • xarray.tutorial.open_rasterio
    • xarray.tutorial.load_dataset
    • xarray.testing.assert_equal
    • xarray.testing.assert_identical
    • xarray.testing.assert_allclose
    • xarray.testing.assert_chunks_equal
    • xarray.MergeError
    • xarray.SerializationWarning
    • xarray.Dataset.variables
    • xarray.DataArray.variable
    • xarray.Variable
    • xarray.IndexVariable
    • xarray.as_variable
    • xarray.register_dataset_accessor
    • xarray.register_dataarray_accessor
    • xarray.Dataset.set_close
    • xarray.backends.BackendArray
    • xarray.backends.BackendEntrypoint
    • xarray.backends.NetCDF4DataStore
    • xarray.backends.H5NetCDFStore
    • xarray.backends.PydapDataStore
    • xarray.backends.ScipyDataStore
    • xarray.backends.FileManager
    • xarray.backends.CachingFileManager
    • xarray.backends.DummyFileManager
    • xarray.Dataset.drop
    • xarray.DataArray.drop
    • xarray.Dataset.apply
    • xarray.core.groupby.DataArrayGroupBy.apply
    • xarray.core.groupby.DatasetGroupBy.apply
    • xarray.DataArray.dt.weekofyear
    • xarray.DataArray.dt.week
  • How do I ...
  • Ecosystem

For developers/contributors

  • Contributing Guide
  • Xarray Internals
    • Variable objects
    • Integrating with duck arrays
    • Extending xarray
    • Zarr Encoding Specification
    • How to add a new backend
  • Development Roadmap
  • Team
  • What’s New
  • GitHub repository

Community

  • GitHub discussions
  • StackOverflow
Contents
  • Notebook Examples
  • External Examples

Gallery¶

Here’s a list of examples on how to use xarray. We will be adding more examples soon. Contributions are highly welcomed and appreciated. So, if you are interested in contributing, please consult the Contributing to xarray guide.

Notebook Examples¶

img-top

Toy weather data

img-top

Calculating Seasonal Averages from Timeseries of Monthly Means

img-top

Compare weighted and unweighted mean temperature

img-top

Working with Multidimensional Coordinates

img-top

Visualization Gallery

img-top

ROMS Ocean Model Example

img-top

GRIB Data Example

img-top

Applying unvectorized functions with apply_ufunc

External Examples¶

img-top

Managing raster data with rioxarray

img-top

Xarray and dask on the cloud with Pangeo

img-top

Xarray with Dask Arrays

Working with numpy-like arrays Toy weather data

© Copyright 2014-2021, xarray Developers.
Last updated on 2021-05-19.

Xarray is a fiscally sponsored project of NumFOCUS, a nonprofit dedicated to supporting the open-source scientific computing community.
Theme by the Executable Book Project