Skip to main content

VICC normalization routines for diseases

Project description

Disease Normalizer

image image image Actions status

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,
    "disease": {
        "conceptType": "Disease",
        "primaryCoding": {
            "id": "ncit:C34803",
            "code": "C34803",
            "system": "https://ncit.nci.nih.gov/ncitbrowser/ConceptReport.jsp?dictionary=NCI_Thesaurus&code=",
        },
        "id": "normalize.disease:liver%20cancer",
        "name": "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.disease.primaryCoding.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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

disease_normalizer-0.13.0.tar.gz (331.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

disease_normalizer-0.13.0-py3-none-any.whl (58.9 kB view details)

Uploaded Python 3

File details

Details for the file disease_normalizer-0.13.0.tar.gz.

File metadata

  • Download URL: disease_normalizer-0.13.0.tar.gz
  • Upload date:
  • Size: 331.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for disease_normalizer-0.13.0.tar.gz
Algorithm Hash digest
SHA256 698934557dab2cc49899cdca1e8ef8246840c3f3de5784bae655e08f64640b9c
MD5 8d0663fe103c1cd28c377327c5be5534
BLAKE2b-256 bf56783ec71e50af8c7b89e90d109ce6240e7f332a01c6474c8d7450bd36db5e

See more details on using hashes here.

Provenance

The following attestation bundles were made for disease_normalizer-0.13.0.tar.gz:

Publisher: release.yml on cancervariants/disease-normalization

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file disease_normalizer-0.13.0-py3-none-any.whl.

File metadata

File hashes

Hashes for disease_normalizer-0.13.0-py3-none-any.whl
Algorithm Hash digest
SHA256 628e0e95774635f5429b3f221d9356c16e6993863314a53eec1c98d3d8bd0331
MD5 bd4b8820cf5b2cbb4ad74215eb85bcd6
BLAKE2b-256 d2d8e5e08d0238d7da4be8612425d5be06ecc7786553f4aa43fae7e236a84dd3

See more details on using hashes here.

Provenance

The following attestation bundles were made for disease_normalizer-0.13.0-py3-none-any.whl:

Publisher: release.yml on cancervariants/disease-normalization

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page