РУКОВОДСТВО ПО ИСПОЛЬЗОВАНИЮ ПРОГРАММЫ CROSSMATCH

1. Распакуйте архив. Файлы Stilts.jar и Crossmatch.jar должны находится в одной папке.
2. Откройте окно команд в этой папке.
3. Введите следующую команду: java -jar Crossmatch.jar [параметры]

	Обязательные параметры:
	
	ra - прямое восхождение
	dec - склонение
	area_radius - радиус области в градусах
	crossmatch_radius - радиус отождествления в секундах
	
	Следующие параметры имеют значения по умолчанию, поэтому их объявление в командной строке не является обязательным:
	
	apass_crossmatch_radius - радиус отождествления в секундах для каталога APASS. По умолчанию устанавливается равным 2*crossmatch_radius

	main_catalogue - выбор опорного каталога. По умолчанию опорным каталогом считается IPHAS, другие варианты: ALLWISE, URAT1, 2MASS, USNOB1, UCAC5, GAIA, VPHAS

	filter - задание ограничений на входные данные. Схема запроса: filter=[название_каталога]: "условия фильтрации". После двоеточия пробел обязателен; внутри 
	кавычек разрешено использование пробелов. Если несколько условий накладывается на несколько каталогов, то параметр filter используется столько раз, сколько 
	каталогов должно быть подвергнуто фильтрации. Если для одного каталога используется несколько условий, то взаимоотношения между ними описываются бинарными 
	операторами || (или) и && (и).
	(Внимание! Не все названия столбцов могут быть правильно прочитаны при фильтрации. В качестве альтернативы можно использовать UCD-идентификатор столбца, 
	указанный на странице соответствующего каталога в VizieR, с заменой всех небуквенных символов на символ "_" и с префиксом ucd$.)
	По умолчанию задан фильтр для каталога VPHAS: "fprimary == 1". Это сделано ради исключения множественных измерений одного объекта.
	Также по умолчанию заданы фильтры для каталогов ALLWISE ("equals (ccf, padWithZeros (0, 4) )") и 2MASS ("equals (Cflg, padWithZeros (0, 3) )").

	addcol - добавление столбцов. Схема запроса: addcol=[название_каталога]: "названия столбцов". После двоеточия пробел обязателен; внутри кавычек 
	перечисляемые названия столбцов разделяются пробелами.
	Если добавляются столбцы для нового каталога, то первыми по порядку должны идти координатные столбцы, значения которых будут использованы при кроссматче.

	addcat - добавление каталога. Схема запроса: addcat=[название_каталога]: "идентификатор каталога". После двоеточия пробел обязателен. В кавычках вводится
	идентификатор каталога в базе данных VizieR, включающий в себя римскую цифру, косую черту и число, записанное арабскими цифрами (например, II/341 для GAIA).
	Вместе с addcat следует использовать addcol для того же каталога, чтобы указать все необходимые столбцы.
	Сразу после запуска программа выведет URL, по которому она будет пытаться загрузить таблицу данных из добавленного каталога.
	Если таблица из каталога находится на диске, то вместо идентификатора каталога надо написать "PATH:[путь к таблице]". Путь может быть как относительным, так и 
	абсолютным. Файл с любым расширением, кроме .csv, считается файлом в формате ASCII.

	magic_value - заполнение пустых ячеек. По умолчанию пустые ячейки отмечаются значением 999.99; чтобы отключить заполнение ячеек, введите: magic_value=off

	out - название файла, содержащего итоговую таблицу. По умолчанию файл будет назван match_[ra]_[dec]_[area_radius]_[crossmatch_radius].txt 
	и будет иметь формат ASCII. Также возможен вывод в формате CSV.
	
Внимание! При присвоении параметрам значений в командной строке не рекомендуется выделять знак равенства пробелами.

При работе с большими таблицами объёма памяти (java heap memory), выделенного по умолчанию, может не хватить. Чтобы изменить значение объёма выделяемой памяти, 
используйте параметр -Xmx. Например, -Xmx512m увеличивает объём java heap memory до 512 мегабайт.
	
Примеры запросов:

java -Xmx512m -jar Crossmatch.jar ra=298.052 dec=29.408 area_radius=0.1667 crossmatch_radius=2 magic_value=off out=test.txt

Кроссматч проводится в области с координатами 298.052 +29.408 и радиусом 0.1667 градусов (около 10 минут). Радиус отождествления равен 2 секундам для всех 
каталогов, кроме APASS - для него радиус отождествления равен 4 секундам. Основной каталог - IPHAS, фильтров нет. Результат будет записан в файл test.txt в 
формате ASCII без предварительной обработки пустых ячеек. Для работы программы выделено 512 МБ.

java -jar Crossmatch.jar ra=298.052 dec=29.408 area_radius=0.1667 crossmatch_radius=2 apass_crossmatch_radius=3

Дополнительно задан радиус отождествления для APASS, равный трём секундам. Результат будет записан в файл 298.052_29.408_0.1667_2.txt с заполнением пустых 
ячеек значением 999.99.

java -jar Crossmatch.jar ra=298.052 dec=29.408 area_radius=0.1667 crossmatch_radius=2 main_catalogue=UCAC5

В качестве основного каталога устанавливается каталог UCAC5.

java -jar Crossmatch.jar ra=298.052 dec=29.408 area_radius=0.1667 crossmatch_radius=2 filter=IPHAS: "r < 19 || i < 19" filter=GAIA: "ucd$phot_mag_stat_mean_em_opt < 19"

На входные данные из двух каталогов наложены ограничения. В каталоге IPHAS значения в столбцах r или i должны быть меньше 19. В каталоге GAIA значения столбца 
<Gmag> должны быть меньше 19, но угловые скобки в названии столбца могут быть восприняты программой как знаки "больше" и "меньше", поэтому в запросе 
используется UCD-идентификатор с соответствующим префиксом и заменой всех небуквенных символов на символ "_".

java -jar Crossmatch.jar ra=298.052 dec=29.408 area_radius=0.1667 crossmatch_radius=2 addcol=2MASS: "dup use"

В итоговую таблицу будут включены столбцы dup и use из каталога 2MASS.

java -jar Crossmatch.jar ra=298.052 dec=29.408 area_radius=0.1667 crossmatch_radius=2 addcat=NOMAD: "I/297" addcol=NOMAD: "RAJ2000 DEJ2000 e_RAJ2000 e_DEJ2000"

Добавлен каталог NOMAD. В итоговой таблице окажутся четыре столбца данных из этого каталога. Для кроссматча будут использованы значения из столбцов RAJ2000 и DEJ2000.

java -jar Crossmatch.jar ra=298.052 dec=29.408 area_radius=0.1667 crossmatch_radius=2 addcat=NOMAD: "PATH:c:\nomad.dat" addcol=NOMAD: "RAJ2000 DEJ2000 e_RAJ2000 e_DEJ2000"

То же самое в случае, когда данные из каталога NOMAD уже загружены на диск в формате ASCII.