[DOC] Tutorial: variable-length columns (ListArray and BatchArray)
- 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
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