#1711 - Last minute docs changes
This commit is contained in:
@@ -6,7 +6,7 @@ Welcome to PrimAITE's documentation
|
|||||||
====================================
|
====================================
|
||||||
|
|
||||||
What is PrimAITE?
|
What is PrimAITE?
|
||||||
------------------------
|
-----------------
|
||||||
|
|
||||||
PrimAITE (Primary-level AI Training Environment) is a simulation environment for training AI under the ARCD programme. It incorporates the functionality required of a Primary-level environment, as specified in the Dstl ARCD Training Environment Matrix document:
|
PrimAITE (Primary-level AI Training Environment) is a simulation environment for training AI under the ARCD programme. It incorporates the functionality required of a Primary-level environment, as specified in the Dstl ARCD Training Environment Matrix document:
|
||||||
|
|
||||||
@@ -14,10 +14,9 @@ PrimAITE (Primary-level AI Training Environment) is a simulation environment for
|
|||||||
* The ability to model key characteristics of a platform / system by representing connections, IP addresses, ports, traffic loading, operating systems, file system, services and processes;
|
* The ability to model key characteristics of a platform / system by representing connections, IP addresses, ports, traffic loading, operating systems, file system, services and processes;
|
||||||
* Operates at machine-speed to enable fast training cycles.
|
* Operates at machine-speed to enable fast training cycles.
|
||||||
|
|
||||||
PrimAITE aims to evolve into an ARCD environment that could be used as the follow-on from Reception level approaches (e.g. `Yawning-Titan <https://github.com/dstl/YAWNING-TITAN>`_), and help bridge the Sim-to-Real gap into Secondary level environments.
|
|
||||||
|
|
||||||
What is PrimAITE built with
|
What is PrimAITE built with
|
||||||
--------------------------------------
|
---------------------------
|
||||||
|
|
||||||
* `OpenAI's Gym <https://gym.openai.com/>`_ is used as the basis for AI blue agent interaction with the PrimAITE environment
|
* `OpenAI's Gym <https://gym.openai.com/>`_ is used as the basis for AI blue agent interaction with the PrimAITE environment
|
||||||
* `Networkx <https://github.com/networkx/networkx>`_ is used as the underlying data structure used for the PrimAITE environment
|
* `Networkx <https://github.com/networkx/networkx>`_ is used as the underlying data structure used for the PrimAITE environment
|
||||||
@@ -29,8 +28,8 @@ What is PrimAITE built with
|
|||||||
* `Plotly <https://github.com/plotly/plotly.py>`_ is used for building high level charts
|
* `Plotly <https://github.com/plotly/plotly.py>`_ is used for building high level charts
|
||||||
|
|
||||||
|
|
||||||
Where next?
|
Getting Started with PrimAITE
|
||||||
------------
|
-----------------------------
|
||||||
|
|
||||||
Head over to the :ref:`getting-started` page to install and setup PrimAITE!
|
Head over to the :ref:`getting-started` page to install and setup PrimAITE!
|
||||||
|
|
||||||
|
|||||||
@@ -49,6 +49,34 @@ For example, when running a session at 17:30:00 on 31st January 2023, the sessio
|
|||||||
|
|
||||||
``primaite session`` can be ran in the terminal/command prompt without arguments. It will use the default configs in the directory ``primaite/config/example_config``.
|
``primaite session`` can be ran in the terminal/command prompt without arguments. It will use the default configs in the directory ``primaite/config/example_config``.
|
||||||
|
|
||||||
|
To run a PrimAITE session using legacy training or laydown config files, add the ``--legacy-tc`` and/or ``legacy-ldc`` options.
|
||||||
|
|
||||||
|
.. tabs::
|
||||||
|
|
||||||
|
.. code-tab:: bash
|
||||||
|
:caption: Unix CLI
|
||||||
|
|
||||||
|
cd ~/primaite/2.0.0
|
||||||
|
source ./.venv/bin/activate
|
||||||
|
primaite session --tc ./config/my_legacy_training_config.yaml --legacy-tc --ldc ./config/my_legacy_lay_down_config.yaml --legacy-ldc
|
||||||
|
|
||||||
|
.. code-tab:: powershell
|
||||||
|
:caption: Powershell CLI
|
||||||
|
|
||||||
|
cd ~\primaite\2.0.0
|
||||||
|
.\.venv\Scripts\activate
|
||||||
|
primaite session --tc .\config\my_legacy_training_config.yaml --legacy-tc --ldc .\config\my_legacy_lay_down_config.yaml --legacy-ldc
|
||||||
|
|
||||||
|
|
||||||
|
.. code-tab:: python
|
||||||
|
:caption: Python
|
||||||
|
|
||||||
|
from primaite.main import run
|
||||||
|
|
||||||
|
training_config = <path to legacy training config yaml file>
|
||||||
|
lay_down_config = <path to legacy lay down config yaml file>
|
||||||
|
run(training_config, lay_down_config, legacy_training_config=True, legacy_lay_down_config=True)
|
||||||
|
|
||||||
|
|
||||||
Outputs
|
Outputs
|
||||||
-------
|
-------
|
||||||
|
|||||||
Reference in New Issue
Block a user