Output Description

Outputs from a CITAM simulation are as follows.

SIMULATION_FOLDER
├── floor_0
│   ├── contact_dist_per_coord.csv
│   |── contacts.txt
|   |── map.svg
│   └── heatmap.svg
├── agents.ids
├── citam.log
├── contact_dist_per_agent.csv
├── manifest.json
├── meetings.txt
├── office_assignment.json
├── pair_contacts.csv
|── raw_contact_data.ccd
├── schedules.txt
├── statistics.json
|── timing.txt
└── trajectory.txt

Please note that the structure of these files should be preserved for the dashboard to successfully load and display information on the GUI.

Floor-Based Results

Each floor has its own subfolder which contains data about each contact event that occurred on that floor. Here is a description of each result file:

  • contact_dist_per_coord.csv

    The number of contacts that take place in each x, y location on this floor.

  • contacts.txt

    A time-based non-cumulative list of positions where contacts take place. Notice that this does not take into account how many contacts take place in each location. This file is used in the dashboard visualizer to plot contact locations as a function of time on this floor.

  • heatmap.svg

    A heatmap highlighting the locations and cumulative number of contacts that take place on this floor. This of visual representation of contact_dist_per_coord.csv.

  • map.svg

    A bare map of this floor for use by the dashboard visualizer to display time-based data.

Overall Results

CITAM also includes results that pertain to the entire facility. Here is a description of each file:

  • agents_ids.txt

    List of IDs used for each agent in this simulation. This file is subject to removal in subsequent version of CITAM.

  • citam.log

    This is the log file with all the details of the simulation. This is particularly useful for debugging.

  • contact_dist_per_agent.csv

    Each line contains the cumulative contact duration (or steps) for each agent.

  • inputs.json

    Input parameters for this simulation as provided by the user.

  • manifest.json

    A description of the key information related to this simulation for use by the GUI.

  • meetings.txt

    List of meetings automatically scheduled in this simulation. Each meeting has a location, list of attendees, start and end time.

  • office_assignment.json

    List of agents and the work space automatically assigned to them in this simulation. This file can be provided as input in case the same simulation is to be repeated.

  • pair_contacts.csv

    This is one of the primary outputs from CITAM simulations. This file records the number of individual contact events and the total duration of contact between every pair of agents (for simplicity, pairs of agents that did not make contact during the simulation are not listed).

  • raw_contact_data.ccd

    A dictionary of dictionaries with raw contact data information. It’s there in case users want to dive deeper into the data.

  • statistics.json

    Key summary data (e.g. total contact duration) from this simulation. Used by the dashboard to show key statistics.

  • timing.txt

    How long it took to run this simulation.

  • trajectory.txt

    This file contains the time-based x, y, f positions of all the agents for the entire duration of the simulation (f is the floor number). This can be used to generate a “video” of the simulation as implemented in the dashboard visualizer.