funcone - En ligne dans le Cloud

PROGRAMME:

Nom

funcone - recherche de cône d'une table binaire contenant les colonnes RA, Dec

SYNOPSIS

fonctioncone [Colonnes]

OPTIONS

-d deccol:[hdr] # Nom de la colonne Dec, unités (def: DEC:d)
-j # joint les colonnes du fichier de liste
-J # joint les colonnes du fichier de liste, affiche toutes les lignes
-l listfile # lit les centres et les rayons d'une liste
-L listfile # lit les centres et les rayons d'une liste, affiche les lignes de la liste
-n # n'utilise pas les limites des cônes comme filtre
-r racol:[hdr] # Nom de la colonne RA, unités (def: RA:h)
-x # ajoute les cols RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY
-X # ajoute les cols RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY, affiche toutes les lignes

DESCRIPTION

Funcone effectue une recherche conique sur les colonnes RA et Dec d'une table binaire FITS. Les
distance du centre RA, Dec position à la RA, Dec dans chaque ligne du tableau est
calculé. Les lignes dont la distance est inférieure au rayon spécifié sont sorties.

Le premier argument du programme spécifie le fichier FITS, le fichier d'événement brut ou le tableau brut
déposer. Si "stdin" est spécifié, les données sont lues à partir de l'entrée standard. Utiliser Funtools
Bracket Notation pour spécifier les extensions FITS et les filtres. Le deuxième argument est le
fichier FITS de sortie. Si "stdout" est spécifié, la table binaire FITS est écrite dans le
sortie standard.

Les troisième et quatrième arguments requis sont la position centrale RA et Dec. Par défaut,
RA est spécifié en heures tandis que Dec est spécifié en degrés. Vous pouvez changer les unités de
l'un ou l'autre en ajoutant le caractère "d" (degrés), "h" (heures) ou "r" (radians).
La notation sexagésimale est prise en charge, avec des deux-points ou des espaces séparant hms et dms. (Lorsque
en utilisant des espaces, veuillez vous assurer que la chaîne entière est entre guillemets.)

Le cinquième argument requis est le rayon de la recherche du cône. Par défaut, la valeur du rayon
est donné en degrés. Les unités peuvent être modifiées en ajoutant le caractère "d" (degrés),
"r" (radians), "'" (minutes d'arc) ou '"' (secondes d'arc).

Par défaut, toutes les colonnes du fichier d'entrée sont copiées dans le fichier de sortie. Colonnes sélectionnées
peut être affiché à l'aide d'un sixième argument facultatif sous la forme :

"colonne1 colonne1 ... colonneN"

Un septième argument vous permet de sortir les colonnes sélectionnées du fichier de liste lorsque -j interrupteur
est utilisé. Notez que les colonnes RA et Dec utilisées dans le calcul du cône ne doivent pas être
désélectionné.

Par défaut également, les noms des colonnes RA et Dec sont nommés "RA" et "Dec", et sont donnés dans
unités d'heures et de degrés respectivement. Vous pouvez modifier à la fois le nom et les unités en utilisant
les commutateurs -r [RA] et/ou -d [Dec]. Encore une fois, l'un des "h", "d" ou "r" est ajouté à
le nom de la colonne pour spécifier les unités mais dans ce cas, il doit y avoir un deux-points ":" entre le
nom et la spécification de l'unité.

Si la -l [fichier liste] est utilisé, puis un ou plusieurs des éléments suivants : centre RA, centre Dec et
le rayon peut être extrait d'un fichier de liste (qui peut être une table FITS ou un texte de colonne ASCII
déposer). Dans ce cas, le troisième (centre RA), le quatrième (centre Dec) et le cinquième (rayon)
les arguments de la ligne de commande peuvent être soit un nom de colonne dans le fichier de liste (si ce paramètre
varie) ou bien une valeur numérique (si ce paramètre est statique). Lorsqu'un nom de colonne est
spécifié pour le RA, Dec ou le rayon, vous pouvez ajouter deux points suivis de "h", "d" ou "r"
pour spécifier les unités (également ' et " pour le rayon). L'algorithme de recherche de cône est exécuté une fois pour chaque
ligne dans la liste, en prenant les valeurs RA, Dec et radius des colonnes spécifiées ou de
valeurs numériques statiques spécifiées sur la ligne de commande.

Lors de l'utilisation d'une liste, toutes les lignes valides de chaque itération sont écrites dans un seul fichier de sortie.
Utilisez l'option -x pour aider à délimiter quelle ligne du fichier de liste a été utilisée pour produire le
ligne(s) de sortie donnée(s). Ce commutateur provoque les valeurs pour le centre RA, Dec, rayon et
numéro de ligne à ajouter au fichier de sortie, dans les colonnes appelées RA_CEN, DEC_CEN, RAD_CEN
et CONE_KEY, respectivement. Alternativement, le -j (joindre) le commutateur ajoutera toutes les colonnes
de la ligne de liste à la ligne de sortie (essentiellement une jointure de la ligne de liste et de la ligne d'entrée),
avec le numéro de ligne CONE_KEY. Ces deux commutateurs sont mutuellement exclusifs.

La -X ainsi que -J les commutateurs écrivent les mêmes données que leurs homologues en minuscules pour chaque
ligne satisfaisant une recherche de cône. De plus, ces commutateurs écrivent également des lignes à partir du
fichier d'événements qui ne satisfont à aucune recherche de cône. Dans de tels cas, cette colonne CONE_KEY sera
une valeur de -1 et les informations de position centrale et de liste seront mises à zéro
pour la ligne donnée. Ainsi, toutes les lignes du fichier d'événements d'entrée sont garanties d'être sorties,
avec des rangées satisfaisant au moins une recherche de cône ayant des informations de recherche supplémentaires.

La -L l'interrupteur agit de la même manière que le -l commutateur en ce sens qu'il prend les centres d'un fichier de liste.
Cependant, il définit également implicitement le commutateur -j, de sorte que les lignes de sortie sont la jointure du
la ligne d'événement d'entrée et la ligne de position centrale. De plus, ce commutateur écrit également tous les
lignes de position centrale pour lesquelles aucun événement ne satisfait les critères de recherche de cône de cette ligne.
La colonne CONE_KEY recevra une valeur de -2 pour les lignes centrales qui n'étaient proches d'aucune
ligne de données et les colonnes d'événements seront mises à zéro pour ces lignes. Ainsi, tous les centres
les lignes sont garanties d'être sorties au moins une fois.

Si l'un des commutateurs "toutes les lignes" (-X, -Jou -L) sont spécifiés, puis une nouvelle colonne nommée JSTAT
est ajouté à la table de sortie. Les valeurs positives dans cette colonne indiquent le centre
positionner le numéro de ligne (à partir de 1) dans le fichier de liste que cette ligne de données a réussi
correspond dans une recherche de cône. Une valeur de -1 signifie que la ligne de données ne correspond à aucun centre
position. Une valeur de -2 signifie que la position centrale ne correspond à aucune ligne de données.

Étant donné une position centrale et un rayon, l'algorithme de recherche de cône calcule les paramètres de limite
pour une boîte englobant le cône spécifié, et ne teste que les lignes dont les valeurs de position se situent
dans ces limites. Pour les petits fichiers, la surcharge associée à cette limite de cône
le filtrage peut entraîner une exécution plus lente du programme que si tous les événements étaient testés. Vous pouvez
désactiver le filtrage de limite de cône à l'aide de la -n commutateur pour voir si cela accélère le traitement
(particulièrement utile lors du traitement d'une grande liste de positions).

Par exemple, la recherche de cône par défaut utilise les colonnes "RA" et "Dec" en heures et en degrés
(respectivement) et position RA en heures, Dec et rayon en degrés :

funone in.fits out.fits 23.45 34.56 0.01

Pour spécifier la position RA en degrés :

funcone in.fits out.fits 23.45d 34.56 0.01

Pour obtenir RA et Dec à partir d'une liste mais utilisez une valeur statique pour le rayon (et écrivez également
informations d'identification pour chaque ligne de la liste):

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

Colonnes spécifiées par l'utilisateur en degrés, position RA en heures (notation sexagésimale), décembre
position en degrés (notation sexagésimale) et rayon en minutes d'arc :

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

Utilisez funcone en ligne en utilisant les services onworks.net