simulation_utils
================

.. py:module:: simulation_utils

.. autoapi-nested-parse::

   Utility functions to run the simulation.



Functions
---------

.. autoapisummary::

   simulation_utils.map_path_to_class
   simulation_utils.get_agent_information
   simulation_utils.get_simulator_information
   simulation_utils.get_NLU
   simulation_utils.train_cosine_classifier
   simulation_utils.train_rasa_diet_classifier


Module Contents
---------------

.. py:function:: map_path_to_class(cls_path: str) -> Type

   Maps a class path to a class.

   :param cls_path: Class path.

   :returns: Class.


.. py:function:: get_agent_information(config: confuse.Configuration) -> Tuple[Type, Dict[str, Any]]

   Gets the agent information.

   :param config: Configuration of the run.

   :raises TypeError: if agent class does not inherit from Agent.

   :returns: Agent class and agent configuration.


.. py:function:: get_simulator_information(config: confuse.Configuration) -> Tuple[str, Type, Dict[str, Any]]

   Gets the simulator information.

   :param config: Configuration of the run.

   :raises ValueError: If the simulator class is not supported.

   :returns: Simulator ID, simulator class, and configuration.


.. py:function:: get_NLU(config: confuse.Configuration) -> dialoguekit.nlu.NLU

   Returns an NLU component.

   Only supports disjoint dialogue act extractors for now.

   :param config: Configuration for the simulation.

   :raises ValueError: Unsupported intent classifier.

   :returns: An NLU component.


.. py:function:: train_cosine_classifier(config: confuse.Configuration) -> dialoguekit.nlu.models.intent_classifier_cosine.IntentClassifierCosine

   Trains a cosine classifier on annotated dialogues for NLU module.

   :param config: Configuration generated from YAML configuration file.

   :returns: A trained cosine model for intent classification.


.. py:function:: train_rasa_diet_classifier(config: confuse.Configuration) -> dialoguekit.nlu.models.diet_classifier_rasa.IntentClassifierRasa

   Trains a DIET classifier on Rasa annotated dialogues for NLU module.

   :param config: Configuration generated from YAML configuration file.

   :returns: A trained Rasa DIET model for intent classification.