Common names tracking issue
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 45/100
调研方向
Review the history in the issue body and linked PRs #6, #14, #26, #36, #37. Understand the current common-names handling in the codebase, likely in a module like common_names.py. Examine the GBIF Backbone and Catalogue of Life data sources. The work involves fixing homonym lookups, cache handling, and deciding on rerun behavior. A newcomer must first understand the project's taxonomic resolution flow and the existing Polars-based data processing.
由索引模型根据 Issue 内容生成。
描述
Issue text drafted with the help of Opus 5.5.
Common-name handling has gone through several iterations across releases, PRs, and branches. This issue collects that history in one place and gathers the open work that should inform the next iteration.
History
| Stage | Where | Released? | Behavior |
|---|---|---|---|
| Original retrieval | #6 (merged 2025-05-01) | v0.1.0 | Merges GBIF Backbone vernacular names into resolved output. Input common names could pass through. |
| Deterministic rewrite | #14 (open, branch feat/deterministic-common-names) |
never merged | Backbone-only names, Polars rewrite, higher-rank coverage, tests. The review discussion there (usefulness of higher-rank names such as "Orchid" for many species; recording the source rank) directly shaped later work. |
| Hierarchical fallback | #26 | v0.2.0 | Always climbs species → kingdom. Prefers the first English name, then any language. Input common names always replaced. |
| Optional fallback + rank column | #36 → #37 | unreleased (on main only) |
--no-higher-rank-fallback disables climbing. New common_name_rank column records the rank the name came from. Default output matches v0.2.0 plus the new column. |
Note: #37's behavior has not shipped in any tagged release. If the next iteration lands before the next tag, release notes should describe the net change from v0.2.0.
Open items
- #10: input common names must not pass through. The literal request is addressed since v0.2.0 (the input
common_namecolumn is always dropped before lookup). Its broader goal, a uniform one-to-one mapping between taxonomy and vernacular, is affected by the homonym item below. - Homonym-blind taxon lookup (new). Each rank's name is mapped to a backbone
taxonIDbycanonicalNamealone, ignoring kingdom andtaxonomicStatus. Duplicates are dropped with Polarsunique(subset=[rank]), which keeps an arbitrary row (stable in practice, not guaranteed). In the GBIF Backbone: 44,403 duplicated genus names (11,520 spanning more than one kingdom), 248,587 duplicated species names, 194 duplicated family names. Example: genus Laelia maps to taxonID 7562880 (Plantae, doubtful) for every row, so animal Laelia can receive a plant's common name. - #35: dead
cache_dirhandling in the standalone common-names parser. - #34 (last bullet):
--full-rerundoes not apply tocommon-names, although the command writes its own manifest. Decide whether it should, or document that it isresolve-only.
Related branches (kept for reference)
feat/deterministic-common-names: #14's branch.
Next iteration
Should include fixes required by the above notes.
Before common names updates are added to a tagged release, the strategy should shift to use Catalogue of Life vernacular data retrieved from here.
Furthermore, a vernacular assignment strategy for TaxonoPy-resolved entries should be agreed upon. Default behavior can be unfiltered retrieval of all vernacular data, enabling a user to apply custom strategy of their design. Additionally, we can provide reasonable prioritization/filtering strategies that serve our own use-cases.
- 主要语言
- Python
- 星标
- 19
- 派生
- 0
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
我们还没有检查这个项目的环境配置文件。先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
Imageomics/TaxonoPy 的其他 Issue
-
难度 1/5 1 小时以内 新手友好度 78/100
Imageomics/TaxonoPy#35 ·
-
documentation
难度 3/5 1-2 天 新手友好度 55/100
Imageomics/TaxonoPy#34 ·
-
Trace command package version silent cache misses可能重新可做 @thompsonmj 于 220 天前认领，目前没有进行中的 PR。 未关闭enhancement
Imageomics/TaxonoPy#29 · 已指派 1 人 ·
-
edge case
难度 5/5 一周以上 新手友好度 35/100
Imageomics/TaxonoPy#25 ·
-
Discuss complementary and similar approaches可能重新可做 @thompsonmj 于 232 天前认领，目前没有进行中的 PR。 未关闭documentation
Imageomics/TaxonoPy#24 · 1 条评论 · 已指派 1 人 ·
查看 Imageomics/TaxonoPy 的全部 Issue
相似的 Issue
-
bug status/needs-triage
难度 2/5 1-3 小时 新手友好度 86/100
prowler-cloud/prowler#12887 · 1 条评论 ·
维护者通常 1 天内回复
-
area: desktop platform: macos priority: p3 status: ready type: enhancement
难度 1/5 1 小时以内 新手友好度 92/100
use-agent-os/agent-os#3484 ·
维护者通常 2 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 86/100
open-telemetry/opentelemetry-python-contrib#5113 · 2 条评论 · 2 个 reaction ·
维护者通常 1 天内回复
-
external
难度 2/5 1-3 小时 新手友好度 68/100
langchain-ai/docs#6255 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复