"""
ENSEMBLE Command Line Commands
====================================
Command definitions
"""
# ============================================================================
# STANDARD IMPORTS
# ============================================================================
# ============================================================================
# INTERNAL IMPORTS
# ============================================================================
from ensemble.configurator import Configurator
from ensemble.tools.screen import log_in_terminal
from ensemble.tools.checkers import check_scenario_consistency
from ensemble.logic import RuntimeDevice
from ensemble.control.operational.basic_test import runtime_op_layer
# ============================================================================
# CLASS AND DEFINITIONS
# ============================================================================
[docs]def launch_simulation(configurator: Configurator):
"""Launches a RuntimeDevice starting from a configurator
Args:
configurator {Configurator} -- Configurator file
Example:
Use the the function from a python package as::
>>> from ensemble import launch_simulation, Configurator
>>> c = Configurator() # default arguments
>>> library = 'path/to/simulator'
>>> scenarios = ('path/to/scenario',)
>>> config.update_values(library_path=library, scenario_files=scenario)
>>> launch_simulation(configurator)
"""
log_in_terminal("Initializing scenario ⏱", fg="magenta")
with RuntimeDevice(configurator):
log_in_terminal("Finalizing simulation ⏱", fg="magenta")
[docs]def check_consistency(configurator: Configurator) -> bool:
"""Checks consistency of the current configurator
Arguments:
configurator {Configurator} -- Configurator file
Returns:
bool -- True in case all is correct
"""
# Check only for platform/file consistency, others could be added in future
return check_scenario_consistency(configurator)
[docs]def run_operational_runtime():
"""Considers a demonstration scenario to run in the operational layer with components from the framework. The purpose is to test components from the tactical layer"""
runtime_op_layer(scenario="platoon")
if __name__=="__main__":
configurator = Configurator()
configurator.update_values()
