issues: 1585231355

This data as json

id node_id number title user state locked assignee milestone comments created_at updated_at closed_at author_association active_lock_reason draft pull_request body reactions performed_via_github_app state_reason repo type
1585231355 I_kwDOAMm_X85efLX7 7533 Numpy to xarray docs 35968931 open 0     0 2023-02-15T05:13:50Z 2023-02-15T06:28:05Z   MEMBER      

We should make a docs page specifically to ease the transition from pure-numpy to xarray.

A lot of new xarray users come from already using numpy as their primary data structure. We relatively often get questions about "what's the xarray equivalent of X numpy function" but we don't have a dedicated place to collect those answers, or explain key conceptual differences.

I think this deserves its own dedicated docs page, with: - [ ] High-level conceptual differences (e.g. transpose invariance) - [ ] Arguments for the benefits of using xarray over pure numpy - [ ] Table of numpy <-> xarray function equivalents (similar to the existing "How do I..." page) - [ ] Other common recommendations for numpy users (e.g. use netCDF / Zarr instead of .npz or pickle to store data on disk)

For the table I thought of a few already, but I know there will be a lot more:

  • np.concatenate/np.vstack/np.hstack/np.stack → xr.concat
  • np.block → xr.combine_nested
  • np.apply_along_axis → xr.apply_ufunc
  • np.polynomial → xr.polyfit
  • np.reshape -> xr.coarsen().construct()
 
{
    "url": "https://api.github.com/repos/pydata/xarray/issues/7533/reactions",
    "total_count": 2,
    "+1": 2,
    "-1": 0,
    "laugh": 0,
    "hooray": 0,
    "confused": 0,
    "heart": 0,
    "rocket": 0,
    "eyes": 0
}
     13221727 issue

Links from other tables