.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "generated/met_tool_wrapper/GFDLTracker/GFDLTracker_TC.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_generated_met_tool_wrapper_GFDLTracker_GFDLTracker_TC.py>`
        to download the full example code.

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_generated_met_tool_wrapper_GFDLTracker_GFDLTracker_TC.py:


GFDLTracker: Tropical Cyclone Use Case
======================================

met_tool_wrapper/GFDLTracker/GFDLTracker_TC.conf

.. GENERATED FROM PYTHON SOURCE LINES 9-15

Scientific Objective
--------------------

Setup and run GFDL Tracker applications to track tropical cyclones.
See :ref:`external-components-gfdl-tracker` for more information.


.. GENERATED FROM PYTHON SOURCE LINES 17-25

Datasets
--------

| **Forecast:** HWRF

| **Location:** All of the input data required for this use case can be found in the met_test sample data tarball. Click here to the METplus releases page and download sample data for the appropriate release: https://github.com/dtcenter/METplus/releases
| This tarball should be unpacked into the directory that you will set the value of INPUT_BASE. See `Running METplus`_ section for more information.


.. GENERATED FROM PYTHON SOURCE LINES 27-32

METplus Components
------------------

This use case utilizes the METplus GFDLTracker wrapper to generate a command
to run the GFDL Tracker Fortran applications.

.. GENERATED FROM PYTHON SOURCE LINES 34-43

METplus Workflow
----------------

GFDLTracker is the only tool called in this example.
It processes the following run time:

| **Init:** 2016-09-06 00Z
| **Forecast lead**: All available leads (0 - 126 hour)
|

.. GENERATED FROM PYTHON SOURCE LINES 45-54

METplus Configuration
---------------------

METplus first loads all of the configuration files found in parm/metplus_config,
then it loads any configuration files passed to METplus via the command line
with the -c option, i.e. -c parm/use_cases/met_tool_wrapper/GFDLTracker/GFDLTracker_TC.conf

.. highlight:: bash
.. literalinclude:: ../../../../parm/use_cases/met_tool_wrapper/GFDLTracker/GFDLTracker_TC.conf

.. GENERATED FROM PYTHON SOURCE LINES 56-66

GFDL Tracker Configuration
--------------------------

METplus replaces values in the template configuration files read by the
tracker based on user settings in the METplus configuration file.

**YOU SHOULD NOT SET ANY OF THESE ENVIRONMENT VARIABLES YOURSELF! THEY WILL BE OVERWRITTEN BY METPLUS WHEN IT CALLS THE MET TOOLS!**

.. highlight:: bash
.. literalinclude:: ../../../../parm/use_cases/met_tool_wrapper/GFDLTracker/template.nml

.. GENERATED FROM PYTHON SOURCE LINES 68-78

Running METplus
---------------

This use case can be run by passing in the conf file to the run script::

   run_metplus.py /path/to/METplus/parm/use_cases/met_tool_wrapper/GFDLTracker/GFDLTracker_TC.conf

See the :ref:`running-metplus` section of the User's Guide for more
information on how to run use cases.


.. GENERATED FROM PYTHON SOURCE LINES 80-93

Expected Output
---------------

A successful run will output the following both to the screen and to the logfile::

  INFO: METplus has successfully finished running.

Refer to the value set for **OUTPUT_BASE** to find where the output data was generated.
Output for this use case will be found in gfdl_tracker/tc (relative to **OUTPUT_BASE**)
and will contain the following file:

* hwrf.2016090600.track.txt
* input.201609060000.nml

.. GENERATED FROM PYTHON SOURCE LINES 95-104

Keywords
--------

.. note::

  * GFDLTrackerToolUseCase

  Navigate to the :ref:`quick-search` page to discover other similar use cases.



.. _sphx_glr_download_generated_met_tool_wrapper_GFDLTracker_GFDLTracker_TC.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: GFDLTracker_TC.ipynb <GFDLTracker_TC.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: GFDLTracker_TC.py <GFDLTracker_TC.py>`

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: GFDLTracker_TC.zip <GFDLTracker_TC.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_