Ndfrt

---
name: 52_NDF_RT
description: >
  Query NDF-RT (National Drug File Reference Terminology) via the NCI EVS REST
  API. Use when looking up drug mechanisms of action, physiological effects,
  pharmacologic classes, chemical structures, or drug–disease relationships
  (may_treat / may_prevent) in NDF-RT. Accepts drug names or NDF-RT codes.
---

# NDF-RT Query Skill

Search NDF-RT concepts by drug name or NDF-RT code via the NCI EVS REST API.
Auto-detects entity type by pattern:

| Input Pattern | Detected As | Lookup Logic |
|---|---|---|
| `N0000145918` | NDF-RT code (`N` + 10 digits) | direct concept GET |
| anything else | free text | full-text search endpoint |

## API

| Function | Input | Returns |
|---|---|---|
| `search(entity, limit)` | single entity string | `dict` with `entity`, `type`, `results` |
| `search_batch(entities, limit)` | list of entity strings | `dict[str, dict]` |
| `summarize(result, entity)` | search result dict + label | compact multi-line text |
| `to_json(result)` | search result dict | `list[dict]` |

### Result dict structure

Each item in `results` contains:

| Key | Description |
|---|---|
| `code` | NDF-RT concept code |
| `name` | Preferred concept name |
| `kind` | Concept kind (e.g. `DRUG_KIND`, `DISEASE_KIND`) |
| `properties` | flat `{type: value}` property dict |
| `roles` | list of `{type, relatedCode, relatedName}` role relationships |
| `parents` | list of `{code, name}` ISA parent concepts |
| `synonyms` | deduplicated list of synonym strings |

### Key NDF-RT relationship types (roles)

| Role | Meaning |
|---|---|
| `has_MoA` | mechanism of action |
| `has_PE` | physiological effect |
| `has_EPC` | established pharmacologic class |
| `may_treat` | indicated disease/condition |
| `may_prevent` | preventable disease/condition |
| `CI_with` | contraindicated with |
| `has_Chemical_Structure` | chemical structure classification |

## Usage

See `if __name__ == "__main__"` block in `52_NDF_RT.py` for runnable examples
covering: drug name search, code lookup, batch search, JSON output, and root
concept listing.

## Data

- **Source**: NCI EVS REST API (`https://api-evsrest.nci.nih.gov/api/v1`)
- **Terminology**: `ndfrt`
- **Auth**: none required
- **Rate limits**: not documented; use reasonable request spacing
- **Maintainer**: U.S. Department of Veterans Affairs / NCI Enterprise Vocabulary Services