Chapter 3. ptcl: The Ptolemy Interpreter

• 3.1 Introduction

• 3.2 Getting started

• 3.3 Global information

• 3.4 Commands for defining the simulation
  • 3.4.1 Creating and deleting universes
  • 3.4.2 Setting the domain
  • 3.4.3 Creating instances of stars and galaxies
  • 3.4.4 Connecting stars and galaxies
  • 3.4.5 Netlist-style connections
  • 3.4.6 Bus connections between MultiPortHoles
  • 3.4.7 Connecting internal galaxy stars and galaxies to the outside
  • 3.4.8 Defining parameters and states for a galaxy
  • 3.4.9 Setting the value of states
  • 3.4.10 Setting the number of ports to a star
  • 3.4.11 Defining new galaxies

• 3.5 Showing the current status
  • 3.5.1 Displaying the known classes
  • 3.5.2 Displaying information on a the current galaxy or other class

• 3.6 Running the simulation
  • 3.6.1 Creating a schedule
  • 3.6.2 Running the simulation
  • 3.6.3 Continuing a simulation
  • 3.6.4 Wrapping up a simulation
  • 3.6.5 Interrupting a simulation
  • 3.6.6 Obtaining the stop time of the current run
  • 3.6.7 Obtaining time information from the scheduler
  • 3.6.8 Animating a simulation

• 3.7 Undoing what you have done
  • 3.7.1 Resetting the interpreter
  • 3.7.2 Removing a star
  • 3.7.3 Removing a connection
  • 3.7.4 Removing a node

• 3.8 Targets
  • 3.8.1 What targets are available?
  • 3.8.2 Changing the target
  • 3.8.3 Changing target parameters
  • 3.8.4 Pragmas

• 3.9 Miscellaneous commands
  • 3.9.1 Loading commands from a file
  • 3.9.2 Changing the seed of random number generation
  • 3.9.3 Changing the current directory
  • 3.9.4 Dynamically linking new stars
  • 3.9.5 Top-level blocks
  • 3.9.6 Examining states
  • 3.9.7 Giving up
  • 3.9.8 Getting help
  • 3.9.9 Registering actions
  • 3.9.10 The Interface to Matlab and Mathematica

• 3.10 Limitations of the interpreter

• 3.11 A wormhole example

• 3.12 Some hints on advanced uses of ptcl with pigi
  • 3.12.1 Ptcl as a simulation control language for pigi
  • 3.12.2 The pigi log file pigiLog.pt
  • 3.12.3 Using pigiLog.pt to build scripts
  • 3.12.4 oct2ptcl

Authors: Joseph T. Buck
Wan-Teh Chang
Edward A. Lee

Other Contributors: Brian L. Evans
Christopher Hylands