Skip to main content

A python package to query the National Biomedical Imaging Archive (NBIA) database.

Project description

NBIA Toolkit

PyTests Documentation Status codecov Python version

PyPI version Downloads PyPI - Downloads GitHub repo size Docker Pulls

GitHub milestone detailsGitHub milestone details

nbiatoolkit is a python package that provides programmatic access to query and download images from the National Biomedical Imaging Archive (NBIA) and The Cancer Imaging Archive (TCIA) databases.

Features

  • Use NBIA Guest account to access public data OR authenticate using OAuth with user credentials for limited access data (requires approved data access).
  • Query NBIA database for metadata on collections, patients, studies, series, and images
  • Download images from NBIA
    • Validate doownloads with MD5 checksums for downloaded images
    • Auto-sort DICOM files using a user-defined pattern of DICOM tags with specialized DICOMSorter class

See Documentation at NBIA-Toolkit Read The Docs

Installation

nbiatoolkit is currently under development. It is made available via PyPI and can be installed using pip:


pip install nbiatoolkit

CLI Usage

getCollections Output

nbia-toolkit also provides a command line interface (CLI) to query the NBIA database for some queries.

> NBIAToolkit --version

Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

License

nbiatoolkit was created by Jermiah Joseph. It is licensed under the terms of the MIT license.

User Agreements and Disclaimers

The NBIA-toolkit is NOT a product of the National Cancer Institute (NCI) and is not endorsed by the NCI. The NBIA-toolkit is provided as an open-source tool based on the NBIA REST API. The NBIA-toolkit is provided "AS IS" without warranty of any kind.

In no event shall the authors or contributors be liable for any claim, damages or other liability, arising from, out of or in connection with the NBIA-toolkit or the use or other dealings in the NBIA-toolkit.

Users of the NBIA-toolkit are required to abide by the NBIA REST API Terms of Service and the NBIA Data Usage Policies and Restrictions

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

nbiatoolkit-0.16.0.tar.gz (17.1 kB view details)

Uploaded Source

Built Distribution

nbiatoolkit-0.16.0-py3-none-any.whl (20.4 kB view details)

Uploaded Python 3

File details

Details for the file nbiatoolkit-0.16.0.tar.gz.

File metadata

  • Download URL: nbiatoolkit-0.16.0.tar.gz
  • Upload date:
  • Size: 17.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.7

File hashes

Hashes for nbiatoolkit-0.16.0.tar.gz
Algorithm Hash digest
SHA256 260f781981cdcb9bac9a6bce984b17031f85f60ef7a1b2f2ad82f5a8e52fc776
MD5 45384a94410f7ffe64a12760568e40b9
BLAKE2b-256 f59add5d52779da923631f0faeff016ce1f6bfb86388f923ff91008865055659

See more details on using hashes here.

File details

Details for the file nbiatoolkit-0.16.0-py3-none-any.whl.

File metadata

File hashes

Hashes for nbiatoolkit-0.16.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3d4623fc0b3ba3254800a4766279991429945223657def15e6aa24e17776ea74
MD5 b771be4283d82e0b13f906cd2bc41dbb
BLAKE2b-256 5aa5fb647f004113d9ec756574a0fcd3b9288327289299ae83cefabcdf363ee2

See more details on using hashes here.

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