app caminos

A modular interconnection network simulator

11 unstable releases (4 breaking)

0.5.1 Sep 16, 2022
0.5.0 Sep 7, 2022
0.4.3 Feb 15, 2022
0.3.1 Oct 20, 2021
0.1.1 Nov 24, 2020

#5 in Simulation




This crate provides the CAMINOS simulator as a binary. Most of the functionality is obtained from the caminos-lib crate.


To use this simulator first install it.

$ cargo install caminos

Then you should be able to run it.

$ caminos --help

To perform a single simulation create a file my_experiment.cfg and execute the simulator. See the caminos-lib crate for documentation on its format.

$ caminos my_experiment.cfg

You may set the --results flags to write the simulation result into it instead of to stdout.

For more complex experiments it is recommended to make a new directory /path/to/my/experiment. This directory should include a file main.cfg describing the experiment to perform and a file main.od describing the outputs to be generated. It may contain a file remote to help to pull result files launched remotely. Then, to run all the simulations locally and create the outputs execute the following.

$ caminos /path/to/my/experiment

Executing Simulations Using SLURM

If we have access to a machine with a SLURM queue system then a way to proceed is as follows.

  • Make a local experiment with its main.cfg.
  • Create the /path/to/my/experiment/remote
		name: "default",
		host: "the.remote.host",
		username: "myusername",
		root: "/path/in/the/remote/machine/to/my/experiment",
		binary: "/path/in/the/remote/to/caminos",
  • Perform a push to create the files in the remote.
local$ caminos /path/to/my/experiment --action=push
  • Login into the remote machine.
  • Create the slurm jobs
the.remote.host$ caminos /path/in/the/remote/machine/to/my/experiment --action=slurm
  • Close the connection to the remote machine.
  • Pull the results. It is fine if only a few have ended, you are indicated how many are yet to be completed.
local$ caminos /path/to/my/experiment --action=pull
  • You may now generate your desired outputs if you are so inclined.
local$ caminos /path/to/my/experiment --action=output

Special modes

The special flag enables extra modes other than simulating scenarios. Currently the only such availale mode is exporting a topology. By setting --special=export and --special_args='Export{...}' it will create a topology file. An example command is the following.

$ caminos --special=export --special_args='Export{topology:RandomRegularGraph{routers:500,degree:20,servers_per_router:1},seed:5,filename:"the_topology_file"}'


~421K SLoC