Summarize Intolerant Regions
summarize_intolerant_regionsRead-onlyIdempotent
Identify the most constrained protein regions from MetaDome tolerance landscapes. Returns stretches of residues with low tolerance scores, annotated with Pfam domains and variant counts.
Instructions
Return the top ranked contiguous intolerant regions of a MetaDome tolerance landscape, each annotated with overlapping Pfam domain ids and aggregate gnomAD/ClinVar variant counts. Regions are stretches of consecutive residues with sw_dn_ds below threshold (length >= min_run), ranked by mean sw_dn_ds ascending (most constrained first). Signature: summarize_intolerant_regions(transcript_id, threshold=0.5, min_run=3, top_n=15, response_mode='compact').
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top_n | No | Maximum number of regions to return, ranked by mean_sw_dn_ds ascending (default 15). | |
| min_run | No | Minimum number of consecutive residues to form a region (default 3). Shorter stretches are discarded. | |
| threshold | No | sw_dn_ds threshold (exclusive upper bound) for intolerant residues (default 0.5). Lower values identify only the most constrained positions. | |
| response_mode | No | Verbosity: minimal|compact|standard|full (default compact). | compact |
| transcript_id | Yes | A versioned Ensembl transcript id (the .N version suffix is required), e.g. ENST00000269305.4. Resolve a gene symbol with resolve_transcript first. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | ||
| _meta | No | ||
| field | No | ||
| top_n | No | ||
| message | No | ||
| min_run | No | ||
| regions | No | ||
| success | Yes | ||
| gene_name | No | ||
| retryable | No | ||
| threshold | No | ||
| candidates | No | ||
| error_code | No | ||
| region_count | No | ||
| data_versions | No | ||
| transcript_id | No | ||
| recovery_action | No | ||
| recommended_citation | No |