BuildRequirements

Build requirements and dependencies

There are several items that need to be installed before you can use dicompyler. Since this project is cross-platform, it is assumed you should be able to run Python on Windows / Mac / Linux. Most dependencies can be installed via easy_install or pip.

New: As of version 0.4.1, dicompyler is now a package and can be found on PyPI. To get the latest released version, just install via: easy_install dicompyler or pip install dicompyler.

If you are interest in the source code for dicompyler, it is available here.

Details

Main requirements:

• Python 2.5 or higher; untested on Python 3.0
  • Does NOT work on the system Python 2.6 on Mac OS X Snow Leopard due to wxPython not being compatible
    • Use the command python2.5 to run
    • Install packages with easy_install-2.5
• wxPython 2.8.8.1 to 2.8.10.1 (2.9 is not supported yet)
• Python Imaging Library (PIL) 1.1.7 or higher or any version of Pillow
• simplejson (ONLY for Python 2.5 - Python 2.6+ includes JSON support)

Scientific requirements:

• pydicom 0.9.5 or 0.9.6
  • IMPORTANT: Currently pydicom 0.9.7 does not work due to the way Decimal data is handled - more information
• NumPy 1.2.1 or higher
• matplotlib 0.99 to 1.1 (not 1.2 or higher)

Getting the Source

The dicompyler code is managed with mercurial (a.k.a. hg). In order to download the dicompyler code, you will need to have hg installed. Once hg is installed, you can clone (download) the code repository with the following command:

hg clone https://dicompyler.googlecode.com/hg/ dicompyler

Further instructions and the browseable code are found here.

Building

As Python is an interpreted language, the source is simply run rather than built or compiled. Any build steps necessary for libraries should be explained in included documentation.

Running

The most basic way to run dicompyler is to call dicompyler_app.py while in the dicompyler directory.

user@computer:~/dicompyler$ ./dicompyler_app.py

After dicompyler has started, open a patient by selecting the Open Patient button or using the File menu.

Updating to the Latest Source

To get the latest dicompyler source code, use the following mercurial command while in the dicompyler directory, which downloads the code:

hg pull

then use the following command which actually applies the code to your local copy:

hg update

If you have made any changes, there will be conflicts. This is outside of the scope of this guide, but you will have to resolve the changes before performing another operation with mercurial. Please see this guide for further information on mercurial.

Developing, etc.

Please see the Plugin Development Guide and the Helping page.