mImgtbl - Online na nuvem

PROGRAMA:

NOME

mImgtbl - Gera metadados de um conjunto de imagens FITS

SINOPSE

mImgtbl [-rcadb] [-s arquivo de status] [-f arquivo de lista de campos] [-t imglista] diretório images.tbl

DESCRIÇÃO

mImgtbl extrai as informações de geometria do cabeçalho FITS de um conjunto de arquivos e cria um
Tabela de metadados de imagem ASCII que é usada por vários outros programas. É só
coleta dados de cabeçalhos que estão em conformidade com o padrão FITS, mas relata uma contagem de
imagens que falham nessa verificação.

OPÇÕES

-r mImgtbl também pode ser usado como um programa autônomo para coletar metadados de imagem para outros
finalidades (para preencher um banco de dados, como base para pesquisas de cobertura espacial, etc.)
Neste caso, muitas vezes é desejável coletar informações sobre todos os arquivos em um
árvore de diretórios recursivamente. O sinalizador "-r" (recursivo) instrui mImgtbl procurar
o diretório fornecido e todos os seus subdiretórios recursivamente.

-c A opção "-c" (cantos) em mImgtbl fará com que oito colunas extras sejam adicionadas ao
a tabela de metadados de saída contendo as coordenadas RA, Dec (ra1, dec1, ... ra4,
dec4) dos cantos da imagem. A saída é sempre Equatorial J2000, mesmo se o
entrada é algum outro sistema. Embora não seja necessário para os módulos principais de processamento, nós
recomendo usar esta opção, pois alguns dos utilitários podem exigir locais de canto
para funcionar corretamente.

-C A versão original do mImgtbl ignorou a estrutura do cubo nos arquivos; só parecia
nas primeiras duas dimensões e parâmetros WCS associados. Quando o cubo é processado
foi adicionado à montagem, foi necessário examinar a terceira e a quarta dimensões
(se existirem) e, portanto, algumas colunas adicionais foram adicionadas à saída mImgtbl
(por exemplo, NAXIS4, CRVAL3). Ainda é frequentemente o caso em que todas as novas colunas
ficaria em branco, para economizar espaço, a saída do modo antigo pode ser chamada usando o "-C"
opção (sem cubo). Isso é cosmético na maior parte, uma vez que o "quadridimensional"
a saída é perfeitamente válida para processamento posterior de dados 2D.

-a Por padrão, mImgtbl ignora arquivos FITS com nomes que terminam em _área (isto é,
nome_area.fits), supondo que sejam imagens de área criadas por montagem. Se você quiser
gerar informações sobre essas imagens, ou se você tiver imagens com _área no título
de outros do que aqueles gerados pelo Montage, você deve ativar este sinalizador para forçar
mImgtbl para ver todas as imagens no diretório.

-d Ativar depuração

-b Quando esta opção é definida, mImgtbl irá mostrar explicitamente cada arquivo FITS que encontrar
que não parece ser válido, junto com informações sobre o erro.

-s arquivo de status
A saída e os erros são gravados em arquivo de status em vez de ser escrito para stdout.

-f arquivo de lista de campos
Usado para especificar um lista de campos, que listará palavras-chave adicionais a serem lidas
os cabeçalhos FITS e incluídos na tabela de saída. As listas de campos devem especificar o
nome da palavra-chave, tipo (int, char, double) e tamanho. Exemplo: example.fieldlist.

-t imglista
mImgtbl irá processar apenas arquivos com nomes especificados na tabela imglista, ignorando qualquer
outros arquivos no diretório. Exemplo: example.imglist.

ARGUMENTOS

anuário
Caminho para o diretório que contém o conjunto de arquivos FITS de entrada.

imagens.tbl
Caminho da tabela de metadados de saída.

RESULTADO

A tabela de saída contém informações de metadados de todos os arquivos FITS legíveis no diretório
especificado por anuário. contar é o número de registros na tabela, e roupas ruins é o
número de arquivos para os quais os metadados FITS não puderam ser extraídos.

SAÍDA COLUNAS

cntr Um contador único (número da linha)

ra, dec Posição da imagem no formato de graus decimais

cra, cdec
Ascensão reta no formato HHMMSS.SS. Declinação no formato DDMMSS.S

naxis1, naxis2
O tamanho da imagem em pixels para as dimensões 1 e 2

tipo1, tipo2
O sistema de coordenadas (os primeiros quatro caracteres) e a projeção do mapa WCS (último
três caracteres) para dimensões 1 e 2

crpix1, crpix2
As coordenadas de pixel da localização de referência (podem ser fracionárias e podem estar desligadas
a imagem) para as dimensões 1 e 2

crval1, crval2
As coordenadas de um local de referência no céu (geralmente no centro do
imagem) para as dimensões 1 e 2

cdelt1, cdelt2
A escala de pixels (em graus no céu por pixel) no local de referência para
dimensões 1 e 2

crota2 O ângulo de rotação da direção "para cima" até o pólo celeste

equinócio
Ano de precessão associado ao sistema de coordenadas

hdu identificador numérico para a extensão FITS da qual as informações da imagem são extraídas,
para arquivos FITS com várias HDUs.

size Tamanho do arquivo (em bytes) do arquivo FITS de entrada

fname O caminho para o arquivo FITS de entrada

MENSAGENS

OK [struct stat = "OK", contagem =contar, roupas ruins =roupas ruins]

ERROR Argumento ilegal: -arg

ERROR Não é possível abrir o arquivo de status: arquivo de status

ERROR Não é possível abrir o arquivo da lista de campos: arquivo de lista de campos

ERROR Não é possível abrir o arquivo da lista de imagens: arquivo img

ERROR A tabela de imagens precisa da coluna fname / arquivo

ERROR Nome de campo ilegal: corda]

ERROR Tipo de campo ilegal: corda]

ERROR Não é possível acessar anuário

ERRO anuário não é um diretório

ERROR Não é possível abrir a tabela de saída.

ERROR Impossível abrir a tabela de cópia.

ERROR Impossível abrir a tabela tmp (in).

ERROR Impossível abrir a tabela tmp (out).

ERROR Não é possível abrir a mesa final.

ERRO ENCAIXA biblioteca erro

EXEMPLOS

O exemplo a seguir é executado mImgtbl em um diretório contendo 14 imagens 2MASS:

$ mImgtbl input / 2mass images.tbl
[struct stat = "OK", contagem = 14, badfits = 0]

Saída: imagens.tbl.

Corrida mImgtbl em um diretório que contém 3 imagens FITS ruins, com a opção -c ativada:

$ mImgtbl -c input / 2mass-bad images-corners.tbl
[struct stat = "OK", contagem = 14, badfits = 3]

O arquivo de saída é idêntico ao primeiro exemplo, mas com a adição de 8 "cantos"
colunas: imagens-corners.tbl. O roupas ruins contador nos relatórios de mensagem de saída sobre como
muitas imagens foram encontradas contendo informações de cabeçalho inválidas.

Quando passado um arquivo de lista de campos como este exemplo, colunas extras são extraídas do FITS
cabeçalhos e inseridos na tabela:

$ mImgtbl -f example.fieldlist input / 2mass images-extended.tbl
[struct stat = "OK", contagem = 14, badfits = 0]

O arquivo de saída possui colunas adicionais conforme especificado: images-expansion.tbl.

Use mImgtbl online usando serviços onworks.net