=====================
Create Roman Filters
=====================

This module provides functionality to process Roman Space Telescope filter
data, create individual filter files, and generate a configuration file for use
with ``rail/lephare``.

The input must be a machine-readable file with the monochromatic effective area
per filter. They can be downloaded from the `WFI Performance website
<https://roman.gsfc.nasa.gov/science/WFI_technical.html>`_.

All the individual filter files generated by this module will be saved where
``rail/lephare`` expects
them to be

::

    $LEPHAREDIR/data/filt/roman
    ├── roman_F062.pb
    ├── roman_F087.pb
    ├── roman_F106.pb
    ├── roman_F129.pb
    ├── roman_F146.pb
    ├── roman_F158.pb
    ├── roman_F184.pb
    ├── roman_F213.pb
    ├── roman_Grism_0thOrder.pb
    ├── roman_Grism_1stOrder.pb
    ├── roman_phot.par
    └── roman_SNPrism.pb


    $LEPHAREWORK/filt
    ├── filter_roman_config.yaml
    ├── filter_roman.dat
    └── filter_roman.doc



Module API
----------

.. automodule:: roman_photoz.create_roman_filters
   :members:
   :undoc-members:
   :show-inheritance:

Command-line Interface
----------------------

This module can be run as a command-line tool to generate filter definitions:

.. code-block:: bash

   python -m roman_photoz.create_roman_filters <input_filename>

- ``<input_filename>``: File with monochromatic effective area per filter.