com.anylogic.engine.AutotestExperimentHost

All Implemented Interfaces:: IExperimentHost

public class AutotestExperimentHost
extends Object

Nested Class Summary

Nested classes/interfaces inherited from interface com.anylogic.engine.gui.IExperimentHost

IExperimentHost.IValue

Method Summary

Modifier and Type	Method	Description
`void`	`addInspect(double x, double y, Presentable p, String name)`	Creates an inspect window at a particular location for an element of a Presentable object.
`Object`	`callFunction(String pathtofunction, IExperimentHost.IValue... args)`
`void`	`close()`	This method returns immediately and performs the following actions in a separate thread: stops experiment if it is not stopped, destroys the model and closes experiment window (only if model is started in the application mode)
`void`	`copyToClipboard(String text)`	Copies the given text to the system clipboard Due to the security policy of the browser, the actual copying may be preceded by a prompt.
`void`	`executeCommand(String cmd, String parameters)`
`void`	`executeUserAction(long id, String value)`
`LaunchConfiguration`	`getConfiguration()`
`Experiment<?>`	`getExperiment()`	Returns the experiment associated with this host.
`Experiment.State`	`getExperimentState()`
`SVGFrameProducer`	`getFrameProducer()`
`long`	`getNextFrameNumber()`
`Presentable`	`getPresentable()`	Returns the current top-level object (Agent or Experiment), whose presentation is displayed.
`double`	`getProgress()`
`AnimationPacket`	`getUpdate(boolean fullFrame)`
`Object`	`getValue(String pathtofield)`
`boolean`	`isRunControlEnabled()`	Tests if Run, Pause, and Stop buttons on the model toolbar are enabled.
`boolean`	`isSpeedControlEnabled()`	Tests if the model execution speed control buttons on the model toolbar are enabled.
`boolean`	`isZoomAndPanningEnabled()`	Tests if zoom & panning from the GUI is enabled.
`void`	`launch(boolean startServer, boolean startExperiment)`	Creates and optionally runs experiment, starts frame collection
`void`	`loadSnapshot(String fileName, Runnable successfulCallback, Consumer<Throwable> errorCallback)`	Stops experiment and loads snapshot (in its 'not running' state), doesn't resume simulation of loaded snapshot. On any error throws nothing, silently rollbacks to the current experiment and resumes it if it was running. When snapshot is loaded, presentation forgets everything about the model which was running before (including the engine, experiment and agents), therefore, it is recommended not to keep references to model objects after this method call Usage example:
`void`	`logFrame()`	No need for synchronization because called in same thread with model execution
`void`	`navigateHome()`	Navigates presentation home, i.e.
`void`	`navigateTo(ViewArea viewArea)`	Shows the given view area in the model animation panel
`void`	`onAgentDestroyed_xjal(Agent ao)`	A callback called by the engine when an agent is being destroyed.
`void`	`openWebSite(String url)`	Opens web page with the given URL in the browser
`void`	`postExperimentSettings()`
`void`	`removeInspect(Presentable p, String name)`	Removes the inspect window for the given element
`void`	`saveSnapshot(String fileName, Runnable successfulCallback, Consumer<Throwable> errorCallback)`	Pauses experiment if it is currently running, saves snapshot and then resumes experiment if it was running On any error throws nothing. Usage example:
`void`	`setCenter(double x, double y)`	Centers the animation view to the given x and y (in the model coordinates)
`void`	`setDeveloperPanelEnabled(boolean yes)`	Enables or disables the developer panel.
`void`	`setDeveloperPanelVisibleOnStart(boolean yes)`	Shows (if enabled) the developer panel when the model window is shown.
`void`	`setMaxFPS(double maxFPS)`
`void`	`setPresentable(Presentable p)`	Sets a new top-level object (Agent or Experiment) to be displayed and navigates to its home point.
`void`	`setRunControlEnabled(boolean runControlEnabled)`	Enables or disables Run, Pause, and Stop buttons on the model toolbar (but not in the developer panel), and sets the corresponding tooltips.
`void`	`setSendConsoleItems(boolean yes)`
`void`	`setSpeed(double speed)`
`void`	`setSpeedControlEnabled(boolean speedControlEnabled)`	Enables or disables the model execution speed control buttons on the model toolbar (but not in the developer panel), and sets the corresponding tooltips.
`void`	`setValue(String pathtofield, IExperimentHost.IValue value)`
`void`	`setZoomAndPanningEnabled(boolean yes)`	Enables or disables zoom & panning initiated from the GUI (button.
`void`	`showErrorDialog(String text, String title)`	Shows a standard error dialog box with the given text.
`void`	`showErrorInModelDialog(String text, String title)`	Shows a standard 'error in model logic' dialog box with the given text.
`void`	`showMessageDialog(String text)`	Shows a standard message dialog box with the given text.
`void`	`zoomIn(double coefficient)`	Zooms in the animation view by the given amount
`void`	`zoomOut(double coefficient)`	Zooms out the animation view by the given amount

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.anylogic.engine.gui.IExperimentHost

launch, loadSnapshot, saveSnapshot

Method Details

logFrame

public void logFrame()

No need for synchronization because called in same thread with model execution

getExperiment

public Experiment<?> getExperiment()

Description copied from interface: IExperimentHost

Returns the experiment associated with this host.

Specified by:: getExperiment in interface IExperimentHost
Returns:: the experiment associated with this host

getFrameProducer

public SVGFrameProducer getFrameProducer()

Specified by:: getFrameProducer in interface IExperimentHost

setPresentable

public void setPresentable(Presentable p)

Description copied from interface: IExperimentHost

Sets a new top-level object (Agent or Experiment) to be displayed and navigates to its home point.

Specified by:: setPresentable in interface IExperimentHost
Parameters:: p - the new top-level object to be displayed

getPresentable

public Presentable getPresentable()

Description copied from interface: IExperimentHost

Returns the current top-level object (Agent or Experiment), whose presentation is displayed.

Specified by:: getPresentable in interface IExperimentHost
Returns:: the current top-level object being displayed, or null

navigateHome

public void navigateHome()

Description copied from interface: IExperimentHost

Navigates presentation home, i.e. moves the presentation coordinate origin (0,0) to the top left corner of the window, and sets zoom to match the initial frame.

Specified by:: navigateHome in interface IExperimentHost

setZoomAndPanningEnabled

public void setZoomAndPanningEnabled(boolean yes)

Description copied from interface: IExperimentHost

Enables or disables zoom & panning initiated from the GUI (button. mouse, or keyboard).

Specified by:: setZoomAndPanningEnabled in interface IExperimentHost
Parameters:: yes - if true, zoom & panning should be enabled, if false - disabled

isZoomAndPanningEnabled

public boolean isZoomAndPanningEnabled()

Description copied from interface: IExperimentHost

Tests if zoom & panning from the GUI is enabled.

Specified by:: isZoomAndPanningEnabled in interface IExperimentHost
Returns:: true if zoom & panning are enabled, false if not.

setDeveloperPanelEnabled

public void setDeveloperPanelEnabled(boolean yes)

Description copied from interface: IExperimentHost

Enables or disables the developer panel.

Specified by:: setDeveloperPanelEnabled in interface IExperimentHost
Parameters:: yes - if false, there will be no button to show the developer panel

setDeveloperPanelVisibleOnStart

public void setDeveloperPanelVisibleOnStart(boolean yes)

Description copied from interface: IExperimentHost

Shows (if enabled) the developer panel when the model window is shown.

Specified by:: setDeveloperPanelVisibleOnStart in interface IExperimentHost
Parameters:: yes - if true, the panel will be visible from the beginning, and may be later hidden by pressing the special button.

setRunControlEnabled

public void setRunControlEnabled(boolean runControlEnabled)

Description copied from interface: IExperimentHost

Enables or disables Run, Pause, and Stop buttons on the model toolbar (but not in the developer panel), and sets the corresponding tooltips.

Specified by:: setRunControlEnabled in interface IExperimentHost
Parameters:: runControlEnabled - if false, those buttons will be disabled

isRunControlEnabled

public boolean isRunControlEnabled()

Description copied from interface: IExperimentHost

Tests if Run, Pause, and Stop buttons on the model toolbar are enabled.

Specified by:: isRunControlEnabled in interface IExperimentHost
Returns:: true if they are enabled, false if not.

setSpeedControlEnabled

public void setSpeedControlEnabled(boolean speedControlEnabled)

Description copied from interface: IExperimentHost

Enables or disables the model execution speed control buttons on the model toolbar (but not in the developer panel), and sets the corresponding tooltips.

Specified by:: setSpeedControlEnabled in interface IExperimentHost
Parameters:: speedControlEnabled - if false, those buttons will be disabled

isSpeedControlEnabled

public boolean isSpeedControlEnabled()

Description copied from interface: IExperimentHost

Tests if the model execution speed control buttons on the model toolbar are enabled.

Specified by:: isSpeedControlEnabled in interface IExperimentHost
Returns:: true if they are enabled, false if not.

setCenter

public void setCenter(double x,
 double y)

Description copied from interface: IExperimentHost

Centers the animation view to the given x and y (in the model coordinates)

Specified by:: setCenter in interface IExperimentHost
Parameters:: x - the x to be centered; y - the y to be centered

zoomIn

public void zoomIn(double coefficient)

Description copied from interface: IExperimentHost

Zooms in the animation view by the given amount

Specified by:: zoomIn in interface IExperimentHost
Parameters:: coefficient - how much to zoom in, positive number. E.g. 2.0 will result in 2x scaling compared to the current view

zoomOut

public void zoomOut(double coefficient)

Description copied from interface: IExperimentHost

Zooms out the animation view by the given amount

Specified by:: zoomOut in interface IExperimentHost
Parameters:: coefficient - how much to zoom out, positive number. E.g. 2.0 will result in 0.5x scaling compared to the current view

navigateTo

public void navigateTo(ViewArea viewArea)

Description copied from interface: IExperimentHost

Shows the given view area in the model animation panel

Specified by:: navigateTo in interface IExperimentHost
Parameters:: viewArea - the view area to show

addInspect

public void addInspect(double x,
 double y,
 Presentable p,
 String name)

Description copied from interface: IExperimentHost

Creates an inspect window at a particular location for an element of a Presentable object. If there is another inspect with the same Presentable and same element name, it is brought to front and a new inspect is not created. The initial size of the window is adjusted to fit the initial contents.

Specified by:: addInspect in interface IExperimentHost
Parameters:: x - the x coordinate in the presentable object system; y - the y coordinate in the presentable object system; p - the Presentable object whose element is being inspected; name - the name of the element being inspected

removeInspect

public void removeInspect(Presentable p,
 String name)

Description copied from interface: IExperimentHost

Removes the inspect window for the given element

Specified by:: removeInspect in interface IExperimentHost
Parameters:: p - the Presentable object whose element is being inspected; name - the name of the element being inspected

showMessageDialog

public void showMessageDialog(String text)

Description copied from interface: IExperimentHost

Shows a standard message dialog box with the given text. This method usually returns immediately - it doesn't wait for the dialog to be closed (except the cases when called from UI thread)

Specified by:: showMessageDialog in interface IExperimentHost
Parameters:: text - the text to display

showErrorDialog

public void showErrorDialog(String text,
 String title)

Description copied from interface: IExperimentHost

Shows a standard error dialog box with the given text. This method usually returns immediately - it doesn't wait for the dialog to be closed (except the cases when called from UI thread)

Specified by:: showErrorDialog in interface IExperimentHost
Parameters:: text - the text to display; title - title of the dialog window

showErrorInModelDialog

public void showErrorInModelDialog(String text,
 String title)

Description copied from interface: IExperimentHost

Shows a standard 'error in model logic' dialog box with the given text. This method usually returns immediately - it doesn't wait for the dialog to be closed (except the cases when called from UI thread)

Specified by:: showErrorInModelDialog in interface IExperimentHost
Parameters:: text - the text to display; title - title of the dialog window

saveSnapshot

public void saveSnapshot(String fileName,
 Runnable successfulCallback,
 Consumer<Throwable> errorCallback)

Description copied from interface: IExperimentHost

Pauses experiment if it is currently running, saves snapshot and then resumes experiment if it was running
On any error throws nothing.
Usage example:

 getExperimentHost().saveSnapshot(
                "file.als",
                () -> traceln("Saved!"),
                e -> {
                        traceln("Error!");
                        e.printStackTrace();
                }
 );

This method is only available in the AnyLogic Professional

Specified by:: saveSnapshot in interface IExperimentHost
Parameters:: fileName - the name of snapshot file; successfulCallback - called when snapshot is successfully saved; errorCallback - called in case of any error

loadSnapshot

public void loadSnapshot(String fileName,
 Runnable successfulCallback,
 Consumer<Throwable> errorCallback)

Description copied from interface: IExperimentHost

Stops experiment and loads snapshot (in its 'not running' state), doesn't resume simulation of loaded snapshot.
On any error throws nothing, silently rollbacks to the current experiment and resumes it if it was running.

When snapshot is loaded, presentation forgets everything about the model which was running before (including the engine, experiment and agents), therefore, it is recommended not to keep references to model objects after this method call
Usage example:

 getExperimentHost().loadSnapshot(
                "file.als",
                () -> {
                        traceln("Loaded!");
                        getExperimentHost().setPresentable(
                                getExperiment().getEngine().getRoot()
                        );
                        getExperiment().run();
                },
                e -> {
                        traceln("Error!");
                        e.printStackTrace();
                }
 );

This method is only available in the AnyLogic Professional

Specified by:: loadSnapshot in interface IExperimentHost
Parameters:: fileName - the name of snapshot file

close

public void close()

Description copied from interface: IExperimentHost

This method returns immediately and performs the following actions in a separate thread:

stops experiment if it is not stopped,
destroys the model and
closes experiment window (only if model is started in the application mode)

Specified by:: close in interface IExperimentHost

openWebSite

public void openWebSite(String url)

Description copied from interface: IExperimentHost

Opens web page with the given URL in the browser

Specified by:: openWebSite in interface IExperimentHost
Parameters:: url - the url to open

copyToClipboard

public void copyToClipboard(String text)

Description copied from interface: IExperimentHost

Copies the given text to the system clipboard
Due to the security policy of the browser, the actual copying may be preceded by a prompt.

Specified by:: copyToClipboard in interface IExperimentHost
Parameters:: text - the text to copy

executeUserAction

public void executeUserAction(long id,
 String value)

Specified by:: executeUserAction in interface IExperimentHost

executeCommand

public void executeCommand(String cmd,
 String parameters)

Specified by:: executeCommand in interface IExperimentHost

getExperimentState

public Experiment.State getExperimentState()

Specified by:: getExperimentState in interface IExperimentHost

setValue

public void setValue(String pathtofield,
 IExperimentHost.IValue value)

Specified by:: setValue in interface IExperimentHost

getValue

public Object getValue(String pathtofield)

Specified by:: getValue in interface IExperimentHost

callFunction

public Object callFunction(String pathtofunction,
 IExperimentHost.IValue... args)

Specified by:: callFunction in interface IExperimentHost

launch

public void launch(boolean startServer,
 boolean startExperiment)

Description copied from interface: IExperimentHost

Creates and optionally runs experiment, starts frame collection

Specified by:: launch in interface IExperimentHost
Parameters:: startServer - TODO

getConfiguration

public LaunchConfiguration getConfiguration()

Specified by:: getConfiguration in interface IExperimentHost

getUpdate

public AnimationPacket getUpdate(boolean fullFrame)

Specified by:: getUpdate in interface IExperimentHost

getNextFrameNumber

public long getNextFrameNumber()

Specified by:: getNextFrameNumber in interface IExperimentHost

setSendConsoleItems

public void setSendConsoleItems(boolean yes)

Specified by:: setSendConsoleItems in interface IExperimentHost

getProgress

public double getProgress()

Specified by:: getProgress in interface IExperimentHost

setSpeed

public void setSpeed(double speed)

Specified by:: setSpeed in interface IExperimentHost

setMaxFPS

public void setMaxFPS(double maxFPS)

Specified by:: setMaxFPS in interface IExperimentHost

postExperimentSettings

public void postExperimentSettings()

Specified by:: postExperimentSettings in interface IExperimentHost

onAgentDestroyed_xjal

public void onAgentDestroyed_xjal(Agent ao)

Description copied from interface: IExperimentHost

A callback called by the engine when an agent is being destroyed. If that agent is currently displayed by the presentation, display experiment.

Specified by:: onAgentDestroyed_xjal in interface IExperimentHost
Parameters:: ao - the agent being destroyed

Class AutotestExperimentHost

Nested Class Summary

Nested classes/interfaces inherited from interface com.anylogic.engine.gui.IExperimentHost

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface com.anylogic.engine.gui.IExperimentHost

Method Details

logFrame

getExperiment

getFrameProducer

setPresentable

getPresentable

navigateHome

setZoomAndPanningEnabled

isZoomAndPanningEnabled

setDeveloperPanelEnabled

setDeveloperPanelVisibleOnStart

setRunControlEnabled

isRunControlEnabled

setSpeedControlEnabled

isSpeedControlEnabled

setCenter

zoomIn

zoomOut

navigateTo

addInspect

removeInspect

showMessageDialog

showErrorDialog

showErrorInModelDialog

saveSnapshot

loadSnapshot

close

openWebSite

copyToClipboard

executeUserAction

executeCommand

getExperimentState

setValue

getValue

callFunction

launch

getConfiguration

getUpdate

getNextFrameNumber

setSendConsoleItems

getProgress

setSpeed

setMaxFPS

postExperimentSettings

onAgentDestroyed_xjal