README.md
1time - calgps
2=============
3
4This application generates a dual GPS and Julian calendar to either stdout or to a graphics
5file. The arguments and format are inspired by the UNIX ‘cal’ utility. With no arguments, the
6current argument is printed. The last and next month can also be printed. Also, the current
7or any given year can be printed.
8
9Usage:
10------
11
12### Optional Arguments
13
14Short Arg.| Long Arg.| Description
15
16 -h –help Generates help output.
17 -3 –three-months Prints a GPS calendar for the previous, current, and next month.
18 -y –year Prints a GPS calendar for the entire current year.
19 -Y –specific-year=NUM Prints a GPS calendar for the entire specified year.
20 -p –postscript=ARG Generates a postscript file.
21 -s –svg=ARG Generates an SVG file.
22 -e –eps=ARG Generates an encapsulated postscript file.
23 -v –view Try to launch an appropriate viewer for the file.
24 -n –no-blurb Suppress GPSTk reference in graphic output.
25
26Examples:
27---------
28
29 > calgps -3
30 Jun 2011
31 1638 1-152 2-153 3-154 4-155
32 1639 5-156 6-157 7-158 8-159 9-160 10-161 11-162
33 1640 12-163 13-164 14-165 15-166 16-167 17-168 18-169
34 1641 19-170 20-171 21-172 22-173 23-174 24-175 25-176
35 1642 26-177 27-178 28-179 29-180 30-181
36 Jul 2011
37 1642 1-182 2-183
38 1643 3-184 4-185 5-186 6-187 7-188 8-189 9-190
39 1644 10-191 11-192 12-193 13-194 14-195 15-196 16-197
40 1645 17-198 18-199 19-200 20-201 21-202 22-203 23-204
41 1646 24-205 25-206 26-207 27-208 28-209 29-210 30-211
42 1647 31-212
43 . . .
44
45Notes:
46---------
47
48If multiple options are given only the first is considered.
49
50
51
52-----------------------------------------------------------------------------------------------------------------------
53
54time - timeconvert
55==================
56
57This application allows the user to convert between time formats associated with GPS. Time
58formats include: civilian time, Julian day of year and year, GPS week and seconds of week, Z
59counts, and Modified Julian Date (MJD).
60
61Usage:
62------
63
64### Optional Arguments
65
66Short Arg.| Long Arg.| Description
67
68 -d –debug Increase debug level.
69 -v –verbose Increase verbosity.
70 -h –help Print help usage.
71 -A –ansi=TIME “ANSI-Second”.
72 -c –civil=TIME “Month(numeric) DayOfMonth Year Hour:Minute:Second
73 -R –rinex-file=TIME “Year(2-digit) Month(numeric) DayOfMonth Hour Minute Second”.
74 -o –ews=TIME “GPSEpoch 10bitGPSweek SecondOfWeek”.
75 -f –ws=TIME “FullGPSWeek SecondOfWeek”.
76 -w –wz=TIME “FullGPSWeek Zcount”.
77 –z29=TIME “29bitZcount”.
78 -Z –z32=TIME “32bitZcount”.
79 -j –julian=TIME “JulianDate”.
80 -m –mjd=TIME “ModifiedJulianDate”.
81 -u –unixtime=TIME “UnixSeconds UnixMicroseconds”.
82 -y –doy=TIME “Year DayOfYear SecondsOfDay”.
83 –input-format=ARG Time format to use on input.
84 –input-time=ARG Time to be parsed by ”input-format” option.
85 -F –format=ARG Time format to use on output.
86 -a –add-offset=NUM Add NUM seconds to specified time.
87 -s –sub-offset=NUM Subtract NUM seconds from specified time.
88
89Examples:
90---------
91
92Convert RINEX file time.
93
94 > timeconvert -R "05 06 1985 13:50:02"
95 Month/Day/Year H:M:S 11/06/2010 13:00:00
96 Modified Julian Date 55506.541666667
97 GPSweek DayOfWeek SecOfWeek 584 6 565200.000000
98 FullGPSweek Zcount 1608 376800
99 Year DayOfYear SecondOfDay 2010 310 46800.000000
100 Unix: Second Microsecond 1289048400 0
101 Zcount: 29-bit (32-bit) 306560992 (843431904)
102 Convert ews time.
103 timeconvert -o "01 1379 500"
104 Month/Day/Year 1/25/2026
105 Hour:Min:Sec 00:08:20
106 Modified Julian Date 61065.005787037
107 GPSweek DayOfWeek SecOfWeek 355 0 500.000000
108 FullGPSweek Zcount 2403 333
109 Year DayOfYear SecondOfDay 2026 25 500.000000
110 Unix_sec Unix_usec 1769299700 0
111 Zcount: 29-bit (32-bit) 186122573 (1259864397)
112
113Notes:
114---------
115
116If no arguments are given it will convert the current time to all