Improve SVS documentation

[garfieldnate]

Thought I had written this up already but I can't find it now, so this might be a duplicate 🤷

• Is there any wildcard syntax? SVS communicates with the SVS viewer using wildcards, so I thought they might be usable in commands. svs S1.scene.clear clears S1; how do I run the command for all scenes? Or a command on all objects?
• Manual chapter needs some examples of using the CLI.

See also #490, #488.

[garfieldnate]

Just for later documentation: here's an example script showing loading an agent and some basic SVS commands. You always have to step 1 before you can see any of the updates in SVS!

import Python_sml_ClientInterface as sml

kernel = sml.Kernel.CreateKernelInNewThread()
agent = kernel.CreateAgent("soar")
print(agent.ExecuteCommandLine("svs --on"))
svs_commands = """
add Apple1 world v 0.5 0.5 0.5 0.5 0.5 -0.5 0.5 -0.5 0.5 0.5 -0.5 -0.5 -0.5 0.5 0.5 -0.5 0.5 -0.5 -0.5 -0.5 0.5 -0.5 -0.5 -0.5 p -0.465155 0.475745 1.156725 r 0.000000 0.000000 0.000000 s 0.106014 0.106025 0.113450
tag add Apple1 object-source perception
add Book2 world v 0.5 0.5 0.5 0.5 0.5 -0.5 0.5 -0.5 0.5 0.5 -0.5 -0.5 -0.5 0.5 0.5 -0.5 0.5 -0.5 -0.5 -0.5 0.5 -0.5 -0.5 -0.5 p 0.153736 0.615839 1.130338 r 0.000000 0.000000 0.000000 s 0.534262 0.532402 0.061983
tag add Book2 object-source perception
"""
print(agent.SendSVSInput(svs_commands))
print(agent.RunSelf(1))

print("\n---------------------\nSVS Contents\n---------------------")
print(agent.ExecuteCommandLine("svs S1.scene.world dir"))