Occultation Input Format - Operator View

Operator Checks

Beobachterprüfung

This page gathers camera and preparation parameters alongside the candidate list. It supports a last technical plausibility check; it does not connect equipment or run the sequence.

Diese Seite stellt Kamera- und Vorbereitungsparameter neben die Kandidatenliste. Sie unterstützt die letzte technische Plausibilitätsprüfung; sie verbindet keine Geräte und startet kein Skript.

Compare ROI position and dimensions, binning, exposure and frame count with the actual camera. Check the selected station and target coordinates separately. An available catalog match is not a verification of the telescope pointing.

Vergleiche ROI-Position und Abmessungen, Binning, Belichtung und Bildzahl mit der tatsächlichen Kamera. Prüfe Station und Zielkoordinaten getrennt. Ein vorhandener Katalogtreffer bestätigt nicht die Teleskopausrichtung.

Only a current-night, checked file should be loaded for observing. The Help distinguishes the immutable template, the nightly output and the TimeCheck-corrected file.

Für die Beobachtung sollte nur eine geprüfte Datei der richtigen Nacht geladen werden. Die Hilfe unterscheidet unveränderte Vorlage, Nachtausgabe und TimeCheck-korrigierte Datei.

Operator workflow and generated NINA sequence behavior.

Beobachtungsablauf und Verhalten der erzeugten NINA-Sequenzen.

Before Run

Select the working folder, optionally select one TXT file, confirm the source NINA template and the Lucky container template.

Arbeitsordner, optional eine TXT-Datei, saubere NINA-Vorlage und Lucky-Container-Vorlage bilden die Eingabeauswahl.

Generated Blocks

Each event gets an outer sequential container. Inside it, the Lucky Target Container uses the configured ROI X/Y directly, waits until capture start minus the configured video prep seconds, runs Take Video Roi Exposures with the planned frame count, waits at capture end, then a 60 s full-frame localization exposure runs below the Lucky container.

Jedes Ereignis erhält ein äußeres Zeitfenster. Darin verwendet der Lucky-Container ROI X/Y direkt, wartet bis Aufnahmestart abzüglich Video-Vorlauf, führt die geplante ROI-Bildzahl aus und wartet bis zum Aufnahmeende. Darunter folgt eine normale 60-Sekunden-Vollbildaufnahme zur Lokalisierung.

Daily Output

The tool writes one NINA JSON per observing date and copies the daily files to the configured Dropbox folder.

Das Programm erzeugt datierte NINA-Dateien. Die ausgewählten Ausgaben werden bei aktivierter Option in den konfigurierten Dropbox-Ordner kopiert.

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.

--template bezeichnet die schreibgeschützte NINA-Ausgangsvorlage. Der Generator kann zusätzlich eigenständige Bedeckungsblockdateien ausgeben; sie sind nicht mit der vollständigen Nachtsequenz gleichzusetzen.

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.

Der geschützte Eingabeordner einzeln wird bei jedem Lauf gelesen; seine ursprünglichen Zeilen haben Vorrang. --txt-file ergänzt eine weitere Datei. YYMMDD-Dateinamen liefern das Datum; andere Namen benötigen DATE yyyy-mm-dd- oder # yyyy-mm-dd-Zeilen.

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.

--complete-txt-file bezeichnet die zusammengeführte Eingabetabelle. Daraus entstehen Planungsephemeriden und NINA-Nachtdateien.

ROI Position

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

--field-x und --field-y definieren die obere linke ROI-Ecke, die direkt in den Lucky-Container geschrieben wird.

ROI Size

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

--roi-width und --roi-height definieren das Aufnahme-Rechteck; der Standard beträgt 200 × 200 Pixel.

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.

--min-diff-time ist die Speicher-/Ausleseverzögerung je Bild, die zur TXT-Belichtung addiert wird. Take Video ROI erhält den resultierenden Real-Wert. Bereich 0 bis 1 Sekunde, Standard 0,5 Sekunden.

Preparation Reserve

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

--slew-center-minutes reserviert den Vorbereitungsvorlauf vor der ROI-Aufnahme. Bereich 0 bis 10 Minuten, Standard 3 Minuten.

Binning

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

--binning erlaubt 1x1, 2x2, 3x3 oder 4x4; Standard ist 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-prep-seconds zieht Wait For Time vor Take Video Roi Exposures gegenüber dem Aufnahmestart vor. Bereich 0 bis 30 Sekunden, Standard 5 Sekunden.

Video ROI Margin

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

--video-roi-margin-percent erhöht die berechnete ROI-Bildzahl prozentual. Bereich 0 bis 100 Prozent; der Standardwert dieses Builds steht in der Hilfe.

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.

--camera-min-exposure markiert berechnete Belichtungen unterhalb der Kameragrenze. Bereich 0,01 bis 1,00 Sekunden, Standard 0,1 Sekunden.

Station

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

--station X09 bezeichnet Deep Random Survey, Rio Hurtado. Manuelle Breite und Länge können die lokale Stationszuordnung überschreiben; die automatische GUI-Stationsbefüllung ist davon zu unterscheiden.

MPC Ephemerides

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

Standardmäßig werden MPC-MPES-Ephemeriden für die genaue Ereignismitte abgefragt. --no-mpc-ephemerides schaltet dies ab.

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.

Standardmäßig wird die nächste Gaia-DR3-Quelle um jede TXT-Position abgefragt und zwischengespeichert. --star-radius-arcsec erlaubt 0 bis 10 Bogensekunden, Standard 3. Null überspringt die Suche; --no-star-catalog schaltet den Katalog ab.

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.

--star-distance-warning-arcsec markiert V Star rot, wenn der eigenbewegungskorrigierte Stern weiter entfernt ist. Bereich 0 bis 10 Bogensekunden, Standard 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.

--asteroid-albedo wird mit MPC H zur Schätzung von Durchmesser D und Durchquerungszeit dt verwendet. Bereich 0 bis 1, Standard 0,15.

Operator Checks

Template

The source template is read only. Standalone occultation blocks are created alongside complete day sequences.

Die Ausgangsvorlage ist schreibgeschützt. Eigenständige Bedeckungsblöcke und vollständige Nachtsequenzen haben unterschiedliche Rollen; für einen vollständigen Ablauf ist die passende Nachtsequenz erforderlich.

Coordinates

Use the listed RA/DEC as J2000. The Lucky target name removes any text after #.

Die angegebenen RA/DEC sind J2000-Koordinaten. Beim Lucky-Zielnamen wird Text hinter # entfernt.

MPC

The ephemerides page shows whether MPC or TXT coordinates were used for altitude and azimuth.

Die Ephemeridenseite zeigt, ob MPC- oder TXT-Koordinaten für Höhe und Azimut verwendet wurden.