ACT-R 7.13+ Reference Manual Dan Bothell Includes material adapted from the ACT-R 4.0 manual by Christian Lebiere, documentation on the perceptual motor components by Mike Byrne and the Introduction is a shortened version of the ACT- R description written by Raluca Budiu for the ACT-R web site. 2 Notice ACT-R 7.6 represents a significant rewrite of the core software, but does not include any changes to the underlying cognitive architecture. As noted by the version number, it is not guaranteed to be backwards compatible with prior versions of the ACT-R 7 architecture software. The purpose of this document is to describe the current software. It does not generally describe the differences from prior versions, but in places where such changes are significant some additional information will be provided. 3 Table of Contents Notice......................................................................................................................................................3 Table of Contents....................................................................................................................................4 Preface...................................................................................................................................................18 Introduction...........................................................................................................................................19 Document Overview.............................................................................................................................21 General Software Description ..............................................................................................................22 Licensing ..........................................................................................................................................23 Case sensitivity.................................................................................................................................23 Functions vs. Macros........................................................................................................................23 Compatibility issues..........................................................................................................................24 Notations in the Documentation...........................................................................................................25 Command Syntax..............................................................................................................................25 Examples...........................................................................................................................................26 Remote commands............................................................................................................................26 Embedded Strings ........................................................................................................................26 Transmission Protocol..................................................................................................................27 ACT-R Software Distribution...............................................................................................................28 Distribution Contents............................................................................................................................29 Subdirectories....................................................................................................................................29 commands.....................................................................................................................................29 core-modules.................................................................................................................................29 dev-tools........................................................................................................................................29 devices...........................................................................................................................................29 docs...............................................................................................................................................30 environment..................................................................................................................................31 examples.......................................................................................................................................31 extras.............................................................................................................................................31 framework.....................................................................................................................................31 modules.........................................................................................................................................31 other-files......................................................................................................................................32 support...........................................................................................................................................32 test-models....................................................................................................................................32 tools...............................................................................................................................................32 tutorial...........................................................................................................................................32 user-loads......................................................................................................................................32 Loading and Running the ACT-R System............................................................................................33 Single-threaded mode.......................................................................................................................33 ACT-R version details......................................................................................................................33 Component and Module versions.....................................................................................................34 User Load files..................................................................................................................................35 Compiler Optimizations....................................................................................................................35 Logical Host......................................................................................................................................36 actr-load .......................................................................................................................................36 load-act-r-model/load-act-r-code..................................................................................................37 Load order.........................................................................................................................................38 Recompiling......................................................................................................................................39 4 Packaging..........................................................................................................................................39 Clean.............................................................................................................................................40 Packaged.......................................................................................................................................40 Requiring files...................................................................................................................................40 require-compiled ..........................................................................................................................40 Overall Software Design...................................................................................................................42 Model files............................................................................................................................................44 Commands & Signals............................................................................................................................46 ACT-R Output.......................................................................................................................................47 Commands & Signals........................................................................................................................47 general-trace..................................................................................................................................47 model-trace...................................................................................................................................47 command-trace..............................................................................................................................47 warning-trace................................................................................................................................48 echo-act-r-output...........................................................................................................................48