Downloading

Assuming you already have git on your machine (see the OS specific install instructions below if this is not the case).

cd ~
git clone https://git.fmrib.ox.ac.uk/fsl/melview.git

Installation Instructions

For Mac OS X users

We recommend using MacPorts to obtain git, python and it's dependencies and melview itself.

melview can be installed using the MacPorts framework... but first you'll need to do some groundwork to setup (and customise) MacPorts. After the initial setup you will be able to add, remove and update the software with port commands.

The following instructions assume you haven't already installed and/or used MacPorts. You should follow some/or all of the steps accordingly:

First, if you haven't already done so, you may need to enable your command-line compiler tools.
```
 xcode-select --install
```
Select the option to install the "Command Line Tools" from the resulting pop-up dialog.
Download and install MacPorts (you will need Administrator rights for this) from www.macports.org...

Install git:

 sudo port install git

You should now be able to download melview sources:

 cd ~
 git clone https://git.fmrib.ox.ac.uk/fsl/melview.git

Now you will need to create your own local ports directory. Unfortunately you will also need to configure your MacPorts installation to look at this local repository... a full description can found at https://guide.macports.org/chunked/development.local-repositories.html but I have summarised the steps here:
```
 mkdir -p ~/ports/python
 cd ~/ports/python
 cp -r ~/melview/ports/python/melview .
```
Now edit your local macports sources file...
```
 sudo nano /opt/local/etc/macports/sources.conf
```
The lines toward the end of this file lists possible sources where MacPorts can look for the ports. Add the following BEFORE the "[default]" URL at the end of the file (so it'll probably end up being the the second to last line in the file):
```
 file:///Users/<your-user-name>/ports
```
Run "portindex" to incorporate our new Portfile:
```
 cd ~/ports
 portindex
```
```
 Creating software index in /Users/<your-user-name/ports
 Adding port python/melview

 Total number of ports parsed:   1
 Ports successfully parsed:      1
 Ports failed:                   0
```
Now you can install/update melview using the normal MacPorts commands:
```
 sudo port install melview +pyside
```

This final step may take a long time (hours) as it may need to build all the gcc compilers and libraries from sources. More mature MacPorts releases, i.e., for older Mac OS X, may have these as binaries which will save some time.

From now on installing/upgrading/removing melview should be very fast and easy.

For RedHat/CentOS users

melview is available to install via the FMRIB repository. Unfortunately this isn't a public repo so, if you aren't at FMRIB, you will need to follow the manual installation instructions below.

NB. To satisfy the dependencies on RedHat/CentOS try the following:

sudo yum install python-Traits python-traitsui python-matplotlib python-pyside python-pyface python-configobj

For Ubuntu/Debian users

We haven't got a suitable installer prepared yet. Please follow the manual install instructions.

The package dependencies (on Ubuntu) were:

python-configobj
python-enthoughtbase
python-matplotlib
python-nibabel
python-pyface
python-pyside
python-traits
python-traitsui

For EPD users

While it is possible to install melview in EPD/Canopy environments Enthought have now made this product so hard to obtain, initially setup and, in my opinion, use that I feel it is no longer appropriate for all but the experienced users.

Having said that, if you've already installed EPD/Canopy and it's python is the default in your path then melview is installed manually using setuptools:

git clone https://git.fmrib.ox.ac.uk/fsl/melview.git
cd melview
sudo python ./setup.py install

Manual install instructions

melview has the following Python (current target is Python 2.7) package dependencies:

traits
traitsui
nibabel
matplotlib
pyside
pyface
configobj

Assuming these are present, and you have Administrator (sudo) rights, then you should be able to run:

sudo python ./setup.py install

Errors and bugs

If you have any issues, either with melview or the install instructions, then please e-mail fsl-bugs@fmrib.ox.ac.uk