Trace based simulations

Packet reception traces allow to input real-world radio link dynamics in simulated network. This can significantly improve the fidelity of simulations to real-world testbed. However, trace-based simulation are still no replacement for real world experiments, as short-term dynamics are typically missed by the trace preparation process.

Trace file format

TSCH-Sim simulator uses the "K7" trace file format from the OpenWSN 6tisch simulator. Both plaintext files and compressed files (with gzip) are support. The latter are expected to have .gz extension.

An example trace file:

datetime,src,dst,channel,mean_rssi,pdr,tx_count
2020-01-01T00:00:00.0,0,1,20,-80,0.0,100
2020-01-01T00:00:00.0,1,0,20,-80,0.0,100
2020-01-01T00:00:00.0,0,2,20,-80,0.0,100
2020-01-01T00:00:00.0,2,0,20,-80,0.0,100
2020-01-01T00:00:00.0,0,3,20,-80,0.0,100
2020-01-01T00:00:00.0,3,0,20,-80,0.0,100
2020-01-01T00:00:00.0,0,4,20,-80,0.0,100
2020-01-01T00:00:00.0,4,0,20,-80,0.0,100
2020-01-01T00:00:00.0,0,5,20,-80,0.0,100
2020-01-01T00:00:00.0,5,0,20,-80,0.0,100
2020-01-01T00:00:00.0,0,6,20,-80,0.0,100
2020-01-01T00:00:00.0,6,0,20,-80,0.0,100
2020-01-01T00:01:00.0,0,1,20,-80,1.0,100
2020-01-01T00:01:00.0,1,0,20,-80,1.0,100
2020-01-01T00:01:00.0,0,2,20,-80,0.8,100
2020-01-01T00:01:00.0,2,0,20,-80,0.8,100
2020-01-01T00:01:00.0,0,3,20,-80,0.6,100
2020-01-01T00:01:00.0,3,0,20,-80,0.6,100
2020-01-01T00:01:00.0,0,4,20,-80,0.4,100
2020-01-01T00:01:00.0,4,0,20,-80,0.4,100
2020-01-01T00:01:00.0,0,5,20,-80,0.2,100
2020-01-01T00:01:00.0,5,0,20,-80,0.2,100
2020-01-01T00:01:00.0,0,6,20,-80,0.0,100
2020-01-01T00:01:00.0,6,0,20,-80,0.0,100

Configuration parameters

• TRACE_FILE - The name of the trace file. If a relative path, assumed to be relative to the configuration file. Filename, default: null.