funcone - Online in de cloud

PROGRAMMA:

NAAM

funcone - kegel zoeken van een binaire tabel met RA, Dec-kolommen

KORTE INHOUD

funkegel [kolommen]

OPTIES

-d deccol:[hdr] # Dec kolomnaam, eenheden (def: DEC:d)
-j # voeg kolommen samen uit lijstbestand
-J # voeg kolommen samen uit lijstbestand, voer alle rijen uit
-l lijstbestand # lees centra en stralen uit een lijst
-L lijstbestand # lees centra en stralen uit een lijst, voer lijstrijen uit
-n # gebruik kegellimieten niet als filter
-r racol:[hdr] # RA kolomnaam, eenheden (def: RA:h)
-x # voeg RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY cols toe
-X # voeg RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY cols toe, voer alle rijen uit

PRODUCTBESCHRIJVING

Funcone voert een kegelzoekopdracht uit op de RA- en Dec-kolommen van een FITS-binaire tabel. De
afstand van het centrum RA, Dec positie naar de RA, Dec in elke rij in de tabel is
berekend. Rijen waarvan de afstand kleiner is dan de opgegeven radius worden uitgevoerd.

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.

Het derde en vierde vereiste argument zijn de positie van RA en Dec in het midden. Standaard,
RA wordt gespecificeerd in uren terwijl Dec wordt gespecificeerd in graden. U kunt de eenheden van wijzigen
een van beide door het teken "d" (graden), "h" (uren) of "r" (radialen) toe te voegen.
Sexagesimale notatie wordt ondersteund, met dubbele punten of spaties die hms en dms scheiden. (Wanneer
zorg er bij gebruik van spaties voor dat de hele tekenreeks tussen aanhalingstekens staat.)

Het vijfde vereiste argument is de straal van de kegelzoekopdracht. Standaard de radiuswaarde
wordt gegeven in graden. De eenheden kunnen worden gewijzigd door het teken "d" (graden) toe te voegen,
"r" (radialen), "'" (boogminuten) of ''' (boogseconden).

Standaard worden alle kolommen van het invoerbestand gekopieerd naar het uitvoerbestand. Geselecteerde kolommen
kan worden uitgevoerd met een optioneel zesde argument in de vorm:

"kolom1 kolom1 ... kolomN"

Met een zevende argument kunt u geselecteerde kolommen uit het lijstbestand uitvoeren wanneer -j schakelaar
is gebruikt. Merk op dat de RA- en Dec-kolommen die in de kegelberekening worden gebruikt, dat niet mogen zijn
gedeselecteerd.

Ook worden de kolomnamen RA en Dec standaard "RA" en "Dec" genoemd, en worden opgegeven
eenheden van respectievelijk uren en graden. U kunt zowel de naam als de eenheden wijzigen met behulp van
de schakelaars -r [RA] en/of -d [Dec]. Nogmaals, er wordt een van "h", "d" of "r" aan toegevoegd
de kolomnaam om eenheden te specificeren, maar in dit geval moet er een dubbele punt ":" tussen de
naam en de specificatie van het apparaat.

Indien de -l [lijstbestand] schakelaar wordt gebruikt, dan een of meer van de middelste RA, middelste Dec, en
radius kan uit een lijstbestand worden gehaald (dit kan een FITS-tabel of een ASCII-kolomtekst zijn
bestand). In dit geval de derde (midden RA), vierde (midden Dec) en vijfde (straal)
opdrachtregelargumenten kunnen ofwel een kolomnaam in het lijstbestand zijn (als die parameter
varieert) of anders een numerieke waarde (als die parameter statisch is). Wanneer een kolomnaam is
opgegeven voor de RA, Dec of radius, kunt u een dubbele punt toevoegen gevolgd door "h", "d" of "r"
om eenheden te specificeren (ook ' en " voor radius). Het algoritme voor het zoeken naar kegels wordt eenmaal voor elk uitgevoerd
rij in de lijst, waarbij RA-, Dec- en straalwaarden uit de opgegeven kolommen of uit
statische numerieke waarden opgegeven op de opdrachtregel.

Bij gebruik van een lijst worden alle geldige rijen van elke iteratie naar één uitvoerbestand geschreven.
Gebruik de -x schakelaar om te helpen afbakenen welke regel van het lijstbestand werd gebruikt om de
gegeven uitvoerrij(en). Deze schakelaar zorgt ervoor dat de waarden voor het midden RA, Dec, radius en
rijnummer dat moet worden toegevoegd aan het uitvoerbestand, in kolommen genaamd RA_CEN, DEC_CEN, RAD_CEN
en CONE_KEY, respectievelijk. Alternatief, de -j (join) schakelaar voegt alle kolommen toe
van de lijstrij naar de uitvoerrij (in wezen een samenvoeging van de lijstrij en de invoerrij),
samen met het CONE_KEY rijnummer. Deze twee schakelaars sluiten elkaar uit.

De -X en -J schakelaars schrijven voor elk dezelfde gegevens uit als hun tegenhangers in kleine letters
rij die voldoet aan een kegelzoekopdracht. Bovendien schrijven deze schakelaars ook rijen uit de
event-bestand dat niet voldoet aan een kegelzoekopdracht. In dergelijke gevallen zal die CONE_KEY-kolom dat wel doen
krijgen een waarde van -1 en de midden- en lijstpositie-informatie wordt op nul gezet
voor de gegeven rij. Alle rijen van het invoergebeurtenisbestand worden dus gegarandeerd uitgevoerd,
met rijen die voldoen aan ten minste één kegelzoekopdracht met aanvullende zoekinformatie.

De -L schakelaar werkt op dezelfde manier als de -l schakel in dat het centra uit een lijstbestand haalt.
Het stelt echter ook impliciet de schakeloptie -j in, zodat uitvoerrijen de join zijn van de
invoergebeurtenisrij en de middelste positierij. Daarnaast schrijft deze schakelaar ook alles uit
middenpositie rijen waarvoor geen enkele gebeurtenis voldoet aan de kegelzoekcriteria van die rij.
De kolom CONE_KEY krijgt een waarde van -2 voor middelste rijen die er niet dichtbij waren
gegevensrij en de gebeurteniskolommen worden voor dergelijke rijen op nul gezet. Op deze manier alle centra
rijen worden gegarandeerd minstens één keer uitgevoerd.

Als een van de "alle rijen"-schakelaars (-X, -Jof -L) zijn opgegeven, dan een nieuwe kolom met de naam JSTAT
wordt toegevoegd aan de uitvoertabel. De positieve waarden in deze kolom geven het midden aan
positie rijnummer (beginnend vanaf 1) in het lijstbestand dat deze gegevensrij succesvol is
gematcht in een kegel zoeken. Een waarde van -1 betekent dat de gegevensrij met geen enkel middelpunt overeenkomt
positie. Een waarde van -2 betekent dat de middenpositie door geen enkele gegevensrij is geëvenaard.

Gegeven een middenpositie en straal, berekent het kegelzoekalgoritme limietparameters
voor een vak dat de gespecificeerde kegel omsluit, en test alleen rijen waarvan de positiewaarden liggen
binnen die grenzen. Voor kleine bestanden is de overhead gekoppeld aan deze kegellimiet
filteren kan ervoor zorgen dat het programma langzamer werkt dan wanneer alle gebeurtenissen zouden worden getest. Jij kan
schakel kegellimietfiltering uit met behulp van de -n schakel over om te zien of dit de verwerking versnelt
(vooral handig bij het verwerken van een grote lijst met functies).

De standaard kegelzoekopdracht gebruikt bijvoorbeeld de kolommen "RA" en "Dec" in uren en graden
(respectievelijk) en RA positie in uren, Dec en radius in graden:

funone in.past uit.past 23.45 34.56 0.01

Om de RA-positie in graden op te geven:

funcone in.past uit.past 23.45d 34.56 0.01

Om RA en Dec uit een lijst te halen, maar gebruik een statische waarde voor radius (en schrijf ook
identificerende informatie voor elke rij in de lijst):

funcone -x -l lijst.txt in.fits out.fits MYRA MYDec 0.01

Door de gebruiker opgegeven kolommen in graden, RA-positie in uren (sexagesimale notatie), dec
positie in graden (sexagesimale notatie) en straal in boogminuten:

funcone -r myRa:d -d myDec in.fits out.fits 12:30:15.5 30:12 15'

Gebruik funcone online met behulp van onworks.net-services