The visir_util_img_std_cat recipe
===============================================================

.. data:: visir_util_img_std_cat

Synopsis
--------

Convert ASCII-file(s) to a FITS standard star catalog

Description
-----------

This recipe generates a FITS standard star catalog for imaging from one or 
more ASCII-files.

Each line in the text file must have 45 fields separated by white-space.

The first field is the star name, e.g. 'HD108903' which will be stored in a 
table column labeled 'STARS'.

The 3 next fields are the RA (hh mm ss) which will be stored in degrees in 
a table column labeled 'RA' - all three are non-negative and hh and mm are 
integer.

The 3 next fields are the DEC (dd mm ss) which will be stored in degrees in 
a table column labeled 'DEC' - all three are non-negative, dd and mm are 
integer, while dd has either a '+' or a '-' prepended (including -00).

The next field is the spectral type which will be stored in a 
table column labeled 'SP_TYPE'.

The 31 next fields are the JY values for the 31 supported image filters.

The 6 next fields are the JY values for the 6 supported spectral filters.

All JY values must be positive.

For each filter the JY value is stored in a table column labeled with the 
filter name.

The 37 filter names are hard-coded in the recipe.


Lines beginning with a hash (#) are treated as comments.


The ASCII-input should be tagged IMG_LINES_ASCII, but all input 
files will currently be processed regardless.


Constructor
-----------

.. method:: cpl.Recipe("visir_util_img_std_cat")
   :noindex:

   Create an object for the recipe visir_util_img_std_cat.

::

   import cpl
   visir_util_img_std_cat = cpl.Recipe("visir_util_img_std_cat")



.. seealso:: `cpl.Recipe <http://packages.python.org/python-cpl/recipe.html>`_
   for more information about the recipe object.

Bug reports
-----------

Please report any problems to `Lars Lundin <llundin@eso.org>`_. Alternatively, you may 
send a report to the `ESO User Support Department <usd-help@eso.org>`_.

Copyright
---------

This file is part of the VISIR Instrument Pipeline
Copyright (C) 2004, 2005 European Southern Observatory

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 St, Fifth Floor, Boston, 
MA  02111-1307  USA

.. codeauthor:: Lars Lundin <llundin@eso.org>
