This should get you up and running with the PTSG particle in cell codes in a minimal amount of time on linux/BSD platforms with appropriately installed libraries. The instructions may work on other systems too, but trouble-shooting failed installations is beyond the scope of this manual. The XGRAFIX and XPDP1 software are dealt with explicitly, but the general procedure is applicable to other codes on the PTSG website. For more detailed instructions, refer to the README files included with the software please contact you local system administrator or the PTSG system administrator, BUT MAKE SURE YOU READ AND FOLLOW ALL THE INSTRUCTIONS. Bug reports that say "your software doesn't work" aren't useful -- in describing problems, please be verbose and describe the platform you are working on.
tar xvf xgrafix260.tar
Change into the xgrafix directory:
If you don't have root priveledge or don't want to install XGRAFIX globally, you must run configure and specify the destination of the installation using the --with-prefix option:
MYPREFIXis the desired directory path to install to -- $PWD (current working directory) and your home directory might not be bad choices. If you use the --with-prefix option, keep in mind that the makefiles of other PTSG PIC programs will need to be manually changed in order to link to the XGRAFIX library when compiling.
from the unix prompt.
from the unix prompt. If you are installing the library system wide (i.e. running configure without using the --with-prefix option), make sure you are root before running this command, or you will have permissions errors.
XPDP1 is an acronym for X Plasma Device Planar 1-D. Installation of XPDC1, XPDP2, XPDC2 and XES2 follow similar procedures.
XGPATH = /usr/local/lib/xgrafix
to the location specified by --with-prefix option for XGRAFIX's configure script.
XGPATH = MYPREFIX
For example, a user 'jhammel' with home directory /accounts/jhammel downloads xgrafix260.tar.gz to his home directory and uncompresses. After changing to the the xgrafix directory, he runs
So 'jhammel' should change the link in XPDP1's makefile to
XGPATH = /account/jhammel/xgrafix
CFLAGS= -g -I$(XGPATH) -DPDP1PATH=\"$(HOME)/xpdp1/src\"
CFLAGS= -g -I$(XGPATH) -I$(XGPATH)/include -DPDP1PATH=\"$(HOME)/xpdp1/src\"
LIBS = -L$(XGPATH) -L/usr/local/lib -L/usr/X11R6/lib -lXGC250 -ltk -ltcl -lXpm -lX11 -lm -ldl
LIBS = -L$(XGPATH) -L$(XGPATH)/lib -L/usr/local/lib -L/usr/X11R6/lib -lXGC250 -ltk -ltcl -lXpm -lX11 -lm -ldl
../xpdp1.linux -i ../maxwello.inp