NAME

Soar::WM - Traverse Soar working memory dumps

VERSION

version 0.01

SYNOPSIS

use Soar::WM qw(wm_root_from_file);
my $root = wm_root_from_file('/path/to/wme/dump');
print $root->id;

DESCRIPTION

This module represents Soar's working memory. It can be used for traversing and manipulating WME dumps generated by Soar.

NAME

Soar::WM - Perl extension for representing Soar working memory given a WME dump file

METHODS

wm\_root\_from\_file

This is a shortcut for: wm_root(file=>$arg) It's single argument is the path to a WME dump file, or an opened file handle for one. It returns a Soar::WM::Element object representing the root of the given WME dump.

wm\_root

This function reads in a Soar WME dump and returnes a Soar::WM::Element representing its root. It takes a named argument, file or text. Using wm\_root(file=path)> or wm\_root(file=$fileGlob)>, you can create an object given the path to a WME dump file. Using wm\_root(text='(S1 ^foo bar)')>, you can create an object using a given WME dump text. If neither argument is specified, this function will wait for input from standard in.

TO DO

Currently there is no separate constructor for a Soar::WM object; instead, the only existing functions return the root of a Soar::WM object, which is an instance of Soar::WM::Element. Besides a separate constructor, one might find it useful to be able to grab any element of a Soar::WM object given its ID. I have not found this expedient, and so have not coded. If you really want it, just shoot me an email.

SEE ALSO

The homepage for the Soar cognitive architecture is here: http://sitemaker.umich.edu/soar/home.

AUTHOR

Nathan Glenn garfieldnate@gmail.com

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Nathan Glenn.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.