.. _grid-tools-ascii_to_specint:

ascii_to_specint
~~~~~~~~~~~~~~~~

.. program:: ascii_to_specint

Synopsis
--------

.. code-block:: text

   ascii_to_specint ASCII_FILE SPECINT_FILE [options]

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

The :program:`ascii_to_specint` tool reads a generic flux spectrum
from an ASCII text file, and writes it to a :f-schema:`specint`
file.

The ASCII text file should contain one or more lines, each consisting
of a wavelength value followed by a flux value. Blank lines are
ignored, and comments and label definitions are supported via
the :option:`--comment-prefix` and :option:`--label-prefix` options.

Options
-------

.. option:: -h, --help

   Print a summary of options.

.. option:: --lambda-units=UNITS

   Wavelength units of input file. Valid choices are ``A``
   (:math:`\angstrom`; default) and ``micron`` (:math:`{\rm \mu\,m}`).

.. option:: --flux-units=UNITS

   Flux units of input file. Valid choices are ``erg/cm^2/s/A``
   (:math:`\erg\,\cm^{-2}\,\second^{-1}\,\angstrom^{-1}`; default).

.. option:: --comment-prefix=PREFIX

   Treat lines prefixed by PREFIX as comments.

.. option:: --label-prefix=PREFIX

   Treat lines prefixed by PREFIX as photospheric parameter
   definitions (formatted as NAME:VALUE).

.. option:: -l, --label=NAME:VALUE

   Photospheric parameter name and value. Can be specified multiple
   times, to define multiple parameters. Overrides values defined
   using :option:`--label-prefix`.