funimage - Online in de cloud

PROGRAMMA:

NAAM

funimage - maak een FITS-afbeelding van een Funtools-gegevensbestand

KORTE INHOUD

leuk beeld [-A] [bitpix=n] leuk beeld [-l]
[bitpix=n] leuk beeld [-px⎪y] [bitpix=n]

OPTIES

-a # toevoegen aan een bestaand uitvoerbestand als een afbeeldingsextensie
-l # input is een lijstbestand met xcol, ycol, waarde
-p [x⎪y] # projecteer langs de x- of y-as om een ​​1D-afbeelding te maken

PRODUCTBESCHRIJVING

leuk beeld creëert een primaire FITS-afbeelding van de opgegeven FITS-extensie en/of afbeelding
Sectie van een FITS-bestand, of van een afbeeldingssectie van een niet-FITS-array, of van een onbewerkte gebeurtenis
bestand.

Het eerste argument voor het programma specificeert het FITS-invoerbeeld, de array of het onbewerkte gebeurtenisbestand
verwerken. Als "stdin" is opgegeven, worden gegevens uit de standaardinvoer gelezen. Gebruik Funtools
Bracket-notatie om FITS-extensies, afbeeldingssecties en filters te specificeren. De seconde
argument is het FITS-uitvoerbestand. Als "stdout" is opgegeven, wordt er naar de FITS-afbeelding geschreven
de standaarduitvoer. Standaard zijn de uitvoerpixelwaarden van hetzelfde gegevenstype als
die van het invoerbestand (of typ "int" bij het binnen van een tabel), maar dit kan worden overschreven
met behulp van een optioneel derde argument van de vorm:

bitpix=n

waarbij n 8,16,32,-32,-64 is, voor respectievelijk niet-ondertekende char, short, int, float en double.

Als de invoergegevens van het type afbeelding zijn, wordt de betreffende sectie geëxtraheerd en geblokkeerd
(gebaseerd op hoe de afbeeldingssectie is gespecificeerd) en het resultaat wordt naar de FITS geschreven
primaire afbeelding. Wanneer een integer-afbeelding met de trefwoorden BSCALE en BZERO is
geconverteerd naar zwevend, worden de pixelwaarden geschaald en worden de schaalsleutelwoorden verwijderd
de uitvoerkop. Bij het converteren van geheel getal geschaalde gegevens naar geheel getal (mogelijk van een ander
grootte), worden de pixels niet geschaald en blijven de schaalsleutelwoorden behouden.

Als de invoergegevens een binaire tabel of een onbewerkt gebeurtenisbestand zijn, worden deze in een afbeelding opgeslagen.
waaruit een sectie wordt geëxtraheerd en geblokkeerd, en naar een primaire FITS-afbeelding wordt geschreven. In
In dit geval is het noodzakelijk om de twee kolommen op te geven die in de 2D-binning zullen worden gebruikt.
Dit kan gedaan worden op de opdrachtregel met behulp van de bincols=(x,y) trefwoord:

funcnts "foo.ev[EVENTS,bincols=(detx,dety)]"

De volledige vorm van de bincols= specificatie is:

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

waarbij de tlmin-, tlmax- en binsiz-specificaties de afmetingen van de afbeeldingsbinning bepalen:

dim = (tlmax - tlmin)/binsiz (gegevens met drijvende komma)
dim = (tlmax - tlmin)/binsiz + 1 (gehele gegevens)

Met behulp van deze syntaxis is het mogelijk om twee willekeurige kolommen van een binaire tabel in een willekeurige bin te plaatsen
maat. Houd er rekening mee dat de specificaties tlmin, tlmax en binsiz kunnen worden weggelaten als TLMIN, TLMAX,
en TDBIN headerparameters (respectievelijk) zijn aanwezig in de FITS binaire tabelheader voor
de kolom in kwestie. Houd er ook rekening mee dat als er slechts één parameter is opgegeven, hiervan wordt uitgegaan
is tlmax, en tlmin is standaard 1. Als er twee parameters zijn opgegeven, wordt aangenomen dat ze
wees tlmin en tlmax. Zie Binning van FITS binaire tabellen en niet-FITS gebeurtenisbestanden voor meer informatie
informatie over binningparameters.

Standaard wordt er een nieuw 2D FITS-afbeeldingsbestand gemaakt en wordt de afbeelding naar het primaire bestand geschreven
HDU. Als de -a (append)-schakelaar is opgegeven, wordt de afbeelding toegevoegd aan een bestaande FITS
bestand als IMAGE-extensie. (Als het uitvoerbestand niet bestaat, is de schakelaar effectief
genegeerd en de afbeelding wordt naar de primaire HDU geschreven.) Dit kan handig zijn in een shell
programmeeromgeving bij het verwerken van meerdere FITS-afbeeldingen waarin u wilt combineren
één definitief FITS-bestand.

leuk beeld kan ook invoer halen uit een tabel met kolommen x, y en waarde (bijvoorbeeld de
uitvoer van geldschieter -l die elke afbeelding x en y weergeeft en het aantal tellingen daarbij
positie.) Wanneer de -l (lijst)-schakelaar wordt gebruikt, wordt het invoerbestand beschouwd als een FITS of
ASCII-tabel met (minstens) drie kolommen die de x- en y-beeldcoördinaten specificeren
en de waarde van die afbeeldingspixel. In dit geval, leuk beeld vereist vier extra argumenten:
xcolumn:xdims, ycolumn:ydims, vcolumn en bitpix=n. De x- en y col:dim-informatie neemt
het formulier:

naam:dim # waarden variëren van 1 tot dim
naam:min:max # waarden variëren van min tot max
naam:min:max:binsiz # afmetingen geschaald op bingrootte

In het bijzonder moet de min-waarde worden gebruikt wanneer de minimale coördinaatwaarde is
iets anders dan één. Bijvoorbeeld:

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

De lijstfunctie kan ook worden gebruikt om naamloze kolommen uit standaardinvoer te lezen: eenvoudigweg
vervang de kolomnaam door een null-tekenreeks. Merk op dat de dimensie-informatie nog steeds is
verplicht:

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

De lijstfunctie biedt een eenvoudige manier om een ​​lege afbeelding te genereren. Als u langs een kolom-
gebaseerd tekstbestand naar funimage waarin de tekstkop de vereiste afbeelding bevat
informatie, dan zal funimage correct een blanco afbeelding maken. Denk bijvoorbeeld aan de
volgende tekstbestand (genaamd foo.txt):

x:I:1:10 j:I:1:10
------ ------
0 0

Dit tekstbestand definieert twee kolommen, x en y, elk met het gegevenstype 32-bits int en image
afmeting 10. Het commando:

funimage foo.txt foo.fits bitpix=8

zal een lege FITS-afbeelding maken met de naam foo.fits met een 10x10-afbeelding van niet-ondertekende char:

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

Houd er rekening mee dat het tekstbestand minimaal één rij gegevens moet bevatten. Echter, in het heden
Gebeurtenispositie 0,0 valt bijvoorbeeld buiten de grenzen van de afbeelding en wordt genegeerd. (Jij
kan uiteraard echte x,y-waarden gebruiken om de afbeelding met gegevens te vullen.)

Bovendien kunt u de TEXT-filterspecificatie gebruiken om de noodzaak van invoer te vermijden
tekstbestand helemaal. Met de volgende opdracht wordt dezelfde 10x10 char-afbeelding gemaakt zonder
een daadwerkelijk invoerbestand:

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

U kunt ook een van deze methoden gebruiken om een ​​regiomasker te genereren door eenvoudigweg een
gebied binnen de filterbeugels en specificatie masker=alles samen met de bitpix. Voor
De volgende opdracht genereert bijvoorbeeld een tekenmasker van 10x10 met behulp van 3 regio's:

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

Het resulterende masker ziet er als volgt uit:

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

Je kunt gebruiken leuk beeld om 1D-beeldprojecties langs de x- of y-as te maken met behulp van de -p
[x⎪y] schakelaar. Deze mogelijkheid werkt voor zowel afbeeldingen als tabellen. Denk bijvoorbeeld aan een
FITS-tabel met de naam ev.fits en bevat de volgende rijen:

XY
-------- --------
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

Een overeenkomstige afbeelding van 5x5, dim2.fits genaamd, zou daarom het volgende bevatten:

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

Een projectie langs de y-as kan op de tafel of op het beeld worden uitgevoerd:

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

Bovendien kunt u een 1D-beeldprojectie langs elke kolom van een tafel maken met behulp van de
bincols=[kolom] filterspecificatie en het specificeren van een enkele kolom. Bijvoorbeeld de
De volgende opdracht projecteert dezelfde 1D-afbeelding langs de y-as van een tabel als bij gebruik van de -p
y schakelaar:

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

Voorbeelden:

Maak een FITS-afbeelding van een binaire FITS-tabel:

[sh] funimage test.ev test.fits

Geef de FITS-afbeelding weer die is gegenereerd op basis van een geblokkeerd gedeelte van de binaire FITS-tabel:

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

Gebruik funimage online met behulp van onworks.net-services