Skip to main content

COnsolidated BReast cancer Analysis DataBase

Project description

cobra_db

DOI:10.1117/1.JMI.10.6.061404 PyPI version Documentation Status codecov

Consolidated Breast Cancer Analysis DataBase

What is cobra_db?

cobra_db is a python package that allows you to extract DICOM metadata and store it in a MongoDB database. Allowing you to index, transform, and export your medical imaging metadata.

With cobra_db, you will have more visibility of your data enabling you to get more value from your medical imaging studies.

Once the metadata is in the database, you can import other text-based information (csv or json) into a custom collection and then run queries. This allows you to mix and match data extracted from different sources in different formats.

For example, let's say you have 1 million mammography DICOM files and you would like to obtain the path of the files that belong to women scanned at an age of between 40 and 50 years old.

If you had cobra_db, you could run the following query in just a few seconds directly in the mongo shell.

db.ImageMetadata.find(
  // filter the data
  {patient_age:{$gt:40, $lte:50}},
  // project it into a flat structure
  {
    patient_id: "$dicom_tags.PatientID.Value"
    drive_name: "$file_source.drive_name",
    rel_path:"$file_source.rel_path",
  })

This would return the patient id, the drive name and the relative path (to the drive) for all the files that match the selection criteria.

Installation

If you already have a working instance of the database, you only need to install the python package.

$ pip install cobra_db

If you would like to create a database from scratch, go ahead and follow the tutorial.

Usage

If you have an ImageMetadata instance id that you would like to access from python.

from cobra_db import Connector, ImageMetadataDao

# the _id of the ImageMetadata instance that you want to access
im_id = '62de8e38dc2414586e4ddb25'

# prompt user for password
connector = Connector.get_pass(
  host='my_host.server.com',
  port=27017,
  db_name='cobra_db',
  username='my_user'
)
# connect to the ImageMetadata collection
im_dao = ImageMetadataDao(connector)
im = im_dao.get_by_id(im_id)
print(im.date.file_source.rel_path)

# this will return
... rel/path/to/my_file.dcm

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

cobra_db was created by Fernando Cossio, Apostolia Tsirikoglou, Annika Gregoorian, Haiko Schurz, Hui Li, and Fredrik Strand. It is licensed under the terms of the Apache License 2.0 license.

Aknowledgements

This project has been funded by research grants Regional Cancer Centers in Collaboration 21/00060, and Vinnova 2021-0261.

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

cobra_db-0.4.6.tar.gz (36.0 kB view details)

Uploaded Source

Built Distribution

cobra_db-0.4.6-py3-none-any.whl (43.0 kB view details)

Uploaded Python 3

File details

Details for the file cobra_db-0.4.6.tar.gz.

File metadata

  • Download URL: cobra_db-0.4.6.tar.gz
  • Upload date:
  • Size: 36.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.8

File hashes

Hashes for cobra_db-0.4.6.tar.gz
Algorithm Hash digest
SHA256 2c854d31dd85ed6391a1f57edadee41a326c84d6cf212aa7e242c8ae74f2c7c9
MD5 993dacd7cdaa3c1b3a39e9d8811a5726
BLAKE2b-256 7595d585a29767cfa6a5ba65feeb08d2974c97003aefb1e47ddb575372e153ad

See more details on using hashes here.

Provenance

File details

Details for the file cobra_db-0.4.6-py3-none-any.whl.

File metadata

  • Download URL: cobra_db-0.4.6-py3-none-any.whl
  • Upload date:
  • Size: 43.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.8

File hashes

Hashes for cobra_db-0.4.6-py3-none-any.whl
Algorithm Hash digest
SHA256 5eff19960b3ded4b98b7de825504b74ce3fa08b19309395dc1c0b477a719c49a
MD5 3b564b6cfa66fc77ff76c9951d30b943
BLAKE2b-256 7b51cd15d738ae5f962c0ba21c345a73066fb5cb2fa386bb3d208a506ace2673

See more details on using hashes here.

Provenance

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