Interface Configuration

Configuration Options For ACI

Interface Configuration

There are four main aspects of the interface each with their own set of options. Primarily, the settings for capturing observations from the simulation and handing them to the agents are set in the Capture Configuration. Logging experiments into a postgres database is configured by default but can be modified using a Database Configuration. A monitor is also under development where summary statistics from the database can be queried while the agent is racing to give live feedback. The behaviour of which is determined by the Evaluation Configuration. When using aci.AssettoCorsaRecorder an additional Recording Configuration is required and can be used to configure it.

Assetto Corsa Interface Configuration

DICT Interface Configuration

Configuration dictionary format for aci.AssettoCorsaInterface

KEY capture - dict: Configuration for simulation capture, see details bellow

KEY evaluation - dict: WIP Configuration for simulation evaluation monitors, see details bellow

KEY postgres - dict: WIP Configuration for logging to postgres, see details bellow

KEY recording - dict: Configuration for recording data when using aci.AssettoCorsaRecorder, see details bellow

Simulation Capture Configuration

DICT Capture Configuration

Simulation capture configuration options

KEY state - dict: Configuration options for how the harness handles state observations

KEY images - dict: Configuration options for how the harness handles visual observations

KEY ffmpeg - dict: Configuration options for how the harness captures visual observations

Image Capture Configuration

DICT Image Configuration

Visual capture configuration options

KEY image_format - str: Choose the frame format of returned images. Supports RGB, BGR or BGR0. BGR0 is used by default.

KEY wait_for_new_frames - bool: If true execution will block until a new frame is available otherwise stale frames will be read along side fresh state information

State Capture Configuration

DICT State Configuration

State capture configuration options

KEY use_state_dicts - bool: If true simulation state is returned as dictionaries outlined here otherwise raw bytes are returned. Default is False.

FFMPEG Process Configuration

DICT FFMPEG Configuration

Configuration options for ffmpeg capture process

KEY framerate - int: Set the rate at which frames are captured by ffmpeg. Defaults to 30.

Logging Database Configuration

DICT Database Configuration

Configuration options for logging simulation state to Postgres

KEY host - str: Database host address

KEY port - str: Database port

KEY dbname - str: Database name

KEY user - str: User to access database with

KEY password - str: Database user's password

KEY table_name - str: Table to log simulation state to

Driver Recording Configuration

DICT Recording Configuration

Configuration options for aci.AssettoCorsaRecorder

KEY save_path - str: Path to folder where recording should be saved