next up previous contents index
Next: 6.2.7 IDL UIO routines Up: 6.2 UIO data format Previous: 6.2.5 Fortran90   Contents   Index


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). 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
make install


tar -zxvf for.tar.gz
cd for/uio/f90
ln -s ../conf/configure .
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! 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)

     uiolook - print entry headers of file in uio form

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


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

     -h    Print usage of uiolook.

     -p    Entry header keywords in (long) pretty form

SunOS 5.5.1       Last change: 27 November 1996                 1 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)

     uiocat - concatenate file(s) in uio form

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

     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.

     -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

     -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

     -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 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)

     uioinfo - print machine-dependent information


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


SunOS 5.5.1       Last change: 12 January 1998                  1

next up previous contents index
Next: 6.2.7 IDL UIO routines Up: 6.2 UIO data format Previous: 6.2.5 Fortran90   Contents   Index