Warp can be built and installed on Linux and Mac OSX. Several packages are needed to install and run Warp. Below are instructions on how to install the various packages. This assumes that Python is already installed. Note that depending on where Python is installed, root privilege may be needed to install the packages. On Mac OSX, XCode and it's development package need to be installed, as well as XQuartz. Warp requires Python3.
If you do not have root privileges, it is recommended to install the packages in a Python virtual environment.
On OSX, a recommended method of installation is to use the Python installed under HomeBrew, http://brew.sh. This offers a number of advantages, including not needing sudo, the Python includes pip for easy package installation, and allows easy install of gfortran (as part of the gcc package), openmpi, and git among other things. After installing brew, you will need to do the following (gcc includes gfortran, and openmpi is only needed for running in parallel).
brew install python
brew install gcc
brew install openmpi
Alternatively, Warp can be installed using Anaconda, which provides a extensive set of Python packages, though this is not recommended.
Numpy is the numerics package for python. On most variants of Linux, this can be installed using the package manager, such as yum. It is pre-installed in the built in version of Python on Mac OSX. It can also be installed using the Python package managers, pip or easy_install. For example,
python -m pip install numpy
Forthon provides the glue linking Fortran and python. It must be installed first before Warp can be built. It can be installed using pip:
python -m pip install Forthon
Alternatively, it can be downloaded using git, "git clone https://github.com/dpgrote/Forthon.git". After downloading it, cd into the Forthon directory and run "python -m pip install .", using the same Python that will be used with Warp.
Warp can be downloaded from bitbucket.
git clone https://bitbucket.org/berkeleylab/warp.git
This will download the Warp repository and put it in the "warp" directory. Inside of the warp directory will be "pywarp90" which contains the Fortran source and "scripts" which contains the Python source. The installation is done in the pywarp90 directory.
The fortran backend of Warp is called pywarp90, which can be compiled for single- or multi-processor support. The compilation requires a fortran compiler - the recommended one is gfortran. The following will build the serial, single processor, version and install Warp into Python's site-packages directory, including the Warp scripts.
make install
If a modification of the make process is needed, create a file call Makefile.local3 and put the modifications there instead of changing Makefile.Forthon3.
Parallel Warp
When installing the parallel version of Warp in an environment that has the command mpifort available, no extra setup is needed.
make pinstall
If mpifort is not available, the compiler type and compiler executable need to be specified in a file called Makefile.local3.pympi. For example, add these lines:
FCOMP = -F gfortran
FCOMPEXEC = --fcompexec ftn
Also create a file setup.local.py to add the include and library paths for the Fortran libraries. (This is needed since the final linking will be done by a C compiler which may not know which mpi libraries are needed for Fortran.) For example:
if parallel:
library_dirs += ['/usr/lib64/mpi/gcc/openmpi/lib64/']
libraries += ['mpi','mpi_f77']
After this you can compile and install the parallel version by using "make pinstall".
Parallel Warp needs the mpi4py package, which can be installed with "python -m pip install mpi4py".
NOTE: If the parallel version of Warp is installed, the serial version must also be installed.
Any updates to Warp can be downloaded using git. The following will update both the serial and the parallel versions (starting in the top directory of warp):
git pull
cd pywarp90
make install
make pinstall
pygist is the plotting package that is used by Warp. It can be obtained from https://bitbucket.org/dpgrote/pygist.
git clone https://bitbucket.org/dpgrote/pygist.git
Note that there are other versions of pygist available elsewhere but they will likely not work with Warp since some special coding is needed.
For installation, the X11 header files need to be installed, for example by installing the X11 devel package under Linux.
This will install the python interface as well as the cgm file viewer, gist:
cd pygist
python setup.py config
python setup.py install
Posinst provides routines for handling secondary emission of electrons from impact on surfaces, developed for electron-cloud physics. The source can be obtained by special request. There are several ways to build posinst. For Warp related usage, the following will compile the code and install it into the usual location for python modules.
make installpy
SciPy (optional)
SciPy is a full fledged scientific numeric package, which contains many useful tools. For Warp, it is only need for optional beam matching scripts. It can be installed using the pip python manager:
python -m pip install scipy
After Warp is installed, there are test scripts that can be used to verify that it is functioning properly. Go into the directory warp/warp_tests and run the following command:
python runalltests.py
This will run the tests - it's output will be a list of each test as it runs, hopefully saying "OK". If there are any problems, there will be output showing the test that failed and the error. It shouldn't take more than a minute or so to run the tests.