funtable - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

funtable - копіює вибрані рядки з файлу Funtools у двійкову таблицю FITS

СИНТАКСИС

веселий [-a] [-i⎪-z] [-m] [-s стовпців] [стовпці]

ВАРІАНТИ

-a # додати до наявного вихідного файлу як розширення таблиці
-i # для даних зображення генерувати лише стовпці X та Y
-m # для таблиць записати окремий файл для кожного регіону
-s "col1 ..." # стовпці, за якими потрібно сортувати
-z # для даних зображення, вивести пікселі з нульовим значенням

ОПИС

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

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

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

Команда веселий Програма зазвичай використовується для вибору рядків із двійкової таблиці FITS за допомогою таблиці
Фільтри та/або фільтри просторової області. Наприклад, ви можете скопіювати лише вибрані рядки (і
вивести лише вибрані стовпці), виконавши таку команду, як:

[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

Спеціальна колонка $REGION можна вказати, щоб записати ідентифікатор регіону кожного рядка:

[sh $] funtable "test.ev[time-(int)time>=.99&&annulus(0 0 0 10 n=3)]" stdout 'xy time $REGION' ⎪ fundisp stdin
ЧАС XY ОБЛАСТЬ
--------- --------- --------------------- ----------
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

Тут лише рядки з правильним дробовим часом і чия позиція також знаходиться в межах одного з
три кільця написані.

Стовпці можна виключити з відображення за допомогою знака мінус перед стовпцем:

[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

Записуються всі стовпці, крім стовпця часу.

Загалом правила активації та деактивації стовпців такі:

· Якщо вказано лише стовпці виключення, то будуть усі стовпці, крім стовпців виключення
бути активованим.

· Якщо вказано лише стовпці включення, тоді активуються лише вказані стовпці.

· Якщо вказано комбінацію стовпців включення та виключення, то всі, крім виключення
колонки будуть активними; цей останній випадок неоднозначний і правило довільне.

На додаток до явного вказівки імен стовпців, спеціальні символи + та - може бути
використовується для активації та деактивації всі колонки. Це корисно, якщо ви хочете активувати
$REGION разом з усіма іншими стовпцями. Згідно з правилами, синтаксис "$REGION"
активує лише стовпець регіону та деактивує решту. Використовуйте "+ $REGION", щоб активувати
всі стовпці, а також стовпець регіону.

Як правило, у вихідний файл копіюється лише вибрана таблиця. У двійковій таблиці FITS,
іноді бажано скопіювати всі інші розширення FITS у вихідний файл як
добре. Це можна зробити, додавши знак «+» до назви розширення у вводі
ім'я файлу. Наприклад, перша команда нижче копіює лише таблицю EVENT, тоді як
друга команда також копіює інші розширення:

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

Якщо вхідний файл є зображенням або необробленим файлом масиву, то веселий створить FITS
двійкової таблиці зі значень пікселів у зображенні. Зауважте, що це неможливо вказати
стовпці для виведення (використовуючи аргумент командного рядка 3). Натомість є два шляхи
створити таку двійкову таблицю з зображення. За замовчуванням створюється таблиця з 3 стовпцями, де
стовпці: "X", "Y" і "VALUE". Для кожного пікселя на зображенні один рядок (подія)
створюється зі стовпцями "X" і "Y", яким присвоєно значення dim1 і dim2 зображення
піксель відповідно, а стовпець "ЗНАЧЕННЯ" присвоєно значення пікселя. З начебто
стіл, біг фунгіст у стовпці "VALUE" дасть ті самі результати, що й запуск фунгіст
на оригінальному зображенні.

Якщо -i ("окремі" рядки) вказано перемикач, тоді лише стовпці "X" і "Y"
згенеровано. У цьому випадку кожне позитивне значення пікселя на зображенні генерує n рядків (подій),
де n дорівнює цілого значення цього пікселя (плюс 0.5, для плаваючої коми
дані). В ефекті, -i приблизно відтворює рядки таблиці, які б були
закріплено у вхідному зображенні. (Звичайно, це лише приблизно вірно, оскільки
отримані позиції x, y є цілими.)

Якщо -s [стовп.1 col2 ... колон] ("сортування") вказано перемикач, вихідні рядки двійкового файлу
таблиця буде відсортована за допомогою вказаних стовпців як ключів сортування. Ключі сортування повинні бути
скалярні стовпці, а також повинні бути частиною вихідного файлу (тобто ви не можете сортувати за стовпцем
але не включати його у вихідні дані). Цей заклад використовує _сортувати програма (входить в комплект
funtools), які мають бути доступні через ваш шлях.

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

Окремі імена вихідних файлів, згенеровані файлом -m перемикач виробляються автоматично з
кореневий вихідний файл, щоб містити ідентифікатор регіону асоційованого регіону. (Зверніть увагу, що регіон
ідентифікатори починаються з 1, тому ім’я файлу, пов’язане з ідентифікатором 0, містить рядки, які передають
фільтр, але не в жодному регіоні.) Імена вихідних файлів генеруються наступним чином:

· Специфікацію $n можна використовувати в будь-якому місці в імені кореневого файлу (відповідно в лапках до
захистити його від оболонки) і буде розширено до ідентифікаційного номера пов’язаного
регіон. Наприклад:

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

створить файли з назвою foo.goo_0.fits (для рядків не в будь-якому регіоні, але все ще проходять
фільтр), foo.goo_1.fits (рядки в регіоні ID №1, перша область), foo.goo_2.fits
(рядки в регіоні з ідентифікатором №2) тощо. Зверніть увагу, що одинарні лапки у вихідному корені є обов'язковими
щоб захистити '$' від оболонки.

· Якщо $n не вказано, то ідентифікатор регіону буде розміщено перед першою крапкою (.).
ім'я файлу. Таким чином:

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

створить файли з іменем foo0.evt.fits (для рядків не в будь-якому регіоні, але все ще проходять
фільтр), foo1.evt.fits (рядки в ідентифікаторі регіону №1), foo2.evt.fits (рядки в ідентифікаторі регіону
№2) тощо.

· Якщо в імені кореневого вихідного файлу не вказано крапку, тоді буде ідентифікатор регіону
додається до імені файлу. Таким чином:

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

створить файли з іменем foo_evt0 (для рядків не в будь-якому регіоні, але все ще передає
filter), foo_evt1 (рядки в регіоні з ідентифікатором №1), foo_evt2 (рядки з ідентифікатором регіону №2) тощо.

Механізм кількох файлів забезпечує простий спосіб створення окремих файлів вихідних даних
за один прохід через дані.

За замовчуванням створюється новий файл FITS, і двійкова таблиця записується в першу
розширення. Якщо -a (append) вказано перемикач, таблиця додається до існуючої
FITS як розширення BINTABLE. Зауважте, що вихідний файл FITS вже має існувати.

Якщо -z ("нульові" значення пікселя) вказано перемикач і -i не вказано, то пікселів
які мають нульове значення, буде виведено зі стовпцем "VALUE", встановленим на нуль. Очевидно, це
перемикач не має сенсу, коли виводяться окремі події.

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