funjoin - Online na nuvem

PROGRAMA:

NOME

funjoin - junta duas ou mais tabelas binárias FITS em colunas especificadas

SINOPSE

diversão [comuta] ...

OPÇÕES

-a cols # colunas para ativar em todos os arquivos
-a1 cols ... an cols # colunas para ativar em cada arquivo
-b 'c1: bvl, c2: bv2' # valores em branco para colunas comuns em todos os arquivos
-bn 'c1: bv1, c2: bv2' # valores em branco para colunas em arquivos específicos
-j col # coluna para juntar em todos os arquivos
-j1 col ... jn col # coluna para juntar em cada arquivo
-m min # min corresponde à saída de uma linha
-M max # max corresponde para gerar uma linha
-s # adiciona a coluna de status 'jfiles'
-S col # add col como coluna de status
-t tol # tolerância para juntar colunas numéricas [2 arquivos apenas]

DESCRIÇÃO

diversão junta linhas de dois ou mais (até 32) arquivos de tabela binária FITS, com base no
valores de colunas de junção especificadas em cada arquivo. NB: as colunas de junção devem ter um índice
arquivo associado a ele. Esses arquivos são gerados usando o índice de diversão .

O primeiro argumento para o programa especifica a primeira tabela FITS de entrada ou arquivo de evento bruto.
Se "stdin" for especificado, os dados serão lidos da entrada padrão. Argumentos subsequentes
especifique arquivos de eventos adicionais e tabelas para ingressar. O último argumento é o FITS de saída
arquivo.

NB: Faça não usar Funtools Bracket Notation para especificar extensões FITS e filtros de linha quando
executando o funjoin ou você obterá resultados errados. As linhas são acessadas e unidas usando o
indexe arquivos diretamente, e isso ignora toda a filtragem.

As colunas de junção são especificadas usando o -j col switch (que especifica um nome de coluna para
usar para todos os arquivos) ou com -j1 col1, -j2 col2, ... -JN coln interruptores (que especificam um
nome da coluna a ser usado para cada arquivo). Uma coluna de junção deve ser especificada para cada arquivo. Se ambos
-j col e -JN coln são especificados para um determinado arquivo, então o último é usado. Colunas de junção
deve ser do tipo string ou numérico; é ilegal misturar numérico e string
colunas em uma determinada junção. Por exemplo, para juntar três arquivos usando a mesma coluna-chave para
cada arquivo, use:

funjoin -j tecla in1.fits in2.fits in3.fits out.fits

Uma chave diferente pode ser especificada para o terceiro arquivo desta maneira:

funjoin -j key -j3 otherkey in1.encaixa 2.encaixa 3.encaixa fora.encaixa

A -a "cols" mudar (e .A1 "col1", .A2 "cols2" contrapartes) podem ser usados ​​para especificar
colunas para ativar (ou seja, gravar no arquivo de saída) para cada arquivo de entrada. Por padrão, todos
colunas são geradas.

Se duas ou mais colunas de arquivos separados têm o mesmo nome, o segundo (e subsequentes)
colunas são renomeadas para ter um sublinhado e um valor numérico anexado.

A -m minutos e -M max opções especificam o número mínimo e máximo de junções necessárias para
escreva uma linha. O mínimo padrão é 0 junções (ou seja, todas as linhas são gravadas) e o
o máximo padrão é 63 (o número máximo de junções possíveis com um limite de 32 entradas
arquivos). Por exemplo, para escrever apenas as linhas em que exatamente dois arquivos têm colunas
aquela correspondência (ou seja, uma junção):

funjoin -j tecla -m 1 -M 1 in1.fits in2.fits in3.fits ... out.fits

Uma determinada linha pode ter o número necessário de junções sem que todos os arquivos sejam juntados
(por exemplo, três arquivos estão sendo unidos, mas apenas dois têm um determinado valor de chave de união). Nisso
caso, todas as colunas do arquivo não unido são gravadas, por padrão, usando espaços em branco
(zeros ou NULLs). o -b c1: bv1, c2: bv2 e -b1 'c1: bv1, c2: bv2' -b2 'c1: bv1, c2 - bv2' ...
as opções podem ser usadas para definir o valor em branco para colunas comuns a todos os arquivos e / ou colunas
em um arquivo especificado, respectivamente. Cada string de valor em branco contém uma lista separada por vírgulas
de coluna: especificadores de valor em branco. Para valores de ponto flutuante (simples ou duplo), um caso-
valor de string insensível de "nan" significa que o IEEE NaN (não-um-número) deve ser usado.
Assim, por exemplo:

funjoin -b "AKEY: ???" -b1 "A: -1" -b3 "G: NaN, E: -1, F: -100" ...

significa que uma coluna AKEY não associada em qualquer arquivo conterá a string "???", o
unido Uma coluna do arquivo 1 conterá um valor de -1, a coluna G não unida do arquivo 3
conterá NaNs IEEE, enquanto as colunas E e F não unidas do mesmo arquivo conterão
valores -1 e -100, respectivamente. Claro, onde os valores em branco comuns e específicos são
especificado para a mesma coluna, o valor em branco específico é usado.

Para distinguir quais arquivos são componentes não vazios de uma determinada linha, o -s (estado) interruptor
pode ser usado para adicionar uma coluna de bitmask chamada "JFILES" ao arquivo de saída. Nesta coluna, um
bit é definido para cada arquivo não vazio que compõe a linha dada, com o bit 0 corresponde ao
primeiro arquivo, bit 1 para o segundo arquivo e assim por diante. Os próprios nomes dos arquivos são armazenados em
o cabeçalho FITS como parâmetros nomeados JFILE1, JFILE2, etc. -S col interruptor permite que você
altere o nome da coluna de status do padrão "JFILES".

Uma junção entre linhas é o produto cartesiano de todas as linhas em um arquivo com uma determinada junção
valor da coluna com todas as linhas em um segundo arquivo tendo o mesmo valor para sua coluna de junção e
em breve. Assim, se o arquivo1 tiver 2 linhas com valor de coluna de junção 100, o arquivo2 terá 3 linhas com o
mesmo valor, e o arquivo3 tem 4 linhas, então a junção resulta em 2 * 3 * 4 = 24 linhas sendo geradas.

O algoritmo de junção processa diretamente o arquivo de índice associado à coluna de junção de
cada arquivo. O menor valor de todas as colunas atuais é selecionado como base, e este
valor é usado para unir colunas de valores iguais nos outros arquivos. Desta forma, o índice
os arquivos são percorridos exatamente uma vez.

A -t tol switch especifica um valor de tolerância para colunas numéricas. No momento, um
o valor de tolerância pode unir apenas dois arquivos por vez. (Um algoritmo completamente diferente é
necessário para juntar mais de dois arquivos usando uma tolerância, algo que podemos considerar
implementação no futuro.)

O exemplo a seguir mostra muitos dos recursos do funjoin. Os arquivos de entrada t1.fits,
t2.fits e t3.fits contêm as seguintes colunas:

[sh] fundisp t1.fits
AKEY KEY AB
----------- ------ ------ ------
aaaa 0 0 1
bb 1 3 4
ccc 2 6 7
dd 3 9 10
eee 4 12 13
aff 5 15 16
ggg 6 18 19
ahhh 7 21 22

fundisp t2.fits
CD AKEY KEY
----------- ------ ------ ------
iii 8 24 25
ggg 6 18 19
eee 4 12 13
ccc 2 6 7
aaaa 0 0 1

fundisp t3.fits
AKEY KEY EFG ------------ ------ -------- --------
-----------
ggg 6 18 19 100.10
jjj 9 27 28 200.20
aaa 0 0 1 300.30
ddd 3 9 10 400.40

Dados esses arquivos de entrada, o seguinte comando funjoin:

funjoin -s -a1 "-B" -a2 "-D" -a3 "-E" -b \
"UMA CHAVE:???" -b1 "AKEY: XXX, A: 255" -b3 "G: NaN, E: -1, F: -100" \
-j tecla t1.fits t2.fits t3.fits foo.fits

irá juntar os arquivos na coluna KEY, gerando todas as colunas exceto B (em t1.fits), D (em
t2.fits) e E (em t3.fits), e definindo valores em branco para AKEY (globalmente, mas substituído
para t1.fits) e A (no arquivo 1) e G, E e F (no arquivo 3). Uma coluna JFILES será
saída para sinalizar quais arquivos foram usados ​​em cada linha:

AKEY KEY A AKEY_2 KEY_2 C AKEY_3 KEY_3 FG JFILES
------------ ------ ------ ------------ ------ ------ - ---------- ------ -------- ----------- --------
aaa 0 0 aaa 0 0 aaa 0 1 300.30 7
bbb 1 3 ??? 0 0 ??? 0 -100 nan 1
ccc 2 6 ccc 2 6 ??? 0 -100 nan 3
ddd 3 9 ??? 0 0 ddd 3 10 400.40 5
eee 4 12 eee 4 12 ??? 0 -100 nan 3
aff 5 15 ??? 0 0 ??? 0 -100 nan 1
ggg 6 18 ggg 6 18 ggg 6 19 100.10 7
ahhh 7 21 ??? 0 0 ??? 0 -100 nan 1
XXX 0 255 iii 8 24 ??? 0 -100 nan 2
XXX 0 255 ??? 0 0 jjj 9 28 200.20 4

Use funjoin online usando serviços onworks.net