NAME

Astro::Catalog::IO::FINDOFF - Catalogue I/O for Astro::Catalog for Starlink FINDOFF.

SYNOPSIS

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

DESCRIPTION

This class provides read and write methods for catalogues in the Starlink FINDOFF 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 catalogue lines and returns a new Astro::Catalog object containing the catalog entries.

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

There are currently no supported options.

_write_catalog

Create an output catalogue in the Starlink FINDOFF format and return the lines in an array.

$ref = Astro::Catalog::IO::FINDOFF->_write_catalog( $catalog );

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

As the Starlink FINDOFF is ID in column 1, X position in column 2, Y position in column 3, and miscellaneous information in the remaining columns that gets carried through to the output file, this method writes a new ID, X, and Y in the first three columns. A new ID is formed by removing any non-numbers from the original ID because FINDOFF cannot understand non-integer IDs. This ID is also written to the fourth column because FINDOFF trounces the original input ID when doing matching, and being able to have the original ID is a good thing.

REVISION

$Id: FINDOFF.pm,v 1.5 2007/05/31 01:42:34 cavanagh Exp $

SEE ALSO

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

Starlink User Note 139 (http://www.starlink.ac.uk/star/docs/sun139.htx/sun139.html)

COYPRIGHT

Copyright (C) 2005 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>