burlap.domain.singleagent.tabularized

Class TabulatedDomainWrapper

java.lang.Object

burlap.domain.singleagent.tabularized.TabulatedDomainWrapper

All Implemented Interfaces:

DomainGenerator

public class TabulatedDomainWrapper
extends java.lang.Object
implements DomainGenerator

In general, it is suggested algorithms be designed to work with either factored state representations or the BURLAP State Hashing. However, some algorithms may be limited to working with states that have explicit enumerated values and with an entire state space already defined. In particular, if you are interfacing with code external to BURLAP this may be required. This domain generator can take any input domain that does not have parameterized actions and turn it into a domain in which states are represented by a single int attribute and are fully enumerated. The state space used must be enumerated before calling the generateDomain() method and is performed using a BURLAP state enumerator. In particular, seed states must be passed to this object and it will find all reachable states from the seed state and enumerate them.

Author:

James MacGlashan

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	TabulatedDomainWrapper.ActionWrapper An action wrapper that coverts a tabularized state into the source domain state, perform the corresponding source domain action on it getting the resutling source domain state and returns the tabularized version of the resulting source domain state.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ATTSTATE The single attribute name for identifying states
static java.lang.String	CLASSSTATE The single class name that holds the state attribute
protected StateEnumerator	enumerator The state enumerator used for enumerating (or tabulating) all states
protected Domain	inputDomain The input domain that is to be wrapped into a tabularized domain
protected Domain	tabDomain The output tabularied domain

Constructor Summary

Constructors

Constructor and Description
TabulatedDomainWrapper(Domain inputDomain, StateHashFactory hashingFactory) Constructs.

Method Summary

Methods

Modifier and Type	Method and Description
void	addReachableStatesFrom(State from) Enumerates all reachable states from the input state to include in this tabularized domain's state space.
Domain	generateDomain() Returns a newly instanced Domain object
State	getSourceDomainState(State s) Returns the source domain state associated with the tabularized state
int	getStateId(State s) Returns the state id for a state beloning to the input source domain
State	getTabularizedState(State s) Returns a tabularized state for a source domain state

Methods inherited from class java.lang.Object

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

Field Detail

ATTSTATE

public static final java.lang.String ATTSTATE

The single attribute name for identifying states

See Also:

Constant Field Values

CLASSSTATE

public static final java.lang.String CLASSSTATE

The single class name that holds the state attribute

See Also:

Constant Field Values

inputDomain

protected Domain inputDomain

The input domain that is to be wrapped into a tabularized domain

tabDomain

protected Domain tabDomain

The output tabularied domain

enumerator

protected StateEnumerator enumerator

The state enumerator used for enumerating (or tabulating) all states

Constructor Detail

TabulatedDomainWrapper

public TabulatedDomainWrapper(Domain inputDomain,
                      StateHashFactory hashingFactory)

Constructs.

Parameters:

inputDomain - the input domain to be wrapped

hashingFactory - the hashing factory used to enumerate states from the input domain

Method Detail

addReachableStatesFrom

public void addReachableStatesFrom(State from)

Enumerates all reachable states from the input state to include in this tabularized domain's state space.

Parameters:

from - the souce state from which to find and enumerate all reachable states

generateDomain

public Domain generateDomain()

Description copied from interface: DomainGenerator

Returns a newly instanced Domain object

Specified by:

generateDomain in interface DomainGenerator

Returns:

the newly instantiated Domain object.

getStateId

public int getStateId(State s)

Returns the state id for a state beloning to the input source domain

Parameters:

s - the source domain state

Returns:

the state id

getSourceDomainState

public State getSourceDomainState(State s)

Returns the source domain state associated with the tabularized state

Parameters:

s - the tabularized state

Returns:

the source domain state

getTabularizedState

public State getTabularizedState(State s)

Returns a tabularized state for a source domain state

Parameters:

s - the source domain state

Returns:

the tabularized state