Blosc/python-blosc2

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

Open

#649 aberto em 2 de jun. de 2026

Ver no GitHub
 (0 comments) (0 reactions) (0 assignees)Python (47 forks)auto 404
documentationgood first issue

Métricas do repositório

Stars
 (207 stars)
Métricas de merge de PR
 (Métricas PR pendentes)

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

Guia do colaborador

Direção de pesquisa
Estenda o notebook existente 12.batcharray.ipynb adicionando uma nova seção ou criando um notebook separado para ListArray, cobrindo criação com item spec, anexação, indexação, incorporação em CTable e round trip Arrow. Inclua exemplos de código e explicações para cada etapa.
Pilha de tecnologia
python
Domain
backend
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Recente
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Pythonblosc2Jupyter Notebooks
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
70