Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- astroimagej_plugin_-_helpertools_fuer_exoplaneten [2024/02/22 07:16] – torsten.roehl
+++ astroimagej_plugin_-_helpertools_fuer_exoplaneten [2024/02/23 09:04] (aktuell) – torsten.roehl
@@ Zeile 1: / Zeile 1: @@
 ====== AstroImageJ Plugin ======
-#CASObservatory AstroImageJ Plugin - v. 0.1.1
-# @since 2020
-# @last modified 16.04.2024
-# @author  torsten.roehl@linux-astronomie.de
-# @licence opensource (gpl)
+[[exoplaneten| zurück zu Exoplaneten beobachten und erforschen]]
-<code>
+====== Installation ======
-imagej (install directory)
+<note>Um das Plugin zu installieren, entpacken Sie zunächst die heruntergeladene Datei und kopieren das entstehende Verzeichnis in das ''Plugin-Verzeichnis'' von ''AstroImageJ''.
+  - Plugin Herunterladen und Verzeichnis entpacken
+  - den nun vorhandenen Ordner ''CASObservatory'' in das Verzeichnis ''plugins''  verschieben
+</note>
+<code| Verzeichnisstruktur von AstroImageJ>
+imagej ( install directory, this is the home directory)
 │   ij.jar                  # main application file
 │   ...                     # other files
@@ Zeile 32: / Zeile 37: @@
-[install]
+====== Plugins ======
-step 0: verzeichnis entpacken
+===== Überblick =====
-step 1: den Ordner CASObservatory in das Verzeichnis plugins (siehe oben) verschieben)
+  * **Cameratools**
+          * Plugin, das Kamerawerte (aus den Datenblättern) zur Verfügung stellt, nützlich für die Auswertung von Exoplaneten.
+===== Details =====
+====Cameratools ====
+Plugin, das Kamerawerte (aus den Datenblättern) zur Verfügung stellt, nützlich für die Auswertung von Exoplaneten.
-[content]
+<color #00a2e8>**INPUT**</color>
+  * **Camera** Auswahl der Kamera
+  * **Read Fits Header** Falls Gain und Temperatur im FITS-Header gespeichert sind (dies ist abhängig von der Aufnahmesoftware), können die erforderlichen Werte hier automatisch berechnet werden.
+  * **Gain Value**
+          * Der verwendete "Gain" während der Aufnahme. Am einfachsten ist es, wenn dieser Wert von der Aufnahmesoftware zur Verfügung gestellt wird. Ansonsten ist dieser Wert manuell einzutragen.
+  * **Temp. Value**
+          * Die Temperatur während der Aufnahme. Auch dieser Wert kann direkt aus dem FITS-Header gelesen werden, falls die Aufnahmesoftware ihn zur Verfügung stellt. Ansonsten ist dieser Wert manuell einzutragen.
+<color #00a2e8>**OUTPUT**</color>
-cameratools  - plugin das Kamerawerte (aus den Datenblättern) zur Verfügung stellt,
+Dieses Tool stellt folgende Werte zur Verfügung, die als Eingabe bei der Auswertung von Exoplaneten als Kamerawerte i.d.R. zur Verfügung gestellt werden sollten.
-               nützlich für exoplaneten Auswertung. Eigene Kameras können leicht durch hinzufügen von camera_#.dat Dateien erstellt werden.
+  * **CCD gain**
+  * **CCD readout noise**
+  * **CCD dark current per sec
+**
+|{{ :exoplanet:cameratool-1.png?320 |}}|{{ :exoplanet:aperture_photometry_settings.png?320 |}} |
+|Das ''Camera Tool'' berechnet aus den Gain- und Temperaturwert die Ausgabewerte (Gain, Read Noise, Dark Current), die ''AstroImageJ'' benötigt, um Fehler bei der Lichtkurvenanalyse möglichst gut abschätzen/berechnen zu können.| AstroImageJ bietet im Dialog 'Aperture Photometry Settings' die Möglichkeit, kameraspezifische Werte einzutragen.|
+<WRAP center round info 95%>
+Diese Werte werden alle aus dem Datenblatt für die Kamera bzw. den Sensor entnommen und im einfachsten Fall linear approximiert, was in der Praxis ausreichend ist.
+</WRAP>
+=== Hinzufügen einer Kamera ===
+Eigene Kameras können einfach durch Hinzufügen von ''camera_#.dat-Dateien'' erstellt werden.
+  - Im Verzeichnis "CASObservatory → res" eine neue Datei mit dem Namen "camera_#.dat" anlegen. Achten Sie dabei auf die Nomenklatur und wählen Sie die nächste freie Nummer für den Platzhalter (#).
+<code| Template für eine Kamera >
+# CAMERA
+# HEADER_GAIN
+# READ_NOISE
+#
+CAMERA = ZWO ASI 178 MM Cool Mono
+HEADER_GAIN = GAIN
+HEADER_TEMP = CCD-TEMP
+GAIN=0,0.918079,50,0.514124,100,0.290960,150,0.1666666,200,0.098870,269.72,0.04237,300,0.033898,400,0.01412429
+READ_NOISE=0,2.241176,50,1.923529,100,1.7323529,150,1.573529,200,1.4441176,269.72,1.373529,300,1.3735294,400,1.352941
+#
+# a exp(bx) +c
+#
+TEMP_A = 0.004298235031008166
+TEMP_B = 0.12257061220179669
+TEMP_C = 0.00575453787776399
+</code>
+**Erforderliche Header**
+<WRAP center round info 95%>
+Je nach Aufnahmesoftware müssen die Werte für ''HEADER_GAIN'' und ''HEADER_TEMP'' eventuell angepasst werden. Die Default Werte beziehen sich auf die Aufnahmesoftware ''CCDCiel''.
+</WRAP>
+  * ''CAMERA'' Bezeichnung für die Kamera
+  * ''HEADER_GAIN''  Fits-Keywort für Gain, wenn dieser Wert von der Aufnahmesoftware zur Verfügung gestellt wird
+  * ''HEADER_TEMP''  Fits-Keywort für die Temperatur, wenn die Temperatur von der Aufnahmesoftware zur Verfügung gestellt wird.
+          * Lassen sie dieses Feld frei (''HEADER_TEMP=''), wenn kein ''Darkcurrent''  zur Verfügung steht.
+**
+Werte:**
+  * ''GAIN''  Liste von n-Wertepaaren $x_0,y_0,x_1,y_1,...x_n,y_n$ für die Verstärkung
+  * ''READ_NOISE'' Liste von n-Wertepaaren $x_0,y_0,x_1,y_1,...x_n,y_n$ für die Temperatur
+Die Anzahl und x-Werte sollten in beiden Listen übereinstimmen!
+**Dunkelstrom**
+Der Dunkelstrom (engl. dark current) ist temperaturabhängig. Um ihn berechnen zu können, steht ein Python-Programm "camera_darkcurrent_astroimagej.py" zur Verfügung. Hier werden aus einer Liste (die dem Datenblatt entnommen werden muss) die Koeffizienten (TEMP_A, TEMP_B, TEMP_C) berechnet. Falls die erforderlichen Daten nicht im Datenblatt zu finden sind, muss weiter gesucht werden (z.B. im Datenblatt für den Bildsensor).
+Hierbei wird mit folgender Funktion gefittet:
+\begin{equation*} a e^{bx} +c \end{equation*}
+  * ''TEMP_A'' = a
+  * ''TEMP_B'' = b
+  * ''TEMP_C'' = c