6.2.6 UNIX scripts

So far, there exist three UNIX shell scripts useful to quickly examine data sets (uiolook), to change the format or conversion type of files (uiocat), or to print some information about the conversion types possible on the local machine (uioinfo).

6.2.6.1 Installation of UIO UNIX scripts

The installation procedure for the UIO scripts has been updated to make use of its own configure script. Therefore, the procedure should now look like

tar -zxvf for.tar.gz
cd for/uio/f90/YOUR_MACHINE
./configure
make
make install

or

tar -zxvf for.tar.gz
cd for/uio/f90
mkdir YOUR_MACHINE
cd YOUR_MACHINE
ln -s ../conf/configure .
./configure
make
make install

Some of the environment variables that control the CO5BOLD configure script are also recognized (see the header of the UIO configure script). The command

make install

generates a directory ${HOME}/local and sub-directories. An init script is put into ${HOME}/bin. And the resource files .cshrc and .bashrc are modified to call it. Therefore, this installation step is potentially dangerous, because its effect is not restricted to the local directory!

6.2.6.2 Quick examination of files: uiolook

The shell script uiolook calls the Fortran program uiolok.f90. The man page:

UIOLOOK(1V)       Misc. Reference Manual Pages        UIOLOOK(1V)

NAME
     uiolook - print entry headers of file in uio form

SYNOPSIS
     uiolook [ -h ] [ -p ] [ filename ...  ]

AVAILABILITY

DESCRIPTION
     The routine uiolook reads each filename (file in  uio  form)
     in  sequence  and  displays  the  headers  of the entries in
     pretty form.

OPTIONS
     -h    Print usage of uiolook.

     -p    Entry header keywords in (long) pretty form

SunOS 5.5.1       Last change: 27 November 1996                 1

6.2.6.3 Transformation of files: uiocat

The shell script uiocat calls the Fortran program uiocat.f90. The man page:

UIOCAT(1V)        Misc. Reference Manual Pages         UIOCAT(1V)

NAME
     uiocat - concatenate file(s) in uio form

SYNOPSIS
     uiocat [ -c conversion ] [ -f format ] [ -h ] [ -l  copylist
     ] [ -o outputfilename ] [ filename ...  ]

DESCRIPTION
     The routine uiocat reads each filename (file in uio form) in
     sequence  and  displays  its  contents formatted on standard
     output or writes it into a file.  In  the  latter  case  the
     format  change  from  'formatted'  to  'unformatted' or vice
     versa is possible.

OPTIONS
     -c    Conversion  type:  'native',  'ieee_4',  ...  (machine
          dependent),  its  specification is only relevant, if an
          output file is specified with the -o option and  output
          format='unformatted'.

     -f    Output  format:  'formatted'  or  'unformatted'.   Its
          specification  is  only  relevant, if an output file is
          specified with the -o option.

     -h    Help: print usage of uiocat.

     -l    List of entries to be copied. E.g.
            uiocat ... -l"real rho"
            uiocat ... -l"real rho,integer i"
            uiocat ... -l"label *,real rho,integer i"
            uiocat ... -l"label *,real rho,* i"
            Here, copylist is a list, separated by ",". Each item
          consists of exactly two items, separated by a blank. No
          additional blanks are allowed.  Use copylist with "" as
          above.

     -o    Output file name. If omitted, standard output is  used
          and "-c" and "-f" are meaningless.

SunOS 5.5.1       Last change: 12 January 1998                  1

6.2.6.4 Information about conversion types: uioinfo

The shell script uioinfo calls the Fortran program uioinf.f90. The man page:

uioinfo(1V)       Misc. Reference Manual Pages        uioinfo(1V)

NAME
     uioinfo - print machine-dependent information

SYNOPSIS
     uioinfo

DESCRIPTION
     The routine uioinfo prints information about its environment
     and a list of possible conversion types.

OPTIONS

SunOS 5.5.1       Last change: 12 January 1998                  1