1PLCONFIGTIME(3plplot) PLplot API PLCONFIGTIME(3plplot)
2
6 plconfigtime - Configure the transformation between continuous and bro‐
7 ken-down time for the current stream
8
10 plconfigtime(scale, offset1, offset2, ccontrol, ifbtime_offset, year,
11 month, day, hour, min, sec)
12
14 Configure the transformation between continuous and broken-down time
15 for the current stream. This transformation is used by both plb‐
16 time(3plplot) and plctime(3plplot).
17 Redacted form: General: plconfigtime(scale, offset1, offset2, ccontrol,
19 ifbtime_offset, year, month, day, hour, min, sec) Perl/PDL: Not avail‐
20 able?
21 This function is used in example 29.
24
26 scale (PLFLT(3plplot), input)
27 The number of days per continuous time unit. As a special case,
28 if scale is 0., then all other arguments are ignored, and the
29 result (the default used by PLplot) is the equivalent of a call
30 to plconfigtime(1./86400., 0., 0., 0x0, 1, 1970, 0, 1, 0, 0,
31 0.). That is, for this special case broken-down time is calcu‐
32 lated with the proleptic Gregorian calendar with no leap seconds
33 inserted, and the continuous time is defined as the number of
34 seconds since the Unix epoch of 1970-01-01T00:00:00Z.
35 offset1 (PLFLT(3plplot), input)
37 If ifbtime_offset is true, the parameters offset1 and offset2
38 are completely ignored. Otherwise, the sum of these parameters
39 (with units in days) specify the epoch of the continuous time
40 relative to the MJD epoch corresponding to the Gregorian calen‐
41 dar date of 1858-11-17T00:00:00Z or JD = 2400000.5. Two PLFLT
42 numbers are used to specify the origin to allow users (by speci‐
43 fying offset1 as an integer that can be exactly represented by a
44 floating-point variable and specifying offset2 as a number in
45 the range from 0. to 1) the chance to minimize the numerical
46 errors of the continuous time representation.
47 offset2 (PLFLT(3plplot), input)
49 See documentation of offset1.
50 ccontrol (PLINT(3plplot), input)
52 ccontrol contains bits controlling the transformation. If the
53 0x1 bit is set, then the proleptic Julian calendar is used for
54 broken-down time rather than the proleptic Gregorian calendar.
55 If the 0x2 bit is set, then leap seconds that have been histori‐
56 cally used to define UTC are inserted into the broken-down time.
57 Other possibilities for additional control bits for ccontrol
58 exist such as making the historical time corrections in the bro‐
59 ken-down time corresponding to ET (ephemeris time) or making the
60 (slightly non-constant) corrections from international atomic
61 time (TAI) to what astronomers define as terrestrial time (TT).
62 But those additional possibilities have not been implemented yet
63 in the qsastime library (one of the PLplot utility libraries).
64 ifbtime_offset (PLBOOL(3plplot), input)
66 ifbtime_offset controls how the epoch of the continuous time
67 scale is specified by the user. If ifbtime_offset is false, then
68 offset1 and offset2 are used to specify the epoch, and the fol‐
69 lowing broken-down time parameters are completely ignored. If
70 ifbtime_offset is true, then offset1 and offset2 are completely
71 ignored, and the following broken-down time parameters are used
72 to specify the epoch.
73 year (PLINT(3plplot), input)
75 Year of epoch.
76 month (PLINT(3plplot), input)
78 Month of epoch in range from 0 (January) to 11 (December).
79 day (PLINT(3plplot), input)
81 Day of epoch in range from 1 to 31.
82 hour (PLINT(3plplot), input)
84 Hour of epoch in range from 0 to 23
85 min (PLINT(3plplot), input)
87 Minute of epoch in range from 0 to 59.
88 sec (PLFLT(3plplot), input)
90 Second of epoch in range from 0. to 60.
91
94 Many developers (who are credited at http://plplot.source‐
95 forge.net/credits.php) have contributed to PLplot over its long his‐
96 tory.
97
99 PLplot documentation at http://plplot.sourceforge.net/documenta‐
100 tion.php.
101 August, 2017 PLCONFIGTIME(3plplot)