NAME

catalog_convert - convert astronomical catalogs between different formats

SYNOPSIS

    catalog_convert [--infmt FORMAT] [--outfmt FORMAT] [--clobber] INFILE OUTFILE

DESCRIPTION

This program converts catalogs between the various formats which the Astro::Catalog library can read and write. It will attempt to infer the format of the input and output files by the pattern of their names. If this is not successful or the wrong format is inferred, the "--infmt" and / or "--outfmt" options should be specified.

The input and / or output files can be given as -, in which case the program will read from standard input / write to standard output. In this case the corresponding formats must be specified.

OPTIONS

--infmt

The format of the input catalog.

--inopt

Input reading options. This is a comma-separated list of key=value pairs. E.g.:

    telecope=ARECIBO,tag=SCIENCE
    

--outfmt

The format in which to write the catalog.

--outopt

Output writing options, formatted as for input options.

--clobber

This option can be specified to allow OUTFILE to overwrite an existing file.

--epoch

Apply the given epoch (in ISO8601 format) to items with coordinates of type "RADEC" in the input catalog, replacing such coordinates with the apparent position of the item at this time in J2000. This can be used to convert a catalog with proper motion and parallax values to one without. The current time can be used by specifying the epoch as "now".

FORMATS

The following formats may be supported. Note that not all formats support both reading and writing catalogs.

ASSM

Astrom

Cluster

FINDOFF

FITSTable

GaiaPick

Hedwig

JCMT

JCMT_OT_SC

LCOGTFITSTable

Northstar

RITMatch

SExtractor

STL

Simple

TST

UKIRTBS

VEX

VOTable

XY

COPYRIGHT

Copyright (C) 2021 East Asian Observatory All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc.,51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA