ai.susi.mind

Class SusiThought

java.lang.Object

org.json.JSONObject

ai.susi.mind.SusiThought

public class SusiThought
extends JSONObject

A thought is a piece of data that can be remembered. The structure or the thought can be modeled as a table which may be created using the retrieval of information from elsewhere of the current argument.

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.regex.Pattern	variable_pattern

Fields inherited from class org.json.JSONObject

NULL

Constructor Summary

Constructors

Constructor and Description
SusiThought() create an empty thought, to be filled with single data entities.
SusiThought(JSONObject json) create a clone of a json object as a SusiThought object
SusiThought(java.util.regex.Matcher matcher) Create an initial thought using the matcher on an expression.
SusiThought(java.lang.String metadata_name, java.lang.String data_name) Deprecated.

Method Summary

Modifier and Type	Method and Description
SusiThought	addAction(SusiAction action)
SusiThought	addActions(java.util.List<SusiAction> actions) Every information may have a set of (re-)actions assigned.
SusiThought	addObservation(java.lang.String featureName, java.lang.String observation) If during thinking we observe something that we want to memorize, we can memorize this here.
SusiThought	addTimes(int t)
boolean	equals(java.lang.Object o)
java.util.List<SusiAction>	getActions() To be able to apply (re-)actions to this thought, the actions on the information can be retrieved.
int	getCount() The number of information pieces in a set of informations may have a count.
JSONArray	getData() Information contained in this thought can get returned as a table, a set of information pieces.
int	getHits()
java.lang.String	getObservation(java.lang.String featureName)
java.util.List<java.lang.String>	getObservations(java.lang.String featureName)
int	getOffset()
java.lang.String	getQuery()
java.util.List<java.lang.String>	getSkills()
int	getTimes()
boolean	hasEmptyObservation(java.lang.String key)
boolean	isFailed()
static void	main(java.lang.String[] args)
SusiThought	mergeData(JSONArray table1) Merging of data is required during an mind-meld.
SusiThought	setData(JSONArray table) Information contained in this thought has the form of a result set table, organized in rows and columns.
SusiThought	setHits(int hits) While the number of information pieces in a whole has a count, the number of relevant information pieces may have been extracted.
SusiThought	setOffset(int offset) In a series of information pieces the first information piece has number 0.
SusiThought	setProcess(java.lang.String processName) The process which created this thought may have a name or description string.
SusiThought	setQuery(java.lang.String query) If this thought was the result of a retrieval using a specific expression, that expression is called the query.
SusiThought	setScraperInfo(java.lang.String scraperInfo) If the expression to create this thought had an agent that expressed the result set of the information contained in this thought, it is called the scraper.
SusiThought	setTimes(int t)
JSONObject	toJSON()
java.lang.String	toString() Make a JSON text of this JSONObject.
java.lang.String	unify(java.lang.String statement, boolean urlencode) Unification applies a piece of memory within the current argument to a statement which creates an instantiated statement

Methods inherited from class org.json.JSONObject

accumulate, append, doubleToString, get, getBigDecimal, getBigInteger, getBoolean, getDouble, getEnum, getInt, getJSONArray, getJSONObject, getLong, getNames, getNames, getString, has, increment, isNull, keys, keySet, length, names, numberToString, opt, optBigDecimal, optBigInteger, optBoolean, optBoolean, optDouble, optDouble, optEnum, optEnum, optInt, optInt, optJSONArray, optJSONObject, optLong, optLong, optString, optString, put, put, put, put, put, put, put, putAll, putOnce, putOpt, quote, quote, remove, similar, stringToValue, testValidity, toJSONArray, toMap, toString, valueToString, wrap, write, write

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

variable_pattern

public static final java.util.regex.Pattern variable_pattern

Constructor Detail

SusiThought

public SusiThought()

create an empty thought, to be filled with single data entities.

SusiThought

public SusiThought(JSONObject json)

create a clone of a json object as a SusiThought object

Parameters:

json - the 'other' thought, probably an exported and re-imported thought

SusiThought

public SusiThought(java.util.regex.Matcher matcher)

Create an initial thought using the matcher on an expression. Such an expression is like the input from a text source which contains keywords that are essential for the thought. The matcher extracts such information. Matching informations are named using the order of the appearance of the information pieces. The first information is named '1', the second '2' and so on. The whole information which contained the matching information is named '0'.

Parameters:

matcher -

SusiThought

@Deprecated
public SusiThought(java.lang.String metadata_name,
                               java.lang.String data_name)

Deprecated.

Method Detail

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

setTimes

public SusiThought setTimes(int t)

addTimes

public SusiThought addTimes(int t)

getTimes

public int getTimes()

setOffset

public SusiThought setOffset(int offset)

In a series of information pieces the first information piece has number 0. If the thought is a follow-up series of a previous set of information, an offset is needed. That can be set here.

Parameters:

offset - the offset to a previous set of information pieces.

Returns:

the thought

getOffset

public int getOffset()

getCount

public int getCount()

The number of information pieces in a set of informations may have a count.

Returns:

hits number of information pieces

isFailed

public boolean isFailed()

hasEmptyObservation

public boolean hasEmptyObservation(java.lang.String key)

setHits

public SusiThought setHits(int hits)

While the number of information pieces in a whole has a count, the number of relevant information pieces may have been extracted. The hits number gives the number of relevant pieces. This can be set here.

Parameters:

hits - number of information pieces

Returns:

the thought

getHits

public int getHits()

setProcess

public SusiThought setProcess(java.lang.String processName)

The process which created this thought may have a name or description string. To document what happened, the process namen can be given here

Parameters:

query - the process which formed this thought

Returns:

the thought

setQuery

public SusiThought setQuery(java.lang.String query)

If this thought was the result of a retrieval using a specific expression, that expression is called the query. The query can be attached to a thought

Parameters:

query - the expression which caused that this thought was formed

Returns:

the thought

getQuery

public java.lang.String getQuery()

setScraperInfo

public SusiThought setScraperInfo(java.lang.String scraperInfo)

If the expression to create this thought had an agent that expressed the result set of the information contained in this thought, it is called the scraper. The scraper name can be attached here.

Parameters:

scraperInfo - the scraper that created this thought

Returns:

the thought

setData

public SusiThought setData(JSONArray table)

Information contained in this thought has the form of a result set table, organized in rows and columns. The columns must have all the same name in each row.

Parameters:

table - the information for this thought.

Returns:

the thought

getData

public JSONArray getData()

Information contained in this thought can get returned as a table, a set of information pieces.

Returns:

a table of information pieces as a set of rows which all have the same column names.

mergeData

public SusiThought mergeData(JSONArray table1)

Merging of data is required during an mind-meld. To meld two thoughts, we combine their data arrays into one. The resulting table has at maximum the length of both source tables combined.

Parameters:

table - the information to be melted into our existing table.

Returns:

the thought

addObservation

public SusiThought addObservation(java.lang.String featureName,
                                  java.lang.String observation)

If during thinking we observe something that we want to memorize, we can memorize this here. We insert the new data always in front of existing same data to make it visible as primary backtracking option. This means that new observations are always more important than old observations but do not overwrite them; they can be used again in case that the new observation is not valid during inference computation.

Parameters:

featureName - the object key

observation - the object value

Returns:

the thought

getObservations

public java.util.List<java.lang.String> getObservations(java.lang.String featureName)

getObservation

public java.lang.String getObservation(java.lang.String featureName)

addActions

public SusiThought addActions(java.util.List<SusiAction> actions)

Every information may have a set of (re-)actions assigned. Those (re-)actions are methods to do something with the thought.

Parameters:

actions - (re-)actions on this thought

Returns:

the thought

addAction

public SusiThought addAction(SusiAction action)

getActions

public java.util.List<SusiAction> getActions()

To be able to apply (re-)actions to this thought, the actions on the information can be retrieved.

Returns:

the (re-)actions which are applicable to this thought.

getSkills

public java.util.List<java.lang.String> getSkills()

unify

public java.lang.String unify(java.lang.String statement,
                              boolean urlencode)

Unification applies a piece of memory within the current argument to a statement which creates an instantiated statement

Parameters:

statement -

Returns:

the instantiated statement with elements of the argument applied as much as possible

toJSON

public JSONObject toJSON()

toString

public java.lang.String toString()

Description copied from class: JSONObject

Make a JSON text of this JSONObject. For compactness, no whitespace is added. If this would not result in a syntactically correct JSON text, then null will be returned instead.

Warning: This method assumes that the data structure is acyclical.

Overrides:

toString in class JSONObject

Returns:

a printable, displayable, portable, transmittable representation of the object, beginning with { (left brace) and ending with } (right brace).

main

public static void main(java.lang.String[] args)