2.4.1

01st June 2021

This is a minor release of the software that includes a few fixes to Parquet output as well as some smaller request features.

Upgrading

Upgrading can be done by changing the simudyne.version setting in your pom.xml to 2.4.1. You MUST also switch any instance in your pom.xml where a library like simudyne-core-abm_2.11 exists to simudyne-core-abm_2.12 - This is because 2.4 is now using Scala 12.

There should be no breaking changes going from 2.4.0 to 2.4.1, but if upgrading for the first time see below.

Fixes

• Parquet Output is no longer nested within an additional structure. This should support more common readers requirements and lessen data impact.
• Fixed an issue where some Hive configuration was using default localhost which for some deployments could pose an issue.
• If there is no simudyneSDK.properties file a warning will now notify the user, this is to mitigate confusion on why certain settings may not be working as the software would simply revert back to defaults.
• Additional checks have been made to not cause issues with missing properties that users may not require (such as Hive password / username)

Additions

• Parquet Output now supports the ability to work with INT's, previously usage of LONG or DOUBLE was required.
• A ScenarioDefinitionsBuilder has been added - previously this was only possible via Scala instead of Java like other Builders.
• The Programmable Random Number Generator (prng) now has the ability to getRandom in order to generate a RNG for usage with the default seed set by the PRNG, and a getSeed function which is preferable to grabbing to seed from configuration (which can be overwritten)

2.4.0

25th January 2021

This is a major relase of the software, including updated data handling and a more powerful console.

Upgrading

Upgrading can be done by changing the simudyne.version setting in your pom.xml to 2.4.0. You MUST also switch any instance in your pom.xml where a library like simudyne-core-abm_2.11 exists to simudyne-core-abm_2.12 - This is because 2.4 is now using Scala 12.

We have been careful in 2.4 to avoid any other major breaking changes, but there are still a few things to be aware of. Most notably will be changes to data structure and format of parquet output.

Parquet Output

We've updated the process for handling data output via Parquet. This involves usage of new libaries both to improve performance but also availabilty to easily use in both other data formats and output methods in 2.4 and 2.5 Parquet Output

Hive Integration

Changes to our output libraries allows us to now connect via JDBC to a Hive database using the exact same structure of parquet output. Users can simply modify their settings to move local output to Hive. Hive Output

H2 Output

Updates to data format will allow storage to H2, a simple example is available at H2 Output

Chart Improvements

Console charts now have better handling for negative values, as well as optional bounding in order to easily analyze your data.

Import updates and bug fixes

Several classes may have been moved, so their imports will have to be updated to reflect that. The easiest way to do that is to remove the old imports which are broken, and with your mouse over the erroring classes, press alt + enter (this only works if using Intelij). Intelij will now be able to find and add the new import for you.

Additional various small fixes to other bugs have been added, mostly concerning the console.