User's Guide‎ > ‎Advanced Users‎ > ‎

Command line arguments

A list of command line arguments to control SimStudent

You can fully control the behavior of SimStudent with the following command line arguments.

Note that some of them are Java VM arguments whereas the others are the arguments for CTAT (SimStudent). For the VM arguments, use "-D" -- e.g., place "-DnoCtatWindow" to hide CTAT windows. For the CTAT option, use "-" -- e.g., "-traceLevel 5" to indicate the trace level of 5.

Some arguments take value (e.g., traceLevel) whereas some arguments are switches -- namely, their mere presence affects the system's performance (e.g., ssBatchMode)

VM arguments
 noCtatWindow  Run SimStudent without showing CTAT windows but only the Student Interface (hence speeds up the whole session). 

CTAT arguments
 traceLevel <n>  Zero or a positive integer.  The greater the traceLevel, the more verbose the trace output
 debugCodes <name>

 sets a list of codes attached to debug messages for which the debug messages should be displayed

 reduced  sets CTAT to run in reduced mode
 Interactive Learning                                                                                                              
 ssInteractiveLearning  turns interactive learning on
 ssIlSignalNegative <boolean>

 set whether or not to signal a negative example when SimSt makes a wrong step during Interactive Learning

 ssIlSignalPositive <boolean>  set whether or not to signal a positive example when SimSt makes a correct step during Interactive Learning
 ssForceToUpdateModel  sets SimSt to relearn production rules even if they may be correct, instead of only when they are incorrect
 ssSwitchLearningStrategyAfter <n>  sets the number of training problems that are learned with traditional learning, after these problems, SimSt switches to Interactive Learning
 Batch Mode                                                                                                                             
 ssProblemSet <name>  A list of training problems, or a name of a directory containing training problems
 ssTestSet <name>  A list of test problems, or a name of a directory containing test problems
 ssSearchTimeOutDuration <n> Time in milliseconds to let SimStudent give up a search in RHS operator sequence. 
 ssBatchMode  Indicates to run SimStudent in a batch-mode
 ssCheckWilkinsburgBadBrd  When specified, the BRD files listed in Problems\DataShopExport-NG-files will be automatically excluded from the training problems.
 ssTestOnLastTrainingOnly  When specified, the test takes place on when training is done for all training problems given.
 ssSetMaxNumTest <n>  The maximum number of problems used for test
 ssSetMaxNumTraining <n>  The maximum number of problems used for training
 ssLearnBuggyActions <boolean>  When true, SimStudent learns from incorrect steps in training problems
 ssLearnCorrectActions <boolean>  When true, SimStudent learns from correct steps in training problems - defaults to true
 ssLearnCltErrorActions <boolean>  When true, SimStudentlearns from error steps in training problems - defaults to false
 ssTestProductionModelNoTest  turns off testing of the production model
 ssAnalysisOfFitnessWilkinsburg  turns on analysis of fitness
 ssRunValidation  Run SimStudent only to test existing production rules in the ./ file.  No learning involved at all.
 ssPreservePrFile  Indicates not to delete an existing ./ file, which otherwise will be deleted when SimStudent is launched in bach-mode
 ssDeletePrFile  sets the production rule file to be deleted without prompting
 ssConidition <name>  sets the name of the condition for a validation test
 ssNumIteration <n>  sets the validation iteration number
 Inquiry Oracle                                                                                                                        
 ssCacheOracleInquiry <boolean>  Turn on/off the cache for inquiry on the correctness of the rule activations suggested by SimStudent
 ssRuleActivationTestMethod <name>

 Specify the oracle for inquiry on the correctness of the rule activations

ClTutorSolver: CL Algebra I Tutor

 ssHintMethod <name>

 Specify an oracle to ask for a hint on what to do next

ClTutorSolver: CL Algebra I Tutor

 ssClSolverTutorHost <name>  Specify a machine name on which the clSolverTutor is running
 ssTutorServerTimeOutDuration <n>  sets the duration in milliseconds at which a request to the ClTutorServer will timeout
 Learning By Teaching                                                                                                            
 ssRunInPLE  Running the Tutor Interface and SimStudent in the Peer Learning Environment
 ssNumBadInputRetries <n>  sets the number of times on a single step which the user can enter input for which SimSt fails to learn before SimSt prompts to go on to another problem - if set to 0 (default value) SimSt will move on to next step and never prompt for retry
 ssLogging  sets SimSt to log PLE activities to disk and DataShop
 ssUserID <name>1  sets the ID of the student user of SimSt for logging purposes - pop-up window prompts for user ID if ssLogging is on and ID is not provided
 ssLogURL <name>1  sets the name of the server to log to - defaults to (DataShop Production)
 ssCLQuizReqMode1  sets SimSt to display a success message and exit with code 104 if SimSt passes the quiz with 100%
 File/Class Selection                                                                                                                
 ssConstraintFile <name>  sets the file SimSt reads its topological constraints from
 ssDecomposerFile <name>  sets the file SimSt reads its decomposers from
 ssFeaturePredicateFile <name>  set the file for which feature predicates are taken for background knowledge
 ssFoaGetterClass <name>  sets the class SimSt uses to determine focus of attention - determined by double clicking cells if not provided
 ssInputCheckerClass <name>  sets the class SimSt uses to verify that input is valid - input is not checked for validity if not provided
 ssSkillNameGetterClass <name>  sets the class SimSt uses to determine the name of skills - otherwise uses an unlabelled skillname if ssLearnNoLabel is set or must be defined through interface
 ssPathOrderingClass <name>  sets the class SimSt uses to order the path - does not reorder if not defined
 ssInputMatcher <name>  sets the class SimSt uses to test if "input" is semantically correct
 ssTypeChecker <name>  sets the class SimSt uses to match input and output arguments for operators
 ssUserDefSymbols <name>  a package name for "load-package" command appearing in the production rule file
 ssOperatorFile <name>  Specify an alternative file name for operator.txt
 ssProjectDir <name> sets the project directory 
 File Output                                                                                                                              
 ssFoilLogDir <name>  Specify a directory where the log-files from FOIL will be stored
 ssTestOutput <name>  Specify a name of the file for logging the result of the test
 ssLogPriorRuleActivationsOnTraining  Rule activations (conflict set) will be logged during training
 ssTestOutput <name>  the file to log output to
 ssLearningRuleFiringLogged  sets activation rule firing to be logged
 ssLogAgendaRuleFiring  sets SimSt to log agenda rule firing
 ssLogStudentsLearning  sets SimSt to only output real students' learning log
 ssLearningLogFile <name>  sets a file to record results of model tracing during learning
 ssPrAgeDir <name>  sets the directory where aged production rule files are to be archived by # rules and # steps performed
 Other Options                                                                                                                         
 ssValidateStepsInBRD  Open give BRD file(s) and invoke inquiry oracle (CL Solver Tutor) to test if the steps in the BRD codes as "correct" are indeed correct steps or not.  This is useful when you want to know which BRD files are broken, because ssValidateStepsInBRD throws an Exception on a broken step. Use ssTestSet and ssTestOutput to specify BRD files and a logging file.
 useOldExampleTracer  turns off using the new example tracer
 ssDecomposeInput  sets SimSt to decompose input
 ssDoNotSaveRules  disables SimSt from generating production rule files
 ssFoaClickDisabled  disables double clicking cells to provide focus of attention as long as a FoaGetter is defined
 ssMemoryWindowOverRules  sets the memory window to be defined for each individual rule instead of overall
 ssSetFpCacheCapacity <n>  sets the capacity of the cache - default 50
 ssMaxSearchDepth <n>  sets the maximum search depth for an instruction - default 6
 ssVerifyNumFoA  sets SimSt to attempt to verify the consistency of the number of FoA
ssSetMemoryWindowSize <n>  sets the number of past instructions demonstrated to consider - by default all instructions are considered
 ssShuffleValidation  sets SimSt to run in shuffle mode
 ssPredictObservableActionName <name>  sets the name used with predictions of an observable action - default to "predict-algebra-input"
 ssNoAutoOrderFOA  turns off SimSt's auto ordering of focus of attention based on value
 ssLearnNoLabel  sets SimSt to learn skills without labels
 ssDontShowAllRaWhenTutored  sets SimSt to not show all RA

 sets SimSt to not learn any specific WME paths.

1. Not yet available in most recent CTAT release.
Updated 04/15/2010