:orphan:

.. _examples:

Examples
========

Examples that show how to work with mobgap.



.. raw:: html

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


.. raw:: html

    </div>


Data Loading and Handling
-------------------------



.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to use the loader functions to load example data.">

.. only:: html

  .. image:: /auto_examples/data/images/thumb/sphx_glr__01_loading_example_data_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_data__01_loading_example_data.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Loading example data</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Often you want to test an algorithmic step in isolation or validate the output of an algorithm....">

.. only:: html

  .. image:: /auto_examples/data/images/thumb/sphx_glr__02_working_with_ref_data_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_data__02_working_with_ref_data.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Working with reference data</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Besides raw data, mobgap also has utilities to load pre-calculated DMO data in the format publi...">

.. only:: html

  .. image:: /auto_examples/data/images/thumb/sphx_glr__03_dmo_data_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_data__03_dmo_data.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Loading Digital Mobility Outcome (DMO) data</div>
    </div>


.. raw:: html

    </div>


Gait Sequence Detection
-----------------------



.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to use the GSD Iluz algorithm and some examples on how the results compa...">

.. only:: html

  .. image:: /auto_examples/gsd/images/thumb/sphx_glr__01_gsd_iluz_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_gsd__01_gsd_iluz.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">GSD Iluz</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to apply evaluation algorithms to GSD and thus how to rate the performan...">

.. only:: html

  .. image:: /auto_examples/gsd/images/thumb/sphx_glr__02_gsd_evaluation_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_gsd__02_gsd_evaluation.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">GSD Evaluation</div>
    </div>


.. raw:: html

    </div>


Initial Contact Detection
-------------------------



.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to use the icd Ionescu algorithm and how its results compare to the orig...">

.. only:: html

  .. image:: /auto_examples/icd/images/thumb/sphx_glr__01_icd_ionescu_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_icd__01_icd_ionescu.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">ICD Ionescu</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to use the improved Shin algorithm and some examples on how the results ...">

.. only:: html

  .. image:: /auto_examples/icd/images/thumb/sphx_glr__02_shin_algo_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_icd__02_shin_algo.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Shin Algo</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to use the improved HKLee algorithm and some examples on how the results...">

.. only:: html

  .. image:: /auto_examples/icd/images/thumb/sphx_glr__03_hklee_algo_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_icd__03_hklee_algo.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">HKLee algo</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to apply evaluation algorithms to ICD and thus how to rate the performan...">

.. only:: html

  .. image:: /auto_examples/icd/images/thumb/sphx_glr__04_icd_evaluation_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_icd__04_icd_evaluation.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">ICD Evaluation</div>
    </div>


.. raw:: html

    </div>


Left/Right Classification
-------------------------



.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The McCamley L/R classifier is a simple algorithm to detect the laterality of initial contacts ...">

.. only:: html

  .. image:: /auto_examples/lrc/images/thumb/sphx_glr__01_lrc_mccamley_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_lrc__01_lrc_mccamley.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">McCamley L/R Classifier</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The Ullrich L/R classifier is a general approach of differentiating left from right foot contac...">

.. only:: html

  .. image:: /auto_examples/lrc/images/thumb/sphx_glr__02_lrc_ullrich_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_lrc__02_lrc_ullrich.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Ullrich L/R Classifier</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to evaluate an LRC algorithm. As left-right classification, is a ...">

.. only:: html

  .. image:: /auto_examples/lrc/images/thumb/sphx_glr__99_lrc_evaluation_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_lrc__99_lrc_evaluation.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">LRC Evaluation</div>
    </div>


.. raw:: html

    </div>


Cadence Estimation
------------------



.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="The most obvious way to calculate cadence is to use the detected initial contacts. However, ini...">

.. only:: html

  .. image:: /auto_examples/cad/images/thumb/sphx_glr__01_cad_from_ic_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_cad__01_cad_from_ic.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Cadence from Initial Contacts</div>
    </div>


.. raw:: html

    </div>


Creating final Walking Bouts
----------------------------



.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="An important part of the Mobilise-D pipeline is that we output WBs based on a fixed set of defi...">

.. only:: html

  .. image:: /auto_examples/wba/images/thumb/sphx_glr__01_assembling_wbs_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_wba__01_assembling_wbs.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Assembling WBs</div>
    </div>


.. raw:: html

    </div>


DMO Aggregation
---------------



.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to use the .MobilisedAggregator class to aggregate DMOs over multiple wa...">

.. only:: html

  .. image:: /auto_examples/aggregation/images/thumb/sphx_glr__01_mobilised_aggregator_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_aggregation__01_mobilised_aggregator.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Mobilised Aggregator</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows how to use the functions apply_thresholds to check if a DMO falls within the...">

.. only:: html

  .. image:: /auto_examples/aggregation/images/thumb/sphx_glr__02_threshold_check_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_aggregation__02_threshold_check.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Threshold Checker</div>
    </div>


.. raw:: html

    </div>


Full Pipelines and Pipeline Helper
----------------------------------



.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="As part of most pipelines, we need to iterate over the gait sequences to apply all further algo...">

.. only:: html

  .. image:: /auto_examples/pipeline/images/thumb/sphx_glr__01_gs_iterator_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_pipeline__01_gs_iterator.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Gait Sequence Iterator</div>
    </div>


.. raw:: html

    </div>


Data Transformations and Filtering
----------------------------------



.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Besides explicit gait specific algorithms, we also provide a set of generic data transforms, wh...">

.. only:: html

  .. image:: /auto_examples/data_transform/images/thumb/sphx_glr__01_generic_data_transforms_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_data_transform__01_generic_data_transforms.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Generic Data Transforms</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="One of the most common data transformations is filtering. In mobgap various types of filters ar...">

.. only:: html

  .. image:: /auto_examples/data_transform/images/thumb/sphx_glr__02_filter_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_data_transform__02_filter.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">General Filter Introduction</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Sometimes you may want to resample your data to a different sampling rate. We provide a utility...">

.. only:: html

  .. image:: /auto_examples/data_transform/images/thumb/sphx_glr__03_resample_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_data_transform__03_resample.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Resampling data</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Continuous wavelet transform (CWT) is a time-frequency analysis method that can provide frequen...">

.. only:: html

  .. image:: /auto_examples/data_transform/images/thumb/sphx_glr__04_cwt_filter_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_data_transform__04_cwt_filter.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Continuous Wavelet Transform (CWT) - Filter</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Gaussian Smoothing">

.. only:: html

  .. image:: /auto_examples/data_transform/images/thumb/sphx_glr__05_gaussian_smoothing_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_data_transform__05_gaussian_smoothing.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Gaussian Smoothing</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="We provide a class based implementation of the Savitzky-Golay filter in the SavgolFilter class....">

.. only:: html

  .. image:: /auto_examples/data_transform/images/thumb/sphx_glr__06_savgol_filter_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_data_transform__06_savgol_filter.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Savitzky-Golay Filter Example</div>
    </div>


.. raw:: html

    </div>


Development Guides
------------------

Some recipies that should help during development of mobgap and might also be helpful, if you want to extend mobgap
using new algorithms.


.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="All mobgap algorithms are implemented as tpcp classes (see tpcp.Algorithm). Hence, all there co...">

.. only:: html

  .. image:: /auto_examples/dev_guides/images/thumb/sphx_glr__01_pretrained_models_thumb.png
    :alt:

  :ref:`sphx_glr_auto_examples_dev_guides__01_pretrained_models.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Pretrained models and predefined Parameters</div>
    </div>


.. raw:: html

    </div>


.. toctree::
   :hidden:
   :includehidden:


   /./auto_examples/data/index.rst
   /./auto_examples/gsd/index.rst
   /./auto_examples/icd/index.rst
   /./auto_examples/lrc/index.rst
   /./auto_examples/cad/index.rst
   /./auto_examples/wba/index.rst
   /./auto_examples/aggregation/index.rst
   /./auto_examples/pipeline/index.rst
   /./auto_examples/data_transform/index.rst
   /./auto_examples/dev_guides/index.rst


.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-gallery

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

      :download:`Download all examples in Python source code: auto_examples_python.zip </auto_examples/auto_examples_python.zip>`

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

      :download:`Download all examples in Jupyter notebooks: auto_examples_jupyter.zip </auto_examples/auto_examples_jupyter.zip>`


.. only:: html

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

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