fundisp - Интернет в облаке

ПРОГРАММА:

ИМЯ

fundisp - отображение данных в файле данных Funtools

СИНТАКСИС

Fundisp [-f формат] [-l] [-n] [-T] [столбцы⎪bitpix = n]

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-f # строка формата для отображения
-l # отображать изображение в виде списка, содержащего столбцы X, Y, VAL
-n # не выводить заголовок
-F [c] # использовать указанный символ в качестве разделителя столбцов (по умолчанию: пробел)
-T # вывод в формате rdb / starbase (разделители табуляции)

ОПИСАНИЕ

Fundisp отображает данные в указанном расширении FITS и / или разделе изображения FITS
файл, или в разделе не-FITS массива или необработанного файла событий.

Первый аргумент программы указывает входное изображение FITS, массив или необработанный файл событий.
для отображения. Если указано "stdin", данные считываются со стандартного ввода. Используйте Funtools
Обозначение в скобках для указания расширений FITS, разделов изображений и фильтров.

Если отображаемые данные являются столбцами (либо в двоичной таблице FITS, либо в исходном событии
файл), будут перечислены отдельные строки. Фильтры можно добавлять, используя скобки. Таким образом:

[sh] fundisp "test.ev [time- (int) time> .15]"
XY PHA PI TIME DX DY
------- ------- ------- --------- ---------------- ---- ------ ----------
10 8 10 8 17.1600 8.50 10.50
9 9 9 9 17.1600 9.50 9.50
10 9 10 9 18.1600 9.50 10.50
10 9 10 9 18.1700 9.50 10.50
8 10 8 10 17.1600 10.50 8.50
9 10 9 10 18.1600 10.50 9.50
9 10 9 10 18.1700 10.50 9.50
10 10 10 10 19.1600 10.50 10.50
10 10 10 10 19.1700 10.50 10.50
10 10 10 10 19.1800 10.50 10.50

[NB: тестовый файл двоичной таблицы FITS test.ev, а также файл FITS image test.fits являются
содержится в каталоге funtest.]

Когда таблица отображается с использованием Fundisp, второй необязательный аргумент можно использовать для
укажите столбцы для отображения. Например:

[sh] fundisp "test.ev [time- (int) time> =. 99]" ​​"xy time"
XY ВРЕМЯ
-------- -------- -------
5-6 40.99000000
4-5 59.99000000
-1 0 154.99000000
-2 1 168.99000000
-3 2 183.99000000
-4 3 199.99000000
-5 4 216.99000000
-6 5 234.99000000
-7 6 253.99000000

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

[sh $] fundisp "test.ev [time- (int) time> =. 99 && annulus (0 0 0 10 n = 3)]" 'xy time $ REGION'
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 $] fundisp "test.ev [time- (int) time> =. 99]" ​​"-time"
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

Отображаются все столбцы, кроме столбца времени.

Специальная колонка $N можно указать для отображения порядкового номера каждой строки. Таким образом,
продолжая предыдущий пример:

fundisp "test.ev [время- (целое) время> =. 99]" ​​'-время $ n'
XY PHA PI DX DY N
------- -------- -------- ---------- ----------- ------ ----- ----------
5-6 5-6 5.50-6.50 337
4-5 4-5 4.50-5.50 356
-1 0-1 0-1.50 0.50 451
-2 1-2 1-2.50 1.50 465
-3 2-3 2-3.50 2.50 480
-4 3-4 3-4.50 3.50 496
-5 4-5 4-5.50 4.50 513
-6 5-6 5-6.50 5.50 531
-7 6-7 6-7.50 6.50 550

Обратите внимание, что спецификация столбца заключена в одинарные кавычки, чтобы защитить $ n от начала.
расширяется оболочкой.

В общем, правила активации и деактивации столбцов следующие:

· Если указаны только исключаемые столбцы, то все столбцы, кроме исключаемых столбцов, будут
быть активированным.

· Если указаны только включаемые столбцы, то активируются только указанные столбцы.

· Если указано сочетание столбцов включения и исключения, то все, кроме исключенных
столбцы будут активными; этот последний случай неоднозначен, и правило произвольно.

Помимо явного указания имен столбцов, специальные символы + и - может быть
используется для активации и деактивации Найти столбцы. Это полезно, если вы хотите активировать
Столбец $ REGION вместе со всеми остальными столбцами. Согласно правилам, синтаксис «$ REGION»
активирует только столбец региона и деактивирует остальные. Используйте "+ $ REGION" для активации
все столбцы, а также столбец региона.

Если отображаемые данные являются данными изображения (либо в основном изображении FITS, либо в изображении FITS
расширение или файл массива) создается пиксельный дисплей размером mxn, где m и n - это
размеры изображения. По умолчанию значения пикселей отображаются с использованием одного и того же типа данных.
как в файле. Однако для целочисленных данных, где параметры заголовка BSCALE и BZERO являются
в настоящее время данные отображаются в виде чисел с плавающей запятой. В любом случае тип данных отображения может быть
переопределено с использованием необязательного второго аргумента формы:

bitpix = n

где n равно 8,16,32, -32, -64, для unsigned char, short, int, float и double соответственно.

Конечно, бег Fundisp на чем угодно, кроме самого маленького изображения, обычно приводит к отображению
чей размер делает его нечитаемым. Следовательно, можно использовать скобки (см. Ниже), чтобы
применить раздел и / или блокировку к изображению перед созданием отображения. Например:

[sh] fundisp "test.fits [2: 6,2: 7]" bitpix = -32
2 3 4 5 6
---------- ---------- ---------- ---------- ----------
2: 3.00 4.00 5.00 6.00 7.00
3: 4.00 5.00 6.00 7.00 8.00
4: 5.00 6.00 7.00 8.00 9.00
5: 6.00 7.00 8.00 9.00 10.00
6: 7.00 8.00 9.00 10.00 11.00
7: 8.00 9.00 10.00 11.00 12.00

Обратите внимание, что можно отобразить двоичную таблицу FITS в виде изображения, просто передав
таблица через забавный образ первый:

[sh] ./funimage test.ev stdout ⎪ fundisp "stdin [2: 6,2: 7]" bitpix = 8
2 3 4 5 6
------- ------- ------- ------- -------
2: 3 4 5 6 7
3: 4 5 6 7 8
4: 5 6 7 8 9
5: 6 7 8 9 10
6: 7 8 9 10 11
7: 8 9 10 11 12

Если же линия индикатора -l (список) используется переключатель, тогда изображение отображается в виде списка, содержащего
столбцы: X, Y, VAL. Например:

fundisp -l "test1.fits [2: 6,2: 7]" bitpix = -32
XY VAL
---------- ---------- -----------
2 2 6.00
3 2 1.00
4 2 1.00
5 2 1.00
6 2 1.00
2 3 1.00
3 3 5.00
4 3 1.00
5 3 1.00
6 3 1.00
2 4 1.00
3 4 1.00
4 4 4.00
5 4 1.00
6 4 1.00
2 5 1.00
3 5 1.00
4 5 1.00
5 5 3.00
6 5 1.00
2 6 1.00
3 6 1.00
4 6 1.00
5 6 1.00
6 6 2.00
2 7 1.00
3 7 1.00
4 7 1.00
5 7 1.00
6 7 1.00

Если же линия индикатора -n (nohead) используется переключатель, тогда заголовок для таблиц не выводится. Это полезно,
например, когда вывод fundisp направляется в gnuplot.

Ассоциация Fundisp программа использует стандартный набор форматов отображения:

тип данных формат TFORM
-------- ----- --------
двойной D "% 21.8f"
float E "% 11.2f"
int J "% 10d"
короткий I "% 8d"
байт B "% 6d"
строка A "% 12.12s"
биты X "% 8x"
логический L "% 1x"

Таким образом, отображение по умолчанию 1 дабл и 2 шорт дает:

[sh] fundisp snr.ev "время ху"

ВРЕМЯ XY
--------------------- -------- --------
79494546.56818075 546 201
79488769.94469175 548 201
...

Вы можете изменить формат отображения для отдельных столбцов или для всех столбцов заданного
типы данных с помощью переключателя -f. Строка формата, сопровождающая -f, является пробелом-
разделенный список ключевых слов = значений формата. Значения ключевых слов могут быть именами столбцов.
(в этом случае связанный формат относится только к этому столбцу) или таблица FITS TFORM
спецификаторы (в этом случае формат относится ко всем столбцам, имеющим этот тип данных). Для
Например, вы можете изменить двойной и короткий форматы для всех столбцов следующим образом:

[sh] fundisp -f "D =% 22.11f I =% 3d" snr.ev "время xy"

ВРЕМЯ XY
---------------------- --- ---
79494546.56818075478 546 201
79488769.94469174743 548 201
...

Кроме того, вы можете изменить формат столбцов времени и x следующим образом:

[sh] fundisp -f "time =% 22.11fx =% 3d" snr.ev "time xy"

ВРЕМЯ XY
---------------------- --- --------
79494546.56818075478 546 201
79488769.94469174743 548 201
...

Обратите внимание, что существует потенциальный конфликт, если имя столбца совпадает с именем одного из столбцов TFORM.
спецификаторы. В приведенных выше примерах столбец «X» в таблице имеет то же имя, что и
тип данных X (бит). Чтобы разрешить этот конфликт, строка формата обрабатывается так, чтобы
Сначала проверяются спецификаторы типа данных TFORM с использованием сравнения с учетом регистра. Если
указанное значение формата не является значением TFORM в верхнем регистре, тогда проверка без учета регистра
сделано по названию столбца. Это означает, что в приведенных выше примерах "X =% 3d" будет относиться к
тип данных X (бит), а "x =% 3d" будет относиться к столбцу X:

[sh] fundisp -f "X =% 3d" snr.ev "xy"

XY
-------- --------
546 201
548 201
...

[sh] fundisp -f "x =% 3d" snr.ev "xy"

XY
--- --------
546 201
548 201
...

Поэтому, как правило, лучше всегда указывать имя столбца в нижнем регистре, а TFORM
типы данных в верхнем регистре.

Ассоциация -f [формат] изменит формат для однократного выполнения команды fundisp. Вы также можете использовать
домен FUN_FORMAT переменная envronment для изменения формата всех вызовов функции fundisp.
Формат значения этой переменной среды идентичен формату, используемому с -f
выключатель. Это глобальное значение может быть переопределено в отдельных случаях с помощью -f [формат]
переключатель.

Предостережения: обратите внимание, что соответствие формату лежит на пользователе.
спецификатор к типу данных столбца правильно. Также обратите внимание, что для сохранения визуального
выравнивание между именами и столбцами, имя столбца будет обрезано (слева), если
ширина формата меньше длины имени. Однако усечение не выполняется.
если вывод находится в формате RDB (с помощью переключателя -T).

[Строка формата старого стиля поддерживается, но не рекомендуется. Он состоит из разделенных пробелами
Операторы формата C для всех типов данных, указанные в следующем порядке:

double float int бит короткой байтовой строки.

Этот порядок списка основан на предположении, что люди обычно хотят
изменить форматы с плавающей запятой.

Если вместо оператора формата для данного типа данных вводится "-", формат по умолчанию
используется. Кроме того, строка формата может быть завершена без указания всех форматов, и
для остальной части списка будут использоваться значения по умолчанию. Обратите внимание, что вы должны указать минимальное поле
width, т. е. "% 6d" и "% -6d" допустимы, "% d" недопустимы.

Используя -f [формат], вы можете изменить двойной и короткий форматы следующим образом:

[sh] fundisp -f "22.11f - - 3d" snr.ev "time xy"

ВРЕМЯ XY
---------------------- --- ---
79494546.56818075478 546 201
79488769.94469174743 548 201
...

NB: этот формат устарел и будет удален в одном из следующих выпусков.]

Ассоциация -F [c] переключатель может использоваться для указания (односимвольного) разделителя столбцов (где
по умолчанию - пробел). Обратите внимание, что форматирование столбцов почти наверняка также добавит пробелы в
дополнить отдельные столбцы необходимой шириной. Их можно удалить с помощью такой программы, как
sed за счет генерации невыровненных столбцов. Например:

fundisp -F ',' snr.ev '[cir 512 512 .1]'
X, Y, PHA, PI, ВРЕМЯ, DX, DY
512, 512, 6, 7, 79493997.45854475, 578, 574
512, 512, 8, 9, 79494575.58943175, 579, 573
512, 512, 5, 6, 79493631.03866175, 578, 575
512, 512, 5, 5, 79493290.86521725, 578, 575
512, 512, 8, 9, 79493432.00990875, 579, 573

fundisp -F ',' snr.ev '[cir 512 512 .1]' ⎪ sed 's / *, * /, / g'
X, Y, PHA, PI, ВРЕМЯ, DX, DY
512,512,6,7,79493997.45854475,578,574
512,512,8,9,79494575.58943175,579,573
512,512,5,6,79493631.03866175,578,575
512,512,5,5,79493290.86521725,578,575
512,512,8,9,79493432.00990875,579,573

fundisp -f "x =% 3d y =% 3d pi =% 1d pha =% 1d time =% 20.11f dx =% 3d dy =% 3d" -F ',' snr.ev '[cir 512
512 .1] '⎪ sed' s / *, * /, / g '
X, Y, A, I, ВРЕМЯ, DX, DY ---, ---, -, -, --------------------, ---, ---
512,512,6,7,79493997.45854474604,578,574 512,512,8,9,79494575.58943174779,579,573
512,512,5,6,79493631.03866174817,578,575 512,512,5,5,79493290.86521725357,578,575
512,512,8,9,79493432.00990875065,579,573

Если же линия индикатора -T (таблица rdb) используется переключатель, вывод будет соответствовать базе данных starbase / rdb
формат: табуляция будет вставлена ​​между столбцами, а не пробелами. Этот формат не
доступно при отображении пикселей изображения (кроме -l выключатель).

Наконец, обратите внимание, что Fundisp может использоваться для создания фильтров столбцов из вспомогательных таблиц
в файле FITS. Например, следующий код оболочки сгенерирует хороший интервал времени
(GTI) фильтр для файлов рентгеновских данных, которые содержат стандартное расширение GTI:

#!/ Бен / ш
sed '1, / ----. * / d
/ ^ $ /, $ d '⎪ awk' tot> 0 {printf "⎪⎪"}; {printf "time =" $ 1 ":" $ 2; tot ++} '

Если этот сценарий помещен в файл с именем «mkgti», его можно использовать в таких командах, как:

fundisp foo.fits "[GTI]" ⎪ mkgti> gti.filter

Полученный файл фильтра затем можно использовать в различных программах funtools:

funcnts foo.fits "[@ gti.filter]" ...

обрабатывать только события в хорошие промежутки времени.

Используйте fundisp онлайн с помощью сервисов onworks.net