S E S P

Notes on Using Software Transformation Tools on the QA Server

The Software
Engineering Group

Computational Science & Engineering
CLRC Rutherford Appleton Laboratory


All the tools are currently on the Numerical Analysis Group Server - hsl.rl.ac.uk - which is reachable through ssh once you have been given a user name on that machine.

Four suites of tools are available:

Several Fortran compilers are also available.

PlusFort

plusFORT requires that the environment variable PFDIR be set to access configuration and license files. Set this environment variable to /home/mathsoft/plusFORT.

PlusFORT will search the current directory and any in PFDIR for configuration files. Also add this directory to your PATH environment variable for access to the tools themselves.

The plusFORT configuration file has too many options to be explained here, but the manual is available giving the complete description of each option. The user can change options as thought necessary - it is a plain text file.

Configuration files for the following basic tasks are available on the server:

  • restructure Fortran 77 - spag-f77.fig
  • transform Fortran 77 to Fortran 95 - spag-f77tof90.fig
  • restructure Fortran 95 - spag-f90.fig

These files can be found in /home/mathsoft/plusFORT and copied for modification by the user.

PlusFORT will generate quite a few output files but *.spg is usually the transformed source file.


NAGWare Tools

Many of the NagWare tools have options files. However the standard default files are generally ok. You should note that the NagWare tools use a flexlm license server - there can often be problems with these. You need to set the environment variable LM_LICENSE_FILE to /usr/local/flexlm/licenses/NAG.demo.

This is really only required to use the f95 compiler as the NagWare tools do not require a license file.

All the manual pages for the NAG compiler and the other NagWare tools can be accessed through man e.g. man nag_modules95 or man f95 or this link.

Although there is a GUI front-end to the NagWare tools, nag_tools, this does not work under Fedora Core 2 - some form of X-Windows problems.


Ftncheck

ftnchek does not require much. It is in /home/mathsoft/ftnchek-3.2.2 on the server as ftnchek. The manual page gives all the details on the options (add /home/mathsoft/ftnchek-3.2.2/man to your MANPATH environment variable). There is a Fortran 90/95 version in development.


FORCHECK

FORCHECK is a comprehensive Fortran analysis tool. The tool is held in /home/mathsoft/FORCHECK and require the environment variables below (csh). FCKPWD is the password file and is required. FCKCNF specifies the compiler emulation and FCKCNF as default set of options - strict Fortran 95 and free format source.

setenv FCKDIR /home/mathsoft/FORCHECK

setenv FCKPWD /home/mathsoft/FORCHECK/fckpwd.pwd

setenv FCKCNF ${FCKDIR}/laheyf95.cnf

setenv FCKCPR QUIET

setenv FCKOPT "-f95 -ff"

setenv PATH ${PATH}:${FCKDIR}

You should also add ${FCKDIR}/man to your MANPATH  environment variable.

The full user manual for linux is available in PDF format here.

N.B. The command to type is forchk


Fortran Compilers

There are four useful compilers on the server:

  • f95 - NAG Ltd
    Compiler in /usr/local/bin.
    Set or add LM_LICENSE_FILE environment variable as /usr/local/flexlm/licenses/NAG.demo.
    The man pages are in the standard path.
  • lf95 - Lahey
    Compiler in /usr/local/lf9562/bin.
    Set or add to LD_LIBRARY_PATH -
  • /usr/local/lf9562/lib.
    Add  /usr/local/lf9562/manuals/man/l95 to  MANPATH.
  • ifort - Intel
  • Compiler in /opt/intel_fc_80/bin.
    Set or add to LD_LIBRARY_PATH environment variable - /opt/intel_fc_80/lib.
    Add /opt/intel_fc_80/doc/man to MANPATH.

  • g95
  • Compiler in /usr/local/bin.
    No man pages at present but
    g95 --help  gives the basic options.
    Note that g95 is incompatible with g77 at present.

Most of these can be found through slocate.




SESP Homepage

SEG Homepage