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,
    "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.

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

Uploaded Source

Built Distribution

disease_normalizer-0.6.0-py3-none-any.whl (50.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: disease_normalizer-0.6.0.tar.gz
  • Upload date:
  • Size: 290.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for disease_normalizer-0.6.0.tar.gz
Algorithm Hash digest
SHA256 fb2d900f7e0008b167aa60bcfa2d8bd70cf1b026465d7be236186dcf4e6e284a
MD5 3ab629b15293da54f2e3aca83410d673
BLAKE2b-256 a9bdd35422286b1cec9dc9f87d38c84a0125f2808f5b4c2b20bf8999e6705d19

See more details on using hashes here.

Provenance

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

Publisher: release.yml on cancervariants/disease-normalization

Attestations:

File details

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

File metadata

File hashes

Hashes for disease_normalizer-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a6b3cc7e7e40762b262f3948b0671e271cd79d44f596576927fc6d17dde6ab86
MD5 7ff7cc3932d606b051c28a131a2633ad
BLAKE2b-256 962de2df0ae81cb59978eafa540bc5cd2092a5db37fc8f2e5f180f4232f93656

See more details on using hashes here.

Provenance

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

Publisher: release.yml on cancervariants/disease-normalization

Attestations:

Supported by

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