fundisp - Online na nuvem

PROGRAMA:

NOME

fundisp - exibe dados em um arquivo de dados Funtools

SINOPSE

fundo [-f formato] [-l] [-n] [-T] [colunas⎪bitpix = n]

OPÇÕES

-f # string de formato para exibição
-l # exibe a imagem como uma lista contendo as colunas X, Y, VAL
-n # não produz cabeçalho
-F [c] # usa o caractere especificado como separador de coluna (def: espaço)
-T # saída no formato rdb / starbase (separadores de tabulação)

DESCRIÇÃO

fundo exibe os dados na extensão FITS especificada e / ou seção de imagem de um FITS
ou em uma seção de um array não FITS ou arquivo de evento bruto.

O primeiro argumento para o programa especifica a imagem de entrada FITS, matriz ou arquivo de evento bruto
mostrar. Se "stdin" for especificado, os dados serão lidos da entrada padrão. Use Funtools
Notação de colchetes para especificar extensões FITS, seções de imagem e filtros.

Se os dados exibidos forem colunas (em uma tabela binária FITS ou em um evento bruto
arquivo), as linhas individuais são listadas. Os filtros podem ser adicionados usando a notação de colchetes. Assim:

[sh] fundisp "test.ev [time- (int) time> .15]"
XY PHA PI TIME DX DY
------- ------- ------- --------- ---------------- ---- ------ ----------
10 8 10 8 17.1600 8.50 10.50
9 9 9 9 17.1600 9.50 9.50
10 9 10 9 18.1600 9.50 10.50
10 9 10 9 18.1700 9.50 10.50
8 10 8 10 17.1600 10.50 8.50
9 10 9 10 18.1600 10.50 9.50
9 10 9 10 18.1700 10.50 9.50
10 10 10 10 19.1600 10.50 10.50
10 10 10 10 19.1700 10.50 10.50
10 10 10 10 19.1800 10.50 10.50

[NB: O arquivo de teste da tabela binária FITS test.ev, bem como a imagem test.fits FITS, são
contido no diretório funtools funtest.]

Quando uma tabela está sendo exibida usando fundo, um segundo argumento opcional pode ser usado para
especifique as colunas a serem exibidas. Por exemplo:

[sh] fundisp "test.ev [time- (int) time> =. 99]" ​​"xy time"
XY TIME
-------- -------- ----------
5 -6 40.99000000
4 -5 59.99000000
-1 0 154.99000000
-2 1 168.99000000
-3 2 183.99000000
-4 3 199.99000000
-5 4 216.99000000
-6 5 234.99000000
-7 6 253.99000000

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

[sh $] fundisp "test.ev [tempo- (int) tempo> =. 99 && annulus (0 0 0 10 n = 3)]" 'xy tempo $ REGION'
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 exibidos.

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

[sh $] fundisp "test.ev [time- (int) time> =. 99]" ​​"-time"
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 exibidas.

A coluna especial $N pode ser especificado para exibir o valor ordinal de cada linha. Assim,
continuando o exemplo anterior:

fundisp "test.ev [time- (int) time> =. 99]" ​​'-time $ n'
XY PHA PI DX DY N
------- -------- -------- ---------- ----------- ------ ----- ----------
5 -6 5 -6 5.50 -6.50 337
4 -5 4 -5 4.50 -5.50 356
-1 0 -1 0 -1.50 0.50 451
-2 1 -2 1 -2.50 1.50 465
-3 2 -3 2 -3.50 2.50 480
-4 3 -4 3 -4.50 3.50 496
-5 4 -5 4 -5.50 4.50 513
-6 5 -6 5 -6.50 5.50 531
-7 6 -7 6 -7.50 6.50 550

Observe que a especificação da coluna está entre aspas simples para proteger '$ n' desde o início
expandido pela casca.

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.

Se os dados exibidos forem dados de imagem (em uma imagem FITS primária, uma imagem FITS
extensão, ou um arquivo de matriz), uma exibição de pixel mxn é produzida, onde m e n são os
dimensões da imagem. Por padrão, os valores de pixel são exibidos usando o mesmo tipo de dados
como no arquivo. No entanto, para dados inteiros onde os parâmetros de cabeçalho BSCALE e BZERO são
presente, os dados são exibidos como flutuantes. Em qualquer caso, o tipo de dados de exibição pode ser
substituído usando um segundo argumento opcional do formulário:

bitpix = n

onde n é 8,16,32, -32, -64, para unsigned char, short, int, float e double, respectivamente.

Claro, correndo fundo em qualquer coisa que não seja a menor imagem geralmente resulta em uma exibição
cujo tamanho o torna ilegível. Portanto, pode-se usar a notação de colchetes (veja abaixo) para
aplique seção e / ou bloqueio à imagem antes de gerar uma exibição. Por exemplo:

[sh] fundisp "test.fits [2: 6,2: 7]" bitpix = -32
2 3 4 5 6
---------- ---------- ---------- ---------- ----------
2: 3.00 4.00 5.00 6.00 7.00
3: 4.00 5.00 6.00 7.00 8.00
4: 5.00 6.00 7.00 8.00 9.00
5: 6.00 7.00 8.00 9.00 10.00
6: 7.00 8.00 9.00 10.00 11.00
7: 8.00 9.00 10.00 11.00 12.00

Observe que é possível exibir uma tabela binária FITS como uma imagem simplesmente passando o
mesa através imagem divertida primeiro:

[sh] ./funimage test.ev stdout ⎪ fundisp "stdin [2: 6,2: 7]" bitpix = 8
2 3 4 5 6
------- ------- ------- ------- -------
2: 3 4 5 6 7
3: 4 5 6 7 8
4: 5 6 7 8 9
5: 6 7 8 9 10
6: 7 8 9 10 11
7: 8 9 10 11 12

Se o -l (lista) é usado, então uma imagem é exibida como uma lista contendo o
colunas: X, Y, VAL. Por exemplo:

fundisp -l "test1.fits [2: 6,2: 7]" bitpix = -32
XY VAL
---------- ---------- -----------
2 2 6.00
3 2 1.00
4 2 1.00
5 2 1.00
6 2 1.00
2 3 1.00
3 3 5.00
4 3 1.00
5 3 1.00
6 3 1.00
2 4 1.00
3 4 1.00
4 4 4.00
5 4 1.00
6 4 1.00
2 5 1.00
3 5 1.00
4 5 1.00
5 5 3.00
6 5 1.00
2 6 1.00
3 6 1.00
4 6 1.00
5 6 1.00
6 6 2.00
2 7 1.00
3 7 1.00
4 7 1.00
5 7 1.00
6 7 1.00

Se o -n (nohead) switch é usado, então nenhum cabeçalho é gerado para as tabelas. Isso é útil,
por exemplo, quando a saída do fundisp está sendo direcionada para o gnuplot.

A fundo programa usa um conjunto padrão de formatos de exibição:

formato TFORM de tipo de dados
-------- ----- --------
duplo D "% 21.8f"
float E "% 11.2f"
int J "% 10d"
curto I "% 8d"
byte B "% 6d"
string A "% 12.12s"
bits X "% 8x"
L lógico "% 1x"

Assim, a exibição padrão de 1 duplo e 2 shorts fornece:

[sh] fundisp snr.ev "tempo xy"

TEMPO XY
---------- -------- --------
79494546.56818075 546 201
79488769.94469175 548 201
...

Você pode alterar o formato de exibição de colunas individuais ou de todas as colunas de um determinado
tipos de dados por meio da opção -f. A string de formato que acompanha -f é um espaço-
lista delimitada de valores de palavra-chave = formato. Os valores de palavra-chave podem ser nomes de coluna
(neste caso, o formato associado pertence apenas a essa coluna) ou tabela FITS TFORM
especificadores (neste caso, o formato pertence a todas as colunas com esse tipo de dados). Para
Por exemplo, você pode alterar os formatos duplo e curto para todas as colunas como este:

[sh] fundisp -f "D =% 22.11f I =% 3d" snr.ev "tempo xy"

TEMPO XY
------------- --- ---
79494546.56818075478 546 201
79488769.94469174743 548 201
...

Como alternativa, você pode alterar o formato das colunas de hora e x assim:

[sh] fundisp -f "tempo =% 22.11fx =% 3d" snr.ev "tempo xy"

TEMPO XY
------------- --- --------
79494546.56818075478 546 201
79488769.94469174743 548 201
...

Observe que há um conflito potencial se uma coluna tiver o mesmo nome de um dos TFORM
especificadores. Nos exemplos acima, a coluna "X" da tabela tem o mesmo nome que
o tipo de dados X (bit). Para resolver esse conflito, a string de formato é processada de forma que
Os especificadores de tipo de dados TFORM são verificados primeiro, usando uma comparação que diferencia maiúsculas de minúsculas. Se o
o valor do formato especificado não é um valor TFORM em maiúsculas, então uma verificação que não diferencia maiúsculas de minúsculas é
feito no nome da coluna. Isso significa que, nos exemplos acima, "X =% 3d" se referirá a
o tipo de dados X (bit), enquanto "x =% 3d" se referirá à coluna X:

[sh] fundisp -f "X =% 3d" snr.ev "xy"

XY
-------- --------
546 201
548 201
...

[sh] fundisp -f "x =% 3d" snr.ev "xy"

XY
--- --------
546 201
548 201
...

Como regra, portanto, é melhor sempre especificar o nome da coluna em letras minúsculas e TFORM
tipos de dados em maiúsculas.

A -f [formato] mudará o formato para uma única execução do fundisp. Você também pode usar
que o FUN_FORMAT variável de ambiente para alterar o formato de todas as invocações de fundisp.
O formato do valor desta variável de ambiente é idêntico ao usado com o -f
trocar. Este valor global pode ser substituído em casos individuais pelo uso do -f [formato]
interruptor.

Advertências: Observe também que é responsabilidade do usuário combinar o formato
especificador para o tipo de dados da coluna corretamente. Observe também que, a fim de manter o visual
alinhamento entre nomes e colunas, o nome da coluna será truncado (à esquerda) se
a largura do formato é menor que o comprimento do nome. No entanto, o truncamento não é executado
se a saída estiver no formato RDB (usando a opção -T).

[Uma string de formato de estilo mais antigo é compatível, mas está obsoleta. Consiste em delimitado por espaço
Instruções de formato C para todos os tipos de dados, especificados na seguinte ordem:

double float int bit de string de byte curto.

Esta ordem da lista é baseada no pressuposto de que as pessoas geralmente desejam
alterar os formatos flutuantes.

Se "-" for inserido em vez de uma instrução de formato para um determinado tipo de dados, o formato padrão
é usado. Além disso, a string de formato pode ser encerrada sem especificar todos os formatos, e
os padrões serão usados ​​para o resto da lista. Observe que você deve fornecer um campo mínimo
largura, ou seja, "% 6d" e "% -6d" são legais, "% d" não é legal.

Usando -f [formato], você pode alterar os formatos duplo e curto como este:

[sh] fundisp -f "22.11f - - 3d" snr.ev "tempo xy"

TEMPO XY
------------- --- ---
79494546.56818075478 546 201
79488769.94469174743 548 201
...

NB: este formato está obsoleto e será removido em uma versão futura.]

A -F [c] switch pode ser usado para especificar um separador de coluna (caractere único) (onde o
o padrão é um espaço). Observe que a formatação da coluna quase certamente também adicionará espaços para
preencher colunas individuais com a largura necessária. Eles podem ser removidos com um programa como
sed, ao custo de gerar colunas não alinhadas. Por exemplo:

fundisp -F ',' snr.ev '[cir 512 512 .1]'
X, Y, PHA, PI, TEMPO, DX, DY
512, 512, 6, 7, 79493997.45854475, 578, 574
512, 512, 8, 9, 79494575.58943175, 579, 573
512, 512, 5, 6, 79493631.03866175, 578, 575
512, 512, 5, 5, 79493290.86521725, 578, 575
512, 512, 8, 9, 79493432.00990875, 579, 573

fundisp -F ',' snr.ev '[cir 512 512 .1]' ⎪ sed 's / *, * /, / g'
X, Y, PHA, PI, TIME, DX, DY
512,512,6,7,79493997.45854475,578,574
512,512,8,9,79494575.58943175,579,573
512,512,5,6,79493631.03866175,578,575
512,512,5,5,79493290.86521725,578,575
512,512,8,9,79493432.00990875,579,573

fundisp -f "x =% 3d y =% 3d pi =% 1d pha =% 1d tempo =% 20.11f dx =% 3d dy =% 3d" -F ',' snr.ev '[cir 512
512 .1] '⎪ sed' s / *, * /, / g '
X, Y, A, I, TIME, DX, DY ---, ---, -, -, --------------------, ---, ---
512,512,6,7,79493997.45854474604,578,574 512,512,8,9,79494575.58943174779,579,573
512,512,5,6,79493631.03866174817,578,575 512,512,5,5,79493290.86521725357,578,575
512,512,8,9,79493432.00990875065,579,573

Se o -T (tabela rdb) for usado, a saída será conforme a base de dados starbase / rdb
formato: tabulações serão inseridas entre colunas em vez de espaços. Este formato não é
disponível ao exibir pixels de imagem (exceto em conjunto com o -l trocar).

Finalmente, observe que fundo pode ser usado para criar filtros de coluna das tabelas auxiliares
em um arquivo FITS. Por exemplo, o seguinte código de shell irá gerar um bom intervalo de tempo
Filtro (GTI) para arquivos de dados de raios-X que contêm uma extensão GTI padrão:

#!/ Bin / sh
sed '1, / ----. * / d
/ ^ $ /, $ d '⎪ awk' tot> 0 {printf "⎪⎪"}; {printf "time =" $ 1 ":" $ 2; tot ++} '

Se este script for colocado em um arquivo chamado "mkgti", ele pode ser usado em um comando como:

fundisp foo.fits "[GTI]" ⎪ mkgti> gti.filter

O arquivo de filtro resultante pode então ser usado em vários programas Funtools:

funcnts foo.fits "[@ gti.filter]" ...

para processar apenas os eventos nos intervalos de tempo bom.

Use fundisp online usando serviços onworks.net