Open TomNicholas opened 4 days ago
Yeah its not great. I wrote some tutorial material here: https://tutorial.xarray.dev/fundamentals/02.3_aligning_data_objects.html
I wrote some tutorial material here:
I was looking for that one! The content on that really fills a much-needed gap (and is really good). I think a dedicated page that explains what Broadcasting and Alignment are is what we are missing from the main docs.
What is your issue?
I'm writing more documentation for DataTree, and was looking for an in-depth explanation of what Alignment actually is so I can refer to it, but I can't really find one?
The concept of alignment is referred to in multiple places, e.g.
.reindex()
,xr.merge
on the Combining pageDataset.update()
on the data structures page.xr.align()
has examples, but no narrative explanation.But there doesn't appear to be a dedicated section on Alignment anywhere in the narrative docs (or even on the xarray tutorial site). I can't find any explanation of what it means for two
Datasets
not to align, for example.This seems like a very fundamental concept to not have dedicated documentation with examples. Maybe I've just missed it?
cc @max-sixty @dcherian @shoyer @flamingbear