MacOS Quick Start User

Where is OpenM++

• Download latest binary files and source code: openmpp_mac_YYYYMMDD.tar.gz
• Documentation: this wiki

You can have multiple versions of openM++ installed on your computer. OpenM++ distributed as tar.gz archive, you can unpack into any directory and it is ready to use. In the documentation that directory called OM_ROOT.

OpenM++ does not update any system shared resources and you can remove it any time by simply deleting openM++ directory.

It is possible to run openM++ models:

• from terminal command line as described below
• using openM++ UI on your local computer: UI: openM++ user interface
• from Xcode model debug session: MacOS: Quick Start for Model Developers

On Linux and/or Windows you also can run model in cloud or on high perfomance cluster (HPC). Please also check Model Run: How to Run the Model page for more details.

Run openM++ models from terminal command line

• download and unpack openM++ using Safari or, for example, curl:

curl -L -o om.tar.gz https://github.com/openmpp/main/releases/download/v1.6.0/openmpp_mac_20200621.tar.gz
tar xzf om.tar.gz

• run modelOne model with single sub-sample on local machine:

cd openmpp_mac_20200621/models/bin/
./modelOne

2017-06-06 19:24:53.0747 modelOne
2017-06-06 19:24:53.0763 Run: 105
2017-06-06 19:24:53.0763 Reading Parameters
2017-06-06 19:24:53.0764 Running Simulation
2017-06-06 19:24:53.0765 Writing Output Tables
2017-06-06 19:24:53.0790 Done.

• run modelOne model with 16 sub-samples and 4 threads:

./modelOne -OpenM.Subvalues 16 -OpenM.Threads 4

2017-06-06 19:25:38.0721 modelOne
2017-06-06 19:25:38.0735 Run: 106
2017-06-06 19:25:38.0735 Reading Parameters
........................
2017-06-06 19:25:38.0906 Done.

• run other models (i.e. NewCaseBased, NewTimeBased, RiskPaths):

./NewCaseBased -OpenM.Subvalues 32 -OpenM.Threads 4

• run RiskPaths model with new parameter value CanDie = true and all other parameter values the same as in previous model run:

RiskPaths -Parameter.CanDie true -OpenM.BaseRunId 102

2020-08-14 17:27:48.574 RiskPaths
2020-08-14 17:27:48.610 Run: 103
2020-08-14 17:27:48.618 Sub-value: 0
2020-08-14 17:27:48.628 member=0 Simulation progress=0% cases=0
........................
2020-08-14 17:27:54.883 Done.

• run modelOne to compute modeling task "taskOne":

./modelOne -OpenM.Subvalues 16 -OpenM.Threads 4 -OpenM.TaskName taskOne

2017-06-06 19:27:08.0401 modelOne
2017-06-06 19:27:08.0421 Run: 107
2017-06-06 19:27:08.0421 Reading Parameters
........................
2017-06-06 19:27:08.0593 Run: 108
2017-06-06 19:27:08.0593 Reading Parameters
........................
2017-06-06 19:27:08.0704 Writing Output Tables
2017-06-06 19:27:08.0812 Done.

• in case if previous model run fail, for example, due to power outage, then it can be "restarted":

./modelOne -OpenM.RestartRunId 1234

output may vary depending on the stage where previous modelOne run failed, but still similar to above.