Output Data Files - swise5/SETOSim GitHub Wiki

Outputting Data from the simulation

When an instance of the simulation is run, it will produce a file which looks something like this:

ID	age	status	evacuatingRecord	flooded	x_home	y_home	x_loc	y_loc
1	55	Evacuating	START:1243	inZone	10	0	5	5
2	25	Evacuated	START:1227,ENTER_SHELTER:1256,FINISH_EVAC:1257	inZone	8	2	0	1
3	45	Trapped	START:1168,TRAPPED:1170.0,DONE	inZone	0	10	1	9

The columns are tab-delimited and have the following meanings:

ID: the ID of the individual agent. Usually this will represent a single individual person/evacuee, although it might also represent a household.
age: the age of the individual agent (or head of household).
status: the status of the agent at the time the simulation ended (see more about this).
evacuatingRecord: a list of the statuses through which an agent has passed during their journey (see more about this). Note that the different stages are presented as a single string, and must be "unpacked" to allow further querying.
x_home, y_home: the x and y coordinates of the agent's home location.
x_loc, y_loc: the x and y coordinates of the agent at the end of the simulation, representing their final position.

Status

The agent may finish the simulation in one of several states, based on their location within the behavioural flowchart. Under normal circumstances, these will include the following:

Home - the agent is in their home, potentially resting or conducting other normal business.
Work - the agent is away from their home for an activity.
Travel to Work/Home - the agent is travelling between their home and some non-emergency activity, as part of a regular commute or travel.

If hazards in the environment exist, the agent may move into a series of other statuses. These include:

Evacuated - the agent has successfully made their way to a designated shelter area and gained access to the shelter.
Evacuating - the agent is still trying to evacuate, but has either not yet reached a shelter or else has not yet found a shelter with capacity to accept them.
Sheltering (at Home) - the agent has decided to "shelter in place" in their home. They will not leave their home for normal business (eg to go to work or run errands) but also have not sought out a formal shelter.
Travel to Home Sheltering - the agent is still travelling towards their home in order to shelter in place.
Preparing - the agent is in their home, preparing to leave in order to seek an alternative source of shelter.
Trapped - the agent has attempted to move between locations and become stuck on roads which are flooded or otherwise impassable. They can take no further action and will need to be rescued.

In instances of the model where "helper" agents may be tasked with assisting other "dependent" agents, the helpers may also be in the following task statuses:

Travel to Dependent - the helper is travelling from wherever they were toward the home of their dependent to help them evacuate.
Escort Dependent - the helper is accompanying their dependent as the dependent searches for a shelter.

EvacuatingRecord

The evacuatingRecord entry is a timestamped list of the tick of the simulation during which the agent switched to the given status. As mentioned previously, the journey is encoded as a single string, with the different stages delimited by commas. Each step includes a name of the process (eg START or TRAPPED) combined with the tick of the simulation when the agent transitioned to that status. The format is given as STATUS_NAME:time.

For example, agent 2's record (START:1227,ENTER_SHELTER:1256,FINISH_EVAC:1257) means that at time tick 1227, Agent 2 began trying to evacuate; at time 1256, they successfully reached a shelter. They finished their evacuation journey at time 1257.

Agent 3's record (START:1168,TRAPPED:1170.0,DONE) means that at Time 1168, Agent 3 began trying to evacuate; however, at 1170, they encountered an obstacle or road closure significant enough that they needed rescue in order to proceed, and were unable to complete their evacuation.