diff --git a/docs/source/primaite_session.rst b/docs/source/primaite_session.rst index b8895fc7..c081d0d9 100644 --- a/docs/source/primaite_session.rst +++ b/docs/source/primaite_session.rst @@ -47,6 +47,105 @@ The sub-directory is formatted as such: ``~/primaite/sessions//) When PrimAITE runs a loaded session, PrimAITE will output in the provided session directory - -Outputs -------- - -PrimAITE produces four types of outputs: - -* Session Metadata -* Results -* Diagrams -* Saved agents - - -**Session Metadata** - -PrimAITE creates a ``session_metadata.json`` file that contains the following metadata: - - * **uuid** - The UUID assigned to the session upon instantiation. - * **start_datetime** - The date & time the session started in iso format. - * **end_datetime** - The date & time the session ended in iso format. - * **total_episodes** - The total number of training episodes completed. - * **total_time_steps** - The total number of training time steps completed. - * **env** - * **training_config** - * **All training config items** - * **lay_down_config** - * **All lay down config items** - - -**Results** - -PrimAITE automatically creates two sets of results from each session: - -* Average reward per episode - a csv file listing the average reward for each episode of the session. This provides, for example, an indication of the change over a training session of the reward value -* All transactions - a csv file listing the following values for every step of every episode: - - * Timestamp - * Episode number - * Step number - * Reward value - * Action taken (as presented by the blue agent on this step). Individual elements of the action space are presented in the format AS_X - * Initial observation space (what the blue agent observed when it decided its action) - -**Diagrams** - -For each session, PrimAITE automatically creates a visualisation of the system / network lay down configuration. - -**Saved agents** - -For each training session, assuming the agent being trained implements the *save()* function and this function is called by the code, PrimAITE automatically saves the agent state. diff --git a/src/primaite/setup/old_installation_clean_up.py b/src/primaite/setup/old_installation_clean_up.py index 858ecfd9..d23abf3c 100644 --- a/src/primaite/setup/old_installation_clean_up.py +++ b/src/primaite/setup/old_installation_clean_up.py @@ -1,12 +1,8 @@ # Crown Owned Copyright (C) Dstl 2023. DEFCON 703. Shared in confidence. -from typing import TYPE_CHECKING from primaite import getLogger -if TYPE_CHECKING: - from logging import Logger - -_LOGGER: Logger = getLogger(__name__) +_LOGGER = getLogger(__name__) def run() -> None: diff --git a/src/primaite/setup/reset_example_configs.py b/src/primaite/setup/reset_example_configs.py index d50b24b5..68ce588c 100644 --- a/src/primaite/setup/reset_example_configs.py +++ b/src/primaite/setup/reset_example_configs.py @@ -3,16 +3,12 @@ import filecmp import os import shutil from pathlib import Path -from typing import TYPE_CHECKING import pkg_resources from primaite import getLogger, USERS_CONFIG_DIR -if TYPE_CHECKING: - from logging import Logger - -_LOGGER: Logger = getLogger(__name__) +_LOGGER = getLogger(__name__) def run(overwrite_existing: bool = True) -> None: