MPC Neo Rating - Weitergabe und Bedienung ========================================= Stand: 2026-05-13 Webseite: https://www.jostjahn.de/amrum-software/MPCNEORating/ Empfohlene Nutzung ------------------ MpcRatingGui.exe Die GUI ist die normale Oberflaeche. Sie fuehrt durch Auswahl der MPC- Eingabedatei, Parameter, Verarbeitungsschritte, HTML-Ausgabe, Aufraeumvorschau und Find_Orb-Vergleich. Viele Buttons, Parameterfelder und Statuszeilen haben Hover-Texte mit ausfuehrlichen Erklaerungen. Sprache, Eingabedatei, Parameter, Verarbeitungsschritte und Fensterposition werden fuer den naechsten Start gemerkt. Die Find_Orb-Probe startet bei auffaelligen Residuen isolierte Full-, Simplex- und Superplex-Testlaeufe unter findorb_probe. Beim Start prueft die GUI die Datei versions.txt auf der Webseite. Eine Meldung erscheint nur, wenn dort eine neuere Version steht; bei aktueller Version bleibt der Start ohne Hinweis. Bei einem verfuegbaren Update kann direkt die Webseite geoeffnet oder das Setup von der Webseite geladen, per SHA256 geprueft und gestartet werden. Kommandozeile ------------- mpc_rating.exe test.txt Das Kommandozeilentool startet die eigentliche Auswertung. Die GUI nutzt dieses Programm intern und ruft danach die HTML- und Orbitseiten-Werkzeuge auf. Voraussetzungen auf dem Zielrechner ----------------------------------- - Windows 10 oder Windows 11 - Internetzugang fuer MPC NEO Rating, MPC Checker, WAMO und MPC db_search - Google Chrome oder Microsoft Edge fuer Browserautomation (die grossen Browserpakete werden nicht im Setup mitgeliefert) - Find_Orb/fo64 liegt im Paket bzw. in den mitgelieferten Hilfsordnern Eingabedatei ------------ Die Eingabedatei ist eine MPC-Datei mit Kopfzeilen und 80-Spalten- Beobachtungszeilen. Eigene Objektbezeichnungen duerfen bis zu 7 Zeichen lang sein und muessen nicht mit JJDS beginnen. Wenn der Vergleich mit alten Beobachtungen aktiviert ist und die konfigurierte Old_obs-Datei existiert, z.B. z:\neueobjekte.txt, nutzt die GUI Old_obs nur fuer den Doppelten-Vergleich. Rating, MPC NEO Rating, MPC Checker, WAMO, Find_Orb und die Orbitseiten verwenden exakt die ausgewaehlte Eingabedatei. Die GUI protokolliert dazu Beobachtungszahl, Objektliste, Datum und SHA256 der Quelle und der Arbeitskopie. Wichtige Ausgaben ----------------- Zu einer Eingabedatei test.txt entstehen u.a.: test.txt.rating test.txt.rating.html test.txt.rating.en.html plots\test.txt\index.html plots\test.txt\index.en.html test.txt.findorb_compare.html test.txt.findorb_compare.csv test.txt.findorb_optimization.html test.txt.findorb_optimization.csv test.txt.manifest.json last_run_manifest.json input_orbits\ findorb_orbits\ backup\yyyymmddhhmmss\ input_orbits enthaelt Orbitseiten nur aus den eigenen Beobachtungen des neuen Objekts. findorb_orbits enthaelt eigene Bahnen und vom MPC verlinkte Bahnen. Beide Ordner enthalten zu jeder erzeugten deutschen Orbitseite auch eine englische Datei mit der Endung .en.html. Die deutsche Hauptdatei verlinkt die deutschen Orbitseiten, die englische Hauptdatei verlinkt die englischen Orbitseiten. Der Ordner plots\\ enthaelt die getrennten Grafiken. index.html ist deutsch, index.en.html ist englisch. Die englische HTML-Ausgabe verlinkt die *_en.png- bzw. *_en.svg-Dateien, damit dort nicht versehentlich deutsche Grafikbeschriftungen erscheinen. Die SVG-Dateien bleiben erhalten; fuer die Vorschau werden bevorzugt PNG-Dateien verwendet. Die Residuen werden auf den Elemente-Seiten als Tabelle ausgegeben; die Spalte Res steht hinter dDec. GUIDE9 und Tycho Tracker ------------------------ Die GUI kann nach einem Lauf die eigenen Bahnelemente in die von GUIDE9 bzw. Tycho Tracker benutzte MPCORB.DAT eintragen. Das geschieht nur, wenn die entsprechende Option in der GUI angehakt ist. Ohne die Zusatzoption "alle vorhandenen eigenen Orbits aus Backups einbeziehen" werden nur die eigenen Objekte aus der gerade erzeugten lokalen Orbitberechnung eingetragen, also die Zeilen aus input_orbits\findorb\*\mpc_fmt.txt. Mit dieser Zusatzoption werden zusaetzlich die vorhandenen Backup-Laeufe durchsucht und eigene MPCORB-Zeilen uebernommen. Bereits vorhandene Zielzeilen mit gleicher Objektkennung werden dabei ersetzt. Vor dem ersten Schreibzugriff wird im Zielordner genau eine Sicherung angelegt: MPCORB.DAT.mpc-rating-original Wenn diese Sicherung schon existiert, wird keine weitere Sicherungskopie erzeugt. Vor dem Schreiben prueft das Programm die Objektkennung in der MPCORB.DAT. Bereits vorhandene eigene Objekte werden durch die neu berechneten Zeilen ersetzt; neue eigene Objekte werden angehaengt. Die rechte lesbare Objektbezeichnung wird im MPCORB-Format an der gleichen Spaltenposition geschrieben wie z.B. "5154 T-3" in einer normalen MPCORB.DAT. Die Option veraendert nicht die MPC-Auswertung, nicht MPC Checker, nicht WAMO und nicht die NEO-Rating-Betrachtung. Sie ist nur dazu da, GUIDE9 bzw. Tycho Tracker die lokal berechneten eigenen Bahnen bekannt zu machen. Helligkeitskorrektur -------------------- Die Helligkeitskorrektur darf nur verwendet werden, wenn gemessene und erwartete Helligkeiten vorher verglichen wurden und damit eine erkannte systematische Differenz ausgeglichen werden soll. Sie sollte moeglichst nicht benutzt werden. Ohne diesen fachlichen Vergleich sollten die Originalhelligkeiten unveraendert bleiben. Wenn in einem Objekt/Nacht-Block gar keine Helligkeit steht, wird das eingestellte mag-max-Limit als Ersatzhelligkeit verwendet. Automatische Sicherung ---------------------- Nach jedem vollstaendigen HTML-Lauf wird ein Backup-Ordner mit Zeitstempel angelegt: backup\yyyymmddhhmmss Dort werden die laut Manifest erzeugten Dateien gesichert. Der Pfad steht in last_run_manifest.json und in .manifest.json. Die Aufraeumfunktion loescht diesen Ordner nicht automatisch; backup wird nur als "manuell pruefen" angezeigt. Alte Backup-Laeufe koennen optional vorgeschlagen werden, wenn mindestens 20 neuere Backups erhalten bleiben und die alten Ordner aelter als 30 Tage sind. Aufraeumen ---------- Die GUI kann einen Trockenlauf fuer alte temporaere Dateien und alte Rating-/HTML-Ausgaben anzeigen. Geloescht wird nur nach ausdruecklicher Bestaetigung. Alte Backups sind eine eigene, standardmaessig nicht angehakte Kategorie. Ordner wie versionierung, findorb, findorb_probe und build werden nicht automatisch entfernt. HTML-Bericht ------------ Die HTML-Ausgabe enthaelt sortierbare Tabellen, Hover-Texte in Spaltenkoepfen, rechtsbuendige Zahlen, horizontales Scrollen fuer schmale Bildschirme und Links auf die Einzelorbitseiten. Die Ausgabe wird in Deutsch und Englisch erzeugt. Die englische HTML-Datei verlinkt die englischen Orbitseiten und die englische Grafikuebersicht; dadurch werden deutsche und englische Ausgaben nicht mehr vermischt. Unsichere eigene Bahnen werden grau markiert; rote Warnwerte werden in diesen grauen Zeilen abgeschwaecht. Find_Orb-Vergleich ------------------ Der Find_Orb-Vergleich ist ein Diagnosebericht. Er vergleicht vorhandene eigene und MPC-verlinkte Bahnen und markiert auffaellige Residuen. Bei auffaelligen Residuen startet die GUI anschliessend direkt isolierte Full-, Simplex- und Superplex-Proben unter findorb_probe. Normale Bahnelemente und HTML-Orbitseiten bleiben dabei unveraendert. Find_Orb-Probe -------------- Bei auffaelligen Residuen startet die GUI echte isolierte Testlaeufe. Auf der Kommandozeile ist der reine Vorschlagsbericht weiterhin moeglich: python findorb_optimization_probe.py test.txt Echte Proben entsprechen: python findorb_optimization_probe.py test.txt --run Dabei entstehen isolierte Probeordner unter findorb_probe\. Die normalen Bahnelemente und HTML-Orbitseiten bleiben unveraendert. Weitergabeumfang ---------------- Fuer eine vollstaendige Weitergabe wird das Setup empfohlen: website\downloads\MPC-Rating-Setup.exe Das Setup installiert nur die benoetigten Programmdateien und Hilfswerkzeuge. Die Playwright-Testbrowser werden bewusst nicht eingepackt; das Programm startet den auf dem Zielrechner vorhandenen Chrome oder Edge. Dadurch bleibt das Setup deutlich kleiner. Im Windows-Startmenue wird angelegt: AmrumSoftware\MPC Rating\MPC Rating AmrumSoftware\MPC Rating\Datenordner AmrumSoftware\MPC Rating\Hilfe AmrumSoftware\MPC Rating\Fehlerbericht AmrumSoftware\MPC Rating\Webseite AmrumSoftware\MPC Rating\Update pruefen AmrumSoftware\MPC Rating\Alte Version wiederherstellen AmrumSoftware\MPC Rating\Deinstallieren Die GUI zeigt oben die installierte Versionsnummer. Sie prueft beim Start Internet-/Firewall-Zugriff fuer die Webabfragen und zeigt bei Blockaden eine blinkende Warnung. Solange diese Pruefung laeuft, zeigt der Startbutton "Pruefe Internet..." und ist gesperrt; erst bei freiem Zugriff wird er wieder als "Start" freigegeben. Ueber Fehlerbericht kann das sichtbare Log gespeichert oder als Bericht mit Versionsnummer, Registry-/Firewall-Hinweisen und Programmdatei-Informationen per Mailprogramm an mpcrating@jostjahn.de vorbereitet werden. Der Datenordner fuer GUI-Laeufe ist standardmaessig: Dokumente\MPC Rating Bei einer vorhandenen Installation zeigt das Setup vor der Rueckfrage die neue Version und die erkannte installierte Version an und warnt vor dem Ersetzen der Programmdateien. Vor dem Ersetzen wird die alte Programmversion unter %LOCALAPPDATA%\AmrumSoftware\MPC-Rating-Backups\backup-yyyymmdd-hhmmss gesichert. Der Startmenue-Eintrag "Alte Version wiederherstellen" kopiert das letzte Setup-Backup zurueck. Der Deinstaller entfernt Programmdateien und Startmenue-Eintraege; der Datenordner bleibt standardmaessig erhalten. Die einzelnen EXE-Dateien bleiben fuer direkte Tests erhalten: website\downloads\MpcRatingGui.exe website\downloads\mpc_rating.exe Die Hashwerte stehen in website\versions.txt und auf der Webseite. Beim Bauen des Setups werden diese Hashwerte automatisch aktualisiert. Fuer Release-Pruefungen gibt es zusaetzlich einen isolierten Setup-Smoke-Test.