Extract LAI from .TXT-files
=============================

The methods in this repo allow for LAI value extraction from ``TXT.``-files generated by
`LI-COR LAI-2200 meter <https://www.licor.com/env/products/leaf_area/LAI-2200/>`_.
Files are searched recursively and are aggregated in one ``.csv`` file. ESU names are added/validated via a
*Look Up Table (LUT)* containing the coordinates of field measurement sites.

Name of interactive command line tool ``extract_LAI``.

Example usage of command line tool:
-----------------------------------------

.. code-block:: bash

    # get to directory which contains (folders of) 
    # LAI TXT files
    cd /path/to/LAI/TXT/files    

    # start interactive LAI extraction: 
    extract_LAI

Example usage of python module:
-----------------------------------------

.. code-block:: python

    from mni2017 import extract_LAI

    LAI = LAIdata()  # initialize LAIdata class object, load or create 'data.csv' file
    LAI.extract_LAI()  # extract LAI values from available files in cwd
    LAI.save_LAIdata()  # save updated 'data.csv' file

    # show data from field 301
    fieldnumber = 301
    LAI.field(fieldnumber)

.. hint::

    See also **LAI_extraction_example.ipynb** for a demonstration of the contained methods!