CheckStationLogs.pl - GNSS station site log validator

written by Dominique Mesmaker, Royal Observatory of Belgium

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

1. Change log

2016-01-05: Creation
2017-12-11: Option -s modified (E, D or option omitted)
2018-01-23: strictness (about antenna) modified for the default (EPOS level)
2018-10-22: message formats modified
2019-04-08: validation rules modified
2024-07-26: - detects the site log version (v1.0 or v2.0)
            - checks the 'Country or Region' when 'site log v2.0' (in place of 'Country')
            - checks the 'Nine Character ID' when 'site log v2.0' (in place of 'Four Character ID')
            - checks if the 'Date Installed' (in section 1) is later than the 'Date Installed' of the first receiver and antenna

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

2. Purpose 

Validate the content of GNSS station log files available from a directory
from the command line.

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

3. Configuration

- Perl runs on over 100 platforms : Unix/Linux, Windows, Mac OS X, etc...
- Libraries to be installed :
   Getopt::Long
   Getopt::Std
   Cwd
   Time::Local
   Time::localtime
   File::Basename
   File::Copy
   File::Temp qw/ tempfile tempdir /
   File::Spec
   Date::Calc qw(:all)

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

4. Installation

The file CheckStationLogs.pl has to be copied on your local disk.

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

5. Operating instructions

./CheckStationLogs.pl [-h] -l StationLogsDirectory -r ReferencesDirectory 
    [-c CurrentLogDirectory] [-s Network]

 -h                      
    this (help) message
    
 -l StationLogsDirectory        MANDATORY
    name of the directory containing the submitted station logs 
    
 -s Network                     OPTIONAL
    Flexibility of the validation rules 
    Network=E (EPN): Station logs of EPN stations passing this validation will     
                     pass the EPN station log submission at
                     http://epncb.oma.be/_networkdata/sitelogsubmission/
    Network=D (EPN DENSIFICATION): Station logs of EPN densification stations 
                     passing this validation will pass the EPN station log 
                     submission at
                     http://epncb.oma.be/_networkdata/sitelogsubmission/
    default (omitting option -s: flexible validation - to be used for EPOS)

 -r ReferencesDirectory         MANDATORY
    name of the directory containing the reference files antenna.gra (mandatory), 
    rcvr_ant.tab (madatory), and epn_14.atx (mandatory).
    These files should be downloaded from ftp://igs.org/pub/station/general/ or
    ftp://epncb.eu/pub/station/general/ prior to running this script
    
 -c CurrentLogDirectory         OPTIONAL
    name of the directory containing the current station logs (to be used only to check 
    the content of the field "Previous site log")
    
Differences/details about the option "-s" for all the station log sections :

Section 1 - IERS DOMES Number :
  - default: recommended
  - D: recommended
  - E: required

Section 1 - Monument Description :
  - default: recommended
  - E or D:	not required

Section 1 - Height of the Monument :
  - default: recommended
  - E or D:	not required

Section 1 - Monument Foundation :
  - default: recommended
  - E or D:	not required

Section 1 - Foundation Depth :
  - default: recommended
  - E or D:	not required

Section 1 - Geologic Characteristic :
  - default: recommended
  - E or D:	not required

Section 1 - Fault zones nearby :
  - default: recommended
  - E or D:	not required

Section 3 - Serial Number :
  - default or D: not required
  - E: required

Section 3 - Elevation Cutoff Setting :
  - default : recommended
  - D: recommended (EPN guidelines recommend 0 deg)
  - E: required (EPN guidelines recommend 0 deg)

Section 4 - Antenna Type :
  - default or D: required (from IGS table - EPN calibration values required. However values without RADOME type (NONE) are acceptable.)
  - E: required (from IGS table - EPN calibration values required.)

Section 4 - Radome Type :
  - default: required (UNKN allowed)
  - E or D: required (UNKN not allowed)

Section 4 - Antenna Serial Number :
  - default: not required
  - E or D: required

Section 4 - Alignment from True N
  - default or D: not required
  - E: required

Section 5 - Survey method
  - default or D: recommended
  - E: required

Section 6 - Standard Standard :
  - default or D: not required
  - E: required

Section 13 - Primary Data Center :
  - default: required
  - D: recommended
  - E: required (from http://epncb.eu/ftp/center/data/)

Section 13 - Secondary Data Center :
  - default or D : recommended
  - E: recommended (from http://epncb.eu/ftp/center/data/)

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

6. Disclamer

The Royal Observatory of Belgium (ROB) uses the best technical standards and 
makes every possible effort to ensure that the provided information is complete,
accurate and up-to-date. If there would be any inaccuracies or errors in the
provided information, the users are requested to inform the responsible person
for this matter by e-mail to epncb@oma.be.

The ROB declines all responsibility for any and all inaccuracies or other errors
in the provided information. Neither the ROB nor any other party involved in
creating, producing or providing the information shall be liable for any direct,
incidental, consequential, indirect or punitive damages arising out of users'
access to, or use of, or inability to access or make use of the provided
information.