From ef4284159274ba9ff7b643746c5b40efc30e8abe Mon Sep 17 00:00:00 2001 From: Don Cross Date: Wed, 14 Apr 2021 06:41:24 -0400 Subject: [PATCH] PY: Finished implementation of JupiterMoons function. --- demo/browser/astronomy.browser.js | 2 +- demo/nodejs/astronomy.js | 2 +- demo/python/astronomy.py | 376 ++- generate/codegen.c | 42 +- generate/template/astronomy.py | 243 +- generate/template/astronomy.ts | 2 +- generate/test.py | 84 + source/js/README.md | 2 +- source/js/astronomy.browser.js | 2 +- source/js/astronomy.d.ts | 2 +- source/js/astronomy.js | 2 +- source/js/astronomy.ts | 2 +- source/js/esm/astronomy.js | 2 +- source/python/README.md | 96 + source/python/astronomy.py | 376 ++- website/src/assets/documentation.json | 3816 ++++++++++++------------- 16 files changed, 3126 insertions(+), 1925 deletions(-) diff --git a/demo/browser/astronomy.browser.js b/demo/browser/astronomy.browser.js index 523a089e..906cc787 100644 --- a/demo/browser/astronomy.browser.js +++ b/demo/browser/astronomy.browser.js @@ -2957,7 +2957,7 @@ function CalcJupiterMoon(time, m) { * add the jovicentric vectors. Likewise, you can call {@link GeoVector} * to convert to geocentric vectors. * - * @param {FlexibleDateTime} date The date and time for which to calculate the position vectors. + * @param {FlexibleDateTime} date The date and time for which to calculate Jupiter's moons. * @return {JupiterMoonsInfo} Position and velocity vectors of Jupiter's largest 4 moons. */ function JupiterMoons(date) { diff --git a/demo/nodejs/astronomy.js b/demo/nodejs/astronomy.js index 8baf20c0..1566e861 100644 --- a/demo/nodejs/astronomy.js +++ b/demo/nodejs/astronomy.js @@ -2956,7 +2956,7 @@ function CalcJupiterMoon(time, m) { * add the jovicentric vectors. Likewise, you can call {@link GeoVector} * to convert to geocentric vectors. * - * @param {FlexibleDateTime} date The date and time for which to calculate the position vectors. + * @param {FlexibleDateTime} date The date and time for which to calculate Jupiter's moons. * @return {JupiterMoonsInfo} Position and velocity vectors of Jupiter's largest 4 moons. */ function JupiterMoons(date) { diff --git a/demo/python/astronomy.py b/demo/python/astronomy.py index cd5553e6..2a5259ff 100644 --- a/demo/python/astronomy.py +++ b/demo/python/astronomy.py @@ -155,6 +155,50 @@ class Vector: """Returns the length of the vector in AU.""" return math.sqrt(self.x**2 + self.y**2 + self.z**2) +class StateVector: + """A combination of a position vector, a velocity vector, and a time. + + The position (x, y, z) is measured in astronomical units (AU). + The velocity (vx, vy, vz) is measured in AU/day. + The coordinate system varies and depends on context. + The state vector also includes a time stamp. + + Attributes + ---------- + x : float + The x-coordinate of the position, measured in AU. + y : float + The y-coordinate of the position, measured in AU. + z : float + The z-coordinate of the position, measured in AU. + vx : float + The x-component of the velocity, measured in AU/day. + vy : float + The y-component of the velocity, measured in AU/day. + vz : float + The z-component of the velocity, measured in AU/day. + t : Time + The date and time at which the position and velocity vectors are valid. + """ + def __init__(self, x, y, z, vx, vy, vz, t): + self.x = x + self.y = y + self.z = z + self.vx = vx + self.vy = vy + self.vz = vz + self.t = t + + def __repr__(self): + return 'StateVector[pos=({}, {}, {}), vel=({}, {}, {}), t{}]'.format( + self.x, self.y, self.z, + self.vx, self.vy, self.vz, + str(self.t)) + + def __str__(self): + return '({}, {}, {}, {}, {}, {}, {})'.format(self.x, self.y, self.z, self.vx, self.vy, self.vz, str(self.t)) + + @enum.unique class Body(enum.Enum): """The celestial bodies supported by Astronomy Engine calculations. @@ -411,6 +455,20 @@ _DeltaT = DeltaT_EspenakMeeus def _TerrestrialTime(ut): return ut + _DeltaT(ut) / 86400.0 +def _UniversalTime(tt): + # This is the inverse function of _TerrestrialTime. + # This is an iterative numerical solver, but because + # the relationship between UT and TT is almost perfectly linear, + # it converges extremely fast (never more than 3 iterations). + dt = _TerrestrialTime(tt) - tt # first approximation of dt = tt - ut + while True: + ut = tt - dt + tt_check = _TerrestrialTime(ut) + err = tt_check - tt + if abs(err) < 1.0e-12: + return ut + dt += err + _TimeRegex = re.compile(r'^([0-9]{1,4})-([0-9]{2})-([0-9]{2})(T([0-9]{2}):([0-9]{2})(:([0-9]{2}(\.[0-9]+)?))?Z)?$') class Time: @@ -457,11 +515,28 @@ class Time: such as the orbits of planets around the Sun, or the Moon around the Earth. Historically, Terrestrial Time has also been known by the term *Ephemeris Time* (ET). """ - def __init__(self, ut): + def __init__(self, ut, tt = None): self.ut = ut - self.tt = _TerrestrialTime(ut) + if tt is None: + self.tt = _TerrestrialTime(ut) + else: + self.tt = tt self.etilt = None + @staticmethod + def FromTerrestrialTime(tt): + """Creates a #Time object from a Terrestrial Time day value. + + Parameters + ---------- + tt : The number of days after the J2000 epoch. + + Returns + ------- + Time + """ + return Time(_UniversalTime(tt), tt) + @staticmethod def Parse(text): """Creates a #Time object from a string of the form 'yyyy-mm-ddThh:mm:ss.sssZ' @@ -3396,6 +3471,273 @@ def _CalcPluto(time): # END Pluto Integrator #---------------------------------------------------------------------------- +# BEGIN Jupiter Moons + +_Rotation_JUP_EQJ = RotationMatrix([ + [ 9.9943276533865444e-01, -3.3677107469764142e-02, 0.0000000000000000e+00 ], + [ 3.0395942890628476e-02, 9.0205791235280897e-01, 4.3054338854229507e-01 ], + [ -1.4499455966335291e-02, -4.3029916940910073e-01, 9.0256988127375404e-01 ] +]) + +_JupiterMoonModel = [ + # [0] Io + [ + 2.8248942843381399e-07, 1.4462132960212239e+00, 3.5515522861824000e+00, # mu, al0, al1 + [ # a + [ 0.0028210960212903, 0.0000000000000000e+00, 0.0000000000000000e+00 ] + ], + [ # l + [ -0.0001925258348666, 4.9369589722644998e+00, 1.3584836583050000e-02 ], + [ -0.0000970803596076, 4.3188796477322002e+00, 1.3034138432430000e-02 ], + [ -0.0000898817416500, 1.9080016428616999e+00, 3.0506486715799999e-03 ], + [ -0.0000553101050262, 1.4936156681568999e+00, 1.2938928911549999e-02 ] + ], + [ # z + [ 0.0041510849668155, 4.0899396355450000e+00, -1.2906864146660001e-02 ], + [ 0.0006260521444113, 1.4461888986270000e+00, 3.5515522949801999e+00 ], + [ 0.0000352747346169, 2.1256287034577999e+00, 1.2727416566999999e-04 ] + ], + [ # zeta + [ 0.0003142172466014, 2.7964219722923001e+00, -2.3150960980000000e-03 ], + [ 0.0000904169207946, 1.0477061879627001e+00, -5.6920638196000003e-04 ] + ] + ], + + # [1] Europa + [ + 2.8248327439289299e-07, -3.7352634374713622e-01, 1.7693227111234699e+00, # mu, al0, al1 + [ # a + [ 0.0044871037804314, 0.0000000000000000e+00, 0.0000000000000000e+00 ], + [ 0.0000004324367498, 1.8196456062910000e+00, 1.7822295777568000e+00 ] + ], + [ # l + [ 0.0008576433172936, 4.3188693178264002e+00, 1.3034138308049999e-02 ], + [ 0.0004549582875086, 1.4936531751079001e+00, 1.2938928819619999e-02 ], + [ 0.0003248939825174, 1.8196494533458001e+00, 1.7822295777568000e+00 ], + [ -0.0003074250079334, 4.9377037005910998e+00, 1.3584832867240000e-02 ], + [ 0.0001982386144784, 1.9079869054759999e+00, 3.0510121286900001e-03 ], + [ 0.0001834063551804, 2.1402853388529000e+00, 1.4500978933800000e-03 ], + [ -0.0001434383188452, 5.6222140366630002e+00, 8.9111478887838003e-01 ], + [ -0.0000771939140944, 4.3002724372349999e+00, 2.6733443704265998e+00 ] + ], + [ # z + [ -0.0093589104136341, 4.0899396509038999e+00, -1.2906864146660001e-02 ], + [ 0.0002988994545555, 5.9097265185595003e+00, 1.7693227079461999e+00 ], + [ 0.0002139036390350, 2.1256289300016000e+00, 1.2727418406999999e-04 ], + [ 0.0001980963564781, 2.7435168292649998e+00, 6.7797343008999997e-04 ], + [ 0.0001210388158965, 5.5839943711203004e+00, 3.2056614899999997e-05 ], + [ 0.0000837042048393, 1.6094538368039000e+00, -9.0402165808846002e-01 ], + [ 0.0000823525166369, 1.4461887708689001e+00, 3.5515522949801999e+00 ] + ], + [ # zeta + [ 0.0040404917832303, 1.0477063169425000e+00, -5.6920640539999997e-04 ], + [ 0.0002200421034564, 3.3368857864364001e+00, -1.2491307306999999e-04 ], + [ 0.0001662544744719, 2.4134862374710999e+00, 0.0000000000000000e+00 ], + [ 0.0000590282470983, 5.9719930968366004e+00, -3.0561602250000000e-05 ] + ] + ], + + # [2] Ganymede + [ + 2.8249818418472298e-07, 2.8740893911433479e-01, 8.7820792358932798e-01, # mu, al0, al1 + [ # a + [ 0.0071566594572575, 0.0000000000000000e+00, 0.0000000000000000e+00 ], + [ 0.0000013930299110, 1.1586745884981000e+00, 2.6733443704265998e+00 ] + ], + [ # l + [ 0.0002310797886226, 2.1402987195941998e+00, 1.4500978438400001e-03 ], + [ -0.0001828635964118, 4.3188672736968003e+00, 1.3034138282630000e-02 ], + [ 0.0001512378778204, 4.9373102372298003e+00, 1.3584834812520000e-02 ], + [ -0.0001163720969778, 4.3002659861490002e+00, 2.6733443704265998e+00 ], + [ -0.0000955478069846, 1.4936612842567001e+00, 1.2938928798570001e-02 ], + [ 0.0000815246854464, 5.6222137132535002e+00, 8.9111478887838003e-01 ], + [ -0.0000801219679602, 1.2995922951532000e+00, 1.0034433456728999e+00 ], + [ -0.0000607017260182, 6.4978769669238001e-01, 5.0172167043264004e-01 ] + ], + [ # z + [ 0.0014289811307319, 2.1256295942738999e+00, 1.2727413029000001e-04 ], + [ 0.0007710931226760, 5.5836330003496002e+00, 3.2064341100000001e-05 ], + [ 0.0005925911780766, 4.0899396636447998e+00, -1.2906864146660001e-02 ], + [ 0.0002045597496146, 5.2713683670371996e+00, -1.2523544076106000e-01 ], + [ 0.0001785118648258, 2.8743156721063001e-01, 8.7820792442520001e-01 ], + [ 0.0001131999784893, 1.4462127277818000e+00, 3.5515522949801999e+00 ], + [ -0.0000658778169210, 2.2702423990985001e+00, -1.7951364394536999e+00 ], + [ 0.0000497058888328, 5.9096792204858000e+00, 1.7693227129285001e+00 ] + ], + [ # zeta + [ 0.0015932721570848, 3.3368862796665000e+00, -1.2491307058000000e-04 ], + [ 0.0008533093128905, 2.4133881688166001e+00, 0.0000000000000000e+00 ], + [ 0.0003513347911037, 5.9720789850126996e+00, -3.0561017709999999e-05 ], + [ -0.0001441929255483, 1.0477061764435001e+00, -5.6920632124000004e-04 ] + ] + ], + + # [3] Callisto + [ + 2.8249214488990899e-07, -3.6203412913757038e-01, 3.7648623343382798e-01, # mu, al0, al1 + [ # a + [ 0.0125879701715314, 0.0000000000000000e+00, 0.0000000000000000e+00 ], + [ 0.0000035952049470, 6.4965776007116005e-01, 5.0172168165034003e-01 ], + [ 0.0000027580210652, 1.8084235781510001e+00, 3.1750660413359002e+00 ] + ], + [ # l + [ 0.0005586040123824, 2.1404207189814999e+00, 1.4500979323100001e-03 ], + [ -0.0003805813868176, 2.7358844897852999e+00, 2.9729650620000000e-05 ], + [ 0.0002205152863262, 6.4979652596399995e-01, 5.0172167243580001e-01 ], + [ 0.0001877895151158, 1.8084787604004999e+00, 3.1750660413359002e+00 ], + [ 0.0000766916975242, 6.2720114319754998e+00, 1.3928364636651001e+00 ], + [ 0.0000747056855106, 1.2995916202344000e+00, 1.0034433456728999e+00 ] + ], + [ # z + [ 0.0073755808467977, 5.5836071576083999e+00, 3.2065099140000001e-05 ], + [ 0.0002065924169942, 5.9209831565786004e+00, 3.7648624194703001e-01 ], + [ 0.0001589869764021, 2.8744006242622999e-01, 8.7820792442520001e-01 ], + [ -0.0001561131605348, 2.1257397865089001e+00, 1.2727441285000001e-04 ], + [ 0.0001486043380971, 1.4462134301023000e+00, 3.5515522949801999e+00 ], + [ 0.0000635073108731, 5.9096803285953996e+00, 1.7693227129285001e+00 ], + [ 0.0000599351698525, 4.1125517584797997e+00, -2.7985797954588998e+00 ], + [ 0.0000540660842731, 5.5390350845569003e+00, 2.8683408228299999e-03 ], + [ -0.0000489596900866, 4.6218149483337996e+00, -6.2695712529518999e-01 ] + ], + [ # zeta + [ 0.0038422977898495, 2.4133922085556998e+00, 0.0000000000000000e+00 ], + [ 0.0022453891791894, 5.9721736773277003e+00, -3.0561255249999997e-05 ], + [ -0.0002604479450559, 3.3368746306408998e+00, -1.2491309972000001e-04 ], + [ 0.0000332112143230, 5.5604137742336999e+00, 2.9003768850700000e-03 ] + ] + ] +] + +class JupiterMoonsInfo: + """Holds the positions and velocities of Jupiter's major 4 moons. + + The #JupiterMoons function returns an object of this type + to report position and velocity vectors for Jupiter's largest 4 moons + Io, Europa, Ganymede, and Callisto. Each position vector is relative + to the center of Jupiter. Both position and velocity are oriented in + the EQJ system (that is, using Earth's equator at the J2000 epoch). + The positions are expressed in astronomical units (AU), + and the velocities in AU/day. + + Attributes + ---------- + moon : StateVector[4] + An array of state vectors, one for each of the four major moons + of Jupiter, in the following order: 0=Io, 1=Europa, 2=Ganymede, 3=Callisto. + """ + def __init__(self, moon): + self.moon = moon + + +def _JupiterMoon_elem2pv(time, mu, A, AL, K, H, Q, P): + # Translation of FORTRAN subroutine ELEM2PV from: + # https://ftp.imcce.fr/pub/ephem/satel/galilean/L1/L1.2/ + AN = math.sqrt(mu / (A*A*A)) + EE = AL + K*math.sin(AL) - H*math.cos(AL) + DE = 1 + while abs(DE) >= 1.0e-12: + CE = math.cos(EE) + SE = math.sin(EE) + DE = (AL - EE + K*SE - H*CE) / (1.0 - K*CE - H*SE) + EE += DE + CE = math.cos(EE) + SE = math.sin(EE) + DLE = H*CE - K*SE + RSAM1 = -K*CE - H*SE + ASR = 1.0/(1.0 + RSAM1) + PHI = math.sqrt(1.0 - K*K - H*H) + PSI = 1.0/(1.0 + PHI) + X1 = A*(CE - K - PSI*H*DLE) + Y1 = A*(SE - H + PSI*K*DLE) + VX1 = AN*ASR*A*(-SE - PSI*H*RSAM1) + VY1 = AN*ASR*A*(+CE + PSI*K*RSAM1) + F2 = 2.0*math.sqrt(1.0 - Q*Q - P*P) + P2 = 1.0 - 2.0*P*P + Q2 = 1.0 - 2.0*Q*Q + PQ = 2.0*P*Q + return StateVector( + X1*P2 + Y1*PQ, + X1*PQ + Y1*Q2, + (Q*Y1 - X1*P)*F2, + VX1*P2 + VY1*PQ, + VX1*PQ + VY1*Q2, + (Q*VY1 - VX1*P)*F2, + time + ) + + +def _CalcJupiterMoon(time, mu, al0, al1, a, l, z, zeta): + # This is a translation of FORTRAN code by Duriez, Lainey, and Vienne: + # https://ftp.imcce.fr/pub/ephem/satel/galilean/L1/L1.2/ + + t = time.tt + 18262.5 # number of days since 1950-01-01T00:00:00Z + + # Calculate 6 orbital elements at the given time t. + elem0 = 0.0 + for (amplitude, phase, frequency) in a: + elem0 += amplitude * math.cos(phase + (t * frequency)) + + elem1 = al0 + (t * al1) + for (amplitude, phase, frequency) in l: + elem1 += amplitude * math.sin(phase + (t * frequency)) + + elem1 = math.fmod(elem1, _PI2) + if elem1 < 0: + elem1 += _PI2 + + elem2 = 0.0 + elem3 = 0.0 + for (amplitude, phase, frequency) in z: + arg = phase + (t * frequency) + elem2 += amplitude * math.cos(arg) + elem3 += amplitude * math.sin(arg) + + elem4 = 0.0 + elem5 = 0.0 + for (amplitude, phase, frequency) in zeta: + arg = phase + (t * frequency) + elem4 += amplitude * math.cos(arg) + elem5 += amplitude * math.sin(arg) + + # Convert the oribital elements into position vectors in the Jupiter equatorial system (JUP). + state = _JupiterMoon_elem2pv(time, mu, elem0, elem1, elem2, elem3, elem4, elem5) + + # Re-orient position and velocity vectors from Jupiter-equatorial (JUP) to Earth-equatorial in J2000 (EQJ). + return RotateState(_Rotation_JUP_EQJ, state) + + +def JupiterMoons(time): + """Calculates jovicentric positions and velocities of Jupiter's largest 4 moons. + + Calculates position and velocity vectors for Jupiter's moons + Io, Europa, Ganymede, and Callisto, at the given date and time. + The vectors are jovicentric (relative to the center of Jupiter). + Their orientation is the Earth's equatorial system at the J2000 epoch (EQJ). + The position components are expressed in astronomical units (AU), and the + velocity components are in AU/day. + + To convert to heliocentric vectors, call #HelioVector + with `Body.Jupiter` to get Jupiter's heliocentric position, then + add the jovicentric vectors. Likewise, you can call #GeoVector + to convert to geocentric vectors. + + Parameters + ---------- + time : Time + The date and time for which to calculate Jupiter's moons. + + Returns + ------- + JupiterMoonsInfo + The positions and velocities of Jupiter's 4 largest moons. + """ + infolist = [] + for (mu, al0, al1, a, l, z, zeta) in _JupiterMoonModel: + infolist.append(_CalcJupiterMoon(time, mu, al0, al1, a, l, z, zeta)) + return JupiterMoonsInfo(infolist) + +# END Jupiter Moons +#---------------------------------------------------------------------------- # BEGIN Search def _QuadInterp(tm, dt, fa, fm, fb): @@ -6076,6 +6418,36 @@ def RotateVector(rotation, vector): ) +def RotateState(rotation, state): + """Applies a rotation to a state vector, yielding a rotated state vector. + + This function transforms a state vector in one orientation to a + state vector in another orientation. Both the position and velocity + vectors are rotated the same way. + + Parameters + ---------- + rotation : RotationMatrix + A rotation matrix that specifies how the orientation of the vector is to be changed. + state : StateVector + The state vector whose orientation is to be changed. + + Returns + ------- + StateVector + A state vector in the orientation specified by `rotation`. + """ + return StateVector( + rotation.rot[0][0]*state.x + rotation.rot[1][0]*state.y + rotation.rot[2][0]*state.z, + rotation.rot[0][1]*state.x + rotation.rot[1][1]*state.y + rotation.rot[2][1]*state.z, + rotation.rot[0][2]*state.x + rotation.rot[1][2]*state.y + rotation.rot[2][2]*state.z, + rotation.rot[0][0]*state.vx + rotation.rot[1][0]*state.vy + rotation.rot[2][0]*state.vz, + rotation.rot[0][1]*state.vx + rotation.rot[1][1]*state.vy + rotation.rot[2][1]*state.vz, + rotation.rot[0][2]*state.vx + rotation.rot[1][2]*state.vy + rotation.rot[2][2]*state.vz, + state.t + ) + + def Rotation_EQJ_ECL(): """Calculates a rotation matrix from equatorial J2000 (EQJ) to ecliptic J2000 (ECL). diff --git a/generate/codegen.c b/generate/codegen.c index 55725f8c..abc136bf 100644 --- a/generate/codegen.c +++ b/generate/codegen.c @@ -1755,8 +1755,46 @@ static int JupiterMoons_JS(cg_context_t *context, const jupiter_moon_model_t *mo static int JupiterMoons_Python(cg_context_t *context, const jupiter_moon_model_t *model) { - (void)model; - return LogError(context, "JupiterMoons_Python: NOT YET IMPLEMENTED.\n"); + int mindex, var, i; + vsop_series_t series[4]; + const char *moon_name[] = { "Io", "Europa", "Ganymede", "Callisto" }; + const char *var_name[] = { "a", "l", "z", "zeta" }; + + fprintf(context->outfile, "_Rotation_JUP_EQJ = RotationMatrix([\n"); + fprintf(context->outfile, " [ %23.16le, %23.16le, %23.16le ],\n", model->rot[0][0], model->rot[0][1], model->rot[0][2]); + fprintf(context->outfile, " [ %23.16le, %23.16le, %23.16le ],\n", model->rot[1][0], model->rot[1][1], model->rot[1][2]); + fprintf(context->outfile, " [ %23.16le, %23.16le, %23.16le ]\n", model->rot[2][0], model->rot[2][1], model->rot[2][2]); + fprintf(context->outfile, "])\n\n"); + + fprintf(context->outfile, "_JupiterMoonModel = [\n"); + for (mindex = 0; mindex < NUM_JUPITER_MOONS; ++mindex) + { + series[0] = model->moon[mindex].a; + series[1] = model->moon[mindex].l; + series[2] = model->moon[mindex].z; + series[3] = model->moon[mindex].zeta; + fprintf(context->outfile, " # [%d] %s\n", mindex, moon_name[mindex]); + fprintf(context->outfile, " [\n"); + fprintf(context->outfile, " %23.16le, %23.16le, %23.16le, # mu, al0, al1\n", model->moon[mindex].mu, model->moon[mindex].al[0], model->moon[mindex].al[1]); + for (var = 0; var < NUM_JM_VARS; ++var) + { + int nterms = series[var].nterms_total; + fprintf(context->outfile, " [ # %s\n", var_name[var]); + for (i = 0; i < nterms; ++i) + { + const vsop_term_t *term = &series[var].term[i]; + fprintf(context->outfile, " [ %19.16lf, %23.16le, %23.16le ]%s\n", + term->amplitude, + term->phase, + term->frequency, + (i+1 < nterms) ? "," : ""); + } + fprintf(context->outfile, " ]%s\n", ((var+1 < NUM_JM_VARS) ? "," : "")); + } + fprintf(context->outfile, " ]%s\n", ((mindex+1 < NUM_JUPITER_MOONS) ? ",\n" : "")); + } + fprintf(context->outfile, "]"); + return 0; } diff --git a/generate/template/astronomy.py b/generate/template/astronomy.py index b8dd245f..a01f75a6 100644 --- a/generate/template/astronomy.py +++ b/generate/template/astronomy.py @@ -155,6 +155,50 @@ class Vector: """Returns the length of the vector in AU.""" return math.sqrt(self.x**2 + self.y**2 + self.z**2) +class StateVector: + """A combination of a position vector, a velocity vector, and a time. + + The position (x, y, z) is measured in astronomical units (AU). + The velocity (vx, vy, vz) is measured in AU/day. + The coordinate system varies and depends on context. + The state vector also includes a time stamp. + + Attributes + ---------- + x : float + The x-coordinate of the position, measured in AU. + y : float + The y-coordinate of the position, measured in AU. + z : float + The z-coordinate of the position, measured in AU. + vx : float + The x-component of the velocity, measured in AU/day. + vy : float + The y-component of the velocity, measured in AU/day. + vz : float + The z-component of the velocity, measured in AU/day. + t : Time + The date and time at which the position and velocity vectors are valid. + """ + def __init__(self, x, y, z, vx, vy, vz, t): + self.x = x + self.y = y + self.z = z + self.vx = vx + self.vy = vy + self.vz = vz + self.t = t + + def __repr__(self): + return 'StateVector[pos=({}, {}, {}), vel=({}, {}, {}), t{}]'.format( + self.x, self.y, self.z, + self.vx, self.vy, self.vz, + str(self.t)) + + def __str__(self): + return '({}, {}, {}, {}, {}, {}, {})'.format(self.x, self.y, self.z, self.vx, self.vy, self.vz, str(self.t)) + + @enum.unique class Body(enum.Enum): """The celestial bodies supported by Astronomy Engine calculations. @@ -411,6 +455,20 @@ _DeltaT = DeltaT_EspenakMeeus def _TerrestrialTime(ut): return ut + _DeltaT(ut) / 86400.0 +def _UniversalTime(tt): + # This is the inverse function of _TerrestrialTime. + # This is an iterative numerical solver, but because + # the relationship between UT and TT is almost perfectly linear, + # it converges extremely fast (never more than 3 iterations). + dt = _TerrestrialTime(tt) - tt # first approximation of dt = tt - ut + while True: + ut = tt - dt + tt_check = _TerrestrialTime(ut) + err = tt_check - tt + if abs(err) < 1.0e-12: + return ut + dt += err + _TimeRegex = re.compile(r'^([0-9]{1,4})-([0-9]{2})-([0-9]{2})(T([0-9]{2}):([0-9]{2})(:([0-9]{2}(\.[0-9]+)?))?Z)?$') class Time: @@ -457,11 +515,28 @@ class Time: such as the orbits of planets around the Sun, or the Moon around the Earth. Historically, Terrestrial Time has also been known by the term *Ephemeris Time* (ET). """ - def __init__(self, ut): + def __init__(self, ut, tt = None): self.ut = ut - self.tt = _TerrestrialTime(ut) + if tt is None: + self.tt = _TerrestrialTime(ut) + else: + self.tt = tt self.etilt = None + @staticmethod + def FromTerrestrialTime(tt): + """Creates a #Time object from a Terrestrial Time day value. + + Parameters + ---------- + tt : The number of days after the J2000 epoch. + + Returns + ------- + Time + """ + return Time(_UniversalTime(tt), tt) + @staticmethod def Parse(text): """Creates a #Time object from a string of the form 'yyyy-mm-ddThh:mm:ss.sssZ' @@ -1499,6 +1574,140 @@ def _CalcPluto(time): # END Pluto Integrator #---------------------------------------------------------------------------- +# BEGIN Jupiter Moons + +$ASTRO_JUPITER_MOONS() + +class JupiterMoonsInfo: + """Holds the positions and velocities of Jupiter's major 4 moons. + + The #JupiterMoons function returns an object of this type + to report position and velocity vectors for Jupiter's largest 4 moons + Io, Europa, Ganymede, and Callisto. Each position vector is relative + to the center of Jupiter. Both position and velocity are oriented in + the EQJ system (that is, using Earth's equator at the J2000 epoch). + The positions are expressed in astronomical units (AU), + and the velocities in AU/day. + + Attributes + ---------- + moon : StateVector[4] + An array of state vectors, one for each of the four major moons + of Jupiter, in the following order: 0=Io, 1=Europa, 2=Ganymede, 3=Callisto. + """ + def __init__(self, moon): + self.moon = moon + + +def _JupiterMoon_elem2pv(time, mu, A, AL, K, H, Q, P): + # Translation of FORTRAN subroutine ELEM2PV from: + # https://ftp.imcce.fr/pub/ephem/satel/galilean/L1/L1.2/ + AN = math.sqrt(mu / (A*A*A)) + EE = AL + K*math.sin(AL) - H*math.cos(AL) + DE = 1 + while abs(DE) >= 1.0e-12: + CE = math.cos(EE) + SE = math.sin(EE) + DE = (AL - EE + K*SE - H*CE) / (1.0 - K*CE - H*SE) + EE += DE + CE = math.cos(EE) + SE = math.sin(EE) + DLE = H*CE - K*SE + RSAM1 = -K*CE - H*SE + ASR = 1.0/(1.0 + RSAM1) + PHI = math.sqrt(1.0 - K*K - H*H) + PSI = 1.0/(1.0 + PHI) + X1 = A*(CE - K - PSI*H*DLE) + Y1 = A*(SE - H + PSI*K*DLE) + VX1 = AN*ASR*A*(-SE - PSI*H*RSAM1) + VY1 = AN*ASR*A*(+CE + PSI*K*RSAM1) + F2 = 2.0*math.sqrt(1.0 - Q*Q - P*P) + P2 = 1.0 - 2.0*P*P + Q2 = 1.0 - 2.0*Q*Q + PQ = 2.0*P*Q + return StateVector( + X1*P2 + Y1*PQ, + X1*PQ + Y1*Q2, + (Q*Y1 - X1*P)*F2, + VX1*P2 + VY1*PQ, + VX1*PQ + VY1*Q2, + (Q*VY1 - VX1*P)*F2, + time + ) + + +def _CalcJupiterMoon(time, mu, al0, al1, a, l, z, zeta): + # This is a translation of FORTRAN code by Duriez, Lainey, and Vienne: + # https://ftp.imcce.fr/pub/ephem/satel/galilean/L1/L1.2/ + + t = time.tt + 18262.5 # number of days since 1950-01-01T00:00:00Z + + # Calculate 6 orbital elements at the given time t. + elem0 = 0.0 + for (amplitude, phase, frequency) in a: + elem0 += amplitude * math.cos(phase + (t * frequency)) + + elem1 = al0 + (t * al1) + for (amplitude, phase, frequency) in l: + elem1 += amplitude * math.sin(phase + (t * frequency)) + + elem1 = math.fmod(elem1, _PI2) + if elem1 < 0: + elem1 += _PI2 + + elem2 = 0.0 + elem3 = 0.0 + for (amplitude, phase, frequency) in z: + arg = phase + (t * frequency) + elem2 += amplitude * math.cos(arg) + elem3 += amplitude * math.sin(arg) + + elem4 = 0.0 + elem5 = 0.0 + for (amplitude, phase, frequency) in zeta: + arg = phase + (t * frequency) + elem4 += amplitude * math.cos(arg) + elem5 += amplitude * math.sin(arg) + + # Convert the oribital elements into position vectors in the Jupiter equatorial system (JUP). + state = _JupiterMoon_elem2pv(time, mu, elem0, elem1, elem2, elem3, elem4, elem5) + + # Re-orient position and velocity vectors from Jupiter-equatorial (JUP) to Earth-equatorial in J2000 (EQJ). + return RotateState(_Rotation_JUP_EQJ, state) + + +def JupiterMoons(time): + """Calculates jovicentric positions and velocities of Jupiter's largest 4 moons. + + Calculates position and velocity vectors for Jupiter's moons + Io, Europa, Ganymede, and Callisto, at the given date and time. + The vectors are jovicentric (relative to the center of Jupiter). + Their orientation is the Earth's equatorial system at the J2000 epoch (EQJ). + The position components are expressed in astronomical units (AU), and the + velocity components are in AU/day. + + To convert to heliocentric vectors, call #HelioVector + with `Body.Jupiter` to get Jupiter's heliocentric position, then + add the jovicentric vectors. Likewise, you can call #GeoVector + to convert to geocentric vectors. + + Parameters + ---------- + time : Time + The date and time for which to calculate Jupiter's moons. + + Returns + ------- + JupiterMoonsInfo + The positions and velocities of Jupiter's 4 largest moons. + """ + infolist = [] + for (mu, al0, al1, a, l, z, zeta) in _JupiterMoonModel: + infolist.append(_CalcJupiterMoon(time, mu, al0, al1, a, l, z, zeta)) + return JupiterMoonsInfo(infolist) + +# END Jupiter Moons +#---------------------------------------------------------------------------- # BEGIN Search def _QuadInterp(tm, dt, fa, fm, fb): @@ -4179,6 +4388,36 @@ def RotateVector(rotation, vector): ) +def RotateState(rotation, state): + """Applies a rotation to a state vector, yielding a rotated state vector. + + This function transforms a state vector in one orientation to a + state vector in another orientation. Both the position and velocity + vectors are rotated the same way. + + Parameters + ---------- + rotation : RotationMatrix + A rotation matrix that specifies how the orientation of the vector is to be changed. + state : StateVector + The state vector whose orientation is to be changed. + + Returns + ------- + StateVector + A state vector in the orientation specified by `rotation`. + """ + return StateVector( + rotation.rot[0][0]*state.x + rotation.rot[1][0]*state.y + rotation.rot[2][0]*state.z, + rotation.rot[0][1]*state.x + rotation.rot[1][1]*state.y + rotation.rot[2][1]*state.z, + rotation.rot[0][2]*state.x + rotation.rot[1][2]*state.y + rotation.rot[2][2]*state.z, + rotation.rot[0][0]*state.vx + rotation.rot[1][0]*state.vy + rotation.rot[2][0]*state.vz, + rotation.rot[0][1]*state.vx + rotation.rot[1][1]*state.vy + rotation.rot[2][1]*state.vz, + rotation.rot[0][2]*state.vx + rotation.rot[1][2]*state.vy + rotation.rot[2][2]*state.vz, + state.t + ) + + def Rotation_EQJ_ECL(): """Calculates a rotation matrix from equatorial J2000 (EQJ) to ecliptic J2000 (ECL). diff --git a/generate/template/astronomy.ts b/generate/template/astronomy.ts index d0587675..be735f73 100644 --- a/generate/template/astronomy.ts +++ b/generate/template/astronomy.ts @@ -2283,7 +2283,7 @@ function CalcJupiterMoon(time: AstroTime, m: jupiter_moon_t): StateVector { * add the jovicentric vectors. Likewise, you can call {@link GeoVector} * to convert to geocentric vectors. * - * @param {FlexibleDateTime} date The date and time for which to calculate the position vectors. + * @param {FlexibleDateTime} date The date and time for which to calculate Jupiter's moons. * @return {JupiterMoonsInfo} Position and velocity vectors of Jupiter's largest 4 moons. */ export function JupiterMoons(date: FlexibleDateTime): JupiterMoonsInfo { diff --git a/generate/test.py b/generate/test.py index f140554d..b76f2da1 100755 --- a/generate/test.py +++ b/generate/test.py @@ -1697,11 +1697,95 @@ def Geoid(): #----------------------------------------------------------------------------------------------------------- +def JupiterMoons_CheckJpl(mindex, tt, pos, vel): + pos_tolerance = 9.0e-4 + vel_tolerance = 9.0e-4 + time = astronomy.Time.FromTerrestrialTime(tt) + jm = astronomy.JupiterMoons(time) + + dx = v(pos[0] - jm.moon[mindex].x) + dy = v(pos[1] - jm.moon[mindex].y) + dz = v(pos[2] - jm.moon[mindex].z) + mag = sqrt(pos[0]*pos[0] + pos[1]*pos[1] + pos[2]*pos[2]) + pos_diff = sqrt(dx*dx + dy*dy + dz*dz) / mag + if pos_diff > pos_tolerance: + print('PY JupiterMoons_CheckJpl(mindex={}, tt={}): excessive position error {}'.format(mindex, tt, pos_diff)) + return 1 + + dx = v(vel[0] - jm.moon[mindex].vx) + dy = v(vel[1] - jm.moon[mindex].vy) + dz = v(vel[2] - jm.moon[mindex].vz) + mag = sqrt(vel[0]*vel[0] + vel[1]*vel[1] + vel[2]*vel[2]) + vel_diff = sqrt(dx*dx + dy*dy + dz*dz) / mag + if vel_diff > vel_tolerance: + print('PY JupiterMoons_CheckJpl(mindex={}, tt={}): excessive velocity error {}'.format(mindex, tt, vel_diff)) + return 1 + + Debug('PY JupiterMoons_CheckJpl: mindex={}, tt={}, pos_diff={}, vel_diff={}'.format(mindex, tt, pos_diff, vel_diff)) + return 0 + + +def JupiterMoons(): + for mindex in range(4): + filename = 'jupiter_moons/horizons/jm{}.txt'.format(mindex) + with open(filename, 'rt') as infile: + lnum = 0 + found = False + part = -1 + expected_count = 5001 + count = 0 + for line in infile: + line = line.rstrip() + lnum += 1 + if not found: + if line == '$$SOE': + found = True + part = 0 + elif line.startswith('Revised:'): + check_mindex = int(line[76:]) - 501 + if mindex != check_mindex: + print('PY JupiterMoons({} line {}): moon index does not match: check={}, mindex={}'.format(filename, lnum, check_mindex, mindex)) + return 1 + elif line == '$$EOE': + break + else: + if part == 0: + # 2446545.000000000 = A.D. 1986-Apr-24 12:00:00.0000 TDB + tt = float(line.split()[0]) - 2451545.0 # convert JD to J2000 TT + elif part == 1: + # X = 1.134408131605554E-03 Y =-2.590904586750408E-03 Z =-7.490427225904720E-05 + match = re.match(r'\s*X =\s*(\S+) Y =\s*(\S+) Z =\s*(\S+)', line) + if not match: + print('PY JupiterMoons({} line {}): cannot parse position vector.'.format(filename, lnum)) + return 1 + pos = [ float(match.group(1)), float(match.group(2)), float(match.group(3)) ] + else: # part == 2 + # VX= 9.148038778472862E-03 VY= 3.973823407182510E-03 VZ= 2.765660368640458E-04 + match = re.match(r'\s*VX=\s*(\S+) VY=\s*(\S+) VZ=\s*(\S+)', line) + if not match: + print('PY JupiterMoons({} line {}): cannot parse velocity vector.'.format(filename, lnum)) + return 1 + vel = [ float(match.group(1)), float(match.group(2)), float(match.group(3)) ] + if JupiterMoons_CheckJpl(mindex, tt, pos, vel): + print('PY JupiterMoons({} line {}): FAILED VERIFICATION.'.format(filename, lnum)) + return 1 + count += 1 + part = (part + 1) % 3 + if count != expected_count: + print('PY JupiterMoons: expected {} test cases, but found {}'.format(expected_count, count)) + return 1 + + print('PY JupiterMoons: PASS') + return 0 + +#----------------------------------------------------------------------------------------------------------- + UnitTests = { 'constellation': Constellation, 'elongation': Elongation, 'geoid': Geoid, 'global_solar_eclipse': GlobalSolarEclipse, + 'jupiter_moons': JupiterMoons, 'local_solar_eclipse': LocalSolarEclipse, 'lunar_apsis': LunarApsis, 'lunar_eclipse': LunarEclipse, diff --git a/source/js/README.md b/source/js/README.md index 13491e2c..ac9348c8 100644 --- a/source/js/README.md +++ b/source/js/README.md @@ -978,7 +978,7 @@ to convert to geocentric vectors. | Param | Type | Description | | --- | --- | --- | -| date | [FlexibleDateTime](#FlexibleDateTime) | The date and time for which to calculate the position vectors. | +| date | [FlexibleDateTime](#FlexibleDateTime) | The date and time for which to calculate Jupiter's moons. | * * * diff --git a/source/js/astronomy.browser.js b/source/js/astronomy.browser.js index 523a089e..906cc787 100644 --- a/source/js/astronomy.browser.js +++ b/source/js/astronomy.browser.js @@ -2957,7 +2957,7 @@ function CalcJupiterMoon(time, m) { * add the jovicentric vectors. Likewise, you can call {@link GeoVector} * to convert to geocentric vectors. * - * @param {FlexibleDateTime} date The date and time for which to calculate the position vectors. + * @param {FlexibleDateTime} date The date and time for which to calculate Jupiter's moons. * @return {JupiterMoonsInfo} Position and velocity vectors of Jupiter's largest 4 moons. */ function JupiterMoons(date) { diff --git a/source/js/astronomy.d.ts b/source/js/astronomy.d.ts index f9e9f0be..1b946f5c 100644 --- a/source/js/astronomy.d.ts +++ b/source/js/astronomy.d.ts @@ -607,7 +607,7 @@ export declare class JupiterMoonsInfo { * add the jovicentric vectors. Likewise, you can call {@link GeoVector} * to convert to geocentric vectors. * - * @param {FlexibleDateTime} date The date and time for which to calculate the position vectors. + * @param {FlexibleDateTime} date The date and time for which to calculate Jupiter's moons. * @return {JupiterMoonsInfo} Position and velocity vectors of Jupiter's largest 4 moons. */ export declare function JupiterMoons(date: FlexibleDateTime): JupiterMoonsInfo; diff --git a/source/js/astronomy.js b/source/js/astronomy.js index 8baf20c0..1566e861 100644 --- a/source/js/astronomy.js +++ b/source/js/astronomy.js @@ -2956,7 +2956,7 @@ function CalcJupiterMoon(time, m) { * add the jovicentric vectors. Likewise, you can call {@link GeoVector} * to convert to geocentric vectors. * - * @param {FlexibleDateTime} date The date and time for which to calculate the position vectors. + * @param {FlexibleDateTime} date The date and time for which to calculate Jupiter's moons. * @return {JupiterMoonsInfo} Position and velocity vectors of Jupiter's largest 4 moons. */ function JupiterMoons(date) { diff --git a/source/js/astronomy.ts b/source/js/astronomy.ts index 1cd51130..2f17b163 100644 --- a/source/js/astronomy.ts +++ b/source/js/astronomy.ts @@ -3277,7 +3277,7 @@ function CalcJupiterMoon(time: AstroTime, m: jupiter_moon_t): StateVector { * add the jovicentric vectors. Likewise, you can call {@link GeoVector} * to convert to geocentric vectors. * - * @param {FlexibleDateTime} date The date and time for which to calculate the position vectors. + * @param {FlexibleDateTime} date The date and time for which to calculate Jupiter's moons. * @return {JupiterMoonsInfo} Position and velocity vectors of Jupiter's largest 4 moons. */ export function JupiterMoons(date: FlexibleDateTime): JupiterMoonsInfo { diff --git a/source/js/esm/astronomy.js b/source/js/esm/astronomy.js index 748dbf8b..88f1dec9 100644 --- a/source/js/esm/astronomy.js +++ b/source/js/esm/astronomy.js @@ -2930,7 +2930,7 @@ function CalcJupiterMoon(time, m) { * add the jovicentric vectors. Likewise, you can call {@link GeoVector} * to convert to geocentric vectors. * - * @param {FlexibleDateTime} date The date and time for which to calculate the position vectors. + * @param {FlexibleDateTime} date The date and time for which to calculate Jupiter's moons. * @return {JupiterMoonsInfo} Position and velocity vectors of Jupiter's largest 4 moons. */ export function JupiterMoons(date) { diff --git a/source/python/README.md b/source/python/README.md index fda09dbc..f7171130 100644 --- a/source/python/README.md +++ b/source/python/README.md @@ -403,6 +403,25 @@ body at a given date and time. --- + +### class JupiterMoonsInfo + +**Holds the positions and velocities of Jupiter's major 4 moons.** + +The [`JupiterMoons`](#JupiterMoons) function returns an object of this type +to report position and velocity vectors for Jupiter's largest 4 moons +Io, Europa, Ganymede, and Callisto. Each position vector is relative +to the center of Jupiter. Both position and velocity are oriented in +the EQJ system (that is, using Earth's equator at the J2000 epoch). +The positions are expressed in astronomical units (AU), +and the velocities in AU/day. + +| Type | Attribute | Description | +| --- | --- | --- | +| [`StateVector[4]`](#StateVector[4]) | `moon` | An array of state vectors, one for each of the four major moons of Jupiter, in the following order: 0=Io, 1=Europa, 2=Ganymede, 3=Callisto. | + +--- + ### class LocalSolarEclipseInfo @@ -543,6 +562,28 @@ Call [`Seasons`](#Seasons) to calculate this data structure for a given year. --- + +### class StateVector + +**A combination of a position vector, a velocity vector, and a time.** + +The position (x, y, z) is measured in astronomical units (AU). +The velocity (vx, vy, vz) is measured in AU/day. +The coordinate system varies and depends on context. +The state vector also includes a time stamp. + +| Type | Attribute | Description | +| --- | --- | --- | +| `float` | `x` | The x-coordinate of the position, measured in AU. | +| `float` | `y` | The y-coordinate of the position, measured in AU. | +| `float` | `z` | The z-coordinate of the position, measured in AU. | +| `float` | `vx` | The x-component of the velocity, measured in AU/day. | +| `float` | `vy` | The y-component of the velocity, measured in AU/day. | +| `float` | `vz` | The z-component of the velocity, measured in AU/day. | +| [`Time`](#Time) | `t` | The date and time at which the position and velocity vectors are valid. | + +--- + ### class Time @@ -583,6 +624,17 @@ The value of the calling object is not modified. This function creates a brand n ### Returns: [`Time`](#Time) + +### Time.FromTerrestrialTime(tt) + +**Creates a [`Time`](#Time) object from a Terrestrial Time day value.** + +| Type | Parameter | Description | +| --- | --- | --- | +| [`The number of days after the J2000 epoch.`](#The number of days after the J2000 epoch.) | `tt` | | + +### Returns: [`Time`](#Time) + ### Time.Make(year, month, day, hour, minute, second) @@ -1330,6 +1382,31 @@ The inverse rotation matrix. --- + +### JupiterMoons(time) + +**Calculates jovicentric positions and velocities of Jupiter's largest 4 moons.** + +Calculates position and velocity vectors for Jupiter's moons +Io, Europa, Ganymede, and Callisto, at the given date and time. +The vectors are jovicentric (relative to the center of Jupiter). +Their orientation is the Earth's equatorial system at the J2000 epoch (EQJ). +The position components are expressed in astronomical units (AU), and the +velocity components are in AU/day. +To convert to heliocentric vectors, call [`HelioVector`](#HelioVector) +with `Body.Jupiter` to get Jupiter's heliocentric position, then +add the jovicentric vectors. Likewise, you can call [`GeoVector`](#GeoVector) +to convert to geocentric vectors. + +| Type | Parameter | Description | +| --- | --- | --- | +| [`Time`](#Time) | `time` | The date and time for which to calculate Jupiter's moons. | + +### Returns: [`JupiterMoonsInfo`](#JupiterMoonsInfo) +The positions and velocities of Jupiter's 4 largest moons. + +--- + ### LongitudeFromSun(body, time) @@ -1590,6 +1667,25 @@ option selected by the `refraction` parameter. --- + +### RotateState(rotation, state) + +**Applies a rotation to a state vector, yielding a rotated state vector.** + +This function transforms a state vector in one orientation to a +state vector in another orientation. Both the position and velocity +vectors are rotated the same way. + +| Type | Parameter | Description | +| --- | --- | --- | +| [`RotationMatrix`](#RotationMatrix) | `rotation` | A rotation matrix that specifies how the orientation of the vector is to be changed. | +| [`StateVector`](#StateVector) | `state` | The state vector whose orientation is to be changed. | + +### Returns: [`StateVector`](#StateVector) +A state vector in the orientation specified by `rotation`. + +--- + ### RotateVector(rotation, vector) diff --git a/source/python/astronomy.py b/source/python/astronomy.py index cd5553e6..2a5259ff 100644 --- a/source/python/astronomy.py +++ b/source/python/astronomy.py @@ -155,6 +155,50 @@ class Vector: """Returns the length of the vector in AU.""" return math.sqrt(self.x**2 + self.y**2 + self.z**2) +class StateVector: + """A combination of a position vector, a velocity vector, and a time. + + The position (x, y, z) is measured in astronomical units (AU). + The velocity (vx, vy, vz) is measured in AU/day. + The coordinate system varies and depends on context. + The state vector also includes a time stamp. + + Attributes + ---------- + x : float + The x-coordinate of the position, measured in AU. + y : float + The y-coordinate of the position, measured in AU. + z : float + The z-coordinate of the position, measured in AU. + vx : float + The x-component of the velocity, measured in AU/day. + vy : float + The y-component of the velocity, measured in AU/day. + vz : float + The z-component of the velocity, measured in AU/day. + t : Time + The date and time at which the position and velocity vectors are valid. + """ + def __init__(self, x, y, z, vx, vy, vz, t): + self.x = x + self.y = y + self.z = z + self.vx = vx + self.vy = vy + self.vz = vz + self.t = t + + def __repr__(self): + return 'StateVector[pos=({}, {}, {}), vel=({}, {}, {}), t{}]'.format( + self.x, self.y, self.z, + self.vx, self.vy, self.vz, + str(self.t)) + + def __str__(self): + return '({}, {}, {}, {}, {}, {}, {})'.format(self.x, self.y, self.z, self.vx, self.vy, self.vz, str(self.t)) + + @enum.unique class Body(enum.Enum): """The celestial bodies supported by Astronomy Engine calculations. @@ -411,6 +455,20 @@ _DeltaT = DeltaT_EspenakMeeus def _TerrestrialTime(ut): return ut + _DeltaT(ut) / 86400.0 +def _UniversalTime(tt): + # This is the inverse function of _TerrestrialTime. + # This is an iterative numerical solver, but because + # the relationship between UT and TT is almost perfectly linear, + # it converges extremely fast (never more than 3 iterations). + dt = _TerrestrialTime(tt) - tt # first approximation of dt = tt - ut + while True: + ut = tt - dt + tt_check = _TerrestrialTime(ut) + err = tt_check - tt + if abs(err) < 1.0e-12: + return ut + dt += err + _TimeRegex = re.compile(r'^([0-9]{1,4})-([0-9]{2})-([0-9]{2})(T([0-9]{2}):([0-9]{2})(:([0-9]{2}(\.[0-9]+)?))?Z)?$') class Time: @@ -457,11 +515,28 @@ class Time: such as the orbits of planets around the Sun, or the Moon around the Earth. Historically, Terrestrial Time has also been known by the term *Ephemeris Time* (ET). """ - def __init__(self, ut): + def __init__(self, ut, tt = None): self.ut = ut - self.tt = _TerrestrialTime(ut) + if tt is None: + self.tt = _TerrestrialTime(ut) + else: + self.tt = tt self.etilt = None + @staticmethod + def FromTerrestrialTime(tt): + """Creates a #Time object from a Terrestrial Time day value. + + Parameters + ---------- + tt : The number of days after the J2000 epoch. + + Returns + ------- + Time + """ + return Time(_UniversalTime(tt), tt) + @staticmethod def Parse(text): """Creates a #Time object from a string of the form 'yyyy-mm-ddThh:mm:ss.sssZ' @@ -3396,6 +3471,273 @@ def _CalcPluto(time): # END Pluto Integrator #---------------------------------------------------------------------------- +# BEGIN Jupiter Moons + +_Rotation_JUP_EQJ = RotationMatrix([ + [ 9.9943276533865444e-01, -3.3677107469764142e-02, 0.0000000000000000e+00 ], + [ 3.0395942890628476e-02, 9.0205791235280897e-01, 4.3054338854229507e-01 ], + [ -1.4499455966335291e-02, -4.3029916940910073e-01, 9.0256988127375404e-01 ] +]) + +_JupiterMoonModel = [ + # [0] Io + [ + 2.8248942843381399e-07, 1.4462132960212239e+00, 3.5515522861824000e+00, # mu, al0, al1 + [ # a + [ 0.0028210960212903, 0.0000000000000000e+00, 0.0000000000000000e+00 ] + ], + [ # l + [ -0.0001925258348666, 4.9369589722644998e+00, 1.3584836583050000e-02 ], + [ -0.0000970803596076, 4.3188796477322002e+00, 1.3034138432430000e-02 ], + [ -0.0000898817416500, 1.9080016428616999e+00, 3.0506486715799999e-03 ], + [ -0.0000553101050262, 1.4936156681568999e+00, 1.2938928911549999e-02 ] + ], + [ # z + [ 0.0041510849668155, 4.0899396355450000e+00, -1.2906864146660001e-02 ], + [ 0.0006260521444113, 1.4461888986270000e+00, 3.5515522949801999e+00 ], + [ 0.0000352747346169, 2.1256287034577999e+00, 1.2727416566999999e-04 ] + ], + [ # zeta + [ 0.0003142172466014, 2.7964219722923001e+00, -2.3150960980000000e-03 ], + [ 0.0000904169207946, 1.0477061879627001e+00, -5.6920638196000003e-04 ] + ] + ], + + # [1] Europa + [ + 2.8248327439289299e-07, -3.7352634374713622e-01, 1.7693227111234699e+00, # mu, al0, al1 + [ # a + [ 0.0044871037804314, 0.0000000000000000e+00, 0.0000000000000000e+00 ], + [ 0.0000004324367498, 1.8196456062910000e+00, 1.7822295777568000e+00 ] + ], + [ # l + [ 0.0008576433172936, 4.3188693178264002e+00, 1.3034138308049999e-02 ], + [ 0.0004549582875086, 1.4936531751079001e+00, 1.2938928819619999e-02 ], + [ 0.0003248939825174, 1.8196494533458001e+00, 1.7822295777568000e+00 ], + [ -0.0003074250079334, 4.9377037005910998e+00, 1.3584832867240000e-02 ], + [ 0.0001982386144784, 1.9079869054759999e+00, 3.0510121286900001e-03 ], + [ 0.0001834063551804, 2.1402853388529000e+00, 1.4500978933800000e-03 ], + [ -0.0001434383188452, 5.6222140366630002e+00, 8.9111478887838003e-01 ], + [ -0.0000771939140944, 4.3002724372349999e+00, 2.6733443704265998e+00 ] + ], + [ # z + [ -0.0093589104136341, 4.0899396509038999e+00, -1.2906864146660001e-02 ], + [ 0.0002988994545555, 5.9097265185595003e+00, 1.7693227079461999e+00 ], + [ 0.0002139036390350, 2.1256289300016000e+00, 1.2727418406999999e-04 ], + [ 0.0001980963564781, 2.7435168292649998e+00, 6.7797343008999997e-04 ], + [ 0.0001210388158965, 5.5839943711203004e+00, 3.2056614899999997e-05 ], + [ 0.0000837042048393, 1.6094538368039000e+00, -9.0402165808846002e-01 ], + [ 0.0000823525166369, 1.4461887708689001e+00, 3.5515522949801999e+00 ] + ], + [ # zeta + [ 0.0040404917832303, 1.0477063169425000e+00, -5.6920640539999997e-04 ], + [ 0.0002200421034564, 3.3368857864364001e+00, -1.2491307306999999e-04 ], + [ 0.0001662544744719, 2.4134862374710999e+00, 0.0000000000000000e+00 ], + [ 0.0000590282470983, 5.9719930968366004e+00, -3.0561602250000000e-05 ] + ] + ], + + # [2] Ganymede + [ + 2.8249818418472298e-07, 2.8740893911433479e-01, 8.7820792358932798e-01, # mu, al0, al1 + [ # a + [ 0.0071566594572575, 0.0000000000000000e+00, 0.0000000000000000e+00 ], + [ 0.0000013930299110, 1.1586745884981000e+00, 2.6733443704265998e+00 ] + ], + [ # l + [ 0.0002310797886226, 2.1402987195941998e+00, 1.4500978438400001e-03 ], + [ -0.0001828635964118, 4.3188672736968003e+00, 1.3034138282630000e-02 ], + [ 0.0001512378778204, 4.9373102372298003e+00, 1.3584834812520000e-02 ], + [ -0.0001163720969778, 4.3002659861490002e+00, 2.6733443704265998e+00 ], + [ -0.0000955478069846, 1.4936612842567001e+00, 1.2938928798570001e-02 ], + [ 0.0000815246854464, 5.6222137132535002e+00, 8.9111478887838003e-01 ], + [ -0.0000801219679602, 1.2995922951532000e+00, 1.0034433456728999e+00 ], + [ -0.0000607017260182, 6.4978769669238001e-01, 5.0172167043264004e-01 ] + ], + [ # z + [ 0.0014289811307319, 2.1256295942738999e+00, 1.2727413029000001e-04 ], + [ 0.0007710931226760, 5.5836330003496002e+00, 3.2064341100000001e-05 ], + [ 0.0005925911780766, 4.0899396636447998e+00, -1.2906864146660001e-02 ], + [ 0.0002045597496146, 5.2713683670371996e+00, -1.2523544076106000e-01 ], + [ 0.0001785118648258, 2.8743156721063001e-01, 8.7820792442520001e-01 ], + [ 0.0001131999784893, 1.4462127277818000e+00, 3.5515522949801999e+00 ], + [ -0.0000658778169210, 2.2702423990985001e+00, -1.7951364394536999e+00 ], + [ 0.0000497058888328, 5.9096792204858000e+00, 1.7693227129285001e+00 ] + ], + [ # zeta + [ 0.0015932721570848, 3.3368862796665000e+00, -1.2491307058000000e-04 ], + [ 0.0008533093128905, 2.4133881688166001e+00, 0.0000000000000000e+00 ], + [ 0.0003513347911037, 5.9720789850126996e+00, -3.0561017709999999e-05 ], + [ -0.0001441929255483, 1.0477061764435001e+00, -5.6920632124000004e-04 ] + ] + ], + + # [3] Callisto + [ + 2.8249214488990899e-07, -3.6203412913757038e-01, 3.7648623343382798e-01, # mu, al0, al1 + [ # a + [ 0.0125879701715314, 0.0000000000000000e+00, 0.0000000000000000e+00 ], + [ 0.0000035952049470, 6.4965776007116005e-01, 5.0172168165034003e-01 ], + [ 0.0000027580210652, 1.8084235781510001e+00, 3.1750660413359002e+00 ] + ], + [ # l + [ 0.0005586040123824, 2.1404207189814999e+00, 1.4500979323100001e-03 ], + [ -0.0003805813868176, 2.7358844897852999e+00, 2.9729650620000000e-05 ], + [ 0.0002205152863262, 6.4979652596399995e-01, 5.0172167243580001e-01 ], + [ 0.0001877895151158, 1.8084787604004999e+00, 3.1750660413359002e+00 ], + [ 0.0000766916975242, 6.2720114319754998e+00, 1.3928364636651001e+00 ], + [ 0.0000747056855106, 1.2995916202344000e+00, 1.0034433456728999e+00 ] + ], + [ # z + [ 0.0073755808467977, 5.5836071576083999e+00, 3.2065099140000001e-05 ], + [ 0.0002065924169942, 5.9209831565786004e+00, 3.7648624194703001e-01 ], + [ 0.0001589869764021, 2.8744006242622999e-01, 8.7820792442520001e-01 ], + [ -0.0001561131605348, 2.1257397865089001e+00, 1.2727441285000001e-04 ], + [ 0.0001486043380971, 1.4462134301023000e+00, 3.5515522949801999e+00 ], + [ 0.0000635073108731, 5.9096803285953996e+00, 1.7693227129285001e+00 ], + [ 0.0000599351698525, 4.1125517584797997e+00, -2.7985797954588998e+00 ], + [ 0.0000540660842731, 5.5390350845569003e+00, 2.8683408228299999e-03 ], + [ -0.0000489596900866, 4.6218149483337996e+00, -6.2695712529518999e-01 ] + ], + [ # zeta + [ 0.0038422977898495, 2.4133922085556998e+00, 0.0000000000000000e+00 ], + [ 0.0022453891791894, 5.9721736773277003e+00, -3.0561255249999997e-05 ], + [ -0.0002604479450559, 3.3368746306408998e+00, -1.2491309972000001e-04 ], + [ 0.0000332112143230, 5.5604137742336999e+00, 2.9003768850700000e-03 ] + ] + ] +] + +class JupiterMoonsInfo: + """Holds the positions and velocities of Jupiter's major 4 moons. + + The #JupiterMoons function returns an object of this type + to report position and velocity vectors for Jupiter's largest 4 moons + Io, Europa, Ganymede, and Callisto. Each position vector is relative + to the center of Jupiter. Both position and velocity are oriented in + the EQJ system (that is, using Earth's equator at the J2000 epoch). + The positions are expressed in astronomical units (AU), + and the velocities in AU/day. + + Attributes + ---------- + moon : StateVector[4] + An array of state vectors, one for each of the four major moons + of Jupiter, in the following order: 0=Io, 1=Europa, 2=Ganymede, 3=Callisto. + """ + def __init__(self, moon): + self.moon = moon + + +def _JupiterMoon_elem2pv(time, mu, A, AL, K, H, Q, P): + # Translation of FORTRAN subroutine ELEM2PV from: + # https://ftp.imcce.fr/pub/ephem/satel/galilean/L1/L1.2/ + AN = math.sqrt(mu / (A*A*A)) + EE = AL + K*math.sin(AL) - H*math.cos(AL) + DE = 1 + while abs(DE) >= 1.0e-12: + CE = math.cos(EE) + SE = math.sin(EE) + DE = (AL - EE + K*SE - H*CE) / (1.0 - K*CE - H*SE) + EE += DE + CE = math.cos(EE) + SE = math.sin(EE) + DLE = H*CE - K*SE + RSAM1 = -K*CE - H*SE + ASR = 1.0/(1.0 + RSAM1) + PHI = math.sqrt(1.0 - K*K - H*H) + PSI = 1.0/(1.0 + PHI) + X1 = A*(CE - K - PSI*H*DLE) + Y1 = A*(SE - H + PSI*K*DLE) + VX1 = AN*ASR*A*(-SE - PSI*H*RSAM1) + VY1 = AN*ASR*A*(+CE + PSI*K*RSAM1) + F2 = 2.0*math.sqrt(1.0 - Q*Q - P*P) + P2 = 1.0 - 2.0*P*P + Q2 = 1.0 - 2.0*Q*Q + PQ = 2.0*P*Q + return StateVector( + X1*P2 + Y1*PQ, + X1*PQ + Y1*Q2, + (Q*Y1 - X1*P)*F2, + VX1*P2 + VY1*PQ, + VX1*PQ + VY1*Q2, + (Q*VY1 - VX1*P)*F2, + time + ) + + +def _CalcJupiterMoon(time, mu, al0, al1, a, l, z, zeta): + # This is a translation of FORTRAN code by Duriez, Lainey, and Vienne: + # https://ftp.imcce.fr/pub/ephem/satel/galilean/L1/L1.2/ + + t = time.tt + 18262.5 # number of days since 1950-01-01T00:00:00Z + + # Calculate 6 orbital elements at the given time t. + elem0 = 0.0 + for (amplitude, phase, frequency) in a: + elem0 += amplitude * math.cos(phase + (t * frequency)) + + elem1 = al0 + (t * al1) + for (amplitude, phase, frequency) in l: + elem1 += amplitude * math.sin(phase + (t * frequency)) + + elem1 = math.fmod(elem1, _PI2) + if elem1 < 0: + elem1 += _PI2 + + elem2 = 0.0 + elem3 = 0.0 + for (amplitude, phase, frequency) in z: + arg = phase + (t * frequency) + elem2 += amplitude * math.cos(arg) + elem3 += amplitude * math.sin(arg) + + elem4 = 0.0 + elem5 = 0.0 + for (amplitude, phase, frequency) in zeta: + arg = phase + (t * frequency) + elem4 += amplitude * math.cos(arg) + elem5 += amplitude * math.sin(arg) + + # Convert the oribital elements into position vectors in the Jupiter equatorial system (JUP). + state = _JupiterMoon_elem2pv(time, mu, elem0, elem1, elem2, elem3, elem4, elem5) + + # Re-orient position and velocity vectors from Jupiter-equatorial (JUP) to Earth-equatorial in J2000 (EQJ). + return RotateState(_Rotation_JUP_EQJ, state) + + +def JupiterMoons(time): + """Calculates jovicentric positions and velocities of Jupiter's largest 4 moons. + + Calculates position and velocity vectors for Jupiter's moons + Io, Europa, Ganymede, and Callisto, at the given date and time. + The vectors are jovicentric (relative to the center of Jupiter). + Their orientation is the Earth's equatorial system at the J2000 epoch (EQJ). + The position components are expressed in astronomical units (AU), and the + velocity components are in AU/day. + + To convert to heliocentric vectors, call #HelioVector + with `Body.Jupiter` to get Jupiter's heliocentric position, then + add the jovicentric vectors. Likewise, you can call #GeoVector + to convert to geocentric vectors. + + Parameters + ---------- + time : Time + The date and time for which to calculate Jupiter's moons. + + Returns + ------- + JupiterMoonsInfo + The positions and velocities of Jupiter's 4 largest moons. + """ + infolist = [] + for (mu, al0, al1, a, l, z, zeta) in _JupiterMoonModel: + infolist.append(_CalcJupiterMoon(time, mu, al0, al1, a, l, z, zeta)) + return JupiterMoonsInfo(infolist) + +# END Jupiter Moons +#---------------------------------------------------------------------------- # BEGIN Search def _QuadInterp(tm, dt, fa, fm, fb): @@ -6076,6 +6418,36 @@ def RotateVector(rotation, vector): ) +def RotateState(rotation, state): + """Applies a rotation to a state vector, yielding a rotated state vector. + + This function transforms a state vector in one orientation to a + state vector in another orientation. Both the position and velocity + vectors are rotated the same way. + + Parameters + ---------- + rotation : RotationMatrix + A rotation matrix that specifies how the orientation of the vector is to be changed. + state : StateVector + The state vector whose orientation is to be changed. + + Returns + ------- + StateVector + A state vector in the orientation specified by `rotation`. + """ + return StateVector( + rotation.rot[0][0]*state.x + rotation.rot[1][0]*state.y + rotation.rot[2][0]*state.z, + rotation.rot[0][1]*state.x + rotation.rot[1][1]*state.y + rotation.rot[2][1]*state.z, + rotation.rot[0][2]*state.x + rotation.rot[1][2]*state.y + rotation.rot[2][2]*state.z, + rotation.rot[0][0]*state.vx + rotation.rot[1][0]*state.vy + rotation.rot[2][0]*state.vz, + rotation.rot[0][1]*state.vx + rotation.rot[1][1]*state.vy + rotation.rot[2][1]*state.vz, + rotation.rot[0][2]*state.vx + rotation.rot[1][2]*state.vy + rotation.rot[2][2]*state.vz, + state.t + ) + + def Rotation_EQJ_ECL(): """Calculates a rotation matrix from equatorial J2000 (EQJ) to ecliptic J2000 (ECL). diff --git a/website/src/assets/documentation.json b/website/src/assets/documentation.json index f2fbe01a..50108360 100644 --- a/website/src/assets/documentation.json +++ b/website/src/assets/documentation.json @@ -30285,11 +30285,11 @@ "params": [] }, { - "comment": "/**\n * @brief Calculates jovicentric positions and velocities of Jupiter's largest 4 moons.\n *\n * Calculates position and velocity vectors for Jupiter's moons\n * Io, Europa, Ganymede, and Callisto, at the given date and time.\n * The vectors are jovicentric (relative to the center of Jupiter).\n * Their orientation is the Earth's equatorial system at the J2000 epoch (EQJ).\n * The position components are expressed in astronomical units (AU), and the\n * velocity components are in AU/day.\n *\n * To convert to heliocentric vectors, call {@link HelioVector}\n * with `Astronomy.Body.Jupiter` to get Jupiter's heliocentric position, then\n * add the jovicentric vectors. Likewise, you can call {@link GeoVector}\n * to convert to geocentric vectors.\n *\n * @param {FlexibleDateTime} date The date and time for which to calculate the position vectors.\n * @return {JupiterMoonsInfo} Position and velocity vectors of Jupiter's largest 4 moons.\n */", + "comment": "/**\n * @brief Calculates jovicentric positions and velocities of Jupiter's largest 4 moons.\n *\n * Calculates position and velocity vectors for Jupiter's moons\n * Io, Europa, Ganymede, and Callisto, at the given date and time.\n * The vectors are jovicentric (relative to the center of Jupiter).\n * Their orientation is the Earth's equatorial system at the J2000 epoch (EQJ).\n * The position components are expressed in astronomical units (AU), and the\n * velocity components are in AU/day.\n *\n * To convert to heliocentric vectors, call {@link HelioVector}\n * with `Astronomy.Body.Jupiter` to get Jupiter's heliocentric position, then\n * add the jovicentric vectors. Likewise, you can call {@link GeoVector}\n * to convert to geocentric vectors.\n *\n * @param {FlexibleDateTime} date The date and time for which to calculate Jupiter's moons.\n * @return {JupiterMoonsInfo} Position and velocity vectors of Jupiter's largest 4 moons.\n */", "meta": { "range": [ - 136434, - 136668 + 136429, + 136663 ], "filename": "astronomy.js", "lineno": 2962, @@ -30323,7 +30323,7 @@ "FlexibleDateTime" ] }, - "description": "The date and time for which to calculate the position vectors.", + "description": "The date and time for which to calculate Jupiter's moons.", "name": "date" } ], @@ -30346,8 +30346,8 @@ "comment": "", "meta": { "range": [ - 136474, - 136500 + 136469, + 136495 ], "filename": "astronomy.js", "lineno": 2963, @@ -30371,8 +30371,8 @@ "comment": "", "meta": { "range": [ - 136510, - 136523 + 136505, + 136518 ], "filename": "astronomy.js", "lineno": 2964, @@ -30396,8 +30396,8 @@ "comment": "", "meta": { "range": [ - 136538, - 136542 + 136533, + 136537 ], "filename": "astronomy.js", "lineno": 2965, @@ -30419,8 +30419,8 @@ "comment": "", "meta": { "range": [ - 136669, - 136704 + 136664, + 136699 ], "filename": "astronomy.js", "lineno": 2970, @@ -30443,8 +30443,8 @@ "comment": "/**\n * @brief Calculates a vector from the center of the Sun to the given body at the given time.\n *\n * Calculates heliocentric (i.e., with respect to the center of the Sun)\n * Cartesian coordinates in the J2000 equatorial system of a celestial\n * body at a specified time. The position is not corrected for light travel time or aberration.\n *\n * @param {Body} body\n * One of the strings\n * `\"Sun\"`, `\"Moon\"`, `\"Mercury\"`, `\"Venus\"`,\n * `\"Earth\"`, `\"Mars\"`, `\"Jupiter\"`, `\"Saturn\"`,\n * `\"Uranus\"`, `\"Neptune\"`, `\"Pluto\"`,\n * `\"SSB\"`, or `\"EMB\"`.\n *\n * @param {FlexibleDateTime} date\n * The date and time for which the body's position is to be calculated.\n *\n * @returns {Vector}\n */", "meta": { "range": [ - 137498, - 138354 + 137493, + 138349 ], "filename": "astronomy.js", "lineno": 2991, @@ -30511,8 +30511,8 @@ "comment": "", "meta": { "range": [ - 137541, - 137562 + 137536, + 137557 ], "filename": "astronomy.js", "lineno": 2992, @@ -30536,8 +30536,8 @@ "comment": "", "meta": { "range": [ - 137825, - 137855 + 137820, + 137850 ], "filename": "astronomy.js", "lineno": 3003, @@ -30561,8 +30561,8 @@ "comment": "", "meta": { "range": [ - 137869, - 137886 + 137864, + 137881 ], "filename": "astronomy.js", "lineno": 3004, @@ -30586,8 +30586,8 @@ "comment": "", "meta": { "range": [ - 138003, - 138033 + 137998, + 138028 ], "filename": "astronomy.js", "lineno": 3008, @@ -30611,8 +30611,8 @@ "comment": "", "meta": { "range": [ - 138049, - 138066 + 138044, + 138061 ], "filename": "astronomy.js", "lineno": 3009, @@ -30636,8 +30636,8 @@ "comment": "", "meta": { "range": [ - 138082, - 138117 + 138077, + 138112 ], "filename": "astronomy.js", "lineno": 3010, @@ -30661,8 +30661,8 @@ "comment": "", "meta": { "range": [ - 138355, - 138388 + 138350, + 138383 ], "filename": "astronomy.js", "lineno": 3018, @@ -30685,8 +30685,8 @@ "comment": "/**\n * @brief Calculates the distance between a body and the Sun at a given time.\n *\n * Given a date and time, this function calculates the distance between\n * the center of `body` and the center of the Sun.\n * For the planets Mercury through Neptune, this function is significantly\n * more efficient than calling {@link HelioVector} followed by taking the length\n * of the resulting vector.\n *\n * @param {Body} body\n * A body for which to calculate a heliocentric distance:\n * the Sun, Moon, or any of the planets.\n *\n * @param {FlexibleDateTime} date\n * The date and time for which to calculate the heliocentric distance.\n *\n * @returns {number}\n * The heliocentric distance in AU.\n */", "meta": { "range": [ - 139100, - 139328 + 139095, + 139323 ], "filename": "astronomy.js", "lineno": 3039, @@ -30751,8 +30751,8 @@ "comment": "", "meta": { "range": [ - 139147, - 139168 + 139142, + 139163 ], "filename": "astronomy.js", "lineno": 3040, @@ -30776,8 +30776,8 @@ "comment": "", "meta": { "range": [ - 139329, - 139366 + 139324, + 139361 ], "filename": "astronomy.js", "lineno": 3046, @@ -30800,8 +30800,8 @@ "comment": "/**\n * @brief Calculates a vector from the center of the Earth to the given body at the given time.\n *\n * Calculates geocentric (i.e., with respect to the center of the Earth)\n * Cartesian coordinates in the J2000 equatorial system of a celestial\n * body at a specified time. The position is always corrected for light travel time:\n * this means the position of the body is \"back-dated\" based on how long it\n * takes light to travel from the body to an observer on the Earth.\n * Also, the position can optionally be corrected for aberration, an effect\n * causing the apparent direction of the body to be shifted based on\n * transverse movement of the Earth with respect to the rays of light\n * coming from that body.\n *\n * @param {Body} body\n * One of the strings\n * `\"Sun\"`, `\"Moon\"`, `\"Mercury\"`, `\"Venus\"`,\n * `\"Earth\"`, `\"Mars\"`, `\"Jupiter\"`, `\"Saturn\"`,\n * `\"Uranus\"`, `\"Neptune\"`, or `\"Pluto\"`.\n *\n * @param {FlexibleDateTime} date\n * The date and time for which the body's position is to be calculated.\n *\n * @param {bool} aberration\n * Pass `true` to correct for\n * aberration,\n * or `false` to leave uncorrected.\n *\n * @returns {Vector}\n */", "meta": { "range": [ - 140622, - 142642 + 140617, + 142637 ], "filename": "astronomy.js", "lineno": 3076, @@ -30882,8 +30882,8 @@ "comment": "", "meta": { "range": [ - 140708, - 140729 + 140703, + 140724 ], "filename": "astronomy.js", "lineno": 3078, @@ -30907,8 +30907,8 @@ "comment": "", "meta": { "range": [ - 140884, - 140896 + 140879, + 140891 ], "filename": "astronomy.js", "lineno": 3085, @@ -30932,8 +30932,8 @@ "comment": "", "meta": { "range": [ - 140906, - 140907 + 140901, + 140902 ], "filename": "astronomy.js", "lineno": 3086, @@ -30955,8 +30955,8 @@ "comment": "", "meta": { "range": [ - 140917, - 140920 + 140912, + 140915 ], "filename": "astronomy.js", "lineno": 3087, @@ -30978,8 +30978,8 @@ "comment": "", "meta": { "range": [ - 140930, - 140936 + 140925, + 140931 ], "filename": "astronomy.js", "lineno": 3088, @@ -31003,8 +31003,8 @@ "comment": "", "meta": { "range": [ - 140946, - 140958 + 140941, + 140953 ], "filename": "astronomy.js", "lineno": 3089, @@ -31028,8 +31028,8 @@ "comment": "", "meta": { "range": [ - 141064, - 141072 + 141059, + 141067 ], "filename": "astronomy.js", "lineno": 3091, @@ -31053,8 +31053,8 @@ "comment": "", "meta": { "range": [ - 141103, - 141131 + 141098, + 141126 ], "filename": "astronomy.js", "lineno": 3092, @@ -31079,8 +31079,8 @@ "comment": "", "meta": { "range": [ - 142041, - 142076 + 142036, + 142071 ], "filename": "astronomy.js", "lineno": 3107, @@ -31105,8 +31105,8 @@ "comment": "", "meta": { "range": [ - 142243, - 142277 + 142238, + 142272 ], "filename": "astronomy.js", "lineno": 3112, @@ -31131,8 +31131,8 @@ "comment": "", "meta": { "range": [ - 142311, - 142378 + 142306, + 142373 ], "filename": "astronomy.js", "lineno": 3115, @@ -31157,8 +31157,8 @@ "comment": "", "meta": { "range": [ - 142392, - 142438 + 142387, + 142433 ], "filename": "astronomy.js", "lineno": 3116, @@ -31182,8 +31182,8 @@ "comment": "", "meta": { "range": [ - 142448, - 142483 + 142443, + 142478 ], "filename": "astronomy.js", "lineno": 3117, @@ -31208,8 +31208,8 @@ "comment": "", "meta": { "range": [ - 142554, - 142568 + 142549, + 142563 ], "filename": "astronomy.js", "lineno": 3121, @@ -31234,8 +31234,8 @@ "comment": "", "meta": { "range": [ - 142643, - 142672 + 142638, + 142667 ], "filename": "astronomy.js", "lineno": 3125, @@ -31258,8 +31258,8 @@ "comment": "", "meta": { "range": [ - 142674, - 143701 + 142669, + 143696 ], "filename": "astronomy.js", "lineno": 3126, @@ -31300,8 +31300,8 @@ "comment": "", "meta": { "range": [ - 142724, - 142746 + 142719, + 142741 ], "filename": "astronomy.js", "lineno": 3127, @@ -31325,8 +31325,8 @@ "comment": "", "meta": { "range": [ - 142756, - 142773 + 142751, + 142768 ], "filename": "astronomy.js", "lineno": 3128, @@ -31350,8 +31350,8 @@ "comment": "", "meta": { "range": [ - 142783, - 142789 + 142778, + 142784 ], "filename": "astronomy.js", "lineno": 3129, @@ -31375,8 +31375,8 @@ "comment": "", "meta": { "range": [ - 142799, - 142800 + 142794, + 142795 ], "filename": "astronomy.js", "lineno": 3130, @@ -31398,8 +31398,8 @@ "comment": "", "meta": { "range": [ - 142993, - 143003 + 142988, + 142998 ], "filename": "astronomy.js", "lineno": 3137, @@ -31424,8 +31424,8 @@ "comment": "", "meta": { "range": [ - 143161, - 143182 + 143156, + 143177 ], "filename": "astronomy.js", "lineno": 3143, @@ -31449,8 +31449,8 @@ "comment": "", "meta": { "range": [ - 143241, - 143258 + 143236, + 143253 ], "filename": "astronomy.js", "lineno": 3146, @@ -31474,8 +31474,8 @@ "comment": "", "meta": { "range": [ - 143272, - 143296 + 143267, + 143291 ], "filename": "astronomy.js", "lineno": 3147, @@ -31499,8 +31499,8 @@ "comment": "", "meta": { "range": [ - 143310, - 143334 + 143305, + 143329 ], "filename": "astronomy.js", "lineno": 3148, @@ -31524,8 +31524,8 @@ "comment": "", "meta": { "range": [ - 143451, - 143457 + 143446, + 143452 ], "filename": "astronomy.js", "lineno": 3152, @@ -31550,8 +31550,8 @@ "comment": "", "meta": { "range": [ - 143522, - 143528 + 143517, + 143523 ], "filename": "astronomy.js", "lineno": 3155, @@ -31576,8 +31576,8 @@ "comment": "", "meta": { "range": [ - 143604, - 143619 + 143599, + 143614 ], "filename": "astronomy.js", "lineno": 3161, @@ -31601,8 +31601,8 @@ "comment": "", "meta": { "range": [ - 143629, - 143657 + 143624, + 143652 ], "filename": "astronomy.js", "lineno": 3162, @@ -31626,8 +31626,8 @@ "comment": "", "meta": { "range": [ - 143672, - 143676 + 143667, + 143671 ], "filename": "astronomy.js", "lineno": 3163, @@ -31649,8 +31649,8 @@ "comment": "", "meta": { "range": [ - 143678, - 143682 + 143673, + 143677 ], "filename": "astronomy.js", "lineno": 3163, @@ -31672,8 +31672,8 @@ "comment": "", "meta": { "range": [ - 143684, - 143696 + 143679, + 143691 ], "filename": "astronomy.js", "lineno": 3163, @@ -31762,8 +31762,8 @@ "comment": "/**\n * @brief Finds the time when a function ascends through zero.\n *\n * Search for next time t (such that t is between `t1` and `t2`)\n * that `func(t)` crosses from a negative value to a non-negative value.\n * The given function must have \"smooth\" behavior over the entire inclusive range [`t1`, `t2`],\n * meaning that it behaves like a continuous differentiable function.\n * It is not required that `t1` < `t2`; `t1` > `t2`\n * allows searching backward in time.\n * Note: `t1` and `t2` must be chosen such that there is no possibility\n * of more than one zero-crossing (ascending or descending), or it is possible\n * that the \"wrong\" event will be found (i.e. not the first event after t1)\n * or even that the function will return `null`, indicating that no event was found.\n *\n * @param {function(AstroTime): number} func\n * The function to find an ascending zero crossing for.\n * The function must accept a single parameter of type {@link AstroTime}\n * and return a numeric value.\n *\n * @param {AstroTime} t1\n * The lower time bound of a search window.\n *\n * @param {AstroTime} t2\n * The upper time bound of a search window.\n *\n * @param {SearchOptions | undefined} options\n * Options that can tune the behavior of the search.\n * Most callers can omit this argument.\n *\n * @returns {AstroTime | null}\n * If the search is successful, returns the date and time of the solution.\n * If the search fails, returns `null`.\n */", "meta": { "range": [ - 146291, - 149283 + 146286, + 149278 ], "filename": "astronomy.js", "lineno": 3222, @@ -31869,8 +31869,8 @@ "comment": "", "meta": { "range": [ - 146339, - 146422 + 146334, + 146417 ], "filename": "astronomy.js", "lineno": 3223, @@ -31894,8 +31894,8 @@ "comment": "", "meta": { "range": [ - 146434, - 146492 + 146429, + 146487 ], "filename": "astronomy.js", "lineno": 3224, @@ -31919,8 +31919,8 @@ "comment": "", "meta": { "range": [ - 146502, - 146544 + 146497, + 146539 ], "filename": "astronomy.js", "lineno": 3225, @@ -31944,8 +31944,8 @@ "comment": "", "meta": { "range": [ - 146554, - 146596 + 146549, + 146591 ], "filename": "astronomy.js", "lineno": 3226, @@ -31969,8 +31969,8 @@ "comment": "", "meta": { "range": [ - 146606, - 146616 + 146601, + 146611 ], "filename": "astronomy.js", "lineno": 3227, @@ -31994,8 +31994,8 @@ "comment": "", "meta": { "range": [ - 146626, - 146634 + 146621, + 146629 ], "filename": "astronomy.js", "lineno": 3228, @@ -32019,8 +32019,8 @@ "comment": "", "meta": { "range": [ - 146644, - 146694 + 146639, + 146689 ], "filename": "astronomy.js", "lineno": 3229, @@ -32044,8 +32044,8 @@ "comment": "", "meta": { "range": [ - 146704, - 146720 + 146699, + 146715 ], "filename": "astronomy.js", "lineno": 3230, @@ -32069,8 +32069,8 @@ "comment": "", "meta": { "range": [ - 146839, - 146874 + 146834, + 146869 ], "filename": "astronomy.js", "lineno": 3234, @@ -32094,8 +32094,8 @@ "comment": "", "meta": { "range": [ - 146888, - 146908 + 146883, + 146903 ], "filename": "astronomy.js", "lineno": 3235, @@ -32119,8 +32119,8 @@ "comment": "", "meta": { "range": [ - 147086, - 147100 + 147081, + 147095 ], "filename": "astronomy.js", "lineno": 3241, @@ -32145,8 +32145,8 @@ "comment": "", "meta": { "range": [ - 147127, - 147143 + 147122, + 147138 ], "filename": "astronomy.js", "lineno": 3243, @@ -32171,8 +32171,8 @@ "comment": "", "meta": { "range": [ - 147387, - 147441 + 147382, + 147436 ], "filename": "astronomy.js", "lineno": 3247, @@ -32196,8 +32196,8 @@ "comment": "", "meta": { "range": [ - 147593, - 147611 + 147588, + 147606 ], "filename": "astronomy.js", "lineno": 3251, @@ -32221,8 +32221,8 @@ "comment": "", "meta": { "range": [ - 147629, - 147639 + 147624, + 147634 ], "filename": "astronomy.js", "lineno": 3252, @@ -32246,8 +32246,8 @@ "comment": "", "meta": { "range": [ - 147978, - 148017 + 147973, + 148012 ], "filename": "astronomy.js", "lineno": 3259, @@ -32271,8 +32271,8 @@ "comment": "", "meta": { "range": [ - 148085, - 148114 + 148080, + 148109 ], "filename": "astronomy.js", "lineno": 3261, @@ -32296,8 +32296,8 @@ "comment": "", "meta": { "range": [ - 148140, - 148170 + 148135, + 148165 ], "filename": "astronomy.js", "lineno": 3262, @@ -32321,8 +32321,8 @@ "comment": "", "meta": { "range": [ - 148352, - 148368 + 148347, + 148363 ], "filename": "astronomy.js", "lineno": 3265, @@ -32346,8 +32346,8 @@ "comment": "", "meta": { "range": [ - 148402, - 148420 + 148397, + 148415 ], "filename": "astronomy.js", "lineno": 3266, @@ -32371,8 +32371,8 @@ "comment": "", "meta": { "range": [ - 148514, - 148524 + 148509, + 148519 ], "filename": "astronomy.js", "lineno": 3268, @@ -32397,8 +32397,8 @@ "comment": "", "meta": { "range": [ - 148558, - 148569 + 148553, + 148564 ], "filename": "astronomy.js", "lineno": 3269, @@ -32423,8 +32423,8 @@ "comment": "", "meta": { "range": [ - 148603, - 148613 + 148598, + 148608 ], "filename": "astronomy.js", "lineno": 3270, @@ -32449,8 +32449,8 @@ "comment": "", "meta": { "range": [ - 148647, - 148658 + 148642, + 148653 ], "filename": "astronomy.js", "lineno": 3271, @@ -32475,8 +32475,8 @@ "comment": "", "meta": { "range": [ - 148692, - 148701 + 148687, + 148696 ], "filename": "astronomy.js", "lineno": 3272, @@ -32501,8 +32501,8 @@ "comment": "", "meta": { "range": [ - 148735, - 148752 + 148730, + 148747 ], "filename": "astronomy.js", "lineno": 3273, @@ -32527,8 +32527,8 @@ "comment": "", "meta": { "range": [ - 148963, - 148972 + 148958, + 148967 ], "filename": "astronomy.js", "lineno": 3282, @@ -32553,8 +32553,8 @@ "comment": "", "meta": { "range": [ - 148986, - 148995 + 148981, + 148990 ], "filename": "astronomy.js", "lineno": 3283, @@ -32579,8 +32579,8 @@ "comment": "", "meta": { "range": [ - 149076, - 149085 + 149071, + 149080 ], "filename": "astronomy.js", "lineno": 3287, @@ -32605,8 +32605,8 @@ "comment": "", "meta": { "range": [ - 149099, - 149108 + 149094, + 149103 ], "filename": "astronomy.js", "lineno": 3288, @@ -32631,8 +32631,8 @@ "comment": "", "meta": { "range": [ - 149284, - 149307 + 149279, + 149302 ], "filename": "astronomy.js", "lineno": 3296, @@ -32655,8 +32655,8 @@ "comment": "", "meta": { "range": [ - 149309, - 149483 + 149304, + 149478 ], "filename": "astronomy.js", "lineno": 3297, @@ -32684,8 +32684,8 @@ "comment": "", "meta": { "range": [ - 149350, - 149363 + 149345, + 149358 ], "filename": "astronomy.js", "lineno": 3298, @@ -32709,8 +32709,8 @@ "comment": "", "meta": { "range": [ - 149400, - 149413 + 149395, + 149408 ], "filename": "astronomy.js", "lineno": 3300, @@ -32735,8 +32735,8 @@ "comment": "", "meta": { "range": [ - 149448, - 149461 + 149443, + 149456 ], "filename": "astronomy.js", "lineno": 3302, @@ -32761,8 +32761,8 @@ "comment": "", "meta": { "range": [ - 149484, - 149619 + 149479, + 149614 ], "filename": "astronomy.js", "lineno": 3305, @@ -32790,8 +32790,8 @@ "comment": "", "meta": { "range": [ - 149547, - 149557 + 149542, + 149552 ], "filename": "astronomy.js", "lineno": 3307, @@ -32816,8 +32816,8 @@ "comment": "", "meta": { "range": [ - 149590, - 149600 + 149585, + 149595 ], "filename": "astronomy.js", "lineno": 3309, @@ -32842,8 +32842,8 @@ "comment": "/**\n * @brief Searches for when the Sun reaches a given ecliptic longitude.\n *\n * Searches for the moment in time when the center of the Sun reaches a given apparent\n * ecliptic longitude, as seen from the center of the Earth, within a given range of dates.\n * This function can be used to determine equinoxes and solstices.\n * However, it is usually more convenient and efficient to call {@link Seasons}\n * to calculate equinoxes and solstices for a given calendar year.\n * `SearchSunLongitude` is more general in that it allows searching for arbitrary longitude values.\n *\n * @param {number} targetLon\n * The desired ecliptic longitude of date in degrees.\n * This may be any value in the range [0, 360), although certain\n * values have conventional meanings:\n *\n * When `targetLon` is 0, finds the March equinox,\n * which is the moment spring begins in the northern hemisphere\n * and the beginning of autumn in the southern hemisphere.\n *\n * When `targetLon` is 180, finds the September equinox,\n * which is the moment autumn begins in the northern hemisphere and\n * spring begins in the southern hemisphere.\n *\n * When `targetLon` is 90, finds the northern solstice, which is the\n * moment summer begins in the northern hemisphere and winter\n * begins in the southern hemisphere.\n *\n * When `targetLon` is 270, finds the southern solstice, which is the\n * moment winter begins in the northern hemisphere and summer\n * begins in the southern hemisphere.\n *\n * @param {FlexibleDateTime} dateStart\n * A date and time known to be earlier than the desired longitude event.\n *\n * @param {number} limitDays\n * A floating point number of days, which when added to `dateStart`,\n * yields a date and time known to be after the desired longitude event.\n *\n * @returns {AstroTime | null}\n * The date and time when the Sun reaches the apparent ecliptic longitude `targetLon`\n * within the range of times specified by `dateStart` and `limitDays`.\n * If the Sun does not reach the target longitude within the specified time range, or the\n * time range is excessively wide, the return value is `null`.\n * To avoid a `null` return value, the caller must pick a time window around\n * the event that is within a few days but not so small that the event might fall outside the window.\n */", "meta": { "range": [ - 152012, - 152366 + 152007, + 152361 ], "filename": "astronomy.js", "lineno": 3358, @@ -32921,8 +32921,8 @@ "comment": "", "meta": { "range": [ - 152079, - 152197 + 152074, + 152192 ], "filename": "astronomy.js", "lineno": 3359, @@ -32951,8 +32951,8 @@ "comment": "", "meta": { "range": [ - 152116, - 152136 + 152111, + 152131 ], "filename": "astronomy.js", "lineno": 3360, @@ -32976,8 +32976,8 @@ "comment": "", "meta": { "range": [ - 152264, - 152288 + 152259, + 152283 ], "filename": "astronomy.js", "lineno": 3365, @@ -33001,8 +33001,8 @@ "comment": "", "meta": { "range": [ - 152298, - 152324 + 152293, + 152319 ], "filename": "astronomy.js", "lineno": 3366, @@ -33026,8 +33026,8 @@ "comment": "", "meta": { "range": [ - 152367, - 152414 + 152362, + 152409 ], "filename": "astronomy.js", "lineno": 3369, @@ -33050,8 +33050,8 @@ "comment": "/**\n * @brief Calculates the longitude separation between the Sun and the given body.\n *\n * Calculates the ecliptic longitude difference\n * between the given body and the Sun as seen from\n * the Earth at a given moment in time.\n * The returned value ranges [0, 360) degrees.\n * By definition, the Earth and the Sun are both in the plane of the ecliptic.\n * Ignores the height of the `body` above or below the ecliptic plane;\n * the resulting angle is measured around the ecliptic plane for the \"shadow\"\n * of the body onto that plane.\n *\n * Use {@link AngleFromSun} instead, if you wish to calculate the full angle\n * between the Sun and a body, instead of just their longitude difference.\n *\n * @param {Body} body\n * The name of a supported celestial body other than the Earth.\n *\n * @param {FlexibleDateTime} date\n * The time at which the relative longitude is to be found.\n *\n * @returns {number}\n * An angle in degrees in the range [0, 360).\n * Values less than 180 indicate that the body is to the east\n * of the Sun as seen from the Earth; that is, the body sets after\n * the Sun does and is visible in the evening sky.\n * Values greater than 180 indicate that the body is to the west of\n * the Sun and is visible in the morning sky.\n */", "meta": { "range": [ - 153700, - 154070 + 153695, + 154065 ], "filename": "astronomy.js", "lineno": 3399, @@ -33120,8 +33120,8 @@ "comment": "", "meta": { "range": [ - 153853, - 153871 + 153848, + 153866 ], "filename": "astronomy.js", "lineno": 3402, @@ -33145,8 +33145,8 @@ "comment": "", "meta": { "range": [ - 153883, - 153913 + 153878, + 153908 ], "filename": "astronomy.js", "lineno": 3403, @@ -33170,8 +33170,8 @@ "comment": "", "meta": { "range": [ - 153925, - 153942 + 153920, + 153937 ], "filename": "astronomy.js", "lineno": 3404, @@ -33195,8 +33195,8 @@ "comment": "", "meta": { "range": [ - 153954, - 153988 + 153949, + 153983 ], "filename": "astronomy.js", "lineno": 3405, @@ -33220,8 +33220,8 @@ "comment": "", "meta": { "range": [ - 154000, - 154017 + 153995, + 154012 ], "filename": "astronomy.js", "lineno": 3406, @@ -33245,8 +33245,8 @@ "comment": "", "meta": { "range": [ - 154071, - 154114 + 154066, + 154109 ], "filename": "astronomy.js", "lineno": 3409, @@ -33269,8 +33269,8 @@ "comment": "/**\n * @brief Calculates the angular separation between the Sun and the given body.\n *\n * Returns the full angle seen from\n * the Earth, between the given body and the Sun.\n * Unlike {@link LongitudeFromSun}, this function does not\n * project the body's \"shadow\" onto the ecliptic;\n * the angle is measured in 3D space around the plane that\n * contains the centers of the Earth, the Sun, and `body`.\n *\n * @param {Body} body\n * The name of a supported celestial body other than the Earth.\n *\n * @param {FlexibleDateTime} date\n * The time at which the angle from the Sun is to be found.\n *\n * @returns {number}\n * An angle in degrees in the range [0, 180].\n */", "meta": { "range": [ - 154791, - 155071 + 154786, + 155066 ], "filename": "astronomy.js", "lineno": 3429, @@ -33337,8 +33337,8 @@ "comment": "", "meta": { "range": [ - 154934, - 154970 + 154929, + 154965 ], "filename": "astronomy.js", "lineno": 3432, @@ -33362,8 +33362,8 @@ "comment": "", "meta": { "range": [ - 154980, - 155012 + 154975, + 155007 ], "filename": "astronomy.js", "lineno": 3433, @@ -33387,8 +33387,8 @@ "comment": "", "meta": { "range": [ - 155022, - 155050 + 155017, + 155045 ], "filename": "astronomy.js", "lineno": 3434, @@ -33412,8 +33412,8 @@ "comment": "", "meta": { "range": [ - 155072, - 155107 + 155067, + 155102 ], "filename": "astronomy.js", "lineno": 3437, @@ -33436,8 +33436,8 @@ "comment": "/**\n * @brief Calculates heliocentric ecliptic longitude based on the J2000 equinox.\n *\n * @param {Body} body\n * The name of a celestial body other than the Sun.\n *\n * @param {FlexibleDateTime} date\n * The date and time for which to calculate the ecliptic longitude.\n *\n * @returns {number}\n * The ecliptic longitude angle of the body in degrees measured counterclockwise around the mean\n * plane of the Earth's orbit, as seen from above the Sun's north pole.\n * Ecliptic longitude starts at 0 at the J2000\n * equinox and\n * increases in the same direction the Earth orbits the Sun.\n * The returned value is always in the range [0, 360).\n */", "meta": { "range": [ - 155867, - 156100 + 155862, + 156095 ], "filename": "astronomy.js", "lineno": 3455, @@ -33503,8 +33503,8 @@ "comment": "", "meta": { "range": [ - 156014, - 156042 + 156009, + 156037 ], "filename": "astronomy.js", "lineno": 3458, @@ -33528,8 +33528,8 @@ "comment": "", "meta": { "range": [ - 156054, - 156074 + 156049, + 156069 ], "filename": "astronomy.js", "lineno": 3459, @@ -33553,8 +33553,8 @@ "comment": "", "meta": { "range": [ - 156101, - 156146 + 156096, + 156141 ], "filename": "astronomy.js", "lineno": 3462, @@ -33577,8 +33577,8 @@ "comment": "", "meta": { "range": [ - 156148, - 157442 + 156143, + 157437 ], "filename": "astronomy.js", "lineno": 3463, @@ -33614,8 +33614,8 @@ "comment": "", "meta": { "range": [ - 156304, - 156306 + 156299, + 156301 ], "filename": "astronomy.js", "lineno": 3465, @@ -33637,8 +33637,8 @@ "comment": "", "meta": { "range": [ - 156308, - 156314 + 156303, + 156309 ], "filename": "astronomy.js", "lineno": 3465, @@ -33662,8 +33662,8 @@ "comment": "", "meta": { "range": [ - 156316, - 156322 + 156311, + 156317 ], "filename": "astronomy.js", "lineno": 3465, @@ -33687,8 +33687,8 @@ "comment": "", "meta": { "range": [ - 156324, - 156330 + 156319, + 156325 ], "filename": "astronomy.js", "lineno": 3465, @@ -33712,8 +33712,8 @@ "comment": "", "meta": { "range": [ - 156391, - 156401 + 156386, + 156396 ], "filename": "astronomy.js", "lineno": 3468, @@ -33738,8 +33738,8 @@ "comment": "", "meta": { "range": [ - 156415, - 156425 + 156410, + 156420 ], "filename": "astronomy.js", "lineno": 3469, @@ -33764,8 +33764,8 @@ "comment": "", "meta": { "range": [ - 156439, - 156449 + 156434, + 156444 ], "filename": "astronomy.js", "lineno": 3470, @@ -33790,8 +33790,8 @@ "comment": "", "meta": { "range": [ - 156463, - 156473 + 156458, + 156468 ], "filename": "astronomy.js", "lineno": 3471, @@ -33816,8 +33816,8 @@ "comment": "", "meta": { "range": [ - 156568, - 156578 + 156563, + 156573 ], "filename": "astronomy.js", "lineno": 3475, @@ -33842,8 +33842,8 @@ "comment": "", "meta": { "range": [ - 156596, - 156606 + 156591, + 156601 ], "filename": "astronomy.js", "lineno": 3476, @@ -33868,8 +33868,8 @@ "comment": "", "meta": { "range": [ - 156624, - 156634 + 156619, + 156629 ], "filename": "astronomy.js", "lineno": 3477, @@ -33894,8 +33894,8 @@ "comment": "", "meta": { "range": [ - 156652, - 156662 + 156647, + 156657 ], "filename": "astronomy.js", "lineno": 3478, @@ -33920,8 +33920,8 @@ "comment": "", "meta": { "range": [ - 156713, - 156722 + 156708, + 156717 ], "filename": "astronomy.js", "lineno": 3481, @@ -33946,8 +33946,8 @@ "comment": "", "meta": { "range": [ - 156740, - 156750 + 156735, + 156745 ], "filename": "astronomy.js", "lineno": 3482, @@ -33972,8 +33972,8 @@ "comment": "", "meta": { "range": [ - 156821, - 156831 + 156816, + 156826 ], "filename": "astronomy.js", "lineno": 3486, @@ -33998,8 +33998,8 @@ "comment": "", "meta": { "range": [ - 156845, - 156855 + 156840, + 156850 ], "filename": "astronomy.js", "lineno": 3487, @@ -34024,8 +34024,8 @@ "comment": "", "meta": { "range": [ - 156915, - 156925 + 156910, + 156920 ], "filename": "astronomy.js", "lineno": 3490, @@ -34050,8 +34050,8 @@ "comment": "", "meta": { "range": [ - 156939, - 156949 + 156934, + 156944 ], "filename": "astronomy.js", "lineno": 3491, @@ -34076,8 +34076,8 @@ "comment": "", "meta": { "range": [ - 157008, - 157018 + 157003, + 157013 ], "filename": "astronomy.js", "lineno": 3494, @@ -34102,8 +34102,8 @@ "comment": "", "meta": { "range": [ - 157032, - 157042 + 157027, + 157037 ], "filename": "astronomy.js", "lineno": 3495, @@ -34128,8 +34128,8 @@ "comment": "", "meta": { "range": [ - 157102, - 157112 + 157097, + 157107 ], "filename": "astronomy.js", "lineno": 3498, @@ -34154,8 +34154,8 @@ "comment": "", "meta": { "range": [ - 157170, - 157180 + 157165, + 157175 ], "filename": "astronomy.js", "lineno": 3501, @@ -34180,8 +34180,8 @@ "comment": "", "meta": { "range": [ - 157194, - 157204 + 157189, + 157199 ], "filename": "astronomy.js", "lineno": 3502, @@ -34206,8 +34206,8 @@ "comment": "", "meta": { "range": [ - 157309, - 157324 + 157304, + 157319 ], "filename": "astronomy.js", "lineno": 3506, @@ -34231,8 +34231,8 @@ "comment": "", "meta": { "range": [ - 157334, - 157373 + 157329, + 157368 ], "filename": "astronomy.js", "lineno": 3507, @@ -34256,8 +34256,8 @@ "comment": "", "meta": { "range": [ - 157379, - 157423 + 157374, + 157418 ], "filename": "astronomy.js", "lineno": 3508, @@ -34282,8 +34282,8 @@ "comment": "", "meta": { "range": [ - 157443, - 158493 + 157438, + 158488 ], "filename": "astronomy.js", "lineno": 3511, @@ -34322,8 +34322,8 @@ "comment": "", "meta": { "range": [ - 157765, - 157785 + 157760, + 157780 ], "filename": "astronomy.js", "lineno": 3516, @@ -34347,8 +34347,8 @@ "comment": "", "meta": { "range": [ - 157797, - 157825 + 157792, + 157820 ], "filename": "astronomy.js", "lineno": 3517, @@ -34372,8 +34372,8 @@ "comment": "", "meta": { "range": [ - 157891, - 157944 + 157886, + 157939 ], "filename": "astronomy.js", "lineno": 3518, @@ -34397,8 +34397,8 @@ "comment": "", "meta": { "range": [ - 158060, - 158094 + 158055, + 158089 ], "filename": "astronomy.js", "lineno": 3520, @@ -34422,8 +34422,8 @@ "comment": "", "meta": { "range": [ - 158106, - 158140 + 158101, + 158135 ], "filename": "astronomy.js", "lineno": 3521, @@ -34447,8 +34447,8 @@ "comment": "", "meta": { "range": [ - 158152, - 158250 + 158147, + 158245 ], "filename": "astronomy.js", "lineno": 3522, @@ -34472,8 +34472,8 @@ "comment": "", "meta": { "range": [ - 158262, - 158297 + 158257, + 158292 ], "filename": "astronomy.js", "lineno": 3523, @@ -34497,8 +34497,8 @@ "comment": "", "meta": { "range": [ - 158307, - 158333 + 158302, + 158328 ], "filename": "astronomy.js", "lineno": 3524, @@ -34522,8 +34522,8 @@ "comment": "", "meta": { "range": [ - 158339, - 158380 + 158334, + 158375 ], "filename": "astronomy.js", "lineno": 3525, @@ -34548,8 +34548,8 @@ "comment": "", "meta": { "range": [ - 158386, - 158430 + 158381, + 158425 ], "filename": "astronomy.js", "lineno": 3526, @@ -34574,8 +34574,8 @@ "comment": "", "meta": { "range": [ - 158445, - 158453 + 158440, + 158448 ], "filename": "astronomy.js", "lineno": 3527, @@ -34597,8 +34597,8 @@ "comment": "", "meta": { "range": [ - 158455, - 158488 + 158450, + 158483 ], "filename": "astronomy.js", "lineno": 3527, @@ -34620,8 +34620,8 @@ "comment": "", "meta": { "range": [ - 158494, - 159016 + 158489, + 159011 ], "filename": "astronomy.js", "lineno": 3529, @@ -34656,8 +34656,8 @@ "comment": "", "meta": { "range": [ - 158689, - 158718 + 158684, + 158713 ], "filename": "astronomy.js", "lineno": 3531, @@ -34681,8 +34681,8 @@ "comment": "", "meta": { "range": [ - 158728, - 158744 + 158723, + 158739 ], "filename": "astronomy.js", "lineno": 3532, @@ -34706,8 +34706,8 @@ "comment": "", "meta": { "range": [ - 158754, - 158772 + 158749, + 158767 ], "filename": "astronomy.js", "lineno": 3533, @@ -34731,8 +34731,8 @@ "comment": "", "meta": { "range": [ - 158782, - 158834 + 158777, + 158829 ], "filename": "astronomy.js", "lineno": 3534, @@ -34756,8 +34756,8 @@ "comment": "", "meta": { "range": [ - 158846, - 158898 + 158841, + 158893 ], "filename": "astronomy.js", "lineno": 3535, @@ -34781,8 +34781,8 @@ "comment": "", "meta": { "range": [ - 158908, - 158949 + 158903, + 158944 ], "filename": "astronomy.js", "lineno": 3536, @@ -34806,8 +34806,8 @@ "comment": "", "meta": { "range": [ - 158955, - 158997 + 158950, + 158992 ], "filename": "astronomy.js", "lineno": 3537, @@ -34832,8 +34832,8 @@ "comment": "/**\n * @brief Information about the apparent brightness and sunlit phase of a celestial object.\n *\n * @property {AstroTime} time\n * The date and time pertaining to the other calculated values in this object.\n *\n * @property {number} mag\n * The apparent visual magnitude of the celestial body.\n *\n * @property {number} phase_angle\n * The angle in degrees as seen from the center of the celestial body between the Sun and the Earth.\n * The value is always in the range 0 to 180.\n * The phase angle provides a measure of what fraction of the body's face appears\n * illuminated by the Sun as seen from the Earth.\n * When the observed body is the Sun, the `phase` property is set to 0,\n * although this has no physical meaning because the Sun emits, rather than reflects, light.\n * When the phase is near 0 degrees, the body appears \"full\".\n * When it is 90 degrees, the body appears \"half full\".\n * And when it is 180 degrees, the body appears \"new\" and is very difficult to see\n * because it is both dim and lost in the Sun's glare as seen from the Earth.\n *\n * @property {number} phase_fraction\n * The fraction of the body's face that is illuminated by the Sun, as seen from the Earth.\n * Calculated from `phase_angle` for convenience.\n * This value ranges from 0 to 1.\n *\n * @property {number} helio_dist\n * The distance between the center of the Sun and the center of the body in\n * astronomical units (AU).\n *\n * @property {number} geo_dist\n * The distance between the center of the Earth and the center of the body in AU.\n *\n * @property {Vector} gc\n * Geocentric coordinates: the 3D vector from the center of the Earth to the center of the body.\n * The components are in expressed in AU and are oriented with respect to the J2000 equatorial plane.\n *\n * @property {Vector} hc\n * Heliocentric coordinates: The 3D vector from the center of the Sun to the center of the body.\n * Like `gc`, `hc` is expressed in AU and oriented with respect\n * to the J2000 equatorial plane.\n *\n * @property {number | undefined} ring_tilt\n * For Saturn, this is the angular tilt of the planet's rings in degrees away\n * from the line of sight from the Earth. When the value is near 0, the rings\n * appear edge-on from the Earth and are therefore difficult to see.\n * When `ring_tilt` approaches its maximum value (about 27 degrees),\n * the rings appear widest and brightest from the Earth.\n * Unlike the JPL Horizons online tool,\n * this library includes the effect of the ring tilt angle in the calculated value\n * for Saturn's visual magnitude.\n * For all bodies other than Saturn, the value of `ring_tilt` is `undefined`.\n */", "meta": { "range": [ - 161965, - 162403 + 161960, + 162398 ], "filename": "astronomy.js", "lineno": 3593, @@ -34956,8 +34956,8 @@ "comment": "", "meta": { "range": [ - 161994, - 162401 + 161989, + 162396 ], "filename": "astronomy.js", "lineno": 3594, @@ -34992,8 +34992,8 @@ "comment": "/**\n * @brief Information about the apparent brightness and sunlit phase of a celestial object.\n *\n * @property {AstroTime} time\n * The date and time pertaining to the other calculated values in this object.\n *\n * @property {number} mag\n * The apparent visual magnitude of the celestial body.\n *\n * @property {number} phase_angle\n * The angle in degrees as seen from the center of the celestial body between the Sun and the Earth.\n * The value is always in the range 0 to 180.\n * The phase angle provides a measure of what fraction of the body's face appears\n * illuminated by the Sun as seen from the Earth.\n * When the observed body is the Sun, the `phase` property is set to 0,\n * although this has no physical meaning because the Sun emits, rather than reflects, light.\n * When the phase is near 0 degrees, the body appears \"full\".\n * When it is 90 degrees, the body appears \"half full\".\n * And when it is 180 degrees, the body appears \"new\" and is very difficult to see\n * because it is both dim and lost in the Sun's glare as seen from the Earth.\n *\n * @property {number} phase_fraction\n * The fraction of the body's face that is illuminated by the Sun, as seen from the Earth.\n * Calculated from `phase_angle` for convenience.\n * This value ranges from 0 to 1.\n *\n * @property {number} helio_dist\n * The distance between the center of the Sun and the center of the body in\n * astronomical units (AU).\n *\n * @property {number} geo_dist\n * The distance between the center of the Earth and the center of the body in AU.\n *\n * @property {Vector} gc\n * Geocentric coordinates: the 3D vector from the center of the Earth to the center of the body.\n * The components are in expressed in AU and are oriented with respect to the J2000 equatorial plane.\n *\n * @property {Vector} hc\n * Heliocentric coordinates: The 3D vector from the center of the Sun to the center of the body.\n * Like `gc`, `hc` is expressed in AU and oriented with respect\n * to the J2000 equatorial plane.\n *\n * @property {number | undefined} ring_tilt\n * For Saturn, this is the angular tilt of the planet's rings in degrees away\n * from the line of sight from the Earth. When the value is near 0, the rings\n * appear edge-on from the Earth and are therefore difficult to see.\n * When `ring_tilt` approaches its maximum value (about 27 degrees),\n * the rings appear widest and brightest from the Earth.\n * Unlike the JPL Horizons online tool,\n * this library includes the effect of the ring tilt angle in the calculated value\n * for Saturn's visual magnitude.\n * For all bodies other than Saturn, the value of `ring_tilt` is `undefined`.\n */", "meta": { "range": [ - 161965, - 162403 + 161960, + 162398 ], "filename": "astronomy.js", "lineno": 3593, @@ -35115,8 +35115,8 @@ "comment": "", "meta": { "range": [ - 162081, - 162097 + 162076, + 162092 ], "filename": "astronomy.js", "lineno": 3595, @@ -35140,8 +35140,8 @@ "comment": "", "meta": { "range": [ - 162107, - 162121 + 162102, + 162116 ], "filename": "astronomy.js", "lineno": 3596, @@ -35165,8 +35165,8 @@ "comment": "", "meta": { "range": [ - 162131, - 162161 + 162126, + 162156 ], "filename": "astronomy.js", "lineno": 3597, @@ -35190,8 +35190,8 @@ "comment": "", "meta": { "range": [ - 162171, - 162199 + 162166, + 162194 ], "filename": "astronomy.js", "lineno": 3598, @@ -35215,8 +35215,8 @@ "comment": "", "meta": { "range": [ - 162209, - 162233 + 162204, + 162228 ], "filename": "astronomy.js", "lineno": 3599, @@ -35240,8 +35240,8 @@ "comment": "", "meta": { "range": [ - 162243, - 162255 + 162238, + 162250 ], "filename": "astronomy.js", "lineno": 3600, @@ -35265,8 +35265,8 @@ "comment": "", "meta": { "range": [ - 162265, - 162277 + 162260, + 162272 ], "filename": "astronomy.js", "lineno": 3601, @@ -35290,8 +35290,8 @@ "comment": "", "meta": { "range": [ - 162287, - 162313 + 162282, + 162308 ], "filename": "astronomy.js", "lineno": 3602, @@ -35315,8 +35315,8 @@ "comment": "", "meta": { "range": [ - 162323, - 162394 + 162318, + 162389 ], "filename": "astronomy.js", "lineno": 3603, @@ -35340,8 +35340,8 @@ "comment": "", "meta": { "range": [ - 162404, - 162447 + 162399, + 162442 ], "filename": "astronomy.js", "lineno": 3606, @@ -35364,8 +35364,8 @@ "comment": "/**\n * @brief Calculates visual magnitude and related information about a body.\n *\n * Calculates the phase angle, visual magnitude,\n * and other values relating to the body's illumination\n * at the given date and time, as seen from the Earth.\n *\n * @param {Body} body\n * The name of the celestial body being observed.\n * Not allowed to be `\"Earth\"`.\n *\n * @param {FlexibleDateTime} date\n * The date and time for which to calculate the illumination data for the given body.\n *\n * @returns {IlluminationInfo}\n */", "meta": { "range": [ - 162975, - 164912 + 162970, + 164907 ], "filename": "astronomy.js", "lineno": 3623, @@ -35438,8 +35438,8 @@ "comment": "", "meta": { "range": [ - 163113, - 163134 + 163108, + 163129 ], "filename": "astronomy.js", "lineno": 3626, @@ -35463,8 +35463,8 @@ "comment": "", "meta": { "range": [ - 163146, - 163180 + 163141, + 163175 ], "filename": "astronomy.js", "lineno": 3627, @@ -35488,8 +35488,8 @@ "comment": "", "meta": { "range": [ - 163190, - 163195 + 163185, + 163190 ], "filename": "astronomy.js", "lineno": 3628, @@ -35511,8 +35511,8 @@ "comment": "", "meta": { "range": [ - 163271, - 163273 + 163266, + 163268 ], "filename": "astronomy.js", "lineno": 3629, @@ -35534,8 +35534,8 @@ "comment": "", "meta": { "range": [ - 163310, - 163312 + 163305, + 163307 ], "filename": "astronomy.js", "lineno": 3630, @@ -35557,8 +35557,8 @@ "comment": "", "meta": { "range": [ - 163351, - 163354 + 163346, + 163349 ], "filename": "astronomy.js", "lineno": 3631, @@ -35580,8 +35580,8 @@ "comment": "", "meta": { "range": [ - 163413, - 163464 + 163408, + 163459 ], "filename": "astronomy.js", "lineno": 3633, @@ -35606,8 +35606,8 @@ "comment": "", "meta": { "range": [ - 163474, - 163504 + 163469, + 163499 ], "filename": "astronomy.js", "lineno": 3634, @@ -35632,8 +35632,8 @@ "comment": "", "meta": { "range": [ - 163514, - 163523 + 163509, + 163518 ], "filename": "astronomy.js", "lineno": 3635, @@ -35658,8 +35658,8 @@ "comment": "", "meta": { "range": [ - 163785, - 163803 + 163780, + 163798 ], "filename": "astronomy.js", "lineno": 3640, @@ -35684,8 +35684,8 @@ "comment": "", "meta": { "range": [ - 163817, - 163886 + 163812, + 163881 ], "filename": "astronomy.js", "lineno": 3641, @@ -35710,8 +35710,8 @@ "comment": "", "meta": { "range": [ - 164002, - 164030 + 163997, + 164025 ], "filename": "astronomy.js", "lineno": 3645, @@ -35736,8 +35736,8 @@ "comment": "", "meta": { "range": [ - 164044, - 164113 + 164039, + 164108 ], "filename": "astronomy.js", "lineno": 3646, @@ -35762,8 +35762,8 @@ "comment": "", "meta": { "range": [ - 164133, - 164161 + 164128, + 164156 ], "filename": "astronomy.js", "lineno": 3648, @@ -35788,8 +35788,8 @@ "comment": "", "meta": { "range": [ - 164177, - 164199 + 164172, + 164194 ], "filename": "astronomy.js", "lineno": 3650, @@ -35813,8 +35813,8 @@ "comment": "", "meta": { "range": [ - 164250, - 164274 + 164245, + 164269 ], "filename": "astronomy.js", "lineno": 3651, @@ -35838,8 +35838,8 @@ "comment": "", "meta": { "range": [ - 164323, - 164332 + 164318, + 164327 ], "filename": "astronomy.js", "lineno": 3652, @@ -35861,8 +35861,8 @@ "comment": "", "meta": { "range": [ - 164399, - 164443 + 164394, + 164438 ], "filename": "astronomy.js", "lineno": 3654, @@ -35887,8 +35887,8 @@ "comment": "", "meta": { "range": [ - 164494, - 164542 + 164489, + 164537 ], "filename": "astronomy.js", "lineno": 3657, @@ -35913,8 +35913,8 @@ "comment": "", "meta": { "range": [ - 164601, - 164664 + 164596, + 164659 ], "filename": "astronomy.js", "lineno": 3660, @@ -35938,8 +35938,8 @@ "comment": "", "meta": { "range": [ - 164674, - 164690 + 164669, + 164685 ], "filename": "astronomy.js", "lineno": 3661, @@ -35964,8 +35964,8 @@ "comment": "", "meta": { "range": [ - 164700, - 164728 + 164695, + 164723 ], "filename": "astronomy.js", "lineno": 3662, @@ -35990,8 +35990,8 @@ "comment": "", "meta": { "range": [ - 164755, - 164811 + 164750, + 164806 ], "filename": "astronomy.js", "lineno": 3665, @@ -36016,8 +36016,8 @@ "comment": "", "meta": { "range": [ - 164913, - 164948 + 164908, + 164943 ], "filename": "astronomy.js", "lineno": 3669, @@ -36040,8 +36040,8 @@ "comment": "", "meta": { "range": [ - 164950, - 165861 + 164945, + 165856 ], "filename": "astronomy.js", "lineno": 3670, @@ -36072,8 +36072,8 @@ "comment": "", "meta": { "range": [ - 165482, - 165503 + 165477, + 165498 ], "filename": "astronomy.js", "lineno": 3679, @@ -36097,8 +36097,8 @@ "comment": "", "meta": { "range": [ - 165708, - 165739 + 165703, + 165734 ], "filename": "astronomy.js", "lineno": 3684, @@ -36122,8 +36122,8 @@ "comment": "", "meta": { "range": [ - 165751, - 165776 + 165746, + 165771 ], "filename": "astronomy.js", "lineno": 3685, @@ -36147,8 +36147,8 @@ "comment": "", "meta": { "range": [ - 165788, - 165832 + 165783, + 165827 ], "filename": "astronomy.js", "lineno": 3686, @@ -36172,8 +36172,8 @@ "comment": "/**\n * @brief Searches for when the Earth and a given body reach a relative ecliptic longitude separation.\n *\n * Searches for the date and time the relative ecliptic longitudes of\n * the specified body and the Earth, as seen from the Sun, reach a certain\n * difference. This function is useful for finding conjunctions and oppositions\n * of the planets. For the opposition of a superior planet (Mars, Jupiter, ..., Pluto),\n * or the inferior conjunction of an inferior planet (Mercury, Venus),\n * call with `targetRelLon` = 0. The 0 value indicates that both\n * planets are on the same ecliptic longitude line, ignoring the other planet's\n * distance above or below the plane of the Earth's orbit.\n * For superior conjunctions, call with `targetRelLon` = 180.\n * This means the Earth and the other planet are on opposite sides of the Sun.\n *\n * @param {Body} body\n * The name of a planet other than the Earth.\n *\n * @param {number} targetRelLon\n * The desired angular difference in degrees between the ecliptic longitudes\n * of `body` and the Earth. Must be in the range (-180, +180].\n *\n * @param {FlexibleDateTime} startDate\n * The date and time after which to find the next occurrence of the\n * body and the Earth reaching the desired relative longitude.\n *\n * @returns {AstroTime}\n * The time when the Earth and the body next reach the specified relative longitudes.\n */", "meta": { "range": [ - 167267, - 169509 + 167262, + 169504 ], "filename": "astronomy.js", "lineno": 3717, @@ -36257,8 +36257,8 @@ "comment": "", "meta": { "range": [ - 167375, - 167396 + 167370, + 167391 ], "filename": "astronomy.js", "lineno": 3719, @@ -36282,8 +36282,8 @@ "comment": "", "meta": { "range": [ - 167737, - 167810 + 167732, + 167805 ], "filename": "astronomy.js", "lineno": 3726, @@ -36307,8 +36307,8 @@ "comment": "", "meta": { "range": [ - 167816, - 168047 + 167811, + 168042 ], "filename": "astronomy.js", "lineno": 3727, @@ -36339,8 +36339,8 @@ "comment": "", "meta": { "range": [ - 167851, - 167884 + 167846, + 167879 ], "filename": "astronomy.js", "lineno": 3728, @@ -36364,8 +36364,8 @@ "comment": "", "meta": { "range": [ - 167900, - 167939 + 167895, + 167934 ], "filename": "astronomy.js", "lineno": 3729, @@ -36389,8 +36389,8 @@ "comment": "", "meta": { "range": [ - 167955, - 167987 + 167950, + 167982 ], "filename": "astronomy.js", "lineno": 3730, @@ -36414,8 +36414,8 @@ "comment": "", "meta": { "range": [ - 168056, - 168081 + 168051, + 168076 ], "filename": "astronomy.js", "lineno": 3733, @@ -36439,8 +36439,8 @@ "comment": "", "meta": { "range": [ - 168091, - 168117 + 168086, + 168112 ], "filename": "astronomy.js", "lineno": 3734, @@ -36464,8 +36464,8 @@ "comment": "", "meta": { "range": [ - 168322, - 168348 + 168317, + 168343 ], "filename": "astronomy.js", "lineno": 3738, @@ -36489,8 +36489,8 @@ "comment": "", "meta": { "range": [ - 168383, - 168401 + 168378, + 168396 ], "filename": "astronomy.js", "lineno": 3740, @@ -36515,8 +36515,8 @@ "comment": "", "meta": { "range": [ - 168451, - 168459 + 168446, + 168454 ], "filename": "astronomy.js", "lineno": 3741, @@ -36540,8 +36540,8 @@ "comment": "", "meta": { "range": [ - 168646, - 168685 + 168641, + 168680 ], "filename": "astronomy.js", "lineno": 3744, @@ -36565,8 +36565,8 @@ "comment": "", "meta": { "range": [ - 168695, - 168726 + 168690, + 168721 ], "filename": "astronomy.js", "lineno": 3745, @@ -36591,8 +36591,8 @@ "comment": "", "meta": { "range": [ - 168821, - 168845 + 168816, + 168840 ], "filename": "astronomy.js", "lineno": 3748, @@ -36616,8 +36616,8 @@ "comment": "", "meta": { "range": [ - 168855, - 168881 + 168850, + 168876 ], "filename": "astronomy.js", "lineno": 3749, @@ -36642,8 +36642,8 @@ "comment": "", "meta": { "range": [ - 169221, - 169268 + 169216, + 169263 ], "filename": "astronomy.js", "lineno": 3755, @@ -36667,8 +36667,8 @@ "comment": "", "meta": { "range": [ - 169338, - 169350 + 169333, + 169345 ], "filename": "astronomy.js", "lineno": 3757, @@ -36693,8 +36693,8 @@ "comment": "", "meta": { "range": [ - 169510, - 169567 + 169505, + 169562 ], "filename": "astronomy.js", "lineno": 3763, @@ -36717,8 +36717,8 @@ "comment": "/**\n * @brief Determines the moon's phase expressed as an ecliptic longitude.\n *\n * @param {FlexibleDateTime} date\n * The date and time for which to calculate the moon's phase.\n *\n * @returns {number}\n * A value in the range [0, 360) indicating the difference\n * in ecliptic longitude between the center of the Sun and the\n * center of the Moon, as seen from the center of the Earth.\n * Certain longitude values have conventional meanings:\n *\n * * 0 = new moon\n * * 90 = first quarter\n * * 180 = full moon\n * * 270 = third quarter\n */", "meta": { "range": [ - 170129, - 170203 + 170124, + 170198 ], "filename": "astronomy.js", "lineno": 3781, @@ -36770,8 +36770,8 @@ "comment": "", "meta": { "range": [ - 170204, - 170233 + 170199, + 170228 ], "filename": "astronomy.js", "lineno": 3784, @@ -36794,8 +36794,8 @@ "comment": "/**\n * @brief Searches for the date and time that the Moon reaches a specified phase.\n *\n * Lunar phases are defined in terms of geocentric ecliptic longitudes\n * with respect to the Sun. When the Moon and the Sun have the same ecliptic\n * longitude, that is defined as a new moon. When the two ecliptic longitudes\n * are 180 degrees apart, that is defined as a full moon.\n * To enumerate quarter lunar phases, it is simpler to call\n * {@link SearchMoonQuarter} once, followed by repeatedly calling\n * {@link NextMoonQuarter}. `SearchMoonPhase` is only\n * necessary for finding other lunar phases than the usual quarter phases.\n *\n * @param {number} targetLon\n * The difference in geocentric ecliptic longitude between the Sun and Moon\n * that specifies the lunar phase being sought. This can be any value\n * in the range [0, 360). Here are some helpful examples:\n * 0 = new moon,\n * 90 = first quarter,\n * 180 = full moon,\n * 270 = third quarter.\n *\n * @param {FlexibleDateTime} dateStart\n * The beginning of the window of time in which to search.\n *\n * @param {number} limitDays\n * The floating point number of days after `dateStart`\n * that limits the window of time in which to search.\n *\n * @returns {AstroTime | null}\n * If the specified lunar phase occurs after `dateStart`\n * and before `limitDays` days after `dateStart`,\n * this function returns the date and time of the first such occurrence.\n * Otherwise, it returns `null`.\n */", "meta": { "range": [ - 171747, - 173201 + 171742, + 173196 ], "filename": "astronomy.js", "lineno": 3819, @@ -36879,8 +36879,8 @@ "comment": "", "meta": { "range": [ - 171811, - 171925 + 171806, + 171920 ], "filename": "astronomy.js", "lineno": 3820, @@ -36909,8 +36909,8 @@ "comment": "", "meta": { "range": [ - 171849, - 171868 + 171844, + 171863 ], "filename": "astronomy.js", "lineno": 3821, @@ -36934,8 +36934,8 @@ "comment": "", "meta": { "range": [ - 172675, - 172692 + 172670, + 172687 ], "filename": "astronomy.js", "lineno": 3836, @@ -36959,8 +36959,8 @@ "comment": "", "meta": { "range": [ - 172702, - 172726 + 172697, + 172721 ], "filename": "astronomy.js", "lineno": 3837, @@ -36984,8 +36984,8 @@ "comment": "", "meta": { "range": [ - 172736, - 172756 + 172731, + 172751 ], "filename": "astronomy.js", "lineno": 3838, @@ -37009,8 +37009,8 @@ "comment": "", "meta": { "range": [ - 172782, - 172791 + 172777, + 172786 ], "filename": "astronomy.js", "lineno": 3840, @@ -37035,8 +37035,8 @@ "comment": "", "meta": { "range": [ - 172850, - 172891 + 172845, + 172886 ], "filename": "astronomy.js", "lineno": 3841, @@ -37060,8 +37060,8 @@ "comment": "", "meta": { "range": [ - 172901, - 172927 + 172896, + 172922 ], "filename": "astronomy.js", "lineno": 3842, @@ -37085,8 +37085,8 @@ "comment": "", "meta": { "range": [ - 173051, - 173098 + 173046, + 173093 ], "filename": "astronomy.js", "lineno": 3845, @@ -37110,8 +37110,8 @@ "comment": "", "meta": { "range": [ - 173108, - 173128 + 173103, + 173123 ], "filename": "astronomy.js", "lineno": 3846, @@ -37135,8 +37135,8 @@ "comment": "", "meta": { "range": [ - 173138, - 173158 + 173133, + 173153 ], "filename": "astronomy.js", "lineno": 3847, @@ -37160,8 +37160,8 @@ "comment": "", "meta": { "range": [ - 173202, - 173243 + 173197, + 173238 ], "filename": "astronomy.js", "lineno": 3850, @@ -37184,8 +37184,8 @@ "comment": "/**\n * @brief A quarter lunar phase, along with when it occurs.\n *\n * @property {number} quarter\n * An integer as follows:\n * 0 = new moon,\n * 1 = first quarter,\n * 2 = full moon,\n * 3 = third quarter.\n *\n * @property {AstroTime} time\n * The date and time of the quarter lunar phase.\n */", "meta": { "range": [ - 173563, - 173681 + 173558, + 173676 ], "filename": "astronomy.js", "lineno": 3864, @@ -37238,8 +37238,8 @@ "comment": "", "meta": { "range": [ - 173587, - 173679 + 173582, + 173674 ], "filename": "astronomy.js", "lineno": 3865, @@ -37268,8 +37268,8 @@ "comment": "/**\n * @brief A quarter lunar phase, along with when it occurs.\n *\n * @property {number} quarter\n * An integer as follows:\n * 0 = new moon,\n * 1 = first quarter,\n * 2 = full moon,\n * 3 = third quarter.\n *\n * @property {AstroTime} time\n * The date and time of the quarter lunar phase.\n */", "meta": { "range": [ - 173563, - 173681 + 173558, + 173676 ], "filename": "astronomy.js", "lineno": 3864, @@ -37321,8 +37321,8 @@ "comment": "", "meta": { "range": [ - 173624, - 173646 + 173619, + 173641 ], "filename": "astronomy.js", "lineno": 3866, @@ -37346,8 +37346,8 @@ "comment": "", "meta": { "range": [ - 173656, - 173672 + 173651, + 173667 ], "filename": "astronomy.js", "lineno": 3867, @@ -37371,8 +37371,8 @@ "comment": "", "meta": { "range": [ - 173682, - 173715 + 173677, + 173710 ], "filename": "astronomy.js", "lineno": 3870, @@ -37395,8 +37395,8 @@ "comment": "/**\n * @brief Finds the first quarter lunar phase after the specified date and time.\n *\n * The quarter lunar phases are: new moon, first quarter, full moon, and third quarter.\n * To enumerate quarter lunar phases, call `SearchMoonQuarter` once,\n * then pass its return value to {@link NextMoonQuarter} to find the next\n * `MoonQuarter`. Keep calling `NextMoonQuarter` in a loop,\n * passing the previous return value as the argument to the next call.\n *\n * @param {FlexibleDateTime} dateStart\n * The date and time after which to find the first quarter lunar phase.\n *\n * @returns {MoonQuarter}\n */", "meta": { "range": [ - 174319, - 174712 + 174314, + 174707 ], "filename": "astronomy.js", "lineno": 3885, @@ -37453,8 +37453,8 @@ "comment": "", "meta": { "range": [ - 174421, - 174454 + 174416, + 174449 ], "filename": "astronomy.js", "lineno": 3887, @@ -37478,8 +37478,8 @@ "comment": "", "meta": { "range": [ - 174464, - 174506 + 174459, + 174501 ], "filename": "astronomy.js", "lineno": 3888, @@ -37503,8 +37503,8 @@ "comment": "", "meta": { "range": [ - 174516, - 174548 + 174511, + 174543 ], "filename": "astronomy.js", "lineno": 3889, @@ -37528,8 +37528,8 @@ "comment": "", "meta": { "range": [ - 174558, - 174609 + 174553, + 174604 ], "filename": "astronomy.js", "lineno": 3890, @@ -37553,8 +37553,8 @@ "comment": "", "meta": { "range": [ - 174713, - 174758 + 174708, + 174753 ], "filename": "astronomy.js", "lineno": 3895, @@ -37577,8 +37577,8 @@ "comment": "/**\n * @brief Finds the next quarter lunar phase in a series.\n *\n * Given a {@link MoonQuarter} object, finds the next consecutive\n * quarter lunar phase. See remarks in {@link SearchMoonQuarter}\n * for explanation of usage.\n *\n * @param {MoonQuarter} mq\n * The return value of a prior call to {@link MoonQuarter} or `NextMoonQuarter`.\n */", "meta": { "range": [ - 175105, - 175462 + 175100, + 175457 ], "filename": "astronomy.js", "lineno": 3906, @@ -37623,8 +37623,8 @@ "comment": "", "meta": { "range": [ - 175363, - 175423 + 175358, + 175418 ], "filename": "astronomy.js", "lineno": 3910, @@ -37648,8 +37648,8 @@ "comment": "", "meta": { "range": [ - 175463, - 175504 + 175458, + 175499 ], "filename": "astronomy.js", "lineno": 3913, @@ -37672,8 +37672,8 @@ "comment": "", "meta": { "range": [ - 175506, - 175907 + 175501, + 175902 ], "filename": "astronomy.js", "lineno": 3914, @@ -37698,8 +37698,8 @@ "comment": "/**\n * @brief Finds the next rise or set time for a body.\n *\n * Finds a rise or set time for the given body as\n * seen by an observer at the specified location on the Earth.\n * Rise time is defined as the moment when the top of the body\n * is observed to first appear above the horizon in the east.\n * Set time is defined as the moment the top of the body\n * is observed to sink below the horizon in the west.\n * The times are adjusted for typical atmospheric refraction conditions.\n *\n * @param {Body} body\n * The name of the body to find the rise or set time for.\n *\n * @param {Observer} observer\n * Specifies the geographic coordinates and elevation above sea level of the observer.\n *\n * @param {number} direction\n * Either +1 to find rise time or -1 to find set time.\n * Any other value will cause an exception to be thrown.\n *\n * @param {FlexibleDateTime} dateStart\n * The date and time after which the specified rise or set time is to be found.\n *\n * @param {number} limitDays\n * The fractional number of days after `dateStart` that limits\n * when the rise or set time is to be found.\n *\n * @returns {AstroTime | null}\n * The date and time of the rise or set event, or null if no such event\n * occurs within the specified time window.\n */", "meta": { "range": [ - 177199, - 180995 + 177194, + 180990 ], "filename": "astronomy.js", "lineno": 3957, @@ -37805,8 +37805,8 @@ "comment": "", "meta": { "range": [ - 177340, - 177375 + 177335, + 177370 ], "filename": "astronomy.js", "lineno": 3960, @@ -37830,8 +37830,8 @@ "comment": "", "meta": { "range": [ - 177381, - 178204 + 177376, + 178199 ], "filename": "astronomy.js", "lineno": 3961, @@ -37862,8 +37862,8 @@ "comment": "", "meta": { "range": [ - 177942, - 177989 + 177937, + 177984 ], "filename": "astronomy.js", "lineno": 3970, @@ -37887,8 +37887,8 @@ "comment": "", "meta": { "range": [ - 178005, - 178054 + 178000, + 178049 ], "filename": "astronomy.js", "lineno": 3971, @@ -37912,8 +37912,8 @@ "comment": "", "meta": { "range": [ - 178070, - 178165 + 178065, + 178160 ], "filename": "astronomy.js", "lineno": 3972, @@ -37937,8 +37937,8 @@ "comment": "", "meta": { "range": [ - 178884, - 178893 + 178879, + 178888 ], "filename": "astronomy.js", "lineno": 3985, @@ -37960,8 +37960,8 @@ "comment": "", "meta": { "range": [ - 178895, - 178903 + 178890, + 178898 ], "filename": "astronomy.js", "lineno": 3985, @@ -37983,8 +37983,8 @@ "comment": "", "meta": { "range": [ - 178941, - 178955 + 178936, + 178950 ], "filename": "astronomy.js", "lineno": 3987, @@ -38009,8 +38009,8 @@ "comment": "", "meta": { "range": [ - 179025, - 179037 + 179020, + 179032 ], "filename": "astronomy.js", "lineno": 3988, @@ -38035,8 +38035,8 @@ "comment": "", "meta": { "range": [ - 179150, - 179163 + 179145, + 179158 ], "filename": "astronomy.js", "lineno": 3991, @@ -38061,8 +38061,8 @@ "comment": "", "meta": { "range": [ - 179218, - 179231 + 179213, + 179226 ], "filename": "astronomy.js", "lineno": 3992, @@ -38087,8 +38087,8 @@ "comment": "", "meta": { "range": [ - 179396, - 179428 + 179391, + 179423 ], "filename": "astronomy.js", "lineno": 3997, @@ -38112,8 +38112,8 @@ "comment": "", "meta": { "range": [ - 179438, - 179449 + 179433, + 179444 ], "filename": "astronomy.js", "lineno": 3998, @@ -38135,8 +38135,8 @@ "comment": "", "meta": { "range": [ - 179459, - 179469 + 179454, + 179464 ], "filename": "astronomy.js", "lineno": 3999, @@ -38158,8 +38158,8 @@ "comment": "", "meta": { "range": [ - 179479, - 179488 + 179474, + 179483 ], "filename": "astronomy.js", "lineno": 4000, @@ -38181,8 +38181,8 @@ "comment": "", "meta": { "range": [ - 179498, - 179536 + 179493, + 179531 ], "filename": "astronomy.js", "lineno": 4001, @@ -38206,8 +38206,8 @@ "comment": "", "meta": { "range": [ - 179546, - 179555 + 179541, + 179550 ], "filename": "astronomy.js", "lineno": 4002, @@ -38229,8 +38229,8 @@ "comment": "", "meta": { "range": [ - 179694, - 179761 + 179689, + 179756 ], "filename": "astronomy.js", "lineno": 4005, @@ -38255,8 +38255,8 @@ "comment": "", "meta": { "range": [ - 179771, - 179800 + 179766, + 179795 ], "filename": "astronomy.js", "lineno": 4006, @@ -38281,8 +38281,8 @@ "comment": "", "meta": { "range": [ - 179810, - 179849 + 179805, + 179844 ], "filename": "astronomy.js", "lineno": 4007, @@ -38307,8 +38307,8 @@ "comment": "", "meta": { "range": [ - 180033, - 180057 + 180028, + 180052 ], "filename": "astronomy.js", "lineno": 4012, @@ -38333,8 +38333,8 @@ "comment": "", "meta": { "range": [ - 180069, - 180135 + 180064, + 180130 ], "filename": "astronomy.js", "lineno": 4014, @@ -38359,8 +38359,8 @@ "comment": "", "meta": { "range": [ - 180141, - 180182 + 180136, + 180177 ], "filename": "astronomy.js", "lineno": 4015, @@ -38385,8 +38385,8 @@ "comment": "", "meta": { "range": [ - 180345, - 180445 + 180340, + 180440 ], "filename": "astronomy.js", "lineno": 4019, @@ -38410,8 +38410,8 @@ "comment": "", "meta": { "range": [ - 180403, - 180422 + 180398, + 180417 ], "filename": "astronomy.js", "lineno": 4019, @@ -38433,8 +38433,8 @@ "comment": "", "meta": { "range": [ - 180424, - 180442 + 180419, + 180437 ], "filename": "astronomy.js", "lineno": 4019, @@ -38456,8 +38456,8 @@ "comment": "", "meta": { "range": [ - 180606, - 180677 + 180601, + 180672 ], "filename": "astronomy.js", "lineno": 4024, @@ -38482,8 +38482,8 @@ "comment": "", "meta": { "range": [ - 180687, - 180757 + 180682, + 180752 ], "filename": "astronomy.js", "lineno": 4025, @@ -38508,8 +38508,8 @@ "comment": "", "meta": { "range": [ - 180853, - 180882 + 180848, + 180877 ], "filename": "astronomy.js", "lineno": 4028, @@ -38534,8 +38534,8 @@ "comment": "", "meta": { "range": [ - 180892, - 180935 + 180887, + 180930 ], "filename": "astronomy.js", "lineno": 4029, @@ -38560,8 +38560,8 @@ "comment": "", "meta": { "range": [ - 180945, - 180986 + 180940, + 180981 ], "filename": "astronomy.js", "lineno": 4030, @@ -38586,8 +38586,8 @@ "comment": "", "meta": { "range": [ - 180996, - 181033 + 180991, + 181028 ], "filename": "astronomy.js", "lineno": 4033, @@ -38610,8 +38610,8 @@ "comment": "/**\n * @brief Horizontal position of a body upon reaching an hour angle.\n *\n * Returns information about an occurrence of a celestial body\n * reaching a given hour angle as seen by an observer at a given\n * location on the surface of the Earth.\n *\n * @property {AstroTime} time\n * The date and time of the celestial body reaching the hour angle.\n *\n * @property {HorizontalCoordinates} hor\n * Topocentric horizontal coordinates for the body\n * at the time indicated by the `time` property.\n */", "meta": { "range": [ - 181544, - 181653 + 181539, + 181648 ], "filename": "astronomy.js", "lineno": 4048, @@ -38664,8 +38664,8 @@ "comment": "", "meta": { "range": [ - 181571, - 181651 + 181566, + 181646 ], "filename": "astronomy.js", "lineno": 4049, @@ -38694,8 +38694,8 @@ "comment": "/**\n * @brief Horizontal position of a body upon reaching an hour angle.\n *\n * Returns information about an occurrence of a celestial body\n * reaching a given hour angle as seen by an observer at a given\n * location on the surface of the Earth.\n *\n * @property {AstroTime} time\n * The date and time of the celestial body reaching the hour angle.\n *\n * @property {HorizontalCoordinates} hor\n * Topocentric horizontal coordinates for the body\n * at the time indicated by the `time` property.\n */", "meta": { "range": [ - 181544, - 181653 + 181539, + 181648 ], "filename": "astronomy.js", "lineno": 4048, @@ -38747,8 +38747,8 @@ "comment": "", "meta": { "range": [ - 181604, - 181620 + 181599, + 181615 ], "filename": "astronomy.js", "lineno": 4050, @@ -38772,8 +38772,8 @@ "comment": "", "meta": { "range": [ - 181630, - 181644 + 181625, + 181639 ], "filename": "astronomy.js", "lineno": 4051, @@ -38797,8 +38797,8 @@ "comment": "", "meta": { "range": [ - 181654, - 181693 + 181649, + 181688 ], "filename": "astronomy.js", "lineno": 4054, @@ -38821,8 +38821,8 @@ "comment": "/**\n * @brief Finds when a body will reach a given hour angle.\n *\n * Finds the next time the given body is seen to reach the specified\n * hour angle\n * by the given observer.\n * Providing `hourAngle` = 0 finds the next maximum altitude event (culmination).\n * Providing `hourAngle` = 12 finds the next minimum altitude event.\n * Note that, especially close to the Earth's poles, a body as seen on a given day\n * may always be above the horizon or always below the horizon, so the caller cannot\n * assume that a culminating object is visible nor that an object is below the horizon\n * at its minimum altitude.\n *\n * @param {Body} body\n * The name of a celestial body other than the Earth.\n *\n * @param {Observer} observer\n * Specifies the geographic coordinates and elevation above sea level of the observer.\n *\n * @param {number} hourAngle\n * The hour angle expressed in\n * sidereal\n * hours for which the caller seeks to find the body attain.\n * The value must be in the range [0, 24).\n * The hour angle represents the number of sidereal hours that have\n * elapsed since the most recent time the body crossed the observer's local\n * meridian.\n * This specifying `hourAngle` = 0 finds the moment in time\n * the body reaches the highest angular altitude in a given sidereal day.\n *\n * @param {FlexibleDateTime} dateStart\n * The date and time after which the desired hour angle crossing event\n * is to be found.\n *\n * @returns {HourAngleEvent}\n */", "meta": { "range": [ - 183384, - 185254 + 183379, + 185249 ], "filename": "astronomy.js", "lineno": 4091, @@ -38912,8 +38912,8 @@ "comment": "", "meta": { "range": [ - 183487, - 183513 + 183482, + 183508 ], "filename": "astronomy.js", "lineno": 4093, @@ -38937,8 +38937,8 @@ "comment": "", "meta": { "range": [ - 183523, - 183531 + 183518, + 183526 ], "filename": "astronomy.js", "lineno": 4094, @@ -38962,8 +38962,8 @@ "comment": "", "meta": { "range": [ - 183873, - 183899 + 183868, + 183894 ], "filename": "astronomy.js", "lineno": 4103, @@ -38987,8 +38987,8 @@ "comment": "", "meta": { "range": [ - 183913, - 183963 + 183908, + 183958 ], "filename": "astronomy.js", "lineno": 4104, @@ -39012,8 +39012,8 @@ "comment": "", "meta": { "range": [ - 184094, - 184180 + 184089, + 184175 ], "filename": "astronomy.js", "lineno": 4107, @@ -39037,8 +39037,8 @@ "comment": "", "meta": { "range": [ - 184336, - 184362 + 184331, + 184357 ], "filename": "astronomy.js", "lineno": 4111, @@ -39063,8 +39063,8 @@ "comment": "", "meta": { "range": [ - 184583, - 184609 + 184578, + 184604 ], "filename": "astronomy.js", "lineno": 4117, @@ -39089,8 +39089,8 @@ "comment": "", "meta": { "range": [ - 184676, - 184702 + 184671, + 184697 ], "filename": "astronomy.js", "lineno": 4119, @@ -39115,8 +39115,8 @@ "comment": "", "meta": { "range": [ - 184869, - 184931 + 184864, + 184926 ], "filename": "astronomy.js", "lineno": 4123, @@ -39140,8 +39140,8 @@ "comment": "", "meta": { "range": [ - 185134, - 185204 + 185129, + 185199 ], "filename": "astronomy.js", "lineno": 4128, @@ -39165,8 +39165,8 @@ "comment": "", "meta": { "range": [ - 185214, - 185245 + 185209, + 185240 ], "filename": "astronomy.js", "lineno": 4129, @@ -39191,8 +39191,8 @@ "comment": "", "meta": { "range": [ - 185255, - 185296 + 185250, + 185291 ], "filename": "astronomy.js", "lineno": 4132, @@ -39215,8 +39215,8 @@ "comment": "/**\n * @brief When the seasons change for a given calendar year.\n *\n * Represents the dates and times of the two solstices\n * and the two equinoxes in a given calendar year.\n * These four events define the changing of the seasons on the Earth.\n *\n * @property {AstroTime} mar_equinox\n * The date and time of the March equinox in the given calendar year.\n * This is the moment in March that the plane of the Earth's equator passes\n * through the center of the Sun; thus the Sun's declination\n * changes from a negative number to a positive number.\n * The March equinox defines\n * the beginning of spring in the northern hemisphere and\n * the beginning of autumn in the southern hemisphere.\n *\n * @property {AstroTime} jun_solstice\n * The date and time of the June solstice in the given calendar year.\n * This is the moment in June that the Sun reaches its most positive\n * declination value.\n * At this moment the Earth's north pole is most tilted most toward the Sun.\n * The June solstice defines\n * the beginning of summer in the northern hemisphere and\n * the beginning of winter in the southern hemisphere.\n *\n * @property {AstroTime} sep_equinox\n * The date and time of the September equinox in the given calendar year.\n * This is the moment in September that the plane of the Earth's equator passes\n * through the center of the Sun; thus the Sun's declination\n * changes from a positive number to a negative number.\n * The September equinox defines\n * the beginning of autumn in the northern hemisphere and\n * the beginning of spring in the southern hemisphere.\n *\n * @property {AstroTime} dec_solstice\n * The date and time of the December solstice in the given calendar year.\n * This is the moment in December that the Sun reaches its most negative\n * declination value.\n * At this moment the Earth's south pole is tilted most toward the Sun.\n * The December solstice defines\n * the beginning of winter in the northern hemisphere and\n * the beginning of summer in the southern hemisphere.\n */", "meta": { "range": [ - 187437, - 187699 + 187432, + 187694 ], "filename": "astronomy.js", "lineno": 4176, @@ -39289,8 +39289,8 @@ "comment": "", "meta": { "range": [ - 187460, - 187697 + 187455, + 187692 ], "filename": "astronomy.js", "lineno": 4177, @@ -39321,8 +39321,8 @@ "comment": "/**\n * @brief When the seasons change for a given calendar year.\n *\n * Represents the dates and times of the two solstices\n * and the two equinoxes in a given calendar year.\n * These four events define the changing of the seasons on the Earth.\n *\n * @property {AstroTime} mar_equinox\n * The date and time of the March equinox in the given calendar year.\n * This is the moment in March that the plane of the Earth's equator passes\n * through the center of the Sun; thus the Sun's declination\n * changes from a negative number to a positive number.\n * The March equinox defines\n * the beginning of spring in the northern hemisphere and\n * the beginning of autumn in the southern hemisphere.\n *\n * @property {AstroTime} jun_solstice\n * The date and time of the June solstice in the given calendar year.\n * This is the moment in June that the Sun reaches its most positive\n * declination value.\n * At this moment the Earth's north pole is most tilted most toward the Sun.\n * The June solstice defines\n * the beginning of summer in the northern hemisphere and\n * the beginning of winter in the southern hemisphere.\n *\n * @property {AstroTime} sep_equinox\n * The date and time of the September equinox in the given calendar year.\n * This is the moment in September that the plane of the Earth's equator passes\n * through the center of the Sun; thus the Sun's declination\n * changes from a positive number to a negative number.\n * The September equinox defines\n * the beginning of autumn in the northern hemisphere and\n * the beginning of spring in the southern hemisphere.\n *\n * @property {AstroTime} dec_solstice\n * The date and time of the December solstice in the given calendar year.\n * This is the moment in December that the Sun reaches its most negative\n * declination value.\n * At this moment the Earth's south pole is tilted most toward the Sun.\n * The December solstice defines\n * the beginning of winter in the northern hemisphere and\n * the beginning of summer in the southern hemisphere.\n */", "meta": { "range": [ - 187437, - 187699 + 187432, + 187694 ], "filename": "astronomy.js", "lineno": 4176, @@ -39394,8 +39394,8 @@ "comment": "", "meta": { "range": [ - 187536, - 187566 + 187531, + 187561 ], "filename": "astronomy.js", "lineno": 4178, @@ -39419,8 +39419,8 @@ "comment": "", "meta": { "range": [ - 187576, - 187608 + 187571, + 187603 ], "filename": "astronomy.js", "lineno": 4179, @@ -39444,8 +39444,8 @@ "comment": "", "meta": { "range": [ - 187618, - 187648 + 187613, + 187643 ], "filename": "astronomy.js", "lineno": 4180, @@ -39469,8 +39469,8 @@ "comment": "", "meta": { "range": [ - 187658, - 187690 + 187653, + 187685 ], "filename": "astronomy.js", "lineno": 4181, @@ -39494,8 +39494,8 @@ "comment": "", "meta": { "range": [ - 187700, - 187731 + 187695, + 187726 ], "filename": "astronomy.js", "lineno": 4184, @@ -39518,8 +39518,8 @@ "comment": "/**\n * @brief Finds the equinoxes and solstices for a given calendar year.\n *\n * @param {number | AstroTime} year\n * The integer value or `AstroTime` object that specifies\n * the UTC calendar year for which to find equinoxes and solstices.\n *\n * @returns {SeasonInfo}\n */", "meta": { "range": [ - 188015, - 188848 + 188010, + 188843 ], "filename": "astronomy.js", "lineno": 4194, @@ -39579,8 +39579,8 @@ "comment": "", "meta": { "range": [ - 188044, - 188337 + 188039, + 188332 ], "filename": "astronomy.js", "lineno": 4195, @@ -39612,8 +39612,8 @@ "comment": "", "meta": { "range": [ - 188095, - 188147 + 188090, + 188142 ], "filename": "astronomy.js", "lineno": 4196, @@ -39637,8 +39637,8 @@ "comment": "", "meta": { "range": [ - 188161, - 188211 + 188156, + 188206 ], "filename": "astronomy.js", "lineno": 4197, @@ -39662,8 +39662,8 @@ "comment": "", "meta": { "range": [ - 188415, - 188443 + 188410, + 188438 ], "filename": "astronomy.js", "lineno": 4203, @@ -39688,8 +39688,8 @@ "comment": "", "meta": { "range": [ - 188614, - 188642 + 188609, + 188637 ], "filename": "astronomy.js", "lineno": 4208, @@ -39713,8 +39713,8 @@ "comment": "", "meta": { "range": [ - 188652, - 188682 + 188647, + 188677 ], "filename": "astronomy.js", "lineno": 4209, @@ -39738,8 +39738,8 @@ "comment": "", "meta": { "range": [ - 188692, - 188722 + 188687, + 188717 ], "filename": "astronomy.js", "lineno": 4210, @@ -39763,8 +39763,8 @@ "comment": "", "meta": { "range": [ - 188732, - 188764 + 188727, + 188759 ], "filename": "astronomy.js", "lineno": 4211, @@ -39788,8 +39788,8 @@ "comment": "", "meta": { "range": [ - 188849, - 188874 + 188844, + 188869 ], "filename": "astronomy.js", "lineno": 4214, @@ -39812,8 +39812,8 @@ "comment": "/**\n * @brief The viewing conditions of a body relative to the Sun.\n *\n * Represents the angular separation of a body from the Sun as seen from the Earth\n * and the relative ecliptic longitudes between that body and the Earth as seen from the Sun.\n *\n * @property {AstroTime} time\n * The date and time of the observation.\n *\n * @property {string} visibility\n * Either `\"morning\"` or `\"evening\"`,\n * indicating when the body is most easily seen.\n *\n * @property {number} elongation\n * The angle in degrees, as seen from the center of the Earth,\n * of the apparent separation between the body and the Sun.\n * This angle is measured in 3D space and is not projected onto the ecliptic plane.\n * When `elongation` is less than a few degrees, the body is very\n * difficult to see from the Earth because it is lost in the Sun's glare.\n * The elongation is always in the range [0, 180].\n *\n * @property {number} ecliptic_separation\n * The absolute value of the difference between the body's ecliptic longitude\n * and the Sun's ecliptic longitude, both as seen from the center of the Earth.\n * This angle measures around the plane of the Earth's orbit (the ecliptic),\n * and ignores how far above or below that plane the body is.\n * The ecliptic separation is measured in degrees and is always in the range [0, 180].\n *\n * @see {@link Elongation}\n */", "meta": { "range": [ - 190291, - 190549 + 190286, + 190544 ], "filename": "astronomy.js", "lineno": 4245, @@ -39889,8 +39889,8 @@ "comment": "", "meta": { "range": [ - 190319, - 190547 + 190314, + 190542 ], "filename": "astronomy.js", "lineno": 4246, @@ -39921,8 +39921,8 @@ "comment": "/**\n * @brief The viewing conditions of a body relative to the Sun.\n *\n * Represents the angular separation of a body from the Sun as seen from the Earth\n * and the relative ecliptic longitudes between that body and the Earth as seen from the Sun.\n *\n * @property {AstroTime} time\n * The date and time of the observation.\n *\n * @property {string} visibility\n * Either `\"morning\"` or `\"evening\"`,\n * indicating when the body is most easily seen.\n *\n * @property {number} elongation\n * The angle in degrees, as seen from the center of the Earth,\n * of the apparent separation between the body and the Sun.\n * This angle is measured in 3D space and is not projected onto the ecliptic plane.\n * When `elongation` is less than a few degrees, the body is very\n * difficult to see from the Earth because it is lost in the Sun's glare.\n * The elongation is always in the range [0, 180].\n *\n * @property {number} ecliptic_separation\n * The absolute value of the difference between the body's ecliptic longitude\n * and the Sun's ecliptic longitude, both as seen from the center of the Earth.\n * This angle measures around the plane of the Earth's orbit (the ecliptic),\n * and ignores how far above or below that plane the body is.\n * The ecliptic separation is measured in degrees and is always in the range [0, 180].\n *\n * @see {@link Elongation}\n */", "meta": { "range": [ - 190291, - 190549 + 190286, + 190544 ], "filename": "astronomy.js", "lineno": 4245, @@ -39997,8 +39997,8 @@ "comment": "", "meta": { "range": [ - 190392, - 190408 + 190387, + 190403 ], "filename": "astronomy.js", "lineno": 4247, @@ -40022,8 +40022,8 @@ "comment": "", "meta": { "range": [ - 190418, - 190446 + 190413, + 190441 ], "filename": "astronomy.js", "lineno": 4248, @@ -40047,8 +40047,8 @@ "comment": "", "meta": { "range": [ - 190456, - 190484 + 190451, + 190479 ], "filename": "astronomy.js", "lineno": 4249, @@ -40072,8 +40072,8 @@ "comment": "", "meta": { "range": [ - 190494, - 190540 + 190489, + 190535 ], "filename": "astronomy.js", "lineno": 4250, @@ -40097,8 +40097,8 @@ "comment": "", "meta": { "range": [ - 190550, - 190591 + 190545, + 190586 ], "filename": "astronomy.js", "lineno": 4253, @@ -40121,8 +40121,8 @@ "comment": "/**\n * @brief Calculates the viewing conditions of a body relative to the Sun.\n *\n * Calculates angular separation of a body from the Sun as seen from the Earth\n * and the relative ecliptic longitudes between that body and the Earth as seen from the Sun.\n * See the return type {@link ElongationEvent} for details.\n *\n * This function is helpful for determining how easy\n * it is to view a planet away from the Sun's glare on a given date.\n * It also determines whether the object is visible in the morning or evening;\n * this is more important the smaller the elongation is.\n * It is also used to determine how far a planet is from opposition, conjunction, or quadrature.\n *\n * @param {Body} body\n * The name of the observed body. Not allowed to be `\"Earth\"`.\n *\n * @returns {ElongationEvent}\n */", "meta": { "range": [ - 191396, - 191735 + 191391, + 191730 ], "filename": "astronomy.js", "lineno": 4272, @@ -40180,8 +40180,8 @@ "comment": "", "meta": { "range": [ - 191438, - 191459 + 191433, + 191454 ], "filename": "astronomy.js", "lineno": 4273, @@ -40205,8 +40205,8 @@ "comment": "", "meta": { "range": [ - 191469, - 191503 + 191464, + 191498 ], "filename": "astronomy.js", "lineno": 4274, @@ -40230,8 +40230,8 @@ "comment": "", "meta": { "range": [ - 191513, - 191516 + 191508, + 191511 ], "filename": "astronomy.js", "lineno": 4275, @@ -40253,8 +40253,8 @@ "comment": "", "meta": { "range": [ - 191547, - 191562 + 191542, + 191557 ], "filename": "astronomy.js", "lineno": 4277, @@ -40279,8 +40279,8 @@ "comment": "", "meta": { "range": [ - 191572, - 191587 + 191567, + 191582 ], "filename": "astronomy.js", "lineno": 4278, @@ -40305,8 +40305,8 @@ "comment": "", "meta": { "range": [ - 191614, - 191629 + 191609, + 191624 ], "filename": "astronomy.js", "lineno": 4281, @@ -40331,8 +40331,8 @@ "comment": "", "meta": { "range": [ - 191645, - 191677 + 191640, + 191672 ], "filename": "astronomy.js", "lineno": 4283, @@ -40356,8 +40356,8 @@ "comment": "", "meta": { "range": [ - 191736, - 191767 + 191731, + 191762 ], "filename": "astronomy.js", "lineno": 4286, @@ -40380,8 +40380,8 @@ "comment": "/**\n * @brief Finds the next time Mercury or Venus reaches maximum elongation.\n *\n * Searches for the next maximum elongation event for Mercury or Venus\n * that occurs after the given start date. Calling with other values\n * of `body` will result in an exception.\n * Maximum elongation occurs when the body has the greatest\n * angular separation from the Sun, as seen from the Earth.\n * Returns an `ElongationEvent` object containing the date and time of the next\n * maximum elongation, the elongation in degrees, and whether\n * the body is visible in the morning or evening.\n *\n * @param {Body} body Either `\"Mercury\"` or `\"Venus\"`.\n * @param {FlexibleDateTime} startDate The date and time after which to search for the next maximum elongation event.\n *\n * @returns {ElongationEvent}\n */", "meta": { "range": [ - 192563, - 196689 + 192558, + 196684 ], "filename": "astronomy.js", "lineno": 4304, @@ -40462,8 +40462,8 @@ "comment": "", "meta": { "range": [ - 192621, - 192630 + 192616, + 192625 ], "filename": "astronomy.js", "lineno": 4305, @@ -40487,8 +40487,8 @@ "comment": "", "meta": { "range": [ - 192636, - 193098 + 192631, + 193093 ], "filename": "astronomy.js", "lineno": 4306, @@ -40521,8 +40521,8 @@ "comment": "", "meta": { "range": [ - 192897, - 192920 + 192892, + 192915 ], "filename": "astronomy.js", "lineno": 4310, @@ -40546,8 +40546,8 @@ "comment": "", "meta": { "range": [ - 192936, - 192959 + 192931, + 192954 ], "filename": "astronomy.js", "lineno": 4311, @@ -40571,8 +40571,8 @@ "comment": "", "meta": { "range": [ - 192973, - 193000 + 192968, + 192995 ], "filename": "astronomy.js", "lineno": 4312, @@ -40596,8 +40596,8 @@ "comment": "", "meta": { "range": [ - 193014, - 193041 + 193009, + 193036 ], "filename": "astronomy.js", "lineno": 4313, @@ -40621,8 +40621,8 @@ "comment": "", "meta": { "range": [ - 193055, - 193073 + 193050, + 193068 ], "filename": "astronomy.js", "lineno": 4314, @@ -40646,8 +40646,8 @@ "comment": "", "meta": { "range": [ - 193107, - 193138 + 193102, + 193133 ], "filename": "astronomy.js", "lineno": 4317, @@ -40671,8 +40671,8 @@ "comment": "", "meta": { "range": [ - 193150, - 193244 + 193145, + 193239 ], "filename": "astronomy.js", "lineno": 4318, @@ -40696,8 +40696,8 @@ "comment": "", "meta": { "range": [ - 193168, - 193199 + 193163, + 193194 ], "filename": "astronomy.js", "lineno": 4319, @@ -40720,8 +40720,8 @@ "comment": "", "meta": { "range": [ - 193179, - 193187 + 193174, + 193182 ], "filename": "astronomy.js", "lineno": 4319, @@ -40744,8 +40744,8 @@ "comment": "", "meta": { "range": [ - 193189, - 193197 + 193184, + 193192 ], "filename": "astronomy.js", "lineno": 4319, @@ -40768,8 +40768,8 @@ "comment": "", "meta": { "range": [ - 193209, - 193238 + 193204, + 193233 ], "filename": "astronomy.js", "lineno": 4320, @@ -40792,8 +40792,8 @@ "comment": "", "meta": { "range": [ - 193218, - 193226 + 193213, + 193221 ], "filename": "astronomy.js", "lineno": 4320, @@ -40816,8 +40816,8 @@ "comment": "", "meta": { "range": [ - 193228, - 193236 + 193223, + 193231 ], "filename": "astronomy.js", "lineno": 4320, @@ -40840,8 +40840,8 @@ "comment": "", "meta": { "range": [ - 193256, - 193276 + 193251, + 193271 ], "filename": "astronomy.js", "lineno": 4322, @@ -40865,8 +40865,8 @@ "comment": "", "meta": { "range": [ - 193374, - 193382 + 193369, + 193377 ], "filename": "astronomy.js", "lineno": 4325, @@ -40890,8 +40890,8 @@ "comment": "", "meta": { "range": [ - 193532, - 193573 + 193527, + 193568 ], "filename": "astronomy.js", "lineno": 4329, @@ -40915,8 +40915,8 @@ "comment": "", "meta": { "range": [ - 193587, - 193634 + 193582, + 193629 ], "filename": "astronomy.js", "lineno": 4330, @@ -40940,8 +40940,8 @@ "comment": "", "meta": { "range": [ - 193648, - 193683 + 193643, + 193678 ], "filename": "astronomy.js", "lineno": 4331, @@ -40965,8 +40965,8 @@ "comment": "", "meta": { "range": [ - 193969, - 193976 + 193964, + 193971 ], "filename": "astronomy.js", "lineno": 4335, @@ -40988,8 +40988,8 @@ "comment": "", "meta": { "range": [ - 193978, - 193985 + 193973, + 193980 ], "filename": "astronomy.js", "lineno": 4335, @@ -41011,8 +41011,8 @@ "comment": "", "meta": { "range": [ - 193987, - 193998 + 193982, + 193993 ], "filename": "astronomy.js", "lineno": 4335, @@ -41034,8 +41034,8 @@ "comment": "", "meta": { "range": [ - 194113, - 194128 + 194108, + 194123 ], "filename": "astronomy.js", "lineno": 4338, @@ -41060,8 +41060,8 @@ "comment": "", "meta": { "range": [ - 194208, - 194228 + 194203, + 194223 ], "filename": "astronomy.js", "lineno": 4340, @@ -41086,8 +41086,8 @@ "comment": "", "meta": { "range": [ - 194308, - 194328 + 194303, + 194323 ], "filename": "astronomy.js", "lineno": 4342, @@ -41112,8 +41112,8 @@ "comment": "", "meta": { "range": [ - 194473, - 194488 + 194468, + 194483 ], "filename": "astronomy.js", "lineno": 4346, @@ -41138,8 +41138,8 @@ "comment": "", "meta": { "range": [ - 194568, - 194588 + 194563, + 194583 ], "filename": "astronomy.js", "lineno": 4348, @@ -41164,8 +41164,8 @@ "comment": "", "meta": { "range": [ - 194668, - 194688 + 194663, + 194683 ], "filename": "astronomy.js", "lineno": 4350, @@ -41190,8 +41190,8 @@ "comment": "", "meta": { "range": [ - 194877, - 194915 + 194872, + 194910 ], "filename": "astronomy.js", "lineno": 4355, @@ -41216,8 +41216,8 @@ "comment": "", "meta": { "range": [ - 194929, - 194949 + 194924, + 194944 ], "filename": "astronomy.js", "lineno": 4356, @@ -41242,8 +41242,8 @@ "comment": "", "meta": { "range": [ - 194963, - 194983 + 194958, + 194978 ], "filename": "astronomy.js", "lineno": 4357, @@ -41268,8 +41268,8 @@ "comment": "", "meta": { "range": [ - 195231, - 195269 + 195226, + 195264 ], "filename": "astronomy.js", "lineno": 4363, @@ -41294,8 +41294,8 @@ "comment": "", "meta": { "range": [ - 195283, - 195303 + 195278, + 195298 ], "filename": "astronomy.js", "lineno": 4364, @@ -41320,8 +41320,8 @@ "comment": "", "meta": { "range": [ - 195391, - 195411 + 195386, + 195406 ], "filename": "astronomy.js", "lineno": 4366, @@ -41346,8 +41346,8 @@ "comment": "", "meta": { "range": [ - 195435, - 195475 + 195430, + 195470 ], "filename": "astronomy.js", "lineno": 4368, @@ -41371,8 +41371,8 @@ "comment": "", "meta": { "range": [ - 195489, - 195541 + 195484, + 195536 ], "filename": "astronomy.js", "lineno": 4369, @@ -41396,8 +41396,8 @@ "comment": "", "meta": { "range": [ - 195555, - 195602 + 195550, + 195597 ], "filename": "astronomy.js", "lineno": 4370, @@ -41421,8 +41421,8 @@ "comment": "", "meta": { "range": [ - 195737, - 195755 + 195732, + 195750 ], "filename": "astronomy.js", "lineno": 4373, @@ -41446,8 +41446,8 @@ "comment": "", "meta": { "range": [ - 195859, - 195877 + 195854, + 195872 ], "filename": "astronomy.js", "lineno": 4376, @@ -41471,8 +41471,8 @@ "comment": "", "meta": { "range": [ - 196090, - 196176 + 196085, + 196171 ], "filename": "astronomy.js", "lineno": 4380, @@ -41496,8 +41496,8 @@ "comment": "", "meta": { "range": [ - 196123, - 196134 + 196118, + 196129 ], "filename": "astronomy.js", "lineno": 4380, @@ -41519,8 +41519,8 @@ "comment": "", "meta": { "range": [ - 196136, - 196147 + 196131, + 196142 ], "filename": "astronomy.js", "lineno": 4380, @@ -41542,8 +41542,8 @@ "comment": "", "meta": { "range": [ - 196149, - 196173 + 196144, + 196168 ], "filename": "astronomy.js", "lineno": 4380, @@ -41565,8 +41565,8 @@ "comment": "", "meta": { "range": [ - 196585, - 196610 + 196580, + 196605 ], "filename": "astronomy.js", "lineno": 4388, @@ -41591,8 +41591,8 @@ "comment": "", "meta": { "range": [ - 196690, - 196739 + 196685, + 196734 ], "filename": "astronomy.js", "lineno": 4392, @@ -41615,8 +41615,8 @@ "comment": "/**\n * @brief Searches for the date and time Venus will next appear brightest as seen from the Earth.\n *\n * @param {Body} body\n * Currently only `\"Venus\"` is supported.\n * Mercury's peak magnitude occurs at superior conjunction, when it is virtually impossible to see from Earth,\n * so peak magnitude events have little practical value for that planet.\n * The Moon reaches peak magnitude very close to full moon, which can be found using\n * {@link SearchMoonQuarter} or {@link SearchMoonPhase}.\n * The other planets reach peak magnitude very close to opposition,\n * which can be found using {@link SearchRelativeLongitude}.\n *\n * @param {FlexibleDateTime} startDate\n * The date and time after which to find the next peak magnitude event.\n *\n * @returns {IlluminationInfo}\n */", "meta": { "range": [ - 197557, - 201724 + 197552, + 201719 ], "filename": "astronomy.js", "lineno": 4410, @@ -41697,8 +41697,8 @@ "comment": "", "meta": { "range": [ - 197713, - 197722 + 197708, + 197717 ], "filename": "astronomy.js", "lineno": 4413, @@ -41722,8 +41722,8 @@ "comment": "", "meta": { "range": [ - 197728, - 198323 + 197723, + 198318 ], "filename": "astronomy.js", "lineno": 4414, @@ -41756,8 +41756,8 @@ "comment": "", "meta": { "range": [ - 198108, - 198131 + 198103, + 198126 ], "filename": "astronomy.js", "lineno": 4420, @@ -41781,8 +41781,8 @@ "comment": "", "meta": { "range": [ - 198147, - 198170 + 198142, + 198165 ], "filename": "astronomy.js", "lineno": 4421, @@ -41806,8 +41806,8 @@ "comment": "", "meta": { "range": [ - 198186, - 198217 + 198181, + 198212 ], "filename": "astronomy.js", "lineno": 4422, @@ -41831,8 +41831,8 @@ "comment": "", "meta": { "range": [ - 198233, - 198264 + 198228, + 198259 ], "filename": "astronomy.js", "lineno": 4423, @@ -41856,8 +41856,8 @@ "comment": "", "meta": { "range": [ - 198280, - 198298 + 198275, + 198293 ], "filename": "astronomy.js", "lineno": 4424, @@ -41881,8 +41881,8 @@ "comment": "", "meta": { "range": [ - 198332, - 198363 + 198327, + 198358 ], "filename": "astronomy.js", "lineno": 4427, @@ -41906,8 +41906,8 @@ "comment": "", "meta": { "range": [ - 198464, - 198473 + 198459, + 198468 ], "filename": "astronomy.js", "lineno": 4429, @@ -41931,8 +41931,8 @@ "comment": "", "meta": { "range": [ - 198485, - 198494 + 198480, + 198489 ], "filename": "astronomy.js", "lineno": 4430, @@ -41956,8 +41956,8 @@ "comment": "", "meta": { "range": [ - 198504, - 198512 + 198499, + 198507 ], "filename": "astronomy.js", "lineno": 4431, @@ -41981,8 +41981,8 @@ "comment": "", "meta": { "range": [ - 198662, - 198703 + 198657, + 198698 ], "filename": "astronomy.js", "lineno": 4435, @@ -42006,8 +42006,8 @@ "comment": "", "meta": { "range": [ - 198717, - 198764 + 198712, + 198759 ], "filename": "astronomy.js", "lineno": 4436, @@ -42031,8 +42031,8 @@ "comment": "", "meta": { "range": [ - 198778, - 198813 + 198773, + 198808 ], "filename": "astronomy.js", "lineno": 4437, @@ -42056,8 +42056,8 @@ "comment": "", "meta": { "range": [ - 199099, - 199106 + 199094, + 199101 ], "filename": "astronomy.js", "lineno": 4441, @@ -42079,8 +42079,8 @@ "comment": "", "meta": { "range": [ - 199108, - 199115 + 199103, + 199110 ], "filename": "astronomy.js", "lineno": 4441, @@ -42102,8 +42102,8 @@ "comment": "", "meta": { "range": [ - 199117, - 199128 + 199112, + 199123 ], "filename": "astronomy.js", "lineno": 4441, @@ -42125,8 +42125,8 @@ "comment": "", "meta": { "range": [ - 199229, - 199244 + 199224, + 199239 ], "filename": "astronomy.js", "lineno": 4444, @@ -42151,8 +42151,8 @@ "comment": "", "meta": { "range": [ - 199324, - 199337 + 199319, + 199332 ], "filename": "astronomy.js", "lineno": 4446, @@ -42177,8 +42177,8 @@ "comment": "", "meta": { "range": [ - 199417, - 199430 + 199412, + 199425 ], "filename": "astronomy.js", "lineno": 4448, @@ -42203,8 +42203,8 @@ "comment": "", "meta": { "range": [ - 199561, - 199576 + 199556, + 199571 ], "filename": "astronomy.js", "lineno": 4452, @@ -42229,8 +42229,8 @@ "comment": "", "meta": { "range": [ - 199656, - 199669 + 199651, + 199664 ], "filename": "astronomy.js", "lineno": 4454, @@ -42255,8 +42255,8 @@ "comment": "", "meta": { "range": [ - 199749, - 199762 + 199744, + 199757 ], "filename": "astronomy.js", "lineno": 4456, @@ -42281,8 +42281,8 @@ "comment": "", "meta": { "range": [ - 199951, - 199989 + 199946, + 199984 ], "filename": "astronomy.js", "lineno": 4461, @@ -42307,8 +42307,8 @@ "comment": "", "meta": { "range": [ - 200003, - 200016 + 199998, + 200011 ], "filename": "astronomy.js", "lineno": 4462, @@ -42333,8 +42333,8 @@ "comment": "", "meta": { "range": [ - 200104, - 200117 + 200099, + 200112 ], "filename": "astronomy.js", "lineno": 4464, @@ -42359,8 +42359,8 @@ "comment": "", "meta": { "range": [ - 200291, - 200329 + 200286, + 200324 ], "filename": "astronomy.js", "lineno": 4469, @@ -42385,8 +42385,8 @@ "comment": "", "meta": { "range": [ - 200343, - 200356 + 200338, + 200351 ], "filename": "astronomy.js", "lineno": 4470, @@ -42411,8 +42411,8 @@ "comment": "", "meta": { "range": [ - 200444, - 200457 + 200439, + 200452 ], "filename": "astronomy.js", "lineno": 4472, @@ -42437,8 +42437,8 @@ "comment": "", "meta": { "range": [ - 200481, - 200521 + 200476, + 200516 ], "filename": "astronomy.js", "lineno": 4474, @@ -42462,8 +42462,8 @@ "comment": "", "meta": { "range": [ - 200535, - 200587 + 200530, + 200582 ], "filename": "astronomy.js", "lineno": 4475, @@ -42487,8 +42487,8 @@ "comment": "", "meta": { "range": [ - 200601, - 200648 + 200596, + 200643 ], "filename": "astronomy.js", "lineno": 4476, @@ -42512,8 +42512,8 @@ "comment": "", "meta": { "range": [ - 200782, - 200796 + 200777, + 200791 ], "filename": "astronomy.js", "lineno": 4479, @@ -42537,8 +42537,8 @@ "comment": "", "meta": { "range": [ - 200900, - 200914 + 200895, + 200909 ], "filename": "astronomy.js", "lineno": 4482, @@ -42562,8 +42562,8 @@ "comment": "", "meta": { "range": [ - 201127, - 201209 + 201122, + 201204 ], "filename": "astronomy.js", "lineno": 4486, @@ -42587,8 +42587,8 @@ "comment": "", "meta": { "range": [ - 201156, - 201167 + 201151, + 201162 ], "filename": "astronomy.js", "lineno": 4486, @@ -42610,8 +42610,8 @@ "comment": "", "meta": { "range": [ - 201169, - 201180 + 201164, + 201175 ], "filename": "astronomy.js", "lineno": 4486, @@ -42633,8 +42633,8 @@ "comment": "", "meta": { "range": [ - 201182, - 201206 + 201177, + 201201 ], "filename": "astronomy.js", "lineno": 4486, @@ -42656,8 +42656,8 @@ "comment": "", "meta": { "range": [ - 201620, - 201645 + 201615, + 201640 ], "filename": "astronomy.js", "lineno": 4494, @@ -42682,8 +42682,8 @@ "comment": "", "meta": { "range": [ - 201725, - 201774 + 201720, + 201769 ], "filename": "astronomy.js", "lineno": 4498, @@ -42706,8 +42706,8 @@ "comment": "/**\n * @brief A closest or farthest point in a body's orbit around its primary.\n *\n * For a planet orbiting the Sun, apsis is a perihelion or aphelion, respectively.\n * For the Moon orbiting the Earth, apsis is a perigee or apogee, respectively.\n *\n * @property {AstroTime} time\n * The date and time of the apsis.\n *\n * @property {number} kind\n * For a closest approach (perigee or perihelion), `kind` is 0.\n * For a farthest distance event (apogee or aphelion), `kind` is 1.\n *\n * @property {number} dist_au\n * The distance between the centers of the two bodies in astronomical units (AU).\n *\n * @property {number} dist_km\n * The distance between the centers of the two bodies in kilometers.\n *\n * @see {@link SearchLunarApsis}\n * @see {@link NextLunarApsis}\n */", "meta": { "range": [ - 202565, - 202761 + 202560, + 202756 ], "filename": "astronomy.js", "lineno": 4521, @@ -42783,8 +42783,8 @@ "comment": "", "meta": { "range": [ - 202583, - 202759 + 202578, + 202754 ], "filename": "astronomy.js", "lineno": 4522, @@ -42814,8 +42814,8 @@ "comment": "/**\n * @brief A closest or farthest point in a body's orbit around its primary.\n *\n * For a planet orbiting the Sun, apsis is a perihelion or aphelion, respectively.\n * For the Moon orbiting the Earth, apsis is a perigee or apogee, respectively.\n *\n * @property {AstroTime} time\n * The date and time of the apsis.\n *\n * @property {number} kind\n * For a closest approach (perigee or perihelion), `kind` is 0.\n * For a farthest distance event (apogee or aphelion), `kind` is 1.\n *\n * @property {number} dist_au\n * The distance between the centers of the two bodies in astronomical units (AU).\n *\n * @property {number} dist_km\n * The distance between the centers of the two bodies in kilometers.\n *\n * @see {@link SearchLunarApsis}\n * @see {@link NextLunarApsis}\n */", "meta": { "range": [ - 202565, - 202761 + 202560, + 202756 ], "filename": "astronomy.js", "lineno": 4521, @@ -42890,8 +42890,8 @@ "comment": "", "meta": { "range": [ - 202626, - 202642 + 202621, + 202637 ], "filename": "astronomy.js", "lineno": 4523, @@ -42915,8 +42915,8 @@ "comment": "", "meta": { "range": [ - 202652, - 202668 + 202647, + 202663 ], "filename": "astronomy.js", "lineno": 4524, @@ -42940,8 +42940,8 @@ "comment": "", "meta": { "range": [ - 202678, - 202700 + 202673, + 202695 ], "filename": "astronomy.js", "lineno": 4525, @@ -42965,8 +42965,8 @@ "comment": "", "meta": { "range": [ - 202710, - 202752 + 202705, + 202747 ], "filename": "astronomy.js", "lineno": 4526, @@ -42990,8 +42990,8 @@ "comment": "", "meta": { "range": [ - 202762, - 202783 + 202757, + 202778 ], "filename": "astronomy.js", "lineno": 4529, @@ -43014,8 +43014,8 @@ "comment": "/**\n * @brief Finds the next perigee or apogee of the Moon.\n *\n * Finds the next perigee (closest approach) or apogee (farthest remove) of the Moon\n * that occurs after the specified date and time.\n *\n * @param {FlexibleDateTime} startDate\n * The date and time after which to find the next perigee or apogee.\n *\n * @returns {Apsis}\n */", "meta": { "range": [ - 203126, - 205921 + 203121, + 205916 ], "filename": "astronomy.js", "lineno": 4541, @@ -43079,8 +43079,8 @@ "comment": "", "meta": { "range": [ - 203175, - 203185 + 203170, + 203180 ], "filename": "astronomy.js", "lineno": 4542, @@ -43104,8 +43104,8 @@ "comment": "", "meta": { "range": [ - 203191, - 203435 + 203186, + 203430 ], "filename": "astronomy.js", "lineno": 4543, @@ -43138,8 +43138,8 @@ "comment": "", "meta": { "range": [ - 203232, - 203255 + 203227, + 203250 ], "filename": "astronomy.js", "lineno": 4544, @@ -43163,8 +43163,8 @@ "comment": "", "meta": { "range": [ - 203269, - 203292 + 203264, + 203287 ], "filename": "astronomy.js", "lineno": 4545, @@ -43188,8 +43188,8 @@ "comment": "", "meta": { "range": [ - 203306, - 203335 + 203301, + 203330 ], "filename": "astronomy.js", "lineno": 4546, @@ -43213,8 +43213,8 @@ "comment": "", "meta": { "range": [ - 203349, - 203378 + 203344, + 203373 ], "filename": "astronomy.js", "lineno": 4547, @@ -43238,8 +43238,8 @@ "comment": "", "meta": { "range": [ - 203392, - 203410 + 203387, + 203405 ], "filename": "astronomy.js", "lineno": 4548, @@ -43263,8 +43263,8 @@ "comment": "", "meta": { "range": [ - 203440, - 203518 + 203435, + 203513 ], "filename": "astronomy.js", "lineno": 4551, @@ -43290,8 +43290,8 @@ "comment": "", "meta": { "range": [ - 203946, - 203970 + 203941, + 203965 ], "filename": "astronomy.js", "lineno": 4560, @@ -43315,8 +43315,8 @@ "comment": "", "meta": { "range": [ - 203980, - 204003 + 203975, + 203998 ], "filename": "astronomy.js", "lineno": 4561, @@ -43340,8 +43340,8 @@ "comment": "", "meta": { "range": [ - 204015, - 204028 + 204010, + 204023 ], "filename": "astronomy.js", "lineno": 4562, @@ -43365,8 +43365,8 @@ "comment": "", "meta": { "range": [ - 204087, - 204095 + 204082, + 204090 ], "filename": "astronomy.js", "lineno": 4563, @@ -43390,8 +43390,8 @@ "comment": "", "meta": { "range": [ - 204162, - 204188 + 204157, + 204183 ], "filename": "astronomy.js", "lineno": 4564, @@ -43415,8 +43415,8 @@ "comment": "", "meta": { "range": [ - 204202, - 204225 + 204197, + 204220 ], "filename": "astronomy.js", "lineno": 4565, @@ -43440,8 +43440,8 @@ "comment": "", "meta": { "range": [ - 204620, - 204685 + 204615, + 204680 ], "filename": "astronomy.js", "lineno": 4573, @@ -43465,8 +43465,8 @@ "comment": "", "meta": { "range": [ - 204658, - 204669 + 204653, + 204664 ], "filename": "astronomy.js", "lineno": 4573, @@ -43488,8 +43488,8 @@ "comment": "", "meta": { "range": [ - 204671, - 204682 + 204666, + 204677 ], "filename": "astronomy.js", "lineno": 4573, @@ -43511,8 +43511,8 @@ "comment": "", "meta": { "range": [ - 204817, - 204848 + 204812, + 204843 ], "filename": "astronomy.js", "lineno": 4576, @@ -43536,8 +43536,8 @@ "comment": "", "meta": { "range": [ - 205158, - 205234 + 205153, + 205229 ], "filename": "astronomy.js", "lineno": 4583, @@ -43561,8 +43561,8 @@ "comment": "", "meta": { "range": [ - 205205, - 205217 + 205200, + 205212 ], "filename": "astronomy.js", "lineno": 4583, @@ -43584,8 +43584,8 @@ "comment": "", "meta": { "range": [ - 205219, - 205231 + 205214, + 205226 ], "filename": "astronomy.js", "lineno": 4583, @@ -43607,8 +43607,8 @@ "comment": "", "meta": { "range": [ - 205365, - 205396 + 205360, + 205391 ], "filename": "astronomy.js", "lineno": 4586, @@ -43632,8 +43632,8 @@ "comment": "", "meta": { "range": [ - 205699, - 205706 + 205694, + 205701 ], "filename": "astronomy.js", "lineno": 4593, @@ -43658,8 +43658,8 @@ "comment": "", "meta": { "range": [ - 205716, - 205723 + 205711, + 205718 ], "filename": "astronomy.js", "lineno": 4594, @@ -43684,8 +43684,8 @@ "comment": "", "meta": { "range": [ - 205922, - 205965 + 205917, + 205960 ], "filename": "astronomy.js", "lineno": 4599, @@ -43708,8 +43708,8 @@ "comment": "/**\n * @brief Finds the next lunar apsis (perigee or apogee) in a series.\n *\n * Given a lunar apsis returned by an initial call to {@link SearchLunarApsis},\n * or a previous call to `NextLunarApsis`, finds the next lunar apsis.\n * If the given apsis is a perigee, this function finds the next apogee, and vice versa.\n *\n * @param {Apsis} apsis\n * A lunar perigee or apogee event.\n *\n * @returns {Apsis}\n * The successor apogee for the given perigee, or the successor perigee for the given apogee.\n */", "meta": { "range": [ - 206478, - 206899 + 206473, + 206894 ], "filename": "astronomy.js", "lineno": 4613, @@ -43765,8 +43765,8 @@ "comment": "", "meta": { "range": [ - 206521, - 206530 + 206516, + 206525 ], "filename": "astronomy.js", "lineno": 4614, @@ -43790,8 +43790,8 @@ "comment": "", "meta": { "range": [ - 206604, - 206653 + 206599, + 206648 ], "filename": "astronomy.js", "lineno": 4615, @@ -43815,8 +43815,8 @@ "comment": "", "meta": { "range": [ - 206900, - 206939 + 206895, + 206934 ], "filename": "astronomy.js", "lineno": 4621, @@ -43839,8 +43839,8 @@ "comment": "", "meta": { "range": [ - 206941, - 207934 + 206936, + 207929 ], "filename": "astronomy.js", "lineno": 4622, @@ -43882,8 +43882,8 @@ "comment": "", "meta": { "range": [ - 207009, - 207047 + 207004, + 207042 ], "filename": "astronomy.js", "lineno": 4623, @@ -43907,8 +43907,8 @@ "comment": "", "meta": { "range": [ - 207059, - 207071 + 207054, + 207066 ], "filename": "astronomy.js", "lineno": 4624, @@ -43932,8 +43932,8 @@ "comment": "", "meta": { "range": [ - 207102, - 207136 + 207097, + 207131 ], "filename": "astronomy.js", "lineno": 4626, @@ -43957,8 +43957,8 @@ "comment": "", "meta": { "range": [ - 207251, - 207298 + 207246, + 207293 ], "filename": "astronomy.js", "lineno": 4628, @@ -43982,8 +43982,8 @@ "comment": "", "meta": { "range": [ - 207318, - 207359 + 207313, + 207354 ], "filename": "astronomy.js", "lineno": 4629, @@ -44007,8 +44007,8 @@ "comment": "", "meta": { "range": [ - 207440, - 207451 + 207435, + 207446 ], "filename": "astronomy.js", "lineno": 4632, @@ -44032,8 +44032,8 @@ "comment": "", "meta": { "range": [ - 207465, - 207480 + 207460, + 207475 ], "filename": "astronomy.js", "lineno": 4633, @@ -44057,8 +44057,8 @@ "comment": "", "meta": { "range": [ - 207499, - 207504 + 207494, + 207499 ], "filename": "astronomy.js", "lineno": 4634, @@ -44082,8 +44082,8 @@ "comment": "", "meta": { "range": [ - 207544, - 207583 + 207539, + 207578 ], "filename": "astronomy.js", "lineno": 4635, @@ -44107,8 +44107,8 @@ "comment": "", "meta": { "range": [ - 207603, - 207647 + 207598, + 207642 ], "filename": "astronomy.js", "lineno": 4636, @@ -44132,8 +44132,8 @@ "comment": "", "meta": { "range": [ - 207711, - 207721 + 207706, + 207716 ], "filename": "astronomy.js", "lineno": 4638, @@ -44158,8 +44158,8 @@ "comment": "", "meta": { "range": [ - 207739, - 207755 + 207734, + 207750 ], "filename": "astronomy.js", "lineno": 4639, @@ -44184,8 +44184,8 @@ "comment": "", "meta": { "range": [ - 207835, - 207891 + 207830, + 207886 ], "filename": "astronomy.js", "lineno": 4643, @@ -44210,8 +44210,8 @@ "comment": "", "meta": { "range": [ - 207901, - 207925 + 207896, + 207920 ], "filename": "astronomy.js", "lineno": 4644, @@ -44236,8 +44236,8 @@ "comment": "", "meta": { "range": [ - 207935, - 210523 + 207930, + 210518 ], "filename": "astronomy.js", "lineno": 4647, @@ -44278,8 +44278,8 @@ "comment": "", "meta": { "range": [ - 209226, - 209239 + 209221, + 209234 ], "filename": "astronomy.js", "lineno": 4672, @@ -44303,8 +44303,8 @@ "comment": "", "meta": { "range": [ - 209251, - 209315 + 209246, + 209310 ], "filename": "astronomy.js", "lineno": 4673, @@ -44328,8 +44328,8 @@ "comment": "", "meta": { "range": [ - 209327, - 209392 + 209322, + 209387 ], "filename": "astronomy.js", "lineno": 4674, @@ -44353,8 +44353,8 @@ "comment": "", "meta": { "range": [ - 209402, - 209412 + 209397, + 209407 ], "filename": "astronomy.js", "lineno": 4675, @@ -44378,8 +44378,8 @@ "comment": "", "meta": { "range": [ - 209422, - 209432 + 209417, + 209427 ], "filename": "astronomy.js", "lineno": 4676, @@ -44403,8 +44403,8 @@ "comment": "", "meta": { "range": [ - 209442, - 209457 + 209437, + 209452 ], "filename": "astronomy.js", "lineno": 4677, @@ -44428,8 +44428,8 @@ "comment": "", "meta": { "range": [ - 209467, - 209482 + 209462, + 209477 ], "filename": "astronomy.js", "lineno": 4678, @@ -44453,8 +44453,8 @@ "comment": "", "meta": { "range": [ - 209494, - 209536 + 209489, + 209531 ], "filename": "astronomy.js", "lineno": 4679, @@ -44478,8 +44478,8 @@ "comment": "", "meta": { "range": [ - 209551, - 209556 + 209546, + 209551 ], "filename": "astronomy.js", "lineno": 4680, @@ -44503,8 +44503,8 @@ "comment": "", "meta": { "range": [ - 209592, - 209623 + 209587, + 209618 ], "filename": "astronomy.js", "lineno": 4681, @@ -44528,8 +44528,8 @@ "comment": "", "meta": { "range": [ - 209639, - 209671 + 209634, + 209666 ], "filename": "astronomy.js", "lineno": 4682, @@ -44553,8 +44553,8 @@ "comment": "", "meta": { "range": [ - 209708, - 209734 + 209703, + 209729 ], "filename": "astronomy.js", "lineno": 4684, @@ -44579,8 +44579,8 @@ "comment": "", "meta": { "range": [ - 209719, - 209734 + 209714, + 209729 ], "filename": "astronomy.js", "lineno": 4684, @@ -44605,8 +44605,8 @@ "comment": "", "meta": { "range": [ - 209812, - 209827 + 209807, + 209822 ], "filename": "astronomy.js", "lineno": 4688, @@ -44631,8 +44631,8 @@ "comment": "", "meta": { "range": [ - 209845, - 209857 + 209840, + 209852 ], "filename": "astronomy.js", "lineno": 4689, @@ -44657,8 +44657,8 @@ "comment": "", "meta": { "range": [ - 209924, - 209939 + 209919, + 209934 ], "filename": "astronomy.js", "lineno": 4692, @@ -44683,8 +44683,8 @@ "comment": "", "meta": { "range": [ - 209957, - 209969 + 209952, + 209964 ], "filename": "astronomy.js", "lineno": 4693, @@ -44709,8 +44709,8 @@ "comment": "", "meta": { "range": [ - 210011, - 210090 + 210006, + 210085 ], "filename": "astronomy.js", "lineno": 4697, @@ -44734,8 +44734,8 @@ "comment": "", "meta": { "range": [ - 210102, - 210179 + 210097, + 210174 ], "filename": "astronomy.js", "lineno": 4698, @@ -44759,8 +44759,8 @@ "comment": "/**\n * @brief Finds the next perihelion or aphelion of a planet.\n *\n * Finds the date and time of a planet's perihelion (closest approach to the Sun)\n * or aphelion (farthest distance from the Sun) after a given time.\n *\n * Given a date and time to start the search in `startTime`, this function finds the\n * next date and time that the center of the specified planet reaches the closest or farthest point\n * in its orbit with respect to the center of the Sun, whichever comes first\n * after `startTime`.\n *\n * The closest point is called *perihelion* and the farthest point is called *aphelion*.\n * The word *apsis* refers to either event.\n *\n * To iterate through consecutive alternating perihelion and aphelion events,\n * call `SearchPlanetApsis` once, then use the return value to call\n * {@link NextPlanetApsis}. After that, keep feeding the previous return value\n * from `NextPlanetApsis` into another call of `NextPlanetApsis`\n * as many times as desired.\n *\n * @param {Body} body\n * The planet for which to find the next perihelion/aphelion event.\n * Not allowed to be `\"Sun\"` or `\"Moon\"`.\n *\n * @param {AstroTime} startTime\n * The date and time at which to start searching for the next perihelion or aphelion.\n *\n * @returns {Apsis}\n * The next perihelion or aphelion that occurs after `startTime`.\n */", "meta": { "range": [ - 211856, - 214301 + 211851, + 214296 ], "filename": "astronomy.js", "lineno": 4740, @@ -44837,8 +44837,8 @@ "comment": "", "meta": { "range": [ - 212024, - 212292 + 212019, + 212287 ], "filename": "astronomy.js", "lineno": 4744, @@ -44872,8 +44872,8 @@ "comment": "", "meta": { "range": [ - 212067, - 212077 + 212062, + 212072 ], "filename": "astronomy.js", "lineno": 4745, @@ -44897,8 +44897,8 @@ "comment": "", "meta": { "range": [ - 212091, - 212114 + 212086, + 212109 ], "filename": "astronomy.js", "lineno": 4746, @@ -44922,8 +44922,8 @@ "comment": "", "meta": { "range": [ - 212128, - 212151 + 212123, + 212146 ], "filename": "astronomy.js", "lineno": 4747, @@ -44947,8 +44947,8 @@ "comment": "", "meta": { "range": [ - 212165, - 212193 + 212160, + 212188 ], "filename": "astronomy.js", "lineno": 4748, @@ -44972,8 +44972,8 @@ "comment": "", "meta": { "range": [ - 212207, - 212235 + 212202, + 212230 ], "filename": "astronomy.js", "lineno": 4749, @@ -44997,8 +44997,8 @@ "comment": "", "meta": { "range": [ - 212249, - 212267 + 212244, + 212262 ], "filename": "astronomy.js", "lineno": 4750, @@ -45022,8 +45022,8 @@ "comment": "", "meta": { "range": [ - 212297, - 212366 + 212292, + 212361 ], "filename": "astronomy.js", "lineno": 4753, @@ -45049,8 +45049,8 @@ "comment": "", "meta": { "range": [ - 212377, - 212423 + 212372, + 212418 ], "filename": "astronomy.js", "lineno": 4756, @@ -45074,8 +45074,8 @@ "comment": "", "meta": { "range": [ - 212435, - 212470 + 212430, + 212465 ], "filename": "astronomy.js", "lineno": 4757, @@ -45099,8 +45099,8 @@ "comment": "", "meta": { "range": [ - 212480, - 212494 + 212475, + 212489 ], "filename": "astronomy.js", "lineno": 4758, @@ -45124,8 +45124,8 @@ "comment": "", "meta": { "range": [ - 212504, - 212527 + 212499, + 212522 ], "filename": "astronomy.js", "lineno": 4759, @@ -45149,8 +45149,8 @@ "comment": "", "meta": { "range": [ - 212542, - 212550 + 212537, + 212545 ], "filename": "astronomy.js", "lineno": 4760, @@ -45174,8 +45174,8 @@ "comment": "", "meta": { "range": [ - 212620, - 212646 + 212615, + 212641 ], "filename": "astronomy.js", "lineno": 4761, @@ -45199,8 +45199,8 @@ "comment": "", "meta": { "range": [ - 212662, - 212685 + 212657, + 212680 ], "filename": "astronomy.js", "lineno": 4762, @@ -45224,8 +45224,8 @@ "comment": "", "meta": { "range": [ - 212949, - 212959 + 212944, + 212954 ], "filename": "astronomy.js", "lineno": 4767, @@ -45247,8 +45247,8 @@ "comment": "", "meta": { "range": [ - 212977, - 212981 + 212972, + 212976 ], "filename": "astronomy.js", "lineno": 4768, @@ -45270,8 +45270,8 @@ "comment": "", "meta": { "range": [ - 213212, - 213239 + 213207, + 213234 ], "filename": "astronomy.js", "lineno": 4772, @@ -45296,8 +45296,8 @@ "comment": "", "meta": { "range": [ - 213257, - 213265 + 213252, + 213260 ], "filename": "astronomy.js", "lineno": 4773, @@ -45322,8 +45322,8 @@ "comment": "", "meta": { "range": [ - 213527, - 213554 + 213522, + 213549 ], "filename": "astronomy.js", "lineno": 4778, @@ -45348,8 +45348,8 @@ "comment": "", "meta": { "range": [ - 213572, - 213580 + 213567, + 213575 ], "filename": "astronomy.js", "lineno": 4779, @@ -45374,8 +45374,8 @@ "comment": "", "meta": { "range": [ - 213834, - 213869 + 213829, + 213864 ], "filename": "astronomy.js", "lineno": 4785, @@ -45399,8 +45399,8 @@ "comment": "", "meta": { "range": [ - 213998, - 214032 + 213993, + 214027 ], "filename": "astronomy.js", "lineno": 4788, @@ -45424,8 +45424,8 @@ "comment": "", "meta": { "range": [ - 214179, - 214186 + 214174, + 214181 ], "filename": "astronomy.js", "lineno": 4792, @@ -45450,8 +45450,8 @@ "comment": "", "meta": { "range": [ - 214196, - 214203 + 214191, + 214198 ], "filename": "astronomy.js", "lineno": 4793, @@ -45476,8 +45476,8 @@ "comment": "", "meta": { "range": [ - 214302, - 214347 + 214297, + 214342 ], "filename": "astronomy.js", "lineno": 4797, @@ -45500,8 +45500,8 @@ "comment": "/**\n * @brief Finds the next planetary perihelion or aphelion event in a series.\n *\n * This function requires an {@link Apsis} value obtained from a call\n * to {@link SearchPlanetApsis} or `NextPlanetApsis`.\n * Given an aphelion event, this function finds the next perihelion event, and vice versa.\n * See {@link SearchPlanetApsis} for more details.\n *\n * @param {Body} body\n * The planet for which to find the next perihelion/aphelion event.\n * Not allowed to be `\"Sun\"` or `\"Moon\"`.\n * Must match the body passed into the call that produced the `apsis` parameter.\n *\n * @param {Apsis} apsis\n * An apsis event obtained from a call to {@link SearchPlanetApsis} or `NextPlanetApsis`.\n *\n * @returns {Apsis}\n * Same as the return value for {@link SearchPlanetApsis}.\n */", "meta": { "range": [ - 215143, - 215734 + 215138, + 215729 ], "filename": "astronomy.js", "lineno": 4817, @@ -45568,8 +45568,8 @@ "comment": "", "meta": { "range": [ - 215358, - 215398 + 215353, + 215393 ], "filename": "astronomy.js", "lineno": 4822, @@ -45593,8 +45593,8 @@ "comment": "", "meta": { "range": [ - 215410, - 215441 + 215405, + 215436 ], "filename": "astronomy.js", "lineno": 4823, @@ -45618,8 +45618,8 @@ "comment": "", "meta": { "range": [ - 215453, - 215489 + 215448, + 215484 ], "filename": "astronomy.js", "lineno": 4824, @@ -45643,8 +45643,8 @@ "comment": "", "meta": { "range": [ - 215735, - 215776 + 215730, + 215771 ], "filename": "astronomy.js", "lineno": 4831, @@ -45667,8 +45667,8 @@ "comment": "/**\n * @brief Calculates the inverse of a rotation matrix.\n *\n * Given a rotation matrix that performs some coordinate transform,\n * this function returns the matrix that reverses that trasnform.\n *\n * @param {RotationMatrix} rotation\n * The rotation matrix to be inverted.\n *\n * @returns {RotationMatrix}\n * The inverse rotation matrix.\n */", "meta": { "range": [ - 216130, - 216417 + 216125, + 216412 ], "filename": "astronomy.js", "lineno": 4844, @@ -45720,8 +45720,8 @@ "comment": "", "meta": { "range": [ - 216418, - 216459 + 216413, + 216454 ], "filename": "astronomy.js", "lineno": 4851, @@ -45744,8 +45744,8 @@ "comment": "/**\n * @brief Creates a rotation based on applying one rotation followed by another.\n *\n * Given two rotation matrices, returns a combined rotation matrix that is\n * equivalent to rotating based on the first matrix, followed by the second.\n *\n * @param {RotationMatrix} a\n * The first rotation to apply.\n *\n * @param {RotationMatrix} b\n * The second rotation to apply.\n *\n * @returns {RotationMatrix}\n * The combined rotation matrix.\n */", "meta": { "range": [ - 216914, - 218217 + 216909, + 218212 ], "filename": "astronomy.js", "lineno": 4867, @@ -45807,8 +45807,8 @@ "comment": "", "meta": { "range": [ - 218218, - 218259 + 218213, + 218254 ], "filename": "astronomy.js", "lineno": 4893, @@ -45831,8 +45831,8 @@ "comment": "/**\n * @brief Creates an identity rotation matrix.\n *\n * Returns a rotation matrix that has no effect on orientation.\n * This matrix can be the starting point for other operations,\n * such as using a series of calls to #Astronomy_Pivot to\n * create a custom rotation matrix.\n *\n * @returns {RotationMatrix}\n * The identity matrix.\n */", "meta": { "range": [ - 218601, - 218726 + 218596, + 218721 ], "filename": "astronomy.js", "lineno": 4905, @@ -45872,8 +45872,8 @@ "comment": "", "meta": { "range": [ - 218727, - 218766 + 218722, + 218761 ], "filename": "astronomy.js", "lineno": 4912, @@ -45896,8 +45896,8 @@ "comment": "/**\n* @brief Re-orients a rotation matrix by pivoting it by an angle around one of its axes.\n*\n* Given a rotation matrix, a selected coordinate axis, and an angle in degrees,\n* this function pivots the rotation matrix by that angle around that coordinate axis.\n*\n* For example, if you have rotation matrix that converts ecliptic coordinates (ECL)\n* to horizontal coordinates (HOR), but you really want to convert ECL to the orientation\n* of a telescope camera pointed at a given body, you can use `Astronomy_Pivot` twice:\n* (1) pivot around the zenith axis by the body's azimuth, then (2) pivot around the\n* western axis by the body's altitude angle. The resulting rotation matrix will then\n* reorient ECL coordinates to the orientation of your telescope camera.\n*\n* @param {RotationMatrix} rotation\n* The input rotation matrix.\n*\n* @param {number} axis\n* An integer that selects which coordinate axis to rotate around:\n* 0 = x, 1 = y, 2 = z. Any other value will cause an exception.\n*\n* @param {number} angle\n* An angle in degrees indicating the amount of rotation around the specified axis.\n* Positive angles indicate rotation counterclockwise as seen from the positive\n* direction along that axis, looking towards the origin point of the orientation system.\n* Any finite number of degrees is allowed, but best precision will result from\n* keeping `angle` in the range [-360, +360].\n*\n* @returns {RotationMatrix}\n* A pivoted matrix object.\n*/", "meta": { "range": [ - 220258, - 221471 + 220253, + 221466 ], "filename": "astronomy.js", "lineno": 4943, @@ -45979,8 +45979,8 @@ "comment": "", "meta": { "range": [ - 220459, - 220506 + 220454, + 220501 ], "filename": "astronomy.js", "lineno": 4947, @@ -46004,8 +46004,8 @@ "comment": "", "meta": { "range": [ - 220518, - 220539 + 220513, + 220534 ], "filename": "astronomy.js", "lineno": 4948, @@ -46029,8 +46029,8 @@ "comment": "", "meta": { "range": [ - 220551, - 220572 + 220546, + 220567 ], "filename": "astronomy.js", "lineno": 4949, @@ -46054,8 +46054,8 @@ "comment": "", "meta": { "range": [ - 220817, - 220835 + 220812, + 220830 ], "filename": "astronomy.js", "lineno": 4956, @@ -46079,8 +46079,8 @@ "comment": "", "meta": { "range": [ - 220847, - 220865 + 220842, + 220860 ], "filename": "astronomy.js", "lineno": 4957, @@ -46104,8 +46104,8 @@ "comment": "", "meta": { "range": [ - 220877, - 220885 + 220872, + 220880 ], "filename": "astronomy.js", "lineno": 4958, @@ -46129,8 +46129,8 @@ "comment": "", "meta": { "range": [ - 220895, - 220934 + 220890, + 220929 ], "filename": "astronomy.js", "lineno": 4959, @@ -46154,8 +46154,8 @@ "comment": "", "meta": { "range": [ - 220940, - 220999 + 220935, + 220994 ], "filename": "astronomy.js", "lineno": 4960, @@ -46180,8 +46180,8 @@ "comment": "", "meta": { "range": [ - 221005, - 221064 + 221000, + 221059 ], "filename": "astronomy.js", "lineno": 4961, @@ -46206,8 +46206,8 @@ "comment": "", "meta": { "range": [ - 221070, - 221100 + 221065, + 221095 ], "filename": "astronomy.js", "lineno": 4962, @@ -46232,8 +46232,8 @@ "comment": "", "meta": { "range": [ - 221106, - 221165 + 221101, + 221160 ], "filename": "astronomy.js", "lineno": 4963, @@ -46258,8 +46258,8 @@ "comment": "", "meta": { "range": [ - 221171, - 221230 + 221166, + 221225 ], "filename": "astronomy.js", "lineno": 4964, @@ -46284,8 +46284,8 @@ "comment": "", "meta": { "range": [ - 221236, - 221266 + 221231, + 221261 ], "filename": "astronomy.js", "lineno": 4965, @@ -46310,8 +46310,8 @@ "comment": "", "meta": { "range": [ - 221272, - 221331 + 221267, + 221326 ], "filename": "astronomy.js", "lineno": 4966, @@ -46336,8 +46336,8 @@ "comment": "", "meta": { "range": [ - 221337, - 221396 + 221332, + 221391 ], "filename": "astronomy.js", "lineno": 4967, @@ -46362,8 +46362,8 @@ "comment": "", "meta": { "range": [ - 221402, - 221432 + 221397, + 221427 ], "filename": "astronomy.js", "lineno": 4968, @@ -46388,8 +46388,8 @@ "comment": "", "meta": { "range": [ - 221472, - 221493 + 221467, + 221488 ], "filename": "astronomy.js", "lineno": 4971, @@ -46412,8 +46412,8 @@ "comment": "/**\n * @brief Converts spherical coordinates to Cartesian coordinates.\n *\n * Given spherical coordinates and a time at which they are valid,\n * returns a vector of Cartesian coordinates. The returned value\n * includes the time, as required by `AstroTime`.\n *\n * @param {Spherical} sphere\n * Spherical coordinates to be converted.\n *\n * @param {AstroTime} time\n * The time that should be included in the returned vector.\n *\n * @returns {Vector}\n * The vector form of the supplied spherical coordinates.\n */", "meta": { "range": [ - 222016, - 222326 + 222011, + 222321 ], "filename": "astronomy.js", "lineno": 4988, @@ -46480,8 +46480,8 @@ "comment": "", "meta": { "range": [ - 222068, - 222105 + 222063, + 222100 ], "filename": "astronomy.js", "lineno": 4989, @@ -46505,8 +46505,8 @@ "comment": "", "meta": { "range": [ - 222117, - 222154 + 222112, + 222149 ], "filename": "astronomy.js", "lineno": 4990, @@ -46530,8 +46530,8 @@ "comment": "", "meta": { "range": [ - 222166, - 222206 + 222161, + 222201 ], "filename": "astronomy.js", "lineno": 4991, @@ -46555,8 +46555,8 @@ "comment": "", "meta": { "range": [ - 222327, - 222370 + 222322, + 222365 ], "filename": "astronomy.js", "lineno": 4994, @@ -46579,8 +46579,8 @@ "comment": "/**\n * @brief Given an equatorial vector, calculates equatorial angular coordinates.\n *\n * @param {Vector} vec\n * A vector in an equatorial coordinate system.\n *\n * @returns {EquatorialCoordinates}\n * Angular coordinates expressed in the same equatorial system as `vec`.\n */", "meta": { "range": [ - 222657, - 222819 + 222652, + 222814 ], "filename": "astronomy.js", "lineno": 5004, @@ -46635,8 +46635,8 @@ "comment": "", "meta": { "range": [ - 222701, - 222731 + 222696, + 222726 ], "filename": "astronomy.js", "lineno": 5005, @@ -46660,8 +46660,8 @@ "comment": "", "meta": { "range": [ - 222820, - 222865 + 222815, + 222860 ], "filename": "astronomy.js", "lineno": 5008, @@ -46684,8 +46684,8 @@ "comment": "/**\n * @brief Converts Cartesian coordinates to spherical coordinates.\n *\n * Given a Cartesian vector, returns latitude, longitude, and distance.\n *\n * @param {Vector} vector\n * Cartesian vector to be converted to spherical coordinates.\n *\n * @returns {Spherical}\n * Spherical coordinates that are equivalent to the given vector.\n */", "meta": { "range": [ - 223211, - 223837 + 223206, + 223832 ], "filename": "astronomy.js", "lineno": 5020, @@ -46743,8 +46743,8 @@ "comment": "", "meta": { "range": [ - 223257, - 223307 + 223252, + 223302 ], "filename": "astronomy.js", "lineno": 5021, @@ -46768,8 +46768,8 @@ "comment": "", "meta": { "range": [ - 223319, - 223365 + 223314, + 223360 ], "filename": "astronomy.js", "lineno": 5022, @@ -46793,8 +46793,8 @@ "comment": "", "meta": { "range": [ - 223375, - 223378 + 223370, + 223373 ], "filename": "astronomy.js", "lineno": 5023, @@ -46816,8 +46816,8 @@ "comment": "", "meta": { "range": [ - 223380, - 223383 + 223375, + 223378 ], "filename": "astronomy.js", "lineno": 5023, @@ -46839,8 +46839,8 @@ "comment": "", "meta": { "range": [ - 223514, - 223523 + 223509, + 223518 ], "filename": "astronomy.js", "lineno": 5028, @@ -46865,8 +46865,8 @@ "comment": "", "meta": { "range": [ - 223533, - 223571 + 223528, + 223566 ], "filename": "astronomy.js", "lineno": 5029, @@ -46891,8 +46891,8 @@ "comment": "", "meta": { "range": [ - 223598, - 223652 + 223593, + 223647 ], "filename": "astronomy.js", "lineno": 5032, @@ -46917,8 +46917,8 @@ "comment": "", "meta": { "range": [ - 223691, - 223703 + 223686, + 223698 ], "filename": "astronomy.js", "lineno": 5034, @@ -46943,8 +46943,8 @@ "comment": "", "meta": { "range": [ - 223723, - 223786 + 223718, + 223781 ], "filename": "astronomy.js", "lineno": 5036, @@ -46969,8 +46969,8 @@ "comment": "", "meta": { "range": [ - 223838, - 223881 + 223833, + 223876 ], "filename": "astronomy.js", "lineno": 5040, @@ -46993,8 +46993,8 @@ "comment": "", "meta": { "range": [ - 223883, - 224044 + 223878, + 224039 ], "filename": "astronomy.js", "lineno": 5041, @@ -47022,8 +47022,8 @@ "comment": "", "meta": { "range": [ - 223925, - 223940 + 223920, + 223935 ], "filename": "astronomy.js", "lineno": 5042, @@ -47048,8 +47048,8 @@ "comment": "", "meta": { "range": [ - 223971, - 223982 + 223966, + 223977 ], "filename": "astronomy.js", "lineno": 5044, @@ -47074,8 +47074,8 @@ "comment": "", "meta": { "range": [ - 224015, - 224026 + 224010, + 224021 ], "filename": "astronomy.js", "lineno": 5046, @@ -47100,8 +47100,8 @@ "comment": "/**\n * @brief Converts Cartesian coordinates to horizontal coordinates.\n *\n * Given a horizontal Cartesian vector, returns horizontal azimuth and altitude.\n *\n * *IMPORTANT:* This function differs from {@link SphereFromVector} in two ways:\n * - `SphereFromVector` returns a `lon` value that represents azimuth defined counterclockwise\n * from north (e.g., west = +90), but this function represents a clockwise rotation\n * (e.g., east = +90). The difference is because `SphereFromVector` is intended\n * to preserve the vector \"right-hand rule\", while this function defines azimuth in a more\n * traditional way as used in navigation and cartography.\n * - This function optionally corrects for atmospheric refraction, while `SphereFromVector` does not.\n *\n * The returned object contains the azimuth in `lon`.\n * It is measured in degrees clockwise from north: east = +90 degrees, west = +270 degrees.\n *\n * The altitude is stored in `lat`.\n *\n * The distance to the observed object is stored in `dist`,\n * and is expressed in astronomical units (AU).\n *\n * @param {Vector} vector\n * Cartesian vector to be converted to horizontal coordinates.\n *\n * @param {string} refraction\n * `\"normal\"`: correct altitude for atmospheric refraction (recommended).\n * `\"jplhor\"`: for JPL Horizons compatibility testing only; not recommended for normal use.\n * `null`: no atmospheric refraction correction is performed.\n *\n * @returns {Spherical}\n */", "meta": { "range": [ - 225506, - 225727 + 225501, + 225722 ], "filename": "astronomy.js", "lineno": 5080, @@ -47167,8 +47167,8 @@ "comment": "", "meta": { "range": [ - 225565, - 225598 + 225560, + 225593 ], "filename": "astronomy.js", "lineno": 5081, @@ -47192,8 +47192,8 @@ "comment": "", "meta": { "range": [ - 225604, - 225651 + 225599, + 225646 ], "filename": "astronomy.js", "lineno": 5082, @@ -47218,8 +47218,8 @@ "comment": "", "meta": { "range": [ - 225657, - 225705 + 225652, + 225700 ], "filename": "astronomy.js", "lineno": 5083, @@ -47244,8 +47244,8 @@ "comment": "", "meta": { "range": [ - 225728, - 225773 + 225723, + 225768 ], "filename": "astronomy.js", "lineno": 5086, @@ -47268,8 +47268,8 @@ "comment": "/**\n * @brief Given apparent angular horizontal coordinates in `sphere`, calculate horizontal vector.\n *\n * @param {Spherical} sphere\n * A structure that contains apparent horizontal coordinates:\n * `lat` holds the refracted azimuth angle,\n * `lon` holds the azimuth in degrees clockwise from north,\n * and `dist` holds the distance from the observer to the object in AU.\n *\n * @param {AstroTime} time\n * The date and time of the observation. This is needed because the returned\n * vector object requires a valid time value when passed to certain other functions.\n *\n * @param {string} refraction\n * `\"normal\"`: correct altitude for atmospheric refraction (recommended).\n * `\"jplhor\"`: for JPL Horizons compatibility testing only; not recommended for normal use.\n * `null`: no atmospheric refraction correction is performed.\n *\n * @returns {Vector}\n * A vector in the horizontal system: `x` = north, `y` = west, and `z` = zenith (up).\n */", "meta": { "range": [ - 226764, - 227172 + 226759, + 227167 ], "filename": "astronomy.js", "lineno": 5108, @@ -47346,8 +47346,8 @@ "comment": "", "meta": { "range": [ - 226913, - 226953 + 226908, + 226948 ], "filename": "astronomy.js", "lineno": 5110, @@ -47371,8 +47371,8 @@ "comment": "", "meta": { "range": [ - 227007, - 227067 + 227002, + 227062 ], "filename": "astronomy.js", "lineno": 5112, @@ -47396,8 +47396,8 @@ "comment": "", "meta": { "range": [ - 227079, - 227125 + 227074, + 227120 ], "filename": "astronomy.js", "lineno": 5113, @@ -47421,8 +47421,8 @@ "comment": "", "meta": { "range": [ - 227173, - 227218 + 227168, + 227213 ], "filename": "astronomy.js", "lineno": 5116, @@ -47445,8 +47445,8 @@ "comment": "/**\n * @brief Calculates the amount of \"lift\" to an altitude angle caused by atmospheric refraction.\n *\n * Given an altitude angle and a refraction option, calculates\n * the amount of \"lift\" caused by atmospheric refraction.\n * This is the number of degrees higher in the sky an object appears\n * due to the lensing of the Earth's atmosphere.\n *\n * @param {string} refraction\n * `\"normal\"`: correct altitude for atmospheric refraction (recommended).\n * `\"jplhor\"`: for JPL Horizons compatibility testing only; not recommended for normal use.\n * `null`: no atmospheric refraction correction is performed.\n *\n * @param {number} altitude\n * An altitude angle in a horizontal coordinate system. Must be a value between -90 and +90.\n *\n * @returns {number}\n * The angular adjustment in degrees to be added to the altitude angle to correct for atmospheric lensing.\n */", "meta": { "range": [ - 228108, - 229703 + 228103, + 229698 ], "filename": "astronomy.js", "lineno": 5136, @@ -47512,8 +47512,8 @@ "comment": "", "meta": { "range": [ - 228160, - 228164 + 228155, + 228159 ], "filename": "astronomy.js", "lineno": 5137, @@ -47535,8 +47535,8 @@ "comment": "", "meta": { "range": [ - 228993, - 229006 + 228988, + 229001 ], "filename": "astronomy.js", "lineno": 5150, @@ -47560,8 +47560,8 @@ "comment": "", "meta": { "range": [ - 229043, - 229052 + 229038, + 229047 ], "filename": "astronomy.js", "lineno": 5152, @@ -47586,8 +47586,8 @@ "comment": "", "meta": { "range": [ - 229062, - 229138 + 229057, + 229133 ], "filename": "astronomy.js", "lineno": 5153, @@ -47612,8 +47612,8 @@ "comment": "", "meta": { "range": [ - 229532, - 229564 + 229527, + 229559 ], "filename": "astronomy.js", "lineno": 5159, @@ -47638,8 +47638,8 @@ "comment": "", "meta": { "range": [ - 229667, - 229677 + 229662, + 229672 ], "filename": "astronomy.js", "lineno": 5164, @@ -47664,8 +47664,8 @@ "comment": "", "meta": { "range": [ - 229704, - 229735 + 229699, + 229730 ], "filename": "astronomy.js", "lineno": 5168, @@ -47688,8 +47688,8 @@ "comment": "/**\n * @brief Calculates the inverse of an atmospheric refraction angle.\n *\n * Given an observed altitude angle that includes atmospheric refraction,\n * calculate the negative angular correction to obtain the unrefracted\n * altitude. This is useful for cases where observed horizontal\n * coordinates are to be converted to another orientation system,\n * but refraction first must be removed from the observed position.\n *\n * @param {string} refraction\n * `\"normal\"`: correct altitude for atmospheric refraction (recommended).\n * `\"jplhor\"`: for JPL Horizons compatibility testing only; not recommended for normal use.\n * `null`: no atmospheric refraction correction is performed.\n *\n * @param {number} bent_altitude\n * The apparent altitude that includes atmospheric refraction.\n *\n * @returns {number}\n * The angular adjustment in degrees to be added to the\n * altitude angle to correct for atmospheric lensing.\n * This will be less than or equal to zero.\n */", "meta": { "range": [ - 230733, - 231334 + 230728, + 231329 ], "filename": "astronomy.js", "lineno": 5191, @@ -47755,8 +47755,8 @@ "comment": "", "meta": { "range": [ - 231019, - 231083 + 231014, + 231078 ], "filename": "astronomy.js", "lineno": 5196, @@ -47780,8 +47780,8 @@ "comment": "", "meta": { "range": [ - 231148, - 231216 + 231143, + 231211 ], "filename": "astronomy.js", "lineno": 5199, @@ -47805,8 +47805,8 @@ "comment": "", "meta": { "range": [ - 231309, - 231325 + 231304, + 231320 ], "filename": "astronomy.js", "lineno": 5202, @@ -47831,8 +47831,8 @@ "comment": "", "meta": { "range": [ - 231335, - 231380 + 231330, + 231375 ], "filename": "astronomy.js", "lineno": 5205, @@ -47855,8 +47855,8 @@ "comment": "/**\n * @brief Applies a rotation to a vector, yielding a rotated vector.\n *\n * This function transforms a vector in one orientation to a vector\n * in another orientation.\n *\n * @param {RotationMatrix} rotation\n * A rotation matrix that specifies how the orientation of the vector is to be changed.\n *\n * @param {Vector} vector\n * The vector whose orientation is to be changed.\n *\n * @returns {Vector}\n * A vector in the orientation specified by `rotation`.\n */", "meta": { "range": [ - 231858, - 232219 + 231853, + 232214 ], "filename": "astronomy.js", "lineno": 5221, @@ -47918,8 +47918,8 @@ "comment": "", "meta": { "range": [ - 232220, - 232255 + 232215, + 232250 ], "filename": "astronomy.js", "lineno": 5224, @@ -47942,8 +47942,8 @@ "comment": "/**\n * @brief Applies a rotation to a state vector, yielding a rotated vector.\n *\n * This function transforms a state vector in one orientation to a vector\n * in another orientation.\n *\n * @param {RotationMatrix} rotation\n * A rotation matrix that specifies how the orientation of the state vector is to be changed.\n *\n * @param {StateVector} state\n * The state vector whose orientation is to be changed.\n * Both the position and velocity components are transformed.\n *\n * @return {StateVector}\n * A state vector in the orientation specified by `rotation`.\n */", "meta": { "range": [ - 232838, - 233477 + 232833, + 233472 ], "filename": "astronomy.js", "lineno": 5241, @@ -48005,8 +48005,8 @@ "comment": "", "meta": { "range": [ - 233478, - 233511 + 233473, + 233506 ], "filename": "astronomy.js", "lineno": 5244, @@ -48029,8 +48029,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from equatorial J2000 (EQJ) to ecliptic J2000 (ECL).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: EQJ = equatorial system, using equator at J2000 epoch.\n * Target: ECL = ecliptic system, using equator at J2000 epoch.\n *\n * @returns {RotationMatrix}\n * A rotation matrix that converts EQJ to ECL.\n */", "meta": { "range": [ - 233954, - 234264 + 233949, + 234259 ], "filename": "astronomy.js", "lineno": 5256, @@ -48074,8 +48074,8 @@ "comment": "", "meta": { "range": [ - 234077, - 234099 + 234072, + 234094 ], "filename": "astronomy.js", "lineno": 5258, @@ -48099,8 +48099,8 @@ "comment": "", "meta": { "range": [ - 234125, - 234147 + 234120, + 234142 ], "filename": "astronomy.js", "lineno": 5259, @@ -48124,8 +48124,8 @@ "comment": "", "meta": { "range": [ - 234265, - 234308 + 234260, + 234303 ], "filename": "astronomy.js", "lineno": 5266, @@ -48148,8 +48148,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from ecliptic J2000 (ECL) to equatorial J2000 (EQJ).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: ECL = ecliptic system, using equator at J2000 epoch.\n * Target: EQJ = equatorial system, using equator at J2000 epoch.\n *\n * @returns {RotationMatrix}\n * A rotation matrix that converts ECL to EQJ.\n */", "meta": { "range": [ - 234751, - 235061 + 234746, + 235056 ], "filename": "astronomy.js", "lineno": 5278, @@ -48193,8 +48193,8 @@ "comment": "", "meta": { "range": [ - 234874, - 234896 + 234869, + 234891 ], "filename": "astronomy.js", "lineno": 5280, @@ -48218,8 +48218,8 @@ "comment": "", "meta": { "range": [ - 234922, - 234944 + 234917, + 234939 ], "filename": "astronomy.js", "lineno": 5281, @@ -48243,8 +48243,8 @@ "comment": "", "meta": { "range": [ - 235062, - 235105 + 235057, + 235100 ], "filename": "astronomy.js", "lineno": 5288, @@ -48267,8 +48267,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from equatorial J2000 (EQJ) to equatorial of-date (EQD).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: EQJ = equatorial system, using equator at J2000 epoch.\n * Target: EQD = equatorial system, using equator of the specified date/time.\n *\n * @param {FlexibleDateTime} time\n * The date and time at which the Earth's equator defines the target orientation.\n *\n * @returns {RotationMatrix}\n * A rotation matrix that converts EQJ to EQD at `time`.\n */", "meta": { "range": [ - 235700, - 235930 + 235695, + 235925 ], "filename": "astronomy.js", "lineno": 5303, @@ -48325,8 +48325,8 @@ "comment": "", "meta": { "range": [ - 235738, - 235759 + 235733, + 235754 ], "filename": "astronomy.js", "lineno": 5304, @@ -48351,8 +48351,8 @@ "comment": "", "meta": { "range": [ - 235771, - 235825 + 235766, + 235820 ], "filename": "astronomy.js", "lineno": 5305, @@ -48376,8 +48376,8 @@ "comment": "", "meta": { "range": [ - 235837, - 235888 + 235832, + 235883 ], "filename": "astronomy.js", "lineno": 5306, @@ -48401,8 +48401,8 @@ "comment": "", "meta": { "range": [ - 235931, - 235974 + 235926, + 235969 ], "filename": "astronomy.js", "lineno": 5309, @@ -48425,8 +48425,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from equatorial of-date (EQD) to equatorial J2000 (EQJ).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: EQD = equatorial system, using equator of the specified date/time.\n * Target: EQJ = equatorial system, using equator at J2000 epoch.\n *\n * @param {FlexibleDateTime} time\n * The date and time at which the Earth's equator defines the source orientation.\n *\n * @returns {RotationMatrix}\n * A rotation matrix that converts EQD at `time` to EQJ.\n */", "meta": { "range": [ - 236569, - 236799 + 236564, + 236794 ], "filename": "astronomy.js", "lineno": 5324, @@ -48483,8 +48483,8 @@ "comment": "", "meta": { "range": [ - 236607, - 236628 + 236602, + 236623 ], "filename": "astronomy.js", "lineno": 5325, @@ -48509,8 +48509,8 @@ "comment": "", "meta": { "range": [ - 236640, - 236691 + 236635, + 236686 ], "filename": "astronomy.js", "lineno": 5326, @@ -48534,8 +48534,8 @@ "comment": "", "meta": { "range": [ - 236703, - 236757 + 236698, + 236752 ], "filename": "astronomy.js", "lineno": 5327, @@ -48559,8 +48559,8 @@ "comment": "", "meta": { "range": [ - 236800, - 236843 + 236795, + 236838 ], "filename": "astronomy.js", "lineno": 5330, @@ -48583,8 +48583,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from equatorial of-date (EQD) to horizontal (HOR).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: EQD = equatorial system, using equator of the specified date/time.\n * Target: HOR = horizontal system.\n *\n * Use `HorizonFromVector` to convert the return value\n * to a traditional altitude/azimuth pair.\n *\n * @param {FlexibleDateTime} time\n * The date and time at which the Earth's equator applies.\n *\n * @param {Observer} observer\n * A location near the Earth's mean sea level that defines the observer's horizon.\n *\n * @returns {RotationMatrix}\n * A rotation matrix that converts EQD to HOR at `time` and for `observer`.\n * The components of the horizontal vector are:\n * x = north, y = west, z = zenith (straight up from the observer).\n * These components are chosen so that the \"right-hand rule\" works for the vector\n * and so that north represents the direction where azimuth = 0.\n */", "meta": { "range": [ - 237903, - 238698 + 237898, + 238693 ], "filename": "astronomy.js", "lineno": 5355, @@ -48660,8 +48660,8 @@ "comment": "", "meta": { "range": [ - 237951, - 237972 + 237946, + 237967 ], "filename": "astronomy.js", "lineno": 5356, @@ -48686,8 +48686,8 @@ "comment": "", "meta": { "range": [ - 237984, - 238038 + 237979, + 238033 ], "filename": "astronomy.js", "lineno": 5357, @@ -48711,8 +48711,8 @@ "comment": "", "meta": { "range": [ - 238050, - 238104 + 238045, + 238099 ], "filename": "astronomy.js", "lineno": 5358, @@ -48736,8 +48736,8 @@ "comment": "", "meta": { "range": [ - 238116, - 238171 + 238111, + 238166 ], "filename": "astronomy.js", "lineno": 5359, @@ -48761,8 +48761,8 @@ "comment": "", "meta": { "range": [ - 238183, - 238238 + 238178, + 238233 ], "filename": "astronomy.js", "lineno": 5360, @@ -48786,8 +48786,8 @@ "comment": "", "meta": { "range": [ - 238250, - 238298 + 238245, + 238293 ], "filename": "astronomy.js", "lineno": 5361, @@ -48811,8 +48811,8 @@ "comment": "", "meta": { "range": [ - 238310, - 238360 + 238305, + 238355 ], "filename": "astronomy.js", "lineno": 5362, @@ -48836,8 +48836,8 @@ "comment": "", "meta": { "range": [ - 238372, - 238398 + 238367, + 238393 ], "filename": "astronomy.js", "lineno": 5363, @@ -48861,8 +48861,8 @@ "comment": "", "meta": { "range": [ - 238410, - 238448 + 238405, + 238443 ], "filename": "astronomy.js", "lineno": 5364, @@ -48886,8 +48886,8 @@ "comment": "", "meta": { "range": [ - 238460, - 238486 + 238455, + 238481 ], "filename": "astronomy.js", "lineno": 5365, @@ -48911,8 +48911,8 @@ "comment": "", "meta": { "range": [ - 238498, - 238524 + 238493, + 238519 ], "filename": "astronomy.js", "lineno": 5366, @@ -48936,8 +48936,8 @@ "comment": "", "meta": { "range": [ - 238536, - 238562 + 238531, + 238557 ], "filename": "astronomy.js", "lineno": 5367, @@ -48961,8 +48961,8 @@ "comment": "", "meta": { "range": [ - 238699, - 238742 + 238694, + 238737 ], "filename": "astronomy.js", "lineno": 5374, @@ -48985,8 +48985,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from horizontal (HOR) to equatorial of-date (EQD).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: HOR = horizontal system (x=North, y=West, z=Zenith).\n * Target: EQD = equatorial system, using equator of the specified date/time.\n *\n * @param {FlexibleDateTime} time\n * The date and time at which the Earth's equator applies.\n *\n * @param {Observer} observer\n * A location near the Earth's mean sea level that defines the observer's horizon.\n *\n * @returns {RotationMatrix}\n * A rotation matrix that converts HOR to EQD at `time` and for `observer`.\n */", "meta": { "range": [ - 239446, - 239574 + 239441, + 239569 ], "filename": "astronomy.js", "lineno": 5392, @@ -49051,8 +49051,8 @@ "comment": "", "meta": { "range": [ - 239500, - 239538 + 239495, + 239533 ], "filename": "astronomy.js", "lineno": 5393, @@ -49076,8 +49076,8 @@ "comment": "", "meta": { "range": [ - 239575, - 239618 + 239570, + 239613 ], "filename": "astronomy.js", "lineno": 5396, @@ -49100,8 +49100,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from horizontal (HOR) to J2000 equatorial (EQJ).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: HOR = horizontal system (x=North, y=West, z=Zenith).\n * Target: EQJ = equatorial system, using equator at the J2000 epoch.\n *\n * @param {FlexibleDateTime} time\n * The date and time of the observation.\n *\n * @param {Observer} observer\n * A location near the Earth's mean sea level that defines the observer's horizon.\n *\n * @returns {RotationMatrix}\n * A rotation matrix that converts HOR to EQD at `time` and for `observer`.\n */", "meta": { "range": [ - 240294, - 240510 + 240289, + 240505 ], "filename": "astronomy.js", "lineno": 5414, @@ -49168,8 +49168,8 @@ "comment": "", "meta": { "range": [ - 240342, - 240363 + 240337, + 240358 ], "filename": "astronomy.js", "lineno": 5415, @@ -49194,8 +49194,8 @@ "comment": "", "meta": { "range": [ - 240375, - 240417 + 240370, + 240412 ], "filename": "astronomy.js", "lineno": 5416, @@ -49219,8 +49219,8 @@ "comment": "", "meta": { "range": [ - 240429, - 240461 + 240424, + 240456 ], "filename": "astronomy.js", "lineno": 5417, @@ -49244,8 +49244,8 @@ "comment": "", "meta": { "range": [ - 240511, - 240554 + 240506, + 240549 ], "filename": "astronomy.js", "lineno": 5420, @@ -49268,8 +49268,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from equatorial J2000 (EQJ) to horizontal (HOR).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: EQJ = equatorial system, using the equator at the J2000 epoch.\n * Target: HOR = horizontal system.\n *\n * Use {@link HorizonFromVector} to convert the return value\n * to a traditional altitude/azimuth pair.\n *\n * @param {FlexibleDateTime} time\n * The date and time of the desired horizontal orientation.\n *\n * @param {Observer} observer\n * A location near the Earth's mean sea level that defines the observer's horizon.\n *\n * @return\n * A rotation matrix that converts EQJ to HOR at `time` and for `observer`.\n * The components of the horizontal vector are:\n * x = north, y = west, z = zenith (straight up from the observer).\n * These components are chosen so that the \"right-hand rule\" works for the vector\n * and so that north represents the direction where azimuth = 0.\n */", "meta": { "range": [ - 241597, - 241725 + 241592, + 241720 ], "filename": "astronomy.js", "lineno": 5445, @@ -49329,8 +49329,8 @@ "comment": "", "meta": { "range": [ - 241651, - 241689 + 241646, + 241684 ], "filename": "astronomy.js", "lineno": 5446, @@ -49354,8 +49354,8 @@ "comment": "", "meta": { "range": [ - 241726, - 241769 + 241721, + 241764 ], "filename": "astronomy.js", "lineno": 5449, @@ -49378,8 +49378,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from equatorial of-date (EQD) to ecliptic J2000 (ECL).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: EQD = equatorial system, using equator of date.\n * Target: ECL = ecliptic system, using equator at J2000 epoch.\n *\n * @param {FlexibleDateTime} time\n * The date and time of the source equator.\n *\n * @returns {RotationMatrix}\n * A rotation matrix that converts EQD to ECL.\n */", "meta": { "range": [ - 242293, - 242458 + 242288, + 242453 ], "filename": "astronomy.js", "lineno": 5464, @@ -49435,8 +49435,8 @@ "comment": "", "meta": { "range": [ - 242337, - 242369 + 242332, + 242364 ], "filename": "astronomy.js", "lineno": 5465, @@ -49460,8 +49460,8 @@ "comment": "", "meta": { "range": [ - 242381, - 242409 + 242376, + 242404 ], "filename": "astronomy.js", "lineno": 5466, @@ -49485,8 +49485,8 @@ "comment": "", "meta": { "range": [ - 242459, - 242502 + 242454, + 242497 ], "filename": "astronomy.js", "lineno": 5469, @@ -49509,8 +49509,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from ecliptic J2000 (ECL) to equatorial of-date (EQD).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: ECL = ecliptic system, using equator at J2000 epoch.\n * Target: EQD = equatorial system, using equator of date.\n *\n * @param {FlexibleDateTime} time\n * The date and time of the desired equator.\n *\n * @returns {RotationMatrix}\n * A rotation matrix that converts ECL to EQD.\n */", "meta": { "range": [ - 243027, - 243135 + 243022, + 243130 ], "filename": "astronomy.js", "lineno": 5484, @@ -49565,8 +49565,8 @@ "comment": "", "meta": { "range": [ - 243071, - 243099 + 243066, + 243094 ], "filename": "astronomy.js", "lineno": 5485, @@ -49590,8 +49590,8 @@ "comment": "", "meta": { "range": [ - 243136, - 243179 + 243131, + 243174 ], "filename": "astronomy.js", "lineno": 5488, @@ -49614,8 +49614,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from ecliptic J2000 (ECL) to horizontal (HOR).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: ECL = ecliptic system, using equator at J2000 epoch.\n * Target: HOR = horizontal system.\n *\n * Use {@link HorizonFromVector} to convert the return value\n * to a traditional altitude/azimuth pair.\n *\n * @param {FlexibleDateTime} time\n * The date and time of the desired horizontal orientation.\n *\n * @param {Observer} observer\n * A location near the Earth's mean sea level that defines the observer's horizon.\n *\n * @returns {RotationMatrix}\n * A rotation matrix that converts ECL to HOR at `time` and for `observer`.\n * The components of the horizontal vector are:\n * x = north, y = west, z = zenith (straight up from the observer).\n * These components are chosen so that the \"right-hand rule\" works for the vector\n * and so that north represents the direction where azimuth = 0.\n */", "meta": { "range": [ - 244228, - 244444 + 244223, + 244439 ], "filename": "astronomy.js", "lineno": 5513, @@ -49682,8 +49682,8 @@ "comment": "", "meta": { "range": [ - 244276, - 244297 + 244271, + 244292 ], "filename": "astronomy.js", "lineno": 5514, @@ -49708,8 +49708,8 @@ "comment": "", "meta": { "range": [ - 244309, - 244341 + 244304, + 244336 ], "filename": "astronomy.js", "lineno": 5515, @@ -49733,8 +49733,8 @@ "comment": "", "meta": { "range": [ - 244353, - 244395 + 244348, + 244390 ], "filename": "astronomy.js", "lineno": 5516, @@ -49758,8 +49758,8 @@ "comment": "", "meta": { "range": [ - 244445, - 244488 + 244440, + 244483 ], "filename": "astronomy.js", "lineno": 5519, @@ -49782,8 +49782,8 @@ "comment": "/**\n * @brief Calculates a rotation matrix from horizontal (HOR) to ecliptic J2000 (ECL).\n *\n * This is one of the family of functions that returns a rotation matrix\n * for converting from one orientation to another.\n * Source: HOR = horizontal system.\n * Target: ECL = ecliptic system, using equator at J2000 epoch.\n *\n * @param {FlexibleDateTime} time\n * The date and time of the horizontal observation.\n *\n * @param {Observer} observer\n * The location of the horizontal observer.\n *\n * @returns {RotationMatrix}\n * A rotation matrix that converts HOR to ECL.\n */", "meta": { "range": [ - 245071, - 245199 + 245066, + 245194 ], "filename": "astronomy.js", "lineno": 5537, @@ -49848,8 +49848,8 @@ "comment": "", "meta": { "range": [ - 245125, - 245163 + 245120, + 245158 ], "filename": "astronomy.js", "lineno": 5538, @@ -49873,8 +49873,8 @@ "comment": "", "meta": { "range": [ - 245200, - 245243 + 245195, + 245238 ], "filename": "astronomy.js", "lineno": 5541, @@ -49897,8 +49897,8 @@ "comment": "", "meta": { "range": [ - 245251, - 248387 + 245246, + 248382 ], "filename": "astronomy.js", "lineno": 5542, @@ -49921,8 +49921,8 @@ "comment": "", "meta": { "range": [ - 248395, - 262468 + 248390, + 262463 ], "filename": "astronomy.js", "lineno": 5719, @@ -49945,8 +49945,8 @@ "comment": "", "meta": { "range": [ - 262474, - 262484 + 262469, + 262479 ], "filename": "astronomy.js", "lineno": 6434, @@ -49967,8 +49967,8 @@ "comment": "", "meta": { "range": [ - 262490, - 262499 + 262485, + 262494 ], "filename": "astronomy.js", "lineno": 6435, @@ -49989,8 +49989,8 @@ "comment": "/**\n * @brief Reports the constellation that a given celestial point lies within.\n *\n * @property {string} symbol\n * 3-character mnemonic symbol for the constellation, e.g. \"Ori\".\n *\n * @property {string} name\n * Full name of constellation, e.g. \"Orion\".\n *\n * @property {number} ra1875\n * Right ascension expressed in B1875 coordinates.\n *\n * @property {number} dec1875\n * Declination expressed in B1875 coordinates.\n */", "meta": { "range": [ - 262943, - 263143 + 262938, + 263138 ], "filename": "astronomy.js", "lineno": 6451, @@ -50063,8 +50063,8 @@ "comment": "", "meta": { "range": [ - 262973, - 263141 + 262968, + 263136 ], "filename": "astronomy.js", "lineno": 6452, @@ -50095,8 +50095,8 @@ "comment": "/**\n * @brief Reports the constellation that a given celestial point lies within.\n *\n * @property {string} symbol\n * 3-character mnemonic symbol for the constellation, e.g. \"Ori\".\n *\n * @property {string} name\n * Full name of constellation, e.g. \"Orion\".\n *\n * @property {number} ra1875\n * Right ascension expressed in B1875 coordinates.\n *\n * @property {number} dec1875\n * Declination expressed in B1875 coordinates.\n */", "meta": { "range": [ - 262943, - 263143 + 262938, + 263138 ], "filename": "astronomy.js", "lineno": 6451, @@ -50168,8 +50168,8 @@ "comment": "", "meta": { "range": [ - 263026, - 263046 + 263021, + 263041 ], "filename": "astronomy.js", "lineno": 6453, @@ -50193,8 +50193,8 @@ "comment": "", "meta": { "range": [ - 263056, - 263072 + 263051, + 263067 ], "filename": "astronomy.js", "lineno": 6454, @@ -50218,8 +50218,8 @@ "comment": "", "meta": { "range": [ - 263082, - 263102 + 263077, + 263097 ], "filename": "astronomy.js", "lineno": 6455, @@ -50243,8 +50243,8 @@ "comment": "", "meta": { "range": [ - 263112, - 263134 + 263107, + 263129 ], "filename": "astronomy.js", "lineno": 6456, @@ -50268,8 +50268,8 @@ "comment": "", "meta": { "range": [ - 263144, - 263189 + 263139, + 263184 ], "filename": "astronomy.js", "lineno": 6459, @@ -50292,8 +50292,8 @@ "comment": "/**\n * @brief Determines the constellation that contains the given point in the sky.\n *\n * Given J2000 equatorial (EQJ) coordinates of a point in the sky,\n * determines the constellation that contains that point.\n *\n * @param {number} ra\n * The right ascension (RA) of a point in the sky, using the J2000 equatorial system.\n *\n * @param {number} dec\n * The declination (DEC) of a point in the sky, using the J2000 equatorial system.\n *\n * @returns {ConstellationInfo}\n * An object that contains the 3-letter abbreviation and full name\n * of the constellation that contains the given (ra,dec), along with\n * the converted B1875 (ra,dec) for that point.\n */", "meta": { "range": [ - 263872, - 266076 + 263867, + 266071 ], "filename": "astronomy.js", "lineno": 6477, @@ -50371,8 +50371,8 @@ "comment": "", "meta": { "range": [ - 264113, - 264123 + 264108, + 264118 ], "filename": "astronomy.js", "lineno": 6484, @@ -50397,8 +50397,8 @@ "comment": "", "meta": { "range": [ - 264153, - 264163 + 264148, + 264158 ], "filename": "astronomy.js", "lineno": 6486, @@ -50423,8 +50423,8 @@ "comment": "", "meta": { "range": [ - 264945, - 265009 + 264940, + 265004 ], "filename": "astronomy.js", "lineno": 6501, @@ -50449,8 +50449,8 @@ "comment": "", "meta": { "range": [ - 265019, - 265047 + 265014, + 265042 ], "filename": "astronomy.js", "lineno": 6502, @@ -50475,8 +50475,8 @@ "comment": "", "meta": { "range": [ - 265113, - 265157 + 265108, + 265152 ], "filename": "astronomy.js", "lineno": 6505, @@ -50500,8 +50500,8 @@ "comment": "", "meta": { "range": [ - 265169, - 265215 + 265164, + 265210 ], "filename": "astronomy.js", "lineno": 6506, @@ -50525,8 +50525,8 @@ "comment": "", "meta": { "range": [ - 265227, - 265270 + 265222, + 265265 ], "filename": "astronomy.js", "lineno": 6507, @@ -50550,8 +50550,8 @@ "comment": "", "meta": { "range": [ - 265282, - 265318 + 265277, + 265313 ], "filename": "astronomy.js", "lineno": 6508, @@ -50575,8 +50575,8 @@ "comment": "", "meta": { "range": [ - 265395, - 265413 + 265390, + 265408 ], "filename": "astronomy.js", "lineno": 6510, @@ -50600,8 +50600,8 @@ "comment": "", "meta": { "range": [ - 265480, - 265492 + 265475, + 265487 ], "filename": "astronomy.js", "lineno": 6511, @@ -50625,8 +50625,8 @@ "comment": "", "meta": { "range": [ - 265569, - 265570 + 265564, + 265565 ], "filename": "astronomy.js", "lineno": 6512, @@ -50648,8 +50648,8 @@ "comment": "", "meta": { "range": [ - 265678, - 265693 + 265673, + 265688 ], "filename": "astronomy.js", "lineno": 6514, @@ -50673,8 +50673,8 @@ "comment": "", "meta": { "range": [ - 265709, - 265726 + 265704, + 265721 ], "filename": "astronomy.js", "lineno": 6515, @@ -50698,8 +50698,8 @@ "comment": "", "meta": { "range": [ - 265742, - 265759 + 265737, + 265754 ], "filename": "astronomy.js", "lineno": 6516, @@ -50723,8 +50723,8 @@ "comment": "", "meta": { "range": [ - 265858, - 265880 + 265853, + 265875 ], "filename": "astronomy.js", "lineno": 6518, @@ -50748,8 +50748,8 @@ "comment": "", "meta": { "range": [ - 266077, - 266114 + 266072, + 266109 ], "filename": "astronomy.js", "lineno": 6525, @@ -50772,8 +50772,8 @@ "comment": "/**\n * @brief Returns information about a lunar eclipse.\n *\n * Returned by {@link SearchLunarEclipse} or {@link NextLunarEclipse}\n * to report information about a lunar eclipse event.\n * When a lunar eclipse is found, it is classified as penumbral, partial, or total.\n * Penumbral eclipses are difficult to observe, because the moon is only slightly dimmed\n * by the Earth's penumbra; no part of the Moon touches the Earth's umbra.\n * Partial eclipses occur when part, but not all, of the Moon touches the Earth's umbra.\n * Total eclipses occur when the entire Moon passes into the Earth's umbra.\n *\n * The `kind` field thus holds one of the strings `\"penumbral\"`, `\"partial\"`,\n * or `\"total\"`, depending on the kind of lunar eclipse found.\n *\n * Field `peak` holds the date and time of the peak of the eclipse, when it is at its peak.\n *\n * Fields `sd_penum`, `sd_partial`, and `sd_total` hold the semi-duration of each phase\n * of the eclipse, which is half of the amount of time the eclipse spends in each\n * phase (expressed in minutes), or 0 if the eclipse never reaches that phase.\n * By converting from minutes to days, and subtracting/adding with `peak`, the caller\n * may determine the date and time of the beginning/end of each eclipse phase.\n *\n * @property {string} kind\n * The type of lunar eclipse found.\n *\n * @property {AstroTime} peak\n * The time of the eclipse at its peak.\n *\n * @property {number} sd_penum\n * The semi-duration of the penumbral phase in minutes.\n *\n * @property {number} sd_partial\n * The semi-duration of the penumbral phase in minutes, or 0.0 if none.\n *\n * @property {number} sd_total\n * The semi-duration of the penumbral phase in minutes, or 0.0 if none.\n *\n */", "meta": { "range": [ - 267844, - 268096 + 267839, + 268091 ], "filename": "astronomy.js", "lineno": 6564, @@ -50856,8 +50856,8 @@ "comment": "", "meta": { "range": [ - 267873, - 268094 + 267868, + 268089 ], "filename": "astronomy.js", "lineno": 6565, @@ -50889,8 +50889,8 @@ "comment": "/**\n * @brief Returns information about a lunar eclipse.\n *\n * Returned by {@link SearchLunarEclipse} or {@link NextLunarEclipse}\n * to report information about a lunar eclipse event.\n * When a lunar eclipse is found, it is classified as penumbral, partial, or total.\n * Penumbral eclipses are difficult to observe, because the moon is only slightly dimmed\n * by the Earth's penumbra; no part of the Moon touches the Earth's umbra.\n * Partial eclipses occur when part, but not all, of the Moon touches the Earth's umbra.\n * Total eclipses occur when the entire Moon passes into the Earth's umbra.\n *\n * The `kind` field thus holds one of the strings `\"penumbral\"`, `\"partial\"`,\n * or `\"total\"`, depending on the kind of lunar eclipse found.\n *\n * Field `peak` holds the date and time of the peak of the eclipse, when it is at its peak.\n *\n * Fields `sd_penum`, `sd_partial`, and `sd_total` hold the semi-duration of each phase\n * of the eclipse, which is half of the amount of time the eclipse spends in each\n * phase (expressed in minutes), or 0 if the eclipse never reaches that phase.\n * By converting from minutes to days, and subtracting/adding with `peak`, the caller\n * may determine the date and time of the beginning/end of each eclipse phase.\n *\n * @property {string} kind\n * The type of lunar eclipse found.\n *\n * @property {AstroTime} peak\n * The time of the eclipse at its peak.\n *\n * @property {number} sd_penum\n * The semi-duration of the penumbral phase in minutes.\n *\n * @property {number} sd_partial\n * The semi-duration of the penumbral phase in minutes, or 0.0 if none.\n *\n * @property {number} sd_total\n * The semi-duration of the penumbral phase in minutes, or 0.0 if none.\n *\n */", "meta": { "range": [ - 267844, - 268096 + 267839, + 268091 ], "filename": "astronomy.js", "lineno": 6564, @@ -50972,8 +50972,8 @@ "comment": "", "meta": { "range": [ - 267939, - 267955 + 267934, + 267950 ], "filename": "astronomy.js", "lineno": 6566, @@ -50997,8 +50997,8 @@ "comment": "", "meta": { "range": [ - 267965, - 267981 + 267960, + 267976 ], "filename": "astronomy.js", "lineno": 6567, @@ -51022,8 +51022,8 @@ "comment": "", "meta": { "range": [ - 267991, - 268015 + 267986, + 268010 ], "filename": "astronomy.js", "lineno": 6568, @@ -51047,8 +51047,8 @@ "comment": "", "meta": { "range": [ - 268025, - 268053 + 268020, + 268048 ], "filename": "astronomy.js", "lineno": 6569, @@ -51072,8 +51072,8 @@ "comment": "", "meta": { "range": [ - 268063, - 268087 + 268058, + 268082 ], "filename": "astronomy.js", "lineno": 6570, @@ -51097,8 +51097,8 @@ "comment": "", "meta": { "range": [ - 268097, - 268140 + 268092, + 268135 ], "filename": "astronomy.js", "lineno": 6573, @@ -51121,8 +51121,8 @@ "comment": "/**\n * @ignore\n *\n * @brief Represents the relative alignment of the Earth and another body, and their respective shadows.\n *\n * This is an internal data structure used to assist calculation of\n * lunar eclipses, solar eclipses, and transits of Mercury and Venus.\n *\n * Definitions:\n *\n * casting body = A body that casts a shadow of interest, possibly striking another body.\n *\n * receiving body = A body on which the shadow of another body might land.\n *\n * shadow axis = The line passing through the center of the Sun and the center of the casting body.\n *\n * shadow plane = The plane passing through the center of a receiving body,\n * and perpendicular to the shadow axis.\n *\n * @property {AstroTime} time\n * The time associated with the shadow calculation.\n *\n * @property {number} u\n * The distance [au] between the center of the casting body and the shadow plane.\n *\n * @property {number} r\n * The distance [km] between center of receiving body and the shadow axis.\n *\n * @property {number} k\n * The umbra radius [km] at the shadow plane.\n *\n * @property {number} p\n * The penumbra radius [km] at the shadow plane.\n *\n * @property {Vector} target\n * The location in space where we are interested in determining how close a shadow falls.\n * For example, when calculating lunar eclipses, `target` would be the center of the Moon\n * expressed in geocentric coordinates. Then we can evaluate how far the center of the Earth's\n * shadow cone approaches the center of the Moon.\n * The vector components are expressed in [au].\n *\n * @property {Vector} dir\n * The direction in space that the shadow points away from the center of a shadow-casting body.\n * This vector lies on the shadow axis and points away from the Sun.\n * In other words: the direction light from the Sun would be traveling,\n * except that the center of a body (Earth, Moon, Mercury, or Venus) is blocking it.\n * The distance units do not matter, because the vector will be normalized.\n */", "meta": { "range": [ - 270175, - 270410 + 270170, + 270405 ], "filename": "astronomy.js", "lineno": 6622, @@ -51226,8 +51226,8 @@ "comment": "", "meta": { "range": [ - 270198, - 270408 + 270193, + 270403 ], "filename": "astronomy.js", "lineno": 6623, @@ -51261,8 +51261,8 @@ "comment": "/**\n * @ignore\n *\n * @brief Represents the relative alignment of the Earth and another body, and their respective shadows.\n *\n * This is an internal data structure used to assist calculation of\n * lunar eclipses, solar eclipses, and transits of Mercury and Venus.\n *\n * Definitions:\n *\n * casting body = A body that casts a shadow of interest, possibly striking another body.\n *\n * receiving body = A body on which the shadow of another body might land.\n *\n * shadow axis = The line passing through the center of the Sun and the center of the casting body.\n *\n * shadow plane = The plane passing through the center of a receiving body,\n * and perpendicular to the shadow axis.\n *\n * @property {AstroTime} time\n * The time associated with the shadow calculation.\n *\n * @property {number} u\n * The distance [au] between the center of the casting body and the shadow plane.\n *\n * @property {number} r\n * The distance [km] between center of receiving body and the shadow axis.\n *\n * @property {number} k\n * The umbra radius [km] at the shadow plane.\n *\n * @property {number} p\n * The penumbra radius [km] at the shadow plane.\n *\n * @property {Vector} target\n * The location in space where we are interested in determining how close a shadow falls.\n * For example, when calculating lunar eclipses, `target` would be the center of the Moon\n * expressed in geocentric coordinates. Then we can evaluate how far the center of the Earth's\n * shadow cone approaches the center of the Moon.\n * The vector components are expressed in [au].\n *\n * @property {Vector} dir\n * The direction in space that the shadow points away from the center of a shadow-casting body.\n * This vector lies on the shadow axis and points away from the Sun.\n * In other words: the direction light from the Sun would be traveling,\n * except that the center of a body (Earth, Moon, Mercury, or Venus) is blocking it.\n * The distance units do not matter, because the vector will be normalized.\n */", "meta": { "range": [ - 270175, - 270410 + 270170, + 270405 ], "filename": "astronomy.js", "lineno": 6622, @@ -51365,8 +51365,8 @@ "comment": "", "meta": { "range": [ - 270251, - 270267 + 270246, + 270262 ], "filename": "astronomy.js", "lineno": 6624, @@ -51390,8 +51390,8 @@ "comment": "", "meta": { "range": [ - 270277, - 270287 + 270272, + 270282 ], "filename": "astronomy.js", "lineno": 6625, @@ -51415,8 +51415,8 @@ "comment": "", "meta": { "range": [ - 270297, - 270307 + 270292, + 270302 ], "filename": "astronomy.js", "lineno": 6626, @@ -51440,8 +51440,8 @@ "comment": "", "meta": { "range": [ - 270317, - 270327 + 270312, + 270322 ], "filename": "astronomy.js", "lineno": 6627, @@ -51465,8 +51465,8 @@ "comment": "", "meta": { "range": [ - 270337, - 270347 + 270332, + 270342 ], "filename": "astronomy.js", "lineno": 6628, @@ -51490,8 +51490,8 @@ "comment": "", "meta": { "range": [ - 270357, - 270377 + 270352, + 270372 ], "filename": "astronomy.js", "lineno": 6629, @@ -51515,8 +51515,8 @@ "comment": "", "meta": { "range": [ - 270387, - 270401 + 270382, + 270396 ], "filename": "astronomy.js", "lineno": 6630, @@ -51540,8 +51540,8 @@ "comment": "", "meta": { "range": [ - 270411, - 270994 + 270406, + 270989 ], "filename": "astronomy.js", "lineno": 6633, @@ -51578,8 +51578,8 @@ "comment": "", "meta": { "range": [ - 270478, - 270588 + 270473, + 270583 ], "filename": "astronomy.js", "lineno": 6634, @@ -51603,8 +51603,8 @@ "comment": "", "meta": { "range": [ - 270600, - 270627 + 270595, + 270622 ], "filename": "astronomy.js", "lineno": 6635, @@ -51628,8 +51628,8 @@ "comment": "", "meta": { "range": [ - 270639, - 270666 + 270634, + 270661 ], "filename": "astronomy.js", "lineno": 6636, @@ -51653,8 +51653,8 @@ "comment": "", "meta": { "range": [ - 270678, - 270705 + 270673, + 270700 ], "filename": "astronomy.js", "lineno": 6637, @@ -51678,8 +51678,8 @@ "comment": "", "meta": { "range": [ - 270717, - 270779 + 270712, + 270774 ], "filename": "astronomy.js", "lineno": 6638, @@ -51703,8 +51703,8 @@ "comment": "", "meta": { "range": [ - 270791, - 270856 + 270786, + 270851 ], "filename": "astronomy.js", "lineno": 6639, @@ -51728,8 +51728,8 @@ "comment": "", "meta": { "range": [ - 270868, - 270933 + 270863, + 270928 ], "filename": "astronomy.js", "lineno": 6640, @@ -51753,8 +51753,8 @@ "comment": "", "meta": { "range": [ - 270995, - 271156 + 270990, + 271151 ], "filename": "astronomy.js", "lineno": 6643, @@ -51783,8 +51783,8 @@ "comment": "", "meta": { "range": [ - 271034, - 271064 + 271029, + 271059 ], "filename": "astronomy.js", "lineno": 6644, @@ -51808,8 +51808,8 @@ "comment": "", "meta": { "range": [ - 271076, - 271093 + 271071, + 271088 ], "filename": "astronomy.js", "lineno": 6645, @@ -51833,8 +51833,8 @@ "comment": "", "meta": { "range": [ - 271157, - 271721 + 271152, + 271716 ], "filename": "astronomy.js", "lineno": 6648, @@ -51867,8 +51867,8 @@ "comment": "", "meta": { "range": [ - 271376, - 271406 + 271371, + 271401 ], "filename": "astronomy.js", "lineno": 6652, @@ -51892,8 +51892,8 @@ "comment": "", "meta": { "range": [ - 271440, - 271457 + 271435, + 271452 ], "filename": "astronomy.js", "lineno": 6653, @@ -51917,8 +51917,8 @@ "comment": "", "meta": { "range": [ - 271524, - 271561 + 271519, + 271556 ], "filename": "astronomy.js", "lineno": 6655, @@ -51942,8 +51942,8 @@ "comment": "", "meta": { "range": [ - 271620, - 271630 + 271615, + 271625 ], "filename": "astronomy.js", "lineno": 6657, @@ -51968,8 +51968,8 @@ "comment": "", "meta": { "range": [ - 271636, - 271646 + 271631, + 271641 ], "filename": "astronomy.js", "lineno": 6658, @@ -51994,8 +51994,8 @@ "comment": "", "meta": { "range": [ - 271652, - 271662 + 271647, + 271657 ], "filename": "astronomy.js", "lineno": 6659, @@ -52020,8 +52020,8 @@ "comment": "", "meta": { "range": [ - 271722, - 272429 + 271717, + 272424 ], "filename": "astronomy.js", "lineno": 6662, @@ -52056,8 +52056,8 @@ "comment": "", "meta": { "range": [ - 271977, - 272006 + 271972, + 272001 ], "filename": "astronomy.js", "lineno": 6666, @@ -52081,8 +52081,8 @@ "comment": "", "meta": { "range": [ - 272018, - 272048 + 272013, + 272043 ], "filename": "astronomy.js", "lineno": 6667, @@ -52106,8 +52106,8 @@ "comment": "", "meta": { "range": [ - 272082, - 272099 + 272077, + 272094 ], "filename": "astronomy.js", "lineno": 6668, @@ -52131,8 +52131,8 @@ "comment": "", "meta": { "range": [ - 272207, - 272269 + 272202, + 272264 ], "filename": "astronomy.js", "lineno": 6670, @@ -52156,8 +52156,8 @@ "comment": "", "meta": { "range": [ - 272328, - 272338 + 272323, + 272333 ], "filename": "astronomy.js", "lineno": 6672, @@ -52182,8 +52182,8 @@ "comment": "", "meta": { "range": [ - 272344, - 272354 + 272339, + 272349 ], "filename": "astronomy.js", "lineno": 6673, @@ -52208,8 +52208,8 @@ "comment": "", "meta": { "range": [ - 272360, - 272370 + 272355, + 272365 ], "filename": "astronomy.js", "lineno": 6674, @@ -52234,8 +52234,8 @@ "comment": "", "meta": { "range": [ - 272430, - 273009 + 272425, + 273004 ], "filename": "astronomy.js", "lineno": 6677, @@ -52270,8 +52270,8 @@ "comment": "", "meta": { "range": [ - 272563, - 272595 + 272558, + 272590 ], "filename": "astronomy.js", "lineno": 6679, @@ -52295,8 +52295,8 @@ "comment": "", "meta": { "range": [ - 272673, - 272709 + 272668, + 272704 ], "filename": "astronomy.js", "lineno": 6681, @@ -52320,8 +52320,8 @@ "comment": "", "meta": { "range": [ - 272785, - 272838 + 272780, + 272833 ], "filename": "astronomy.js", "lineno": 6683, @@ -52345,8 +52345,8 @@ "comment": "", "meta": { "range": [ - 272911, - 272921 + 272906, + 272916 ], "filename": "astronomy.js", "lineno": 6685, @@ -52371,8 +52371,8 @@ "comment": "", "meta": { "range": [ - 272927, - 272937 + 272922, + 272932 ], "filename": "astronomy.js", "lineno": 6686, @@ -52397,8 +52397,8 @@ "comment": "", "meta": { "range": [ - 272943, - 272953 + 272938, + 272948 ], "filename": "astronomy.js", "lineno": 6687, @@ -52423,8 +52423,8 @@ "comment": "", "meta": { "range": [ - 273010, - 273271 + 273005, + 273266 ], "filename": "astronomy.js", "lineno": 6690, @@ -52457,8 +52457,8 @@ "comment": "", "meta": { "range": [ - 273069, - 273087 + 273064, + 273082 ], "filename": "astronomy.js", "lineno": 6691, @@ -52482,8 +52482,8 @@ "comment": "", "meta": { "range": [ - 273099, - 273121 + 273094, + 273116 ], "filename": "astronomy.js", "lineno": 6692, @@ -52507,8 +52507,8 @@ "comment": "", "meta": { "range": [ - 273133, - 273155 + 273128, + 273150 ], "filename": "astronomy.js", "lineno": 6693, @@ -52532,8 +52532,8 @@ "comment": "", "meta": { "range": [ - 273167, - 273191 + 273162, + 273186 ], "filename": "astronomy.js", "lineno": 6694, @@ -52557,8 +52557,8 @@ "comment": "", "meta": { "range": [ - 273203, - 273227 + 273198, + 273222 ], "filename": "astronomy.js", "lineno": 6695, @@ -52582,8 +52582,8 @@ "comment": "", "meta": { "range": [ - 273272, - 273557 + 273267, + 273552 ], "filename": "astronomy.js", "lineno": 6698, @@ -52615,8 +52615,8 @@ "comment": "", "meta": { "range": [ - 273341, - 273359 + 273336, + 273354 ], "filename": "astronomy.js", "lineno": 6699, @@ -52640,8 +52640,8 @@ "comment": "", "meta": { "range": [ - 273371, - 273436 + 273366, + 273431 ], "filename": "astronomy.js", "lineno": 6700, @@ -52665,8 +52665,8 @@ "comment": "", "meta": { "range": [ - 273448, - 273513 + 273443, + 273508 ], "filename": "astronomy.js", "lineno": 6701, @@ -52690,8 +52690,8 @@ "comment": "", "meta": { "range": [ - 273558, - 273975 + 273553, + 273970 ], "filename": "astronomy.js", "lineno": 6704, @@ -52723,8 +52723,8 @@ "comment": "", "meta": { "range": [ - 273615, - 273628 + 273610, + 273623 ], "filename": "astronomy.js", "lineno": 6705, @@ -52748,8 +52748,8 @@ "comment": "", "meta": { "range": [ - 273702, - 273742 + 273697, + 273737 ], "filename": "astronomy.js", "lineno": 6706, @@ -52773,8 +52773,8 @@ "comment": "", "meta": { "range": [ - 273754, - 273794 + 273749, + 273789 ], "filename": "astronomy.js", "lineno": 6707, @@ -52798,8 +52798,8 @@ "comment": "", "meta": { "range": [ - 273806, - 273875 + 273801, + 273870 ], "filename": "astronomy.js", "lineno": 6708, @@ -52823,8 +52823,8 @@ "comment": "", "meta": { "range": [ - 273976, - 274389 + 273971, + 274384 ], "filename": "astronomy.js", "lineno": 6713, @@ -52856,8 +52856,8 @@ "comment": "", "meta": { "range": [ - 274032, - 274045 + 274027, + 274040 ], "filename": "astronomy.js", "lineno": 6714, @@ -52881,8 +52881,8 @@ "comment": "", "meta": { "range": [ - 274119, - 274159 + 274114, + 274154 ], "filename": "astronomy.js", "lineno": 6715, @@ -52906,8 +52906,8 @@ "comment": "", "meta": { "range": [ - 274171, - 274211 + 274166, + 274206 ], "filename": "astronomy.js", "lineno": 6716, @@ -52931,8 +52931,8 @@ "comment": "", "meta": { "range": [ - 274223, - 274291 + 274218, + 274286 ], "filename": "astronomy.js", "lineno": 6717, @@ -52956,8 +52956,8 @@ "comment": "", "meta": { "range": [ - 274390, - 274965 + 274385, + 274960 ], "filename": "astronomy.js", "lineno": 6722, @@ -52991,8 +52991,8 @@ "comment": "", "meta": { "range": [ - 274552, - 274564 + 274547, + 274559 ], "filename": "astronomy.js", "lineno": 6724, @@ -53016,8 +53016,8 @@ "comment": "", "meta": { "range": [ - 274657, - 274697 + 274652, + 274692 ], "filename": "astronomy.js", "lineno": 6725, @@ -53041,8 +53041,8 @@ "comment": "", "meta": { "range": [ - 274709, - 274749 + 274704, + 274744 ], "filename": "astronomy.js", "lineno": 6726, @@ -53066,8 +53066,8 @@ "comment": "", "meta": { "range": [ - 274761, - 274839 + 274756, + 274834 ], "filename": "astronomy.js", "lineno": 6727, @@ -53091,8 +53091,8 @@ "comment": "", "meta": { "range": [ - 274966, - 275601 + 274961, + 275596 ], "filename": "astronomy.js", "lineno": 6732, @@ -53126,8 +53126,8 @@ "comment": "", "meta": { "range": [ - 275155, - 275167 + 275150, + 275162 ], "filename": "astronomy.js", "lineno": 6735, @@ -53151,8 +53151,8 @@ "comment": "", "meta": { "range": [ - 275179, - 275219 + 275174, + 275214 ], "filename": "astronomy.js", "lineno": 6736, @@ -53176,8 +53176,8 @@ "comment": "", "meta": { "range": [ - 275231, - 275271 + 275226, + 275266 ], "filename": "astronomy.js", "lineno": 6737, @@ -53201,8 +53201,8 @@ "comment": "", "meta": { "range": [ - 275277, - 275358 + 275272, + 275353 ], "filename": "astronomy.js", "lineno": 6738, @@ -53228,8 +53228,8 @@ "comment": "", "meta": { "range": [ - 275369, - 275439 + 275364, + 275434 ], "filename": "astronomy.js", "lineno": 6741, @@ -53253,8 +53253,8 @@ "comment": "", "meta": { "range": [ - 275602, - 276306 + 275597, + 276301 ], "filename": "astronomy.js", "lineno": 6746, @@ -53289,8 +53289,8 @@ "comment": "", "meta": { "range": [ - 275799, - 275838 + 275794, + 275833 ], "filename": "astronomy.js", "lineno": 6748, @@ -53314,8 +53314,8 @@ "comment": "", "meta": { "range": [ - 275850, - 275887 + 275845, + 275882 ], "filename": "astronomy.js", "lineno": 6749, @@ -53339,8 +53339,8 @@ "comment": "", "meta": { "range": [ - 275899, - 275935 + 275894, + 275930 ], "filename": "astronomy.js", "lineno": 6750, @@ -53364,8 +53364,8 @@ "comment": "", "meta": { "range": [ - 275947, - 276028 + 275942, + 276023 ], "filename": "astronomy.js", "lineno": 6751, @@ -53389,8 +53389,8 @@ "comment": "", "meta": { "range": [ - 276040, - 276120 + 276035, + 276115 ], "filename": "astronomy.js", "lineno": 6752, @@ -53414,8 +53414,8 @@ "comment": "", "meta": { "range": [ - 276307, - 276435 + 276302, + 276430 ], "filename": "astronomy.js", "lineno": 6757, @@ -53443,8 +53443,8 @@ "comment": "", "meta": { "range": [ - 276362, - 276383 + 276357, + 276378 ], "filename": "astronomy.js", "lineno": 6758, @@ -53468,8 +53468,8 @@ "comment": "/**\n * @brief Searches for a lunar eclipse.\n *\n * This function finds the first lunar eclipse that occurs after `startTime`.\n * A lunar eclipse may be penumbral, partial, or total.\n * See {@link LunarEclipseInfo} for more information.\n * To find a series of lunar eclipses, call this function once,\n * then keep calling {@link NextLunarEclipse} as many times as desired,\n * passing in the `center` value returned from the previous call.\n *\n * @param {FlexibleDateTime} date\n * The date and time for starting the search for a lunar eclipse.\n *\n * @returns {LunarEclipseInfo}\n */", "meta": { "range": [ - 277019, - 279382 + 277014, + 279377 ], "filename": "astronomy.js", "lineno": 6776, @@ -53532,8 +53532,8 @@ "comment": "", "meta": { "range": [ - 277065, - 277084 + 277060, + 277079 ], "filename": "astronomy.js", "lineno": 6777, @@ -53557,8 +53557,8 @@ "comment": "", "meta": { "range": [ - 277164, - 277187 + 277159, + 277182 ], "filename": "astronomy.js", "lineno": 6778, @@ -53582,8 +53582,8 @@ "comment": "", "meta": { "range": [ - 277202, - 277213 + 277197, + 277208 ], "filename": "astronomy.js", "lineno": 6779, @@ -53607,8 +53607,8 @@ "comment": "", "meta": { "range": [ - 277330, - 277373 + 277325, + 277368 ], "filename": "astronomy.js", "lineno": 6781, @@ -53632,8 +53632,8 @@ "comment": "", "meta": { "range": [ - 277668, - 277717 + 277663, + 277712 ], "filename": "astronomy.js", "lineno": 6789, @@ -53657,8 +53657,8 @@ "comment": "", "meta": { "range": [ - 277964, - 277998 + 277959, + 277993 ], "filename": "astronomy.js", "lineno": 6793, @@ -53682,8 +53682,8 @@ "comment": "", "meta": { "range": [ - 278166, - 278184 + 278161, + 278179 ], "filename": "astronomy.js", "lineno": 6796, @@ -53707,8 +53707,8 @@ "comment": "", "meta": { "range": [ - 278206, - 278220 + 278201, + 278215 ], "filename": "astronomy.js", "lineno": 6797, @@ -53732,8 +53732,8 @@ "comment": "", "meta": { "range": [ - 278242, - 278258 + 278237, + 278253 ], "filename": "astronomy.js", "lineno": 6798, @@ -53757,8 +53757,8 @@ "comment": "", "meta": { "range": [ - 278280, - 278368 + 278275, + 278363 ], "filename": "astronomy.js", "lineno": 6799, @@ -53782,8 +53782,8 @@ "comment": "", "meta": { "range": [ - 278517, - 278533 + 278512, + 278528 ], "filename": "astronomy.js", "lineno": 6802, @@ -53808,8 +53808,8 @@ "comment": "", "meta": { "range": [ - 278555, - 278648 + 278550, + 278643 ], "filename": "astronomy.js", "lineno": 6803, @@ -53834,8 +53834,8 @@ "comment": "", "meta": { "range": [ - 278798, - 278812 + 278793, + 278807 ], "filename": "astronomy.js", "lineno": 6806, @@ -53860,8 +53860,8 @@ "comment": "", "meta": { "range": [ - 278838, - 278931 + 278833, + 278926 ], "filename": "astronomy.js", "lineno": 6807, @@ -53886,8 +53886,8 @@ "comment": "", "meta": { "range": [ - 279188, - 279217 + 279183, + 279212 ], "filename": "astronomy.js", "lineno": 6814, @@ -53912,8 +53912,8 @@ "comment": "", "meta": { "range": [ - 279383, - 279430 + 279378, + 279425 ], "filename": "astronomy.js", "lineno": 6819, @@ -53936,8 +53936,8 @@ "comment": "/**\n @brief Reports the time and geographic location of the peak of a solar eclipse.\n\n Returned by {@link SearchGlobalSolarEclipse} or {@link NextGlobalSolarEclipse}\n to report information about a solar eclipse event.\n\n Field `peak` holds the date and time of the peak of the eclipse, defined as\n the instant when the axis of the Moon's shadow cone passes closest to the Earth's center.\n\n The eclipse is classified as partial, annular, or total, depending on the\n maximum amount of the Sun's disc obscured, as seen at the peak location\n on the surface of the Earth.\n\n The `kind` field thus holds one of the strings `\"partial\"`, `\"annular\"`, or `\"total\"`.\n A total eclipse is when the peak observer sees the Sun completely blocked by the Moon.\n An annular eclipse is like a total eclipse, but the Moon is too far from the Earth's surface\n to completely block the Sun; instead, the Sun takes on a ring-shaped appearance.\n A partial eclipse is when the Moon blocks part of the Sun's disc, but nobody on the Earth\n observes either a total or annular eclipse.\n\n If `kind` is `\"total\"` or `\"annular\"`, the `latitude` and `longitude`\n fields give the geographic coordinates of the center of the Moon's shadow projected\n onto the daytime side of the Earth at the instant of the eclipse's peak.\n If `kind` has any other value, `latitude` and `longitude` are undefined and should\n not be used.\n\n @property {string} kind\n One of the following string values: `\"partial\"`, `\"annular\"`, `\"total\"`.\n\n @property {AstroTime} peak\n The date and time of the peak of the eclipse, defined as the instant\n when the axis of the Moon's shadow cone passes closest to the Earth's center.\n\n @property {number} distance\n The distance in kilometers between the axis of the Moon's shadow cone\n and the center of the Earth at the time indicated by `peak`.\n\n @property {number | undefined} latitude\n If `kind` holds `\"total\"`, the geographic latitude in degrees\n where the center of the Moon's shadow falls on the Earth at the\n time indicated by `peak`; otherwise, `latitude` holds `undefined`.\n\n @property {number | undefined} longitude\n If `kind` holds `\"total\"`, the geographic longitude in degrees\n where the center of the Moon's shadow falls on the Earth at the\n time indicated by `peak`; otherwise, `longitude` holds `undefined`.\n*/", "meta": { "range": [ - 281888, - 282143 + 281883, + 282138 ], "filename": "astronomy.js", "lineno": 6867, @@ -54022,8 +54022,8 @@ "comment": "", "meta": { "range": [ - 281923, - 282141 + 281918, + 282136 ], "filename": "astronomy.js", "lineno": 6868, @@ -54055,8 +54055,8 @@ "comment": "/**\n @brief Reports the time and geographic location of the peak of a solar eclipse.\n\n Returned by {@link SearchGlobalSolarEclipse} or {@link NextGlobalSolarEclipse}\n to report information about a solar eclipse event.\n\n Field `peak` holds the date and time of the peak of the eclipse, defined as\n the instant when the axis of the Moon's shadow cone passes closest to the Earth's center.\n\n The eclipse is classified as partial, annular, or total, depending on the\n maximum amount of the Sun's disc obscured, as seen at the peak location\n on the surface of the Earth.\n\n The `kind` field thus holds one of the strings `\"partial\"`, `\"annular\"`, or `\"total\"`.\n A total eclipse is when the peak observer sees the Sun completely blocked by the Moon.\n An annular eclipse is like a total eclipse, but the Moon is too far from the Earth's surface\n to completely block the Sun; instead, the Sun takes on a ring-shaped appearance.\n A partial eclipse is when the Moon blocks part of the Sun's disc, but nobody on the Earth\n observes either a total or annular eclipse.\n\n If `kind` is `\"total\"` or `\"annular\"`, the `latitude` and `longitude`\n fields give the geographic coordinates of the center of the Moon's shadow projected\n onto the daytime side of the Earth at the instant of the eclipse's peak.\n If `kind` has any other value, `latitude` and `longitude` are undefined and should\n not be used.\n\n @property {string} kind\n One of the following string values: `\"partial\"`, `\"annular\"`, `\"total\"`.\n\n @property {AstroTime} peak\n The date and time of the peak of the eclipse, defined as the instant\n when the axis of the Moon's shadow cone passes closest to the Earth's center.\n\n @property {number} distance\n The distance in kilometers between the axis of the Moon's shadow cone\n and the center of the Earth at the time indicated by `peak`.\n\n @property {number | undefined} latitude\n If `kind` holds `\"total\"`, the geographic latitude in degrees\n where the center of the Moon's shadow falls on the Earth at the\n time indicated by `peak`; otherwise, `latitude` holds `undefined`.\n\n @property {number | undefined} longitude\n If `kind` holds `\"total\"`, the geographic longitude in degrees\n where the center of the Moon's shadow falls on the Earth at the\n time indicated by `peak`; otherwise, `longitude` holds `undefined`.\n*/", "meta": { "range": [ - 281888, - 282143 + 281883, + 282138 ], "filename": "astronomy.js", "lineno": 6867, @@ -54140,8 +54140,8 @@ "comment": "", "meta": { "range": [ - 281988, - 282004 + 281983, + 281999 ], "filename": "astronomy.js", "lineno": 6869, @@ -54165,8 +54165,8 @@ "comment": "", "meta": { "range": [ - 282014, - 282030 + 282009, + 282025 ], "filename": "astronomy.js", "lineno": 6870, @@ -54190,8 +54190,8 @@ "comment": "", "meta": { "range": [ - 282040, - 282064 + 282035, + 282059 ], "filename": "astronomy.js", "lineno": 6871, @@ -54215,8 +54215,8 @@ "comment": "", "meta": { "range": [ - 282074, - 282098 + 282069, + 282093 ], "filename": "astronomy.js", "lineno": 6872, @@ -54240,8 +54240,8 @@ "comment": "", "meta": { "range": [ - 282108, - 282134 + 282103, + 282129 ], "filename": "astronomy.js", "lineno": 6873, @@ -54265,8 +54265,8 @@ "comment": "", "meta": { "range": [ - 282144, - 282199 + 282139, + 282194 ], "filename": "astronomy.js", "lineno": 6876, @@ -54289,8 +54289,8 @@ "comment": "", "meta": { "range": [ - 282201, - 282519 + 282196, + 282514 ], "filename": "astronomy.js", "lineno": 6877, @@ -54315,8 +54315,8 @@ "comment": "", "meta": { "range": [ - 282520, - 286712 + 282515, + 286707 ], "filename": "astronomy.js", "lineno": 6883, @@ -54374,8 +54374,8 @@ "comment": "", "meta": { "range": [ - 282562, - 282578 + 282557, + 282573 ], "filename": "astronomy.js", "lineno": 6884, @@ -54399,8 +54399,8 @@ "comment": "", "meta": { "range": [ - 282588, - 282606 + 282583, + 282601 ], "filename": "astronomy.js", "lineno": 6885, @@ -54424,8 +54424,8 @@ "comment": "", "meta": { "range": [ - 282616, - 282635 + 282611, + 282630 ], "filename": "astronomy.js", "lineno": 6886, @@ -54449,8 +54449,8 @@ "comment": "", "meta": { "range": [ - 282645, - 282653 + 282640, + 282648 ], "filename": "astronomy.js", "lineno": 6887, @@ -54472,8 +54472,8 @@ "comment": "", "meta": { "range": [ - 282702, - 282711 + 282697, + 282706 ], "filename": "astronomy.js", "lineno": 6888, @@ -54495,8 +54495,8 @@ "comment": "", "meta": { "range": [ - 283041, - 283076 + 283036, + 283071 ], "filename": "astronomy.js", "lineno": 6893, @@ -54520,8 +54520,8 @@ "comment": "", "meta": { "range": [ - 283088, - 283121 + 283083, + 283116 ], "filename": "astronomy.js", "lineno": 6894, @@ -54545,8 +54545,8 @@ "comment": "", "meta": { "range": [ - 283186, - 283222 + 283181, + 283217 ], "filename": "astronomy.js", "lineno": 6895, @@ -54570,8 +54570,8 @@ "comment": "", "meta": { "range": [ - 283567, - 283591 + 283562, + 283586 ], "filename": "astronomy.js", "lineno": 6900, @@ -54596,8 +54596,8 @@ "comment": "", "meta": { "range": [ - 283597, - 283621 + 283592, + 283616 ], "filename": "astronomy.js", "lineno": 6901, @@ -54622,8 +54622,8 @@ "comment": "", "meta": { "range": [ - 283627, - 283670 + 283622, + 283665 ], "filename": "astronomy.js", "lineno": 6902, @@ -54648,8 +54648,8 @@ "comment": "", "meta": { "range": [ - 283676, - 283700 + 283671, + 283695 ], "filename": "astronomy.js", "lineno": 6903, @@ -54674,8 +54674,8 @@ "comment": "", "meta": { "range": [ - 283706, - 283730 + 283701, + 283725 ], "filename": "astronomy.js", "lineno": 6904, @@ -54700,8 +54700,8 @@ "comment": "", "meta": { "range": [ - 283736, - 283779 + 283731, + 283774 ], "filename": "astronomy.js", "lineno": 6905, @@ -54726,8 +54726,8 @@ "comment": "", "meta": { "range": [ - 283939, - 283969 + 283934, + 283964 ], "filename": "astronomy.js", "lineno": 6908, @@ -54751,8 +54751,8 @@ "comment": "", "meta": { "range": [ - 283981, - 284018 + 283976, + 284013 ], "filename": "astronomy.js", "lineno": 6909, @@ -54776,8 +54776,8 @@ "comment": "", "meta": { "range": [ - 284030, - 284076 + 284025, + 284071 ], "filename": "astronomy.js", "lineno": 6910, @@ -54801,8 +54801,8 @@ "comment": "", "meta": { "range": [ - 284088, - 284135 + 284083, + 284130 ], "filename": "astronomy.js", "lineno": 6911, @@ -54826,8 +54826,8 @@ "comment": "", "meta": { "range": [ - 284147, - 284172 + 284142, + 284167 ], "filename": "astronomy.js", "lineno": 6912, @@ -54851,8 +54851,8 @@ "comment": "", "meta": { "range": [ - 284329, - 284366 + 284324, + 284361 ], "filename": "astronomy.js", "lineno": 6916, @@ -54876,8 +54876,8 @@ "comment": "", "meta": { "range": [ - 284460, - 284478 + 284455, + 284473 ], "filename": "astronomy.js", "lineno": 6918, @@ -54901,8 +54901,8 @@ "comment": "", "meta": { "range": [ - 284494, - 284512 + 284489, + 284507 ], "filename": "astronomy.js", "lineno": 6919, @@ -54926,8 +54926,8 @@ "comment": "", "meta": { "range": [ - 284528, - 284567 + 284523, + 284562 ], "filename": "astronomy.js", "lineno": 6920, @@ -54951,8 +54951,8 @@ "comment": "", "meta": { "range": [ - 284658, - 284733 + 284653, + 284728 ], "filename": "astronomy.js", "lineno": 6922, @@ -54976,8 +54976,8 @@ "comment": "", "meta": { "range": [ - 284774, - 284811 + 284769, + 284806 ], "filename": "astronomy.js", "lineno": 6924, @@ -55002,8 +55002,8 @@ "comment": "", "meta": { "range": [ - 284850, - 284899 + 284845, + 284894 ], "filename": "astronomy.js", "lineno": 6927, @@ -55028,8 +55028,8 @@ "comment": "", "meta": { "range": [ - 284991, - 285017 + 284986, + 285012 ], "filename": "astronomy.js", "lineno": 6930, @@ -55053,8 +55053,8 @@ "comment": "", "meta": { "range": [ - 285027, - 285099 + 285022, + 285094 ], "filename": "astronomy.js", "lineno": 6931, @@ -55079,8 +55079,8 @@ "comment": "", "meta": { "range": [ - 285148, - 285166 + 285143, + 285161 ], "filename": "astronomy.js", "lineno": 6933, @@ -55105,8 +55105,8 @@ "comment": "", "meta": { "range": [ - 285229, - 285247 + 285224, + 285242 ], "filename": "astronomy.js", "lineno": 6936, @@ -55131,8 +55131,8 @@ "comment": "", "meta": { "range": [ - 285515, - 285541 + 285510, + 285536 ], "filename": "astronomy.js", "lineno": 6941, @@ -55156,8 +55156,8 @@ "comment": "", "meta": { "range": [ - 285706, - 285805 + 285701, + 285800 ], "filename": "astronomy.js", "lineno": 6944, @@ -55181,8 +55181,8 @@ "comment": "", "meta": { "range": [ - 285887, - 285911 + 285882, + 285906 ], "filename": "astronomy.js", "lineno": 6946, @@ -55207,8 +55207,8 @@ "comment": "", "meta": { "range": [ - 285981, - 286003 + 285976, + 285998 ], "filename": "astronomy.js", "lineno": 6948, @@ -55233,8 +55233,8 @@ "comment": "", "meta": { "range": [ - 286013, - 286035 + 286008, + 286030 ], "filename": "astronomy.js", "lineno": 6949, @@ -55259,8 +55259,8 @@ "comment": "", "meta": { "range": [ - 286045, - 286067 + 286040, + 286062 ], "filename": "astronomy.js", "lineno": 6950, @@ -55285,8 +55285,8 @@ "comment": "", "meta": { "range": [ - 286176, - 286246 + 286171, + 286241 ], "filename": "astronomy.js", "lineno": 6952, @@ -55310,8 +55310,8 @@ "comment": "", "meta": { "range": [ - 286583, - 286621 + 286578, + 286616 ], "filename": "astronomy.js", "lineno": 6958, @@ -55336,8 +55336,8 @@ "comment": "/**\n * @brief Searches for the next lunar eclipse in a series.\n *\n * After using {@link SearchLunarEclipse} to find the first lunar eclipse\n * in a series, you can call this function to find the next consecutive lunar eclipse.\n * Pass in the `center` value from the {@link LunarEclipseInfo} returned by the\n * previous call to `SearchLunarEclipse` or `NextLunarEclipse`\n * to find the next lunar eclipse.\n *\n * @param {AstroTime} prevEclipseTime\n * A date and time near a full moon. Lunar eclipse search will start at the next full moon.\n *\n * @returns {LunarEclipseInfo}\n */", "meta": { "range": [ - 287294, - 287433 + 287289, + 287428 ], "filename": "astronomy.js", "lineno": 6976, @@ -55391,8 +55391,8 @@ "comment": "", "meta": { "range": [ - 287349, - 287388 + 287344, + 287383 ], "filename": "astronomy.js", "lineno": 6977, @@ -55416,8 +55416,8 @@ "comment": "", "meta": { "range": [ - 287434, - 287477 + 287429, + 287472 ], "filename": "astronomy.js", "lineno": 6980, @@ -55440,8 +55440,8 @@ "comment": "/**\n * @brief Searches for a solar eclipse visible anywhere on the Earth's surface.\n *\n * This function finds the first solar eclipse that occurs after `startTime`.\n * A solar eclipse may be partial, annular, or total.\n * See {@link GlobalSolarEclipseInfo} for more information.\n * To find a series of solar eclipses, call this function once,\n * then keep calling {@link NextGlobalSolarEclipse} as many times as desired,\n * passing in the `peak` value returned from the previous call.\n *\n * @param {AstroTime} startTime\n * The date and time for starting the search for a solar eclipse.\n *\n * @returns {GlobalSolarEclipseInfo}\n */", "meta": { "range": [ - 288114, - 289731 + 288109, + 289726 ], "filename": "astronomy.js", "lineno": 6996, @@ -55500,8 +55500,8 @@ "comment": "", "meta": { "range": [ - 288171, - 288190 + 288166, + 288185 ], "filename": "astronomy.js", "lineno": 6997, @@ -55525,8 +55525,8 @@ "comment": "", "meta": { "range": [ - 288366, - 288384 + 288361, + 288379 ], "filename": "astronomy.js", "lineno": 6999, @@ -55550,8 +55550,8 @@ "comment": "", "meta": { "range": [ - 288394, - 288401 + 288389, + 288396 ], "filename": "astronomy.js", "lineno": 7000, @@ -55573,8 +55573,8 @@ "comment": "", "meta": { "range": [ - 288412, - 288423 + 288407, + 288418 ], "filename": "astronomy.js", "lineno": 7001, @@ -55599,8 +55599,8 @@ "comment": "", "meta": { "range": [ - 288536, - 288580 + 288531, + 288575 ], "filename": "astronomy.js", "lineno": 7003, @@ -55624,8 +55624,8 @@ "comment": "", "meta": { "range": [ - 288763, - 288811 + 288758, + 288806 ], "filename": "astronomy.js", "lineno": 7007, @@ -55649,8 +55649,8 @@ "comment": "", "meta": { "range": [ - 289051, - 289083 + 289046, + 289078 ], "filename": "astronomy.js", "lineno": 7011, @@ -55674,8 +55674,8 @@ "comment": "", "meta": { "range": [ - 289498, - 289528 + 289493, + 289523 ], "filename": "astronomy.js", "lineno": 7019, @@ -55700,8 +55700,8 @@ "comment": "", "meta": { "range": [ - 289732, - 289791 + 289727, + 289786 ], "filename": "astronomy.js", "lineno": 7025, @@ -55724,8 +55724,8 @@ "comment": "/**\n * @brief Searches for the next global solar eclipse in a series.\n *\n * After using {@link SearchGlobalSolarEclipse} to find the first solar eclipse\n * in a series, you can call this function to find the next consecutive solar eclipse.\n * Pass in the `peak` value from the {@link GlobalSolarEclipseInfo} returned by the\n * previous call to `SearchGlobalSolarEclipse` or `NextGlobalSolarEclipse`\n * to find the next solar eclipse.\n *\n * @param {AstroTime} prevEclipseTime\n * A date and time near a new moon. Solar eclipse search will start at the next new moon.\n *\n * @returns {GlobalSolarEclipseInfo}\n */", "meta": { "range": [ - 290407, - 290560 + 290402, + 290555 ], "filename": "astronomy.js", "lineno": 7040, @@ -55779,8 +55779,8 @@ "comment": "", "meta": { "range": [ - 290468, - 290509 + 290463, + 290504 ], "filename": "astronomy.js", "lineno": 7041, @@ -55804,8 +55804,8 @@ "comment": "", "meta": { "range": [ - 290561, - 290616 + 290556, + 290611 ], "filename": "astronomy.js", "lineno": 7044, @@ -55828,8 +55828,8 @@ "comment": "/**\n * @brief Holds a time and the observed altitude of the Sun at that time.\n *\n * When reporting a solar eclipse observed at a specific location on the Earth\n * (a \"local\" solar eclipse), a series of events occur. In addition\n * to the time of each event, it is important to know the altitude of the Sun,\n * because each event may be invisible to the observer if the Sun is below\n * the horizon (i.e. it at night).\n *\n * If `altitude` is negative, the event is theoretical only; it would be\n * visible if the Earth were transparent, but the observer cannot actually see it.\n * If `altitude` is positive but less than a few degrees, visibility will be impaired by\n * atmospheric interference (sunrise or sunset conditions).\n *\n * @property {AstroTime} time\n * The date and time of the event.\n *\n * @property {number} altitude\n * The angular altitude of the center of the Sun above/below the horizon, at `time`,\n * corrected for atmospheric refraction and expressed in degrees.\n */", "meta": { "range": [ - 291615, - 291737 + 291610, + 291732 ], "filename": "astronomy.js", "lineno": 7066, @@ -55882,8 +55882,8 @@ "comment": "", "meta": { "range": [ - 291640, - 291735 + 291635, + 291730 ], "filename": "astronomy.js", "lineno": 7067, @@ -55912,8 +55912,8 @@ "comment": "/**\n * @brief Holds a time and the observed altitude of the Sun at that time.\n *\n * When reporting a solar eclipse observed at a specific location on the Earth\n * (a \"local\" solar eclipse), a series of events occur. In addition\n * to the time of each event, it is important to know the altitude of the Sun,\n * because each event may be invisible to the observer if the Sun is below\n * the horizon (i.e. it at night).\n *\n * If `altitude` is negative, the event is theoretical only; it would be\n * visible if the Earth were transparent, but the observer cannot actually see it.\n * If `altitude` is positive but less than a few degrees, visibility will be impaired by\n * atmospheric interference (sunrise or sunset conditions).\n *\n * @property {AstroTime} time\n * The date and time of the event.\n *\n * @property {number} altitude\n * The angular altitude of the center of the Sun above/below the horizon, at `time`,\n * corrected for atmospheric refraction and expressed in degrees.\n */", "meta": { "range": [ - 291615, - 291737 + 291610, + 291732 ], "filename": "astronomy.js", "lineno": 7066, @@ -55965,8 +55965,8 @@ "comment": "", "meta": { "range": [ - 291678, - 291694 + 291673, + 291689 ], "filename": "astronomy.js", "lineno": 7068, @@ -55990,8 +55990,8 @@ "comment": "", "meta": { "range": [ - 291704, - 291728 + 291699, + 291723 ], "filename": "astronomy.js", "lineno": 7069, @@ -56015,8 +56015,8 @@ "comment": "", "meta": { "range": [ - 291738, - 291773 + 291733, + 291768 ], "filename": "astronomy.js", "lineno": 7072, @@ -56039,8 +56039,8 @@ "comment": "/**\n * @brief Information about a solar eclipse as seen by an observer at a given time and geographic location.\n *\n * Returned by {@link SearchLocalSolarEclipse} or {@link NextLocalSolarEclipse}\n * to report information about a solar eclipse as seen at a given geographic location.\n *\n * When a solar eclipse is found, it is classified by setting `kind`\n * to `\"partial\"`, `\"annular\"`, or `\"total\"`.\n * A partial solar eclipse is when the Moon does not line up directly enough with the Sun\n * to completely block the Sun's light from reaching the observer.\n * An annular eclipse occurs when the Moon's disc is completely visible against the Sun\n * but the Moon is too far away to completely block the Sun's light; this leaves the\n * Sun with a ring-like appearance.\n * A total eclipse occurs when the Moon is close enough to the Earth and aligned with the\n * Sun just right to completely block all sunlight from reaching the observer.\n *\n * There are 5 \"event\" fields, each of which contains a time and a solar altitude.\n * Field `peak` holds the date and time of the center of the eclipse, when it is at its peak.\n * The fields `partial_begin` and `partial_end` are always set, and indicate when\n * the eclipse begins/ends. If the eclipse reaches totality or becomes annular,\n * `total_begin` and `total_end` indicate when the total/annular phase begins/ends.\n * When an event field is valid, the caller must also check its `altitude` field to\n * see whether the Sun is above the horizon at the time indicated by the `time` field.\n * See {@link EclipseEvent} for more information.\n *\n * @property {string} kind\n * The type of solar eclipse found: `\"partial\"`, `\"annular\"`, or `\"total\"`.\n *\n * @property {EclipseEvent} partial_begin\n * The time and Sun altitude at the beginning of the eclipse.\n *\n * @property {EclipseEvent | undefined} total_begin\n * If this is an annular or a total eclipse, the time and Sun altitude when annular/total phase begins; otherwise undefined.\n *\n * @property {EclipseEvent} peak\n * The time and Sun altitude when the eclipse reaches its peak.\n *\n * @property {EclipseEvent | undefined} total_end\n * If this is an annular or a total eclipse, the time and Sun altitude when annular/total phase ends; otherwise undefined.\n *\n * @property {EclipseEvent} partial_end\n * The time and Sun altitude at the end of the eclipse.\n */", "meta": { "range": [ - 294159, - 294490 + 294154, + 294485 ], "filename": "astronomy.js", "lineno": 7116, @@ -56135,8 +56135,8 @@ "comment": "", "meta": { "range": [ - 294193, - 294488 + 294188, + 294483 ], "filename": "astronomy.js", "lineno": 7117, @@ -56169,8 +56169,8 @@ "comment": "/**\n * @brief Information about a solar eclipse as seen by an observer at a given time and geographic location.\n *\n * Returned by {@link SearchLocalSolarEclipse} or {@link NextLocalSolarEclipse}\n * to report information about a solar eclipse as seen at a given geographic location.\n *\n * When a solar eclipse is found, it is classified by setting `kind`\n * to `\"partial\"`, `\"annular\"`, or `\"total\"`.\n * A partial solar eclipse is when the Moon does not line up directly enough with the Sun\n * to completely block the Sun's light from reaching the observer.\n * An annular eclipse occurs when the Moon's disc is completely visible against the Sun\n * but the Moon is too far away to completely block the Sun's light; this leaves the\n * Sun with a ring-like appearance.\n * A total eclipse occurs when the Moon is close enough to the Earth and aligned with the\n * Sun just right to completely block all sunlight from reaching the observer.\n *\n * There are 5 \"event\" fields, each of which contains a time and a solar altitude.\n * Field `peak` holds the date and time of the center of the eclipse, when it is at its peak.\n * The fields `partial_begin` and `partial_end` are always set, and indicate when\n * the eclipse begins/ends. If the eclipse reaches totality or becomes annular,\n * `total_begin` and `total_end` indicate when the total/annular phase begins/ends.\n * When an event field is valid, the caller must also check its `altitude` field to\n * see whether the Sun is above the horizon at the time indicated by the `time` field.\n * See {@link EclipseEvent} for more information.\n *\n * @property {string} kind\n * The type of solar eclipse found: `\"partial\"`, `\"annular\"`, or `\"total\"`.\n *\n * @property {EclipseEvent} partial_begin\n * The time and Sun altitude at the beginning of the eclipse.\n *\n * @property {EclipseEvent | undefined} total_begin\n * If this is an annular or a total eclipse, the time and Sun altitude when annular/total phase begins; otherwise undefined.\n *\n * @property {EclipseEvent} peak\n * The time and Sun altitude when the eclipse reaches its peak.\n *\n * @property {EclipseEvent | undefined} total_end\n * If this is an annular or a total eclipse, the time and Sun altitude when annular/total phase ends; otherwise undefined.\n *\n * @property {EclipseEvent} partial_end\n * The time and Sun altitude at the end of the eclipse.\n */", "meta": { "range": [ - 294159, - 294490 + 294154, + 294485 ], "filename": "astronomy.js", "lineno": 7116, @@ -56264,8 +56264,8 @@ "comment": "", "meta": { "range": [ - 294279, - 294295 + 294274, + 294290 ], "filename": "astronomy.js", "lineno": 7118, @@ -56289,8 +56289,8 @@ "comment": "", "meta": { "range": [ - 294305, - 294339 + 294300, + 294334 ], "filename": "astronomy.js", "lineno": 7119, @@ -56314,8 +56314,8 @@ "comment": "", "meta": { "range": [ - 294349, - 294379 + 294344, + 294374 ], "filename": "astronomy.js", "lineno": 7120, @@ -56339,8 +56339,8 @@ "comment": "", "meta": { "range": [ - 294389, - 294405 + 294384, + 294400 ], "filename": "astronomy.js", "lineno": 7121, @@ -56364,8 +56364,8 @@ "comment": "", "meta": { "range": [ - 294415, - 294441 + 294410, + 294436 ], "filename": "astronomy.js", "lineno": 7122, @@ -56389,8 +56389,8 @@ "comment": "", "meta": { "range": [ - 294451, - 294481 + 294446, + 294476 ], "filename": "astronomy.js", "lineno": 7123, @@ -56414,8 +56414,8 @@ "comment": "", "meta": { "range": [ - 294491, - 294544 + 294486, + 294539 ], "filename": "astronomy.js", "lineno": 7126, @@ -56438,8 +56438,8 @@ "comment": "", "meta": { "range": [ - 294546, - 294621 + 294541, + 294616 ], "filename": "astronomy.js", "lineno": 7127, @@ -56464,8 +56464,8 @@ "comment": "", "meta": { "range": [ - 294622, - 294823 + 294617, + 294818 ], "filename": "astronomy.js", "lineno": 7130, @@ -56490,8 +56490,8 @@ "comment": "", "meta": { "range": [ - 294824, - 295948 + 294819, + 295943 ], "filename": "astronomy.js", "lineno": 7135, @@ -56529,8 +56529,8 @@ "comment": "", "meta": { "range": [ - 294876, - 294896 + 294871, + 294891 ], "filename": "astronomy.js", "lineno": 7136, @@ -56554,8 +56554,8 @@ "comment": "", "meta": { "range": [ - 294908, - 294927 + 294903, + 294922 ], "filename": "astronomy.js", "lineno": 7137, @@ -56579,8 +56579,8 @@ "comment": "", "meta": { "range": [ - 294939, - 294978 + 294934, + 294973 ], "filename": "astronomy.js", "lineno": 7138, @@ -56604,8 +56604,8 @@ "comment": "", "meta": { "range": [ - 294988, - 295029 + 294983, + 295024 ], "filename": "astronomy.js", "lineno": 7139, @@ -56629,8 +56629,8 @@ "comment": "", "meta": { "range": [ - 295039, - 295080 + 295034, + 295075 ], "filename": "astronomy.js", "lineno": 7140, @@ -56654,8 +56654,8 @@ "comment": "", "meta": { "range": [ - 295092, - 295187 + 295087, + 295182 ], "filename": "astronomy.js", "lineno": 7141, @@ -56679,8 +56679,8 @@ "comment": "", "meta": { "range": [ - 295199, - 295292 + 295194, + 295287 ], "filename": "astronomy.js", "lineno": 7142, @@ -56704,8 +56704,8 @@ "comment": "", "meta": { "range": [ - 295302, - 295313 + 295297, + 295308 ], "filename": "astronomy.js", "lineno": 7143, @@ -56727,8 +56727,8 @@ "comment": "", "meta": { "range": [ - 295323, - 295332 + 295318, + 295327 ], "filename": "astronomy.js", "lineno": 7144, @@ -56750,8 +56750,8 @@ "comment": "", "meta": { "range": [ - 295342, - 295346 + 295337, + 295341 ], "filename": "astronomy.js", "lineno": 7145, @@ -56773,8 +56773,8 @@ "comment": "", "meta": { "range": [ - 295459, - 295498 + 295454, + 295493 ], "filename": "astronomy.js", "lineno": 7147, @@ -56799,8 +56799,8 @@ "comment": "", "meta": { "range": [ - 295508, - 295547 + 295503, + 295542 ], "filename": "astronomy.js", "lineno": 7148, @@ -56825,8 +56825,8 @@ "comment": "", "meta": { "range": [ - 295557, - 295648 + 295552, + 295643 ], "filename": "astronomy.js", "lineno": 7149, @@ -56851,8 +56851,8 @@ "comment": "", "meta": { "range": [ - 295658, - 295747 + 295653, + 295742 ], "filename": "astronomy.js", "lineno": 7150, @@ -56877,8 +56877,8 @@ "comment": "", "meta": { "range": [ - 295757, - 295794 + 295752, + 295789 ], "filename": "astronomy.js", "lineno": 7151, @@ -56903,8 +56903,8 @@ "comment": "", "meta": { "range": [ - 295821, - 295837 + 295816, + 295832 ], "filename": "astronomy.js", "lineno": 7154, @@ -56929,8 +56929,8 @@ "comment": "", "meta": { "range": [ - 295949, - 296311 + 295944, + 296306 ], "filename": "astronomy.js", "lineno": 7158, @@ -56963,8 +56963,8 @@ "comment": "", "meta": { "range": [ - 296022, - 296150 + 296017, + 296145 ], "filename": "astronomy.js", "lineno": 7159, @@ -56993,8 +56993,8 @@ "comment": "", "meta": { "range": [ - 296062, - 296102 + 296057, + 296097 ], "filename": "astronomy.js", "lineno": 7160, @@ -57018,8 +57018,8 @@ "comment": "", "meta": { "range": [ - 296161, - 296194 + 296156, + 296189 ], "filename": "astronomy.js", "lineno": 7163, @@ -57043,8 +57043,8 @@ "comment": "", "meta": { "range": [ - 296312, - 296445 + 296307, + 296440 ], "filename": "astronomy.js", "lineno": 7168, @@ -57073,8 +57073,8 @@ "comment": "", "meta": { "range": [ - 296359, - 296397 + 296354, + 296392 ], "filename": "astronomy.js", "lineno": 7169, @@ -57098,8 +57098,8 @@ "comment": "", "meta": { "range": [ - 296446, - 296642 + 296441, + 296637 ], "filename": "astronomy.js", "lineno": 7172, @@ -57129,8 +57129,8 @@ "comment": "", "meta": { "range": [ - 296495, - 296546 + 296490, + 296541 ], "filename": "astronomy.js", "lineno": 7173, @@ -57154,8 +57154,8 @@ "comment": "", "meta": { "range": [ - 296558, - 296614 + 296553, + 296609 ], "filename": "astronomy.js", "lineno": 7174, @@ -57179,8 +57179,8 @@ "comment": "/**\n * @brief Searches for a solar eclipse visible at a specific location on the Earth's surface.\n *\n * This function finds the first solar eclipse that occurs after `startTime`.\n * A solar eclipse may be partial, annular, or total.\n * See {@link LocalSolarEclipseInfo} for more information.\n *\n * To find a series of solar eclipses, call this function once,\n * then keep calling {@link NextLocalSolarEclipse} as many times as desired,\n * passing in the `peak` value returned from the previous call.\n *\n * IMPORTANT: An eclipse reported by this function might be partly or\n * completely invisible to the observer due to the time of day.\n * See {@link LocalSolarEclipseInfo} for more information about this topic.\n *\n * @param {AstroTime} startTime\n * The date and time for starting the search for a solar eclipse.\n *\n * @param {Observer} observer\n * The geographic location of the observer.\n *\n * @returns {LocalSolarEclipseInfo}\n */", "meta": { "range": [ - 297587, - 299295 + 297582, + 299290 ], "filename": "astronomy.js", "lineno": 7200, @@ -57249,8 +57249,8 @@ "comment": "", "meta": { "range": [ - 297683, - 297702 + 297678, + 297697 ], "filename": "astronomy.js", "lineno": 7202, @@ -57274,8 +57274,8 @@ "comment": "", "meta": { "range": [ - 297884, - 297902 + 297879, + 297897 ], "filename": "astronomy.js", "lineno": 7204, @@ -57299,8 +57299,8 @@ "comment": "", "meta": { "range": [ - 298006, - 298050 + 298001, + 298045 ], "filename": "astronomy.js", "lineno": 7207, @@ -57324,8 +57324,8 @@ "comment": "", "meta": { "range": [ - 298241, - 298289 + 298236, + 298284 ], "filename": "astronomy.js", "lineno": 7211, @@ -57349,8 +57349,8 @@ "comment": "", "meta": { "range": [ - 298524, - 298571 + 298519, + 298566 ], "filename": "astronomy.js", "lineno": 7215, @@ -57374,8 +57374,8 @@ "comment": "", "meta": { "range": [ - 298715, - 298755 + 298710, + 298750 ], "filename": "astronomy.js", "lineno": 7218, @@ -57399,8 +57399,8 @@ "comment": "", "meta": { "range": [ - 299256, - 299286 + 299251, + 299281 ], "filename": "astronomy.js", "lineno": 7227, @@ -57425,8 +57425,8 @@ "comment": "", "meta": { "range": [ - 299296, - 299353 + 299291, + 299348 ], "filename": "astronomy.js", "lineno": 7230, @@ -57449,8 +57449,8 @@ "comment": "/**\n * @brief Searches for the next local solar eclipse in a series.\n *\n * After using {@link SearchLocalSolarEclipse} to find the first solar eclipse\n * in a series, you can call this function to find the next consecutive solar eclipse.\n * Pass in the `peak` value from the {@link LocalSolarEclipseInfo} returned by the\n * previous call to `SearchLocalSolarEclipse` or `NextLocalSolarEclipse`\n * to find the next solar eclipse.\n * This function finds the first solar eclipse that occurs after `startTime`.\n * A solar eclipse may be partial, annular, or total.\n * See {@link LocalSolarEclipseInfo} for more information.\n *\n * @param {AstroTime} prevEclipseTime\n * The date and time for starting the search for a solar eclipse.\n *\n * @param {Observer} observer\n * The geographic location of the observer.\n *\n * @returns {LocalSolarEclipseInfo}\n */", "meta": { "range": [ - 300212, - 300383 + 300207, + 300378 ], "filename": "astronomy.js", "lineno": 7251, @@ -57514,8 +57514,8 @@ "comment": "", "meta": { "range": [ - 300282, - 300323 + 300277, + 300318 ], "filename": "astronomy.js", "lineno": 7252, @@ -57539,8 +57539,8 @@ "comment": "", "meta": { "range": [ - 300384, - 300437 + 300379, + 300432 ], "filename": "astronomy.js", "lineno": 7255, @@ -57563,8 +57563,8 @@ "comment": "/**\n * @brief Information about a transit of Mercury or Venus, as seen from the Earth.\n *\n * Returned by {@link SearchTransit} or {@link NextTransit} to report\n * information about a transit of Mercury or Venus.\n * A transit is when Mercury or Venus passes between the Sun and Earth so that\n * the other planet is seen in silhouette against the Sun.\n *\n * The calculations are performed from the point of view of a geocentric observer.\n *\n * @property {AstroTime} start\n * The date and time at the beginning of the transit.\n * This is the moment the planet first becomes visible against the Sun in its background.\n *\n * @property {AstroTime} peak\n * When the planet is most aligned with the Sun, as seen from the Earth.\n *\n * @property {AstroTime} finish\n * The date and time at the end of the transit.\n * This is the moment the planet is last seen against the Sun in its background.\n *\n * @property {number} separation\n * The minimum angular separation, in arcminutes, between the centers of the Sun and the planet.\n * This angle pertains to the time stored in `peak`.\n */", "meta": { "range": [ - 301548, - 301748 + 301543, + 301743 ], "filename": "astronomy.js", "lineno": 7281, @@ -57637,8 +57637,8 @@ "comment": "", "meta": { "range": [ - 301572, - 301746 + 301567, + 301741 ], "filename": "astronomy.js", "lineno": 7282, @@ -57669,8 +57669,8 @@ "comment": "/**\n * @brief Information about a transit of Mercury or Venus, as seen from the Earth.\n *\n * Returned by {@link SearchTransit} or {@link NextTransit} to report\n * information about a transit of Mercury or Venus.\n * A transit is when Mercury or Venus passes between the Sun and Earth so that\n * the other planet is seen in silhouette against the Sun.\n *\n * The calculations are performed from the point of view of a geocentric observer.\n *\n * @property {AstroTime} start\n * The date and time at the beginning of the transit.\n * This is the moment the planet first becomes visible against the Sun in its background.\n *\n * @property {AstroTime} peak\n * When the planet is most aligned with the Sun, as seen from the Earth.\n *\n * @property {AstroTime} finish\n * The date and time at the end of the transit.\n * This is the moment the planet is last seen against the Sun in its background.\n *\n * @property {number} separation\n * The minimum angular separation, in arcminutes, between the centers of the Sun and the planet.\n * This angle pertains to the time stored in `peak`.\n */", "meta": { "range": [ - 301548, - 301748 + 301543, + 301743 ], "filename": "astronomy.js", "lineno": 7281, @@ -57742,8 +57742,8 @@ "comment": "", "meta": { "range": [ - 301627, - 301645 + 301622, + 301640 ], "filename": "astronomy.js", "lineno": 7283, @@ -57767,8 +57767,8 @@ "comment": "", "meta": { "range": [ - 301655, - 301671 + 301650, + 301666 ], "filename": "astronomy.js", "lineno": 7284, @@ -57792,8 +57792,8 @@ "comment": "", "meta": { "range": [ - 301681, - 301701 + 301676, + 301696 ], "filename": "astronomy.js", "lineno": 7285, @@ -57817,8 +57817,8 @@ "comment": "", "meta": { "range": [ - 301711, - 301739 + 301706, + 301734 ], "filename": "astronomy.js", "lineno": 7286, @@ -57842,8 +57842,8 @@ "comment": "", "meta": { "range": [ - 301749, - 301782 + 301744, + 301777 ], "filename": "astronomy.js", "lineno": 7289, @@ -57866,8 +57866,8 @@ "comment": "", "meta": { "range": [ - 301784, - 301967 + 301779, + 301962 ], "filename": "astronomy.js", "lineno": 7290, @@ -57898,8 +57898,8 @@ "comment": "", "meta": { "range": [ - 301867, - 301918 + 301862, + 301913 ], "filename": "astronomy.js", "lineno": 7291, @@ -57923,8 +57923,8 @@ "comment": "", "meta": { "range": [ - 301968, - 302338 + 301963, + 302333 ], "filename": "astronomy.js", "lineno": 7294, @@ -57957,8 +57957,8 @@ "comment": "", "meta": { "range": [ - 302160, - 302252 + 302155, + 302247 ], "filename": "astronomy.js", "lineno": 7296, @@ -57982,8 +57982,8 @@ "comment": "/**\n * @brief Searches for the first transit of Mercury or Venus after a given date.\n *\n * Finds the first transit of Mercury or Venus after a specified date.\n * A transit is when an inferior planet passes between the Sun and the Earth\n * so that the silhouette of the planet is visible against the Sun in the background.\n * To continue the search, pass the `finish` time in the returned structure to\n * {@link NextTransit}.\n *\n * @param {Body} body\n * The planet whose transit is to be found. Must be `\"Mercury\"` or `\"Venus\"`.\n *\n * @param {AstroTime} startTime\n * The date and time for starting the search for a transit.\n *\n * @returns {TransitInfo}\n */", "meta": { "range": [ - 303005, - 305197 + 303000, + 305192 ], "filename": "astronomy.js", "lineno": 7318, @@ -58058,8 +58058,8 @@ "comment": "", "meta": { "range": [ - 303057, - 303078 + 303052, + 303073 ], "filename": "astronomy.js", "lineno": 7319, @@ -58083,8 +58083,8 @@ "comment": "", "meta": { "range": [ - 303151, - 303164 + 303146, + 303159 ], "filename": "astronomy.js", "lineno": 7320, @@ -58108,8 +58108,8 @@ "comment": "", "meta": { "range": [ - 303227, - 303243 + 303222, + 303238 ], "filename": "astronomy.js", "lineno": 7322, @@ -58131,8 +58131,8 @@ "comment": "", "meta": { "range": [ - 303304, - 303329 + 303299, + 303324 ], "filename": "astronomy.js", "lineno": 7325, @@ -58157,8 +58157,8 @@ "comment": "", "meta": { "range": [ - 303387, - 303412 + 303382, + 303407 ], "filename": "astronomy.js", "lineno": 7328, @@ -58183,8 +58183,8 @@ "comment": "", "meta": { "range": [ - 303507, - 303530 + 303502, + 303525 ], "filename": "astronomy.js", "lineno": 7333, @@ -58208,8 +58208,8 @@ "comment": "", "meta": { "range": [ - 303764, - 303818 + 303759, + 303813 ], "filename": "astronomy.js", "lineno": 7338, @@ -58233,8 +58233,8 @@ "comment": "", "meta": { "range": [ - 303921, - 303963 + 303916, + 303958 ], "filename": "astronomy.js", "lineno": 7340, @@ -58258,8 +58258,8 @@ "comment": "", "meta": { "range": [ - 304295, - 304350 + 304290, + 304345 ], "filename": "astronomy.js", "lineno": 7346, @@ -58283,8 +58283,8 @@ "comment": "", "meta": { "range": [ - 304541, - 304584 + 304536, + 304579 ], "filename": "astronomy.js", "lineno": 7349, @@ -58308,8 +58308,8 @@ "comment": "", "meta": { "range": [ - 304608, - 304693 + 304603, + 304688 ], "filename": "astronomy.js", "lineno": 7350, @@ -58333,8 +58333,8 @@ "comment": "", "meta": { "range": [ - 304717, - 304759 + 304712, + 304754 ], "filename": "astronomy.js", "lineno": 7351, @@ -58358,8 +58358,8 @@ "comment": "", "meta": { "range": [ - 304783, - 304868 + 304778, + 304863 ], "filename": "astronomy.js", "lineno": 7352, @@ -58383,8 +58383,8 @@ "comment": "", "meta": { "range": [ - 304892, - 304947 + 304887, + 304942 ], "filename": "astronomy.js", "lineno": 7353, @@ -58408,8 +58408,8 @@ "comment": "", "meta": { "range": [ - 305156, - 305188 + 305151, + 305183 ], "filename": "astronomy.js", "lineno": 7358, @@ -58434,8 +58434,8 @@ "comment": "", "meta": { "range": [ - 305198, - 305235 + 305193, + 305230 ], "filename": "astronomy.js", "lineno": 7361, @@ -58458,8 +58458,8 @@ "comment": "/**\n * @brief Searches for the next transit of Mercury or Venus in a series.\n *\n * After calling {@link SearchTransit} to find a transit of Mercury or Venus,\n * this function finds the next transit after that.\n * Keep calling this function as many times as you want to keep finding more transits.\n *\n * @param {Body} body\n * The planet whose transit is to be found. Must be `\"Mercury\"` or `\"Venus\"`.\n *\n * @param {AstroTime} prevTransitTime\n * A date and time near the previous transit.\n *\n * @returns {TransitInfo}\n */", "meta": { "range": [ - 305767, - 305911 + 305762, + 305906 ], "filename": "astronomy.js", "lineno": 7377, @@ -58523,8 +58523,8 @@ "comment": "", "meta": { "range": [ - 305823, - 305865 + 305818, + 305860 ], "filename": "astronomy.js", "lineno": 7378, @@ -58548,8 +58548,8 @@ "comment": "", "meta": { "range": [ - 305912, - 305945 + 305907, + 305940 ], "filename": "astronomy.js", "lineno": 7381,