genius.core.timeline

Class DiscreteTimeline

java.lang.Object

genius.core.timeline.Timeline

genius.core.timeline.DiscreteTimeline

All Implemented Interfaces:

TimeLineInfo, java.io.Serializable

public class DiscreteTimeline
extends Timeline

Implementation of the timeline in which time is divided in rounds. Time does not pass within a round. Note that requesting the total time is in this case undefined. NOTICE: DiscreteTimeline assumes each action of a player a 'round'. In PocketNegotiator this would be called a 'turn'. Check also getOwnRoundsLeft()

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class genius.core.timeline.Timeline

Timeline.Type

Field Summary

Fields

Modifier and Type	Field and Description
protected int	cRound E.g.

Fields inherited from class genius.core.timeline.Timeline

hasDeadline, paused

Constructor Summary

Constructors

Constructor and Description
DiscreteTimeline(int totalRounds)

Method Summary

Modifier and Type	Method and Description
double	getCurrentTime()
int	getOwnRoundsLeft() The number of rounds left for ourself.
int	getOwnTotalRounds() The total number of rounds for ourself.
int	getRound() Starting to count from 1, until the total amount of rounds.
int	getRoundsLeft()
double	getTime() Gets the time, running from t = 0 (start) to t = 1 (deadline).
int	getTotalRounds() Be careful, this is not equal to the initializing value!
double	getTotalTime() Agent.sleep(double) requires this method.
Timeline.Type	getType() In a time-based protocol, time passes within a round.
void	increment()
void	setcRound(int cRound)

Methods inherited from class genius.core.timeline.Timeline

isDeadlineReached, isPaused

Methods inherited from class java.lang.Object

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

Field Detail

cRound

protected int cRound

E.g. with 3 rounds, it takes the values 1, 2, 3, and on 4 is the deadline.

Constructor Detail

DiscreteTimeline

public DiscreteTimeline(int totalRounds)

Parameters:

the - total number of rounds allowed on this timeline. Creates a timeline with a deadline of totalRounds number of rounds. If 3, the play rounds are 1,2,3 and when we are on round 4 the deadline is reached. see also getTime()

Method Detail

getTime

public double getTime()

Description copied from class: Timeline

Gets the time, running from t = 0 (start) to t = 1 (deadline). The time is normalized, so agents need not be concerned with the actual internal clock.

Specified by:

getTime in interface TimeLineInfo

Specified by:

getTime in class Timeline

Returns:

the time, running from t = 0 (start) to t = 1 (deadline). The time is normalized, so agents need not be concerned with the actual internal clock.

increment

public void increment()

setcRound

public void setcRound(int cRound)

getTotalTime

public double getTotalTime()

Agent.sleep(double) requires this method.

Specified by:

getTotalTime in interface TimeLineInfo

Specified by:

getTotalTime in class Timeline

Returns:

amount of time in seconds, or amount of rounds depending on timeline type.

getRound

public int getRound()

Starting to count from 1, until the total amount of rounds.

getRoundsLeft

public int getRoundsLeft()

getTotalRounds

public int getTotalRounds()

Be careful, this is not equal to the initializing value!

getOwnTotalRounds

public int getOwnTotalRounds()

The total number of rounds for ourself. Be careful, this is not equal to the initializing value!

getOwnRoundsLeft

public int getOwnRoundsLeft()

The number of rounds left for ourself.

getType

public Timeline.Type getType()

Description copied from interface: TimeLineInfo

In a time-based protocol, time passes within a round. In contrast, in a rounds-based protocol time only passes when the action is presented.

Specified by:

getType in interface TimeLineInfo

Overrides:

getType in class Timeline

Returns:

type of time: Type.Time or Type.Rounds.

getCurrentTime

public double getCurrentTime()

Specified by:

getCurrentTime in interface TimeLineInfo

Specified by:

getCurrentTime in class Timeline

Returns:

amount of seconds passed, or amount of rounds passed depending on the timeline type.