Subject: [IGSMAIL-2092] RINEX header modifications
From: W. Gurtner
Date: Fri, 4 Dec 1998 6:15:24 PST

******************************************************************************
IGS Electronic Mail      Fri Dec  4  6:15:24 PST 1998      Message Number 2092
******************************************************************************

Author: W. Gurtner
Subject: RINEX header modifications

Dear colleagues,

I wrote a small program that allows the easy modification of items in the
RINEX file headers, the values of which are either given in an options file or
taken directly from the site log file.

It is intended to be used immediately after the rinexing of the raw data files
to account for fields not correctly filled out by the rinex converter or
to take the basic information directly from the own site log file to guarantee
consistency between the two files.

A description, the (Fortran) source for UNIX, a DOS executable and command
files for DOS and UNIX can be found on

Internet:  ubeclu.unibe.ch
User:      anonymous
Directory: aiub$ftp/pcrinex

I append here also the short description.

Any feedback is appreciated.

Regards,

Werner Gurtner

Program RNXHEAD
---------------

The program RNXHEAD modifies the contents of RINEX headers without touching
most of the data part of the file (no copying is necessary).

Only existing header records can be modified. There is no possibility to add
additional header records such as new COMMENT lines.

The items to change are given in an options file, their values either
contained in the same options file or taken from an IGS station log file.

Example:

S CODES KEYWORD               VALUES
*       ********************  **************************************************

O   O   LOG FILE              zimm9801.log
    O   PGM                   
    O   RUN BY                
L  L/O  MARKER NUMBER
   L/O  MARKER NAME           
L  L/O  APPROX POSITION XYZ   
    O   ANTENNA: DELTA H/E/N  
L  L/O  ANTENNA HEIGHT
O   O   OBSERVER              AUTOMATIC
O   O   AGENCY                AIUB
   L/O  REC #
   L/O  REC TYPE
   L/O  REC VERS
L  L/O  ANT #
L  L/O  ANT TYPE
O   O   INTERVAL              30
        COMMENT
        .
        .
        .

You have to specify in the first column where to take the value from:

O = Options file       L = Station log file      blank: Don't modify

The second column shows the possible selection codes.

If you want to access a log file you have to enter its name into the VALUES
field of the LOG FILE line and switch it on with O in the first column.

Values in the VALUE field are only taken if switched on with O.

The name of the RINEX file and the options file are passed to the executable
program through an auxiliary file called RNXHEAD.INP. If this file does not
exist, the two names are requested from the standard input.

The auxiliary file is prepared by a command file (rnxhead for UNIX and
RNXHEAD.BAT for DOS). This command file also calls the executable rnx_head.e
(UNIX) and RNX_HEAD.EXE (DOS).

Call:   rnxhead 'rinex_file' 'options_file'

The program marks the modified header in position 18 of the PGM field with "m".

To compile and link the source file rnx_head.f under UNIX, use:

        f77 -o rnx_head.e rnx_head.f

Files:

        rnxhead         UNIX shell script
        RNXHEAD.BAT     DOS batch file
        rnx_head.f      Fortran source for UNIX systems
        RNX_HEAD.EXE    Executable for DOS
        RNXHEAD.OPT     Blank options file
        RNXHEAD.TXT     This file

Access: ubeclu.unibe.ch
        aiub$ftp/pcrinex

Author: W. Gurtner
        Astronomical Institute
        University of Berne

        [email-masked]

[Mailed From: [email-masked] (WERNER GURTNER)]