AnyLogic provides users with the easy mechanism of integrating AnyLogic models with external Java applications.
AnyLogic comes with a set of special How To models demonstrating different integration scenarios and containing code that can be used as a starting point in case you need some particular integration case and want to develop the given solution further in your Java project.
This article describes how to launch AnyLogic model (and display its model window enabling the user to control the model execution) from external Java application. This integration case is implemented in the following how-to model:
How-To model: Launching AnyLogic Model from External Application
Let's study what should be done to launch the model from external Java application so that its model window is shown. Please open this how-to model by clicking the link given above. Study the model inner structure.
The model contains:
Open MyApplication Java class by double-clicking it in the Projects view. You will see the following code there:
System.out.println() calls just output some information about the model run progress, so you should pay your great attention here to the following lines.
First of all:
final Simulation s = new Simulation();
Here the constructor of the simulation experiment named Simulation is called. Please note that Simulation here is the name of the simulation experiment in this particular model, not the name of the base class for simulation experiments in AnyLogic. In case the experiment is named MyExperiment, you need to write MyExperiment s = new MyExperiment();
Next, we call the constructor to create a host object for the simulation experiment:
host = new ExperimentHost( s );
Then you may notice the following functions being called:
The function setup() of the experiment performs the initialization of the simulation. We pass the host object created before as an argument of this function.
The function launch() creates the model presentation window.
Finally the experiment function runTheModel()
is called. This function is declared right in the model, you can find
it on the simulation experiment's diagram. It runs the model and
shows the presentation of the model's top level agent in the
You can also see that you can easily set up experiment parameter values - they are accessible as experiment fields simply by their names. Here we set 0.012345 as the value of Fraction parameter by writing s.Fraction=0.012345; Note that your external application may choose and set up arbitrary values for the model parameters.
To check how this
integration scenario works
If you want to use the described technique in your application and continue developing it further in some Java IDE, please follow the steps described below. We will describe how to apply this solution in Java project created in Java IDE Eclipse. If you do not have Java project in Eclipse, create it as described here (online help documentation on Eclipse web site).
To use the
described technique in your Java application
Now you will see new files appeared in the project folder.
Select compiled .jar
file of the model
(model.jar) and choose Build path
path from the context menu. Do not add the bat/cmd/sh
files since their purpose is just to launch the exported
model and we do not need them in our project.
In the same manner add all .jar
files required for successful model compilation. The folders
that contain them are highlighted in the image below. Expand each folder in Package Explorer
and select all .jar files
inside to add them to build path:
Note that you can use the usual Code Completion (displayed on pressing Ctrl+space) while typing code in Eclipse.
Import the package containing the model classes. Type the following code in the next line:
(You can find the model package name in
the Advanced properties
section of the AnyLogic model)
In this particular case we will type:
The class code of your project should look as follows:
Now you can refer to model classes in the code of your project. The easiest way to implement the described solution is just to copy the function main() from the model's Java class MyApplication into the class of your Java project:
That's all, now you can run the class as Java application. You will see that the launched application opens the model window. It is the usual model window, that is created and displayed on the model run.
You can see the output information displayed in the Eclipse Console view.
Integrating AnyLogic models with external Java applications
Running the model from outside without model window