org.nlogo.api
Class Context

java.lang.Object
  org.nlogo.api.Context

public class Context

extends Object

Provides access to the current execution environment

Constructor Summary

Context(org.nlogo.workspace.Workspace workspace, org.nlogo.nvm.Context context)

Method Summary

String	attachCurrentDirectory(String path) Transforms a relative path to an absolute path by prepending the current working directory.
String	attachModelDir(String filePath) Transforms a relative path to a model into an absolute path by prepending the current model directory.
void	pauseProgram()
void	resumeProgram()
void	runCommand(String source, boolean waitForFinish) Runs a command as if it were written in the Command Center
Object	runReporter(String source) Runs a reporter as if it were written in the Command Center.
void	setVariable(Argument arg, Object netLogoValue)

Methods inherited from class java.lang.Object

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

Constructor Detail

Context

public Context(org.nlogo.workspace.Workspace workspace,
               org.nlogo.nvm.Context context)

Method Detail

runCommand

public void runCommand(String source,
                       boolean waitForFinish)
                throws ExtensionException

Runs a command as if it were written in the Command Center

Parameters:

source - the source code to run

waitForFinish - determines whether the method returns immediately, or waits until the Logo code is done executing

Throws:

ExtensionException

runReporter

public Object runReporter(String source)
                   throws ExtensionException

Runs a reporter as if it were written in the Command Center.

Parameters:

source - the source code to run

Returns:

the object returned by the reporter

Throws:

ExtensionException

attachModelDir

public String attachModelDir(String filePath)

Transforms a relative path to a model into an absolute path by prepending the current model directory. If this is a new model, and therefore doesn't have a model directory yet, the user's platform-dependent home directory is prepended instead. If filePath is an absolute path, it is returned unchanged.

Parameters:

filePath - the path to be processed

Returns:

an absolute path

attachCurrentDirectory

public String attachCurrentDirectory(String path)

Transforms a relative path to an absolute path by prepending the current working directory. If filePath is an absolute path, it is returned unchanged.

The "current working directory" is the current directory used by NetLogo's file I/O primitives, and can be changed by the user at run-time using the file-set-current-directory primitive. Its initial value is the directory from which the current model was loaded, or the user's home directory if this is a new model.

setVariable

public void setVariable(Argument arg,
                        Object netLogoValue)
                 throws ExtensionException

Throws:

ExtensionException

pauseProgram

public void pauseProgram()

resumeProgram

public void resumeProgram()