# Location tracing

Note

This feature is still being worked on and all information is therefore prone to change.

Location tracing is closely linked to activity tracing. The only major difference is when the files are generated: an activity trace is only created at the end of the simulation run, whereas an location trace is created at the start of the simulation and at every GVT boundary where at least one migration happens. Location traces will always contain the time at which the location as it is presented actually went into effect.

Enabling location tracing is as simple as:

    x, y = 20, 20
    model = FireSpread(x, y)
    sim = Simulator(model)
    sim.setTerminationTime(1000.0)
    sim.setLocationCellMap(True, x, y)
    sim.simulate()

Note that this again shows the location in a Cell view. If this kind of visualisation is not desirable (or possible), you are advised to use standard Visualisation using Graphviz.

An example output of location tracing is given below. It isn’t really spectacular, as it only shows you your allocations again.

Cell view visualisation is completely different from the regular Visualisation, as it contains some domain specific information and thus more closely resembles your interpretation of the model. Drawing a 6x6 grid with the generic visualisation, would generate something non-intuitive like the ‘curly’ graph below.