funtable - Online in de cloud

PROGRAMMA:

NAAM

funtable - kopieer geselecteerde rijen van een Funtools-bestand naar een FITS binaire tabel

KORTE INHOUD

funtabel [-a] [-i⎪-z] [-m] [-s cols] [kolommen]

OPTIES

-a # toevoegen aan bestaand uitvoerbestand als tabelextensie
-i # voor afbeeldingsgegevens: genereer alleen X- en Y-kolommen
-m # voor tabellen: schrijf voor elke regio een apart bestand
-s "col1 ..." # kolommen waarop moet worden gesorteerd
-z # voor afbeeldingsgegevens: uitvoer pixels met nulwaarde

PRODUCTBESCHRIJVING

funtabel selecteert rijen uit de opgegeven FITS-extensie (alleen binaire tabel) van een FITS
-bestand, of vanuit een niet-FITS onbewerkt gebeurtenisbestand, en schrijft die rijen naar een binaire FITS-tabel
bestand. Het zal ook een FITS binaire tabel maken van een afbeelding of een onbewerkt arraybestand.

Het eerste argument voor het programma specificeert het FITS-bestand, het onbewerkte gebeurtenisbestand of de onbewerkte array
bestand. Als "stdin" is opgegeven, worden gegevens uit de standaardinvoer gelezen. Gebruik Funtools
Haakjesnotatie om FITS-extensies en filters te specificeren. Het tweede argument is de
output FITS-bestand. Als "stdout" is opgegeven, wordt de binaire FITS-tabel geschreven naar het
standaard uitvoer. Standaard worden alle kolommen van het invoerbestand gekopieerd naar het uitvoerbestand.
Geselecteerde kolommen kunnen worden uitgevoerd met behulp van een optioneel derde argument in de vorm:

"kolom1 kolom1 ... kolomN"

De funtabel programma wordt over het algemeen gebruikt om rijen uit een binaire FITS-tabel te selecteren met behulp van Table
Filters en/of filters voor ruimtelijke regio's. U kunt bijvoorbeeld alleen geselecteerde rijen (en
voer alleen geselecteerde kolommen uit) door een opdracht uit te voeren zoals:

[sh] funtable "test.ev[pha==1&&pi==10]" stdout "xy pi pha" ⎪ fundisp stdin
XY PHA PI
------- ------- ------- ---------
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10

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

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

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

[sh $] funtable "test.ev[time-(int)time>=.99]" stdout "-time" ⎪ fundisp stdin
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 zijn geschreven.

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.

Normaal gesproken wordt alleen de geselecteerde tabel naar het uitvoerbestand gekopieerd. In een FITS binaire tabel,
soms is het wenselijk om alle andere FITS-extensies naar het uitvoerbestand te kopiëren als
Goed. Dit kunt u doen door een '+' teken toe te voegen aan de naam van de extensie in de invoer
bestandsnaam. Het eerste commando hieronder kopieert bijvoorbeeld alleen de EVENT-tabel, terwijl de
het tweede commando kopieert ook andere extensies:

[sh] funtable "/proj/rd/data/snr.ev[EVENTS]" events.ev
[sh] funtable "/proj/rd/data/snr.ev[EVENTS+]" eventsandmore.ev

Als het invoerbestand een afbeelding of een onbewerkt arraybestand is, dan funtabel zal een FITS genereren
binaire tabel op basis van de pixelwaarden in de afbeelding. Houd er rekening mee dat het niet mogelijk is om dit op te geven
de kolommen die moeten worden uitgevoerd (met opdrachtregelargument 3). In plaats daarvan zijn er twee manieren om dat te doen
maak zo'n binaire tabel van een afbeelding. Standaard wordt een tabel met 3 kolommen gegenereerd, waarin
de kolommen zijn "X", "Y" en "VALUE". Voor elke pixel in de afbeelding een enkele rij (gebeurtenis)
wordt gegenereerd waarbij aan de kolommen "X" en "Y" de dim1- en dim2-waarden van de afbeelding zijn toegewezen
pixel, respectievelijk en de kolom "VALUE" heeft de waarde van de pixel toegewezen. Met soort van
tafel, rennen grappig in de kolom "VALUE" geeft dezelfde resultaten als hardlopen grappig
op de originele afbeelding.

Indien de -i ("individuele" rijen) schakelaar is opgegeven, dan zijn alleen de kolommen "X" en "Y" dat
gegenereerd. In dit geval genereert elke positieve pixelwaarde in de afbeelding n rijen (gebeurtenissen),
waarbij n gelijk is aan de gehele waarde van die pixel (plus 0.5, voor drijvende komma
gegevens). In werkelijkheid, -i reconstrueert ongeveer de rijen van een tabel die er zou zijn geweest
weggegooid in de invoerafbeelding. (Dit is uiteraard slechts bij benadering juist, aangezien de
resulterende x,y-posities zijn geheeltallig.)

Indien de -s [kol1 col2 ... kolom] ("sort") schakelaar is gespecificeerd, de uitvoerrijen van een binair bestand
tabel wordt gesorteerd met behulp van de opgegeven kolommen als sorteersleutels. De sorteersleutels moeten zijn
scalaire kolommen en moeten ook deel uitmaken van het uitvoerbestand (dat wil zeggen dat u niet op een kolom kunt sorteren
maar neem het niet op in de uitvoer). Deze faciliteit maakt gebruik van de _soort programma (inbegrepen bij
funtools), die via jouw pad toegankelijk moet zijn.

Voor binaire tabellen is de -m ("meerdere bestanden") schakelaar genereert voor elk een afzonderlijk bestand
regio in de filterspecificatie, dwz elk bestand bevat alleen de rijen uit die regio.
Rijen die het filter passeren maar zich niet in een regio bevinden, worden ook in een apart bestand geplaatst.

De afzonderlijke uitvoerbestandsnamen die worden gegenereerd door het -m schakelaar worden automatisch geproduceerd
het hoofduitvoerbestand moet de regio-ID van de bijbehorende regio bevatten. (Let op die regio
ids beginnen bij 1, zodat de bestandsnaam die is gekoppeld aan id 0 rijen bevat die de
filteren, maar bevinden zich niet in een bepaalde regio.) Namen van uitvoerbestanden worden als volgt gegenereerd:

· Een $n-specificatie kan overal in de rootbestandsnaam worden gebruikt (op passende wijze tussen aanhalingstekens
bescherm het tegen de shell) en zal worden uitgebreid tot het ID-nummer van de bijbehorende
regio. Bijvoorbeeld:

funtable -m input.fits'[cir(512,512,1);cir(520,520,1)...]' 'foo.goo_$n.fits'

zal bestanden genereren met de naam foo.goo_0.fits (voor rijen die zich niet in een regio bevinden maar nog steeds passeren
het filter), foo.goo_1.fits (rijen in regio-id #1, de eerste regio), foo.goo_2.fits
(rijen in regio-id #2), enz. Houd er rekening mee dat enkele aanhalingstekens in de uitvoerwortel vereist zijn
om de '$' tegen de shell te beschermen.

· Als $n niet is opgegeven, wordt de regio-ID vóór de eerste punt (.) geplaatst
de bestandsnaam. Dus:

funtable -m input.fits'[cir(512,512,1);cir(520,520,1)...]' foo.evt.fits

zal bestanden genereren met de naam foo0.evt.fits (voor rijen die zich niet in een regio bevinden maar nog steeds passeren
het filter), foo1.evt.fits (rijen in regio-ID #1), foo2.evt.fits (rijen in regio-ID
#2), enz.

· Als er geen punt is opgegeven in de hoofduitvoerbestandsnaam, dan is de regio-id dat
toegevoegd aan de bestandsnaam. Dus:

funtable -m input.fits'[cir(512,512,1);cir(520,520,1)...]' 'foo_evt'

zal bestanden genereren met de naam foo_evt0 (voor rijen die zich niet in een regio bevinden maar nog steeds de
filter), foo_evt1 (rijen in regio-id #1), foo_evt2 (rijen in regio-id #2), enz.

Het mechanisme voor meerdere bestanden biedt een eenvoudige manier om individuele brongegevensbestanden te genereren
met één enkele doorgang door de gegevens.

Standaard wordt een nieuw FITS-bestand gemaakt en wordt de binaire tabel naar de eerste geschreven
verlenging. Als de -a (append)-schakelaar is opgegeven, wordt de tabel toegevoegd aan een bestaande
FITS-bestand als BINTABLE-extensie. Houd er rekening mee dat het uitvoer-FITS-bestand al moet bestaan.

Indien de -z ("nul" pixelwaarden) schakelaar is gespecificeerd en -i niet is opgegeven, dan pixels
met een nulwaarde worden uitgevoerd met de kolom "VALUE" ingesteld op nul. Uiteraard dit
schakelaar heeft geen zin wanneer individuele gebeurtenissen worden uitgevoerd.

Gebruik funtable online met behulp van onworks.net-services