Occultation Input Format - Timeline View

Timing formulas from UT midpoint to NINA blocks.

Capture Start

capture_start = UT-Mitte - Duration / 2.

Preparation Start

prep_start = capture_start - slew_center_minutes.

Video Wait

video_wait = capture_start - video_prep_seconds.

Capture End

capture_end = UT-Mitte + Duration / 2. The Lucky Target Container has no loop-until condition. A Wait For Time at this end time is placed after Take Video Roi Exposures. After that, one normal full-frame 60 s exposure is inserted in the same outer event container.

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.

Computed Timeline

DateNamePrep UTCROI Start UTCMid UTCROI End UTCVideo Wait UTCDurationROI
2026-05-1649712 1999 VP2901:37:4201:40:4201:42:4201:44:4201:40:3704:00200x200
2026-05-16198658 2005 BT1606:47:0706:50:0706:52:0706:54:0706:50:0204:00200x200
2026-05-16663 Gerlinde06:49:4806:52:4806:55:1806:57:4806:52:4305:00200x200
2026-05-1624473 2000 UK9808:14:3208:17:3208:19:3208:21:3208:17:2704:00200x200
2026-05-16121131 1999 JE908:28:1008:31:1008:33:1008:35:1008:31:0504:00200x200
2026-05-19180775 2004 QP806:03:3906:06:3906:08:3906:10:3906:06:3404:00200x200
2026-05-20104212 2000 ER11700:11:2000:14:2000:16:2000:18:2000:14:1504:00200x200
2026-05-2048022 2001 DJ703:07:2403:10:2403:12:2403:14:2403:10:1904:00200x200
2026-05-2023070 Koussa10:32:1810:35:1810:37:1810:39:1810:35:1304:00200x200
2026-05-21543 Charlotte07:12:0507:15:0507:17:0507:19:0507:15:0004:00200x200
2026-05-21145549 2006 KJ12408:16:2408:19:2408:21:2408:23:2408:19:1904:00200x200
2026-05-2447635 2000 CH2500:28:0500:31:0500:33:0500:35:0500:31:0004:00200x200
2026-05-2485363 1995 WY3601:34:2701:37:2701:39:2701:41:2701:37:2204:00200x200
2026-05-2438015 1998 KX6302:42:4502:45:4502:47:4502:49:4502:45:4004:00200x200
2026-05-2417612 Whiteknight04:04:4004:07:4004:09:4004:11:4004:07:3504:00200x200
2026-05-2434857 Sutaria06:27:1306:30:1306:32:1306:34:1306:30:0804:00200x200
2026-05-251694 Kaiser05:19:2405:22:2405:24:2405:26:2405:22:1904:00200x200
2026-05-2576293 2000 EV12707:50:4207:53:4207:55:4207:57:4207:53:3704:00200x200
2026-05-258305 Teika08:28:0608:31:0608:33:0608:35:0608:31:0104:00200x200
2026-05-264578 Kurashiki02:36:3502:39:3502:41:3502:43:3502:39:3004:00200x200
2026-05-26470309 2007 JK4306:36:1606:39:1606:44:1606:49:1606:39:1110:00200x200
2026-05-26298295 2003 BW1807:46:0307:49:0307:51:0307:53:0307:48:5804:00200x200
2026-05-2650000 Quaoar08:23:5408:26:5408:36:5408:46:5408:26:4920:00200x200
2026-05-26186979 2004 RT25709:01:5609:04:5609:06:5609:08:5609:04:5104:00200x200
2026-05-2782603 2001 OQ9601:48:3301:51:3301:53:3301:55:3301:51:2804:00200x200
2026-05-27469442 2002 GG16602:39:4802:42:4802:52:4803:02:4802:42:4320:00200x200
2026-05-2723004 Triciatalbert03:33:5103:36:5103:38:5103:40:5103:36:4604:00200x200
2026-05-275804 Bambinidipraga07:06:0207:09:0207:11:0207:13:0207:08:5704:00200x200
2026-05-27186383 2002 JX4010:43:4710:46:4710:48:4710:50:4710:46:4204:00200x200
2026-05-2754354 2000 KO3222:47:4722:50:4722:52:4722:54:4722:50:4204:00200x200
2026-05-27116 Sirona23:07:1823:10:1823:12:1823:14:1823:10:1304:00200x200
2026-05-28895 Helio00:05:4000:08:4000:10:4000:12:4000:08:3504:00200x200
2026-05-28850 Altona04:05:5004:08:5004:10:5004:12:5004:08:4504:00200x200
2026-05-28138504 2000 KW6204:30:0104:33:0104:35:0104:37:0104:32:5604:00200x200
2026-05-285175 Ables05:15:0205:18:0205:20:0205:22:0205:17:5704:00200x200
2026-05-28154559 2003 HL1007:22:4607:25:4607:27:4607:29:4607:25:4104:00200x200
2026-05-28179123 2001 SX25723:30:2523:33:2523:35:2523:37:2523:33:2004:00200x200
2026-05-2956509 2000 HB700:19:5000:22:5000:24:5000:26:5000:22:4504:00200x200
2026-05-29119 Althaea01:39:3401:42:3401:44:3401:46:3401:42:2904:00200x200
2026-05-2966297 1999 JF3004:59:1205:02:1205:04:1205:06:1205:02:0704:00200x200
2026-05-29248093 2004 RH6205:31:3805:34:3805:36:3805:38:3805:34:3304:00200x200
2026-05-29158531 2002 GB5208:27:1808:30:1808:32:1808:34:1808:30:1304:00200x200
2026-05-2912147 Bramante09:59:5010:02:5010:04:5010:06:5010:02:4504:00200x200
2026-05-30210809 2001 JQ902:58:5903:01:5903:03:5903:05:5903:01:5404:00200x200
2026-05-30117302 2004 VP505:34:3205:37:3205:39:3205:41:3205:37:2704:00200x200
2026-05-30256553 2007 PT406:32:5706:35:5706:37:5706:39:5706:35:5204:00200x200
2026-05-3150842 2000 FL4401:28:2301:31:2301:33:2301:35:2301:31:1804:00200x200
2026-05-31941 Murray05:46:1705:49:1705:51:1705:53:1705:49:1204:00200x200
2026-05-31163474 2002 RE21207:43:1207:46:1207:48:1207:50:1207:46:0704:00200x200
2026-05-313277 Aaronson07:58:0308:01:0308:03:0308:05:0308:00:5804:00200x200
2026-05-3190529 2004 FN1909:09:3709:12:3709:14:3709:16:3709:12:3204:00200x200
2026-05-3148501 1993 FM23:05:0923:08:0923:10:0923:12:0923:08:0404:00200x200
2026-05-3168234 2001 DM3823:27:1523:30:1523:32:1523:34:1523:30:1004:00200x200