Why an index#366
Conversation
Initial draft of intermediate/indexing/why-an-index.ipynb: an intuition-first tutorial on why xarray needs indexes and when to build a custom one.
|
Check out this pull request on See visual diffs & provide feedback on Jupyter Notebooks. Powered by ReviewNB |
for more information, see https://pre-commit.ci
♻️ Preview destroyed
🤖 Powered by surge-preview |
|||||||||
The handoff/session notes under notes/ are local working docs and should not be tracked (they were appearing in the draft PR diff). Untrack the handoff note and gitignore notes/ so working notes stay out of git.
for more information, see https://pre-commit.ci
|
View / edit / reply to this conversation on ReviewNB keewis commented on 2026-07-14T11:08:07Z I think you can use a direct reference here: https://mystmd.org/guide/cross-references#link-references |
|
This is really nice, Ian. One thing I would change, though, is to point out that the table only is valid at the time of writing, since it is possible that some third-party libraries will provide these indexes in the future. I'd probably also go through and replace the LLM dashes with other punctuation to make it feel a bit less artificial (but that's a minor concern). |
- Collapse the merge-duplicated notebook down to a single copy - Simplify PeriodicIndex to a scalar-query exercise with an explicit input/return contract; blank the body to hints + a runnable stub and add an attach-and-call demo that prints what sel receives - Rename SliceRuler to DIYRangeIndex and give it the same exercise scaffolding (contract comment, print of received dict, stub, demo) - Generalize the CoordinateTransform forward/reverse description - Remove the 2-D affine grid section; renumber the fisheye section to step 2 of 2 and trim the outline accordingly
for more information, see https://pre-commit.ci
|
Thank you justus!
this was a side effect of some LLM coding alogn the way. I've now re-written the whole prose myself |
for more information, see https://pre-commit.ci
2 participants
rough rough rough draft