Dicompyler installation¶

Introduction¶

dicompyler user Andrew Miller has contributed this guide for beginners to install dicomyler on Ubuntu (18.04 LTS in this case).
Installing the up-to-date dicompyler on Ubuntu for newbies
The dicompyler installation requires:
the use of the terminal (a.k.a. Command Line Interface, 'command line' to most users) a working internet connection
My PC is called “andrew@andrew-HP-EliteBook-1”. When you see this phrase, you can substitute the name of your own PC. This is the first line you will see when you open a terminal. So open a terminal and you should see something like this:
andrew@andrew-HP-EliteBook-1:
Now type/copy & paste the following text after the colon (its 4 separate lines, execute each one):
sudo apt-get install git python3 python3-minimal python-wxtools
sudo apt-get install python3-pil python3-pip python3-numpy
sudo apt-get install python3-matplotlib python-elixir
sudo apt-get install python3-sqlalchemy python3-setuptools

Press ENTER (I won't tell you to do this again, but after each line you need to press enter), and the system will respond with:
[sudo] password for andrew:

Obviously you will see your own name there, so type in your superuser/admin password (its the same as the one you use to log in!). Your packages will start to download and eventually will install, and you will return to the prompt. You have just installed the dependencies listed on the dicomplyer website – Python, wxPython, Python Imaging Library, NumPy, matlibplot, SQLAlchemy and Elixir. You have not installed pydicom yet though. You can now issue the command to get python package.

andrew@andrew-HP-EliteBook-1:~$ pip3 install pydicom

You will see the following text appear in the terminal:

Collecting pydicom
Downloading https://files.pythonhosted.org/packages/43/88/d3c419ab2e753e7651510882a53219373e78fb55294cb247dffd3934ea55/pydicom-1.2.2-py2.py3-none-any.whl (7.0MB)
100% |████████████████████████████████| 7.0MB 232kB/s
Installing collected packages: pydicom
Successfully installed pydicom-1.2.2

Now you need to pull the python code from the Github repository. On the command line enter:
andrew@andrew-HP-EliteBook-1:~$ git clone https://github.com/bastula/dicompyler dicompyler

You will see the following text appear in the terminal:
Cloning into 'dicompyler'...
remote: Enumerating objects: 1148, done.
remote: Total 1148 (delta 0), reused 0 (delta 0), pack-reused 1148
Receiving objects: 100% (1148/1148), 2.83 MiB | 2.25 MiB/s, done.
Resolving deltas: 100% (838/838), done.

If you look in your home directory, you will now see a new directory /dicompyler in your /home/my_name directory. This is where the dicompyler files are found. Move into that directory with this command:

andrew@andrew-HP-EliteBook-1:~$ cd dicompuler/

To obtain some test DICOM data for your new installation, open this link in your browser and download the file testdata.zip. For convenience, save the ZIP file in the folder /home/my_name/dicompyler/testdata/. You now need to uncompress the ZIP file. Enter the directory by entering the following into the command line:

cd dicompyler/testdata

unzip testdata.zip

You will see the following text appear in the terminal:
Archive: testdata.zip
...
inflating: rtdose.dcm
inflating: rtplan.dcm
inflating: rtss.dcm

Now enter the dicompyler directory and run the code:
andrew@andrew-HP-EliteBook-1:~/dicompyler$ python3 dicompyler_app.py

You should now be greeted by the dicompyler screen. You can then select the patient. If you have a DICOM-RT file from your work, park it in testdata also.

Andrew Miller, April 9, 2019