Occultation Input Format - Reference View

Exact input format, accepted fields and generator parameters.

Date Scope

A DATE yyyy-mm-dd or # yyyy-mm-dd line applies to every following event until the next date line. Individual files may still use yymmdd.txt, but a selected TXT file may also use any name when date lines are present.

Required Columns

Name, RA, DEC, UT-Mitte, Duration, Exposure, Gain and ROI must be present. RA/DEC are interpreted as J2000.

Generated ROI

The TXT ROI is validated, while the generated ROI size comes from the width/height parameters.

Multi-Day File Example

DATE 2026-05-20
Name                    RA          DEC         UT-Mitte   Duration   Exposure  Gain ROI
104212                  14 36 18.08 -26 52 51.7 00:16:20   04:00      0.10      80   100x100
48022                   18 16 08.78 -31 34 45.6 03:12:24   04:00      0.20      80   200x200

DATE 2026-05-21
543 Charlotte           18 12 26.73 -29 26 19.9 07:17:05   04:00      3.00      80   640x480

Program Parameters

Input Script

--template points to the NINA source script. It is read only. The generator also writes standalone occultation blocks for direct NINA loading.

Input TXT

The protected einzeln folder below the working folder is scanned on every run and its original TXT rows are preferred. --txt-file can add another TXT file. A yymmdd.txt name supplies the date; other names are accepted when the file contains DATE yyyy-mm-dd or # yyyy-mm-dd lines.

Complete TXT

--complete-txt-file stores the merged original and Discord Text rows. Planning Ephemerides and daily NINA JSON files are generated from this saved table.

ROI Position

--field-x and --field-y define the upper-left ROI corner written directly into the Lucky container.

ROI Size

--roi-width and --roi-height define the generated capture rectangle. The default is 200 by 200 pixels.

Min Diff Time

--min-diff-time is the per-frame storage/readout delay added to the TXT exposure. The Take Video ROI exposure receives the resulting Real value. Range 0.0 to 1.0 s, default 0.5 s.

Preparation Reserve

--slew-center-minutes is the time reserved before ROI capture for LuckyImaging preparation. Range 0 to 10 minutes, default 3.

Binning

--binning accepts 1x1, 2x2, 3x3 or 4x4. Default 2x2.

Video Prep Seconds

--video-prep-seconds moves the Wait For Time before Take Video Roi Exposures ahead of capture start. Range 0 to 30 s, default 5 s.

Video ROI Margin

--video-roi-margin-percent increases the calculated frame count for Take Video Roi Exposures. Range 0 to 100%, default 10%.

Camera Minimum

--camera-min-exposure marks calculated exposure values below the configured camera minimum. Range 0.01 to 1.00 s, default 0.1 s.

Station

--station X09 selects Deep Random Survey, Rio Hurtado. Manual latitude and longitude can override the local station catalog.

MPC Ephemerides

By default the planning table queries MPC MPES perturbed ephemerides for the exact midpoint time. Disable this with --no-mpc-ephemerides.

Star Catalog

By default the planning table queries the nearest Gaia DR3 source around each TXT position and caches the result. --star-radius-arcsec range is 0 to 10 arcseconds, default 3. A radius of 0 skips Gaia lookup. Disable this with --no-star-catalog.

Star Warning

--star-distance-warning-arcsec marks V Star red when the proper-motion corrected star is farther away than this value. Range 0 to 10 arcseconds, default 2.

Diameter Estimate

--asteroid-albedo is used with MPC H to estimate asteroid diameter D and the own-diameter motion time dt. Range 0 to 1.0, default 0.15.

Current Parsed Events

DateNameRADECUT-MitteDurationExposureRealNumberGainROI
2026-05-1649712 1999 VP2915 02 44.02-18 14 07.101:42:4204:000.10.22114680200x200
2026-05-16198658 2005 BT1614 30 46.65-11 07 38.706:52:0704:000.150.2793480200x200
2026-05-16663 Gerlinde19 03 01.19-07 31 21.206:55:1805:0033.1210280200x200
2026-05-1624473 2000 UK9816 47 11.83-30 49 50.508:19:3204:000.20.3278880200x200
2026-05-16121131 1999 JE917 28 37.08-16 42 17.608:33:1004:000.20.3278880200x200
2026-05-19180775 2004 QP818 10 58.33-16 06 25.106:08:3904:000.250.3768280200x200
2026-05-20104212 2000 ER11714 36 18.08-26 52 51.700:16:2004:000.10.22114680200x200
2026-05-2048022 2001 DJ718 16 08.78-31 34 45.603:12:2404:000.20.3278880200x200
2026-05-2023070 Koussa00 26 32.00-02 47 11.610:37:1804:000.150.2793480200x200
2026-05-21543 Charlotte18 12 26.73-29 26 19.907:17:0504:0033.128180200x200
2026-05-21145549 2006 KJ12415 38 29.03-50 57 24.508:21:2404:000.10.22114680200x200
2026-05-2447635 2000 CH2517 40 48.92-17 25 59.200:33:0504:000.20.3278880200x200
2026-05-2485363 1995 WY3618 02 12.02-22 50 46.301:39:2704:000.10.22114680200x200
2026-05-2438015 1998 KX6318 07 38.57-24 40 30.802:47:4504:000.40.5248680200x200
2026-05-2417612 Whiteknight18 05 40.39-33 01 38.004:09:4004:000.50.6240880200x200
2026-05-2434857 Sutaria17 22 07.89-37 12 32.606:32:1304:000.10.22114680200x200
2026-05-251694 Kaiser15 02 42.86-29 42 01.005:24:2404:000.30.4260180200x200
2026-05-2576293 2000 EV12720 05 06.80-40 05 45.707:55:4204:000.10.22114680200x200
2026-05-258305 Teika18 37 37.25-19 19 45.308:33:0604:000.40.5248680200x200
2026-05-264578 Kurashiki17 06 17.54-16 06 52.102:41:3504:000.10.22114680200x200
2026-05-26470309 2007 JK4318 56 43.39+16 38 29.906:44:1610:0055.1212460200x200
2026-05-26298295 2003 BW1813 49 25.45-39 40 58.007:51:0304:000.250.3768280200x200
2026-05-2650000 Quaoar18 49 10.35-14 47 19.408:36:5420:0055.1224760200x200
2026-05-26186979 2004 RT25720 26 43.06-10 00 23.209:06:5604:000.10.22114680200x200
2026-05-2782603 2001 OQ9618 38 56.46-36 16 19.701:53:3304:000.10.22114680200x200
2026-05-27469442 2002 GG16619 18 07.74-30 00 56.102:52:4820:0033.1240560200x200
2026-05-2723004 Triciatalbert17 26 38.01-49 03 15.503:38:5104:000.10.22114660200x200
2026-05-275804 Bambinidipraga16 41 52.02-12 09 04.507:11:0204:000.30.4260180200x200
2026-05-27186383 2002 JX4019 48 24.71-07 30 19.810:48:4704:000.40.5248680200x200
2026-05-2754354 2000 KO3207 14 44.46+17 03 42.722:52:4704:000.10.22114680200x200
2026-05-27116 Sirona14 26 00.15-12 55 20.623:12:1804:000.80.9227560200x200
2026-05-28895 Helio14 34 17.00-35 47 22.100:10:4004:0011.1222660200x200
2026-05-28850 Altona19 25 11.33-11 55 59.704:10:5004:0011.1222660200x200
2026-05-28138504 2000 KW6218 08 25.06-13 23 48.004:35:0104:000.30.4260180200x200
2026-05-285175 Ables18 17 34.56-08 44 43.905:20:0204:000.20.3278880200x200
2026-05-28154559 2003 HL1018 46 00.83-11 31 32.507:27:4604:000.150.2793480200x200
2026-05-28179123 2001 SX25707 23 12.06+19 27 55.023:35:2504:000.10.22114660200x200
2026-05-2956509 2000 HB718 21 26.91-30 55 33.700:24:5004:000.250.3768280200x200
2026-05-29119 Althaea17 02 51.70-15 44 08.001:44:3404:000.10.22114660200x200
2026-05-2966297 1999 JF3015 03 17.46-17 47 34.905:04:1204:000.30.4260180200x200
2026-05-29248093 2004 RH6220 55 43.60-27 28 39.105:36:3804:000.10.22114680200x200
2026-05-29158531 2002 GB5218 42 19.86-27 32 00.808:32:1804:000.150.2793480200x200
2026-05-2912147 Bramante18 49 46.90-18 59 15.810:04:5004:000.150.2793480200x200
2026-05-30210809 2001 JQ918 48 59.55-34 14 44.503:03:5904:000.10.22114680200x200
2026-05-30117302 2004 VP520 00 31.80-21 46 59.305:39:3204:000.10.22114680200x200
2026-05-30256553 2007 PT412 42 05.43-10 47 04.106:37:5704:001.51.6215760200x200
2026-05-3150842 2000 FL4416 09 30.35-00 50 24.101:33:2304:000.20.3278880200x200
2026-05-31941 Murray18 47 59.81-28 56 26.905:51:1704:000.40.5248660200x200
2026-05-31163474 2002 RE21217 56 32.22+01 44 29.707:48:1204:000.30.4260180200x200
2026-05-313277 Aaronson20 21 43.48-23 44 56.508:03:0304:0011.1222680200x200
2026-05-3190529 2004 FN1918 24 40.34-22 59 34.209:14:3704:000.40.5248680200x200
2026-05-3148501 1993 FM09 07 49.25+15 46 31.623:10:0904:000.30.4260180200x200
2026-05-3168234 2001 DM3808 44 16.76+12 51 40.923:32:1504:000.20.3278880200x200
2026-09-01127097 2002 GB8417 46 52.71-13 32 33.700:40:5004:000.10.22114680200x200
2026-09-0133663 1999 JT9215 00 46.89-11 24 57.301:42:3004:000.20.3278880200x200
2026-09-019039 1990 WB400 40 57.46+18 44 07.102:34:3404:000.250.3768280200x200
2026-09-0183982 Crantor22 58 56.37-16 20 26.806:01:4710:0022.1229980200x200
2026-09-022007 JF4517 46 57.12-12 18 24.003:23:4635:000.40.52424180200x200
2026-09-0256614 2000 JQ6315 50 51.35-24 38 32.303:44:0604:000.10.22114680200x200
2026-09-02249566 3386 T-317 23 09.76-34 27 52.806:15:2904:000.150.2793480200x200
2026-09-0318336 1988 LG17 12 53.70-34 29 40.401:26:0604:000.10.22114680200x200
2026-09-0327727 1990 QM717 49 38.11-31 02 43.801:32:2804:000.20.3278880200x200
2026-09-03162786 2000 YT2101 31 23.88-15 00 48.207:49:0504:000.30.4260180200x200
2026-09-0437032 2000 UL818 47 57.41-34 25 57.700:03:2104:000.10.22114680200x200
2026-09-04225743 2001 SM3621 00 25.71-45 18 56.000:15:2604:000.10.22114680200x200
2026-09-0420183 1997 AD118 55 24.60-23 10 45.202:40:3404:0022.1212080200x200
2026-09-04124449 2001 QZ26317 20 14.51-30 25 09.823:32:1604:000.20.3278880200x200
2026-09-05261417 2005 UJ48918 20 20.11-18 40 10.102:13:2004:000.250.3768280200x200
2026-09-059723 Binyang23 53 28.65+06 48 50.508:57:2904:000.30.4260180200x200
2026-09-06177064 2003 FQ416 29 36.45-00 15 57.900:41:1004:000.20.3278880200x200
2026-09-065684 Kogo19 01 20.78-29 16 53.203:07:3604:000.250.3768280200x200
2026-09-06247018 1999 XE4818 24 45.63-43 52 33.704:31:0604:000.30.4260180200x200
2026-09-0668158 2001 BV1401 57 23.81+29 49 53.007:49:4504:000.10.22114680200x200
2026-09-07231606 2009 HN10222 53 17.45-23 04 31.904:03:0804:000.20.3278880200x200
2026-09-0731 Euphrosyne17 42 58.23-51 13 35.905:13:1410:000.30.42150180200x200
2026-09-0753300 1999 GD3119 06 40.53-21 10 14.605:27:4304:000.10.22114680200x200
2026-09-0770495 1999 TY6800 27 30.33-03 31 55.608:25:4604:000.20.3278880200x200
2026-09-07153083 2000 RH2805 28 11.73+07 42 54.109:02:1604:0011.1222680200x200
2026-09-08228413 2001 LU1717 57 13.51-36 15 40.700:30:5304:000.250.3768280200x200
2026-09-08559182 2015 BZ51815 41 12.87-22 45 25.202:07:0020:004040.123250200x200
2026-09-0919906 4138 T-317 39 43.72-43 22 24.102:57:5604:000.250.3768280200x200
2026-09-0956325 1999 VT17918 04 20.39-27 28 17.803:55:3904:0011.1222680200x200
2026-09-09248530 2005 WQ14700 39 03.28+14 54 12.209:45:3904:000.350.4753780200x200
2026-09-1056310 1999 RE15118 17 43.12-28 08 13.702:02:4504:000.60.7235180200x200
2026-09-1092915 2000 RW1321 51 14.43+00 07 23.103:10:1204:000.30.4260180200x200
2026-09-1097236 1999 XW7502 46 45.97+38 52 41.207:07:3404:000.10.22114680200x200
2026-09-10393677 2004 RO21823 21 29.34+18 23 10.607:18:5604:000.350.4753780200x200
2026-09-1021202 1994 PW1905 37 21.42+23 52 37.907:39:3704:000.250.3768280200x200