Summary: an interface to the Push programming language.The PushInterpreter object is used to setup and run programs in the Push programming language, a language developed specifically for evolutionary computation.
Push is useful in breve for evolving evolved agent behaviors. The steve language, in which users write simulations, is a high level language which is not well suited for evolutionary computation. The Push language, on the other hand, is designed from the ground up for evolutionary computation.
More information about Push is available on the Push project page.
Configuring and setting up a Push interpreter
- add-instruction
- add-macro
- get-evaluation-limit
- get-list-limit
- read-config
- set-evaluation-limit
- set-list-limit
Running a Push program
Getting Push interpreter configuration and state information
Pushing Values onto Push Stacks
Getting the Sizes of Push Stacks
- get-boolean-stack-size
- get-code-stack-size
- get-exec-stack-size
- get-float-stack-size
- get-integer-stack-size
- get-vector-stack-size
Getting Values From the Top of Push Stacks
- copy-code-stack-top
- copy-exec-stack-top
- get-boolean-stack-top
- get-float-stack-top
- get-integer-stack-top
- get-vector-stack-top
Popping the Push Stacks
Adds a custom callback instruction named instructionName to the push interpreter. When instructionName is called, it will trigger the method methodName in targetInstance. If the instruction name is not specified, methodName will be used.
Adds a new instruction named instructionName. When the instructionName instruction is executed, it has the effect of executing the code contained in macroCode.
Clears the stacks of the Push interpreter.
Copies the top of the code stack to an existing program. Use get-code-stack-size to determine whether the code stack is empty or not.
Copies the top of the code stack to an existing program. Use get-exec-stack-size to determine whether the code stack is empty or not.
Returns the size of the boolean stack.
Returns the top of the boolean stack. If the boolean stack is empty, the method returns 0 (false). Use get-boolean-stack-size to determine whether the boolean stack is empty or not.
Returns the size of the code stack.
Returns the "effort" of the Push interpreter--the running tally of instructions the interpreter has executed. for associating energy costs with computation in evolving populations.
Returns the current push evaluation limit. See set-evaluation-limit for more information on the evaluation limit.
Returns the size of the code stack.
Returns the size of the float stack.
Returns the top of the float stack. If the float stack is empty, the method returns 0.0. Use get-float-stack-size to determine whether the boolean stack is empty or not.
Returns the size of the integer stack.
Returns the top of the interger stack. If the integer stack is empty, the method returns 0. Use get-integer-stack-size to determine whether the integer stack is empty or not.
Returns the size limit of lists constructed in push. See set-list-limit for more information.
Returns the size of the vector stack.
Returns the top of the vector stack. If the vector stack is empty, the method returns (0, 0, 0). Use get-vector-stack-size to determine whether the vector stack is empty or not.
Pops the boolean stack. If the boolean stack is empty, this method has no effect.
Pops the code stack. If the code stack is empty, this method has no effect.
Pops the exec stack. If the code stack is empty, this method has no effect.
Pops the float stack. If the float stack is empty, this method has no effect.
Pops the integer stack. If the integer stack is empty, this method has no effect.
Pops the vector stack. If the vector stack is empty, this method has no effect.
Prints out the current push configuration, including a list of the active instructions. Useful for debugging.
Prints out the current contents of the exec stack. Useful for debugging.
Prints out the current contents of the stacks. Useful for debugging.
Pushes the boolean booleanValue (an integer in breve, where 0 is false and all other values are true) onto the boolean stack.
Pushes the code codeObject onto the code stack.
Pushes the code codeObject onto the exec stack.
Pushes the float floatValue onto the float stack.
Pushes the integer integerValue onto the integer stack.
Pushes the vector vectorValue onto the vector stack.
Reads the push configuration file configFile.
Clears the effort counter to 0.
Runs the specified push code from the beginning of the program. If the steps variable is provided, evaluation will only run for the specified number of instructions. Otherwise, evaluation will run for the evaluation limit, which is set with set-evaluation-limit.
The method returns 0 if the interpreter completely executes the program, or 1 if execution stopped due to the evaluation limit.
If the program is not executed completely, execution may be stepped forward using the method step. In some cases, it may be desirable to step push programs forward in small increments by calling this method with steps = 0 in order to load the program, then using step to step the simulatation forward.
Dumps out the exec stack at every instruction step. Extremely verbose. For debugging only.
Sets the evaluation limit to newLimit. This specifies the number of instructions to run when the run is called. The default value for a new interpreter is 200.
Sets the size limit of lists constructed in push. This limit also applies to programs created using genetic operators. The default limit is 200.
Steps the interpreter forward by the specified number of instructions.