Blosc / Blosc/python-blosc2

[DOC] Tutorial: variable-length columns (ListArray and BatchArray)

Ouverte
#649 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
documentation good first issue
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

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.