Install from Source README

Acquiring 2dx

The latest source for 2dx along with associated help files and up to the minute installation instructions are available at http://www.2dx.org.

Download: 2dx-{version}.tar.bz2

Extract: tar -xvjf 2dx-{version}.tar.bz2

Requirements

The following are required either for compilation or program execution. If you have installed a pre-built binary and any of the programs produce library errors, most likely there is a platform incompatibility with the libraries, or they are missing.

Libraries from the following may be compiled for your platform and placed in the 2dx/lib directory after install, or simply perform a full install of each of the following and the relevant dynamic libraries should be automatically placed in your path.

./configure --enable-shared --enable-single; make; sudo make install

cd /usr/local/
ln -s /path/to/ccp4-{version} ccp4

cd /usr/local/ccp4/bin
ln -s /path/to/script/ccp4.setup-csh ccp4.setup-csh

Compiling and Installing 2dx:

Installation should be the same regardless of system, though SGI-IRIX and Windows remain unsupported at present.

To install 2dx, just run:

configure
make
sudo make install

This will compile and install 2dx to /usr/local/2dx by default. For the sudo command you need root privileges (the administrator password). If you do not have root privileges, or would rather install to another directory, replace the above with:

configure
make
sudo make install prefix=/path/to/install/dir/2dx

where /path/to/install/dir could be in your hope directory. Then that would be /Users/people/JoeThePlumber/2dx.

2dx will then be installed to /Users/people/JoeThePlummer/2dx.

If you wish to use the web browser/ps viewer/editor integration be sure to edit 2dx/config/2dx.cfg. Once you have launched 2dx_image for the first time, you will also have your own private setting in ~/.2dx/2dx.cfg, where you can adjust things for your own taste, if other people on the same computer want to have other default browsers. Simply change each of the values after the appropriate editor/viewer to the desired program. On OS X "open" opens the default editor for a given mime type, but any program can be used instead via:

open -a /path/to/program.app

Installing a pre-compiled 2dx version on Linux:

RPM Install:

rpm -Uvh 2dx-{version}.rpm

should be sufficient.

However, users wishing to install 2dx to a user-defined installation directory may use:

rpm -Uvh --prefix /path/to/install/dir 2dx-{version}.rpm

In the rare case that rpm complains about bin/sh dependencies, etc, use the following:

rpm -Uvh --force --nodeps --prefix /path/to/install/dir 2dx-{version}.rpm

Running 2dx

You will find links to the installed programs in /usr/local/2dx/bin. There you will find 2dx_image, 2dx_merge, and 2dx_logbrowser. Those files should point to the executables. You could include /usr/local/2dx/bin in your PATH definition, so that you can launch these from the command line. Alternatively, you could make a link to those files or to that directory on your desktop, or where-ever you like to have it.

BASH:

echo export PATH=/usr/local/2dx/bin:$PATH >> ~/.profile

CSH:

echo setenv PATH /usr/local/2dx/bin:$PATH >> ~/.cshrc

(Note: The above may vary from system to system.)

On OS-X (Both PPC and Intel) the binaries are wrapped in {program}.app/ directories. For quick access to any of these, simply drag any of the program links found in 2dx/bin to the Dock. To run such a program from a terminal use:

open /usr/local/2dx/bin/{program}.app

Running any of the programs in the 2dx package should require no modification to the system environment.

Documentation & Community Support

Up to the minute documentation for 2dx is available at http://www.2dx.org/documentation. The site contains installation instructions, tutorials and a full description of program parameters, all of which allow for user comments/questions. The goal of this site being part static documentation/part forum for discussion.