[DOC] Tutorial: variable-length columns (ListArray and BatchArray)
- Vorherrschende Sprache
- Python
- Sterne
- 211
- Forks
- 58
- Ø Merge
- 1 T. 17 Std.
- Gemergte PRs (30 T.)
- 6
Beschreibung
12.batcharray.ipynb covers BatchArray basics but there is no tutorial for ListArray — the newer, more flexible varlen column type. Users working with nested or ragged data (e.g. GPS waypoints, tags, embeddings of varying length) have no worked example to follow.
Suggested work: Extend 12.batcharray.ipynb or add 12b.listarray.ipynb covering:
- Creating a ListArray with item_spec
- Appending, extending, and fancy-indexing
- Embedding a ListArray as a column inside a CTable (using the dataclass schema API)
- Arrow round-trip (from_arrow / to_arrow)
- When to prefer ListArray over BatchArray
Beitragsleitfaden
Rechercherichtung
Start with 12.batcharray.ipynb and inspect the existing BatchArray tutorial structure before choosing whether to extend it or add 12b.listarray.ipynb. Cover the listed ListArray operations, dataclass-schema CTable usage, Arrow round-tripping, and the ListArray-versus-BatchArray guidance; done means each requested workflow has a runnable worked example.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- jupyter-notebook, python
- Bereich
- data, documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 3/5
- Geschätzter Aufwand
- 1-2 Tage
- Aktivitätsstatus
- Ruhig
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 68/100