1 Program installation and execution

1.1 Computers within the Astro I cluster at the Univ. Potsdam

At the Linux Workstation-Cluster astro.physik.uni-potsdam.de, the WRplot system is presently installed in the user directory of W.-R. Hamann: /home/corona/wrh/linux-wrplot.dir . This installation is cluster-wide.

C-shell users must dene the proper path variable, and load a couple of aliases, by inserting the following two lines in his/her .login or .cshrc script:

Bash users have to add the following two lines to their .prole (for login shells) as well as to .bashrc:

Alternatively, there is another installation with Helge's version of the program in PATH_WRPLOT /home/crater/htodt/linux-wrplot.dir .

1.2 WRplot installation on other linux systems

For an automatic installation, download the installation script

and execute

 wrplot-install.com

WRplot will be installed in the user's home directory, i.e. root rights are not requiered. The script sets up the required environment and also provides the syntax highlighting les for KDE's editor kate, if the user has kate installed.

In case of problems with this skript, one may alternatively download (e.g. via anonymous ftp):

The executable of WRplot comes in three dierent versions:

wrplot.gnu.exe

 
This version is linked *statically* and should therefore run on *any* linux computer. This executable is my reference version and should be referred to when trouble-shooting. However, this version has only 32-bit numbers and is compiled without optimisation, i.e. it is slow.

wrplot.X11.exe

 
This version is optimized, and hence fast. Since the X11 window is progressively written, this version can be used for WRplot animations. However, depending on your Xserver abilities, it might be that WRplot windows are not refreshed after they have been covered or iconized.

wrplot.motif.exe

 
In this version, the WRplot window is only lled when the plot is complete. Hence, this version cannot be used for animations. Howver, the X window is restored after ithad been covered or iconized.

In your private installation, you can chose between these versions by setting a corresponding link from the generic wrplot.exe in $PATH_WRPLOT/exe.dir. The default is:

 ln -sf ../exe64.dir/wrplot.X11.exe  wrplot.exe

After succsessfull installation, the following commands are available:

wrplot-update

 
For keeping your WRplot installation up-to-date, you should enter this command from time to time.

manwrplot

 
displays this manual with ghostview at your screen.

wrplot

 
enters an interactive mode where the source le can be specied later.

wrplot lename[.plot] [parameters

] ¹

opens the WRplot-window on your screen and shows the rst plot contained in the source le lename. Entering the return key in that (active) window opens the next plot in that le or closes the window if the end is reached.

Note that the WRplot-X11-window is designed for a quick inspection of data; it has no nice (PostScript) fonts, and cannot display encapsulated PS les (but indicates the BoundingBox of EPSF les in the place they would appear).

wrplot lename[.plot] + [parameters

] 1

creates a PostScript le wrplot.ps.1 with the plot of the source le. If wrplot.ps.1 already exists, the trailing number is incremented. If the le contains more than one plot, each plot is written into an own wrplot.ps-le with incrementing trailing numbers. psappend combines all *.ps.i(i) les (i or ii being the one or two character trailing numbers) found in the present work directory into one PS le total.ps with subsequent pages. The dps command removes all wrplot.ps.* les in the present work directory.

wrps lename[.plot] [parameters

] 1 means \WRplot-to-PS". The extension of the WRplot-le must be .plot and can be omitted in the call. A PostScript le is generated which has the name of the source le, the extension being replaced by .ps. The WRplot-le may contain a number of plots, which than are concatenated to PS le with each plot on a separate page.

wrmult lename[.plot] nn [+] [parameters

] 1 is especially useful for quickly viewing a WRplot le which contains a number of plots, each of about a \standard" size of 20 cm 15 cm in landscape orientation. The rst nn plots (nn = 2, 4, 6, 8, 10 or 12) of that le are scaled down and mounted onto one page. The trailing \+" option creates the PostScript le lename.plot.multi.plot.

ttw lename [f77 as132

] 
is a WRplot-based ascii-to-ps converter. The option \f77" supports the classical fortran format by marking the columns 6 and 73. Option \as132" allows for long lines with 132 characters by producing landscape format. The output is written into the le ttw.ps. The command dttw (including the dps command) removes all ttw debris.

psappend

 
concatenates all ps-les in the current directory into one le total.ps which then may contain many pages. This works only for suciently simple PostScript les, such as those generated by WRplot.

new lename

 
is equivalent to wrps lename; psappend

newall

 
performs wrps for all WRplot-Files in the current directory, and nally a psappend.

ps2pdf_portrait lename[.ps]

 
converts lename.ps into lename.pdf while enforcing portrait orientation, i.e. preventing any automatic rotation which might happen otherwise by the standard ps2pdf. Media format is A4.

ps2pdf_landscape lename[.ps]

 
same as above, but for landscape orientation.

ps2pdf_screen lename[.ps]

 
same as above, but for landscape orientation and media format ArchA, which is 4:3 and thus tting to a XGA full-screen.