funcone - Online w chmurze

PROGRAM:

IMIĘ

funcone - przeszukiwanie stożkowe tabeli binarnej zawierającej kolumny RA, Dec

STRESZCZENIE

stożek funkcyjny [kolumny]

OPCJE

-d deccol:[hdr] # Nazwa kolumny Dec, jednostki (def: DEC:d)
-j # dołącz kolumny z pliku listy
-J # dołącz kolumny z pliku listy, wypisz wszystkie wiersze
-l plik listy # odczytuje środki i promienie z listy
-L plik listy # odczytuje środki i promienie z listy, wyświetla wiersze listy
-n # nie używaj limitów stożka jako filtra
-r racol:[hdr] # nazwa kolumny RA, jednostki (def: RA:h)
-x # dołącz kolumny RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY
-X # dołącz kolumny RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY, wypisz wszystkie wiersze

OPIS

Funcone przeprowadza wyszukiwanie stożkowe w kolumnach RA i Dec tabeli binarnej FITS. The
odległość od centrum RA, pozycja Dec do RA, Dec w każdym rzędzie tabeli
obliczony. Wyprowadzane są wiersze, których odległość jest mniejsza niż określony promień.

Pierwszy argument programu określa plik FITS, plik zdarzeń raw lub tablicę raw
plik. Jeśli określono "stdin", dane są odczytywane ze standardowego wejścia. Użyj Funtools
Notacja nawiasów, aby określić rozszerzenia FITS i filtry. Drugim argumentem jest
wyjściowy plik FITS. Jeśli określono "stdout", tabela binarna FITS jest zapisywana w
standardowe wyjście.

Trzeci i czwarty wymagany argument to pozycja środkowa RA i Dec. Domyślnie,
RA jest podawany w godzinach, a Dec jest podawany w stopniach. Można zmienić jednostki
dowolną z nich poprzez dodanie znaku „d” (stopnie), „h” (godziny) lub „r” (radiany).
Obsługiwana jest notacja sześćdziesiętna, w której dwukropki lub spacje oddzielają hms i dms. (Gdy
używając spacji, upewnij się, że cały ciąg znaków został podany w cudzysłowie.)

Piątym wymaganym argumentem jest promień wyszukiwania stożka. Domyślnie wartość promienia
podaje się w stopniach. Jednostki można zmienić dodając znak „d” (stopnie),
„r” (radiany), „”” (minuty łukowe) lub „”” (sekundy łukowe).

Domyślnie wszystkie kolumny pliku wejściowego są kopiowane do pliku wyjściowego. Wybrane kolumny
można wyprowadzić za pomocą opcjonalnego szóstego argumentu w postaci:

"kolumna1 kolumna1 ... kolumnaN"

Siódmy argument umożliwia wyświetlenie wybranych kolumn z pliku listy, gdy -j wyłącznik
Jest używane. Należy pamiętać, że kolumny RA i Dec użyte w obliczeniach stożka nie mogą być takie
odznaczono.

Domyślnie nazwy kolumn RA i Dec noszą nazwy „RA” i „Dec” i są podawane w formacie
odpowiednio jednostki godzin i stopni. Możesz zmienić zarówno nazwę, jak i używane jednostki
przełączniki -r [RA] i/lub -d [Dec]. Po raz kolejny dołączono jedno z „h”, „d” lub „r”.
nazwę kolumny, aby określić jednostki, ale w tym przypadku musi znajdować się dwukropek „:” pomiędzy
nazwa i specyfikacja jednostki.

Jeśli -l [plik listy] używany jest przełącznik, wówczas jeden lub więcej środkowych RA, środkowych Dec i
promień można pobrać z pliku listy (który może być tabelą FITS lub tekstem kolumny ASCII
plik). W tym przypadku trzeci (środek RA), czwarty (środek Dec) i piąty (promień)
argumenty wiersza poleceń mogą być nazwą kolumny w pliku listy (jeśli ten parametr
jest różny) lub wartość numeryczną (jeśli ten parametr jest statyczny). Gdy nazwa kolumny to
określonych dla RA, Dec lub promienia, możesz dołączyć dwukropek, po którym następuje „h”, „d” lub „r”
aby określić jednostki (także ' i " dla promienia). Algorytm wyszukiwania stożka jest uruchamiany raz dla każdego
wiersz na liście, pobierając wartości RA, Dec i promień z określonych kolumn lub z
statyczne wartości liczbowe określone w wierszu poleceń.

Podczas korzystania z listy wszystkie prawidłowe wiersze z każdej iteracji są zapisywane w jednym pliku wyjściowym.
Użyj -x przełącznik, aby pomóc określić, która linia pliku listy została użyta do utworzenia
podane wiersze wyjściowe. Ten przełącznik powoduje zmianę wartości środka RA, Dec, promienia i
numer wiersza, który ma zostać dołączony do pliku wyjściowego, w kolumnach o nazwach RA_CEN, DEC_CEN, RAD_CEN
i odpowiednio CONE_KEY. Alternatywnie, -j Przełącznik (dołącz) dołączy wszystkie kolumny
z wiersza listy do wiersza wyjściowego (zasadniczo połączenie wiersza listy i wiersza wejściowego),
wraz z numerem wiersza CONE_KEY. Te dwa przełączniki wykluczają się wzajemnie.

Połączenia -X i -J przełączniki zapisują dla każdego te same dane, co ich odpowiedniki pisane małymi literami
wiersz spełniający kryteria wyszukiwania stożkowego. Ponadto przełączniki te zapisują również wiersze z pliku
plik zdarzeń, który nie spełnia kryteriów wyszukiwania stożkowego. W takich przypadkach kolumna CONE_KEY będzie
otrzymać wartość -1, a informacje o środku i pozycji listy zostaną ustawione na zero
dla danego wiersza. W ten sposób gwarantuje się, że wszystkie wiersze wejściowego pliku zdarzeń zostaną wypisane,
z wierszami spełniającymi co najmniej jedno wyszukiwanie stożkowe i posiadającymi dodatkowe informacje o wyszukiwaniu.

Połączenia -L przełącznik działa podobnie do -l włączyć, ponieważ pobiera centra z pliku listy.
Jednak domyślnie ustawia również przełącznik -j, tak że wiersze wyjściowe są połączeniem
wiersz zdarzeń wejściowych i wiersz pozycji środkowej. Ponadto ten przełącznik zapisuje również wszystko
wiersze pozycji środkowej, dla których żadne zdarzenie nie spełnia kryteriów wyszukiwania stożka dla tego wiersza.
Kolumna CONE_KEY otrzyma wartość -2 dla środkowych wierszy, które nie były blisko żadnego
wiersz danych, a kolumny zdarzeń zostaną w przypadku takich wierszy wyzerowane. W ten sposób wszystkie ośrodki
gwarantuje się, że wiersze zostaną wypisane co najmniej raz.

Jeśli którykolwiek z przełączników „wszystkich wierszy” (-X, -Jlub -L) zostaną określone, wówczas nowa kolumna o nazwie JSTAT
jest dodawany do tabeli wyjściowej. Wartości dodatnie w tej kolumnie wskazują środek
umieść numer wiersza (zaczynając od 1) w pliku listy, że ten wiersz danych zakończył się pomyślnie
dopasowane w wyszukiwaniu stożkowym. Wartość -1 oznacza, że ​​wiersz danych nie pasuje do żadnego środka
pozycja. Wartość -2 oznacza, że ​​żaden wiersz danych nie pasuje do pozycji środkowej.

Biorąc pod uwagę położenie środka i promień, algorytm wyszukiwania stożka oblicza parametry graniczne
dla pudełka otaczającego określony stożek i testuje tylko wiersze, których wartości pozycji leżą
w tych granicach. W przypadku małych plików obciążenie związane z tym limitem stożka
filtrowanie może spowodować, że program będzie działał wolniej niż w przypadku testowania wszystkich zdarzeń. Możesz
wyłącz filtrowanie limitu stożka za pomocą -n przełącznik, aby sprawdzić, czy przyspiesza to przetwarzanie
(szczególnie przydatne przy przetwarzaniu dużej listy stanowisk).

Na przykład domyślne wyszukiwanie stożkowe wykorzystuje kolumny „RA” i „Dec” zawierające godziny i stopnie
(odpowiednio) i pozycja RA w godzinach, Dec i promień w stopniach:

funone.pasuje.pasuje.pasuje 23.45 34.56 0.01

Aby określić pozycję RA w stopniach:

funcone wchodzi.pasuje.pasuje 23.45d 34.56 0.01

Aby pobrać RA i Dec z listy, ale użyj statycznej wartości promienia (a także napisz
informacje identyfikujące dla każdego wiersza na liście):

funcone -x -l list.txt in.pasuje.pasuje MYRA MYDec 0.01

Określone przez użytkownika kolumny w stopniach, pozycja RA w godzinach (notacja sześćdziesiątkowa), grudzień
pozycja w stopniach (notacja sześćdziesiątkowa) i promień w minutach łukowych:

funcone -r myRa:d -d mójDec wchodzi.pasuje.pasuje 12:30:15.5 30:12 15'

Korzystaj z funcone online, korzystając z usług onworks.net