burlap.mdp.core.state.StateUtilities Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of burlap Show documentation

The Brown-UMBC Reinforcement Learning and Planning (BURLAP) Java code library is for the use and development of single or multi-agent planning and learning algorithms and domains to accompany them. The library uses a highly flexible state/observation representation where you define states with your own Java classes, enabling support for domains that discrete, continuous, relational, or anything else. Planning and learning algorithms range from classic forward search planning to value-function-based stochastic planning and learning algorithms.

The newest version!

package burlap.mdp.core.state;

import java.util.List;

/**
 * A class with static methods for common tasks with states.
 * @author James MacGlashan.
 */
public class StateUtilities {

	private StateUtilities(){

	}

	/**
	 * Takes an input object, typically value to which a variable should be set, that is either a String representation of a number, or a
	 * {@link Number}, and returns the corresponding {@link Number}. If the input is not a number or string
	 * representation of a number, a runtime exception is thrown.
	 * @param o the input object that is either a {@link String} or a {@link Number}
	 * @return the corresponding {@link Number}.
	 */
	public static Number stringOrNumber(Object o){
		if(o instanceof Number){
			return (Number)o;
		}
		else if(o instanceof String){
			Double d = Double.parseDouble((String)o);
			return d;
		}
		throw new RuntimeException("Value is neither a Number nor a String.");
	}

	/**
	 * Takes an input object, typically value to which a variable should be set, that is either a String representation of a boolean, or a
	 * {@link Boolean}, and returns the corresponding {@link Boolean}. If the input is not a boolean or string
	 * representation of a boolean, a runtime exception is thrown.
	 * @param o the input object that is either a {@link String} or a {@link Boolean}
	 * @return the corresponding {@link Boolean}.
	 */
	public static Boolean stringOrBoolean(Object o){
		if(o instanceof Boolean){
			return (Boolean)o;
		}
		else if(o instanceof String){
			return Boolean.parseBoolean((String)o);
		}
		throw new RuntimeException("Value is neither a Boolean nor a String.");
	}


	/**
	 * A standard method for turning an arbitrary {@link State} into a {@link String} representation. Often used
	 * for the {@link Object#toString()} implementation of a {@link State}.
	 * @param s the input {@link State}
	 * @return the {@link String} representation.
	 */
	public static String stateToString(State s){
		StringBuilder buf = new StringBuilder();
		buf.append("{\n");
		List