Skripte

Siril verfügt über eine Befehlszeile in der grafischen Benutzeroberfläche und über die Möglichkeit, Skripte auszuführen, die eine Liste von Befehlen enthalten, entweder über die grafische Benutzeroberfläche oder über die Befehlszeilenschnittstelle. Im Allgemeinen wirken Befehle, die ein einzelnes Bild verändern, auf das aktuell geladene Bild, so dass die Verwendung des Befehls load in Skripten erforderlich ist, und Befehle, die auf eine Sequenz von Bildern wirken, benötigen den Namen der Sequenz als Argument. Wenn Dateien nicht so benannt sind, dass Siril sie als Sequenz erkennt, hilft der Befehl convert.

Tipp

Das Zeichen Space ist das Begrenzungszeichen zwischen den Argumenten. Wenn Sie Leerzeichen innerhalb der Argumente benötigen, können Sie einfache oder doppelte Anführungszeicehn verwenden, genau wie in der Befehlszeile des Betriebssystems.

Befehle können in die Befehlszeile am unteren Rand des Hauptfensters von Siril eingegeben werden. Eine andere Möglichkeit ist es, die Befehle in eine Datei zu schreiben und diese als Skript auszuführen. Um die Datei von der grafischen Benutzeroberfläche aus auszuführen, fügen speichern Sie sie im konfigurierten Skriptverzeichnis oder vernwende Sie in der grafischen Benutzeroberfläche aus das Zeichen @ in der Befehlszeile wie folgt:

@file_name

Einige Befehle (preprocess, stack, und alle Speicherbefehle) können Dateinamen verwenden, die Variablen aus dem FITS-Header enthalten. Das Format des Ausdrucks wird im Detail hier erläutert und kann mit dem Befehl parse getestet werden.

Benutzung von Skripten

Es gibt drei Wege um ein Skript auszuführen:

  • aus der grafischen Benutzeroberfläche, indem Sie das Schlüsselwort @ in der Befehlszeile verwenden, gefolgt von dem Namen der Skriptdatei im aktuellen Arbeitsverzeichnis,

  • aus der grafischen Benutzeroberfläche, über das Menü Skripte,

    Dialog
  • von der Kommandozeilenschnittstelle (siril-cli executable), mit dem Argument -s gefolgt vom Pfadnamen der Skriptdatei (siehe die Manpage für weitere Informationen).

Das Menü "Skripte" erscheint nur, wenn einige Skripte in den Skript-Suchverzeichnissen gefunden wurden. Dies sind entweder Standardverzeichnisse oder vom Benutzer im Einstellungsdialog festgelegte Verzeichnisse.

Liste der Skripte aufbauen

Standardmäßig werden bei der Installation von Siril eine Reihe von Skripten automatisch installiert. Diese eingebauten Skripte, die offiziellen Skripte, werden vom Entwicklerteam entwickelt und funktionieren garantiert: Sie sind für bestimmte Standardprozesse gedacht.

Verzeichnis für Benutzerskripte hinzufügen

Sie können natürlich auch Ihre eigenen <Scripts:Eigene Skripte schreiben> schreiben und Siril mitteilen, wo sie zu finden sind:

  • Klicken Sie auf das Symbol Hamburger, dann auf Einstellungen (oder drücken Sie Strg+P).

  • Klicken Sie auf den Abschnitt :Skripte.

  • Kopieren Sie in eine neue Zeile den Pfad zu dem Ort, an dem sie gespeichert werden sollen (erstellen Sie einen Ordner auf Ihrem Computer oder verweisen Sie auf einen bestehenden).

  • Klicken Sie auf das Symbol Aktualisieren direkt darunter.

  • Klicken Sie auf Apply.

Sie können so viele benutzerdefinierte Verzeichnisse nutzen wie sie möchten, indem sie diese einfach der Liste hinzufügen.

Wenn Sie gerade ein neues Skript in einem der Ordner hinzugefügt haben und das Menü aktualisieren möchten, geben Sie den Befehl reloadscripts in die Befehlszeile ein oder öffnen Sie den Abschnitt Einstellungen‣ Skripte und verwenden Sie das Symbol Aktualisieren. Dadurch werden alle Ordner der Liste durchsucht und alle Dateien mit der Erweiterung *.ssf gefunden.

Warnung

Es wird dringend empfohlen, Ihre benutzerdefinierten Skripte nicht im selben Ordner wie die mit Siril gelieferten Standardskripte zu speichern. Unter Windows können sie bei der Installation einer neueren Version gelöscht werden oder eine korrekte Deinstallation verhindern. Unter MacOS wird dadurch das Gesamtpaket beschädigt und die Verwendung von Siril gänzlich verhindert.

Keine Sorge, die Liste der Skriptspeicherorte ist in Ihrer Konfigurationsdatei gespeichert, so dass Sie sie bei der Installation einer neueren Version wiederfinden sollten.

Fehlerbehebung

Aus verschiedenen Gründen ist es möglich, dass das Menü Skripte nicht sichtbar ist. Dies bedeutet, dass die Skripte von Siril nicht gefunden wurden. Wenn das der Fall ist, gehen Sie bitte wie folgt vor.

  • Klicken Sie auf das Symbol Burger, dann auf Einstellungen.

  • Klicken Sie auf den Abschnitt :Skripte.

  • Löschen Sie alle Zeilen im Feld Skript Storage Directories wie in der folgenden Abbildung gezeigt.

  • Klicken Sie auf Apply.

  • Beenden Sie Siril und starten es neu.

Dialog

Skript-Seite der Einstellungen. Die Skripte werden aus den Pfaden geladen, die im Skript Storage Directories aufgeführt sind.

Eingebaute Skripte

Alle integrierten Skripte müssen dieser Dateistruktur folgen:

Dateistruktur Skripte
  • Mono_Preprocessing.ssf: Skript für Kalibrierung von Bildern aus monochromen DSLRs oder Astrokameras, verwendet Bias, Flats und Darks, registriert und stacked die Bilder. Um es zu benutzen legen sie Ihre Dateien (RAW oder FITS) in die Ordner mit den Namen lights, darks, flats und biases (im Siril-Standard-Arbeitsordner), dann führen Sie das Skript aus.

  • OSC_Preprocessing.ssf: Skript für die Kalibrierung von Bildern aus Farb-DSLRs oder Farb-Astrokameras (OSC - One-Show-Color), verwendet Bias, Flats und Darks, registriert und stacked die Bilder. Um es zu benutzen, legen sie Ihre Dateien (RAW oder FITS) in die Ordner mit den Namen lights, darks, flats und biases (im Siril-Standard-Arbeitsordner), dann führen Sie das Skript aus.

  • OSC_Extract_Ha.ssf: Skript zur Nutzung mit OSC DSLRs oder OSC Astrokameras, zur Verwendung mit H-Alpha Filtern oder Dual-Band-Filtern. Dieses Skript extrahiert die Ha-Ebene des Farbbildes. Um es zu benutzen, legen sie Ihre Dateien (RAW oder FITS) in die Ordner mit den Namen lights, darks, flats und biases (im Siril-Standard-Arbeitsordner), dann führen Sie das Skript aus.

  • OSC_Extract_HaOIII.ssf: dasselbe Skript wie oben, extrahiert aber die H-Alpha und OIII-Ebenen des Farbbilders. Um es zu benutzen, legen sie Ihre Dateien (RAW oder FITS) in die Ordner mit den Namen lights, darks, flats und biases (im Siril-Standard-Arbeitsordner), dann führen Sie das Skript aus. Sie können auch das Menü Bildbearbeitung, dann RGB Zusammensetzung... verwenden und das Ha-Ergebnis in den Rotkanal und das OIII-Ergebnis in den Grün- und Blaukanal legen, um ein HOO-Bild zu erhalten.

    Tipp

    Für Besitzer von SII- oder SII-OIII-Zweibandfiltern gelten die gleichen Skripte. Tatsächlich ist es für einen Farbsensor unmöglich, den Unterschied zwischen Ha (656,3 nm) und SII (671,6 nm), die beide rot sind, zu erkennen.

  • RGB_Zusammensetzung.ssf: Dieses in Version 1.2 hinzugefügte Skript registriert monochrome Bilder mit einer globalen Registrierung, beschneidet sie auf ihren gemeinsamen Bereich und nimmt die ersten drei Bilder, um ein Farbbild zu erzeugen. Die Eingabebilder sollten allein in ein Verzeichnis gelegt werden und die Namen R.fit (oder mit der konfigurierten Dateierweiterung), G.fit und B.fit tragen. Das Ergebnis wird rgb.fit heißen. Stellen Sie sicher, dass Sie das Verzeichnis process zwischen den einzelnen Läufen entfernen.

Sprache der Skripe

Zu Beginn des Skriptings gab es dank des Beitrags eines Benutzers zwei Versionen der Skripte (Englisch und Französisch). Als Siril 1.2.0 veröffentlicht wurde, wurde beschlossen, nur die englischen Skripte beizubehalten, um die Wartung zu vereinfachen. Wir ermutigen die Benutzer, Übersetzungen der offiziellen Skripte an ihre jeweiligen Communities weiterzugeben, wenn sie dies für notwendig erachten.

Mehr Skripte finden

Es gibt eine ganze Reihe von Skripten, die bei der Installation von Siril nicht mitgeliefert werden. Wir haben jedoch ein Gitlab-Repository für sie eingerichtet. Es steht jedem frei, sich zu registrieren und neue Skripte vorzuschlagen. Wir werden sie entsprechend ihrer Relevanz akzeptieren: Die verwendete Sprache muss Englisch sein.

Please refer to this address to browse and download the scripts: https://gitlab.com/free-astro/siril-scripts.

Warnung

Beachten Sie jedoch, dass diese Skripte nicht unbedingt von den Benutzern, die sie hochgeladen haben, gepflegt werden und möglicherweise nicht auf dem neuesten Stand sind. In diesem Sinne, viel Spaß.

Eigene Skripte schreiben

Eine Skriptdatei ist eine einfache Textdatei mit dem Dateityp *.ssf.

Ein Skript zu schreiben ist nicht schwierig. Es ist eine Folge von Aufrufen von befehlen, die nacheinander ausgeführt werden. Jeder Befehl muss ausgeführt werden, ohne dass ein Fehler zurückgegeben wird, sonst bricht das Skript ab. Es wird daher dringend empfohlen, die Liste der Befehle zu nutzen, um Syntax, Art und Anzahl der verwendeten Parameter zu erlernen. Außerdem sind einige Befehle nicht skriptfähig und werden mit dem Symbol Nicht skriptfähig markiert. Es kann auch nützlich sein, jede Skriptzeile in der Siril-Befehlszeile zu testen.

Each new script created in this way should be placed in a user-defined folder for Siril to find them.