{"data":{"markdownRemark":{"html":"

This page explains some of the caveats inherent to distributed models.

\n

Serializable Messages

\n

Because messages will be passed across the network, they need to be serializable. This leads to some restrictions like the use of java Optional.\nIf you need to use them, you will need to copy the source in order to be able to make it implement Serializable. Here is an example with java OptionalDouble:

\n
public class OptDouble implements Serializable {\n\n  private static final OptDouble EMPTY = new OptDouble();\n  private final boolean isPresent;\n  private final double value;\n\n  private OptDouble() {\n    isPresent = false;\n    this.value = Double.NaN;\n  }\n\n  private OptDouble(double value) {\n    this.isPresent = true;\n    this.value = value;\n  }\n\n  public static OptDouble of(double input) {\n    return new OptDouble(input);\n  }\n\n  public static OptDouble empty() {\n    return EMPTY;\n  }\n\n  public double getAsDouble() {\n    if (!isPresent) {\n      throw new NoSuchElementException(\"No value present\");\n    }\n    return value;\n  }\n\n  public boolean isPresent() {\n    return isPresent;\n  }\n\n  @Override\n  public int hashCode() {\n    return isPresent ? Double.hashCode(value) : 0;\n  }\n\n  @Override\n  public String toString() {\n    return isPresent ? String.format(\"OptDouble[%s]\", value) : \"OptDouble.empty\";\n  }\n}
\n

Prevent Passing Of Reference

\n

When running in a distributed fashion, any agent can be anywhere in the environment. Consequently, passing agents around will create errors.\nIf your programs shows lots of java.io.NotSerializableException errors, these are probably caused by improper use of the java keyword this.\nThe correct way to handle any sharing of data is to send messages.

\n

For example you need to prevent passing reference when initializing Agents.\nThis is an example of a incorrect piece of code, and its correction:

\n
// will throw a serialization error, Model reference is passed\nclass Model {\nint field = 1;\n  public void setup() {\n  Group<SomeAgent> someAgentGroup =\n          generateGroup(SomeAgent.class, count, \n              agent -> { agent.field = field; });        \n  }\n}\n\n// a single value is passed, not the model reference\nclass Model {\nint field = 1;\n  public void setup() {\n  int localField = field;\n  Group<SomeAgent> someAgentGroup =\n          generateGroup(SomeAgent.class, count, \n              agent -> { agent.field = localField; });        \n  }\n}
\n

The difference in the example above is that the field variable in the first Model is in fact this.field, this being the Model. this will pass the entire model to the function and tries to serialize it.\nThe second Model avoids this by copying the needed variable to a local value in the Model#setup function.

\n

This also can happen when using a function instead of variables:

\n
Group<RandomAgent> randomAgentGroup =\n       generateGroup(RandomAgent.class, count, \n           agent -> {\n             SeededRandom prng = agent.getPrng();\n             agent.random = getRandomSample(prng, 0, 100);\n           });\n\n// will throw an error\ndouble getRandomSample(SeededRandom prng, double min, double max) {\n   return prng.uniform(min, max).sample();\n}\n\n// will behave as expected\nstatic double getRandomSample(SeededRandom prng, double min, double max) {\n   return prng.uniform(min, max).sample();\n}
\n

Because the non-static method is part of the class, it will force the system to serialize the entire Model in order to be able to access this function.\nIf the method is static, it does not depend on an instance of the Model and can be called safely from a distributed environment.

\n

Immutability of GlobalState

\n

Agent-Based Model contains a GlobalState that allows you to make global variables available to all agents.\nAt their creation, usually at Model#Setup(), agents are distributed and given a copy of the GlobalState.\nAfter this distribution, the global state should not be updated. There is currently no consistency mechanism to ensure updates on GlobalState are carried over the network.\nConsequently, all GlobalStates' update should be done at the beginning (or before) the Model#setup call, to ensure the consistency of the model across all nodes.

","headings":[{"value":"Serializable Messages","depth":2},{"value":"Prevent Passing Of Reference","depth":2},{"value":"Immutability of GlobalState","depth":2}],"frontmatter":{"title":"Distributed Requirements","toc":null,"experimental":null}},"site":{"siteMetadata":{"title":"Simudyne Docs","latestVersion":"2.6"}}},"pageContext":{"absolutePath":"/home/vsts/work/1/s/content/2.4/reference/distributed_computation/distributed_requirements.md","versioned":true,"version":"2.4","kind":"reference","pagePath":"/reference/distributed_computation/distributed_requirements","chronology":{"prev":{"name":"Distributed Graph","path":"/reference/distributed_computation/distributed_graph"},"next":{"name":"System Dynamics","path":"/reference/system_dynamics"}},"lastUpdated":"2026-04-21T13:56:54.852Z"}}