=========================
Combining Lens Data Files
=========================

As noted in the settings of ``gravelamps_generate_lens``, it is capable of
producing multiple jobs to generate files. To use these generated files they
must be combined. Combination of these files is handled by the
``gravelamps_combine_lens`` entrypoint. This is not typically ran by the user
directory, but instead is generated as jobs to a scheduler by
``gravelamps_generate_lens`` or ``gravelamps_inference``. However, if needed to
be run manually, it can be done so as follows::

    $ gravelamps_combine_lens --options --data-dict path --pattern pattern-string

This will search the ``path`` folder for files with a pattern including
``pattern-string`` that end with ``-n`` where ``n`` is a series of ascending
integers beginning with 1. If the pattern is insufficient to yield a unique
result, the program will not attempt to disambiguate and will return an error
to the user.

Commandline Options
===================

Required
--------

--data-dict     Path to search for files to combine.

--pattern       Pattern to identify files to combine.


Optional
--------

-h, --help      Shows the help message and exists

--logdir        Folder to output logging information. If not set, will not save
                logging information to file.

--loglevel      Name of the level of logging messages that should be output to
                stdout. Default is INFO.