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

ПРОГРАММА:

ИМЯ

funjoin - объединить две или более двоичных таблиц FITS по указанным столбцам

СИНТАКСИС

веселье [переключатели] ...

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

-a cols # столбцы для активации во всех файлах
-a1 cols ... an cols # столбцов для активации в каждом файле
-b 'c1: bvl, c2: bv2' # пустые значения для общих столбцов во всех файлах
-bn 'c1: bv1, c2: bv2' # пустые значения для столбцов в определенных файлах
-j col # столбец для объединения всех файлов
-j1 col ... jn col # столбец для присоединения к каждому файлу
-m min # min соответствует выводимой строке
-M max # max совпадений для вывода строки
-s # добавить столбец статуса 'jfiles'
-S col # добавить col как столбец статуса
-t tol # допуск для объединения числовых столбцов [только 2 файла]

ОПИСАНИЕ

веселье объединяет строки из двух или более (до 32) файлов двоичных таблиц FITS на основе
значения указанных столбцов соединения в каждом файле. NB: столбцы соединения должны иметь индекс
связанный с ним файл. Эти файлы создаются с использованием Funindex программу.

Первый аргумент программы указывает первую входную таблицу FITS или файл необработанных событий.
Если указано "stdin", данные считываются со стандартного ввода. Последующие аргументы
укажите дополнительные файлы событий и таблицы для объединения. Последний аргумент - это выход FITS
.

NB: делать не используйте нотацию скобок Funtools, чтобы указать расширения FITS и фильтры строк, когда
запускаете funjoin, иначе вы получите неверные результаты. Доступ к строкам и их соединение осуществляется с помощью
index файлы напрямую, и это обходит всю фильтрацию.

Столбцы соединения указываются с помощью -j кол переключатель (который указывает имя столбца для
использовать для всех файлов) или с -j1 col1, -j2 col2... -джин Coln переключатели (которые определяют
имя столбца для использования в каждом файле). Столбец соединения должен быть указан для каждого файла. Если оба
-j кол и -джин Coln указаны для данного файла, то используется последний. Соединить столбцы
должен иметь строковый или числовой тип; недопустимо смешивать числовые и строковые
столбцы в данном соединении. Например, чтобы объединить три файла, используя один и тот же ключевой столбец для
каждый файл используйте:

ключ funjoin -j

Для третьего файла можно указать другой ключ таким образом:

funjoin -j key -j3 otherkey

Ассоциация -a "cols" переключатель (и -A1 "col1", -A2 "cols2" аналоги) можно использовать для указания
столбцы для активации (т.е. записи в выходной файл) для каждого входного файла. По умолчанию все
выводятся столбцы.

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

Ассоциация -m мин и -M Макс переключатели определяют минимальное и максимальное количество соединений, необходимых для
выпишите строку. Минимальное значение по умолчанию - 0 объединений (т. Е. Все строки записаны), а
максимум по умолчанию - 63 (максимальное количество возможных объединений с ограничением 32 входных
файлы). Например, чтобы выписать только те строки, в которых ровно два файла имеют столбцы
это совпадение (т.е. одно соединение):

funjoin -j key -m 1 -M 1 in1. подходит для in2.подходит для in3.подходит ...

Данная строка может иметь необходимое количество объединений без объединения всех файлов.
(например, три файла соединяются, но только два имеют заданное значение ключа соединения). В этом
В этом случае все столбцы несоединенного файла по умолчанию записываются с использованием пробелов.
(нули или NULL). В -b c1: bv1, c2: bv2 и -b1 'c1: bv1, c2: bv2' -b2 'c1: bv1, c2 - bv2' ...
переключатели могут использоваться для установки пустого значения для столбцов, общих для всех файлов и / или столбцов
в указанном файле соответственно. Каждая пустая строка значений содержит список, разделенный запятыми.
of column: спецификаторы blank_val. Для значений с плавающей запятой (одинарных или двойных) регистр -
нечувствительное строковое значение «nan» означает, что следует использовать IEEE NaN (не число).
Так, например:

funjoin -b "AKEY: ???" -b1 "A: -1" -b3 "G: NaN, E: -1, F: -100" ...

означает, что несоединенный столбец AKEY в любом файле будет содержать строку «???», а не-
Соединенные Столбец файла 1 будет содержать значение -1, несоединенный столбец G файла 3
будут содержать IEEE NaN, в то время как несоединенные столбцы E и F того же файла будут содержать
значения -1 и -100 соответственно. Конечно, там, где есть общие и конкретные пустые значения.
указано для того же столбца, используется конкретное пустое значение.

Чтобы различать, какие файлы не являются пустыми компонентами данной строки, -s (статус) переключатель
может использоваться для добавления столбца битовой маски с именем «JFILES» в выходной файл. В этом столбце
бит устанавливается для каждого непустого файла, составляющего данную строку, при этом бит 0 соответствует
первый файл, бит 1 для второго файла и так далее. Сами имена файлов хранятся в
заголовок FITS как параметры с именами JFILE1, JFILE2 и т. д. -S кол переключатель позволяет
измените имя столбца статуса с "JFILES" по умолчанию.

Соединение между строками - это декартово произведение всех строк в одном файле, имеющих данное соединение.
значение столбца со всеми строками во втором файле, имеющими одинаковое значение для столбца соединения и
скоро. Таким образом, если file1 имеет 2 строки со значением столбца соединения 100, file2 имеет 3 строки с
то же значение, а файл 3 имеет 4 строки, тогда в результате объединения получается 2 * 3 * 4 = 24 строки.

Алгоритм соединения напрямую обрабатывает индексный файл, связанный со столбцом соединения
каждый файл. Наименьшее значение из всех текущих столбцов выбирается в качестве основы, и это
value используется для объединения однозначных столбцов в других файлах. Таким образом, индекс
файлы просматриваются ровно один раз.

Ассоциация -t тол переключатель определяет значение допуска для числовых столбцов. В настоящее время
значение допуска может объединять только два файла одновременно. (Совершенно другой алгоритм
требуется для соединения более двух файлов, используя допуск, что-то мы могли бы рассмотреть
реализация в будущем.)

В следующем примере показаны многие функции funjoin. Входные файлы t1.fits,
t2.fits и t3.fits содержат следующие столбцы:

[ш] фундисп т1.фитс
AKEY KEY AB
----------- ------ ------ ------
ааа 0 0 1
BBB 1 3 4
ссс 2 6 7
ддд 3 9 10
эээ 4 12 13
5 15 16
ггг 6 18 19
чч 7 21 22

Fundisp t2.fits
AKEY KEY CD
----------- ------ ------ ------
III 8 24 25
ггг 6 18 19
эээ 4 12 13
ссс 2 6 7
ааа 0 0 1

Fundisp t3.fits
AKEY KEY EFG ------------ ------ -------- --------
-----------
гГГ 6 18 19 100.10
jjj 9 27 28 200.20
ааа 0 0 1 300.30
ддд 3 9 10 400.40

Учитывая эти входные файлы, следующая команда funjoin:

funjoin -s -a1 "-B" -a2 "-D" -a3 "-E" -b \
"КЛЮЧ:???" -b1 "AKEY: XXX, A: 255" -b3 "G: NaN, E: -1, F: -100" \
-j ключ t1.подходит t2.подходит t3.подходит foo.подходит

соединит файлы в столбце KEY, выводя все столбцы, кроме B (в t1.fits), D (в
t2.fits) и E (в t3.fits) и установка пустых значений для AKEY (глобально, но переопределено
для t1.fits) и A (в файле 1) и G, E и F (в файле 3). Столбец JFILES будет
output, чтобы отметить, какие файлы использовались в каждой строке:

AKEY KEY A AKEY_2 KEY_2 C AKEY_3 KEY_3 FG JFILES
------------ ------ ------ ------------ ------ ------ - ---------- ------ -------- ----------- --------
ааа 0 0 ааа 0 0 ааа 0 1 300.30 7
bbb 1 3 ??? 0 0 ??? 0-100 нан 1
ccc 2 6 ccc 2 6 ??? 0-100 нан 3
ддд 3 9 ??? 0 0 ддд 3 10 400.40 5
eee 4 12 eee 4 12 ??? 0-100 нан 3
fff 5 15 ??? 0 0 ??? 0-100 нан 1
гГГ 6 18 гГГ 6 18 гГГ 6 19 100.10 7
ххх 7 21 ??? 0 0 ??? 0-100 нан 1
XXX 0 255 iii 8 24 ??? 0-100 нан 2
XXX 0 255 ??? 0 0 jjj 9 28 200.20 4

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