VICC normalization routines for diseases

These details have not been verified by PyPI

Project links

Documentation

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

These details have not been verified by PyPI

Project links

Documentation

Release history Release notifications | RSS feed

This version

0.12.0

Nov 4, 2025

0.11.3

Oct 31, 2025

0.11.2

Jul 21, 2025

0.11.1

Jul 10, 2025

0.11.0

Apr 22, 2025

0.10.0

Mar 24, 2025

0.9.0

Feb 13, 2025

0.8.0

Jan 29, 2025

0.7.0

Jan 2, 2025

0.6.0

Nov 29, 2024

0.5.0

Jul 15, 2024

0.4.0.dev4 pre-release

Jun 7, 2024

0.4.0.dev3 pre-release

Dec 20, 2023

0.4.0.dev2 pre-release

Dec 4, 2023

0.4.0.dev1 pre-release

Nov 28, 2023

0.4.0.dev0 pre-release

Oct 25, 2023

0.3.1

Jan 11, 2023

0.3.0

Nov 2, 2022

0.2.21.dev0 pre-release

May 12, 2023

0.2.20

May 7, 2023

0.2.19

Jan 11, 2023

0.2.18

Jan 10, 2023

0.2.17

Jan 6, 2023

0.2.16

Nov 2, 2022

0.2.15

Oct 31, 2022

0.2.14

Sep 23, 2022

0.2.13

Aug 24, 2022

0.2.12

Jan 24, 2022

0.2.11

Nov 18, 2021

0.2.10

Sep 7, 2021

0.2.9

Sep 7, 2021

0.2.7

Apr 15, 2021

0.2.4

Mar 31, 2021

0.2.3

Mar 30, 2021

0.2.2

Mar 29, 2021

0.2.1

Mar 29, 2021

0.2.0

Mar 12, 2021

0.1.1

Mar 3, 2021

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

Uploaded Nov 4, 2025 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

disease_normalizer-0.12.0-py3-none-any.whl (58.7 kB view details)

Uploaded Nov 4, 2025 Python 3

File details

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

File metadata

Download URL: disease_normalizer-0.12.0.tar.gz
Upload date: Nov 4, 2025
Size: 326.5 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.12.0.tar.gz
Algorithm	Hash digest
SHA256	`20f6b2c63c2aae341e1d36952d01060d06daf4c56da8192df00d62d3e0aab7bc`
MD5	`a1bbf469fb863776cde4e3e5563cfb3a`
BLAKE2b-256	`7b885bbe47ade8900d32cc80c65bdc73e2e87095cb065b73f54fdf0e589408da`

See more details on using hashes here.

Provenance

The following attestation bundles were made for disease_normalizer-0.12.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: disease_normalizer-0.12.0.tar.gz
- Subject digest: 20f6b2c63c2aae341e1d36952d01060d06daf4c56da8192df00d62d3e0aab7bc
- Sigstore transparency entry: 667300074
- Sigstore integration time: Nov 4, 2025
Source repository:
- Permalink: cancervariants/disease-normalization@2f8b1a2e73037b1ddbca0ccf041c270cd71828b7
- Branch / Tag: refs/tags/0.12.0
- Owner: https://github.com/cancervariants
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@2f8b1a2e73037b1ddbca0ccf041c270cd71828b7
- Trigger Event: release

File details

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

File metadata

Download URL: disease_normalizer-0.12.0-py3-none-any.whl
Upload date: Nov 4, 2025
Size: 58.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for disease_normalizer-0.12.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`321c7c2d6bab17fb3378531335dfbf040593a93b708286faf98683e01c856569`
MD5	`ed870bea26a7717cc8ad2768eb92351c`
BLAKE2b-256	`3349bac61ac3d8ae3430ae48076d937fdd93a84efc85a073b98a01bf8b9b7e40`

See more details on using hashes here.

Provenance

The following attestation bundles were made for disease_normalizer-0.12.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: disease_normalizer-0.12.0-py3-none-any.whl
- Subject digest: 321c7c2d6bab17fb3378531335dfbf040593a93b708286faf98683e01c856569
- Sigstore transparency entry: 667300075
- Sigstore integration time: Nov 4, 2025
Source repository:
- Permalink: cancervariants/disease-normalization@2f8b1a2e73037b1ddbca0ccf041c270cd71828b7
- Branch / Tag: refs/tags/0.12.0
- Owner: https://github.com/cancervariants
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@2f8b1a2e73037b1ddbca0ccf041c270cd71828b7
- Trigger Event: release

disease-normalizer 0.12.0

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

Disease Normalizer

Installation

Examples

Feedback and contributing

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Project links

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance