VICC normalization routines for diseases
Project description
Disease Normalizer
The Disease Normalizer resolves ambiguous references and descriptions of human diseases to consistently-structured, normalized terms. For concepts extracted from NCIt, Mondo Disease Ontology, The Human Disease Ontology, OMIM, and OncoTree, it designates a CURIE, and provides additional metadata like aliases and cross-references.
Documentation · Installation · API reference
Installation
The Disease Normalizer is available via PyPI:
python3 -m pip install disease-normalizer
See installation instructions in the documentation for a description of installation options and data setup requirements.
Examples
Use the live service to programmatically normalize disease terms, as in the following truncated example:
$ curl -s 'https://normalize.cancervariants.org/disease/normalize?q=liver%20cancer' | python -m json.tool
{
"query": "liver cancer",
"warnings": null,
"match_type": 80,
"normalized_id": "ncit:C34803",
"disease": {
"type": "Disease",
"id": "normalize.disease:liver%20cancer",
"label": "Primary Malignant Liver Neoplasm",
# ...
}
}
Or utilize the Python API for fast local access:
>>> from disease.query import QueryHandler
>>> from disease.database import create_db
>>> q = QueryHandler(create_db())
>>> result = q.normalize("NSCLC")
>>> result.normalized_id
'ncit:C2926'
Feedback and contributing
We welcome bug reports, feature requests, and code contributions from users and interested collaborators. The documentation contains guidance for submitting feedback and contributing new code.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file disease_normalizer-0.5.0.tar.gz.
File metadata
- Download URL: disease_normalizer-0.5.0.tar.gz
- Upload date:
- Size: 288.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d87a941e6466d153bd876036ffb14fa7d91aa708fad76677f8d60b47a4f69b99 |
|
| MD5 | bf1c7bbc13f04175e30272776ba7d927 |
|
| BLAKE2b-256 | 7aabd64ad8f462c6eedb965ece5278bee9f6a147bb86579c7e5bcecf09a37986 |
File details
Details for the file disease_normalizer-0.5.0-py3-none-any.whl.
File metadata
- Download URL: disease_normalizer-0.5.0-py3-none-any.whl
- Upload date:
- Size: 50.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.12.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 8fe427d711c882b00dafd39e0d417759baa4e8b5280860d6a6acb2959855f902 |
|
| MD5 | 907e05dc0f006074510d7568813aeafb |
|
| BLAKE2b-256 | e85b4d990dc490e8f75fa4f173fd0023c7250490a79abebf7a5db0ddb178b67e |
