funtable - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

funtable – Kopieren Sie ausgewählte Zeilen aus einer Funtools-Datei in eine FITS-Binärtabelle

ZUSAMMENFASSUNG

lustig [-a] [-i⎪-z] [-m] [-s Spalten] [Säulen]

OPTIONAL

-a # als Tabellenerweiterung an die vorhandene Ausgabedatei anhängen
-i # für Bilddaten, nur X- und Y-Spalten generieren
-m # für Tabellen, schreiben Sie eine separate Datei für jede Region
-s "col1 ..." # Spalten, nach denen sortiert werden soll
-z # für Bilddaten, Nullwertpixel ausgeben

BESCHREIBUNG

lustig Wählt Zeilen aus der angegebenen FITS-Erweiterung (nur Binärtabelle) eines FITS aus
Datei oder aus einer Nicht-FITS-Rohereignisdatei und schreibt diese Zeilen in eine FITS-Binärtabelle
Datei. Außerdem wird eine FITS-Binärtabelle aus einem Bild oder einer Roharray-Datei erstellt.

Das erste Argument des Programms gibt die FITS-Datei, die Rohereignisdatei oder das Roharray an
Datei. Wenn „stdin“ angegeben ist, werden Daten aus der Standardeingabe gelesen. Verwenden Sie Funtools
Klammernotation zur Angabe von FITS-Erweiterungen und Filtern. Das zweite Argument ist das
FITS-Datei ausgeben. Wenn „stdout“ angegeben ist, wird die FITS-Binärtabelle in die geschrieben
Standardausgabe. Standardmäßig werden alle Spalten der Eingabedatei in die Ausgabedatei kopiert.
Ausgewählte Spalten können mit einem optionalen dritten Argument in der Form ausgegeben werden:

„Spalte1 Spalte1 ... SpalteN“

Das lustig Das Programm wird im Allgemeinen verwendet, um mithilfe von Table Zeilen aus einer FITS-Binärtabelle auszuwählen
Filter und/oder räumliche Regionsfilter. Sie können beispielsweise nur ausgewählte Zeilen (und) kopieren
Nur ausgewählte Spalten ausgeben) durch Ausführen eines Befehls wie:

[sh] funtable „test.ev[pha==1&&pi==10]“ stdout „xy pi pha“ ⎪ fundisp stdin
XY PHA PI
------- ------- ------- ---------
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10

Die besondere Kolumne $REGION kann angegeben werden, um die Regions-ID jeder Zeile zu schreiben:

[sh $] funtable "test.ev[time-(int)time>=.99&&annulus(0 0 0 10 n=3)]" stdout 'xy time $REGION' ⎪ fundisp stdin
XY ZEITREGION
-------- -------- --------- ----------
5 -6 40.99000000 3
4 -5 59.99000000 2
-1 0 154.99000000 1
-2 1 168.99000000 1
-3 2 183.99000000 2
-4 3 199.99000000 2
-5 4 216.99000000 2
-6 5 234.99000000 3
-7 6 253.99000000 3

Hier nur Zeilen mit der richtigen Nachkommastelle und deren Position auch innerhalb eines von
Die drei Ringe sind geschrieben.

Spalten können mit einem Minuszeichen vor der Spalte von der Anzeige ausgeschlossen werden:

[sh $] funtable „test.ev[time-(int)time>=.99]“ stdout „-time“ ⎪ fundisp stdin
XY PHA PI DX DY
-------- -------- -------- ---------- ---------- ----- ------
5 -6 5 -6 5.50 -6.50
4 -5 4 -5 4.50 -5.50
-1 0 -1 0 -1.50 0.50
-2 1 -2 1 -2.50 1.50
-3 2 -3 2 -3.50 2.50
-4 3 -4 3 -4.50 3.50
-5 4 -5 4 -5.50 4.50
-6 5 -6 5 -6.50 5.50
-7 6 -7 6 -7.50 6.50

Alle Spalten außer der Zeitspalte werden geschrieben.

Im Allgemeinen gelten folgende Regeln zum Aktivieren und Deaktivieren von Spalten:

· Wenn nur Ausschlussspalten angegeben werden, werden alle Spalten außer den Ausschlussspalten
aktiviert werden.

· Wenn nur Include-Spalten angegeben werden, werden nur die angegebenen Spalten aktiviert.

· Wenn eine Mischung aus Einschluss- und Ausschlussspalten angegeben wird, dann alle außer den Ausschlussspalten
Spalten werden aktiv; dieser letzte Fall ist mehrdeutig und die Regel ist willkürlich.

Neben der expliziten Angabe von Spaltennamen sind die Sonderzeichen + und - kann sein
zum Aktivieren und Deaktivieren verwendet alle Säulen. Dies ist nützlich, wenn Sie die
$REGION-Spalte zusammen mit allen anderen Spalten. Laut Regeln ist die Syntax "$REGION"
aktiviert nur die Regionsspalte und deaktiviert den Rest. Verwenden Sie "+ $REGION", um zu aktivieren
alle Spalten sowie die Regionsspalte.

Normalerweise wird nur die ausgewählte Tabelle in die Ausgabedatei kopiert. In einer FITS-Binärtabelle
Manchmal ist es wünschenswert, alle anderen FITS-Erweiterungen als in die Ausgabedatei zu kopieren
Also. Dies kann durch Anhängen eines „+“-Zeichens an den Namen der Erweiterung in der Eingabe erfolgen
Dateiname. Der erste Befehl unten kopiert beispielsweise nur die EVENT-Tabelle, während die
Der zweite Befehl kopiert auch andere Erweiterungen:

[sh] funtable „/proj/rd/data/snr.ev[EVENTS]“ events.ev
[sh] funtable „/proj/rd/data/snr.ev[EVENTS+]“ eventsandmore.ev

Wenn die Eingabedatei ein Bild oder eine Roharray-Datei ist, dann lustig wird ein FITS generieren
Binärtabelle aus den Pixelwerten im Bild. Beachten Sie, dass eine Angabe nicht möglich ist
die auszugebenden Spalten (mit Befehlszeilenargument 3). Stattdessen gibt es zwei Möglichkeiten
Erstellen Sie eine solche Binärtabelle aus einem Bild. Standardmäßig wird eine dreispaltige Tabelle generiert
Die Spalten sind „X“, „Y“ und „VALUE“. Für jedes Pixel im Bild eine einzelne Zeile (Ereignis)
wird generiert, wobei den Spalten „X“ und „Y“ die Werte dim1 und dim2 des Bildes zugewiesen werden
Pixel und der Spalte „VALUE“ wird der Wert des Pixels zugewiesen. Mit irgendwie
Tisch, Laufen lustig in der Spalte „WERT“ führt zu den gleichen Ergebnissen wie beim Ausführen lustig
auf dem Originalbild.

Besitzt das -i Wird der Schalter („einzelne“ Zeilen) angegeben, dann sind es nur die Spalten „X“ und „Y“.
generiert. In diesem Fall generiert jeder positive Pixelwert im Bild n Zeilen (Ereignisse).
Dabei ist n gleich dem ganzzahligen Wert dieses Pixels (plus 0.5 für Gleitkommazahlen).
Daten). Tatsächlich -i stellt ungefähr die Zeilen einer Tabelle wieder her, die vorhanden gewesen wären
in das Eingabebild einsortiert. (Das ist natürlich nur annähernd richtig, da die
resultierende x,y-Positionen werden ganzzahlig.)

Besitzt das -s [col1 col2 ... Spalte] Wird der Schalter („sort“) angegeben, werden die Ausgabezeilen einer Binärdatei ausgegeben
Die Tabelle wird anhand der angegebenen Spalten als Sortierschlüssel sortiert. Die Sortierschlüssel müssen sein
Skalarspalten und müssen auch Teil der Ausgabedatei sein (d. h. Sie können nicht nach einer Spalte sortieren).
aber nicht in die Ausgabe einbeziehen). Diese Einrichtung nutzt die _Sortieren Programm (im Lieferumfang enthalten).
funtools), die über Ihren Pfad erreichbar sein müssen.

Für Binärtabellen ist die -m Der Schalter („mehrere Dateien“) generiert für jede eine separate Datei
Region in der Filterspezifikation, d. h. jede Datei enthält nur die Zeilen aus dieser Region.
Zeilen, die den Filter bestehen, sich aber in keiner Region befinden, werden ebenfalls in einer separaten Datei abgelegt.

Die separaten Ausgabedateinamen, die von generiert werden -m Schalter werden automatisch aus erzeugt
Die Root-Ausgabedatei soll die Regions-ID der zugehörigen Region enthalten. (Beachten Sie diese Region
IDs beginnen bei 1, sodass der mit der ID 0 verknüpfte Dateiname Zeilen enthält, die die übergeben
(Sie befinden sich jedoch nicht in einer bestimmten Region.) Die Namen der Ausgabedateien werden wie folgt generiert:

· Eine $n-Angabe kann an einer beliebigen Stelle im Stammdateinamen verwendet werden (in geeigneter Weise in Anführungszeichen gesetzt).
schützen Sie es vor der Shell) und werden um die ID-Nummer des zugehörigen erweitert
Region. Zum Beispiel:

funtable -m input.fits'[cir(512,512,1);cir(520,520,1)...]' 'foo.goo_$n.fits'

generiert Dateien mit dem Namen foo.goo_0.fits (für Zeilen, die sich nicht in einer Region befinden, aber dennoch übergeben werden
der Filter), foo.goo_1.fits (Zeilen in Regions-ID Nr. 1, die erste Region), foo.goo_2.fits
(Zeilen in Regions-ID Nr. 2) usw. Beachten Sie, dass im Ausgabestamm einfache Anführungszeichen erforderlich sind
um das '$' vor der Shell zu schützen.

· Wenn $n nicht angegeben ist, wird die Regions-ID vor dem ersten Punkt (.) in platziert
der Dateiname. Daher:

funtable -m input.fits'[cir(512,512,1);cir(520,520,1)...]' foo.evt.fits

generiert Dateien mit dem Namen foo0.evt.fits (für Zeilen, die sich nicht in einer Region befinden, aber dennoch übergeben werden).
der Filter), foo1.evt.fits (Zeilen in Regions-ID Nr. 1), foo2.evt.fits (Zeilen in Regions-ID
#2) usw.

· Wenn im Root-Ausgabedateinamen kein Punkt angegeben ist, lautet die Regions-ID
an den Dateinamen angehängt. Daher:

funtable -m input.fits'[cir(512,512,1);cir(520,520,1)...]' 'foo_evt'

generiert Dateien mit dem Namen foo_evt0 (für Zeilen, die sich nicht in einer Region befinden, aber dennoch die übergeben
filter), foo_evt1 (Zeilen in Regions-ID Nr. 1), foo_evt2 (Zeilen in Regions-ID Nr. 2) usw.

Der Mechanismus mit mehreren Dateien bietet eine einfache Möglichkeit, einzelne Quelldatendateien zu generieren
mit einem einzigen Durchgang durch die Daten.

Standardmäßig wird eine neue FITS-Datei erstellt und die Binärtabelle in die erste geschrieben
Verlängerung. Wenn die -a (append)-Schalter angegeben ist, wird die Tabelle an eine bestehende angehängt
FITS-Datei als BINTABLE-Erweiterung. Beachten Sie, dass die FITS-Ausgabedatei bereits vorhanden sein muss.

Besitzt das -z ("null" Pixelwerte) Schalter ist angegeben und -i nicht angegeben ist, dann Pixel
mit einem Nullwert werden ausgegeben, wobei die Spalte „VALUE“ auf Null gesetzt ist. Offensichtlich das
Der Schalter ist bei der Ausgabe einzelner Ereignisse nicht sinnvoll.

Nutzen Sie funtable online mit den onworks.net-Diensten