RESTRAX for Windows

RESTRAX has been ported to Windows platform using Absoft Fortran 90 compiler. Necessary components (source files, makefile, scripts, etc...) are listed below.

Limitations: The PGPLOT library linked to the program does not contain any equivalent of an x-windows driver. You can use only GIF or PostScript drivers and subsequently view the result with an appropriate viewer (e.g. GSView).

Source files

There are several files added to the source distribution needed for the win32 version:

RESTRAX sources specific to windows

src/cfiles/win/excihandle.c

Windows version of the wrapper loading dynamically EXCI libraries (res_exci_*.dll). It uses calls to win32 API.

PGPLOT extension

pgplot\libpgbase.amk

pgplot\sys_awin\*

The makefile used with Absoft Fortran 90 compiler to build libpgbase.lib static library, which has to be linked with RESTRAX (not included in the source distribution).

Makefiles

makefile.amk

makefile_exci.amk

mkdep_restrax.amk

These are makefiles for Absoft Fortran 90 needed to build RESTRAX.

Compilation

makerestrax.bat

makeexci.bat

Use the batch files listed above to build RESTRAX and res_exci_*.dll, respectively. You may want to pass an argument to makeexci.bat with the name of your dll source file (without extension), e.g.

makeexci.bat res_exci_something

libpgbase.lib static library with PGPLOT is required.

At the end, you may clean the distribution by using “clean” argument:

makerestrax.bat clean

makeexci.bat clean

How to compile the PGPLOT library:

get the source files at http://www.astro.caltech.edu/~tjp/pgplot/ and unpack to a directory (called <pgplot > in following)
copy the sys_awin directory to <pgplot>
copy the makefile (libpgbase.amk) to < pgplot >
compile the library using amake utility, e.g.

C:\Absoft95\bin\amake.exe –f libpgbase.amk

copy the created libpgbase.lib file to the RESTRAX distribution directory (needed for RESTRAX to link successfully)
go to the sys_awin\pgpack directory and use the makefile found there to build the pgpack.exe utility
run pgpack.exe to produce grfont.dat binary file

grfont.dat is required by PGPLOT to draw letters correctly. Copy it to the PGPLOT directory (defined by the PGPLOT_DEV environment variable, as set in start.bat).

Installation

Copy the distribution with compiled binaries to any directory you wish (or leave it where it is).

Following directories are not needed for the binary and demo jobs to run:

src

include

exci

config

templates

pgplot\sys_awin

Optionally, you may edit the plot.bat batch file, which invokes GSView with appropriate arguments to plot the output if it is send to a *.ps file. You should set appropriate PGPLOT_DEV variable with PGPLOT PostScript driver and the RESTRAX_PLOT variable in the start.bat file. If RESTRAX_PLOT is set to plot.bat, it will call this batch file after each plotting command.

Usage

Use the start.bat batch file to run the program. You may want to modify the contents in order to call RESTRAX with other setups than those predefined in the .\demo directory. When using GSView in plot.bat to visualise the default PostScript output file (restrax.ps), you may need to open GSView before executing RESTRAX in order to prevent console freezing after the first plot command.