(Continued)

<table><tr><td>414-422</td><td></td><td></td><td>SDIAM projected diameter of occultation star at target</td></tr><tr><td>424-432</td><td>F9.1</td><td>deg</td><td>LONDEG Subtarget Earth longitude (East) at CA</td></tr><tr><td>434-441</td><td>F8.1</td><td>deg</td><td>LATDEG Subtarget Earth latitude at CA</td></tr><tr><td>443-450</td><td>F8.1</td><td>deg</td><td>SGT Sun-Earth-target separation at CA</td></tr><tr><td>452-460</td><td>F9.1</td><td>deg</td><td>MGT Moon-Earth-target separation at CA</td></tr><tr><td>462-469</td><td>F8.2</td><td>—</td><td>RUWE renormalized unit weight error (&lt;1.4 is good astronometric solution)</td></tr><tr><td>471-491</td><td>A21</td><td>—</td><td>_2MASS_ID 2MASS catalog ID</td></tr><tr><td>493-493</td><td>I1</td><td>—</td><td>_2MASS_DUPFLAG another nearby event with a different STARID shares this 2MASS catalog ID</td></tr><tr><td>495-503</td><td>F9.3</td><td>arcsec</td><td>_R angular separation of Gaia and 2MASS positions</td></tr><tr><td>505-505</td><td>I1</td><td>—</td><td>EAS_N_TARGETOCCS number of target occultations by candidate observatories in EAS region</td></tr><tr><td>507-507</td><td>I1</td><td>—</td><td>EAS_NoulOCCS number of ring occultations by candidate observatories in EAS region</td></tr><tr><td>509-509</td><td>I1</td><td>—</td><td>ENA_N_TARGETOCCS number of target occultations by candidate observatories in ENA region</td></tr><tr><td>511-511</td><td>I1</td><td>—</td><td>ENA_NlouOCCS number of ring occultations by candidate observatories in ENA region</td></tr><tr><td>513-513</td><td>I1</td><td>—</td><td>GEO_N_TARGETOCCS number of target occultations by candidate observatories in GEO region</td></tr><tr><td>515-515</td><td>I1</td><td>—</td><td>GEO_NlouOCCS number of ring occultations by candidate observatories in GEO region</td></tr><tr><td>517-517</td><td>I1</td><td>—</td><td>NAM_N_TARGETOCCS number of target occultations by candidate observatories in NAM region</td></tr><tr><td>519-519</td><td>I1</td><td>—</td><td>NAM_NlouOCCS number of ring occultations by candidate observatories in NAM region</td></tr><tr><td>521-521</td><td>I1</td><td>—</td><td>OCN_N_TARGETOCCS number of target occultations by candidate observatories in OCN region</td></tr><tr><td>523-523</td><td>I1</td><td>—</td><td>OCN_NlouOCCS number of ring occultations by candidate observatories in OCN region</td></tr><tr><td>525-525</td><td>I1</td><td>—</td><td>SAF_N_TARGETOCCS number of target occultations by candidate observatories in SAF region</td></tr><tr><td>527-527</td><td>I1</td><td>—</td><td>SAF_NlouOCCS number of ring occultations by candidate observatories in SAF region</td></tr><tr><td>529-529</td><td>I1</td><td>—</td><td>SAM_N_TARGETOCCS number of target occultations by candidate observatories in SAM region</td></tr><tr><td>531-531</td><td>I1</td><td>—</td><td>SAM_NlouOCCS number of ring occultations by candidate observatories in SAM region</td></tr></table>

Neptune SOM/events/Neptune/2023/Neptune_2023-05-03T13_00_52.170_20230528a.pdf N23001 2460068.0422705 2023-0 5-03

(Continued)

<table><tr><td>13:00:52.17</td><td>PgRgt</td><td>2447704782568325504</td><td>23 48 59.15652-02 29 12.98136</td></tr><tr><td>4.4</td><td>3.0</td><td>23 48 59.14834-02 29 12.68060</td><td>0.324 337.79 7.199 26.29 30.600</td></tr><tr><td>33.510-41.58-21.13</td><td>2.4-34.4</td><td>9.623 11.116 11.413 10.610 0 1.181 301.2-2.4</td><td>46.1 160.6 0.96 23485925-0229122 0 0.324 0 0 0 0 1 1 0 1 0 0 0 0 0 0</td></tr></table>

## Appendix B
Examples of Supplementary Online Material Files

For each predicted occultation, the SOM includes visual and tabular overviews of the observing circumstances. We illustrate these using the 2028 Decmeber 19 Uranus occultation.

A single PDF file for each predicted occultation includes key observational data and plotted figures showing the event geometry. Figure 16 shows the summary page for this event.<fnref n="18" /> Both the view of Earth and the sky-plane plots are included in the same SOM subdirectory. The summary page includes information about the target object and occultation star, along with other geometrical information defined in more detail below. This text is included in a separate plaintext file on the SOM.<fnref n="19" /> At lower right, a finder chart image (created using the `plot_finder_image` from the Python `astronplan` `plotspkg` package) is shown, with the event star marked by crosshairs. At the bottom of the page, a convenient summary of the observability of the occultation from all 13 observing sites is included:

1. The observing site code, name, and topocentric Earth location are shown.

2. The observability of each individual ring event and the planet limb occultations is summarized. In time order, each of the 10 Uranus rings is marked during ingress with a “+” if the ring was observable, given the usual altitude constraints.

3. The ingress and egress planet occultations are marked, followed in time order by the egress rings.<fnref n="20" /> For example, from PIC, all ingress and egress ring events were observable, but the grazing occultation chord missed the atmosphere.

4. The next column lists the complete interval over which any marked events were predicted to be observable.

5. We include a summary observed event code (OEcode) for each site, in the following format: `PXYRxy`, where `X` is set to `i` if the target planet/satellite (denoted by `P`) ingress limb event is observable, and `Y` is set to `e` if the egress limb event is observable. Similarly, `x` is set to `i` if any ingress ring events (denoted by `R`) are observable from the given site (unblocked by the planet and meeting the standard altitude criteria), and `y` is set to `e` if any egress ring events are observable. If the given events are not observable, the appropriate letters are set to `n`. In this example, the OEcodes for the PIC and KAV observations are `PnnRie` and `PnnRne`, respectively; from KAV, only the outer five rings are observable during egress. An OEcode of `PnnRnn` indicates that neither the planet nor

<footnote n="18">¹⁸ SOM/events/Uranus/2028/Uranus_2028-12-29T17_39_23.210_20230528a.pdf</footnote>

<footnote n="19">¹⁹ SOM/events/Uranus/2028/Uranus_2028-12-29T17_39_23.210_20230528a.txt</footnote>

<footnote n="20">²⁰ For some Saturn and Neptune ring occultations, the ingress and egress ring events all precede or follow the planet occultation rather than being interrupted by the planet event, but for simplicity we retain the same format for all ringed planets.</footnote>
Stellar occultation prediction by rfrench@wellesley.edu Sat Jun 24 23:36:31 2023

<table><tr><td>target</td><td>: Uranus</td></tr><tr><td>target radius (km)</td><td>: 25559.00</td></tr><tr><td>C/A epoch</td><td>: 2028-12-29T17:39:23.210</td></tr><tr><td>Event type</td><td>: PRgt</td></tr><tr><td colspan="2">: Uranus occs: not geocentric or topocentric</td></tr><tr><td colspan="2">: Ring occs: geocentric, topocentric</td></tr><tr><td>Gaia source ID</td><td>: 144910689034698368</td></tr><tr><td>2Mass ID (if available)</td><td>: 04364126+2201520</td></tr></table>

ICRS Star Coord at Epoch: 04h 36m 41.26579s +22:01:51.89082s

<table><tr><td>RUWE (&gt;1.4 is poor)</td><td>: 1.10</td></tr><tr><td>K magnitude</td><td>: 10.981</td></tr><tr><td>G magnitude</td><td>: 13.751</td></tr><tr><td>RP magnitude</td><td>: 12.920</td></tr><tr><td>BP magnitude</td><td>: 14.483</td></tr><tr><td>DUPflag</td><td>: 0</td></tr><tr><td>Distance (au)</td><td>: 18.411</td></tr><tr><td>f0 (km)</td><td>: 0.000</td></tr><tr><td>g0 (km)</td><td>: 0.000</td></tr><tr><td>skyplane vel. (km/s)</td><td>: -20.11</td></tr><tr><td>Sun-Target sep (deg)</td><td>: 152.61</td></tr><tr><td>Sun-Moon sep (deg)</td><td>: 4.11</td></tr><tr><td>B (ring opening deg)</td><td>: 79.68</td></tr><tr><td>PA of pole (deg)</td><td>: -49.74</td></tr><tr><td># a(km) ring</td><td></td></tr><tr><td>1</td><td>41837.2 6</td></tr><tr><td>2</td><td>42235.0 5</td></tr><tr><td>3</td><td>42571.2 4</td></tr><tr><td>4</td><td>44718.5 alpha</td></tr><tr><td>5</td><td>45661.1 beta</td></tr><tr><td>6</td><td>47176.1 eta</td></tr><tr><td>7</td><td>47626.3 gamma</td></tr><tr><td>8</td><td>48300.3 delta</td></tr><tr><td>9</td><td>50026.7 lambda</td></tr><tr><td>10</td><td>51149.4 epsilon</td></tr></table>

<figure><img src="image_20.png" /></figure>

2028-12-29T17:39:23.2100 c. 04 36 41.26579s +22:01:51.8911 Q.A.2.172* PA 352.14 deg v. sky 20.11 km/s D 18.41 AU
Credit: Stylized after SORA Lucky Star

<figure><img src="image_21.png" /></figure>

Observable events with sun below -5 deg and altitude above 5 deg unblocked by planet

<table><thead><tr><th>Obs</th><th>Location</th><th>lat</th><th>Elon</th><th>Rings I</th><th>Planet</th><th>Rings E</th><th>Observed Events</th><th>Interval</th><th>OEcode</th></tr></thead><tbody><tr><td>PIC</td><td>Pic du Midi</td><td>42.9</td><td>0.1</td><td>++++++</td><td></td><td>++++++</td><td>DEC 29 17:05</td><td>- DEC 29 18:18</td><td>PnnRie</td></tr><tr><td>PAL</td><td>Palomar Mt (200")</td><td>33.4</td><td>243.1</td><td>++++++</td><td></td><td>++++++</td><td>DEC 29 17:00</td><td>- DEC 29 18:10</td><td>PnnRnn</td></tr><tr><td>PMO</td><td>Purple Mtn Obs. NanKi</td><td>32.1</td><td>118.8</td><td>++++++</td><td></td><td>++++++</td><td>DEC 29 17:04</td><td>- DEC 29 18:11</td><td>PnnRie</td></tr><tr><td>KPNO</td><td>Kitt Peak Natl Obs</td><td>32.0</td><td>248.4</td><td></td><td></td><td></td><td></td><td></td><td>PnnRnn</td></tr><tr><td>MCD</td><td>McDonald Obs. 2.7m</td><td>30.7</td><td>256.0</td><td></td><td></td><td></td><td></td><td></td><td>PnnRnn</td></tr><tr><td>TEN</td><td>Teide Obs./Tenerife</td><td>28.3</td><td>343.5</td><td></td><td></td><td></td><td></td><td></td><td>PnnRnn</td></tr><tr><td>IRTF</td><td>Mauna Kea/IRTF</td><td>19.8</td><td>204.5</td><td></td><td></td><td></td><td></td><td></td><td>PnnRnn</td></tr><tr><td>KAV</td><td>Kavalur Observatory</td><td>12.6</td><td>78.8</td><td>++++++</td><td></td><td>++++++</td><td>DEC 29 17:04</td><td>- DEC 29 18:11</td><td>PnnRie</td></tr><tr><td>RIO</td><td>Rio de Janeiro</td><td>-22.9</td><td>316.8</td><td></td><td></td><td></td><td></td><td></td><td>PnnRnn</td></tr><tr><td>ESO</td><td>European Southern Obs</td><td>-29.3</td><td>289.3</td><td></td><td></td><td></td><td></td><td></td><td>PnnRnn</td></tr><tr><td>AAT</td><td>Siding Spring (AAT)</td><td>-31.3</td><td>149.1</td><td></td><td></td><td></td><td></td><td></td><td>PnnRnn</td></tr><tr><td>SAAO</td><td>So. Afr. Astro. Obs.</td><td>-32.4</td><td>20.8</td><td></td><td></td><td>++++</td><td>DEC 29 18:09</td><td>- DEC 29 18:14</td><td>PnnRne</td></tr><tr><td>MSO</td><td>Mt. Stromlo Observato</td><td>-35.3</td><td>149.0</td><td></td><td></td><td></td><td></td><td></td><td>PnnRnn</td></tr></tbody></table>

<figure><img src="image_22.png" /><figcaption>**Figure 16.** Summary page of the PDF file contained in the SOM for the 2028 December 29 Uranus occultation.</figcaption></figure>

any ring occultations were observable for the site in question, such as PAL for this example.

For each site that has an OEcode indicating that a planet/target limb and/or ring occultation is observable, we include a separate page in the SOM PDF file that provides additional detailed information about the geometric circumstances of these events. Figure 17 shows this page for the predicted PIC observations of the 2028 December 29 Uranus event. Inset figures showing the Earth from Uranus and the altitude of the target and Sun over time are included, available at full resolution in the SOM. The text shown includes details of the occultation event and included as a separate text file in the SOM.<fnref n="21" />

At the bottom of the page, we include detailed predictions for each ring event and planet limb that intersects the sky-plane chord for the occultation as observed from this site:

1. For each listed ring, we computed the ingress (I) and egress (E) predicted event times. (For Uranus, we use the full eccentric and inclined ring orbital elements for the rings, taken from French et al. 2023a; for the other planets, we assume circular and equatorial ring orbits.)

2. The UTC time of each predicted event is given, along with the altitudes of the target object and Sun at the event time, the ring plane radius probed (taking into account the orientation of the possibly inclined, eccentric ring at the observed time and accounting for general relativistic bending by the oblate planet), and the ring plane radial velocity, labeled as r-dot, negative for ingress and positive for egress.

3. If the planet occultation is observable, we include the predicted occultation time assuming the planetary shape/oblateness as specified in the kernel file *pck00010.tpc*. Our atmospheric event times do not take into account the refractive bending of the atmospheric half-light ray that typically amounts to one atmospheric scale height.

4. Ring events that are blocked by the planet are marked with a “b” under the column labeled “b?” in cases where the rings are viewed nearly edge-on and the occultation sky-plane chord intersects the rings only when in the shadow of the planet (not applicable in this instance).

5. Events for which the target altitude is less than 5° or the Sun's altitude is above -5° are marked by an “x” to indicate that they are not observable. In this example, none of the events are so marked.

<footnote n="21">²¹ SOM/events/Uranus/2022/Uranus_2028-12-29T17_39_23.210_PIC_20230528a.txt, where the event time in the file name is the geocentric C/A time.</footnote>
Uranus_2028-12-29T17_39_23.2100_PIC.txt

Occultation predictions computed by rfrench@wellesley.edu Sun Jun 11 11:15:28 2023

<table><tr><td>target</td><td>: Uranus</td></tr><tr><td>target radius (km)</td><td>: 25559.00</td></tr><tr><td>C/A epoch</td><td>: 2028-12-29T17:42:22.350</td></tr><tr><td>Event type</td><td>: PRgt</td></tr><tr><td colspan="2">: Uranus occs: not geocentric or topocentric</td></tr><tr><td colspan="2">: Ring occs: geocentric, topocentric</td></tr><tr><td>Observer code</td><td>: PIC</td></tr><tr><td>Location</td><td>: Pic du Midi</td></tr><tr><td>Latitude (deg)</td><td>: 42.93656</td></tr><tr><td>E. Longitude (deg)</td><td>: 0.14231</td></tr><tr><td>Altitude (km)</td><td>: 2.890</td></tr><tr><td>Gaia source ID</td><td>: 144910689034698368</td></tr><tr><td>2Mass ID (if available)</td><td>: 04364126+2201520</td></tr><tr><td>ICRS Star Coord at Epoch</td><td>: 04h 36m 41.26579s +22:01:51.89082s</td></tr><tr><td>RUWE (&gt;1.4 is poor)</td><td>: 1.10</td></tr><tr><td>K magnitude</td><td>: 10.981</td></tr><tr><td>G magnitude</td><td>: 13.751</td></tr><tr><td>RP magnitude</td><td>: 12.920</td></tr><tr><td>BP magnitude</td><td>: 14.483</td></tr><tr><td>DUPflag</td><td>: 0</td></tr><tr><td>Distance (au)</td><td>: 18.411</td></tr><tr><td>f0 (km)</td><td>: 0.000</td></tr><tr><td>g0 (km)</td><td>: 0.000</td></tr><tr><td>skyplane vel. (km/s)</td><td>: -20.11</td></tr><tr><td>Sun-Target sep (deg)</td><td>: 152.61</td></tr><tr><td>Sun-Moon sep (deg)</td><td>: 4.28</td></tr><tr><td>B (ring opening deg)</td><td>: 79.68</td></tr><tr><td>PA of pole (deg)</td><td>: -49.74</td></tr><tr><td>Pole direction: RA (deg)</td><td>: 257.31100</td></tr><tr><td>Dec (deg):</td><td>: -15.17500</td></tr><tr><td>C/A sky separation (")</td><td>: 1.892</td></tr><tr><td>C/A sky separation (km)</td><td>: 25264.4</td></tr><tr><td>NAIF SPICE kernels</td><td>: RAJobs_U111+rgf15.spk</td></tr><tr><td>URKALLv1.spk</td><td></td></tr><tr><td>ural11.bsp</td><td></td></tr><tr><td>IAU_URANUS_forRINGFIT.tpc</td><td></td></tr><tr><td>vgr2.ural11.bsp</td><td></td></tr><tr><td>ural161.bsp</td><td></td></tr><tr><td>vgr2.ural161.bsp</td><td></td></tr><tr><td>peph.ural160.bsp</td><td></td></tr><tr><td>earthstns_ittf93_040916.bsp</td><td></td></tr><tr><td>earth_720101_070426.bpc</td><td></td></tr><tr><td>earth_200101_990628apanet.bpc</td><td></td></tr><tr><td>pg3f0000r.bsp</td><td></td></tr><tr><td>pg490000r.bsp</td><td></td></tr><tr><td>naif0012.tls</td><td></td></tr><tr><td>earth_flatIAU.spk</td><td></td></tr></table>

b: ring blocked by planet x: target alt < 5.0 deg or sun > -5.0 deg

<table><thead><tr><th>Ring</th><th>I/E</th><th>UTC</th><th>b?</th><th>alt</th><th>alt-sun</th><th>radius</th><th>r-dot</th><th>lat-geo</th><th>lat-geodetic</th></tr></thead><tbody><tr><td>epsilon</td><td>I</td><td>2028-12-29T17:05:31.824</td><td>25.99</td><td>-5.90</td><td>51389.62</td><td>-17.72</td><td></td><td></td><td></td></tr><tr><td>lambda</td><td>I</td><td>2028-12-29T17:06:49.350</td><td>26.23</td><td>-6.11</td><td>50026.71</td><td>-17.50</td><td></td><td></td><td></td></tr><tr><td>delta</td><td>I</td><td>2028-12-29T17:08:28.626</td><td>26.53</td><td>-6.39</td><td>48300.35</td><td>-17.28</td><td></td><td></td><td></td></tr><tr><td>gamma</td><td>I</td><td>2028-12-29T17:09:07.454</td><td>26.65</td><td>-6.49</td><td>47631.37</td><td>-17.18</td><td></td><td></td><td></td></tr><tr><td>eta</td><td>I</td><td>2028-12-29T17:09:34.001</td><td>26.73</td><td>-6.57</td><td>47176.12</td><td>-17.11</td><td></td><td></td><td></td></tr><tr><td>beta</td><td>I</td><td>2028-12-29T17:11:01.963</td><td>27.00</td><td>-6.81</td><td>45680.90</td><td>-16.88</td><td></td><td></td><td></td></tr><tr><td>alpha</td><td>I</td><td>2028-12-29T17:12:00.836</td><td>27.18</td><td>-6.97</td><td>44691.87</td><td>-16.70</td><td></td><td></td><td></td></tr><tr><td>4</td><td>I</td><td>2028-12-29T17:14:12.091</td><td>27.58</td><td>-7.34</td><td>42526.42</td><td>-16.29</td><td></td><td></td><td></td></tr><tr><td>5</td><td>I</td><td>2028-12-29T17:14:34.911</td><td>27.65</td><td>-7.40</td><td>42154.90</td><td>-16.20</td><td></td><td></td><td></td></tr><tr><td>6</td><td>I</td><td>2028-12-29T17:14:57.205</td><td>27.71</td><td>-7.46</td><td>41796.03</td><td>-16.12</td><td></td><td></td><td></td></tr></tbody></table>

No planet occultations

<table><caption>**Figure 17.** Site-specific page for PIC observations from the PDF file contained in the SOM for the 2028 December 29 Uranus occultation.</caption><tr><td>6</td><td>E</td><td>2028-12-29T18:09:06.790</td><td>37.67</td><td>-16.76</td><td>41837.84</td><td>16.17</td></tr><tr><td>5</td><td>E</td><td>2028-12-29T18:09:33.131</td><td>37.76</td><td>-16.84</td><td>42260.04</td><td>16.25</td></tr><tr><td>4</td><td>E</td><td>2028-12-29T18:09:53.415</td><td>37.82</td><td>-16.90</td><td>42590.30</td><td>16.34</td></tr><tr><td>alpha</td><td>E</td><td>2028-12-29T18:12:01.024</td><td>38.21</td><td>-17.27</td><td>44708.20</td><td>16.76</td></tr><tr><td>beta</td><td>E</td><td>2028-12-29T18:12:57.331</td><td>38.38</td><td>-17.44</td><td>45657.03</td><td>16.94</td></tr><tr><td>gamma</td><td>E</td><td>2028-12-29T18:14:26.416</td><td>38.65</td><td>-17.70</td><td>47176.12</td><td>17.18</td></tr><tr><td>delta</td><td>E</td><td>2028-12-29T18:15:31.542</td><td>38.85</td><td>-17.89</td><td>48300.35</td><td>17.34</td></tr><tr><td>lambda</td><td>E</td><td>2028-12-29T18:17:10.421</td><td>39.15</td><td>-18.19</td><td>50026.71</td><td>17.57</td></tr><tr><td>epsilon</td><td>E</td><td>2028-12-29T18:18:22.799</td><td>39.38</td><td>-18.40</td><td>51304.06</td><td>17.80</td></tr></table>

<figure><img src="image_23.png" /></figure>

2028-12-29T17:39:23.2100 x: 04 36 41.26568 y: +22.01 51.891 C/A: 2.172" PA: 352.14 deg v_sky: -20.11 km/s D 18.41 AU
Credit: Stylized after SORA Lucky Star

<figure><img src="image_24.png" /></figure>
## Appendix C

### Machine-readable Tables, LaTeX Source, and Typeset Files

The complete prediction list for each target is contained in both machine-readable and typeset form. The SOM/tables/ directory contains subdirectories for each target, within which is a single machine-readable file in a form supported by the American Astronomical Society journals and detailed online.<fnref n="22" /> Also included are the LaTeX source files used to typeset the tables for each target and a PDF file containing the typeset tables. These make use of the document class aastex631.cls, provided in each target subdirectory.

## Appendix D

### Example Occultation Searches

The body of this paper contains only a small subset of the full list of predicted events contained in the SOM. As part of the SOM documentation, we provide two example programs written in Python3 that perform searches of the entire database for occultations that match requested criteria. To run these example codes, users should first download the entire SOM repository to their local machines and then navigate to the SOM/doc/ directory. Both programs are provided as Python source files (*.py) and as Jupyter notebooks (*.ipynb), with sample output files (*.out) produced by running the codes in their default configurations. The codes are intended to be illustrative only, and can be modified to conduct more sophisticated searches.

#### D.1. Example 1—Find Selected Occultations by Geographical Region

In the first example, the user specifies the following search criteria:

1. The list of targets to search.

2. The corresponding upper limits on the *K* magnitude for each target.

3. The range of dates for the search.

4. The geographical regions to search (see Table 2 in the main body of the paper).

Additional options are included that control the output of the search. In its default mode, the output file produced by the program includes the following:

1. A list of the available quantities in the Python table read from the machine-readable (MR) file for each target.

2. A summary of the requested search criteria.

3. For each occultation found, a listing of the summary text file of observing circumstances for all sites.

4. The SOM path names for the summary PDF and text files for each event.

5. A summary PDF file, which can be opened for user viewing for each identified occultation.

In its tersest mode, the default search results in the following output:

******** Contents of EventSearchExample1.out **************

Results of EventSearchExample1.py

Results of search for occultations by Jupiter between 2024-01-01 and 2030-01-01

(Continued)

K magnitude limit 5
Visible from N. Am., Eur.&N.Afr., S. Afr., S. Am., Oceania, E. Asia

2027-02-22 11:12:09.02 Pgt K = 4.926 is visible from N. Am., Oceania, E. Asia

Results of search for occultations by Saturn between 2024-01-01 and 2030-01-01

K magnitude limit 8
Visible from N. Am., Eur.&N.Afr., S. Afr., S. Am., Oceania, E. Asia

2024-08-06 17:12:21.22 PgtRgt K = 7.716 is visible from N. Am., Oceania, E. Asia

2029-07-19 00:57:19.09 PgtRgt K = 7.241 is visible from Eur.&N.Afr., S. Afr., E. Asia

Results of search for occultations by Uranus between 2024-01-01 and 2030-01-01

K magnitude limit 10.9
Visible from N. Am., Eur.&N.Afr., S. Afr., S. Am., Oceania, E. Asia

2026-07-21 02:13:50.22 PgtRgt K = 10.802 is visible from Eur.&N.Afr., S. Afr.

Results of search for occultations by Neptune between 2024-01-01 and 2030-01-01

K magnitude limit 11
Visible from N. Am., Eur.&N.Afr., S. Afr., S. Am., Oceania, E. Asia

2024-10-09 00:36:23.19 PgtRgt K = 9.068 is visible from N. Am., Eur.&N. Afr., S. Afr., S. Am.

Results of search for occultations by Titan between 2024-01-01 and 2030-01-01

K magnitude limit 7
Visible from N. Am., Eur.&N.Afr., S. Afr., S. Am., Oceania, E. Asia

2029-03-04 02:37:38.25 Pt K = 6.151 is visible from N. Am.

Results of search for occultations by Triton between 2024-01-01 and 2030-01-01

K magnitude limit 15
Visible from N. Am., Eur.&N.Afr., S. Afr., S. Am., Oceania, E. Asia

2029-06-11 05:23:26.00 Pt K = 10.259 is visible from Eur.&N.Afr.

#### D.2. Example 2—Find Selected Occultations by Observing Site

In the second example, the user specifies the following search criteria:

1. The list of targets to search.

2. The corresponding upper limits on the *K* magnitude for each target.

3. The range of dates for the search.

4. Specific observing sites for the search (see Table 2 in the main body of the paper).

Additional options are included that control the output of the search. In its default mode, the output file produced by the program includes the following:

<footnote n="22">²² https://journals.aas.org/mrt-overview/</footnote>
1. A list of the available quantities in the Python table read from the machine-readable (MR) file for each target.

2. A summary of the requested search criteria.

3. For each occultation found, a listing of the summary text file of observing circumstances for all sites.

4. The SOM path names for the summary PDF and text files for each event.

5. The SOM path names for the individual event summary text files for each observing site.

6. The summary PDF file, which can be opened for user viewing for each identified occultation.

In its tersest mode, the default search results in the following output:

********* Contents of EventSearchExample2.out **************

Results of EventSearchExample2.py

Results of search for occultations by Jupiter between 2024-01-01 and 2030-01-01

K magnitude limit 5

Visible from IRTF, TEN, KPNO

2027-02-22 11:12:09.02 Pgt K = 4.926 is visible from IRTF, KPNO

Results of search for occultations by Saturn between 2024-01-01 and 2030-01-01

K magnitude limit 8

Visible from IRTF, TEN, KPNO

2024-08-06 17:12:21.22 PgtRgt K = 7.716 is visible from IRTF

2029-07-19 00:57:19.09 PgtRgt K = 7.241 is visible from TEN

Results of search for occultations by Uranus between 2024-01-01 and 2030-01-01

K magnitude limit 10.9

Visible from IRTF, TEN, KPNO

No events found with requested conditions

Results of search for occultations by Neptune between 2024-01-01 and 2030-01-01

K magnitude limit 11

Visible from IRTF, TEN, KPNO

2024-10-09 00:36:23.19 PgtRgt K = 9.068 is visible from KPNO, TEN

Results of search for occultations by Titan between 2024-01-01 and 2030-01-01

K magnitude limit 7

Visible from IRTF, TEN, KPNO

2029-03-04 02:37:38.25 Pt K = 6.151 is visible from KPNO

Results of search for occultations by Triton between 2024-01-01 and 2030-01-01

K magnitude limit 15

Visible from IRTF, TEN, KPNO

2029-06-11 05:23:26.00 Pt K = 10.259 is visible from TEN

ORCID iDs

Richard G. French https://orcid.org/0000-0002-9858-9532

Damya Souami https://orcid.org/0000-0003-4058-0815

References

Acton, C. H. 1996, P&SS, 44, 65

Baron, R. L., French, R. G., & Elliot, J. L. 1989, Icar, 78, 119

Baum, W. A., & Code, A. D. 1953, AJ, 58, 108

Bérard, D., Sicardy, B., Camargo, J. I. B., et al. 2017, AJ, 154, 144

Bertrand, T., Lellouch, E., Holler, B. J., et al. 2022, Icar, 373, 114764

Bhattacharyya, J. C., & Bappu, M. K. V. 1977, Natur, 270, 503

Blanc, M., Mandt, K., Mousis, O., et al. 2021, SSRv, 217, 3

Bosh, A. S., & McDonald, S. W. 1992, AJ, 103, 983

Braga-Ribas, F., Sicardy, B., Ortiz, J. L., et al. 2014, Natur, 508, 72

Brahic, A. 1977, Rech, 8, 569

Buie, M. W., Porter, S. B., Tamblyn, P., et al. 2020, AJ, 159, 130

Buie, M., Keeney, B., Levison, H., Olkin, C. & Lucy Occultations Team 2022, AAS/DPS Meeting, 54, 512.03

Butkevich, A. G., & Lindegren, L. 2014, A&A, 570, A62

Cantat-Gaudin, T., & Brandt, T. D. 2021, A&A, 649, A124

Cartwright, R. J., Beddingfield, C. B., Nordheim, T. A., et al. 2021, PSJ, 2, 120

Chen, D.-H., Yant, H.-Y., Wu, C.-H., et al. 1978, SciSn, 21, 503

Christou, A. A., Beisker, W., Casas, R., et al. 2013, A&A, 556, A118

Coustenis, A., Lellouch, E., Sicardy, B., & Roe, H. 2010, in Titan from Cassini-Huygens, ed. R. H. Brown, J.-P. Lebreton, & J. H. Waite (Dordrecht: Springer), 9

Cutri, R. M., Skrutskie, M. F., van Dyk, S., et al. 2003, Explanatory Supplement to the 2MASS All Sky Data Release and Extended Mission Products (Washington, DC: NASA), http://www.ipac.caltech.edu/2mass/releases/allsky/doc/explsup.html

De Pater, I., Hamilton, D. P., Showalter, M. R., Throop, H. B., & Burns, J. A. 2018a, in Planetary Ring Systems. Properties, Structure, and Evolution, ed. M. S. Tiscareno & C. D. Murray (Cambridge: Cambridge Univ. Press), 125

De Pater, I., Renner, S., Showalter, M. R., & Sicardy, B. 2018b, in Planetary Ring Systems. Properties, Structure, and Evolution, ed. M. S. Tiscareno & C. D. Murray (Cambridge: Cambridge Univ. Press), 112

Dunham, D. W., Preston, S., Herald, D., et al. 2021, JOA, 11, 24

Elliot, J. L. 1979, ARA&A, 17, 445

Elliot, J. L., Dunham, E., & Mink, D. 1977, Natur, 267, 328

Elliot, J. L., Dunham, E. W., Bosh, A. S., et al. 1989, Icar, 77, 148

Elliot, J. L., Bosh, A. S., Cooke, M. L., et al. 1993, AJ, 106, 2544

Elliot, J. L., & Olkin, C. B. 1996, AREPS, 24, 89

Elliot, J. L., Hammel, H. B., Wasserman, L. H., et al. 1998, Natur, 393, 765

Elliot, J. L., Person, M. J., McDonald, S. W., et al. 2000, Icar, 148, 347

Fernández-Valenzuela, E., Morales, N., Vara-Lubiano, M., et al. 2023, A&A, 669, 112

Fletcher, L. N., Helled, R., Roussos, E., et al. 2020, P&SS, 191, 105030

French, R. G., Nicholson, P. D., Cooke, M. L., et al. 1993, Icar, 103, 163

French, R. G., McGhee, C. A., & Sicardy, B. 1998, Icar, 136, 27

French, R. G., et al. 2017, Icar, 290, 14

French, R. G., Hedman, M. M., Nicholson, P. D., Longaretti, P.-Y., & McGhee-French, C. A. 2023a, Icar, submitted

French, R. G., McGhee-French, C. A., Gordon, M., et al. 2023b, Icar, 395, 115474

Gaia Collaboration 2022, yCat, 1335, 0

Gaia Collaboration, et al. 2021, A&A, 649, 9

Gaslac Gallardo, D. M., Giuliatti Winter, S. M., Madeira, G., & Muñoz-Gutiérrez, M. A. 2020, Ap&SS, 365, 5

Gomes-Júnior, A. R., Morgado, B. E., Benedetti-Rossi, G., et al. 2022, MNRAS, 511, 1167

Harrington, J., French, R. G., & Matcheva, K. 2010, ApJ, 716, 404

Hofstadter, M., Simon, A., Atreya, S., et al. 2019, P&SS, 117, 104680

Hubbard, W., Nather, R. E., Evans, D. S., et al. 1972, AJ, 77, 41

Hubbard, W. B., Coyne, G. V., Gehrels, T., Smith, B. A., & Zellner, B. H. 1977, Natur, 268, 33

Hubbard, W. B., Brahic, A., & Sicardy, B. 1986, Natur, 319, 636

Hubbard, W. B., Haemmerle, V., Porco, C. C., Rieke, G. H., & Rieke, M. J. 1995, Icar, 113, 103

Hubbard, W. B., Porco, C. C., Hunten, D. M., et al. 1997, Icar, 130, 404

Klemola, A. R., & Marsden, B. G. 1977, AJ, 82, 849
Klemola, A. R., & Mink, D. J. 1991, AJ, 102, 389

Klemola, A. R., Mink, D. J., & Elliot, J. L. 1981, AJ, 86, 138

Kovalevsky, J., & Link, F. 1969, A&A, 2, 398

Levine, S. E., Zuluaga, C. A., & Person, M. J. 2021, AJ, 161, 210

Marques Oliveira, J., Sicardy, B., Gomes-Júnior, A. R., et al. 2022, A&A, 659, 136

Millis, R. L., Wasserman, L. H., & Birch, P. V. 1977, Natur, 267, 330

Mink, D. J. 1995, BAAS, 27, 1197

Mink, D. J., & Klemola, A. 1985, AJ, 90, 1894

Mink, D. J., Maene, S., French, R. G., & Klemola, A. R. 1992, Icar, 99, 430

Morgado, B. E., Sicardy, B., Braga-Ribas, F., et al. 2021, A&A, 652, 141

Morgado, B. E., Bruno, G., Gomes-Júnior, A. R., et al. 2022, A&A, 664, L15

Morgado, B. E., Sicardy, B., Braga-Ribas, F., et al. 2023, Natur, 614, 239

Morrisby, A. G. F., Vincent, J. V., & Hilton, A. S. 1977, MNSSJ, 36, 53

National Academies of Sciences, Engineering, and Medicine 2022, Origins, Worlds, and Life: A Decadal Strategy for Planetary Science and Astrobiology 2023–2032 (Washington, DC: The National Academies Press)

Nicholson, P. D., McLeod, B. A., Gilmore, G., Buie, M. W., & Matthews, K. 1988, AJ, 95, 562

Nicholson, P. D., McGhee, C. A., & French, R. G. 1995, Icar, 113, 57

Nicholson, P. D., French, R. G., Tollestrup, E., et al. 2000, Icar, 145, 474

Nicholson, P. D., De Pater, I., French, R. G., & Showalter, M. R. 2018, in Planetary Ring Systems. Properties, Structure, and Evolution, ed. M. S. Tiscareno & C. D. Murray (Cambridge: Cambridge Univ. Press), 93

Ochsenbein, F., Bauer, P., & Marcout, J. 2000, A&AS, 143, 23

Olkin, C. B., Elliot, J. L., Hammel, H. B., et al. 1997, Icar, 129, 178

Ortiz, J. L., Santos-Sanz, P., Sicardy, B., et al. 2017, Natur, 550, 219

Pereira, C. L., Sicardy, B., Morgado, B. E., et al. 2023, A&A, 673, L4

Person, M. J., Elliot, J. L., Gulbis, A. A. S., et al. 2008, AJ, 136, 1510

Person, M. J., Schindler, K., Bosh, A. S., et al. 2018, AAS/DPS Meeting, 50, 416.10

Person, M. J., Bosh, A. S., Zuluaga, C. A., et al. 2021, Icar, 356, 113572

Raynaud, E., Drossard, P., Matcheva, K., et al. 2003, Icar, 162, 344

Raynaud, E., Matcheva, K., Drossart, P., Roques, F., & Sicardy, B. 2004, Icar, 168, 324

Röser, S., & Bastian, U. 1988, A&AS, 74, 449

1991, in PPM Star Catalogue. Positions and Proper Motions of 181731 Stars North of −2.5 degrees Declination for Equinox and Epoch J2000.0. Vol. I: Zones +80° to +30°. Vol. II: Zones +20° to −0°. PPM Star Catalogue. Positions and Proper Motions of 181731 Stars North of −2.5 degrees Declination for Equinox and Epoch J2000.0. Vol. I: Zones +80° to +30°. Vol. II: Zones +20° to −0°, S., Röser, & U., Bastian (ed.) (Heidelberg: Spektrum, Akademischer Verlag)

Röser, S., & Bastian, U. 1993, in PPM Star Catalogue South. Positions and Proper Motions of 197179 Stars South of −2.5 degrees Declination for Equinox and Epoch J2000.0. Vol. III: Zones −00 deg. to −20 deg.; Vol. IV: Zones −30 deg. to −80 deg. ed. U. Bastian & S. Röser (Heidelberg: Spektrum, Akademischer Verlag)

Roques, F., Sicardy, B., French, R. G., et al. 1994, A&A, 288, 985

Ruprecht, J. D., Bosh, A. S., Person, M. J., et al. 2015, Icar, 252, 271

Santos-Sanz, P., Ortiz, J. L., Sicardy, B., et al. 2022a, A&A, 664, A130

Santos-Sanz, P., et al. 2022b, in First Science Results from JWST Conf. (Baltimore, MD: STScI)

Saunders, W. R., Person, M. J., Withers, P., et al. 2022, P&SS, 213, 105431

Sicardy, B., Combes, M., Lecacheux, J., et al. 1985, Icar, 64, 88

Sicardy, B., Roques, F., & Brahic, A. 1986, Natur, 320, 729

Sicardy, B., Roques, F., & Brahic, A. 1991, Icar, 89, 220

Sicardy, B., Ferri, F., Roques, F., et al. 1999, Icar, 142, 357

Sicardy, B., Colas, F., Widemann, T., et al. 2006, JGRE, 111, E11S91

Sickafoose, A. A., Bosh, A. S., Emery, J. P., et al. 2020, MNRAS, 491, 3643

Skrutskie, M. F., Cutri, R. M., Steining, R., et al. 2006, AJ, 131, 1163

Smith, B. A., Soderblom, L. A., Banfield, D., et al. 1989, Sci, 246, 1422

Souami, D., Braga-Ribas, F., Sicardy, B., et al. 2020, A&A, 643, A125

Souami, D., Sicardy, B., Renner, S., & Langlois, M. 2022, EPSC, 16, EPSC2022-1263

Taylor, G. E. 1987, IAU Commission Working Group on the Prediction of Occultations by Satellites and Minor Planets. Bull. 30

Tomita, K. 1977, TokAB, 250, 2885

Tyler, G. L., Sweetnam, D. N., Anderson, J. D., et al. 1989, Sci, 246, 1466

Uckert, K., Chanover, N. J., Olkin, C. B., et al. 2014, Icar, 232, 22

Vapillon, L., Combes, M., & Lecacheux, J. 1973, A&A, 29, 135

Veverka, J., Wasserman, L. H., Elliot, J., Sagan, C., & Liller, W. 1974, AJ, 79, 73

Wang, B., Yian, J., Gao, W., et al. 2023, A&A, 671, A70

Young, L. A., Bosh, A. S., Buie, M., Elliot, J. L., & Wasserman, L. H. 2001, Icar, 153, 236

Young, L., Buie, M., Keeney, B., et al. 2022, AAS/DPS Meeting, 54, 307.03

Yuan, Y., Fu, Y.-N., & Cheng, Z. 2017, RAA, 17, 45