https://github.com/ericspod/dicombrowser

Lightweight portable Dicom browser application
https://github.com/ericspod/dicombrowser

dicom dicom-browser dicom-images medical-imaging numpy pydicom pyqt4 pyqtgraph python

Last synced: 7 months ago
JSON representation

Lightweight portable Dicom browser application

• Host: GitHub
• URL: https://github.com/ericspod/dicombrowser
• Owner: ericspod
• License: gpl-3.0
• Created: 2016-11-11T15:50:14.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2024-10-01T14:42:14.000Z (over 1 year ago)
• Last Synced: 2025-01-02T07:43:52.486Z (about 1 year ago)
• Topics: dicom, dicom-browser, dicom-images, medical-imaging, numpy, pydicom, pyqt4, pyqtgraph, python
• Language: Python
• Homepage: https://ericspod.github.io
• Size: 1.04 MB
• Stars: 26
• Watchers: 5
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# DicomBrowser

This is a lightweight portable Dicom browser application written in Python.

It allows Dicom directories to be loaded, images and tag data viewed, and not much else aside.

This is intended to be a cross-platform utility suitable for previewing Dicom data rather than doing any sort of processing.

![DicomBrowser Screenshot](https://github.com/ericspod/DicomBrowser/raw/master/dicombrowser/res/screenshot.png "DicomBrowser Screenshot")

## Installation

DicomBrowser requires **Python 3.8+**, **PyQt5**, **numpy**, **pydicom** and **pyqtgraph**, and optionally the libraries for pydicom used to load JPEG data.

Installation through **pip**:

    pip install dicombrowser

Installation from repo:

    git clone https://github.com/ericspod/DicomBrowser.git

    cd DicomBrowser

    pip install .

This will create the entry point **dicombrowser** which accepts DICOM directories or zip files containing them:

    dicombrowser MAGIX.zip

    

DicomBrowser can be run directly as a module from the repo:

    python -m dicombrowser

## Docker

A Dockerfile is included, to build the image with the following command:

    docker build . -t dicombrowser:latest

and then to run the created image "dicombrowser" on a X Windows host use a command like the following:

    docker run -ti --rm --net=host -e DISPLAY -v "$HOME/.Xauthority:/root/.Xauthority:rw" dicombrowser

Running `xhost +local:docker` may be necessary to add permissions and allow the container to access the X network ports.

## Authors

DicomBrowser is developed and maintained by Eric Kerfoot .

## License

Copyright (C) 2016-22 Eric Kerfoot, King's College London, all rights reserved

This file is part of DicomBrowser.

DicomBrowser is free software: you can redistribute it and/or modify

it under the terms of the GNU General Public License as published by

the Free Software Foundation, either version 3 of the License, or

(at your option) any later version.

DicomBrowser is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

GNU General Public License for more details.

You should have received a copy of the GNU General Public License along

with this program (LICENSE.txt).  If not, see