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

During development it will likely become useful to make usage of automated testing tools for both Unit and Regression testing. Because the Simudyne SDK allows for multiple run configurations the ability to create scripts for certain configurations lends itself to automatic testing. Below are two examples of what some usage of CI tools would look like.

\n

Main.java Setup

\n

Below is a sample model class that makes usage of various demo models and runner configurations. It has been setup to look for command line arguments in order to determine which mode it should run in, as well as configuration for number of ticks/runs/agents.

\n

Note: You will need to make sure that the input for numAgents exists in your model if following this code example.

\n

Main.java

\n
package sandbox;\n\nimport sandbox.demos.SimudyneSIR.SimudyneSIR;\nimport sandbox.demos.TumorGrowthSimulator.TumorGrowthModel;\nimport sandbox.demos.cda.CDAModel;\nimport sandbox.demos.creditCard.CreditCardModel;\nimport sandbox.demos.forestFire.ForestFireModel;\nimport sandbox.demos.mortgage.MortgageModel;\nimport sandbox.demos.schelling.SchellingModel;\nimport sandbox.demos.tokyo.TokyoModel;\nimport sandbox.demos.trading.TradingModel;\nimport sandbox.demos.volatilityModel.VolatilityModel;\nimport simudyne.core.Model;\nimport simudyne.core.exec.runner.ModelRunner;\nimport simudyne.core.exec.runner.MultirunController;\nimport simudyne.core.exec.runner.RunnerBackend;\nimport simudyne.core.exec.runner.definition.BatchDefinitionsBuilder;\nimport simudyne.core.exec.runner.definition.ModelSamplerDefinitionsBuilder;\nimport simudyne.core.exec.runner.definition.Scenario;\nimport simudyne.core.exec.runner.definition.ScenarioDefinitionsBuilder;\nimport simudyne.nexus.Server;\n\nimport java.time.Duration;\nimport java.time.Instant;\n\npublic class Main {\n  public static void main(String[] args) {\n    Instant startTime = Instant.now();\n    System.out.println(\"Start Time \" + startTime);\n\n    String fallBackMode = \"BATCH\"; // BATCH, SCENARIO, SAMPLER, CONSOLE\n    Class fallbackModel = sandbox.testing.housing.MortgageModel.class;\n    int runs = (args.length > 1) ? Integer.parseInt(args[0]) : 1;\n    long ticks = (args.length > 2) ? Long.parseLong(args[1]) : 100;\n    long agents = (args.length > 3) ? Long.parseLong(args[2]) : 1000;\n\n    try {\n      @SuppressWarnings(\"unchecked\")\n      Class<? extends Model> modelClass = (args.length > 3) ? (Class<? extends Model>) Class.forName(args[3]) : fallbackModel;\n      RunnerBackend runnerBackend = RunnerBackend.create();\n      ModelRunner modelRunner = runnerBackend.forModel(modelClass);\n      String mode = (args.length > 4) ? args[4] : fallBackMode;\n\n      switch (mode) {\n        case \"BATCH\":\n          {\n            System.out.println(\"Running in Batch Mode\");\n            BatchDefinitionsBuilder runDefinitionBuilder;\n            if (args.length > 3) {\n              runDefinitionBuilder =\n                  BatchDefinitionsBuilder.create().forRuns(runs).forTicks(ticks).withInput(\"numAgents\", agents);\n            } else {\n              runDefinitionBuilder = BatchDefinitionsBuilder.create().forRuns(runs).forTicks(ticks);\n            }\n            modelRunner.forRunDefinitionBuilder(runDefinitionBuilder);\n            modelRunner.run().awaitOutput();\n            exit(startTime);\n          }\n        case \"SCENARIO\":\n          {\n            System.out.println(\"Running in Scenario Mode\");\n            Scenario runDefinitionBuilder =\n                ScenarioDefinitionsBuilder.create().createScenario(\"Test\").forRuns(runs).forTicks(ticks);\n            modelRunner.forRunDefinitionBuilder(runDefinitionBuilder.done());\n            modelRunner.run().awaitOutput();\n            exit(startTime);\n          }\n        case \"SAMPLER\":\n          {\n            System.out.println(\"Running in Model Sampler Mode\");\n            ModelSamplerDefinitionsBuilder runDefinitionBuilder =\n                ModelSamplerDefinitionsBuilder.create().forRuns(runs).forTicks(ticks);\n            modelRunner.forRunDefinitionBuilder(runDefinitionBuilder);\n            modelRunner.run().awaitOutput();\n            exit(startTime);\n          }\n        case \"CONSOLE\":\n          {\n            System.out.println(\"Running in Console Mode\");\n            Server.register(\"Trading Model\", TradingModel.class);\n            Server.register(\"Mortgage Model\", MortgageModel.class);\n            Server.register(\"Credit Card Model\", CreditCardModel.class);\n            Server.register(\"Continuous Double Auction Model\", CDAModel.class);\n            Server.register(\"Volatility Model\", VolatilityModel.class);\n            Server.register(\"Chain Bankruptcy Model\", TokyoModel.class);\n            Server.register(\"S.I.R. Model\", SimudyneSIR.class);\n            Server.register(\"Tumor Growth Model\", TumorGrowthModel.class);\n            Server.register(\"Schelling Segregation Model\", SchellingModel.class);\n            Server.register(\"Forest Fire Model\", ForestFireModel.class);\n\n            // Start the server.\n            Server.run();\n          }\n      }\n    } catch (Exception e) {\n      e.printStackTrace();\n    }\n  }\n\n  public static void exit(Instant startTime) {\n    Instant finishTime = Instant.now();\n    long timeElapsed = Duration.between(startTime, finishTime).getSeconds();\n    System.out.println(\"Finish Time \" + finishTime);\n    System.out.println(\"Elapsed Time (seconds) \" + timeElapsed);\n    System.exit(0);\n  }\n}
\n

Scripting Runs

\n

Now that we've setup our Main.java to accept command line arguments we have the ability to cleany run multiple types of simulations for testing purposes. Below is a sample shell script that tests the model and ramps up number of agents, ticks, and runs.

\n

MortgateModel.sh

\n
#!/bin/bash\ncd ..\n# Baseline\nmvn compile exec:java -Dexec.args=\"1 10 100 sandbox.testing.advanced3.MortgageModel BATCH\"\n# Agent\nmvn compile exec:java -Dexec.args=\"1 10 100 sandbox.testing.advanced3.MortgageModel BATCH\"\nmvn compile exec:java -Dexec.args=\"1 10 1000 sandbox.testing.advanced3.MortgageModel BATCH\"\nmvn compile exec:java -Dexec.args=\"1 10 10000 sandbox.testing.advanced3.MortgageModel BATCH\"\n# Tick\nmvn compile exec:java -Dexec.args=\"1 10 100 sandbox.testing.advanced3.MortgageModel BATCH\"\nmvn compile exec:java -Dexec.args=\"1 100 100 sandbox.testing.advanced3.MortgageModel BATCH\"\nmvn compile exec:java -Dexec.args=\"1 1000 100 sandbox.testing.advanced3.MortgageModel BATCH\"\n# Runs\nmvn compile exec:java -Dexec.args=\"1 10 100 sandbox.testing.advanced3.MortgageModel BATCH\"\nmvn compile exec:java -Dexec.args=\"10 10 100 sandbox.testing.advanced3.MortgageModel BATCH\"\nmvn compile exec:java -Dexec.args=\"100 10 100 sandbox.testing.advanced3.MortgageModel BATCH\"\nmvn compile exec:java -Dexec.args=\"1000 10 100 sandbox.testing.advanced3.MortgageModel BATCH\"\nmvn compile exec:java -Dexec.args=\"10000 10 100 sandbox.testing.advanced3.MortgageModel BATCH\"\nexit
\n

Azure Devops

\n

Please refer to Deploy on Azure for a visual guide on how to add a Github project to Azure Devops. However while that page will describe how to get your model on a Azure Web Service, this will cover what your .yaml file should look like for testing with the above setup.

\n

azure-pipelines.yml

\n
# Maven\n# Build your Java project and run tests with Apache Maven.\n# Add steps that analyze code, save build artifacts, deploy, and more:\n# https://docs.microsoft.com/azure/devops/pipelines/languages/java\n\ntrigger:\n- master\n- staging\n\npool:\n  vmImage: 'ubuntu-latest'\n\nsteps:\n- task: Maven@3\n  inputs:\n    mavenPomFile: 'pom.xml'\n    options: '--settings settings.xml'\n    mavenOptions: '-Xmx3072m'\n    javaHomeOption: 'JDKVersion'\n    jdkVersionOption: '1.8'\n    jdkArchitectureOption: 'x64'\n    publishJUnitResults: false\n    testResultsFiles: '**/surefire-reports/TEST-*.xml'\n    goals: 'compile'\n\n- task: DownloadSecureFile@1\n  name: license\n  inputs:\n    secureFile: 'azure_pipelines.license'\n\n- task: DownloadSecureFile@1\n  name: maven_settings\n  inputs:\n    secureFile: 'settings.xml'\n\n- script: |\n    mkdir -p ~/.simudyne\n    cp $(license.secureFilePath) /home/vsts/.simudyne/azure.license\n    cp $(maven_settings.secureFilePath) $(System.DefaultWorkingDirectory)/settings.xml\n  displayName: 'Setup Files'\n\n- task: ShellScript@2\n  inputs:\n    scriptPath: MortgageModel.sh\n\n- task: CopyFiles@2\n  inputs:\n    SourceFolder: '$(System.DefaultWorkingDirectory)'\n    Contents: '**.log'\n    TargetFolder: $(Build.ArtifactStagingDirectory)\n  displayName: 'Copy Logs'
\n
\n

Secure Files

\nAs the settings.xml contains login information, and the license file is also meant to be obscured you'll notice that both are secure files. See [here](https://docs.microsoft.com/en-us/azure/devops/pipelines/library/secure-files?view=azure-devops) for a guide on how to add secure files to Azure Devops.\n
\n

Jenkins CI

\n

Another CI tool is Jenkins. Below is a simple example that uses Maven and Java 8, informs the user some initialization information and runs our above simple script. It also includes credential files that must be configured via Jenkins correctly as shown here.

\n

A simple JenkinsFile example

\n
pipeline {\n    agent any\n    tools { \n        maven 'Maven 3.3.9' \n        jdk 'jdk8' \n    }\n    stages {\n        stage ('Initialize') {\n            steps {\n                sh '''\n                    echo "PATH = ${PATH}"\n                    echo "M2_HOME = ${M2_HOME}"\n                ''' \n            }\n        }\n\n        stage ('Build') {\n            withCredentials([\n              file(credentialsId: 'license_file', variable: 'LICENSE_FILE'),\n              file(credentialsId: 'settings_file', variable: 'MVN_SETTINGS')\n            ]) steps {\n\t\t\t\tsh "cp --force $LICENSE_FILE licenseKey; cp --force $MVN_SETTINGS settings.xml"\n                sh '/opt/script-directory/MortgageModel.sh'\n            }\n        }\n    }\n}
","headings":[{"value":"Main.java Setup","depth":2},{"value":"Scripting Runs","depth":2},{"value":"Azure Devops","depth":2},{"value":"Jenkins CI","depth":2}],"frontmatter":{"title":"Continuous Integration Tools","toc":null,"experimental":null}},"site":{"siteMetadata":{"title":"Simudyne Docs","latestVersion":"2.6"}}},"pageContext":{"absolutePath":"/home/vsts/work/1/s/content/2.6/reference/testing_logging/ci.md","versioned":false,"version":"2.6","kind":"reference","pagePath":"/reference/testing_logging/ci","chronology":{"prev":{"name":"Atomic Debug Logging","path":"/reference/testing_logging/atomic-log"},"next":{"name":"System Dynamics","path":"/reference/system_dynamics"}},"lastUpdated":"2026-04-21T13:56:54.870Z"}}