funcone – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

Funcone – Kegelsuche einer Binärtabelle mit RA- und Dec-Spalten

ZUSAMMENFASSUNG

Funken [Säulen]

OPTIONAL

-d deccol:[hdr] # Dec-Spaltenname, Einheiten (def: DEC:d)
-j # Spalten aus Listendatei verbinden
-J # Spalten aus Listendatei verbinden, alle Zeilen ausgeben
-l Listendatei # Mittelpunkte und Radien aus einer Liste lesen
-L Listendatei # Mittelpunkte und Radien aus einer Liste lesen, Listenzeilen ausgeben
-n # Kegelgrenzen nicht als Filter verwenden
-r racol:[hdr] # RA-Spaltenname, Einheiten (def: RA:h)
-x # RA_CEN-, DEC_CEN-, RAD_CEN- und CONE_KEY-Spalten anhängen
-X # RA_CEN-, DEC_CEN-, RAD_CEN- und CONE_KEY-Spalten anhängen, alle Zeilen ausgeben

BESCHREIBUNG

Funcone führt eine Kegelsuche in den RA- und Dec-Spalten einer FITS-Binärtabelle durch. Der
Der Abstand von der Mitte RA, Dec zur RA, Dec in jeder Zeile der Tabelle beträgt
berechnet. Es werden Zeilen ausgegeben, deren Abstand kleiner als der angegebene Radius ist.

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.

Das dritte und vierte erforderliche Argument sind die RA- und Dec-Mittelposition. Standardmäßig,
RA wird in Stunden angegeben, während Dec in Grad angegeben wird. Sie können die Einheiten ändern
entweder durch Anhängen des Zeichens „d“ (Grad), „h“ (Stunden) oder „r“ (Bogenmaß).
Die Sexagesimalschreibweise wird unterstützt, wobei hms und dms durch Doppelpunkte oder Leerzeichen getrennt werden. (Wenn
Wenn Sie Leerzeichen verwenden, stellen Sie bitte sicher, dass die gesamte Zeichenfolge in Anführungszeichen gesetzt wird.)

Das fünfte erforderliche Argument ist der Radius der Kegelsuche. Standardmäßig der Radiuswert
wird in Grad angegeben. Die Einheiten können durch Anhängen des Zeichens „d“ (Grad) geändert werden.
„r“ (Bogenmaß), „‘“ (Bogenminuten) oder „“‘ (Bogensekunden).

Standardmäßig werden alle Spalten der Eingabedatei in die Ausgabedatei kopiert. Ausgewählte Spalten
kann mit einem optionalen sechsten Argument in der Form ausgegeben werden:

„Spalte1 Spalte1 ... SpalteN“

Mit einem siebten Argument können Sie ausgewählte Spalten aus der Listendatei ausgeben, wenn -j wechseln
wird eingesetzt. Beachten Sie, dass die in der Kegelberechnung verwendeten RA- und Dec-Spalten nicht identisch sein dürfen
abgewählt.

Außerdem heißen die RA- und Dec-Spaltennamen standardmäßig „RA“ und „Dec“ und werden in angegeben
Einheiten von Stunden bzw. Grad. Sie können sowohl den Namen als auch die Einheiten ändern
die Schalter -r [RA] und/oder -d [Dec]. Auch hier wird entweder „h“, „d“ oder „r“ angehängt
der Spaltenname, um Einheiten anzugeben, aber in diesem Fall muss ein Doppelpunkt : zwischen den stehen
Name und die Gerätespezifikation.

Besitzt das -l [Listendatei] Wenn der Schalter verwendet wird, dann einer oder mehrere von Center RA, Center Dec und
Der Radius kann einer Listendatei entnommen werden (bei der es sich um eine FITS-Tabelle oder einen ASCII-Spaltentext handeln kann).
Datei). In diesem Fall die dritte (Mitte RA), vierte (Mitte Dec) und fünfte (Radius)
Befehlszeilenargumente können entweder ein Spaltenname in der Listendatei sein (wenn dieser Parameter
variiert) oder ein numerischer Wert (wenn dieser Parameter statisch ist). Wenn ein Spaltenname ist
Wird für RA, Dec oder Radius angegeben, können Sie einen Doppelpunkt gefolgt von „h“, „d“ oder „r“ anhängen.
um Einheiten anzugeben (auch ' und " für den Radius). Der Kegelsuchalgorithmus wird jeweils einmal ausgeführt
Zeile in der Liste, wobei RA-, Dec- und Radiuswerte aus den angegebenen Spalten oder von übernommen werden
Statische numerische Werte, die in der Befehlszeile angegeben werden.

Bei Verwendung einer Liste werden alle gültigen Zeilen aus jeder Iteration in eine einzige Ausgabedatei geschrieben.
Verwenden Sie das -x Schalter, um abzugrenzen, welche Zeile der Listendatei zur Erstellung des verwendet wurde
gegebene Ausgabezeile(n). Dieser Schalter bewirkt, dass die Werte für den Mittelpunkt RA, Dec, Radius und geändert werden
Zeilennummer, die an die Ausgabedatei angehängt werden soll, in den Spalten RA_CEN, DEC_CEN, RAD_CEN
bzw. CONE_KEY. Alternativ ist die -j Der Schalter (Join) hängt alle Spalten an
von der Listenzeile zur Ausgabezeile (im Wesentlichen eine Verbindung der Listenzeile und der Eingabezeile),
zusammen mit der Zeilennummer CONE_KEY. Diese beiden Schalter schließen sich gegenseitig aus.

Das -X und -J Schalter schreiben jeweils die gleichen Daten wie ihre kleingeschriebenen Gegenstücke
Zeile, die eine Kegelsuche erfüllt. Darüber hinaus schreiben diese Schalter auch Zeilen aus dem aus
Ereignisdatei, die keine Kegelsuche erfüllt. In solchen Fällen wird die CONE_KEY-Spalte verwendet
erhält den Wert -1 und die Informationen zur Mitte und Listenposition werden auf Null gesetzt
für die angegebene Zeile. Somit wird garantiert, dass alle Zeilen der Eingabeereignisdatei ausgegeben werden.
wobei Zeilen, die mindestens eine Kegelsuche erfüllen, zusätzliche Suchinformationen enthalten.

Das -L Der Schalter verhält sich ähnlich wie der -l wechseln, indem es Zentren aus einer Listendatei übernimmt.
Es setzt jedoch auch implizit den Schalter -j, sodass die Ausgabezeilen der Join von sind
Eingabeereigniszeile und die Mittelpositionszeile. Darüber hinaus schreibt dieser Schalter auch alle aus
Mittelpositionszeilen, für die kein Ereignis die Kegelsuchkriterien dieser Zeile erfüllt.
Der Spalte CONE_KEY wird der Wert -2 für mittlere Zeilen zugewiesen, die nicht in der Nähe einer solchen waren
Die Datenzeile und die Ereignisspalten werden für diese Zeilen auf Null gesetzt. Auf diese Weise alle Zentren
Zeilen werden garantiert mindestens einmal ausgegeben.

Wenn einer der „Alle Zeilen“-Schalter (-X, -J, oder -L) angegeben werden, dann eine neue Spalte mit dem Namen JSTAT
wird der Ausgabetabelle hinzugefügt. Die positiven Werte in dieser Spalte geben die Mitte an
Positionieren Sie die Zeilennummer (beginnend bei 1) in der Listendatei so, dass diese Datenzeile erfolgreich ist
in einer Kegelsuche gefunden. Ein Wert von -1 bedeutet, dass die Datenzeile mit keinem Mittelpunkt übereinstimmte
Position. Ein Wert von -2 bedeutet, dass mit der Mittelposition keine Datenzeile übereinstimmte.

Bei gegebener Mittelpunktposition und Radius berechnet der Kegelsuchalgorithmus Grenzparameter
für eine Box, die den angegebenen Kegel umschließt, und testet nur Zeilen, deren Positionswerte liegen
innerhalb dieser Grenzen. Bei kleinen Dateien ist der mit diesem Kegel verbundene Overhead begrenzt
Das Filtern kann dazu führen, dass das Programm langsamer ausgeführt wird, als wenn alle Ereignisse getestet würden. Du kannst
Deaktivieren Sie die Kegelgrenzfilterung mithilfe von -n um zu sehen, ob dies die Verarbeitung beschleunigt
(besonders nützlich bei der Verarbeitung einer großen Liste von Positionen).

Beispielsweise verwendet die standardmäßige Kegelsuche die Spalten „RA“ und „Dez“ in Stunden und Grad
(bzw.) und RA-Position in Stunden, Dez und Radius in Grad:

Funone in.fits out.fits 23.45 34.56 0.01

So geben Sie die RA-Position in Grad an:

Funkkegel rein.passt raus.passt 23.45d 34.56 0.01

Um RA und Dec aus einer Liste zu erhalten, aber einen statischen Wert für den Radius verwenden (und auch schreiben).
identifizierende Informationen für jede Zeile in der Liste):

funcone -x -l list.txt in.fits out.fits MYRA MYDec 0.01

Vom Benutzer angegebene Spalten in Grad, RA-Position in Stunden (Sexagesimalschreibweise), Dez
Position in Grad (Sexagesimalschreibweise) und Radius in Bogenminuten:

funcone -r myRa:d -d myDec in.fits out.fits 12:30:15.5 30:12 15'

Nutzen Sie Funcone online über die Dienste von onworks.net