History

Last updated on 16th July 2024

2.0.5

22nd August 2018

This is a minor improvement release, including a compatibility update for deployment on Spark 2.2.x.

Dependency changes

json4s is has been downgraded to version 3.2.11 to match Spark 2.2.x.

Module changelogs

core-abm

Agent#setEnvironment signature has been updated to be consistent with that in Vertex, resolving a warning showing in some IDEs.
Performance for frequently used LongAccumulator and DoubleAccumulator when running on machines with high core counts has been improved.

core

Annotating final or effectively final values such as Scala vals as inputs now gives a clearer, eager error detailing the issue.

2.0.4

2nd August 2018

This is a bug-fix release, most importantly fixing issues relating to execution on Spark using YARN.

Dependency changes

akka and akka-http have been updated to their latest versions (2.5.13 and 10.1.3 respectively)
akka-slf4j is now included as a dependency.
akka-http-testkit is no longer included as a dependency.

Module changelogs

core-abm

When loading links from a Source, ids are now validated to be in the expected range of IDs.

nexus-server

Timeout for long operations has been increased from 20 seconds to 120 seconds.

core-graph-spark

Resolved issues with execution on Spark using YARN, related to Kryo ClassLoaders.
Resolved issues related to serialisation occurring with Spark 2.2.0.

2.0.3

26th June 2018

This is a critical bug-fix release relating to deployment on Cloudera Spark clusters.

Dependency changes

Spark dependency is now properly marked as "provided" scope.
fastutil library has been downgraded from version 8.1.1 to 6.3, to match commonly deployed ambient libraries.

console

String input fields should no longer be null when set from the console.

2.0.2

8th June 2018

Breaking changes

This release is primarily focused on bug fixes but does include a minor API change to be aware of when upgrading; Data injectors for links now receive the agent itself rather than an InitContext. This change allows link attributes to be set based on the agent, and for agents to be altered based on their links. Access to the seeded PRNG and agent ID is then available directly from the agent, e.g. Agent#getPrng().

Group<MyAgent> = generateGroup(MyAgent.class, 100)

// Before
myGroup.fullyConnected(otherGroup, MyLink.class,
  // receives types InitContext and MyLink
  (initContext, myLink) -> { ... });

// After
myGroup.fullyConnected(otherGroup, MyLink.class,
  // receives types MyAgent and MyLink
  (myAgent, myLink) -> { ... });

Behavioural changes

This release includes some improvements which can affect the behaviour of your models.

For APIs where a class is specified for selection, all subclasses of that type will also be selected. See specific changes in core-abm for further information.
When loading external data, user data injectors are now run after the external data has been assigned to the instance.

console

The network tile is now always shown as the first tile when displayed.
The network tile can now appropriately display boolean attributes.
The fan chart shown for multi run results should no longer report NaN as the current value.
The headings for agent tables should now always align with the corresponding columns.
Values of type int and long will no longer show decimal places in the agent table.
Inputs of type String are now supported in the console.
Exception modals can now be dismissed.

nexus-server

The default nexus timeout, controlled by nexus-server.nexus-lifetime, has been increased from 30 to 60 minutes.
Progress for batched model runs is now calculated from the total progress on ticks, rather than the total progress on runs, which should give a smoother progress update when running a high number of ticks.
Batch runs now use the nexus-server.batchrun-lifetime configuration property to determine how long the server stores the results, and this is now timed from when the results are generated rather than when the batch processing is started.
Exceptions thrown during a batch run are now caught and reported. This will also include the root PRNG seed for the run that failed.

core-abm

[Behaviour Change] AgentSelection, as returned by AgentBasedModel#select(Class<AgentType>), now includes subclasses of the given agent type in the selection.
[Behaviour Change] Messages and Links retrieved from an agent, e.g. from Agent#getMessagesOfType(Class<MessageType>), now include subclasses of the given type.
[Behaviour Change] The data injector run by loadGroup(Class<AgentType>, Source, SerializableConsumer<T>) now runs after data from the source has been injected, rather than before.
[**Breaking Change]** Connector data injectors now are given the Agent instance itself, rather than an InitContext. This allows links to be created based on attributes of the agent, and also for agents to be updated based on link properties.

core-graph

Note that changes within this module should not directly affect any users of the API unless noted under core-abm, unless you are using this lower level implementation directly.

[Behaviour Change] VertexSelection now includes subclasses of the given agent type in the selection.
[Breaking Change] Vertex is now an abstract class, rather than an interface. Methods relating to accessing links, such as Environment#getLinks() have moved from the Environment interface to the Vertex class.
[Breaking Change] Graph#addVertices now receives an InitContext rather than a ConnectionInitializer
simudyne.core.graph.SerializationLevel and related configuration setting core-abm.serialization-level have been removed.

2.0.1

17th May 2018

This is a minor bug fix release, primarily resolving issues with the network tile display. Improvements have also been made to the ABM API, allowing more flexible definition of actions, as well as injection of attributes to agents loaded from external sources.

console

Improved attribute selection UI for network tile.
Improved display for hovering agents in the network tile.
Network tile should now reliably update when links in the network change.
Agent table now shows rounded numbers for floating point values.
Upgrading console version should no longer require a browser cache clear.

core-abm

Actions now also run against all subclasses of their defined agent class.
Added AgentSystem#loadGroup(Class<AgentType>, Source, Consumer<AgentType>) (as well as AgentBasedModel#loadGroup(...) shortcut method).
- This allows customisation of agent attributes when loaded from a Source, in the same way as generating agents from scratch allows.

2.0.0

April 19th 2018

First major release of the new Simudyne SDK 2.0.

Release Notes Libraries