From bcfe861944695bd76630f4ef1744836aabf3e144 Mon Sep 17 00:00:00 2001 From: Nathan Glenn Date: Fri, 22 Sep 2023 01:52:03 -0500 Subject: [PATCH] doc updates * List agents in markdown * Add another 9.6.2 change to release notes * Fix date in user readme --- SoarShuffler/Soar_Projects_Filelist.txt | 2 +- txt/Agents_readme.md | 63 +++++++++++++++++++++++++ txt/Agents_readme.txt | 43 ----------------- txt/README | 8 ++-- txt/Release_Notes_9.6.2.txt | 6 +++ 5 files changed, 74 insertions(+), 48 deletions(-) create mode 100644 txt/Agents_readme.md delete mode 100644 txt/Agents_readme.txt diff --git a/SoarShuffler/Soar_Projects_Filelist.txt b/SoarShuffler/Soar_Projects_Filelist.txt index 30ece4b..032777a 100755 --- a/SoarShuffler/Soar_Projects_Filelist.txt +++ b/SoarShuffler/Soar_Projects_Filelist.txt @@ -339,7 +339,7 @@ SoarTutorial_$VERSION $COMPILE_DIR/tcl=bin/tcl $SOAR_GROUP_REPOS_HOME/Release-Support/txt/README=$ROOT $SOAR_GROUP_REPOS_HOME/Release-Support/txt/license.txt=$ROOT - $SOAR_GROUP_REPOS_HOME/Release-Support/txt/Agents_readme.txt=Agents/ + $SOAR_GROUP_REPOS_HOME/Release-Support/txt/Agents_readme.md=Agents/ $SOAR_GROUP_REPOS_HOME/Release-Support/pdf/Soar Tutorial Part 1 - Simple Agents.pdf=Tutorial $SOAR_GROUP_REPOS_HOME/Release-Support/pdf/Soar Tutorial Part 2 - Interacting with an Environment.pdf=Tutorial $SOAR_GROUP_REPOS_HOME/Release-Support/pdf/Soar Tutorial Part 3 - Subgoals.pdf=Tutorial diff --git a/txt/Agents_readme.md b/txt/Agents_readme.md new file mode 100644 index 0000000..2525546 --- /dev/null +++ b/txt/Agents_readme.md @@ -0,0 +1,63 @@ +# Soar 9.6 Demo Agents, April 2017 + +Classic AI problems implemented for Soar 9 + +## Arithmetic + +* Does multicolumn addition and subtraction using simple +* addition facts. Automatically generates, solves, and verifies +* 1000 problems. Demonstrates hierarchical task decomposition +* and chunking over the decomposition. + +## Blocks-World: Stack blocks + +* Demonstrates means-ends analysis, operator-subgoaling, and look-ahead + +## Eight-Puzzle: Sliding tile puzzle + +* Demonstrates look-ahead search and chunking. +* Has graphical interface + +## EpMem-Tutorial + +* A simple agent that shows how structures are stored in episodic +* memory and then retrieved. + +## Hello-world + +* The simplest example of Soar rules and operators + +## Left-right + +* Trivial example for RL. + +## MAC: Missionaries and Cannibals + +* Has multiple version using look-ahead search +* and chunking showing tradeoffs in state representations for +* operator application vs. state copying. + +## Towers-of-hanoi: Classic disk and peg problem + +* Two strategies implemented - no search or learning. +* Multiple implementations of one of the strategies using +* different representations with different generality and different +* execution costs + +## SMem-Tutorial + +* A simple agent that shows how structures are stored in semantic +* memory and then retrieved. + +## Water-jug + +* Has two versions which use look-ahead search +* and chunking showing tradeoffs in state representations for +* operator application vs. state copying. +* Another version with simple evaluation in tie subgoal (water-jug-tie) +* water-jug-rl works with RL. + +## Default + +* Holds rules used for implementing common problem solving +* strategies including look-ahead search and operator subgoaling. diff --git a/txt/Agents_readme.txt b/txt/Agents_readme.txt deleted file mode 100644 index 6f24795..0000000 --- a/txt/Agents_readme.txt +++ /dev/null @@ -1,43 +0,0 @@ -# Soar 9.6.1 Demo Agents -# April 2017 -# -# Classic AI problems implemented for Soar 9 -# -# Arithmetic: -# Does multicolumn addition and subtraction using simple -# addition facts. Automatically generates, solves, and verifies -# 1000 problems. Demonstrates hierarchical task decomposition -# and chunking over the decomposition. -# Blocks-World: Stack blocks -# Demonstrates means-ends analysis, operator-subgoaling, and look-ahead -# Eight-Puzzle: Sliding tile puzzle. -# Demonstrates look-ahead search and chunking. -# Has graphical interface -# EpMem-Tutorial -# A simple agent that shows how structures are stored in episodic -# memory and then retrieved. -# Hello-world: simplest example of Soar rules and operators -# Left-right: -# Trivial example for RL. -# MAC: Missionaries and Cannibals -# Has multiple version using look-ahead search -# and chunking showing tradeoffs in state representations for -# operator application vs. state copying. -# Towers-of-hanoi: Classic disk and peg problem -# Two strategies implemented - no search or learning. -# Multiple implementations of one of the strategies using -# different representations with different generality and different -# execution costs -# SMem-Tutorial -# A simple agent that shows how structures are stored in semantic -# memory and then retrieved. -# Water-jug: -# Has two versions which use look-ahead search -# and chunking showing tradeoffs in state representations for -# operator application vs. state copying. -# Another version with simple evaluation in tie subgoal (water-jug-tie) -# water-jug-rl works with RL. -# -# Default: -# Holds rules used for implementing common problem solving -# strategies including look-ahead search and operator subgoaling. diff --git a/txt/README b/txt/README index 70aca5a..8218bf4 100644 --- a/txt/README +++ b/txt/README @@ -1,9 +1,9 @@ ========================= -= Soar 9.6.1 README = -= January 2023 = += Soar 9.6.2 README = += September 2023 = ========================= -Welcome to Soar! Soar 9.6.1 is the current, stable version of Soar. It is a maintenance release, meaning no major features were added, but it does still represent a lot of work in the form of bug fixes, code modernization, and usability improvements. Note that the included Java tools, such as the Soar Java Debugger, now require at least Java 11 to run. +Welcome to Soar! Soar 9.6.2 is the current, stable version of Soar. It is a maintenance release, meaning no major features were added, but it does still represent a lot of work in the form of bug fixes, code modernization, and usability improvements. Note that the included Java tools, such as the Soar Java Debugger, now require at least Java 11 to run. * VisualSoar has been updated with support for all Soar commands and subsytems, improved reliability and usability, and lots of bug fixes. @@ -23,7 +23,7 @@ The full release notes can be found in its own file. Official Soar Manual ==================== -The 9.6.1 edition of the Soar Manual is included here for your reference. However, the manual is continually updated, and the latest version can be +The 9.6.2 edition of the Soar Manual is included here for your reference. However, the manual is continually updated, and the latest version can be found at: https://soar.eecs.umich.edu/downloads/SoarManual.pdf diff --git a/txt/Release_Notes_9.6.2.txt b/txt/Release_Notes_9.6.2.txt index 51d3e1e..b78807a 100644 --- a/txt/Release_Notes_9.6.2.txt +++ b/txt/Release_Notes_9.6.2.txt @@ -32,6 +32,12 @@ New Features will no longer need to pass the class instance separately as (void*)userData, and can instead simply pass in the result of std::bind. +() More output filtering options in the debugger + We rename "hide all" to "show only errors and top-level", then add a true "hide + all" filter to complement that. We also separate messages from RHS writes, and add + additional filter options for error and top-level. This covers all 14 output + types, while still providing convenient checkboxes for common settings. + () Better dark mode styling for the debugger Previous versions of the debugger were very difficult to read on Mac in dark mode due to displaying black text on a dark background. The text now correctly shows as white.