Skip to content

Microdata output core release: 17 of January 2023
Compare
Choose a tag to compare
@amc1999 amc1999 released this 17 Jan 11:22
· 607 commits to master since this release
v1.13.0
b046cc9

Microdata output core release: 17 of January 2023

20230117 : v1.13.0

This release include core functionality to support model microdata. Please skip this release unless microdata is an important part of your model, use 23 of September 2022 release v1.11.1

Changes in that release:

  • scripts and instructions how to upgrade production databases
  • c++ core: multiple bug fixes in microdata code
  • wiki: updated developer topic Microdata Output
  • Go back-end: add microdata support into dbcopy and oms
  • dbcopy: store parameters, output tables and microdata in separate sub-folders
  • oms: additional filters to select microdata more precisely

Upgrade models SQLite database files to the new schema

If you are using openM++ models in production then it is necessary to existing databases before using new release.
Please follow the readme.txt instructions and run upgrade scripts suitable for your OS which are located in sql/upgrade_to_20221210/ folder.

Important: Always do a database backup before running any upgrade scripts.

Windows:
Assuming existing database files are in:

C:\openmpp_win_20220923\
                       bin\
                       models\

and current release unpacked into:

C:\openmpp_win_20221210\
                       bin\
                       sql\upgrade_to_20221210\
                                              upgrade_win.bat

Option 1:

  • copy directory \upgrade_to_20221210\ into old openM++ folder: C:\openmpp_win_20220923\
  • double click on C:\openmpp_win_20220923\upgrade_to_20221210\upgrade_win.bat

Option 2:

  • open command prompt (not PowerShell) and type:
    cd /D C:\openmpp_win_20221210\sql\upgrade_to_20221210
    upgrade_win.bat C:\openmpp_win_20220923

Linux or MacOS
Assuming existing database files are in:

~/openmpp_debian_20220923/
                       bin/
                       models/

and current release unpacked into:

~/openmpp_debian_20221210/
                       bin/
                       sql/upgrade_to_20221210/
                                              upgrade_linux.sh

Option 1:

cp -r ~/openmpp_debian_20221210/sql/upgrade_to_20221210/ ~/openmpp_debian_20220923/
cd ~/openmpp_debian_20220923
./upgrade_to_20221210/upgrade_linux.sh

Option 2.

cd ~/openmpp_debian_20221210/sql/upgrade_to_20221210/
./upgrade_to_20221210/upgrade_linux.sh ~/openmpp_debian_20220923

Updated model developer topic Microdata Output on wiki

The model developer wiki topic Microdata Output has been revised to improve and expand previous content. It now also includes new material with worked examples on event context, event filtering, and database output, including use of dbcopy to extract microdata for downstream use. The Microdata Output developer topic is at https://github.com/openmpp/openmpp.github.io/wiki/Microdata-Output

Known Issue

MPI version of models (cluster and cloud version, not desktop) suffering from heap fragmentation and excessive memory consumption if microdata are written into database. We are planning to fix this problem in subsequent releases.

Download source code and binaries:

Download release documentation archive:

Download cluster version (MPI):

IMPORTANT:
Full version of OpenM++ source code always included into "Download" links above.
Please do NOT use "Source code (zip)" or "Source code (tar.gz)" archives from "Assets" links below.
It is auto-generated by GitHub release tools and contains only half of OpenM++ source code.

Assets 13
Loading