OrthoDB: Orthologs
orthodb_orthologsResolve a plant gene locus to its OrthoDB ortholog group and retrieve cross-species member genes with group metadata.
Instructions
Resolve a locus to its OrthoDB ortholog group and cross-species member genes (data.orthodb.org; free, no key). Searches at the Viridiplantae level, then returns the group metadata (name, evolutionary rate) and member genes grouped by organism (organism, gene id, description). organism_count is the true cluster total; the member list is capped with truncated flagged. found=false when the locus maps to no ortholog group. Works for all 12 organisms. NOTE: unlike the other locus tools, organism= does NOT scope the search — the group is resolved from the locus id alone at the Viridiplantae level, and organism is only validated and echoed back. Passing a mismatched organism therefore still returns the locus's real group.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max ortholog member rows to return. 'member_count' always reports the true pre-cap total and 'truncated' says whether the cap bit. | |
| locus | Yes | e.g. AT1G01060 (Arabidopsis), Os01g0100100 (rice RAP-DB) | |
| organism | No | Plant organism — accepts canonical slug (arabidopsis_thaliana), scientific or common name, or NCBI taxid. Validated and echoed only: it does NOT scope the OrthoDB search, which keys on the locus id at the Viridiplantae level | arabidopsis_thaliana |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| found | Yes | True if the locus maps to an ortholog group | |
| group | No | Group metadata {id, name, evolutionary_rate, level_name, …} | |
| locus | Yes | ||
| members | No | Per-gene {organism, gene_id, xref, description} | |
| organism | Yes | Canonical organism as requested — echoed, not inferred from the hit. Does not scope the search (see class docstring) | |
| truncated | Yes | True if the member list was capped | |
| member_count | Yes | Member genes returned (post-cap) | |
| organism_count | Yes | Number of member organisms in the whole ortholog group (pre-cap) — the true cluster total, unaffected by the member cap below |