This Qtran build is standalone and does NOT require NASA cdf libraries to be installed.

It is built against cdf version 3.1 for Themis compatibility.

The binary should work straight out of the box, but the source is provided so that Qtran can be built against the local cdf installation.

It is a command line utility and is run from the X11 xterm window or the native Mac command line terminal window. The X11 application can be installed from the Mac install CD's but is not part of the default installation.

The application can be used immediately by typing 
Qtran   filename.cdf
at the prompt to translate file filename.cdf into file filename.cef, or to create a cdf by giving a cef file as input argument. Further control is provided by input arguments listed below.


Usage: ./Qtran  [-o{tdce}] [-i{tdce}] [-hName] [-nName] [-f] [-r] [-v] FileName
options are...
 -i{tdcea} for input type qft, qfd, cdf, cef, cef2(CAA) respectively
 -o{tdceax} to specify output type as  qft, qfd, cdf, cef, cef2(CAA), no file respectively
 -f forces overwrite, otherwise error returned if file exists
 -r turns on record numbering if output file is flat
 -v turns on  verbose messages
 -c turns on  cef 2 syntax compliance messages
 -hName specifies Name as that of a detached header
 -nName specifies Name as that of the output file stem
 -sxxx Records starting with xxx are to be read. 
           First record number is 0. 
           Ignored when reading CDF
 -exxx Records up to and including xxx are to be read. 
           First record number is 0. 
           Ignored when reading CDF

 Option flags MUST be space separated,
 File type option must immediately follow -i and -o flags
 Option -h is ignored for cdf type input file
 If the input file has no extension use -i flag to set input type



Troubleshooting

The install script always places the Qtran directory in /Applications.  The resource file appropriate to users default shell is then modified by the installer to place the Qtran executable in the users PATH.

If the install directory is moved, or a different shell environment is set in the terminal application, then it will be necessary to modify the PATH environment accordingly.

This is best done by creating (or modifying) the .bashrc, .profile or .cshrc or similar file in your home directory, depending on the shell you run. The Mac default is bash, and xterm uses .profile, while X11 xterm uses .bashrc.

In .bashrc or .profile modify ...
PATH=$PATH:/Applications/Qtran

or in .cshrc add...

setenv PATH ${PATH}:/Applications/Qtran

otherwise the full path to the application must be given when running Qtran from a command line. 

The command 
ls -al ~
will show which resource files are present, and the command 
printenv SHELL 
will show which shell is in use.

To build Qtran from source, open a terminal window (terminal or X11) and change directory to /Applications/Qtran/src. Edit the Makefile to change the path to the local cdf installation and type 'make' at the prompt. It is possible to build against the dynamic cdf library by commenting out the CDF_FLAG line and un-commenting the equivalent line containing -lcdf.
A source build should not normally be required for Cluster users.

Notify csc-support-dl@imperial.ac.uk of any difficulties.
