====== AstroImageJ Plugin ======

[[exoplaneten| zurück zu Exoplaneten beobachten und erforschen]]

====== Installation ======
<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
│    
└───macros
│
└───luts
│
└───jre
│
└───images
│   
└───plugins                 # the central folder for plugins
    │     
    │   ...                
    └───CASObservatory      # Unpacked directory from bitbucket
    │   │   ...
    │
    └───other directory
    │   │   ...
    │...
</code>


====== Plugins ======
===== Überblick =====
  * **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.


<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>

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.

  * **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