def test_group_num_samples():
e = Experiment(Mock())
# When the recording interval is zero, only one sample per group should be
# made, regardless of group duration.
with e.new_group() as group:
e.record_interval = 0.0
e.duration = 0.0
assert group.num_samples == 1
with e.new_group() as group:
e.record_interval = 0.0
e.duration = 10.0
assert group.num_samples == 1
# When the recording interval set longer than the group, no recordings
# should be made.
with e.new_group() as group:
e.record_interval = 2.0
e.duration = 1.0
assert group.num_samples == 0
# When the recording interval is equal to the group, duration, one
# recording should be made.
with e.new_group() as group:
e.record_interval = 1.0
e.duration = 1.0
assert group.num_samples == 1
# When the recording interval is a fraction of the group duration, the
# appropriate number of recordings should be made.
with e.new_group() as group:
e.record_interval = 0.1
e.duration = 1.0
assert group.num_samples == 10
def test_group_num_samples():
e = Experiment(Mock())
# When the recording interval is zero, only one sample per group should be
# made, regardless of group duration.
with e.new_group() as group:
e.record_interval = 0.0
e.duration = 0.0
assert group.num_samples == 1
with e.new_group() as group:
e.record_interval = 0.0
e.duration = 10.0
assert group.num_samples == 1
# When the recording interval set longer than the group, no recordings
# should be made.
with e.new_group() as group:
e.record_interval = 2.0
e.duration = 1.0
assert group.num_samples == 0
# When the recording interval is equal to the group, duration, one
# recording should be made.
with e.new_group() as group:
e.record_interval = 1.0
e.duration = 1.0
assert group.num_samples == 1
# When the recording interval is a fraction of the group duration, the
# appropriate number of recordings should be made.
with e.new_group() as group:
e.record_interval = 0.1
e.duration = 1.0
assert group.num_samples == 10
def test_non_nestable_groups():
# Experimental groups must not be allowed to nest
e = Experiment(Mock())
with e.new_group() as group0:
assert e._cur_group is group0
with pytest.raises(Exception):
with e.new_group():
pass # pragma: no cover
# Group should not have been changed
assert e._cur_group is group0
def test_non_nestable_groups():
# Experimental groups must not be allowed to nest
e = Experiment(Mock())
with e.new_group() as group0:
assert e._cur_group is group0
with pytest.raises(Exception):
with e.new_group():
pass # pragma: no cover
# Group should not have been changed
assert e._cur_group is group0
def test_any_router_registers_used(router_register):
# Should return true if any router register is set to be recorded
e = Experiment(Mock())
# Should not be true by default
assert not e._any_router_registers_used()
# Should be true when any register enabled
setattr(e, "record_{}".format(router_register), True)
assert e._any_router_registers_used()
# But not when disabled again
setattr(e, "record_{}".format(router_register), False)
assert not e._any_router_registers_used()
# Should be true if reinjection is used
e.reinject_packets = True
assert e._any_router_registers_used()
e.reinject_packets = False
assert not e._any_router_registers_used()
# Should be true when a timeout is set
e.router_timeout = 16
assert e._any_router_registers_used()
e.router_timeout = (16, 16)
assert e._any_router_registers_used()
e.router_timeout = None
assert not e._any_router_registers_used()
with e.new_group():
e.router_timeout = 16
assert e._any_router_registers_used()
def test_any_router_registers_used(router_register):
# Should return true if any router register is set to be recorded
e = Experiment(Mock())
# Should not be true by default
assert not e._any_router_registers_used()
# Should be true when any register enabled
setattr(e, "record_{}".format(router_register), True)
assert e._any_router_registers_used()
# But not when disabled again
setattr(e, "record_{}".format(router_register), False)
assert not e._any_router_registers_used()
# Should be true if reinjection is used
e.reinject_packets = True
assert e._any_router_registers_used()
e.reinject_packets = False
assert not e._any_router_registers_used()
# Should be true when a timeout is set
e.router_timeout = 16
assert e._any_router_registers_used()
e.router_timeout = (16, 16)
assert e._any_router_registers_used()
e.router_timeout = None
assert not e._any_router_registers_used()
with e.new_group():
e.router_timeout = 16
assert e._any_router_registers_used()
def test_to_csv():
"""Make sure the CSV conversion utility actually works..."""
dt = np.dtype([("a", np.uint), ("b", np.double), ("c", object)])
e = Experiment(Mock())
g0 = e.new_group("g0")
g1 = e.new_group(1)
c0 = e.new_core(name="c0")
c1 = e.new_core(name=1)
f0 = e.new_flow(c0, c0, name="f0")
f1 = e.new_flow(c1, c1, name=1)
# Empty dataset
assert to_csv(np.zeros((0,), dtype=dt)) == "a,b,c"
assert to_csv(np.zeros((0,), dtype=dt), False) == ""
# Standard data types should be handled correctly
a = np.zeros((2,), dtype=dt)
assert to_csv(a) == ("a,b,c\n"
"0,0.0,0\n"
"0,0.0,0")
assert to_csv(a, False) == ("0,0.0,0\n"
"0,0.0,0")
# Nones should be printed specially
a["c"][0] = None
assert to_csv(a) == ("a,b,c\n"
"0,0.0,NA\n"
"0,0.0,0")
# Groups, Flows and Cores should be printed specially
a = np.zeros((6,), dtype=dt)
a["c"][0] = g0
a["c"][1] = g1
a["c"][2] = c0
a["c"][3] = c1
a["c"][4] = f0
a["c"][5] = f1
assert to_csv(a) == ("a,b,c\n"
"0,0.0,g0\n"
"0,0.0,1\n"
"0,0.0,c0\n"
"0,0.0,1\n"
"0,0.0,f0\n"
"0,0.0,1")
def test_to_csv():
"""Make sure the CSV conversion utility actually works..."""
dt = np.dtype([("a", np.uint), ("b", np.double), ("c", object)])
e = Experiment(Mock())
g0 = e.new_group("g0")
g1 = e.new_group(1)
v0 = e.new_vertex("v0")
v1 = e.new_vertex(1)
n0 = e.new_net(v0, v0, name="n0")
n1 = e.new_net(v1, v1, name=1)
# Empty dataset
assert to_csv(np.zeros((0,), dtype=dt)) == "a,b,c"
assert to_csv(np.zeros((0,), dtype=dt), False) == ""
# Standard data types should be handled correctly
a = np.zeros((2,), dtype=dt)
assert to_csv(a) == ("a,b,c\n"
"0,0.0,0\n"
"0,0.0,0")
assert to_csv(a, False) == ("0,0.0,0\n"
"0,0.0,0")
# Nones should be printed specially
a["c"][0] = None
assert to_csv(a) == ("a,b,c\n"
"0,0.0,NA\n"
"0,0.0,0")
# Groups, Nets and Vertices should be printed specially
a = np.zeros((6,), dtype=dt)
a["c"][0] = g0
a["c"][1] = g1
a["c"][2] = v0
a["c"][3] = v1
a["c"][4] = n0
a["c"][5] = n1
assert to_csv(a) == ("a,b,c\n"
"0,0.0,g0\n"
"0,0.0,1\n"
"0,0.0,v0\n"
"0,0.0,1\n"
"0,0.0,n0\n"
"0,0.0,1")
def test_group_labels():
# Make sure groups can have labels added
e = Experiment(Mock())
group0 = e.new_group()
group0.add_label("group", 123)
group0.add_label("colour", "green")
assert group0.labels == {
"group": 123,
"colour": "green",
}
def test_group_labels():
# Make sure groups can have labels added
e = Experiment(Mock())
group0 = e.new_group()
group0.add_label("group", 123)
group0.add_label("colour", "green")
assert group0.labels == {
"group": 123,
"colour": "green",
}
def test_new_functions():
# Make sure the e.new_* functions all work as expected
e = Experiment(Mock())
# Types should be appropriate
core0 = e.new_core()
assert isinstance(core0, Core)
flow0 = e.new_flow(core0, core0)
assert isinstance(flow0, Flow)
group0 = e.new_group()
assert isinstance(group0, Group)
# Everything should be given unique names
core1 = e.new_core()
flow1 = e.new_flow(core1, core1)
group1 = e.new_group()
assert core0.name != core1.name
assert flow0.name != flow1.name
assert group0.name != group1.name
# Custom names should be allowed
core_foo = e.new_core(name="foo")
flow_bar = e.new_flow(core_foo, core_foo, name="bar")
group_baz = e.new_group(name="baz")
assert core_foo.name == "foo"
assert flow_bar.name == "bar"
assert group_baz.name == "baz"
# The objects should all give their name/type in their repr string
assert repr(core0) == "<Core 0>"
assert repr(flow0) == "<Flow 0>"
assert repr(group0) == "<Group 0>"
assert repr(core1) == "<Core 1>"
assert repr(flow1) == "<Flow 1>"
assert repr(group1) == "<Group 1>"
assert repr(core_foo) == "<Core 'foo'>"
assert repr(flow_bar) == "<Flow 'bar'>"
assert repr(group_baz) == "<Group 'baz'>"
def test_new_functions():
# Make sure the e.new_* functions all work as expected
e = Experiment(Mock())
# Types should be appropriate
vertex0 = e.new_vertex()
assert isinstance(vertex0, Vertex)
net0 = e.new_net(vertex0, vertex0)
assert isinstance(net0, Net)
group0 = e.new_group()
assert isinstance(group0, Group)
# Everything should be given unique names
vertex1 = e.new_vertex()
net1 = e.new_net(vertex1, vertex1)
group1 = e.new_group()
assert vertex0.name != vertex1.name
assert net0.name != net1.name
assert group0.name != group1.name
# Custom names should be allowed
vertex_foo = e.new_vertex(name="foo")
net_bar = e.new_net(vertex_foo, vertex_foo, name="bar")
group_baz = e.new_group(name="baz")
assert vertex_foo.name == "foo"
assert net_bar.name == "bar"
assert group_baz.name == "baz"
# The objects should all give their name/type in their repr string
assert repr(vertex0) == "<Vertex 0>"
assert repr(net0) == "<Net 0>"
assert repr(group0) == "<Group 0>"
assert repr(vertex1) == "<Vertex 1>"
assert repr(net1) == "<Net 1>"
assert repr(group1) == "<Group 1>"
assert repr(vertex_foo) == "<Vertex 'foo'>"
assert repr(net_bar) == "<Net 'bar'>"
assert repr(group_baz) == "<Group 'baz'>"
def test_new_functions():
# Make sure the e.new_* functions all work as expected
e = Experiment(Mock())
# Types should be appropriate
core0 = e.new_core()
assert isinstance(core0, Core)
flow0 = e.new_flow(core0, core0)
assert isinstance(flow0, Flow)
group0 = e.new_group()
assert isinstance(group0, Group)
# Everything should be given unique names
core1 = e.new_core()
flow1 = e.new_flow(core1, core1)
group1 = e.new_group()
assert core0.name != core1.name
assert flow0.name != flow1.name
assert group0.name != group1.name
# Custom names should be allowed
core_foo = e.new_core(name="foo")
flow_bar = e.new_flow(core_foo, core_foo, name="bar")
group_baz = e.new_group(name="baz")
assert core_foo.name == "foo"
assert flow_bar.name == "bar"
assert group_baz.name == "baz"
# The objects should all give their name/type in their repr string
assert repr(core0) == "<Core 0>"
assert repr(flow0) == "<Flow 0>"
assert repr(group0) == "<Group 0>"
assert repr(core1) == "<Core 1>"
assert repr(flow1) == "<Flow 1>"
assert repr(group1) == "<Group 1>"
assert repr(core_foo) == "<Core 'foo'>"
assert repr(flow_bar) == "<Flow 'bar'>"
assert repr(group_baz) == "<Group 'baz'>"
def test_to_csv():
"""Make sure the CSV conversion utility actually works..."""
dt = np.dtype([("a", np.uint), ("b", np.double), ("c", object)])
e = Experiment(Mock())
g0 = e.new_group("g0")
g1 = e.new_group(1)
c0 = e.new_core(name="c0")
c1 = e.new_core(name=1)
f0 = e.new_flow(c0, c0, name="f0")
f1 = e.new_flow(c1, c1, name=1)
# Empty dataset
assert to_csv(np.zeros((0, ), dtype=dt)) == "a,b,c"
assert to_csv(np.zeros((0, ), dtype=dt), False) == ""
# Standard data types should be handled correctly
a = np.zeros((2, ), dtype=dt)
assert to_csv(a) == ("a,b,c\n" "0,0.0,0\n" "0,0.0,0")
assert to_csv(a, False) == ("0,0.0,0\n" "0,0.0,0")
# Nones should be printed specially
a["c"][0] = None
assert to_csv(a) == ("a,b,c\n" "0,0.0,NA\n" "0,0.0,0")
# Groups, Flows and Cores should be printed specially
a = np.zeros((6, ), dtype=dt)
a["c"][0] = g0
a["c"][1] = g1
a["c"][2] = c0
a["c"][3] = c1
a["c"][4] = f0
a["c"][5] = f1
assert to_csv(a) == ("a,b,c\n"
"0,0.0,g0\n"
"0,0.0,1\n"
"0,0.0,c0\n"
"0,0.0,1\n"
"0,0.0,f0\n"
"0,0.0,1")
def test_reinjection_used(reinjection_register):
# Should return true if any router register is set to be recorded
e = Experiment(Mock())
# Should not be true by default
assert not e._reinjection_used()
# Should be true when any register enabled
setattr(e, "record_{}".format(reinjection_register), True)
assert e._reinjection_used()
# But not when disabled again
setattr(e, "record_{}".format(reinjection_register), False)
assert not e._reinjection_used()
# Should be true when reinjection is enabled at any point
e.reinject_packets = True
assert e._reinjection_used()
e.reinject_packets = False
assert not e._reinjection_used()
with e.new_group():
e.reinject_packets = True
assert e._reinjection_used()
def test_reinjection_used(reinjection_register):
# Should return true if any router register is set to be recorded
e = Experiment(Mock())
# Should not be true by default
assert not e._reinjection_used()
# Should be true when any register enabled
setattr(e, "record_{}".format(reinjection_register), True)
assert e._reinjection_used()
# But not when disabled again
setattr(e, "record_{}".format(reinjection_register), False)
assert not e._reinjection_used()
# Should be true when reinjection is enabled at any point
e.reinject_packets = True
assert e._reinjection_used()
e.reinject_packets = False
assert not e._reinjection_used()
with e.new_group():
e.reinject_packets = True
assert e._reinjection_used()
def test_construct_vertex_commands(router_access_vertex):
# XXX: This test is *very* far from being complete. In particular, though
# the problem supplied is realistic, the output is not checked thouroughly
# enough.
e = Experiment(Mock())
# A simple example network as follows:
# n0
# v0 ---+--> v1
# | '--> v2
# +-------> v3
# n1
# We'll pretend all of them are on the same chip and vertex0 is the one
# designated as the router-value recording vertex.
vertex0 = e.new_vertex()
vertex1 = e.new_vertex()
vertex2 = e.new_vertex()
vertex3 = e.new_vertex()
vertices = [vertex0, vertex1, vertex2, vertex3]
net0 = e.new_net(vertex0, [vertex1, vertex2])
net1 = e.new_net(vertex0, vertex3)
# Seed randomly
e.seed = None
e.timestep = 1e-6
e.warmup = 0.001
e.duration = 1.0
e.cooldown = 0.001
e.flush_time = 0.01
e.record_sent = True
e.reinject_packets = True
# By default, nothing should send and everything should consume
e.probability = 0.0
e.consume = True
e.router_timeout = 240
# In group0, everything consumes and n0 sends 100% packets and n1 sends 50%
# packets.
with e.new_group():
net0.probability = 1.0
net1.probability = 0.5
# In group1, nothing consumes and n0 and n1 send 100%
with e.new_group():
net0.probability = 1.0
net1.probability = 1.0
e.consume = False
e.router_timeout = 0
# In group2, we have a timeout with emergency routing enabled
with e.new_group():
e.router_timeout = (16, 16)
net_keys = {net0: 0xAA00, net1: 0xBB00}
vertices_source_nets = {
vertex0: [net0, net1],
vertex1: [],
vertex2: [],
vertex3: [],
}
vertices_sink_nets = {
vertex0: [],
vertex1: [net0],
vertex2: [net0],
vertex3: [net1],
}
vertex_commands = {
vertex: e._construct_vertex_commands(
vertex=vertex,
source_nets=vertices_source_nets[vertex],
sink_nets=vertices_sink_nets[vertex],
net_keys=net_keys,
records=[Counters.sent],
router_access_vertex=router_access_vertex).pack()
for vertex in vertices
}
# Make sure all vertices have the right number of sources/sinks set
for vertex in vertices:
commands = vertex_commands[vertex]
num_sources = len(vertices_source_nets[vertex])
num_sinks = len(vertices_sink_nets[vertex])
ref_cmd = struct.pack("<II", NT_CMD.NUM,
(num_sources | num_sinks << 8))
assert ref_cmd in commands
# Make sure all vertices have the right set of sources and sinks
for vertex in vertices:
commands = vertex_commands[vertex]
sources = vertices_source_nets[vertex]
sinks = vertices_sink_nets[vertex]
for source_num, source_net in enumerate(sources):
ref_cmd = struct.pack("<II", NT_CMD.SOURCE_KEY | (source_num << 8),
net_keys[source_net])
assert ref_cmd in commands
for sink_num, sink_net in enumerate(sinks):
ref_cmd = struct.pack("<II", NT_CMD.SINK_KEY | (sink_num << 8),
net_keys[sink_net])
assert ref_cmd in commands
# Make sure all vertices have the right set of timing values
for vertex in vertices:
commands = vertex_commands[vertex]
ref_cmd = struct.pack("<II", NT_CMD.TIMESTEP, 1000)
assert ref_cmd in commands
# Make sure all vertices have the right timeout set
for vertex in vertices:
commands = vertex_commands[vertex]
ref_cmd0 = struct.pack("<I", NT_CMD.ROUTER_TIMEOUT)
ref_cmd1 = struct.pack("<I", NT_CMD.ROUTER_TIMEOUT_RESTORE)
if router_access_vertex:
assert ref_cmd0 in commands
assert ref_cmd1 in commands
else:
assert ref_cmd0 not in commands
assert ref_cmd1 not in commands
# Make sure all vertices packet reinjection enabled if requested
for vertex in vertices:
commands = vertex_commands[vertex]
ref_cmd0 = struct.pack("<I", NT_CMD.REINJECTION_ENABLE)
ref_cmd1 = struct.pack("<I", NT_CMD.REINJECTION_DISABLE)
if router_access_vertex:
assert ref_cmd0 in commands
assert ref_cmd1 in commands
else:
assert ref_cmd0 not in commands
assert ref_cmd1 not in commands
def test_option_getters_setters():
"""Make sure the internal option get/set API works."""
e = Experiment(Mock())
group0 = e.new_group()
vertex0 = e.new_vertex()
vertex1 = e.new_vertex()
net0 = e.new_net(vertex0, vertex1)
net1 = e.new_net(vertex1, vertex0)
# Make sure the getters setters use specific values with the correct
# priority.
# Should get global (default) value
assert e._get_option_value("timestep") == 0.001
assert e._get_option_value("timestep", group=group0) == 0.001
assert e._get_option_value("timestep", vert_or_net=vertex0) == 0.001
assert e._get_option_value("timestep", vert_or_net=net0) == 0.001
assert e._get_option_value("timestep",
group=group0,
vert_or_net=vertex0) == 0.001
assert e._get_option_value("timestep",
group=group0,
vert_or_net=net0) == 0.001
# Should be able to change the default value
e._set_option_value("timestep", 0.1)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 0.1
assert e._get_option_value("timestep", vert_or_net=vertex0) == 0.1
assert e._get_option_value("timestep", vert_or_net=net0) == 0.1
assert e._get_option_value("timestep",
group=group0,
vert_or_net=vertex0) == 0.1
assert e._get_option_value("timestep",
group=group0,
vert_or_net=net0) == 0.1
# Should be able to change the value for a particular vertex
e._set_option_value("timestep", 0.5, vert_or_net=vertex0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 0.1
assert e._get_option_value("timestep", vert_or_net=vertex0) == 0.5
assert e._get_option_value("timestep", vert_or_net=net0) == 0.5
assert e._get_option_value("timestep", vert_or_net=net1) == 0.1
assert e._get_option_value("timestep",
group=group0,
vert_or_net=vertex0) == 0.5
assert e._get_option_value("timestep",
group=group0,
vert_or_net=net0) == 0.5
assert e._get_option_value("timestep",
group=group0,
vert_or_net=net1) == 0.1
# Should be able to change the value for a particular net
e._set_option_value("timestep", 0.6, vert_or_net=net0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 0.1
assert e._get_option_value("timestep", vert_or_net=vertex0) == 0.5
assert e._get_option_value("timestep", vert_or_net=net0) == 0.6
assert e._get_option_value("timestep", vert_or_net=net1) == 0.1
assert e._get_option_value("timestep",
group=group0,
vert_or_net=vertex0) == 0.5
assert e._get_option_value("timestep",
group=group0,
vert_or_net=net0) == 0.6
assert e._get_option_value("timestep",
group=group0,
vert_or_net=net1) == 0.1
# Should be able to change the value for a particular group (vertex/net
# values should override still)
e._set_option_value("timestep", 1.0, group=group0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", vert_or_net=vertex0) == 0.5
assert e._get_option_value("timestep", vert_or_net=net0) == 0.6
assert e._get_option_value("timestep", vert_or_net=net1) == 0.1
assert e._get_option_value("timestep",
group=group0,
vert_or_net=vertex0) == 0.5
assert e._get_option_value("timestep",
group=group0,
vert_or_net=net0) == 0.6
assert e._get_option_value("timestep",
group=group0,
vert_or_net=net1) == 1.0
# Should be able to change the value for a particular vertex-group pair and
# the net value should still take priority
e._set_option_value("timestep", 10.0, group=group0, vert_or_net=vertex0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", vert_or_net=vertex0) == 0.5
assert e._get_option_value("timestep", vert_or_net=net0) == 0.6
assert e._get_option_value("timestep",
group=group0,
vert_or_net=vertex0) == 10.0
assert e._get_option_value("timestep",
group=group0,
vert_or_net=net0) == 0.6
# Should be able to change the value for a particular vertex-group pair and
# implicitly set a net value which has not been overridden.
e._set_option_value("timestep", 20.0, group=group0, vert_or_net=vertex1)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", vert_or_net=vertex1) == 0.1
assert e._get_option_value("timestep", vert_or_net=net1) == 0.1
assert e._get_option_value("timestep",
group=group0,
vert_or_net=vertex1) == 20.0
assert e._get_option_value("timestep",
group=group0,
vert_or_net=net1) == 20.0
# Should be able to change the value for a particular net-group pair and
# it should take priority over anything else in that group.
e._set_option_value("timestep", 30.0, group=group0, vert_or_net=net0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", vert_or_net=vertex0) == 0.5
assert e._get_option_value("timestep", vert_or_net=net0) == 0.6
assert e._get_option_value("timestep",
group=group0,
vert_or_net=vertex0) == 10.0
assert e._get_option_value("timestep",
group=group0,
vert_or_net=net0) == 30.0
# Should be able to get values which don't support exceptions
assert e._get_option_value("record_sent") is False
assert e._get_option_value("record_sent", group=group0) is False
assert e._get_option_value("record_sent", vert_or_net=vertex0) is False
assert e._get_option_value("record_sent",
group=group0,
vert_or_net=vertex0) is False
# Should be able to set values which don't support exceptions
e._set_option_value("record_sent", True)
assert e._get_option_value("record_sent") is True
assert e._get_option_value("record_sent", group=group0) is True
assert e._get_option_value("record_sent", vert_or_net=vertex0) is True
assert e._get_option_value("record_sent",
group=group0,
vert_or_net=vertex0) is True
# Shouldn't be able to set exceptions to options which don't support them
with pytest.raises(ValueError):
e._set_option_value("record_sent", False, group=group0)
with pytest.raises(ValueError):
e._set_option_value("record_sent", False, vert_or_net=vertex0)
with pytest.raises(ValueError):
e._set_option_value("record_sent",
False,
group=group0,
vert_or_net=vertex0)
def test_run(auto_create_group, samples_per_group, num_vertices,
num_nets_per_vertex, error, error_code, record, reinject_packets):
"""Make sure that the run command carries out an experiment as would be
expected."""
machine = Machine(3, 1)
mock_mc = Mock()
mock_mc.get_machine.return_value = machine
mock_application_ctx = Mock()
mock_application_ctx.__enter__ = Mock()
mock_application_ctx.__exit__ = Mock()
mock_mc.application.return_value = mock_application_ctx
mock_mc.get_machine.return_value = machine
if reinject_packets:
# If reinjecting, a core is added to every chip
mock_mc.wait_for_cores_to_reach_state.return_value = len(list(machine))
else:
# If not reinjecting, only the vertices are given cores
mock_mc.wait_for_cores_to_reach_state.return_value = num_vertices
def mock_sdram_file_read(size):
return error_code + b"\0"*(size - 4)
mock_sdram_file = Mock()
mock_sdram_file.read.side_effect = mock_sdram_file_read
mock_mc.sdram_alloc_as_filelike.return_value = mock_sdram_file
e = Experiment(mock_mc)
e.timestep = 1e-6
e.warmup = 0.01
e.duration = 0.01
e.cooldown = 0.01
e.flush_time = 0.01
# Record the result of _construct_vertex_commands to allow checking of
# memory allocation sizes
construct_vertex_commands = e._construct_vertex_commands
vertices_commands = {}
def wrapped_construct_vertex_commands(vertex, *args, **kwargs):
commands = construct_vertex_commands(vertex=vertex, *args, **kwargs)
vertices_commands[vertex] = commands
return commands
e._construct_vertex_commands = Mock(
side_effect=wrapped_construct_vertex_commands)
if record:
e.record_sent = True
e.reinject_packets = reinject_packets
# Create example vertices
vertices = [e.new_vertex() for _ in range(num_vertices)]
for v in vertices:
for _ in range(num_nets_per_vertex):
e.new_net(v, v)
# Vertices are placed on sequential chips along the x-axis
e.placements = {v: (x, 0) for x, v in enumerate(vertices)}
# Create example groups
for num_samples in samples_per_group:
with e.new_group():
e.record_interval = e.duration / float(num_samples)
# The run should fail with an exception when expected.
if error and (num_vertices > 0 or reinject_packets):
with pytest.raises(NetworkTesterError) as exc_info:
e.run(0x33, create_group_if_none_exist=auto_create_group)
results = exc_info.value.results
else:
results = e.run(0x33, create_group_if_none_exist=auto_create_group)
# The results should be of the correct type...
assert isinstance(results, Results)
# The results returned should be all zeros (since that is what was written
# back)
if record and num_vertices > 0 and num_nets_per_vertex > 0:
assert sum(results.totals()["sent"]) == 0
# The supplied app ID should be used
mock_mc.application.assert_called_once_with(0x33)
# If reinjection is enabled, the binary should have been loaded
reinjector_loaded = any("reinjector.aplx" in call[1][0]
for call in mock_mc.load_application.mock_calls)
if reinject_packets:
assert reinjector_loaded
else:
assert not reinjector_loaded
# Each chip should have been issued with a suitable malloc for any vertices
# on it.
for x, vertex in enumerate(vertices):
cmds_size = vertices_commands[vertex].size
if record:
# The space required to record the sent counters.
result_size = (1 + (num_nets_per_vertex *
sum(samples_per_group))) * 4
else:
result_size = 4 # Just the status value
size = max(cmds_size, result_size)
if reinject_packets:
# During packet reinjection, core 1 is used.
core_num = 2
else:
core_num = 1
mock_mc.sdram_alloc_as_filelike.assert_any_call(size, x=x, y=0,
tag=core_num)
# The correct number of barriers should have been reached
num_groups = len(samples_per_group)
if auto_create_group:
num_groups = max(1, num_groups)
assert len(mock_mc.send_signal.mock_calls) == num_groups
def test_option_descriptors():
"""Make sure the option descriptors work."""
e = Experiment(Mock())
# Defualts should work
assert e.seed is None
assert e.probability == 1.0
# Should be able to set
e.probability = 0.1
assert e.probability == 0.1
# Should be able to set exceptions for groups
with e.new_group():
assert e.probability == 0.1
e.probability = 1.0
assert e.probability == 1.0
assert e.probability == 0.1
# Should be able to set non-exception-supporting options globally
assert e.record_sent is False
e.record_sent = True
assert e.record_sent is True
# Should be able to set exceptions for cores
core0 = e.new_core()
assert core0.probability == 0.1
core0.probability = 0.5
assert core0.probability == 0.5
assert e.probability == 0.1
# Should be able to set exceptions for flows
flow0 = e.new_flow(core0, core0)
assert flow0.probability == 0.5
flow0.probability = 0.6
assert flow0.probability == 0.6
assert core0.probability == 0.5
assert e.probability == 0.1
# Should be able to set exceptions in groups for cores and flows
with e.new_group():
assert e.probability == 0.1
assert core0.probability == 0.5
assert flow0.probability == 0.6
# Group probability shouldn't override core/flow probability
e.probability = 1.0
assert e.probability == 1.0
assert core0.probability == 0.5
assert flow0.probability == 0.6
# Group+core probability should take precidence (but not over flows)
core0.probability = 10.0
assert e.probability == 1.0
assert core0.probability == 10.0
assert flow0.probability == 0.6
# Group+flow probability should take overall precidence
flow0.probability = 20.0
assert e.probability == 1.0
assert core0.probability == 10.0
assert flow0.probability == 20.0
# Should be able to get non-exception supporting options
assert e.record_sent is True
# Shouldn't be able to set non-exception-supporting options
with pytest.raises(ValueError):
e.record_sent = False
# ...but only within the group
assert e.probability == 0.1
assert core0.probability == 0.5
assert flow0.probability == 0.6
def test_option_descriptors():
"""Make sure the option descriptors work."""
e = Experiment(Mock())
# Defualts should work
assert e.seed is None
assert e.probability == 1.0
# Should be able to set
e.probability = 0.1
assert e.probability == 0.1
# Should be able to set exceptions for groups
with e.new_group():
assert e.probability == 0.1
e.probability = 1.0
assert e.probability == 1.0
assert e.probability == 0.1
# Should be able to set non-exception-supporting options globally
assert e.record_sent is False
e.record_sent = True
assert e.record_sent is True
# Should be able to set exceptions for cores
core0 = e.new_core()
assert core0.probability == 0.1
core0.probability = 0.5
assert core0.probability == 0.5
assert e.probability == 0.1
# Should be able to set exceptions for flows
flow0 = e.new_flow(core0, core0)
assert flow0.probability == 0.5
flow0.probability = 0.6
assert flow0.probability == 0.6
assert core0.probability == 0.5
assert e.probability == 0.1
# Should be able to set exceptions in groups for cores and flows
with e.new_group():
assert e.probability == 0.1
assert core0.probability == 0.5
assert flow0.probability == 0.6
# Group probability shouldn't override core/flow probability
e.probability = 1.0
assert e.probability == 1.0
assert core0.probability == 0.5
assert flow0.probability == 0.6
# Group+core probability should take precidence (but not over flows)
core0.probability = 10.0
assert e.probability == 1.0
assert core0.probability == 10.0
assert flow0.probability == 0.6
# Group+flow probability should take overall precidence
flow0.probability = 20.0
assert e.probability == 1.0
assert core0.probability == 10.0
assert flow0.probability == 20.0
# Should be able to get non-exception supporting options
assert e.record_sent is True
# Shouldn't be able to set non-exception-supporting options
with pytest.raises(ValueError):
e.record_sent = False
# ...but only within the group
assert e.probability == 0.1
assert core0.probability == 0.5
assert flow0.probability == 0.6
def test_run_callbacks():
"""Make sure that the run command's callbacks occur at the right time."""
num_groups = 3
system_info = SystemInfo(3, 1, {
(x, y): ChipInfo(num_cores=18,
core_states=[AppState.run] + [AppState.idle] * 17,
working_links=set(Links),
largest_free_sdram_block=110*1024*1024,
largest_free_sram_block=1024*1024)
for x in range(3)
for y in range(1)
})
mock_mc = Mock()
mock_mc.get_system_info.return_value = system_info
mock_application_ctx = Mock()
mock_application_ctx.__enter__ = Mock()
mock_application_ctx.__exit__ = Mock()
mock_mc.application.return_value = mock_application_ctx
mock_mc.wait_for_cores_to_reach_state.return_value = len(system_info)
def mock_sdram_file_read(size):
return b"\0\0\0\0" + b"\0"*(size - 4)
mock_sdram_file = Mock()
mock_sdram_file.read.side_effect = mock_sdram_file_read
mock_mc.sdram_alloc_as_filelike.return_value = mock_sdram_file
e = Experiment(mock_mc)
e.timestep = 1e-6
e.warmup = 0.01
e.duration = 0.01
e.cooldown = 0.01
e.flush_time = 0.01
# Enough to cause a recording core to be added to every chip
e.record_dropped_multicast = True
# Create a number of groups
groups = []
for group_num in range(num_groups):
groups.append(e.new_group())
before_load_calls = []
before_group_calls = []
before_read_results_calls = []
def before_load(experiment):
before_load_calls.append(experiment)
assert experiment is e
# Loading should not have started
assert not mock_mc.sdram_alloc_as_filelike.called
def before_group(experiment, group):
before_group_calls.append((experiment, group))
assert experiment is e
# Loading should have ocurred
assert mock_mc.sdram_alloc_as_filelike.called
# The group should appear in the correct sequence
assert group is groups.pop(0)
# The number of barriers reached should be progressing
assert len(mock_mc.wait_for_cores_to_reach_state.mock_calls) == \
(num_groups - len(groups))
def before_read_results(experiment):
before_read_results_calls.append(experiment)
assert experiment is e
# All groups should have been run
assert len(groups) == 0
# Reading should not have started
assert not mock_sdram_file.read.called
# The run should fail with an exception when expected.
results = e.run(0x33,
before_load=before_load,
before_group=before_group,
before_read_results=before_read_results)
# The results should come out as usual...
assert isinstance(results, Results)
# All callbacks should have been called
assert len(before_load_calls) == 1
assert len(before_group_calls) == num_groups
assert len(before_read_results_calls) == 1
def test_run_callbacks():
"""Make sure that the run command's callbacks occur at the right time."""
num_groups = 3
system_info = SystemInfo(
3, 1,
{(x, y): ChipInfo(num_cores=18,
core_states=[AppState.run] + [AppState.idle] * 17,
working_links=set(Links),
largest_free_sdram_block=110 * 1024 * 1024,
largest_free_sram_block=1024 * 1024)
for x in range(3) for y in range(1)})
mock_mc = Mock()
mock_mc.get_system_info.return_value = system_info
mock_application_ctx = Mock()
mock_application_ctx.__enter__ = Mock()
mock_application_ctx.__exit__ = Mock()
mock_mc.application.return_value = mock_application_ctx
mock_mc.wait_for_cores_to_reach_state.return_value = len(system_info)
def mock_sdram_file_read(size):
return b"\0\0\0\0" + b"\0" * (size - 4)
mock_sdram_file = Mock()
mock_sdram_file.read.side_effect = mock_sdram_file_read
mock_mc.sdram_alloc_as_filelike.return_value = mock_sdram_file
e = Experiment(mock_mc)
e.timestep = 1e-6
e.warmup = 0.01
e.duration = 0.01
e.cooldown = 0.01
e.flush_time = 0.01
# Enough to cause a recording core to be added to every chip
e.record_dropped_multicast = True
# Create a number of groups
groups = []
for group_num in range(num_groups):
groups.append(e.new_group())
before_load_calls = []
before_group_calls = []
before_read_results_calls = []
def before_load(experiment):
before_load_calls.append(experiment)
assert experiment is e
# Loading should not have started
assert not mock_mc.sdram_alloc_as_filelike.called
def before_group(experiment, group):
before_group_calls.append((experiment, group))
assert experiment is e
# Loading should have ocurred
assert mock_mc.sdram_alloc_as_filelike.called
# The group should appear in the correct sequence
assert group is groups.pop(0)
# The number of barriers reached should be progressing
assert len(mock_mc.wait_for_cores_to_reach_state.mock_calls) == \
(num_groups - len(groups))
def before_read_results(experiment):
before_read_results_calls.append(experiment)
assert experiment is e
# All groups should have been run
assert len(groups) == 0
# Reading should not have started
assert not mock_sdram_file.read.called
# The run should fail with an exception when expected.
results = e.run(0x33,
before_load=before_load,
before_group=before_group,
before_read_results=before_read_results)
# The results should come out as usual...
assert isinstance(results, Results)
# All callbacks should have been called
assert len(before_load_calls) == 1
assert len(before_group_calls) == num_groups
assert len(before_read_results_calls) == 1
def test_option_getters_setters():
"""Make sure the internal option get/set API works."""
e = Experiment(Mock())
group0 = e.new_group()
core0 = e.new_core()
core1 = e.new_core()
flow0 = e.new_flow(core0, core1)
flow1 = e.new_flow(core1, core0)
# Make sure the getters setters use specific values with the correct
# priority.
# Should get global (default) value
assert e._get_option_value("timestep") == 0.001
assert e._get_option_value("timestep", group=group0) == 0.001
assert e._get_option_value("timestep", core_or_flow=core0) == 0.001
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.001
assert e._get_option_value("timestep", group=group0,
core_or_flow=core0) == 0.001
assert e._get_option_value("timestep", group=group0,
core_or_flow=flow0) == 0.001
# Should be able to change the default value
e._set_option_value("timestep", 0.1)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 0.1
assert e._get_option_value("timestep", core_or_flow=core0) == 0.1
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.1
assert e._get_option_value("timestep", group=group0,
core_or_flow=core0) == 0.1
assert e._get_option_value("timestep", group=group0,
core_or_flow=flow0) == 0.1
# Should be able to change the value for a particular core
e._set_option_value("timestep", 0.5, core_or_flow=core0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 0.1
assert e._get_option_value("timestep", core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow1) == 0.1
assert e._get_option_value("timestep", group=group0,
core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", group=group0,
core_or_flow=flow0) == 0.5
assert e._get_option_value("timestep", group=group0,
core_or_flow=flow1) == 0.1
# Should be able to change the value for a particular flow
e._set_option_value("timestep", 0.6, core_or_flow=flow0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 0.1
assert e._get_option_value("timestep", core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep", core_or_flow=flow1) == 0.1
assert e._get_option_value("timestep", group=group0,
core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", group=group0,
core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep", group=group0,
core_or_flow=flow1) == 0.1
# Should be able to change the value for a particular group (core/flow
# values should override still)
e._set_option_value("timestep", 1.0, group=group0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep", core_or_flow=flow1) == 0.1
assert e._get_option_value("timestep", group=group0,
core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", group=group0,
core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep", group=group0,
core_or_flow=flow1) == 1.0
# Should be able to change the value for a particular core-group pair and
# the flow value should still take priority
e._set_option_value("timestep", 10.0, group=group0, core_or_flow=core0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep", group=group0,
core_or_flow=core0) == 10.0
assert e._get_option_value("timestep", group=group0,
core_or_flow=flow0) == 0.6
# Should be able to change the value for a particular core-group pair and
# implicitly set a flow value which has not been overridden.
e._set_option_value("timestep", 20.0, group=group0, core_or_flow=core1)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", core_or_flow=core1) == 0.1
assert e._get_option_value("timestep", core_or_flow=flow1) == 0.1
assert e._get_option_value("timestep", group=group0,
core_or_flow=core1) == 20.0
assert e._get_option_value("timestep", group=group0,
core_or_flow=flow1) == 20.0
# Should be able to change the value for a particular flow-group pair and
# it should take priority over anything else in that group.
e._set_option_value("timestep", 30.0, group=group0, core_or_flow=flow0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep", group=group0,
core_or_flow=core0) == 10.0
assert e._get_option_value("timestep", group=group0,
core_or_flow=flow0) == 30.0
# Should be able to get values which don't support exceptions
assert e._get_option_value("record_sent") is False
assert e._get_option_value("record_sent", group=group0) is False
assert e._get_option_value("record_sent", core_or_flow=core0) is False
assert e._get_option_value("record_sent", group=group0,
core_or_flow=core0) is False
# Should be able to set values which don't support exceptions
e._set_option_value("record_sent", True)
assert e._get_option_value("record_sent") is True
assert e._get_option_value("record_sent", group=group0) is True
assert e._get_option_value("record_sent", core_or_flow=core0) is True
assert e._get_option_value("record_sent", group=group0,
core_or_flow=core0) is True
# Shouldn't be able to set exceptions to options which don't support them
with pytest.raises(ValueError):
e._set_option_value("record_sent", False, group=group0)
with pytest.raises(ValueError):
e._set_option_value("record_sent", False, core_or_flow=core0)
with pytest.raises(ValueError):
e._set_option_value("record_sent",
False,
group=group0,
core_or_flow=core0)
def test_option_descriptors():
"""Make sure the option descriptors work."""
e = Experiment(Mock())
# Defualts should work
assert e.seed is None
assert e.probability == 1.0
# Should be able to set
e.probability = 0.1
assert e.probability == 0.1
# Should be able to set exceptions for groups
with e.new_group():
assert e.probability == 0.1
e.probability = 1.0
assert e.probability == 1.0
assert e.probability == 0.1
# Should be able to set non-exception-supporting options globally
assert e.record_sent is False
e.record_sent = True
assert e.record_sent is True
# Should be able to set exceptions for vertices
vertex0 = e.new_vertex()
assert vertex0.probability == 0.1
vertex0.probability = 0.5
assert vertex0.probability == 0.5
assert e.probability == 0.1
# Should be able to set exceptions for nets
net0 = e.new_net(vertex0, vertex0)
assert net0.probability == 0.5
net0.probability = 0.6
assert net0.probability == 0.6
assert vertex0.probability == 0.5
assert e.probability == 0.1
# Should be able to set exceptions in groups for vertices and nets
with e.new_group():
assert e.probability == 0.1
assert vertex0.probability == 0.5
assert net0.probability == 0.6
# Group probability shouldn't override vertex/net probability
e.probability = 1.0
assert e.probability == 1.0
assert vertex0.probability == 0.5
assert net0.probability == 0.6
# Group+vertex probability should take precidence (but not over nets)
vertex0.probability = 10.0
assert e.probability == 1.0
assert vertex0.probability == 10.0
assert net0.probability == 0.6
# Group+net probability should take overall precidence
net0.probability = 20.0
assert e.probability == 1.0
assert vertex0.probability == 10.0
assert net0.probability == 20.0
# Should be able to get non-exception supporting options
assert e.record_sent is True
# Shouldn't be able to set non-exception-supporting options
with pytest.raises(ValueError):
e.record_sent = False
# ...but only within the group
assert e.probability == 0.1
assert vertex0.probability == 0.5
assert net0.probability == 0.6
def test_run(auto_create_group, samples_per_group, num_cores,
num_flows_per_core, error, error_code, record, reinject_packets):
"""Make sure that the run command carries out an experiment as would be
expected."""
system_info = SystemInfo(3, 1, {
(x, y): ChipInfo(num_cores=18,
core_states=[AppState.run] + [AppState.idle] * 17,
working_links=set(Links),
largest_free_sdram_block=110*1024*1024,
largest_free_sram_block=1024*1024)
for x in range(3)
for y in range(1)
})
mock_mc = Mock()
mock_mc.get_system_info.return_value = system_info
mock_application_ctx = Mock()
mock_application_ctx.__enter__ = Mock()
mock_application_ctx.__exit__ = Mock()
mock_mc.application.return_value = mock_application_ctx
if reinject_packets:
# If reinjecting, a core is added to every chip
mock_mc.wait_for_cores_to_reach_state.return_value = len(system_info)
else:
# If not reinjecting, only the user-defined cores exist
mock_mc.wait_for_cores_to_reach_state.return_value = num_cores
def mock_sdram_file_read(size):
return error_code + b"\0"*(size - 4)
mock_sdram_file = Mock()
mock_sdram_file.read.side_effect = mock_sdram_file_read
mock_mc.sdram_alloc_as_filelike.return_value = mock_sdram_file
e = Experiment(mock_mc)
e.timestep = 1e-6
e.warmup = 0.01
e.duration = 0.01
e.cooldown = 0.01
e.flush_time = 0.01
# Record the result of _construct_core_commands to allow checking of
# memory allocation sizes
construct_core_commands = e._construct_core_commands
cores_commands = {}
def wrapped_construct_core_commands(core, *args, **kwargs):
commands = construct_core_commands(core=core, *args, **kwargs)
cores_commands[core] = commands
return commands
e._construct_core_commands = Mock(
side_effect=wrapped_construct_core_commands)
if record:
e.record_sent = True
e.reinject_packets = reinject_packets
# Create example cores. Cores are placed on sequential chips along the
# x-axis.
cores = [e.new_core(x, 0) for x in range(num_cores)]
for c in cores:
for _ in range(num_flows_per_core):
e.new_flow(c, c)
# Create example groups
for num_samples in samples_per_group:
with e.new_group():
e.record_interval = e.duration / float(num_samples)
# The run should fail with an exception when expected.
if error and (num_cores > 0 or reinject_packets):
with pytest.raises(NetworkTesterError) as exc_info:
e.run(0x33, create_group_if_none_exist=auto_create_group)
results = exc_info.value.results
else:
results = e.run(0x33, create_group_if_none_exist=auto_create_group)
# The results should be of the correct type...
assert isinstance(results, Results)
# The results returned should be all zeros (since that is what was written
# back)
if record and num_cores > 0 and num_flows_per_core > 0:
assert sum(results.totals()["sent"]) == 0
# The supplied app ID should be used
mock_mc.application.assert_called_once_with(0x33)
# If reinjection is enabled, the binary should have been loaded
print([call[1][0] for call in mock_mc.load_application.mock_calls])
reinjector_loaded = any((len(call[1][0]) == 1 and
"reinjector.aplx" in list(call[1][0])[0])
for call in mock_mc.load_application.mock_calls)
if reinject_packets:
assert reinjector_loaded
else:
assert not reinjector_loaded
# Each chip should have been issued with a suitable malloc for any cores
# on it.
for x, core in enumerate(cores):
cmds_size = cores_commands[core].size
if record:
# The space required to record deadlines_missed and the sent
# counters.
result_size = (1 + ((1 + num_flows_per_core) *
sum(samples_per_group))) * 4
else:
# Just the status value and deadlines_missed
result_size = (1 + sum(samples_per_group)) * 4
size = max(cmds_size, result_size)
core_num = e._allocations[core][Cores].start
mock_mc.sdram_alloc_as_filelike.assert_any_call(size, x=x, y=0,
tag=core_num)
# The correct number of barriers should have been reached
num_groups = len(samples_per_group)
if auto_create_group:
num_groups = max(1, num_groups)
assert len(mock_mc.send_signal.mock_calls) == num_groups
def test_construct_core_commands(router_access_core):
# XXX: This test is *very* far from being complete. In particular, though
# the problem supplied is realistic, the output is not checked thouroughly
# enough.
e = Experiment(Mock())
# A simple example network as follows:
# f0
# c0 ---+--> c1
# | '--> c2
# +-------> c3
# f1
# We'll pretend all of them are on the same chip and core0 is the one
# designated as the router-value recording core.
core0 = e.new_core()
core1 = e.new_core()
core2 = e.new_core()
core3 = e.new_core()
cores = [core0, core1, core2, core3]
flow0 = e.new_flow(core0, [core1, core2])
flow1 = e.new_flow(core0, core3)
# Seed randomly
e.seed = None
e.timestep = 1e-6
e.warmup = 0.001
e.duration = 1.0
e.cooldown = 0.001
e.flush_time = 0.01
e.record_sent = True
e.reinject_packets = True
# By default, nothing should send and everything should consume
e.probability = 0.0
e.consume = True
e.router_timeout = 240
# In group0, everything consumes and f0 sends 100% packets and f1 sends 50%
# packets.
with e.new_group():
flow0.probability = 1.0
flow1.probability = 0.5
# In group1, nothing consumes and f0 and f1 send 100%
with e.new_group():
flow0.probability = 1.0
flow1.probability = 1.0
e.consume = False
e.router_timeout = 0
# In group2, we have a timeout with emergency routing enabled
with e.new_group():
e.router_timeout = (16, 16)
flow_keys = {flow0: 0xAA00, flow1: 0xBB00}
cores_source_flows = {
core0: [flow0, flow1],
core1: [],
core2: [],
core3: [],
}
cores_sink_flows = {
core0: [],
core1: [flow0],
core2: [flow0],
core3: [flow1],
}
core_commands = {
core: e._construct_core_commands(
core=core,
source_flows=cores_source_flows[core],
sink_flows=cores_sink_flows[core],
flow_keys=flow_keys,
records=[Counters.deadlines_missed, Counters.sent],
router_access_core=router_access_core).pack()
for core in cores
}
# Make sure all cores have the right number of sources/sinks set
for core in cores:
commands = core_commands[core]
num_sources = len(cores_source_flows[core])
num_sinks = len(cores_sink_flows[core])
ref_cmd = struct.pack("<II", NT_CMD.NUM,
(num_sources | num_sinks << 16))
assert ref_cmd in commands
# Make sure all cores have the right set of sources and sinks
for core in cores:
commands = core_commands[core]
sources = cores_source_flows[core]
sinks = cores_sink_flows[core]
for source_num, source_flow in enumerate(sources):
ref_cmd = struct.pack("<II", NT_CMD.SOURCE_KEY | (source_num << 8),
flow_keys[source_flow])
assert ref_cmd in commands
for sink_num, sink_flow in enumerate(sinks):
ref_cmd = struct.pack("<II", NT_CMD.SINK_KEY | (sink_num << 8),
flow_keys[sink_flow])
assert ref_cmd in commands
# Make sure all cores have the right set of timing values
for core in cores:
commands = core_commands[core]
ref_cmd = struct.pack("<II", NT_CMD.TIMESTEP, 1000)
assert ref_cmd in commands
# Make sure all cores have the right timeout set
for core in cores:
commands = core_commands[core]
ref_cmd0 = struct.pack("<I", NT_CMD.ROUTER_TIMEOUT)
ref_cmd1 = struct.pack("<I", NT_CMD.ROUTER_TIMEOUT_RESTORE)
if router_access_core:
assert ref_cmd0 in commands
assert ref_cmd1 in commands
else:
assert ref_cmd0 not in commands
assert ref_cmd1 not in commands
# Make sure all cores packet reinjection enabled if requested
for core in cores:
commands = core_commands[core]
ref_cmd0 = struct.pack("<I", NT_CMD.REINJECTION_ENABLE)
ref_cmd1 = struct.pack("<I", NT_CMD.REINJECTION_DISABLE)
if router_access_core:
assert ref_cmd0 in commands
assert ref_cmd1 in commands
else:
assert ref_cmd0 not in commands
assert ref_cmd1 not in commands
def test_construct_core_commands(router_access_core):
# XXX: This test is *very* far from being complete. In particular, though
# the problem supplied is realistic, the output is not checked thouroughly
# enough.
e = Experiment(Mock())
# A simple example network as follows:
# f0
# c0 ---+--> c1
# | '--> c2
# +-------> c3
# f1
# We'll pretend all of them are on the same chip and core0 is the one
# designated as the router-value recording core.
core0 = e.new_core()
core1 = e.new_core()
core2 = e.new_core()
core3 = e.new_core()
cores = [core0, core1, core2, core3]
flow0 = e.new_flow(core0, [core1, core2])
flow1 = e.new_flow(core0, core3)
# Seed randomly
e.seed = None
e.timestep = 1e-6
e.warmup = 0.001
e.duration = 1.0
e.cooldown = 0.001
e.flush_time = 0.01
e.record_sent = True
e.reinject_packets = True
# By default, nothing should send and everything should consume
e.probability = 0.0
e.consume = True
e.router_timeout = 240
# In group0, everything consumes and f0 sends 100% packets and f1 sends 50%
# packets.
with e.new_group():
flow0.probability = 1.0
flow1.probability = 0.5
# In group1, nothing consumes and f0 and f1 send 100%
with e.new_group():
flow0.probability = 1.0
flow1.probability = 1.0
e.consume = False
e.router_timeout = 0
# In group2, we have a timeout with emergency routing enabled
with e.new_group():
e.router_timeout = (16, 16)
flow_keys = {flow0: 0xAA00, flow1: 0xBB00}
cores_source_flows = {
core0: [flow0, flow1],
core1: [],
core2: [],
core3: [],
}
cores_sink_flows = {
core0: [],
core1: [flow0],
core2: [flow0],
core3: [flow1],
}
core_commands = {
core: e._construct_core_commands(
core=core,
source_flows=cores_source_flows[core],
sink_flows=cores_sink_flows[core],
flow_keys=flow_keys,
records=[Counters.deadlines_missed, Counters.sent],
router_access_core=router_access_core).pack()
for core in cores
}
# Make sure all cores have the right number of sources/sinks set
for core in cores:
commands = core_commands[core]
num_sources = len(cores_source_flows[core])
num_sinks = len(cores_sink_flows[core])
ref_cmd = struct.pack("<II", NT_CMD.NUM,
(num_sources | num_sinks << 16))
assert ref_cmd in commands
# Make sure all cores have the right set of sources and sinks
for core in cores:
commands = core_commands[core]
sources = cores_source_flows[core]
sinks = cores_sink_flows[core]
for source_num, source_flow in enumerate(sources):
ref_cmd = struct.pack("<II", NT_CMD.SOURCE_KEY | (source_num << 8),
flow_keys[source_flow])
assert ref_cmd in commands
for sink_num, sink_flow in enumerate(sinks):
ref_cmd = struct.pack("<II", NT_CMD.SINK_KEY | (sink_num << 8),
flow_keys[sink_flow])
assert ref_cmd in commands
# Make sure all cores have the right set of timing values
for core in cores:
commands = core_commands[core]
ref_cmd = struct.pack("<II", NT_CMD.TIMESTEP, 1000)
assert ref_cmd in commands
# Make sure all cores have the right timeout set
for core in cores:
commands = core_commands[core]
ref_cmd0 = struct.pack("<I", NT_CMD.ROUTER_TIMEOUT)
ref_cmd1 = struct.pack("<I", NT_CMD.ROUTER_TIMEOUT_RESTORE)
if router_access_core:
assert ref_cmd0 in commands
assert ref_cmd1 in commands
else:
assert ref_cmd0 not in commands
assert ref_cmd1 not in commands
# Make sure all cores packet reinjection enabled if requested
for core in cores:
commands = core_commands[core]
ref_cmd0 = struct.pack("<I", NT_CMD.REINJECTION_ENABLE)
ref_cmd1 = struct.pack("<I", NT_CMD.REINJECTION_DISABLE)
if router_access_core:
assert ref_cmd0 in commands
assert ref_cmd1 in commands
else:
assert ref_cmd0 not in commands
assert ref_cmd1 not in commands
def test_option_getters_setters():
"""Make sure the internal option get/set API works."""
e = Experiment(Mock())
group0 = e.new_group()
core0 = e.new_core()
core1 = e.new_core()
flow0 = e.new_flow(core0, core1)
flow1 = e.new_flow(core1, core0)
# Make sure the getters setters use specific values with the correct
# priority.
# Should get global (default) value
assert e._get_option_value("timestep") == 0.001
assert e._get_option_value("timestep", group=group0) == 0.001
assert e._get_option_value("timestep", core_or_flow=core0) == 0.001
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.001
assert e._get_option_value("timestep",
group=group0,
core_or_flow=core0) == 0.001
assert e._get_option_value("timestep",
group=group0,
core_or_flow=flow0) == 0.001
# Should be able to change the default value
e._set_option_value("timestep", 0.1)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 0.1
assert e._get_option_value("timestep", core_or_flow=core0) == 0.1
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.1
assert e._get_option_value("timestep",
group=group0,
core_or_flow=core0) == 0.1
assert e._get_option_value("timestep",
group=group0,
core_or_flow=flow0) == 0.1
# Should be able to change the value for a particular core
e._set_option_value("timestep", 0.5, core_or_flow=core0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 0.1
assert e._get_option_value("timestep", core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow1) == 0.1
assert e._get_option_value("timestep",
group=group0,
core_or_flow=core0) == 0.5
assert e._get_option_value("timestep",
group=group0,
core_or_flow=flow0) == 0.5
assert e._get_option_value("timestep",
group=group0,
core_or_flow=flow1) == 0.1
# Should be able to change the value for a particular flow
e._set_option_value("timestep", 0.6, core_or_flow=flow0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 0.1
assert e._get_option_value("timestep", core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep", core_or_flow=flow1) == 0.1
assert e._get_option_value("timestep",
group=group0,
core_or_flow=core0) == 0.5
assert e._get_option_value("timestep",
group=group0,
core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep",
group=group0,
core_or_flow=flow1) == 0.1
# Should be able to change the value for a particular group (core/flow
# values should override still)
e._set_option_value("timestep", 1.0, group=group0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep", core_or_flow=flow1) == 0.1
assert e._get_option_value("timestep",
group=group0,
core_or_flow=core0) == 0.5
assert e._get_option_value("timestep",
group=group0,
core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep",
group=group0,
core_or_flow=flow1) == 1.0
# Should be able to change the value for a particular core-group pair and
# the flow value should still take priority
e._set_option_value("timestep", 10.0, group=group0, core_or_flow=core0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep",
group=group0,
core_or_flow=core0) == 10.0
assert e._get_option_value("timestep",
group=group0,
core_or_flow=flow0) == 0.6
# Should be able to change the value for a particular core-group pair and
# implicitly set a flow value which has not been overridden.
e._set_option_value("timestep", 20.0, group=group0, core_or_flow=core1)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", core_or_flow=core1) == 0.1
assert e._get_option_value("timestep", core_or_flow=flow1) == 0.1
assert e._get_option_value("timestep",
group=group0,
core_or_flow=core1) == 20.0
assert e._get_option_value("timestep",
group=group0,
core_or_flow=flow1) == 20.0
# Should be able to change the value for a particular flow-group pair and
# it should take priority over anything else in that group.
e._set_option_value("timestep", 30.0, group=group0, core_or_flow=flow0)
assert e._get_option_value("timestep") == 0.1
assert e._get_option_value("timestep", group=group0) == 1.0
assert e._get_option_value("timestep", core_or_flow=core0) == 0.5
assert e._get_option_value("timestep", core_or_flow=flow0) == 0.6
assert e._get_option_value("timestep",
group=group0,
core_or_flow=core0) == 10.0
assert e._get_option_value("timestep",
group=group0,
core_or_flow=flow0) == 30.0
# Should be able to get values which don't support exceptions
assert e._get_option_value("record_sent") is False
assert e._get_option_value("record_sent", group=group0) is False
assert e._get_option_value("record_sent", core_or_flow=core0) is False
assert e._get_option_value("record_sent",
group=group0,
core_or_flow=core0) is False
# Should be able to set values which don't support exceptions
e._set_option_value("record_sent", True)
assert e._get_option_value("record_sent") is True
assert e._get_option_value("record_sent", group=group0) is True
assert e._get_option_value("record_sent", core_or_flow=core0) is True
assert e._get_option_value("record_sent",
group=group0,
core_or_flow=core0) is True
# Shouldn't be able to set exceptions to options which don't support them
with pytest.raises(ValueError):
e._set_option_value("record_sent", False, group=group0)
with pytest.raises(ValueError):
e._set_option_value("record_sent", False, core_or_flow=core0)
with pytest.raises(ValueError):
e._set_option_value("record_sent",
False,
group=group0,
core_or_flow=core0)
def test_run(auto_create_group, samples_per_group, num_cores,
num_flows_per_core, error, error_code, record, reinject_packets):
"""Make sure that the run command carries out an experiment as would be
expected."""
system_info = SystemInfo(
3, 1,
{(x, y): ChipInfo(num_cores=18,
core_states=[AppState.run] + [AppState.idle] * 17,
working_links=set(Links),
largest_free_sdram_block=110 * 1024 * 1024,
largest_free_sram_block=1024 * 1024)
for x in range(3) for y in range(1)})
mock_mc = Mock()
mock_mc.get_system_info.return_value = system_info
mock_application_ctx = Mock()
mock_application_ctx.__enter__ = Mock()
mock_application_ctx.__exit__ = Mock()
mock_mc.application.return_value = mock_application_ctx
if reinject_packets:
# If reinjecting, a core is added to every chip
mock_mc.wait_for_cores_to_reach_state.return_value = len(system_info)
else:
# If not reinjecting, only the user-defined cores exist
mock_mc.wait_for_cores_to_reach_state.return_value = num_cores
def mock_sdram_file_read(size):
return error_code + b"\0" * (size - 4)
mock_sdram_file = Mock()
mock_sdram_file.read.side_effect = mock_sdram_file_read
mock_mc.sdram_alloc_as_filelike.return_value = mock_sdram_file
e = Experiment(mock_mc)
e.timestep = 1e-6
e.warmup = 0.01
e.duration = 0.01
e.cooldown = 0.01
e.flush_time = 0.01
# Record the result of _construct_core_commands to allow checking of
# memory allocation sizes
construct_core_commands = e._construct_core_commands
cores_commands = {}
def wrapped_construct_core_commands(core, *args, **kwargs):
commands = construct_core_commands(core=core, *args, **kwargs)
cores_commands[core] = commands
return commands
e._construct_core_commands = Mock(
side_effect=wrapped_construct_core_commands)
if record:
e.record_sent = True
e.reinject_packets = reinject_packets
# Create example cores. Cores are placed on sequential chips along the
# x-axis.
cores = [e.new_core(x, 0) for x in range(num_cores)]
for c in cores:
for _ in range(num_flows_per_core):
e.new_flow(c, c)
# Create example groups
for num_samples in samples_per_group:
with e.new_group():
e.record_interval = e.duration / float(num_samples)
# The run should fail with an exception when expected.
if error and (num_cores > 0 or reinject_packets):
with pytest.raises(NetworkTesterError) as exc_info:
e.run(0x33, create_group_if_none_exist=auto_create_group)
results = exc_info.value.results
else:
results = e.run(0x33, create_group_if_none_exist=auto_create_group)
# The results should be of the correct type...
assert isinstance(results, Results)
# The results returned should be all zeros (since that is what was written
# back)
if record and num_cores > 0 and num_flows_per_core > 0:
assert sum(results.totals()["sent"]) == 0
# The supplied app ID should be used
mock_mc.application.assert_called_once_with(0x33)
# If reinjection is enabled, the binary should have been loaded
print([call[1][0] for call in mock_mc.load_application.mock_calls])
reinjector_loaded = any(
(len(call[1][0]) == 1 and "reinjector.aplx" in list(call[1][0])[0])
for call in mock_mc.load_application.mock_calls)
if reinject_packets:
assert reinjector_loaded
else:
assert not reinjector_loaded
# Each chip should have been issued with a suitable malloc for any cores
# on it.
for x, core in enumerate(cores):
cmds_size = cores_commands[core].size
if record:
# The space required to record deadlines_missed and the sent
# counters.
result_size = (1 + (
(1 + num_flows_per_core) * sum(samples_per_group))) * 4
else:
# Just the status value and deadlines_missed
result_size = (1 + sum(samples_per_group)) * 4
size = max(cmds_size, result_size)
core_num = e._allocations[core][Cores].start
mock_mc.sdram_alloc_as_filelike.assert_any_call(size,
x=x,
y=0,
tag=core_num)
# The correct number of barriers should have been reached
num_groups = len(samples_per_group)
if auto_create_group:
num_groups = max(1, num_groups)
assert len(mock_mc.send_signal.mock_calls) == num_groups
