Blosc / Blosc/python-blosc2

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

Đang mở
#649 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
documentation good first issue
Ngôn ngữ chính
Python
Star
211
Fork
58
Merge trung bình
1 ngày 17 giờ
Pull request đã merge (30 ngày)
6

Mô tả

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

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Hướng nghiên cứu

Bắt đầu với 12.batcharray.ipynb và kiểm tra cấu trúc tutorial BatchArray hiện có trước khi quyết định mở rộng nó hay thêm 12b.listarray.ipynb. Bao quát các thao tác ListArray được liệt kê, cách sử dụng CTable với schema dataclass, việc round-tripping với Arrow và hướng dẫn về ListArray so với BatchArray; được xem là hoàn tất khi mỗi workflow được yêu cầu đều có một ví dụ thực hành có thể chạy được.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
jupyter-notebook, python
Lĩnh vực
data, documentation
Loại issue
Tài liệu
Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức độ hoạt động
Ít trao đổi
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
68/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.