.. _sphx_glr_auto_examples_05_apply:

5. Apply a saved model
======================

**Background.** A fitted habitat model can be saved and reused, so later or
external subjects get the same habitat ids as the training cohort.
**Purpose.** Save the model once, reload it, and label new subjects with the
training centroids without refitting.

Train the habitat definition, write a ``.habitatmodel`` file, and label
later subjects without fitting again.

:doc:`/auto_examples/05_apply/plot_04_apply_saved_model`


.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Background. Habitat ids only mean the same thing in two cohorts when both are labelled with the same centroids. Saving the fitted model lets a later or external cohort be labelled with the training definition instead of a new, incomparable fit.">

.. only:: html

  .. image:: /auto_examples/05_apply/images/thumb/sphx_glr_plot_04_apply_saved_model_thumb.png
    :alt:

  :doc:`/auto_examples/05_apply/plot_04_apply_saved_model`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Applying a saved habitat model</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto_examples/05_apply/plot_04_apply_saved_model