[DOC] Tutorial: variable-length columns (ListArray and BatchArray)
- Langage dominant
- Python
- Étoiles
- 211
- Forks
- 58
- Merge moyen
- 1 j 17 h
- PR mergées (30 j)
- 6
Description
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
Guide de contribution
Ouvrir le guide de contribution
Piste de recherche
Commencez par 12.batcharray.ipynb et examinez la structure existante du tutoriel BatchArray avant de choisir entre l’étendre ou ajouter 12b.listarray.ipynb. Couvrez les opérations ListArray répertoriées, l’utilisation de CTable avec un schéma dataclass, les allers-retours avec Arrow et les indications comparant ListArray à BatchArray ; le travail est considéré comme terminé lorsque chaque workflow demandé dispose d’un exemple pratique exécutable.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- jupyter-notebook, python
- Domaine
- data, documentation
- Type d'issue
- Documentation
- Difficulté
- 3/5
- Temps estimé
- 1-2 jours
- Activité
- Calme
- Clarté
- Plutôt claire
- Accessibilité débutants
- 68/100