funtable - Online na nuvem

PROGRAMA:

NOME

funtable - copia as linhas selecionadas de um arquivo Funtools para uma tabela binária FITS

SINOPSE

divertida [-a] [-i⎪-z] [-m] [-s cols] [colunas]

OPÇÕES

-a # anexa ao arquivo de saída existente como uma extensão de tabela
-i # para dados de imagem, gerar apenas colunas X e Y
-m # para tabelas, escreve um arquivo separado para cada região
-s "col1 ..." # colunas nas quais classificar
-z # para dados de imagem, saída de pixels com valor zero

DESCRIÇÃO

divertida seleciona linhas da extensão FITS especificada (apenas tabela binária) de um FITS
arquivo ou de um arquivo de evento bruto não FITS e grava essas linhas em uma tabela binária FITS
Arquivo. Ele também criará uma tabela binária FITS a partir de uma imagem ou de um arquivo de array bruto.

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. Por padrão, todas as colunas do arquivo de entrada são copiadas para o arquivo de saída.
As colunas selecionadas podem ser geradas usando um terceiro argumento opcional na forma:

"coluna1 coluna1 ... colunaN"

A divertida programa geralmente é usado para selecionar linhas de uma tabela binária FITS usando Tabela
Filtros e / ou Filtros de região espacial. Por exemplo, você pode copiar apenas as linhas selecionadas (e
produza apenas colunas selecionadas) executando em um comando como:

[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

A coluna especial $ REGION pode ser especificado para escrever o id da região de cada linha:

[sh $] funtable "test.ev [time- (int) time> =. 99 && annulus (0 0 0 10 n = 3)]" stdout 'xy time $ REGION' ⎪ fundisp stdin
REGIÃO DO TEMPO XY
-------- -------- ---------- ----------
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

Aqui, apenas as linhas com o tempo fracionário adequado e cuja posição também está dentro de um dos
os três anulares são escritos.

As colunas podem ser excluídas da exibição usando um sinal de menos antes da coluna:

[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

Todas as colunas, exceto a coluna de tempo, são gravadas.

Em geral, as regras para ativar e desativar colunas são:

· Se apenas as colunas de exclusão forem especificadas, todas as colunas, exceto as colunas de exclusão
ser ativado.

· Se apenas incluir colunas forem especificadas, apenas as colunas especificadas serão ativadas.

· Se uma mistura de colunas de inclusão e exclusão for especificada, todas, exceto a de exclusão
as colunas estarão ativas; este último caso é ambíguo e a regra é arbitrária.

Além de especificar os nomes das colunas explicitamente, os símbolos especiais + e - pode ser
usado para ativar e desativar todos os colunas. Isso é útil se você deseja ativar o
Coluna $ REGION junto com todas as outras colunas. De acordo com as regras, a sintaxe "$ REGION"
apenas ativa a coluna da região e desativa o resto. Use "+ $ REGION" para ativar
todas as colunas, bem como a coluna da região.

Normalmente, apenas a tabela selecionada é copiada para o arquivo de saída. Em uma tabela binária FITS,
às vezes é desejável copiar todas as outras extensões FITS para o arquivo de saída como
Nós vamos. Isso pode ser feito anexando um sinal '+' ao nome da extensão na entrada
nome do arquivo. Por exemplo, o primeiro comando abaixo copia apenas a tabela EVENTO, enquanto o
O segundo comando também copia outras extensões:

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

Se o arquivo de entrada for uma imagem ou um arquivo de array bruto, então divertida irá gerar um FITS
tabela binária dos valores de pixel na imagem. Observe que não é possível especificar
as colunas de saída (usando o argumento 3 da linha de comando). Em vez disso, existem duas maneiras de
crie essa tabela binária a partir de uma imagem. Por padrão, uma tabela de 3 colunas é gerada, onde
as colunas são "X", "Y" e "VALOR". Para cada pixel da imagem, uma única linha (evento)
é gerado com as colunas "X" e "Y" atribuídas aos valores dim1 e dim2 da imagem
pixel, respectivamente, e a coluna "VALUE" atribuiu o valor do pixel. Com uma espécie de
mesa, corrida funista na coluna "VALUE" dará os mesmos resultados que em execução funista
na imagem original.

Se o -i (linhas "individuais") for especificado, então apenas as colunas "X" e "Y" são
gerado. Neste caso, cada valor de pixel positivo na imagem gera n linhas (eventos),
onde n é igual ao valor integerizado desse pixel (mais 0.5, para ponto flutuante
dados). Com efeito, -i recria aproximadamente as linhas de uma tabela que teria sido
bin na imagem de entrada. (Claro, isso é apenas aproximadamente correto, uma vez que o
as posições x, y resultantes são integerizadas.)

Se o -s [col1 col2 ... coluna] ("sort") switch é especificado, as linhas de saída de um binário
a tabela será classificada usando as colunas especificadas como chaves de classificação. As chaves de classificação devem ser
colunas escalares e também deve fazer parte do arquivo de saída (ou seja, você não pode classificar em uma coluna
mas não incluí-lo na saída). Esta instalação usa o _ordenar programa (incluído com
funtools), que deve ser acessível através do seu caminho.

Para tabelas binárias, o -m ("vários arquivos") irá gerar um arquivo separado para cada
região na especificação do filtro, ou seja, cada arquivo contém apenas as linhas dessa região.
As linhas que passam pelo filtro, mas não estão em nenhuma região, também são colocadas em um arquivo separado.

Os nomes de arquivo de saída separados gerados pelo -m switch são produzidos automaticamente a partir de
o arquivo de saída raiz para conter o ID da região da região associada. (Observe que região
ids começam em 1, de modo que o nome do arquivo associado com id 0 contém linhas que passam o
filtrar, mas não estão em uma determinada região.) Os nomes dos arquivos de saída são gerados da seguinte maneira:

· Uma especificação $ n pode ser usada em qualquer lugar no nome do arquivo raiz (adequadamente citado para
protegê-lo do shell) e será expandido para ser o número de id do associado
região. Por exemplo:

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

irá gerar arquivos chamados foo.goo_0.fits (para linhas que não estão em qualquer região, mas ainda passando
o filtro), foo.goo_1.fits (linhas na região id # 1, a primeira região), foo.goo_2.fits
(linhas na região id # 2), etc. Observe que as aspas simples na raiz de saída são necessárias
para proteger o '$' do shell.

· Se $ n não for especificado, o id da região será colocado antes do primeiro ponto (.) Em
o nome do arquivo. Assim:

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

irá gerar arquivos chamados foo0.evt.fits (para linhas que não estão em qualquer região, mas ainda passando
o filtro), foo1.evt.fits (linhas na região id # 1), foo2.evt.fits (linhas na região id
# 2), etc.

· Se nenhum ponto for especificado no nome do arquivo de saída raiz, o id da região será
anexado ao nome do arquivo. Assim:

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

irá gerar arquivos chamados foo_evt0 (para linhas que não estão em qualquer região, mas ainda passando o
filtro), foo_evt1 (linhas na região id # 1), foo_evt2 (linhas na região id # 2), etc.

O mecanismo de vários arquivos fornece uma maneira simples de gerar arquivos de dados de origem individuais
com uma única passagem pelos dados.

Por padrão, um novo arquivo FITS é criado e a tabela binária é gravada no primeiro
extensão. Se o -a (anexar) switch é especificado, a tabela é anexada a um existente
Arquivo FITS como uma extensão BINTABLE. Observe que o arquivo FITS de saída já deve existir.

Se o -z (valores de pixel "zero") switch é especificado e -i não é especificado, então pixels
tendo um valor zero será emitido com sua coluna "VALUE" definida como zero. Obviamente, este
switch não faz sentido quando eventos individuais são produzidos.

Use funtable online usando serviços onworks.net