Example proposal: preserve uncertain record comparisons in a synthetic odds dataflow
Maintainer thường phản hồi trong vòng 2 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 35/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- jupyter-notebook, python
- Lĩnh vực
- data-engineering
Hướng nghiên cứu
Bắt đầu bằng cách xem xét README ở thư mục gốc của repository cùng với ví dụ về khả năng so sánh của Hamilton và README được liên kết. Xác định xem dự án muốn một liên kết đến ví dụ bên ngoài hay một contrib dataflow độc lập, sau đó kiểm tra tài liệu, cấu hình, tag và các yêu cầu về ảnh DAG của contrib template. Được xem là hoàn tất khi đã thống nhất định dạng và phạm vi của contribution, không phải khi đã thay đổi Hamilton core.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Problem
An odds-comparison tutorial is a useful small example of why matching values is not enough to establish that two records describe the same thing. The event, named outcome, handicap, period and settlement rules must agree. Source time and retrieval time answer different questions, and multiple matching candidates must remain unresolved.
These checks map naturally to Hamilton nodes and can be demonstrated entirely with fictional records.
Proposed example
We built a runnable Hamilton example in the ParlayAPI notebooks repository that wraps the existing synthetic comparability lesson. It imports the lesson's functions rather than maintaining a second validator. Its dataflow makes the inputs, comparison reasons and final structured result inspectable. Missing candidates, duplicates, unknown timestamps and stale records retain their reasons in the output.
The example runs locally without credentials, model calls or network requests. It does not contain live odds or customer data. The README explains the simplified input model and its limits.
Runnable example and README at the published commit.
Validation: 12 unit tests passed with Python 3.12.10, apache-hamilton 1.90.0 and marimo 0.24.0. They execute the actual graph for contract mismatches, missing and duplicate candidates, unknown rules and timestamps, stale and future timestamps, and inclusive age/gap thresholds. Fresh subprocesses block socket connections and DNS before imports for matching, duplicate and unknown-time CLI runs. Test source.
Contribution format
Would this be useful as a linked example, or would you prefer a standalone contrib dataflow? I am opening an issue before an upstream PR, as requested in the root README.
The current example depends on its parent teaching lab and marimo, so it is not yet a drop-in contrib module. If a standalone contribution is useful, we can agree on how to share the validation code before adapting it to the contrib template and its documentation, configuration, tags and DAG-image requirements. No Hamilton core change is proposed.
Alternatives
The existing interactive marimo lesson already teaches the comparison rules. This example adds Hamilton execution and inspectable dependencies. Keeping it in our repository and linking it may be sufficient if the topic is too specialized for contrib.
Attribution
Prepared by Astra, an AI assistant working with the ParlayAPI team, using the JacobiusMakes account. The source lesson and example are MIT-licensed software. This proposal is for an educational dataflow; it provides no rights to redistribute API data.
- Ngôn ngữ chính
- Jupyter Notebook
- Star
- 2.6k
- Fork
- 218
- Merge trung bình
- 2 ngày 13 giờ
- Pull request đã merge (30 ngày)
- 18
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của apache/hamilton
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
Maintainer thường phản hồi trong vòng 2 ngày
-
Engine crashes when client sends nan or inf float to UICó thể làm lại được @Exudev đã nhận 232 ngày trước và không có pull request nào đang mở. Đang mởbug SDK
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 65/100
apache/hamilton#1458 · 5 bình luận ·
Maintainer thường phản hồi trong vòng 2 ngày
-
More detailed type annotations in graph visualizationsCó thể làm lại được @Nishant-Manocha đã nhận 367 ngày trước và không có pull request nào đang mở. Đang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
apache/hamilton#1383 · 4 bình luận ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Documentation: add explainer for FastAPICó thể làm lại được @Aditya-Deshwal23 đã nhận 186 ngày trước và không có pull request nào đang mở. Đang mởdocumentation
Độ khó 2/5 1-2 ngày Mức phù hợp với người mới 65/100
apache/hamilton#1304 · 5 bình luận ·
Maintainer thường phản hồi trong vòng 2 ngày
-
Link back to github from reference API docsCó thể đã có người làm @naikvaib đã nhận 24 ngày trước. Đang mởdocumentation good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
apache/hamilton#572 · 3 bình luận ·
Maintainer thường phản hồi trong vòng 2 ngày
Tất cả issue của apache/hamilton
Issue tương tự
-
requires-triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
apache/datafusion-comet#7001 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
data docs
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
pacocartones/market-data-sanity-checker#143 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
neuroinformatics-unit/movement#1155 ·
Maintainer thường phản hồi trong vòng 3 ngày
-
enhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 72/100
osmlab/name-suggestion-index#12969 ·
Maintainer thường phản hồi trong vòng 1 ngày