Documentation
=============

Welcome to the osl-dynamics documentation!

The :doc:`API reference <autoapi/index>` provides documentation for the classes, methods and functions in osl-dynamics. New users may find the :doc:`FAQ <faq>` useful.

**New users are encouraged to have a look at the config API interface:** `here <https://osl-dynamics.readthedocs.io/en/latest/autoapi/osl_dynamics/config_api/index.html>`_.

Models
------

Various models are implemented in osl-dynamics. Finalised models that have been used in published papers are described below.

- :doc:`Hidden Markov Model (HMM) <models/hmm>`.
- :doc:`Dynamic Network Modes (DyNeMo) <models/dynemo>`.

Tutorials
---------

The following tutorials illustrate basic usage and analysis that can be done with osl-dynamics.

**Data tutorials**:

- :doc:`tutorials_build/data_loading`.
- :doc:`tutorials_build/data_preparation`.

**Static modelling tutorials**:

- :doc:`tutorials_build/static_spectra_analysis`.
- :doc:`tutorials_build/static_power_analysis`.
- :doc:`tutorials_build/static_aec_analysis`.

**Dynamic modelling tutorials**:

- :doc:`tutorials_build/sliding_window_analysis`.
- :doc:`tutorials_build/hmm_simulation`.
- :doc:`tutorials_build/hmm_training_real_data`.
- :doc:`tutorials_build/hmm_summary_stats_analysis`.
- :doc:`tutorials_build/hmm_power_analysis`.
- :doc:`tutorials_build/hmm_coherence_analysis`.
- :doc:`tutorials_build/hmm_evoked_response_analysis`.
- :doc:`tutorials_build/dynemo_minimal_code`.
- :doc:`tutorials_build/dynemo_soft_mix_simulation`.
- :doc:`tutorials_build/dynemo_long_range_dep_simulation`.
- :doc:`tutorials_build/dynemo_training_real_data`.
- :doc:`tutorials_build/dynemo_mixing_coef_analysis`.
- :doc:`tutorials_build/dynemo_plotting_networks`.

More examples scripts can be found in the `examples directory <https://github.com/OHBA-analysis/osl-dynamics/tree/main/examples>`_ of the repo.

Workshops
---------

- `2023 OHBA Software Library (OSL) workshop <https://osf.io/zxb6c/>`_.