fundisp - Online in de cloud

PROGRAMMA:

NAAM

fundisp - gegevens weergeven in een Funtools-gegevensbestand

KORTE INHOUD

geldschieter [-f formaat] [-l] [-n] [-T] [kolommen⎪bitpix=n]

OPTIES

-f # formaatreeks voor weergave
-l # geef de afbeelding weer als een lijst met de kolommen X, Y, VAL
-n # header niet uitvoeren
-F [c] # gebruik het opgegeven teken als kolomscheidingsteken (def: spatie)
-T # uitvoer in rdb/starbase-formaat (tabbladscheidingstekens)

PRODUCTBESCHRIJVING

geldschieter geeft de gegevens weer in de opgegeven FITS-extensie en/of afbeeldingssectie van een FITS
bestand, of in een sectie van een niet-FITS-array of onbewerkt gebeurtenisbestand.

Het eerste argument voor het programma specificeert het FITS-invoerbeeld, de array of het onbewerkte gebeurtenisbestand
weergeven. Als "stdin" is opgegeven, worden gegevens uit de standaardinvoer gelezen. Gebruik Funtools
Bracket-notatie om FITS-extensies, afbeeldingssecties en filters te specificeren.

Als de weergegeven gegevens kolommen zijn (in een binaire FITS-tabel of in een onbewerkte gebeurtenis
bestand), worden de afzonderlijke rijen weergegeven. Filters kunnen worden toegevoegd met behulp van haakjesnotatie. Dus:

[sh] fundisp "test.ev[tijd-(int)tijd>.15]"
XY PHA PI TIJD 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: Het FITS binaire tabeltestbestand test.ev, evenals de FITS-afbeelding test.fits, zijn
opgenomen in de funtools funtest directory.]

Wanneer een tabel wordt weergegeven met behulp van geldschieter, kan hiervoor een tweede optioneel argument worden gebruikt
specificeer de kolommen die moeten worden weergegeven. Bijvoorbeeld:

[sh] fundisp "test.ev[tijd-(int)tijd>=.99]" "xy tijd"
XY-TIJD
-------- -------- ---------------------
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

De bijzondere kolom $REGIO kan worden opgegeven om de regio-ID van elke rij weer te geven:

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

Hier alleen rijen met de juiste fractionele tijd en waarvan de positie ook binnen een van ligt
de drie annuli worden weergegeven.

Kolommen kunnen van weergave worden uitgesloten door een minteken vóór de kolom te plaatsen:

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

Alle kolommen behalve de tijdkolom worden weergegeven.

De bijzondere kolom $N kan worden opgegeven om de ordinale waarde van elke rij weer te geven. Dus,
vervolg op het vorige voorbeeld:

fundisp "test.ev[tijd-(int)tijd>=.99]" '-tijd $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

Merk op dat de kolomspecificatie tussen enkele aanhalingstekens staat om '$n' vanaf het begin te beschermen
uitgebreid door de schaal.

Over het algemeen zijn de regels voor het activeren en deactiveren van kolommen:

· Als alleen kolommen worden uitgesloten, worden alle kolommen behalve de kolommen uitgesloten
geactiveerd worden.

· Als alleen include-kolommen zijn opgegeven, worden alleen de opgegeven kolommen geactiveerd.

· Als er een combinatie van include- en uitsluitingskolommen is opgegeven, dan worden alle kolommen behalve de uitsluitingskolommen opgegeven
kolommen zullen actief zijn; dit laatste geval is dubbelzinnig en de regel is willekeurig.

Naast het expliciet opgeven van kolomnamen, zijn de speciale symbolen + en - kan zijn
gebruikt om te activeren en deactiveren allen kolommen. Dit is handig als u de
kolom $REGION samen met alle andere kolommen. Volgens de regels is de syntaxis "$REGION"
activeert alleen de regiokolom en deactiveert de rest. Gebruik "+ $REGION" om te activeren
alle kolommen en de regiokolom.

Als de weergegeven gegevens beeldgegevens zijn (hetzij in een FITS-primair beeld, hetzij in een FITS-beeld
extensie of een arraybestand), wordt er een mxn-pixelweergave geproduceerd, waarbij m en n de
afmetingen van het beeld. Standaard worden pixelwaarden weergegeven met hetzelfde gegevenstype
zoals in het bestand. Voor gehele gegevens waarbij de headerparameters BSCALE en BZERO aanwezig zijn
aanwezig zijn, worden de gegevens weergegeven als floats. In beide gevallen kan het weergavegegevenstype zijn
overschreven met behulp van een optioneel tweede argument van het formulier:

bitpix=n

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

Natuurlijk, hardlopen geldschieter op alles behalve de kleinste afbeelding resulteert meestal in een weergave
waarvan de grootte het onleesbaar maakt. Daarom kan men de haakjesnotatie (zie hieronder) gebruiken
pas sectie en/of blokkering toe op de afbeelding voordat u een weergave genereert. Bijvoorbeeld:

[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

Merk op dat het mogelijk is om een ​​binaire FITS-tabel als afbeelding weer te geven door simpelweg de
tafel door leuk beeld eerste:

[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

Indien de -l (lijst)-schakelaar wordt gebruikt, wordt een afbeelding weergegeven als een lijst met de
kolommen: X, Y, VAL. Bijvoorbeeld:

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

Indien de -n (nohead)-schakelaar wordt gebruikt, wordt er geen header uitgevoerd voor tabellen. Dit is nuttig,
bijvoorbeeld wanneer fundisp-uitvoer naar gnuplot wordt geleid.

De geldschieter programma gebruikt een standaardset weergaveformaten:

datatype TFORM-formaat
-------- ----- --------
dubbele D "%21.8f"
zwevende E "%11.2f"
int J "%10d"
kort I "%8d"
byte B "%6d"
tekenreeks A "%12.12s"
bits X "%8x"
logische L "%1x"

De standaardweergave van 1 dubbel en 2 shorts geeft dus:

[sh] fundisp snr.ev "tijd xy"

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

U kunt het weergaveformaat voor individuele kolommen of voor alle kolommen van een gegeven wijzigen
gegevenstypen met behulp van de schakelaar -f. De formatstring die bij -f hoort, is een spatie-
gescheiden lijst met trefwoord=format-waarden. De trefwoordwaarden kunnen kolomnamen zijn
(in welk geval het bijbehorende formaat alleen betrekking heeft op die kolom) of FITS-tabel TFORM
specificeerders (in welk geval het formaat betrekking heeft op alle kolommen met dat gegevenstype). Voor
U kunt bijvoorbeeld de dubbele en korte notatie voor alle kolommen als volgt wijzigen:

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

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

Als alternatief kunt u de notatie van de tijd- en x-kolommen als volgt wijzigen:

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

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

Houd er rekening mee dat er een potentieel conflict bestaat als een kolom dezelfde naam heeft als een van de TFORM-kolommen
specificeerders. In de bovenstaande voorbeelden heeft de kolom 'X' in de tabel dezelfde naam als
het X (bit) datatype. Om dit conflict op te lossen, wordt de formatstring zo verwerkt dat
TFORM-gegevenstypespecificaties worden eerst gecontroleerd met behulp van een hoofdlettergevoelige vergelijking. Als de
De opgegeven formaatwaarde is geen TFORM-waarde in hoofdletters; een controle die niet hoofdlettergevoelig is, is dat wel
gemaakt op de kolomnaam. Dit betekent dat in de bovenstaande voorbeelden "X=%3d" zal verwijzen naar
het X (bit) datatype, terwijl "x=%3d" verwijst naar de X-kolom:

[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
...

In de regel kunt u de kolomnaam daarom het beste altijd in kleine letters en in TFORM opgeven
gegevenstypen in hoofdletters.

De -f [formaat] zal het formaat voor een enkele uitvoering van fundisp. Je kunt ook gebruiken
de FUN_FORMAAT omgevingsvariabele om het formaat voor alle aanroepen van fundisp te wijzigen.
Het formaat van de waarde van deze omgevingsvariabele is identiek aan die gebruikt bij de -f
schakelaar. Deze globale waarde kan in individuele gevallen worden overschreven door gebruik te maken van de -f [formaat]
schakelaar.

Waarschuwingen: Houd er ook rekening mee dat het de verantwoordelijkheid van de gebruiker is om het formaat aan te passen
specificatie correct aan het kolomgegevenstype toe. Merk ook op dat, om visueel te blijven
Uitlijning tussen namen en kolommen, de kolomnaam wordt afgekapt (aan de linkerkant) als
de formaatbreedte is kleiner dan de lengte van de naam. Er wordt echter niet ingekort
als de uitvoer in RDB-indeling is (met behulp van de -T-schakelaar).

[Een tekenreeks in oudere stijl wordt ondersteund, maar is verouderd. Het bestaat uit door de ruimte begrensde
C-formaatinstructies voor alle gegevenstypen, gespecificeerd in de volgende volgorde:

dubbele float int korte byte stringbit.

Deze volgorde van de lijst is gebaseerd op de veronderstelling dat mensen dat over het algemeen wel willen
verander de float-formaten.

Als "-" wordt ingevoerd in plaats van een formaatinstructie voor een bepaald gegevenstype, is dit het standaardformaat
is gebruikt. Ook kan de formatstring worden beëindigd zonder alle formaten op te geven, en
standaardwaarden worden voor de rest van de lijst gebruikt. Houd er rekening mee dat u een minimumveld moet opgeven
breedte, dwz "%6d" en "%-6d" zijn legaal, "%d" is niet legaal.

Door -f [format] te gebruiken, kun je de dubbele en korte formaten als volgt wijzigen:

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

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

NB: dit formaat is verouderd en zal in een toekomstige release worden verwijderd.]

De -F[c] switch kan worden gebruikt om een ​​kolomscheidingsteken (van één teken) op te geven (waarbij de
standaard is een spatie). Merk op dat kolomopmaak vrijwel zeker ook spaties zal toevoegen
vul individuele kolommen op tot de gewenste breedte. Deze kunnen worden verwijderd met een programma zoals
sed, ten koste van het genereren van niet-uitgelijnde kolommen. Bijvoorbeeld:

fundisp -F',' snr.ev'[cir 512 512 .1]'
X, Y, PHA, PI, TIJD, 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,TIJD,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 time=%20.11f dx=%3d dy=%3d" -F',' snr.ev'[cir 512
512 .1]' ⎪ sed 's/ *, */,/g'
X,Y,A,I,TIJD,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

Indien de -T (rdb-tabel)-schakelaar wordt gebruikt, zal de uitvoer voldoen aan starbase/rdb-database
formaat: tabs worden tussen kolommen ingevoegd in plaats van spaties. Dit formaat is dat niet
beschikbaar bij het weergeven van afbeeldingspixels (behalve in combinatie met de -l schakelaar).

Merk ten slotte op dat geldschieter kan worden gebruikt om kolomfilters te maken op basis van de hulptabellen
in een FITS-bestand. De volgende shell-code genereert bijvoorbeeld een goed tijdsinterval
(GTI) filter voor röntgengegevensbestanden die een standaard GTI-extensie bevatten:

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

Als dit script in een bestand met de naam "mkgti" wordt geplaatst, kan het worden gebruikt in een opdracht zoals:

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

Het resulterende filterbestand kan vervolgens in verschillende funtools-programma's worden gebruikt:

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

om alleen de gebeurtenissen in de goede tijdsintervallen te verwerken.

Gebruik fundisp online met behulp van onworks.net-services