Blosc / Blosc/python-blosc2

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

オープン
#649 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
documentation good first issue
主要言語
Python
スター
211
フォーク
58
平均マージ
1日 17時間
マージ済み PR(30日)
6

説明

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

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

12.batcharray.ipynb から始め、拡張するか 12b.listarray.ipynb を追加するかを決める前に、既存の BatchArray チュートリアルの構成を確認してください。列挙された ListArray 操作、dataclass スキーマでの CTable の使用、Arrow とのラウンドトリップ、ListArray と BatchArray の使い分けに関するガイダンスを扱ってください。完了とは、要求された各ワークフローに実行可能な実例があることを意味します。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
jupyter-notebook, python
領域
data, documentation
issue の種類
ドキュメント
難易度
3/5
見積もり時間
1〜2日
活発さ
静か
明瞭さ
おおむね明確
初心者へのやさしさ
68/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。