No Description

Bentley James Oakes 46071f2745 Fix up urllib import. 3 years ago
bootstrap 7e7b45587e Python3 changes - part 1. 4 years ago
doc fe822f68a0 Add generation scripts for the pdf of the dot files 4 years ago
hybrid_server c2dff9f27d Fix imports in hybrid server. 4 years ago
integration ee4f4b136a Change urllib calls. 4 years ago
interface 46071f2745 Fix up urllib import. 3 years ago
kernel 163b07b520 Fix encoding when hashing. 4 years ago
model b2f0bc0469 Naively changed user to task in all files 4 years ago
models 348afda676 Updated model_overwrite: only the megamodelling version remains, and explicitly takes the required metamodel 4 years ago
scripts 1b68fd2e8a Switch raw_input to input when needed. 3 years ago
services 1b68fd2e8a Switch raw_input to input when needed. 3 years ago
state 042b4a3a46 Properly iterate and handle bytes. 4 years ago
unit a7dbc0cd25 Python3 porting of unit dir. 4 years ago
wrappers 1b68fd2e8a Switch raw_input to input when needed. 3 years ago
.gitattributes b3d374390d Make .gz files merge properly 4 years ago
.gitignore 9a7fc2330d Merge branch 'testing' into MvK_rules 4 years ago 592282cbcf Massive cleanup 4 years ago bfcb1fb5d4 More general code to sum times 4 years ago


Installing the Modelverse is unnecessary, as it is mere Python code and doesn't use installation scripts. All scripts which are generally useful are found in the 'scripts' directory, and are written in OS-independent Python code.

You will, however, need to install a dependency: the SCCD compiler and runtime.

Starting up the Modelverse

Starting up the Modelverse is easy: simply execute the scripts/ script, with as parameter the port you want to use. By default, port 8001 is used.

Communicating with the Modelverse

Now that the Modelverse is running, you will want to communicate with it! To do this, you can use whatever tool you want, as long as it can send and receive XML/HTTPRequests. For example, a mere internet browser can already communicate with the Modelverse, though not in the most user-friendly way.

A nicer way is through the Python prompt script scripts/ After that, it will print out all the output of the Modelverse, and send in all your queries directly to the Modelverse.

Python wrapper

To automatically communicate with the Modelverse in a programmatic way, a Python wrapper is provided. This wrapper is found in wrappers/, and provides Python functions that make the necessary Modelverse requests. At the moment, not all functions are implemented in the wrapper yet.


Performance of the Modelverse is currently rather low. This is primarily caused by the reliance on the action language, which is an explicitly modelled (and interpreted) language. Additionally, the Modelverse runs remotely, meaning that all requests have to pass over the network. Even when this is executed on the same machine, this causes quite some overhead.

Additional documentation

Some additional documentation can be found online in the Modelverse techreport, describing the internal workings of the Modelverse, as well as a brief introduction on how to use it. There is also in-depth documentation describing how to use the Modelverse and its various languages.


Running the tests is easy: simply execute scripts/ in the main modelverse folder. This will invoke the necessary build commands (to create bootstrapping code etc.) and call the tests for each individual aspect of the Modelverse. Note that testing is done using py.test, which is the only dependency of the Modelverse (and only for tests, of course).

Using PyPy

Since all scripts chain the invocation with the same interpreter as originally invoking the script, you will need to install py.test for PyPy. Assuming that you already have PyPy installed, you can simply install py.test using these commands:

pypy --user
pypy -m pip install pytest --user

From then on, you can simply invoke all tests in PyPy using:

pypy scripts/