Blosc/python-blosc2

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

Open

#649 建立於 2026年6月2日

在 GitHub 查看
 (0 留言) (0 反應) (0 負責人)Python (47 fork)auto 404
documentationgood first issue

倉庫指標

Star
 (207 star)
PR 合併指標
 (PR 指標待抓取)

描述

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

貢獻者指南