funcone - Online na nuvem

PROGRAMA:

NOME

funcone - pesquisa de cone de uma tabela binária contendo colunas RA, Dec

SINOPSE

função [colunas]

OPÇÕES

-d deccol: [hdr] # nome da coluna Dec, unidades (def: DEC: d)
-j # junta colunas do arquivo de lista
-J # junta colunas do arquivo de lista, produz todas as linhas
-l listfile # lê centros e raios de uma lista
-L listfile # centros de leitura e raios de uma lista, linhas de lista de saída
-n # não usa limites de cone como filtro
-r racol: [hdr] # nome da coluna RA, unidades (def: RA: h)
-x # anexar RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY cols
-X # append RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY cols, saída de todas as linhas

DESCRIÇÃO

Funcone executa uma pesquisa de cone nas colunas RA e Dec de uma tabela binária FITS. o
distância do centro RA, posição Dec para o RA, Dec em cada linha da tabela é
calculado. Linhas cuja distância é menor que o raio especificado são geradas.

O primeiro argumento para o programa especifica o arquivo FITS, arquivo de evento bruto ou array bruto
Arquivo. Se "stdin" for especificado, os dados serão lidos da entrada padrão. Use Funtools
Notação de colchetes para especificar extensões e filtros FITS. O segundo argumento é o
arquivo FITS de saída. Se "stdout" for especificado, a tabela binária FITS será gravada no
saída padrão.

O terceiro e quarto argumentos necessários são a posição central RA e Dec. Por padrão,
RA é especificado em horas enquanto Dec é especificado em graus. Você pode alterar as unidades de
qualquer um deles anexando o caractere "d" (graus), "h" (horas) ou "r" (radianos).
A notação sexagesimal é suportada, com dois pontos ou espaços separando hms e dms. (Quando
usando espaços, certifique-se de que toda a string esteja entre aspas.)

O quinto argumento necessário é o raio da busca do cone. Por padrão, o valor do raio
é dado em graus. As unidades podem ser alteradas anexando o caractere "d" (graus),
"r" (radianos), "'" (minutos de arco) ou' "'(segundos de arco).

Por padrão, todas as colunas do arquivo de entrada são copiadas para o arquivo de saída. Colunas selecionadas
pode ser gerado usando um sexto argumento opcional na forma:

"coluna1 coluna1 ... colunaN"

Um sétimo argumento permite que você produza colunas selecionadas do arquivo de lista quando -j interruptor
é usado. Observe que as colunas RA e Dec usadas no cálculo do cone não devem ser
desmarcado.

Também por padrão, os nomes das colunas RA e Dec são chamados de "RA" e "Dec", e são fornecidos em
unidades de horas e graus, respectivamente. Você pode alterar o nome e as unidades usando
os interruptores -r [RA] e / ou -d [Dec]. Mais uma vez, um de "h", "d" ou "r" é anexado a
o nome da coluna para especificar unidades, mas, neste caso, deve haver dois pontos ":" entre os
nome e a especificação da unidade.

Se o -l [arquivo de listagem] switch é usado, então um ou mais do centro RA, centro de dezembro, e
o raio pode ser obtido de um arquivo de lista (que pode ser uma tabela FITS ou um texto de coluna ASCII
Arquivo). Neste caso, o terceiro (centro RA), o quarto (centro de dezembro) e o quinto (raio)
os argumentos da linha de comando podem ser um nome de coluna no arquivo de lista (se esse parâmetro
varia) ou então um valor numérico (se esse parâmetro for estático). Quando o nome de uma coluna é
especificado para RA, Dec ou raio, você pode acrescentar dois pontos seguidos de "h", "d" ou "r"
para especificar unidades (também 'e "para raio). O algoritmo de pesquisa de cone é executado uma vez para cada
linha na lista, tomando os valores de RA, Dec e raio das colunas especificadas ou de
valores numéricos estáticos especificados na linha de comando.

Ao usar uma lista, todas as linhas válidas de cada iteração são gravadas em um único arquivo de saída.
Use o -x switch para ajudar a delinear qual linha do arquivo de lista foi usada para produzir o
dada (s) linha (s) de saída. Esta mudança faz com que os valores para o centro RA, Dec, raio e
número da linha a ser anexado ao arquivo de saída, em colunas chamadas RA_CEN, DEC_CEN, RAD_CEN
e CONE_KEY, respectivamente. Alternativamente, o -j (juntar) irá anexar todas as colunas
da linha da lista para a linha de saída (essencialmente uma junção da linha da lista e da linha de entrada),
junto com o número da linha CONE_KEY. Essas duas opções são mutuamente exclusivas.

A -X e -J interruptores gravam os mesmos dados que suas contrapartes em minúsculas para cada
linha satisfazendo uma pesquisa de cone. Além disso, essas opções também gravam linhas do
arquivo de evento que não satisfaz nenhuma pesquisa de cone. Nesses casos, essa coluna CONE_KEY irá
receber um valor de -1 e as informações de posição do centro e da lista serão definidas como zero
para a linha fornecida. Assim, todas as linhas do arquivo de evento de entrada têm a garantia de saída,
com linhas que satisfaçam pelo menos uma pesquisa de cone tendo informações de pesquisa adicionais.

A -L interruptor atua de forma semelhante ao -l alternar em que leva centros de um arquivo de lista.
No entanto, também define implicitamente a opção -j, de modo que as linhas de saída sejam a junção do
linha de evento de entrada e a linha de posição central. Além disso, essa opção também grava todos
linhas de posição central para as quais nenhum evento satisfaz os critérios de pesquisa de cone dessa linha.
A coluna CONE_KEY receberá um valor de -2 para as linhas centrais que não estavam perto de nenhum
linha de dados e as colunas de evento serão zeradas para tais linhas. Desta forma, todos os centros
as linhas têm garantia de saída pelo menos uma vez.

Se qualquer uma das opções de "todas as linhas" (-X, -Jou -L) são especificados, em seguida, uma nova coluna chamada JSTAT
é adicionado à tabela de saída. Os valores positivos nesta coluna indicam o centro
posicione o número da linha (começando em 1) no arquivo de lista em que esta linha de dados foi bem-sucedida
correspondido em uma pesquisa de cone. Um valor de -1 significa que a linha de dados não corresponde a nenhum centro
posição. Um valor de -2 significa que a posição central não foi correspondida por nenhuma linha de dados.

Dada uma posição central e raio, o algoritmo de busca de cone calcula os parâmetros de limite
para uma caixa envolvendo o cone especificado, e apenas testa as linhas cujos valores de posição estão
dentro desses limites. Para arquivos pequenos, a sobrecarga associada a este limite de cone
a filtragem pode fazer com que o programa seja executado mais lentamente do que se todos os eventos fossem testados. Você pode
desligue a filtragem de limite de cone usando o -n mude para ver se isso acelera o processamento
(especialmente útil ao processar uma grande lista de posições).

Por exemplo, a pesquisa de cone padrão usa as colunas "RA" e "Dec" em horas e graus
(respectivamente) e posição RA em horas, dezembro e raio em graus:

funone in.fits out.fits 23.45 34.56 0.01

Para especificar a posição RA em graus:

funcone in.fits out.fits 23.45d 34.56 0.01

Para obter RA e Dec de uma lista, mas use um valor estático para o raio (e também escreva
identificando informações para cada linha na lista):

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

Colunas especificadas pelo usuário em graus, posição RA em horas (notação sexagesimal), dezembro
posição em graus (notação sexagesimal) e raio em minutos de arco:

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

Use funcone online usando serviços onworks.net