CLI
===
*Use CLI utilities and coding tools in SEPAL*

CLI tools
---------

To help resolve specific problems, the SEPAL platform includes a variety of useful command-line interface (CLI) utilities, including:

.. toctree::
    :maxdepth: 1

    gdal
    gdrive
    gee
    gwb
    ofgt
    otb
    python
    r

These tools can be called directly from the terminal or via any programming language sending commands to the kernel, including R and Python (installed by default on any SEPAL account).

.. thumbnail:: ../_images/cli/index/cli_gdalinfo.gif
    :title: How to use the **gdalinfo** command in the SEPAL terminal

.. note::

    The code executed previously on an existing :code:`example.tif` file:

    .. code-block:: console

        gdalinfo example.tif

.. tip::

    If you're running actions from multiple directories or instances, you can open multiple **Terminal** tabs and name them as you see fit.

.. tip::

    If the code you want to execute is taking time, consider running it in the background using :code:`nohup`:

    .. code-block:: console

        nohup gdalinfo example.tif

    All console outputs will be redirected to a :code:`nohup.out` in your home directory, but the execution will be running in the background. You will be able to safely close the terminal or even the browser window without interrupting the process (for more information about :code:`nohup`, see `this article <https://en.wikipedia.org/wiki/Nohup>`__).

Coding tools
------------

In the **Apps** section, there are three coding tools at the top of the list:

-   JupyterLab
-   Jupyter Notebook
-   RStudio

.. thumbnail:: ../_images/cli/index/code_editor.png
    :title: The three code editors in the SEPAL environment

They will allow the user to code wokflows in any of the available languages using the corresponding environment in SEPAL. These environments are fully customizable (view the :code:`Python` or :code:`R` section to know more).

.. thumbnail:: ../_images/cli/index/jupyter_example.png
    :title: Example of **rasterio** code running in SEPAL JupyterLab (code extracted from **rasterio** documentation: https://rasterio.readthedocs.io/en/latest/topics/plotting.html)