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.644080200x200
2026-05-16198658 2005 BT1614 30 46.65-11 07 38.706:52:0704:000.150.6540780200x200
2026-05-16663 Gerlinde19 03 01.19-07 31 21.206:55:1805:0033.59580200x200
2026-05-1624473 2000 UK9816 47 11.83-30 49 50.508:19:3204:000.20.737880200x200
2026-05-16121131 1999 JE917 28 37.08-16 42 17.608:33:1004:000.20.737880200x200
2026-05-19180775 2004 QP818 10 58.33-16 06 25.106:08:3904:000.250.7535280200x200
2026-05-20104212 2000 ER11714 36 18.08-26 52 51.700:16:2004:000.10.644080200x200
2026-05-2048022 2001 DJ718 16 08.78-31 34 45.603:12:2404:000.20.737880200x200
2026-05-2023070 Koussa00 26 32.00-02 47 11.610:37:1804:000.150.6540780200x200
2026-05-21543 Charlotte18 12 26.73-29 26 19.907:17:0504:0033.57680200x200
2026-05-21145549 2006 KJ12415 38 29.03-50 57 24.508:21:2404:000.10.644080200x200
2026-05-2447635 2000 CH2517 40 48.92-17 25 59.200:33:0504:000.20.737880200x200
2026-05-2485363 1995 WY3618 02 12.02-22 50 46.301:39:2704:000.10.644080200x200
2026-05-2438015 1998 KX6318 07 38.57-24 40 30.802:47:4504:000.40.929480200x200
2026-05-2417612 Whiteknight18 05 40.39-33 01 38.004:09:4004:000.5126480200x200
2026-05-2434857 Sutaria17 22 07.89-37 12 32.606:32:1304:000.10.644080200x200
2026-05-251694 Kaiser15 02 42.86-29 42 01.005:24:2404:000.30.833080200x200
2026-05-2576293 2000 EV12720 05 06.80-40 05 45.707:55:4204:000.10.644080200x200
2026-05-258305 Teika18 37 37.25-19 19 45.308:33:0604:000.40.929480200x200
2026-05-264578 Kurashiki17 06 17.54-16 06 52.102:41:3504:000.10.644080200x200
2026-05-26470309 2007 JK4318 56 43.39+16 38 29.906:44:1610:0055.512160200x200
2026-05-26298295 2003 BW1813 49 25.45-39 40 58.007:51:0304:000.250.7535280200x200
2026-05-2650000 Quaoar18 49 10.35-14 47 19.408:36:5420:0055.524160200x200
2026-05-26186979 2004 RT25720 26 43.06-10 00 23.209:06:5604:000.10.644080200x200
2026-05-2782603 2001 OQ9618 38 56.46-36 16 19.701:53:3304:000.10.644080200x200
2026-05-27469442 2002 GG16619 18 07.74-30 00 56.102:52:4820:0033.537860200x200
2026-05-2723004 Triciatalbert17 26 38.01-49 03 15.503:38:5104:000.10.644060200x200
2026-05-275804 Bambinidipraga16 41 52.02-12 09 04.507:11:0204:000.30.833080200x200
2026-05-27186383 2002 JX4019 48 24.71-07 30 19.810:48:4704:000.40.929480200x200
2026-05-2754354 2000 KO3207 14 44.46+17 03 42.722:52:4704:000.10.644080200x200
2026-05-27116 Sirona14 26 00.15-12 55 20.623:12:1804:000.81.320460200x200
2026-05-28895 Helio14 34 17.00-35 47 22.100:10:4004:0011.517660200x200
2026-05-28850 Altona19 25 11.33-11 55 59.704:10:5004:0011.517660200x200
2026-05-28138504 2000 KW6218 08 25.06-13 23 48.004:35:0104:000.30.833080200x200
2026-05-285175 Ables18 17 34.56-08 44 43.905:20:0204:000.20.737880200x200
2026-05-28154559 2003 HL1018 46 00.83-11 31 32.507:27:4604:000.150.6540780200x200
2026-05-28179123 2001 SX25707 23 12.06+19 27 55.023:35:2504:000.10.644060200x200
2026-05-2956509 2000 HB718 21 26.91-30 55 33.700:24:5004:000.250.7535280200x200
2026-05-29119 Althaea17 02 51.70-15 44 08.001:44:3404:000.10.644060200x200
2026-05-2966297 1999 JF3015 03 17.46-17 47 34.905:04:1204:000.30.833080200x200
2026-05-29248093 2004 RH6220 55 43.60-27 28 39.105:36:3804:000.10.644080200x200
2026-05-29158531 2002 GB5218 42 19.86-27 32 00.808:32:1804:000.150.6540780200x200
2026-05-2912147 Bramante18 49 46.90-18 59 15.810:04:5004:000.150.6540780200x200
2026-05-30210809 2001 JQ918 48 59.55-34 14 44.503:03:5904:000.10.644080200x200
2026-05-30117302 2004 VP520 00 31.80-21 46 59.305:39:3204:000.10.644080200x200
2026-05-30256553 2007 PT412 42 05.43-10 47 04.106:37:5704:001.5213260200x200
2026-05-3150842 2000 FL4416 09 30.35-00 50 24.101:33:2304:000.20.737880200x200
2026-05-31941 Murray18 47 59.81-28 56 26.905:51:1704:000.40.929460200x200
2026-05-31163474 2002 RE21217 56 32.22+01 44 29.707:48:1204:000.30.833080200x200
2026-05-313277 Aaronson20 21 43.48-23 44 56.508:03:0304:0011.517680200x200
2026-05-3190529 2004 FN1918 24 40.34-22 59 34.209:14:3704:000.40.929480200x200
2026-05-3148501 1993 FM09 07 49.25+15 46 31.623:10:0904:000.30.833080200x200
2026-05-3168234 2001 DM3808 44 16.76+12 51 40.923:32:1504:000.20.737880200x200