What does the API consist of

What does the API consist of

The API has two classes;

  • The AnalysisFramework class

  • The Level class

First, a little bit of context on how the maps used for evaluation are organized. A single submission runs on multiple Tests. Each Test contains a particular rail configuration and number of agents on the rail among other things. Each Test has multiple Levels under it which define the different malfunction probabilities that increase as you go higher up the levels. These different Level parameters are applied to the same Test rail configuration for a given Test.

If there are 2 tests with 10 levels under each test. The submission is evaluated on a total of 20 levels.

1. The AnalysisFramework class

Coming to the AnalysisFramework class, it provides two things:

  1. Methods to fetch the episode end data and action data for a particular submission or submissions given the six-digit submission ID. This data is then cached locally and the tool can use the cached data to fetch metrics and other information out of it. The root folder can be specified by the user and the contents follow the given directory structure:

└── .flatland_analysis_data/
    ├── S12345/
    │   ├── actions/
    │   │   ├── Test_0/
    │   │   │   ├── Level_0.json
    │   │   │   ├── Level_1.json
    │   │   │   └── ...
    │   │   ├── ...
    │   │   ├── Test_N
    │   │   └── seed.yml
    │   └── data/
    │       ├── Test_0/
    │       │   ├── Level_0.json
    │       │   ├── Level_1.json
    │       │   └── ...
    │       ├── ...
    │       └── Test_N
    ├── S67890/
    │   ├── actions
    │   └── data
    └── ...
  1. Methods to calculate a given list of metrics for either a level, an entire test or across the whole submission. The metrics returned for the test and the submission are the mean of the values returned for all levels under them.

2. Level class:

The Level class contains methods that pertain to a single level. A Level class instance is created by providing the submission_id, test_id & level_id.

The level class can then return logged raw level info using certain methods that directly return the data contained within the json files, for the most part as a list of integers depending on the type of data. This is not of interest in context of analysis and only serves as a helper to be used by other methods in order to calculate derived metrics.