README.rst

EUMETSAT Data Tailor
======================================

The EUMETSAT Data Tailor provides format conversion and basic product customisation capabilities
for a set of EUMETSAT products in native formats.

:Note: The EUMETSAT Data Tailor used to be known as EPCT or EUMETSAT Product Customisation Toolbox.
       Some technical aspects related to the renaming are still to be fixed.


Supported platforms and installation
------------------------------------

The EUMETSAT Data Tailor can be installed on:

- Ubuntu Linux 18.04 64bit
- CentOS Linux 7 64bit
- Red Hat Enterprise Linux 7 64bit
- Windows 10 Pro 64bit

The minimum hardware requirements are:

- 64bit platform
- 3 GB of disk space
- 4 GB of free memory 

Installation procedures are in described in the INSTALL.rst file.


Starting the EUMETSAT Data Tailor Web Service and the GUI
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The Data Tailor can be installed in any ``conda`` environment, created
as described in the ``INSTALL.rst`` file.

Once installed, the environment needs to be activated. Assuming the
environment is called ``epct-desktop``, to activate it execute::

    conda activate epct-desktop


Once the environment is active, one can use the Data Tailor GUI and the CLI.

To launch the GUI, execute::

    epct_webui


:Note: An alternative way to launch the GUI without explicitly activating the
       environment is::

    conda run -n epct-desktop epct_webui

where ``epct-desktop`` is the name of the environment.


How to get User Support
-----------------------
Please contact the EUMETSAT User Service Helpdesk using the E-mail: ops@eumetsat.int


Known limitations
-----------------
This section includes the known limitations when working with the Eumetsat Data Tailor.


Limitations about supported products
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Please, see analogous sections in the README files of the DataTailor plugins:

- ``epct_plugin_gis``
- ``epct_plugin_netcdf_generator``
- ``epct_plugin_umarf``
- ``epct-plugin-acdc``
- ``usc-psdc``
- ``epct_plugin_mtg``
- ``mtg4africa``


Inventory Notice
----------------

Licenses and copyright information for software dependencies up to version 2.8.0-rc1
is documented in file ``NOTICE.txt``, as well as within the ``inventory`` folder.