Run Dial software
=================================

This script is designed to interface and run the DIAL-Lidar-Ozone retrieval process, supporting configuration through command line arguments. It allows specifying a parameter file, a log file, and the version of the DIAL software to use.

Features
--------

- **Parameter file (mandatory)**: Specifies the path to the parameter file needed for the retrieval process.
- **Log file (optional)**: Specifies the path to the log file. If not provided, a new log file is created in the 'log' directory.
- **Version (optional)**: Allows specifying the version of the DIAL software to be used. The default version is '01'.

In addition, the script suppresses warnings from the `pint` package and `FutureWarnings` to avoid unnecessary console output.

Installation
------------

No specific installation steps are required for the script itself, assuming Python and the necessary packages (`pint`, `argparse`, `logging`) are installed.

Usage
-----

The script can be run from the command line, providing the necessary arguments. Below is an example command:

.. code-block:: bash

    python run_dial.py 'path/to/parameter/file.xml'

Here's how to specify a custom log file and use a different version of the DIAL software:

.. code-block:: bash

    python run_dial.py 'path/to/parameter/file.xml' --log 'path/to/logfile.log' --version '02'

API
---

.. automodule:: run_dial
    :members:
    :show-inheritance: