funimage - Online în cloud

PROGRAM:

NUME

funimage - creați o imagine FITS dintr-un fișier de date Funtools

REZUMAT

distractiv [-A] [bitpix=n] distractiv [-l]
[bitpix=n] distractiv [-px⎪y] [bitpix=n]

OPŢIUNI

-a # atașează fișierului de ieșire existent ca extensie de imagine
-l # input este un fișier listă care conține xcol, ycol, value
-p [x⎪y] # proiectează de-a lungul axei x sau y pentru a crea o imagine 1D

DESCRIERE

distractiv creează o imagine FITS primară din extensia și/sau imaginea FITS specificate
Secțiune a unui fișier FITS sau dintr-o secțiune de imagine a unui tablou non-FITS sau dintr-un eveniment brut
fișier.

Primul argument al programului specifică imaginea de intrare FITS, matricea sau fișierul eveniment brut
a procesa. Dacă este specificat „stdin”, datele sunt citite de la intrarea standard. Utilizați Funtools
Notație pentru paranteze pentru a specifica extensiile FITS, secțiunile de imagine și filtrele. Al doilea
argumentul este fișierul FITS de ieșire. Dacă este specificat „stdout”, imaginea FITS este scrisă
ieșirea standard. În mod implicit, valorile pixelilor de ieșire sunt de același tip de date ca
cele ale fișierului de intrare (sau tastați „int” când binați un tabel), dar acest lucru poate fi suprascris
folosind un al treilea argument opțional de forma:

bitpix=n

unde n este 8,16,32,-32,-64, pentru unsigned char, short, int, float și, respectiv, double.

Dacă datele de intrare sunt de tip imagine, secțiunea corespunzătoare este extrasă și blocată
(pe baza modului în care este specificată secțiunea de imagine), iar rezultatul este scris în FITS
imaginea primară. Când o imagine întreagă care conține cuvintele cheie BSCALE și BZERO este
convertite în float, valorile pixelilor sunt scalate și cuvintele cheie de scalare sunt șterse din
antetul de ieșire. La conversia datelor scalate întregi în numere întregi (posibil dintr-un alt
dimensiune), pixelii nu sunt scalați și cuvintele cheie de scalare sunt păstrate.

Dacă datele de intrare sunt un tabel binar sau un fișier de eveniment brut, acestea sunt grupate într-o imagine,
din care o secțiune este extrasă și blocată și scrisă într-o imagine FITS primară. În
în acest caz, este necesar să se specifice cele două coloane care vor fi utilizate în binningul 2D.
Acest lucru se poate face pe linia de comandă folosind bincols=(x,y) cuvinte cheie:

funcții „foo.ev[EVENIMENTE,bincols=(detx,dety)]”

Forma completă a bincols= specificatorul este:

bincols=([xname[:tlmin[:tlmax:[binsiz]]]],[yname[:tlmin[:tlmax[:binsiz]]]])

unde specificatorii tlmin, tlmax și binsiz determină dimensiunile de separare a imaginii:

dim = (tlmax - tlmin)/binsiz (date în virgulă mobilă)
dim = (tlmax - tlmin)/binsiz + 1 (date întregi)

Folosind această sintaxă, este posibil să binați oricare două coloane ale unui tabel binar la orice bin
mărimea. Rețineți că specificatorii tlmin, tlmax și binsiz pot fi omisi dacă TLMIN, TLMAX,
și parametrii antetului TDBIN (respectiv) sunt prezenți în antetul tabelului binar FITS pentru
coloana în cauză. Rețineți, de asemenea, că dacă este specificat un singur parametru, acesta se presupune
să fie tlmax, iar tlmin este implicit 1. Dacă sunt specificați doi parametri, se presupune că aceștia sunt
fie tlmin si tlmax. Consultați Binning FITS Binary Tables și Non-FITS Event Files pentru mai multe
informații despre parametrii de binning.

În mod implicit, este creat un nou fișier imagine 2D FITS, iar imaginea este scrisă în fișierul principal
HDU. Dacă -a este specificat comutatorul (adăugați), imaginea este atașată unui FITS existent
fișier ca extensie IMAGE. (Dacă fișierul de ieșire nu există, comutatorul este efectiv
ignorat și imaginea este scrisă pe HDU primar.) Acest lucru poate fi util într-un shell
mediu de programare atunci când procesați mai multe imagini FITS în care doriți să le combinați
un singur fișier FITS final.

distractiv de asemenea, poate prelua intrare dintr-un tabel care conține coloane de x, y și valoare (de exemplu, the
ieșire de la fundisp -l care afișează fiecare imagine x și y și numărul de numărări la care
poziţia.) Când cel -l este utilizat comutatorul (listă), fișierul de intrare este considerat FITS sau
Tabel ASCII care conține (cel puțin) trei coloane care specifică coordonatele imaginii x și y
și valoarea pixelului respectiv al imaginii. În acest caz, distractiv necesită patru argumente suplimentare:
xcolumn:xdims, ycolumn:ydims, vcolumn și bitpix=n. Informațiile x și y col:dim iau
forma:

nume: dim # valorile variază de la 1 la dim
nume:min:max # valori variază de la min la max
nume:min:max:binsiz # dimensiuni scalate în funcție de binsize

În special, valoarea minimă ar trebui utilizată ori de câte ori este valoarea minimă a coordonatei
altceva decât unul. De exemplu:

funimage -l foo.lst foo.fits xcol:0:512 ycol:0:512 value bitpix=-32

Funcția de listă poate fi folosită și pentru a citi coloane fără nume de la intrarea standard: simplu
înlocuiți numele coloanei cu un șir nul. Rețineți că informațiile despre dimensiune sunt încă
necesar:

funimage -l stdin foo.fits "":0:512 "":0:512 "" bitpix=-32
240 250 1
255 256 2
...
^D

Funcția de listă oferă o modalitate simplă de a genera o imagine goală. Dacă treci o coloană-
bazat pe Fișier text la funimage în care antetul textului conține imaginea necesară
informații, atunci funimage va face corect o imagine goală. De exemplu, luați în considerare
următorul fișier text (numit foo.txt):

x:I:1:10 y:I:1:10
------ ------
0 0

Acest fișier text definește două coloane, x și y, fiecare de tipul de date int pe 32 de biți și imagine
dimensiunea 10. Comanda:

funimage foo.txt foo.fits bitpix=8

va crea o imagine FITS goală numită foo.fits care conține o imagine de 10x10 cu caracter nesemnat:

fundisp foo.fits
1 2 3 4 5 6 7 8 9 10
------ ------ ------ ------ ------ ------ ------ ------ -- ---- ------
10: 0 0 0 0 0 0 0 0 0 0
9: 0 0 0 0 0 0 0 0 0 0
8: 0 0 0 0 0 0 0 0 0 0
7: 0 0 0 0 0 0 0 0 0 0
6: 0 0 0 0 0 0 0 0 0 0
5: 0 0 0 0 0 0 0 0 0 0
4: 0 0 0 0 0 0 0 0 0 0
3: 0 0 0 0 0 0 0 0 0 0
2: 0 0 0 0 0 0 0 0 0 0
1: 1 0 0 0 0 0 0 0 0 0

Rețineți că fișierul text trebuie să conțină cel puțin un rând de date. Cu toate acestea, în prezent
de exemplu, poziția evenimentului 0,0 este în afara limitelor imaginii și va fi ignorată. (Tu
poate, desigur, să folosească valori reale x,y pentru a însămânța imaginea cu date.)

În plus, puteți utiliza specificația filtrului TEXT pentru a evita necesitatea unei introduceri
fișier text cu totul. Următoarea comandă va crea aceeași imagine de 10x10 caractere fără
un fișier de intrare real:

funimage stdin'[TEXT(x:I:10,y:I:10)]' foo.fits bitpix=8 < /dev/null
or
funimage /dev/null'[TEXT(x:I:10,y:I:10)]' foo.fits bitpix=8

De asemenea, puteți utiliza oricare dintre aceste metode pentru a genera o mască de regiune prin simpla adăugare a unui
regiunea din interiorul suporturilor filtrului și specificarea masca=toate împreună cu bitpix-ul. Pentru
exemplu, următoarea comandă va genera o mască de caractere de 10x10 folosind 3 regiuni:

funimage stdin'[TEXT(x:I:10,y:I:10),cir(5,5,4),point(10,1),-cir(5,5,2)]'
foo.fits bitpix=8,mask=all < /dev/null

Masca rezultată arată astfel:

fundisp foo.fits
1 2 3 4 5 6 7 8 9 10
------ ------ ------ ------ ------ ------ ------ ------ -- ---- ------
10: 0 0 0 0 0 0 0 0 0 0
9: 0 0 0 0 0 0 0 0 0 0
8: 0 0 1 1 1 1 1 0 0 0
7: 0 1 1 1 1 1 1 1 0 0
6: 0 1 1 0 0 0 1 1 0 0
5: 0 1 1 0 0 0 1 1 0 0
4: 0 1 1 0 0 0 1 1 0 0
3: 0 1 1 1 1 1 1 1 0 0
2: 0 0 1 1 1 1 1 0 0 0
1: 0 0 0 0 0 0 0 0 0 2

Poți să folosești distractiv pentru a crea proiecții de imagini 1D de-a lungul axei x sau y folosind -p
[x⎪y] intrerupator. Această capacitate funcționează atât pentru imagini, cât și pentru tabele. De exemplu, luați în considerare a
Tabelul FITS numit ev.fits care conține următoarele rânduri:

X Y
-------- --------
1 1
1 2
1 3
1 4
1 5
2 2
2 3
2 4
2 5
3 3
3 4
3 5
4 4
4 5
5 5

O imagine corespunzătoare de 5x5, numită dim2.fits, ar conține prin urmare:

1 2 3 4 5
---------- ---------- ---------- ---------- ----------
5: 1 1 1 1 1
4: 1 1 1 1 0
3: 1 1 1 0 0
2: 1 1 0 0 0
1: 1 0 0 0 0

O proiecție de-a lungul axei y poate fi efectuată fie pe tabel, fie pe imagine:

funimage -py ev.fits stdout ⎪ fundisp stdin
1 2 3 4 5
---------- ---------- ---------- ---------- ----------
1: 1 2 3 4 5

funimage -py dim2.fits stdout ⎪ fundisp stdin
1 2 3 4 5
---------- ---------- ---------- ---------- ----------
1: 1 2 3 4 5

În plus, puteți crea o proiecție de imagine 1D de-a lungul oricărei coloane a unui tabel utilizând
bincols=[coloană] specificarea filtrului și specificarea unei singure coloane. De exemplu, cel
următoarea comandă proiectează aceeași imagine 1D de-a lungul axei y a unui tabel ca și folosirea -p
y comutator:

funimage ev.fits'[bincols=y]' stdout ⎪ fundisp stdin
1 2 3 4 5
---------- ---------- ---------- ---------- ----------
1: 1 2 3 4 5

Exemple:

Creați o imagine FITS dintr-un tabel binar FITS:

[sh] funimage test.ev test.fits

Afișați imaginea FITS generată dintr-o secțiune blocată a tabelului binar FITS:

[sh] funimage "test.ev[2:8,3:7,2]" stdout ⎪ fundisp stdin
1 2 3
--------- --------- ---------
1: 20
2: 28

Utilizați funimage online folosind serviciile onworks.net