tec-suite is a command line tool. There is an executable named
tecs.exe) you should invoke to make work done.
In general, the command line looks like:
tecs [-v] [-c config_file] [--save-coordinates]
All the arguments are optional.
- Use the given config file instead of
- Print the version and exit.
- Save the coordinates of the sites found in
coordinates.txt. TEC values are not calculated, the file is saved in a directory which contains configuration file.
The configuration file contains a set of variables that affect the
tecs behaviour. If not set explicitly with
will look for
tecs.cfg in the working dir.
The syntax is simple; white-spaces are ignored, the
# symbol begins
comment to the end of the line, blank lines are ignored. All other
lines are identified as setting variables, in the form
value. The variable names are case sensitive.
obsDirdir [, dir, …]
- Directory with the RINEX observation files. It can contain a list of the directories separated by a comma.
navDirdir [, dir, …]
- Directory with the RINEX navigation files. It can contain a list of the directories separated by a comma.
- Output directory; output files will be saved in it.
- Output file format. The only one format available by now, and it
outFileMode = text). Output data will be saved in multicolumn text files. The set and the order of data columns are defined by the
- Set and order of output file columns. A complete list of the columns (“fields”) is given in the Output file section.
- Date/time format in output file; see the Date/time section for details.
- Interval in seconds to pick values from an observation
file. Values of TEC, azimuth and elevation will be calculated with
the interval. In case of
samplingInterval = 0all the data will be read.
navPriorityGPSsite1, site2, …, siteN
- Priority of search of navigation files for GPS. Here, site is a
4-symbol code of the station (the first 4 symbols of RINEX file
tecssearches for site1 navigation file. If it does not find it, it searches for site2 file and so on to siteN. If
tecsdoes not find any navigation file from the list, it takes the first available file.
navPriorityGLOsite1, site2, …, siteN
- It is an analogue of
navPriorityGEOsite1, site2, …, siteN
- It is an analogue of
True, absence of navigation files for all satellite systems besides GLONASS is ignored. The values of elevation and azimuth are not calculated and are written as
0. Note that for GLONASS the navigation file is required to calculate frequencies.
- Sets the logging level.
ERRORis usually enough.
The results are written into multicolumn text files. The name of an output file is formed as follows:
site - site name, S - satellite system identifier, N - satellite number, DDD - day of the year, YY - year without century.
The order and the set of the output record fields are set by the
recFields variable. The
recFields value is a single quoted
string which contains field names separated by a comma. For example,
recFields = 'datetime, el, az, tec.l1l2, tec.p1p2'
The following is the list of TEC reconstruction variants, which values can be written into an output file.
|tec.p1p2||TEC value reconstructed using pseudorange P1 and P2 values|
|tec.c1p2||The same but using C1 and P2 values|
|tec.c1c2||The same but using C1 and C2 values|
|tec.c1c5||The same but using C1 and C5 values|
|tec.c2c5||The same but using C2 and C5 values|
|tec.c2c6||The same but using C2 and C6 values|
|tec.c2c7||The same but using C2 and C7 values|
|tec.c6c7||The same but using C6 and C7 values|
|tec.l1l2||TEC value reconstructed using phase L1 and L2 values|
|tec.l1l5||The same but using L1 and L2 values|
|tec.l2l5||The same but using L2 and L5 values|
|tec.l2l6||The same but using L2 and L6 values|
|tec.l2l7||The same but using L2 and L7 values|
|tec.l6l7||The same but using L6 and L7 values|
|tec.l1c1||TEC value reconstructed using phase L1 and pseudorange C1 values|
|tec.l2c2||TEC value reconstructed using phase L2 and pseudorange C2 values|
The following is the list of other fields which can be inserted
|Date and time|
|tsn||Time of the observation , where - number of seconds from the beginning of the day, - the observation interval in seconds.|
|hour||Time of the observation in fractions of an hour.|
|datetime||Date and time of the observation. You can control date/time string
|site.x||Geocentric coordinate of a receiver.|
|site.y||Geocentric coordinate of a receiver.|
|site.z||Geocentric coordinate of a receiver.|
|site.l||Geographic longitude of a receiver.|
|site.b||Geographic latitude of a receiver.|
|site.h||Altitude of a receiver.|
|sat.x||Geocentric coordinate of a satellite.|
|sat.y||Geocentric coordinate of a satellite.|
|sat.z||Geocentric coordinate of a satellite.|
|el||Elevation to a satellite.|
|az||Azimuth to a satellite.|
|p1||P1 pseudorange value.|
|p2||P2 pseudorange value.|
|l1||L1 carrier phase value.|
|l2||L2 carrier phase value.|
|l5||L5 carrier phase value.|
|s1||S1 raw signal strength value.|
|s2||S2 raw signal strength value.|
|s5||S5 raw signal strength value.|
|c1||С1 pseudorange value.|
|c2||С2 pseudorange value.|
|c5||C5 pseudorange value.|
|p1.lli||P1 Loss of Lock Indicator (LLI) value.|
datetimeFormat variable one can set the format of the
datetime field which will be written into an output file. Note
datetime field should be put into the
datetimeFormat string can include:
- any printable character;
- date/time codes (according to the С standard 1989 version).
%Y-%m-%d %H:%M:%S corresponds to
The following is the list of codes.
|%a||Weekday as locale’s abbreviated name.|
|%A||Weekday as locale’s full name.|
|%w||Weekday as a decimal number, where 0 is Sunday and 6 is Saturday.|
|%d||Day of the month as a zero-padded decimal number.|
|%b||Month as locale’s abbreviated name.|
|%B||Month as locale’s full name.|
|%m||Month as a zero-padded decimal number.|
|%y||Year without century as a zero-padded decimal number.|
|%Y||Year with century as a decimal number.|
|%H||Hour (24-hour clock) as a zero-padded decimal number.|
|%I||Hour (12-hour clock) as a zero-padded decimal number.|
|%p||Locale’s equivalent of either AM or PM.|
|%M||Minute as a zero-padded decimal number.|
|%S||Second as a zero-padded decimal number.|
|%f||Microsecond as a decimal number, zero-padded on the left.|
|%z||UTC offset in the form +HHMM or -HHMM (empty string if the object is naive).|
|%Z||Time zone name (empty string if the object is naive).|
|%j||Day of the year as a zero-padded decimal number.|
|%U||Week number of the year (Sunday as the first day of the week) as a zero padded decimal number. All days in a new year preceding the first Sunday are considered to be in week 0.|
|%W||Week number of the year (Monday as the first day of the week) as a decimal number. All days in a new year preceding the first Monday are considered to be in week 0.|
|%c||Locale’s appropriate date and time representation.|
|%x||Locale’s appropriate date representation.|
|%X||Locale’s appropriate time representation.|
|%%||A literal ‘%’ character.|