The command-line arguments can also set parameter values for any parameter in the models, with the name given relative to the top-level entity. For example, to specify the iteration count in an SDF model, you can invoke this on the command line as follows:
java -classpath $PTII ptolemy.actor.gui.CompositeActorApplication \ -director.iterations 1000 \ -class ptolemy.domains.sdf.demo.Butterfly.ButterflyThis assumes that the model given by the specified class name has a director named "director" with a parameter named "iterations". If more than one model is given on the command line, then the parameter values will be set for all models that have such a parameter.
This class keeps count the number of open windows. The waitForFinish method can then be used to determine when all of the windows opened by this class have been closed. The main() method exits the application when all windows have been closed. @see ModelFrame @author Edward A. Lee, Brian K. Vogel, and Steve Neuendorffer @version $Id: CompositeActorApplication.java 70398 2014-10-22 23:44:32Z cxh $ @since Ptolemy II 0.4 @Pt.ProposedRating Yellow (cxh) @Pt.AcceptedRating Red (vogel) */ public class CompositeActorApplication extends CompositeActorSimpleApplication { /////////////////////////////////////////////////////////////////// //// public methods //// /** Close any ModeFrames opened in processArgs(). */ public void close() { // Mainly used for testing. for (ModelFrame frame : _frames) { if (frame != null) { frame.close(); } } } /** Create a new application with the specified command-line arguments. * @param args The command-line arguments. */ public static void main(String[] args) { CompositeActorApplication application = new CompositeActorApplication(); _run(application, args); } /** Parse the command-line arguments, creating models as specified. * @param args The command-line arguments. * @exception Exception If something goes wrong. */ @Override public void processArgs(String[] args) throws Exception { if (args != null) { _parseArgs(args); // start the models. Iterator models = _models.iterator(); while (models.hasNext()) { _frames.add((ModelFrame) startRun((CompositeActor) models .next())); } } } /** If the specified model has a manager and is not already running, * then execute the model in a new thread. Otherwise, do nothing. * If the model contains an atomic entity that implements Placeable, * we create create an instance of ModelFrame, if nothing implements * Placeable, then we do not create an instance of ModelFrame. This * allows us to run non-graphical models on systems that do not have * a display. *
* We then start the model running.
*
* @param model The model to execute.
* @return The ModelFrame that for the model.
* @see ptolemy.actor.Manager#startRun()
*/
@Override
public synchronized Object startRun(CompositeActor model) {
// This method is synchronized so that it can atomically modify
// the count of executing processes.
// NOTE: If you modify this method, please be sure that it
// will work for non-graphical models in the nightly test suite.
// Iterate through the model, looking for something that is Placeable.
boolean hasPlaceable = false;
Iterator atomicEntities = model.allAtomicEntityList().iterator();
while (atomicEntities.hasNext()) {
Object object = atomicEntities.next();
if (object instanceof Placeable
|| object instanceof PortablePlaceable) {
hasPlaceable = true;
break;
}
}
ModelFrame frame = null;
if (hasPlaceable) {
// The model has an entity that is Placeable, so create a frame.
try {
frame = new ModelFrame(model);
_openCount++;
frame.addWindowListener(new WindowAdapter() {
@Override
public void windowClosed(WindowEvent event) {
synchronized (CompositeActorApplication.this) {
_openCount--;
CompositeActorApplication.this.notifyAll();
// FIXME: is this right? We need
// to exit if all the windows are closed?
if (_openCount == 0) {
StringUtilities.exit(0);
}
}
}
});
frame.setBackground(new Color(0xe5e5e5));
frame.pack();
frame.centerOnScreen();
frame.setVisible(true);
// FIXME: Use a JFrame listener to determine when all windows
// are closed.
} catch (Exception ex) {
System.out.println("startRun: " + ex);
}
}
Manager manager = model.getManager();
if (manager != null) {
try {
manager.startRun();
} catch (IllegalActionException ex) {
// Model is already running. Ignore.
}
} else {
report("Model " + model.getFullName() + " cannot be executed "
+ "because it does not have a manager.");
}
return frame;
}
///////////////////////////////////////////////////////////////////
//// private variables ////
// List of ModelFrames created processArgs();
private List