| name | cadec-query |
| description | Query the CADEC (CSIRO Adverse Drug Event Corpus). Use whenever the user asks about adverse drug event mentions in consumer health text, entity annotations from patient forum posts, MedDRA/SNOMED-CT normalised ADR spans, or wants to look up drugs, symptoms, or coded entities in the CADEC corpus.
|
CADEC Query Skill
Search CADEC annotated patient forum posts by any entity. Auto-detects type:
| Input Pattern | Detected As | Match Logic |
|---|
10019211 (8 digits) | MedDRA code | exact on normalizations.code |
22253000 (6-18 digits) | SNOMED CT code | exact on normalizations.code |
| anything else | free text | substring on entity text, type, or doc_id |
API
| Function | Input | Returns |
|---|
load_cadec(path) | JSON path | list[dict] (cached) |
search(entity) | single entity string | list[dict] |
search_batch(entities) | list of entity strings | dict[str, list[dict]] |
summarize(hits, entity) | hits + label | compact text |
to_json(hits) | list[dict] | same list (JSON-ready) |
Entity Types in Corpus
| Type | Description |
|---|
| ADR | Adverse Drug Reaction |
| Drug | Medication mention |
| Disease | Pre-existing condition |
| Symptom | Patient-reported symptom |
| Finding | Clinical finding |
Usage
See if __name__ == "__main__" block in 34_CADEC.py for runnable examples:
drug name search, ADR text search, MedDRA code lookup, batch search, JSON output.
Data
- Source: CADEC v2, CSIRO (AskaPatient.com forum posts)
- Local file:
cadec_combined.json built from BRAT .txt + .ann files
- Annotations: Original spans + MedDRA + SNOMED CT normalisations
- Stats: ~1,250 documents, ~7,600 entity annotations
- Path:
DATA_PATH variable in 34_CADEC.py
- Citation: Karimi et al., 2015. J Biomed Inform 55:73–81
