Blosc / Blosc/python-blosc2

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

Abierto
#649 0 comentarios 0 reacciones 0 asignados Ver en GitHub
documentation good first issue
Lenguaje dominante
Python
Estrellas
211
Forks
58
Merge medio
1 d 17 h
PR fusionados (30 d)
6

Descripción

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

Guía de contribución

Abrir la guía de contribución

Línea de trabajo

Empieza por 12.batcharray.ipynb e inspecciona la estructura existente del tutorial de BatchArray antes de decidir si ampliarlo o añadir 12b.listarray.ipynb. Cubre las operaciones de ListArray enumeradas, el uso de CTable con un esquema de dataclass, el round-tripping con Arrow y las indicaciones sobre ListArray frente a BatchArray; se considera terminado cuando cada flujo de trabajo solicitado tiene un ejemplo práctico ejecutable.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
jupyter-notebook, python
Área
data, documentation
Tipo de issue
Documentación
Dificultad
3/5
Tiempo estimado
1-2 días
Estado de actividad
Tranquilo
Claridad
Bastante claro
Aptitud para principiantes
68/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.