Blosc/python-blosc2

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

Open

#649 ouverte le 2 juin 2026

Voir sur GitHub
 (0 commentaires) (0 réactions) (0 assignés)Python (47 forks)auto 404
documentationgood first issue

Métriques du dépôt

Stars
 (207 stars)
Métriques de merge PR
 (Métriques PR en attente)

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 contributeur

Direction de recherche
Étendez le notebook existant 12.batcharray.ipynb en ajoutant une nouvelle section ou en créant un notebook séparé pour ListArray, couvrant la création avec item spec, l'ajout, l'indexation, l'incorporation dans CTable et le round trip Arrow. Incluez des exemples de code et des explications pour chaque étape.
Stack technique
python
Domaine
backend
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Récente
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
Pythonblosc2Jupyter Notebooks
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
70