Metadata-Version: 2.0
Name: dcmfetch
Version: 0.1.6
Summary: DICOM query retrieve tools
Home-page: https://bitbucket.org/rtrhd/dcmfetch
Author: Ron Hartley-Davies
Author-email: R.Hartley-Davies@bristol.ac.uk
License: MIT
Download-URL: https://bitbucket.org/rtrhd/dcmfetch/get/v0.1.6.zip
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Requires-Dist: QtPy (>=1.0.2)
Requires-Dist: pydicom (>=0.9.9)
Requires-Dist: requests (>=2.2.1)

DICOM Server Access
===================

Dcmfetch is a python package for retrieving images from a
`DICOM <http://medical.nema.org/>`__ server. There is no python DICOM
network provided but the package can use command line utilies from
either
`dcm4che2 <http://sourceforge.net/projects/dcm4che/files/dcm4che2/>`__
or
`dcm4che3 <https://sourceforge.net/projects/dcm4che/files/dcm4che3/>`__
for the network transport. In addition, bundled standalone versions of
the required dcm4che3 tools are now included so the only mandatory
external (non-python) dependency is a working java runtime. Further
details on installation and use are available
`here <docs/dcmfetch.md>`__.

The DICOM server must support the dicom ``c-find`` and ``c-get``
protocols (not just ``c-move``). This is the case for the
`dcm4chee <https://sourceforge.net/projects/dcm4che/files/dcm4chee/>`__
server, though several other common servers do not as yet support
``c-get``. In addition though, ``dcmfetch`` supports access to servers
such as `orthanc <http://www.orthanc-server.com/>`__ using the
``QIDO-RS`` and ``WADO-RS`` web *REST* APIs instead.

DICOM servers are identified by keys in the configuration file
``dcmnodes.cf``. This file encodes the server details (AET, most, port)
together with a string representing facilities supported by the server
(including the web API if available). This file is typically installed
to the directory ``/etc`` on a unix system.

As well as the python package ``dcmfetch`` two utilities are provided:
``dcmfetch`` a command line program to retrieve series and
``dcmfetchtool`` a
`PyQt <https://riverbankcomputing.com/software/pyqt/intro>`__ based
graphical tool.

Licences
--------

This package is made available under the `MIT <LICENCE>`__ licence. The
included dcm4che3 programs are distributed under the
`Mozilla <https://github.com/dcm4che/dcm4che/blob/master/LICENSE.txt>`__
public licence, the only modification here has been to bundle them into
single executables.


