################################################################################################################# # V0.1 March 27, 2017 # # +---------------------------------------------------------------------+ Author: A.Harmegnies # # | CIRCULAR T ASCII FORMAT DESCRIPTION for automatic reading | # # +---------------------------------------------------------------------+ # # # # # # This file provides guidelines for automatic extraction of data from the Circular T. # # # # To extract parameters (columns 3) from the Circular T, # # it is needed to look for LABELS to identify concerned lines. # # A test must be performed to identify LABEL (column 2) in a line at the given position (column 1). # # When the LABEL is found, parameters can be extracted reading columns X:Y (X to Y) (column 5), # # the reading format of the parameter is described in column 4: I2 = int*2, A2= char*2, x=blank, # # f8.1= float on 8 bits with 1 decimal precision, 2I2 = 2 x int*2. # # # # If there are several consecutive variables on the same line, a reading loop must be done on incremented columns. # i= increment of the loop: (i=0,N) means i from 0 to N-1. # # N= Number of standard dates (= 6, 7 or 8) as a function of the circular # # # # Some parameters can change from one circular to another : # # - number of laboratoiries in all sections, # # - empty lines # # - notes For more details, contact tai@bipm.org # # # ################################################################################################################# +--------+-------------------+------------------------------------+------------+---------------------+---------+ |POSITION| LABEL | PARAMETER | FORMAT | COLUMNS | REMARK | |(Column)|( Use to | PARAMETER that can be extracted | (format of | (location of | | | |identify lines) | from the Circular T | parameter)| parameter) | | +--------+-------------------+------------------------------------+------------+---------------------+---------+ HEADER +--------+-------------------+------------------------------------+------------+---------------------+---------+ | 1: 8 |"CIRCULAR" | - Number of the Circular T | I3 | 12:14 | | |exist(X)|"h UTC" | - Date of publication: | A26 | 1:X+4 | (1) | | | | (YEAR,MONTH,DAY,HOUR) | | | | +--------+-------------------+------------------------------------+------------+---------------------+---------+ SECTION 1 +--------+-------------------+------------------------------------+------------+---------------------+---------+ | 1: 3 |"1 -" | #Beginning of Section 1# | | | | |exist(X)|"TAI-UTC =" | - Cumulation of leap seconds | I4 | X+9:X+12 | (1),(2) | | | | (TAI-UTC). | | | | | 1: 4 |"Date" | - Dates of reported data | A28 | 1:27 | | | 1: 4 |"Date" | - Standard dates (civil calendar) | N(A6) | 29+9i:34+9i |(i=0,N-1)| | 8:10 |"MJD" | - Standard MJDs | N(I5) | 30+9i:34+9i |(i=0,N-1)| | 8:10 |"MJD" | - Uncertainties type | 3A2 |31+9N+6i:32+9N+6i |(i=0,2) | | 6: 6 |"(" | - Labname, Location | A4,A21 | 1: 4, 6:26 | | | 6: 6 |"(" | - UTC-UTC(k) /block of 10 labs | N(F8.1) | 27+9i:34+9i |(i=0,N-1)| | 6: 6 |"(" | - Uncertainties | 3(F5.1) |28+9N+6i:32+9N+6i |(i=0,2) | | 6: 6 |"(" | - Notes code | A5 | 45+9N:49+9N | | | 1: 6 |"- Note" | - Notes on section 1 title | | | (3) | | | | - Notes on section 1 (lab+comm.) | A120 | 1:120 | | +--------+-------------------+------------------------------------+------------+---------------------+---------+ SECTION 2 +--------+-------------------+------------------------------------+------------+---------------------+---------+ | 1: 3 |"2 -" | #Beginning of Section 3# | | | | | 67:68 |"**" | - Dates of validity | 2I5 | 35:39,43:47 | (3lines)| | 67:68 |"**" | - f(EAL)-f(TAI) (E-13) | f11.3 | 53:63 | (3lines)| | 67:68 |"**" | - Date of validity | A25 | 77:103 | (3lines)| +--------+-------------------+------------------------------------+------------+---------------------+---------+ SECTION 3 +--------+-------------------+------------------------------------+------------+---------------------+---------+ | 1: 3 |"3 -" | #Beginning of Section 4# | | | | |109:109 |")" | - Standard name | A11 | 1:11 | | |109:109 |")" | - Period of estimation | 2I5 | 13:17, 19:23 | | |109:109 |")" | - d | f6.2 | 25:30 | | |109:109 |")" | - Uncertainties: | | | | | | | uA, uB | f6.2,f6.2 | 32:37, 39:44 | | | | | ul/Lab | f5.2 | 46:50 | | | | | ul/Tai | f6.2 | 52:57 | | | | | u | f7.2 | 59:65 | | | | | uS | f6.1 | 69:74 | | | | | Ref(uB) | A6 | 82:87 | | | | | uB(Ref) | f6.2 | 91:97 | | | | | Steer | A1 | 101:101 | | | | | Note code | A1 | 108:108 | | | | | - Notes on section 4 (lab+comm.) | A120 | 1:120 | | | 41:42, |"**","**" | - Period of estimation | I5,I5 | 17:21, 23:27 | | |& 57:58 | | - d (E-15) | f9.1 | 29:38 | | | 41:42, |"**","**" | - Uncertaintie (E-15) | f5.1 | 48:53 | | |& 57:58 | | - Date of validity (start) | I4,A3,I2 | 68:71, 73:75, 76:78 | | | | | - Date of validity (end) | I4,A3,I2 | 82:85, 87:89, 91:92 | | +--------+-------------------+------------------------------------+------------+---------------------+---------+ SECTION 4 +--------+-------------------+------------------------------------+------------+---------------------+---------+ | 1: 3 |"4 -" | #Beginning of Section 5# | | | | |exist(X)|"For this edition | | | | | | | of Circular" | - S0' | f4.1 | X+46:X+50 | (1) | |exist(X)|"For this edition | | | | | | | of Circular" | - S1' | f5.1 | X+71:X+75 | (1) | |exist(X)|"0h UTC" | - DATE (month day) | A3,I2 | 8:10, 12:13 | (4) | | | | - MJD | I5 | 17:21 | | | | | - C0'(/ns) | f8.1 | 23:30 | | | | | - N0' | I4 | 32:35 | | | | | - C1'(/ns) | f8.1 | 37:44 | | | | | - N1' | I4 | 46:49 | | +--------+-------------------+------------------------------------+------------+---------------------+---------+ SECTION 5 +--------+-------------------+------------------------------------+------------+---------------------+---------+ | 1: 3 |"5 -" | #Beginning of Section 6# | | | | | 5:5 |"/" | - Laboratory 1 | A4 | 1:4 | | | 5:5 |"/" | - Laboratory 2 | A4 | 6:9 | | | 5:5 |"/" | - TYPE: | A6 | 11:16 | | | | | "TWSTFT" Two-Way | | | | | | | "GPS MC" GPS Multi-Channel | | | | | | | "GPS SC" GPS Single-Channel | | | | | | | "GPS P3" GPS Mutli-Channel | | | | | | | Dual-Frequency | | | | | | | "GPSPPP" Precise Point Positioning| | | | | | | "GLN MC" Glonass Common-View | | | | | | | "INT LK" Internal Cable link | | | | | | | "GPS GT" GPS time observations | | | | | | | "TWGPPP" TWSTFT+PPP combination | | | | | | | "GPSGLN" GPS AV+GLONASS CV combi. | | | | | 5:5 |"/" | - Equipment 1 | A6 | 20:25 | | | 5:5 |"/" | - Equipment 2 | A6 | 27:32 | | | 5:5 |"/" | - Calibration ID 1 | A9 | 34:42 | | | 5:5 |"/" | - Calibration ID 2 | A9 | 44:52 | | | 5:5 |"/" | - uSTB : instability uncertainty | f6.1 | 54:59 | | | 5:5 |"/" | - uCAL : instability uncertainty | f6.1 | 63:68 | | | 5:5 |"/" | - uAge : ageing uncertainty | I4 | 70:73 | | | 5:5 |"/" | - BIPM alignment value | f8.1 | 75:82 | | | 5:5 |"/" | - Start YYMM of BIPM alignment | I4 | 84:87 | | +--------+-------------------+------------------------------------+------------+---------------------+---------+ (1) exist(X): means that the label is located in free position X (=1st letter position). (2) following leap second can be announced: in such case, there will be 2 labels: the first corresponding to the current value, and the second corresponding to future value. (3) parameters are into lines following the line containing the LABEL. (4) skip the line after the line of the label and read following line.