NAME

Astro::Catalog::IO::RITMatch - Catalog I/O for Astro::Catalog for Michael Richmond's 'match' program

SYNOPSIS

$cat = Astro::Catalog::IO::RITMatch->_read_catalog(\@lines);
$arrref = Astro::Catalog::IO::RITMatch->_write_catalog($cat, %options);

DESCRIPTION

This class provides read and write methods for catalogs in Michael Richmond's 'match' application's input and output file format. The methods are not public and should, in general only be called from the Astro::Catalog write_catalog and read_catalog methods.

METHODS

Private methods

_read_catalog

Parses the catalog lines and returns a new Astro::Catalog object containing the catalog entries.

$cat = Astro::Catalog::IO::RITMatch->_read_catalog(\@lines, %options);

Currently supported options are:

filter

Either an Astro::WaveBand object or a string that can be used by the Filter method of the Astro::WaveBand module when constructing a new object. This option describes the waveband for the magnitudes in the catalog. If this is not defined, then the waveband will default to the near infrared 'J' band.

_write_catalog

Create an output catalog in the 'match' format and return the lines in an array.

$ref = Astro::Catalog::IO::RITMatch->_write_catalog($catalog, %options);

The sole mandatory argument is an Astro::Catalog object.

Optional arguments are:

mag_type

the magnitude type to write out to the file. Defaults to 'mag'.

filter

reference filter to select from catalog. See flux() method in Astro::Flux. This allows a specific filter to be selected for output. Argument can be a string or Astro::Waveband object.

The output format has the ID in column 1, X coordinate in column 2, Y coordinate in column 3, magnitude value in column 4, and any comments in column 5.

SEE ALSO

Astro::Catalog, Astro::Catalog::IO::Simple

http://spiff.rit.edu/match/

COPYRIGHT

Copyright (C) 2014 Tim Jenness Copyright (C) 2006 Particle Physics and Astronomy Research Council. All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU Public License.

AUTHORS

Brad Cavanagh <b.cavanagh@jach.hawaii.edu> Tim Jenness <tjenness@cpan.org>