Skip to main content

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

Project description

PyTests Documentation Status

NBIA Toolkit

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
    • Calculate MD5 checksums for downloaded images
    • Auto-sort DICOM files using a user-defined pattern of DICOM tags

See Documentation at NBIA-Toolkit Read The Docs

Usage

Wiki is empty for now: See the Wiki for more information.

Installation

nbiatoolkit will be made available on PyPI and Conda Forge soon. Until then, you can install the latest development version from GitHub by cloning the repository and running the following commands in the root directory:

pip install poetry
poetry install

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

Uploaded Source

Built Distribution

nbiatoolkit-0.1.0-py3-none-any.whl (14.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: nbiatoolkit-0.1.0.tar.gz
  • Upload date:
  • Size: 12.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.12.0 Darwin/22.3.0

File hashes

Hashes for nbiatoolkit-0.1.0.tar.gz
Algorithm Hash digest
SHA256 933823a89f0e3405a6a700615e7066c9864aa993ebf762e4e30d61db16713807
MD5 076c4378bc9ffe73d445435b82603f50
BLAKE2b-256 67ccf57221773e00fe001a60971fee04bd446c52fff1c4a0d112e4b9482b57a8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: nbiatoolkit-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 14.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.12.0 Darwin/22.3.0

File hashes

Hashes for nbiatoolkit-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2c0041fbd33df8bf62673fc1ed19c572cdfa31a694ffd936f45a08922647bc86
MD5 c55fe14cdd195da9069c8ef717e1b457
BLAKE2b-256 63c1aebcbbd65214de8601af70898c71b2d849a1c848201e3aeda2475a4d3fd5

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