Skip to content

SoarGroup/Engineers-Guide-to-Soar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 

Repository files navigation

The Engineer’s Guide to Soar

A 14-part course in programming the open-source software Soar, written by and for engineers.

This training material is itself an open-source project under the SoarGroup, functionally serving as an extension of the Soar project.

Click here to get started!

Course 01 - Soar Esentials Outline

  1. Starting Soar
  2. Hello World
  3. Input Link
  4. Operator Basics
  5. Output
  6. Multi-Apply Logic
  7. Substates
  8. Practice Debugging
  9. Code Organization
  10. Combining Preferences
  11. SML Part 1: SML Basics
  12. SML Part 2: Managing WMEs
  13. SML Part 3: Custom Input Classes
  14. SML Part 4: Event Handlers

Open-Source Developer Notes

If updating the version of Soar included in this repo, be sure to test the Python run scripts on both Mac and Windows platforms. In particular, ensure that read and execute permissions are active for the Soar folder in the Mac platform.

Also note that the .bat/.sh scripts in the Soar distro folder are slightly modified (improved) from the form found in the official Soar release so that they can be run from Python code and also so that they do not remove files built for different platforms. The Soar Cheat Sheet is also added to the Soar distro folder.

If you want to add additional lessons to teach more Soar topics, such as chunking, it is recommended to create a separate Course folder that is appropriate for the theme of that topic, if one doesn't already exist. (e.g., a lesson on SMEM should be under a course like Course02_SoarModules; a lesson on chunking or RL under Course03_SoarLearning, etc.)

License

This project is released under the BSD 2-Clause License.