Blosc / Blosc/python-blosc2

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

Aperta
#649 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub
documentation good first issue
Lingua principale
Python
Stelle
211
Fork
58
Merge medio
1g 17h
PR unite (30g)
6

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 per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia da 12.batcharray.ipynb e analizza la struttura esistente del tutorial BatchArray prima di decidere se estenderla o aggiungere 12b.listarray.ipynb. Copri le operazioni ListArray elencate, l’utilizzo di CTable con uno schema dataclass, il round-tripping con Arrow e le indicazioni su ListArray rispetto a BatchArray; il lavoro è completato quando ogni workflow richiesto dispone di un esempio pratico eseguibile.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
jupyter-notebook, python
Ambito
data, documentation
Tipo di issue
Documentazione
Difficoltà
3/5
Tempo stimato
1-2 giorni
Stato di attività
Tranquilla
Chiarezza
Abbastanza chiara
Idoneità per principianti
68/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.