funcone - онлайн в хмарі

ПРОГРАМА:

ІМ'Я

funcone - конусний пошук двійкової таблиці, що містить стовпці RA, Dec

СИНТАКСИС

funcone [стовпці]

ВАРІАНТИ

-d deccol:[hdr] # назва стовпця грудня, одиниці (def: DEC:d)
-j # об'єднати стовпці з файлу списку
-J # об'єднати стовпці з файлу списку, вивести всі рядки
-l файл списку # читання центрів і радіусів зі списку
-L файл списку # читання центрів і радіусів зі списку, виведення рядків списку
-n # не використовувати межі конуса як фільтр
-r racol:[hdr] # назва стовпця RA, одиниці (def: RA:h)
-x # додати стовпці RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY
-X # додати стовпці RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY, вивести всі рядки

ОПИС

Funcone виконує пошук конуса в стовпцях RA і Dec двійкової таблиці FITS. The
відстань від центру RA, положення Dec до RA, Dec в кожному рядку таблиці дорівнює
розраховано. Виводяться рядки, відстань яких менша за вказаний радіус.

Перший аргумент програми визначає файл FITS, необроблений файл подій або необроблений масив
файл. Якщо вказано "stdin", дані зчитуються зі стандартного введення. Використовуйте Funtools
Позначення в дужках для визначення розширень і фільтрів FITS. Другим аргументом є
вихідний файл FITS. Якщо вказано "stdout", двійкова таблиця FITS записується в файл
стандартний вихід.

Третій і четвертий обов'язкові аргументи - це RA і Dec центральне положення. За замовчуванням,
RA вказується в годинах, а грудень — у градусах. Ви можете змінити одиниці вимірювання
будь-який з них шляхом додавання символу "d" (градуси), "h" (години) або "r" (радіани).
Підтримується шестидесятирічне позначення з двокрапками або пробілами, що розділяють hms і dms. (Коли
використовуючи пробіли, переконайтеся, що весь рядок у лапках.)

П’ятий необхідний аргумент – радіус пошуку конуса. За замовчуванням значення радіусу
подається в градусах. Одиниці вимірювання можна змінити, додавши символ "d" (градуси),
"r" (радіани), "'" (дугові хвилини) або '"' (дужні секунди).

За замовчуванням усі стовпці вхідного файлу копіюються у вихідний файл. Вибрані стовпці
можна вивести за допомогою необов’язкового шостого аргументу у формі:

"стовпець1 стовпець1 ... стовпецьN"

Сьомий аргумент дозволяє виводити вибрані стовпці з файлу списку, коли -j перемикання
використовується. Зауважте, що стовпці RA і Dec, які використовуються для обчислення конуса, не повинні бути
скасовано вибір.

Також за замовчуванням назви стовпців RA і Dec мають імена "RA" і "Dec" і вказуються
одиниці годин і градусів відповідно. Ви можете змінити як назву, так і одиниці за допомогою
перемикачі -r [RA] та/або -d [Dec]. Ще раз додається один із "h", "d" або "r".
ім'я стовпця для визначення одиниць вимірювання, але в цьому випадку між символами має бути двокрапка ":".
назва та специфікація одиниці.

Якщо -l [файл списку] використовується перемикач, то один або кілька з центрального RA, центрального Dec і
radius можна взяти з файлу списку (який може бути таблицею FITS або текстом стовпця ASCII
файл). У цьому випадку третій (центр RA), четвертий (центр Dec) і п'ятий (радіус)
Аргументи командного рядка можуть бути іменем стовпця у файлі списку (якщо цей параметр
змінюється) або числове значення (якщо цей параметр статичний). Коли ім’я стовпця є
визначені для RA, Dec або radius, ви можете додати двокрапку, за якою слідують "h", "d" або "r"
щоб вказати одиниці (також ' і " для радіусу). Алгоритм пошуку конуса запускається один раз для кожного
рядок у списку, беручи значення RA, Dec та радіусу із вказаних стовпців або з
статичні числові значення, зазначені в командному рядку.

При використанні списку всі дійсні рядки з кожної ітерації записуються в один вихідний файл.
Використовувати -x перемикач, щоб допомогти визначити, який рядок файлу списку був використаний для створення
даний рядок(и) виведення. Цей перемикач викликає значення для центру RA, Dec, radius і
номер рядка, який буде додано до вихідного файлу, у стовпцях під назвою RA_CEN, DEC_CEN, RAD_CEN
і CONE_KEY відповідно. Як варіант, -j Перемикач (приєднання) додасть усі стовпці
від рядка списку до вихідного рядка (по суті, об’єднання рядка списку та рядка введення),
разом із номером рядка CONE_KEY. Ці два перемикачі є взаємовиключними.

Команда -X та -J перемикачі записують ті самі дані, що й їхні аналоги в нижньому регістрі для кожного
рядок, що задовольняє пошук конуса. Крім того, ці перемикачі також записують рядки з
файл подій, які не задовольняють жодному пошуку конуса. У таких випадках цей стовпець CONE_KEY буде
отримати значення -1, а інформацію про центр і положення в списку буде встановлено на нуль
для даного рядка. Таким чином, всі рядки вхідного файлу подій гарантовано будуть виведені,
з рядками, що задовольняють принаймні один конусний пошук, що мають додаткову інформацію про пошук.

Команда -L перемикач діє аналогічно -l перемикач у тому, що він бере центри з файлу списку.
Однак він також неявно встановлює перемикач -j, так що вихідні рядки є об'єднанням
рядок подій введення та рядок центральної позиції. Крім того, цей перемикач також записує все
центральні рядки, для яких жодна подія не задовольняє критеріям пошуку конуса цього рядка.
Стовпцю CONE_KEY буде надано значення -2 для центральних рядків, які не були близькими до жодного
рядок даних і стовпці подій будуть обнулені для таких рядків. Таким чином всі центри
рядки гарантовано виводяться принаймні один раз.

Якщо будь-який з перемикачів "всі рядки" (-X, -Jабо -L), а потім новий стовпець з іменем JSTAT
додається до вихідної таблиці. Додатні значення в цьому стовпці вказують на центр
номер рядка (починаючи з 1) у файлі списку, що цей рядок даних успішно
збігається в конусному пошуку. Значення -1 означає, що рядок даних не відповідає жодному центру
позицію. Значення -2 означає, що центральне положення не відповідає жодному рядку даних.

Враховуючи положення центру та радіус, алгоритм пошуку конуса обчислює граничні параметри
для поля, що охоплює вказаний конус, і перевіряє лише рядки, значення позицій яких лежать
в цих межах. Для невеликих файлів накладні витрати, пов’язані з цим конусом, обмежуються
фільтрація може призвести до того, що програма буде працювати повільніше, ніж якби всі події були перевірені. Ти можеш
вимкніть фільтрацію конуса за допомогою -n перемкніть, щоб перевірити, чи прискорить це обробку
(особливо корисно при обробці великого списку позицій).

Наприклад, пошук конуса за замовчуванням використовує стовпці "RA" і "Dec" у годинах і градусах
(відповідно) і положення RA в годинах, грудні та радіусі в градусах:

funone in.fits out.fits 23.45 34.56 0.01

Щоб вказати положення RA в градусах:

funcone in.fits out.fits 23.45d 34.56 0.01

Щоб отримати RA і Dec зі списку, але використовувати статичне значення для радіуса (а також записати
ідентифікаційна інформація для кожного рядка в списку):

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

Вказані користувачем стовпці в градусах, положення RA в годинах (шістдесятеричне позначення), груд
положення в градусах (шістдесятеричне позначення) і радіус в дугових хвилинах:

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

Використовуйте funcone онлайн за допомогою служб onworks.net