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

Messaging Semantics

\n

The Simudyne SDK adopts the Pregel approach to graph processing. This means that all computation is driven by messages. At every action in the sequence, every agent will process its action only if it has received a message.

\n

In addition to this, Pregel adopts a pure message passing model that eliminates the need of shared memory and remote read, so all sharing of information between agents is done by message passing.

\n

Message Types

\n

All messages sent must extend Message. There are a number of ways in which you may do so, each suitable for different scenarios.

\n

Empty Messages

\n

For messages that have no value one can extend Message.Empty. This is useful if your message type alone is sufficient to convey the required semantics.

\n

Single Primitive Type Messages

\n

For messages that contain only a single primitive value, the Simudyne SDK provides Integer, Long, Float, Double, and Boolean message classes that can be extended. They all provide a getBody() method that returns the primitive value. Use this whenever you need to send only one field.

\n

Complex Data Types

\n

For messages that require sending complex data types extend Message.Object<T>. This will allow you to send a message who's body is the object. It also allows the receiver access to methods on the object.

\n

Messages with Arbitrary Fields

\n

If your message needs to send an arbitrary amount of data, but no explicit type exists, consider extending Message.

\n

For organising custom message classes, see Message Organisation.

\n
\nWhen running the model in distributed mode, all message types need to be registered with the model. This isn't necessary if running the model locally.\n
\n

Registering messages

\n

(Java)

\n
public class MyClass extends AgentBasedModel<GlobalState> {\n  ...\n  registerMessageTypes(Boolean.class, Messages.Vacancy.class);\n  ...\n}
\n

Advanced Message Manipulation

\n

There are other lower level ways of manipulating messages and action sequencing - please refer to System Messages

","headings":[{"value":"Messaging Semantics","depth":2},{"value":"Message Types","depth":2},{"value":"Empty Messages","depth":3},{"value":"Single Primitive Type Messages","depth":3},{"value":"Complex Data Types","depth":3},{"value":"Messages with Arbitrary Fields","depth":3},{"value":"Advanced Message Manipulation","depth":2}],"frontmatter":{"title":"Messaging","toc":null,"experimental":null}},"site":{"siteMetadata":{"title":"Simudyne Docs","latestVersion":"2.6"}}},"pageContext":{"absolutePath":"/home/vsts/work/1/s/content/2.6/reference/modelling/messaging.md","versioned":false,"version":"2.6","kind":"reference","pagePath":"/reference/modelling/messaging","chronology":{"prev":{"name":"Actions & Sequencing","path":"/reference/modelling/actions"},"next":{"name":"Random Number Generation","path":"/reference/modelling/prng"}},"lastUpdated":"2026-04-21T13:56:54.869Z"}}