funcen - Online nel cloud

PROGRAMMA:

NOME

funcen - trova centroide (per tabelle binarie)

SINOSSI

funzione [-i] [-n iter] [-t tol] [-v lev]

VERSIONI

-i # usa il filtro delle immagini (predefinito: filtro degli eventi)
-n iter # numero massimo di iterazioni (default: 0)
-t tol # distanza di tolleranza pixel (predefinito: 1.0)
-v [0,1,2,3] # restituisce il livello di verbosità (predefinito: 0)

DESCRIZIONE

funzione calcola iterativamente la posizione del baricentro all'interno di una o più regioni di a
Tabella Funtools (tabella binaria FITS o file evento raw). A partire da una tabella di input, an
specificazione della regione iniziale e un conteggio delle iterazioni, il programma calcola la media x
e y posizione all'interno della regione e quindi utilizza questa nuova posizione come centro della regione per
la prossima iterazione. L'iterazione termina quando viene raggiunto il numero massimo di iterazioni
o quando viene soddisfatta la distanza di tolleranza di input per quella regione. Un conteggio di eventi nel
viene quindi emessa la regione finale, insieme al valore della posizione dei pixel (e, se disponibile,
posizione WCS).

Il primo argomento del programma specifica il file della tabella Funtools da elaborare. Dal momento che
file deve essere letto ripetutamente, un valore di "stdin" non è consentito quando il numero di
iterazioni è diverso da zero. Usa la notazione tra parentesi di Funtools per specificare le estensioni FITS e
filtri.

Il secondo argomento obbligatorio è il descrittore di regione iniziale. Più regioni sono
permesso. Tuttavia, le regioni composte (acceleratori, regioni e regioni ad argomento variabile
connessi tramite algebra booleana) non sono consentiti. Anche punti e poligoni sono illegali.
Queste restrizioni potrebbero essere revocate in una versione futura, se giustificato.

I -n (numero di iterazione) specifica il numero massimo di iterazioni da eseguire.
Il valore predefinito è 0, il che significa che il programma conterà e visualizzerà semplicemente il numero di
eventi nella/e regione/i iniziale/i. Nota che quando le iterazioni sono 0, i dati possono essere inseriti
tramite stdin.

I -t (tolleranza) specifica un valore di tolleranza in virgola mobile. Se la distanza
tra il valore della posizione del centroide corrente e gli ultimi valori della posizione è inferiore a questo
valore, l'iterazione termina. Il valore predefinito è 1 pixel.

I -v (verbosità) specifica il livello di verbosità dell'output. Il valore predefinito è 0,
che si traduce in una singola riga di output per ciascuna regione di input costituita dalle seguenti
valori:

conta xy [ra dec coordsys]

Gli ultimi 3 valori WCS vengono emessi se le informazioni WCS sono disponibili nell'intestazione del file di dati.
Così, ad esempio:

[sh] funcen -n 0 snr.ev "cir 505 508 5"
915 505.00 508.00 345.284038 58.870920 j2000

[sh] funcen -n 3 snr.ev "cir 505 508 5"
1120 504.43 509.65 345.286480 58.874587 j2000

Il primo esempio conta semplicemente il numero di eventi nella regione iniziale. Il secondo
esempio itera il calcolo del centroide tre volte per determinare un "migliore" finale
posizione.

Livelli più alti di verbosità ovviamente implicano un output più dettagliato. Al livello 1, l'uscita
contiene essenzialmente le stesse informazioni del livello 0, ma con la formattazione delle parole chiave:

[sh] funcen -v 1 -n 3 snr.ev "cir 505 508 5"
file_evento: snr.ev
regione_iniziale: cir 505 508 5
tolleranza: 1.0000
iterazioni: 1

eventi: 1120
x,y (fisico): 504.43 509.65
ra,dec(j2000): 345.286480 58.874587
final_region1: cir 504.43 509.65 5

Anche i risultati di livello 2 derivano da calcoli intermedi.

Normalmente, il filtraggio della regione viene eseguito utilizzando il filtraggio analitico (evento), ovvero quello stesso
stile di filtraggio eseguito da fondi ed divertente. Usa il -i passare a specificare
filtraggio delle immagini, ovvero lo stesso stile di filtraggio eseguito da funzioni. Quindi, puoi
eseguire un rapido calcolo dei conteggi nelle regioni, utilizzando l'analitica o l'immagine
metodo di filtraggio, specificando il
-n 0 e facoltativo -i interruttori. Questi due metodi spesso danno risultati diversi a causa di
come vengono elaborati gli eventi limite:

[sh] funcen snr.ev "cir 505 508 5"
915 505.00 508.00 345.284038 58.870920 j2000

[sh] funcen -i snr.ev "cir 505 508 5"
798 505.00 508.00 345.284038 58.870920 j2000

Vedere Confini della regione per ulteriori informazioni su come vengono calcolati i confini utilizzando questi
due metodi.

Utilizzare funcen online utilizzando i servizi onworks.net