org.javades.jqueues.r5.util.predictor.queues

Class SimQueuePredictor_SUR

java.lang.Object

org.javades.jqueues.r5.util.predictor.AbstractSimQueuePredictor<SUR>

org.javades.jqueues.r5.util.predictor.queues.SimQueuePredictor_SUR

All Implemented Interfaces:

SimQueueEventPredictor<SUR>, SimQueuePredictor<SUR>, SimQueueStatePredictor<SUR>

public class SimQueuePredictor_SUR
extends AbstractSimQueuePredictor<SUR>

A SimQueuePredictor for SUR.

Author:

Jan de Jongh, TNO

Copyright (C) 2005-2017 Jan de Jongh, TNO

This file is covered by the LICENSE file in the root of this project.

Constructor Summary

Constructors

Constructor and Description
SimQueuePredictor_SUR()

Method Summary

Modifier and Type	Method and Description
void	doQueueEvents_SQ_SV_ROEL_U(SUR queue, SimQueueState<SimJob,SUR> queueState, Set<SimEntitySimpleEventType.Member> queueEventTypes, Set<JobQueueVisitLog<SimJob,SUR>> visitLogsSet) Process the next event(s) at a queue with given state.
void	doWorkloadEvents_SQ_SV_ROEL_U(SUR queue, WorkloadSchedule_SQ_SV_ROEL_U workloadSchedule, SimQueueState<SimJob,SUR> queueState, Set<SimEntitySimpleEventType.Member> workloadEventTypes, Set<JobQueueVisitLog<SimJob,SUR>> visitLogsSet) Process the next event(s) from given WorkloadSchedule at a queue with given state.
double	getNextQueueEventTimeBeyond(SUR queue, SimQueueState<SimJob,SUR> queueState, Set<SimEntitySimpleEventType.Member> queueEventTypes) Returns the time and types of the next event(s) scheduled strictly beyond the time at (the state object of) a specific queue.
boolean	isStartArmed(SUR queue, SimQueueState<SimJob,SUR> queueState) Checks whether a given state represents StartArmed on given queue.
String	toString()
void	updateToTime(SUR queue, SimQueueState queueState, double newTime) Updates the queue state to a new time, without processing any events.

Methods inherited from class org.javades.jqueues.r5.util.predictor.AbstractSimQueuePredictor

is_ROEL_U_UnderWorkloadQueueEventClashes, is_U_UnderWorkloadQueueEventClashes, predict_SQ_SV_IOEL_U, predict_SQ_SV_ROEL_U

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.javades.jqueues.r5.util.predictor.SimQueuePredictor

matchVisitLogs_SQ_SV

Methods inherited from interface org.javades.jqueues.r5.util.predictor.SimQueueEventPredictor

createQueueState, createWorkloadSchedule_SQ_SV_ROEL_U, createWorkloadSchedule_SQ_SV, doWorkloadEvents_SQ_SV

Methods inherited from interface org.javades.jqueues.r5.util.predictor.SimQueueStatePredictor

hasServerAccessCredits, isQueueAccessVacation

Constructor Detail

SimQueuePredictor_SUR

public SimQueuePredictor_SUR()

Method Detail

toString

public String toString()

Overrides:

toString in class Object

isStartArmed

public boolean isStartArmed(SUR queue,
                            SimQueueState<SimJob,SUR> queueState)

Description copied from interface: SimQueueStatePredictor

Checks whether a given state represents StartArmed on given queue.

Parameters:

queue - The queue.

queueState - The queue state, non-null.

Returns:

True if the state represents StartArmed at given queue.

getNextQueueEventTimeBeyond

public double getNextQueueEventTimeBeyond(SUR queue,
                                          SimQueueState<SimJob,SUR> queueState,
                                          Set<SimEntitySimpleEventType.Member> queueEventTypes)

Description copied from interface: SimQueueEventPredictor

Returns the time and types of the next event(s) scheduled strictly beyond the time at (the state object of) a specific queue.

The time from which to search must be taken from SimQueueState.getTime(), and equals Double.NaN after initialization.

Parameters:

queue - The queue, non-null.

queueState - The queue-state, non-null.

queueEventTypes - A non-null set to store the (possible multiple) event types; it must be cleared upon entry.

Returns:

The time of the next event, or Double.NaN if no such event exists.

See Also:

SimJQSimpleEventType.START, SimJQSimpleEventType.DEPARTURE

doWorkloadEvents_SQ_SV_ROEL_U

public void doWorkloadEvents_SQ_SV_ROEL_U(SUR queue,
                                          WorkloadSchedule_SQ_SV_ROEL_U workloadSchedule,
                                          SimQueueState<SimJob,SUR> queueState,
                                          Set<SimEntitySimpleEventType.Member> workloadEventTypes,
                                          Set<JobQueueVisitLog<SimJob,SUR>> visitLogsSet)
                                   throws SimQueuePredictionException,
                                          WorkloadScheduleException

Description copied from interface: SimQueueEventPredictor

Process the next event(s) from given WorkloadSchedule at a queue with given state.

The scheduled time and the types of the next events must be known beforehand, e.g., through WorkloadSchedule.getNextEventTimeBeyond(org.javades.jqueues.r5.entity.jq.queue.SimQueue, double, java.util.Set<org.javades.jqueues.r5.entity.SimEntitySimpleEventType.Member>). The scheduled time has already been set on the SimQueueState object, and the object has been updated upto that time. The time on the queue state must not be changed.

Implementations must update the queue state and (if applicable) add suitable entries to the visit logs.

Implementations must not modify the workload schedule.

Parameters:

queue - The queue, non-null.

workloadSchedule - The workload schedule, non-null.

queueState - The queue-state, non-null.

workloadEventTypes - The (pre-calculated) types of the next workload event(s).

visitLogsSet - The visit logs, non-null.

Throws:

SimQueuePredictionException - If the result cannot be computed, e.g., due to invalid input or schedule ambiguities.

WorkloadScheduleException - If the workload is invalid (e.g., containing ambiguities).

See Also:

WorkloadSchedule.getNextEventTimeBeyond(org.javades.jqueues.r5.entity.jq.queue.SimQueue, double, java.util.Set<org.javades.jqueues.r5.entity.SimEntitySimpleEventType.Member>), SimQueueEventPredictor.updateToTime(Q, org.javades.jqueues.r5.util.predictor.state.SimQueueState, double), SimQueueState.setTime(double)

doQueueEvents_SQ_SV_ROEL_U

public void doQueueEvents_SQ_SV_ROEL_U(SUR queue,
                                       SimQueueState<SimJob,SUR> queueState,
                                       Set<SimEntitySimpleEventType.Member> queueEventTypes,
                                       Set<JobQueueVisitLog<SimJob,SUR>> visitLogsSet)
                                throws SimQueuePredictionException

Description copied from interface: SimQueueEventPredictor

Process the next event(s) at a queue with given state.

The scheduled time and the types of the next events must be known beforehand, e.g., through SimQueueEventPredictor.getNextQueueEventTimeBeyond(Q, org.javades.jqueues.r5.util.predictor.state.SimQueueState<org.javades.jqueues.r5.entity.jq.job.SimJob, Q>, java.util.Set<org.javades.jqueues.r5.entity.SimEntitySimpleEventType.Member>). The scheduled time has already been set on the SimQueueState object, and the object has been updated upto that time. The time on the queue state must not be changed.

Implementations must update the queue state and (if applicable) add suitable entries to the visit logs.

Parameters:

queue - The queue, non-null.

queueState - The queue-state, non-null

queueEventTypes - The (pre-calculated) types of the next workload event(s).

visitLogsSet - The visit logs, non-null.

Throws:

SimQueuePredictionException - If the result cannot be computed, e.g., due to invalid input or schedule ambiguities.

See Also:

SimQueueEventPredictor.getNextQueueEventTimeBeyond(Q, org.javades.jqueues.r5.util.predictor.state.SimQueueState<org.javades.jqueues.r5.entity.jq.job.SimJob, Q>, java.util.Set<org.javades.jqueues.r5.entity.SimEntitySimpleEventType.Member>), SimQueueEventPredictor.updateToTime(Q, org.javades.jqueues.r5.util.predictor.state.SimQueueState, double), SimQueueState.setTime(double)

updateToTime

public void updateToTime(SUR queue,
                         SimQueueState queueState,
                         double newTime)

Description copied from interface: SimQueueEventPredictor

Updates the queue state to a new time, without processing any events.

Implementations must at least set the time on the queue state. Beware that the old time on the queue state may equal its initial value Double.NaN.

Parameters:

queue - The queue, non-null.

queueState - The queue-state, non-null.

newTime - The new time.

See Also:

SimQueueState.setTime(double)