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.11.1.tar.gz (318.2 kB view details)

Uploaded Source

Built Distribution

disease_normalizer-0.11.1-py3-none-any.whl (56.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for disease_normalizer-0.11.1.tar.gz
Algorithm Hash digest
SHA256 17d796132f17c949bb063d99cef739f0fad679ae233b110e4963509fa688bde8
MD5 81bf600ba1c2f8c09a31b6025df01943
BLAKE2b-256 5255840c59c9546c62ec2cde93ea71c13b0492849c53698694ca270c103726e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for disease_normalizer-0.11.1.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.11.1-py3-none-any.whl.

File metadata

File hashes

Hashes for disease_normalizer-0.11.1-py3-none-any.whl
Algorithm Hash digest
SHA256 83f27768c4ae6f125275a33158e7d213e1d0c8b000e59e42ef2d3b476e0a7ae2
MD5 63f4de220040d91112dc5861ad9e59e1
BLAKE2b-256 25e12df15f2cb877331424e20ea9ff6a5949d7436f80cdbf605e8ba251df20b5

See more details on using hashes here.

Provenance

The following attestation bundles were made for disease_normalizer-0.11.1-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 Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page