Blosc/python-blosc2

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

Open

#649 aperta il 2 giu 2026

Vedi su GitHub
 (0 commenti) (0 reazioni) (0 assegnatari)Python (47 fork)auto 404
documentationgood first issue

Metriche repository

Star
 (207 star)
Metriche merge PR
 (Metriche PR in attesa)

Descrizione

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

Guida contributor

Direzione di ricerca
Estendi il notebook esistente 12.batcharray.ipynb aggiungendo una nuova sezione o creando un notebook separato per ListArray, coprendo la creazione con item spec, append, indicizzazione, embedding in CTable e round trip Arrow. Includi esempi di codice e spiegazioni per ogni passaggio.
Tech stack
python
Dominio
backend
Tipo issue
Documentazione
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-3 ore
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Nuova
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
Pythonblosc2Jupyter Notebooks
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
70