Controls on this page have intuitive meaning, and only the Window size edit box needs to be discussed. This edit box determines the interval of time (for timed datasets) or the number of points (for non-timed datasets) displayed in the window.
Datasets page
The Datasets page of the Chart Options dialog box looks as shown in Figure 170. The Datasets page is used to specify individual options for each dataset. Also it is used to turn a chart window into a phase diagram.
1.Click Choose button in the Marker color group box. The Color dialog box is displayed.
2.Select color using the Color dialog box.
Each dataset is a set of value pairs <x,y>. When displaying several datasets in one window, you can either map x-values of all datasets to the X-axis, or you can specify that a y-value of some dataset should be mapped to X-axis, and y-values of other datasets should be mapped to the Y-axis. The latter case is called a phase diagram, and it is a sort of a scatter.
►To let all datasets map their x-values to the X-axis
1.Select the Non-phaseoption in the Phase diagram group box.
►To turn the chart window into a phase diagram
1.Select the Absciss is dataset option in the Phase diagram group box.
2.Choose the dataset whose y-values should be mapped to the X-axis.
17.3.2Visualizing collected data in AnyLogic animation
Dataset plots can also be displayed in an AnyLogic animation using a special control – a chart indicator. A chart indicator displays a dataset in one of the following forms: scatter, Gantt, pie chart, or bar chart. See section 12.2.3.3, “Chart indicator” for the detailed description of chart indicator.
►To create a chart indicator
1.Click the Chart Indicator toolbar button, or
Choose Draw|Animation|Chart Indicator from the main menu.
2.Click or drag the indicator area on the animation diagram.
Chapter 17. Collecting data and performing statistical analysis
3.In the Properties window, specify the dataset in the Value to indicate combo box.
17.4Exporting statistical data to other applications
Data presented on a chart window can be copied on the Clipboard in the textual form (tabseparated) or exported to other applications, e.g., MS Excel. You can also get a graphical image of a window on the Clipboard.
►To copy datasets on the Clipboard in textual form
1.Right-click the chart window and choose Copy Data from the popup menu.
Because “x-values” of datasets displayed in the same chart window may not be identical, in the textual form each dataset forms an individual table with two columns. The left column contains “x-values” of that particular dataset (time in case of timed dataset, sample numbers in case of non-timed datasets, some user-specified values in case of phase dataset), and the right column contains the “y-values” of that dataset. The tables are placed one below the other and x- and y-values are tab-separated.
►To copy datasets on the Clipboard and paste them to MS Excel
1.Right-click the chart window and choose Copy to Excel from the popup menu.
►To copy the image of a chart window on the Clipboard
1.Right-click the chart window and choose Copy Image from the popup menu.
AnyLogic gives you the unique ability to run simulation models standalone:
•From the command line on any Java-enabled platform,
•As applets in Web browsers.
18.1Running a model from the command line
You can run AnyLogic model from command line on any Java-enabled machine. In this case, the model displays animation windows if you have developed them. However, you are not able to use AnyLogic windows to view and control the model.
First, you should specify that model files, specifically .class files, should be generated to the dedicated folder.
►To generate .class files to the dedicated folder
1.In the Project window, click the project (the top most item in the workspace tree).
2.In the Properties window, specify the folder path in the Folder for generated files edit box.
Once you specify the folder to store generated model files, build the model, set the folder specified as the current folder and enter the following shell command:
<java> – Java interpreter also known as Java virtual machine (for example, java.exe). If the operating system does not know a path to this application, you must specify the full path manually.
<xjanylogic5engine.jar> – file xjanylogic5engine.jar distributed as a part of AnyLogic.
<mylib1.jar>;…;<mylibn.jar> – list of Java libraries used by the model. The list may include your own libraries, third-party libraries, and libraries coming with AnyLogic.
<root> – full name of the class of the root object of the model. The class name must include the name of the package where the class can be found.
<options> – combination of options listed below:
––debug– tells the model to output debug information.
––norun– tells the model to stop after initialization. If omitted, the model starts running right after initialization.
––seed<num> – value used to seed the pseudorandom-number generator. If 0, the model chooses the seed randomly using the system timer.
<name>=<value> – sets the parameter <name> of the root object to the value
<value>.
18.2 Running a model as an applet
AnyLogic gives you the unique ability to make your models available online over the Internet. As long as an AnyLogic model is a 100% Java application, it can be presented as an applet and viewed in HTML browsers remotely. The simulation engine (including discrete part and numerical methods), the compiled model, and the animation will be transferred to the client machine and run there – with full degree of interactivity.
With respect to download time, the size of the engine is less than 500KB, which is small enough for one-time download at reasonable connection speeds.
Please note that multiple model applets can share the same engine file, so it is actually downloaded to the client machine only once – while the first model is accessed. For every next model, only the actual model code (normally of much smaller size) is downloaded. Check out how this works at http://www.xjtek.com.
1.Make sure you have created animation for the root object of the model. This animation picture is displayed in the applet window.
2.Click the Create Applet toolbar button, or Choose Model|Create Applet from the main menu.
The browser window opens with the applet displayed, as shown in Figure 171.
Figure 171. AnyLogic applet viewed in a Web browser
During this operation AnyLogic creates the folder “<project name> Applet Files” at the same location where the project resides. AnyLogic puts three files in this folder:
•xjanylogic5engine.jar - a copy of AnyLogic simulation engine.
•<project name>.jar - Java archive with the model code.
• <project name> Applet.html - a sample HTML file displaying the applet.
This is a self-sufficient set ready to be published on your Web site. To publish the applet, you would need to copy the first two files to the corresponding locations on your Web server (remember that you would need only one copy of the simulation engine for all model applets, because it can be shared), and to write your own HTML file using <project name> Applet.html as a template.
Each applet window contains a control bar (see Figure 171). It can be used to stop, run and restart the simulation, adjust the speed of model execution, and set up some appearance parameters.
18.2.1Configuring your Web browser to view Java applets
Some Web browsers have built-in capability of displaying Java applets; some require Java plug-in to be installed. The installation is done only once, before you view the first applet. Normally, the browser automatically detects whether the plug-in needs to be installed and offers to download and install the plug-in for your particular platform and browser version. If this does not happen, and you are unable to view Java applets, please consult your browser/OS manufacturer.
18.3 Controlling the model simulation
When AnyLogic simulation model is run either from a command line or as an applet, only animation and 3D animation windows are displayed if you have developed them. In this case, you can control the model simulation and configure animation using the toolbar, displayed in the top of AnyLogic animation and 3D animation windows (see Figure 172).
Namely, you can run, pause and reset the model, and set up model simulation speed, animation update rate and toggle the on/off anti-aliasing option. All these settings apply both to AnyLogic animation and 3D animation windows.
18.3.1Controlling the model simulation
From the animation control bar, you can start, pause or reset the model run.
►To run the model
1.Click the Run toolbar button.
►To pause the model
1.Click the Pause toolbar button.
►To reset the model
1.Click the Reset toolbar button.
18.3.2Setting up model speed
You may need to map the AnyLogic model time to the real time. It is frequently needed when you have developed some animation and want it to appear as in real life. Mapping of AnyLogic model time and the real time is described in section 13.1, “Simulation speed”.
You can set up either real time or virtual time mode. In real time mode, the mapping of model time units to seconds is made – i.e., you define that one model time unit takes the specified number of seconds. This mode can be used to make animation appear as in real life.
In the real time mode, you can increase or decrease model speed by changing the model simulation speed scale. You can change the model speed scale using the Model Speed toolbar slider. The default x1 scale means that the model is simulated with the model simulation
speed defined in the properties of the current AnyLogic experiment; x2 means that model is run twice faster than the specified model speed, etc. For instance, if the model speed is 6 model time units per second, x2 means that 12 model time units correspond to 1 second. You can change the model simulation speed as you like.
Also, you can run model in virtual time mode – the model runs at its maximum speed and no mapping is made between model time unit and seconds of astronomical time.
►To set virtual time mode
1.Move the Model Speed slider to the VT value.
18.3.3Configuring animation
You can configure animation rendering options; namely, specify animation update rate and enable or disable anti-aliasing.
18.3.3.1 Setting up animation update rate
AnyLogic enables you to set up the animation update rate. The greater update rate you specify, the smoother animation will appear. However, animation rendering takes some period of time and frequent animation update will slow the model simulation. So, choose between smooth animation and fast simulation and set up the animation update rate according to your needs.
You can explicitly specify fixed update rate in frames per second. Alternatively, you can specify adaptive update rate. Adaptive update rate will be recalculated during the model simulation to fix up the specified ratio between simulation speed and animation smoothness.
►To set up the animation update rate
1.Click the Settings toolbar button.
The Settings dialog box is displayed, as shown in Figure 173.
2.To define the fixed update rate, choose the Fixed option and explicitly specify the update rate in frames per second with a slider.
toolbar button, or
toolbar button, or Choose Model|Create Applet from the main menu.
toolbar button.
toolbar button.
toolbar button.
toolbar button.