org.javades.jqueues.r5.extensions.composite

Class AbstractSimQueuePredictor_Composite_LocalStart<Q extends AbstractSimQueueComposite_LocalStart>

java.lang.Object

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

org.javades.jqueues.r5.extensions.composite.AbstractSimQueuePredictor_Composite<Q>

org.javades.jqueues.r5.extensions.composite.AbstractSimQueuePredictor_Composite_LocalStart<Q>

Type Parameters:

Q - The type of queue supported.

All Implemented Interfaces:

SimQueueEventPredictor<Q>, SimQueuePredictor<Q>, SimQueueStatePredictor<Q>

Direct Known Subclasses:

SimQueuePredictor_FB_v, SimQueuePredictor_Pattern, SimQueuePredictor_Tandem

public abstract class AbstractSimQueuePredictor_Composite_LocalStart<Q extends AbstractSimQueueComposite_LocalStart>
extends AbstractSimQueuePredictor_Composite<Q>

A SimQueuePredictor for AbstractSimQueueComposite_LocalStart and derived queues.

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.

Nested Class Summary

Nested classes/interfaces inherited from class org.javades.jqueues.r5.extensions.composite.AbstractSimQueuePredictor_Composite

AbstractSimQueuePredictor_Composite.SubQueueSimpleEvent

Field Summary

Fields inherited from class org.javades.jqueues.r5.extensions.composite.AbstractSimQueuePredictor_Composite

subQueuePredictors

Constructor Summary

Constructors

Constructor and Description
AbstractSimQueuePredictor_Composite_LocalStart(List<AbstractSimQueuePredictor> subQueuePredictors)

Method Summary

Modifier and Type	Method and Description
protected void	checkSubQueueVisitLogsSet(double time, Q queue, SimQueueState<SimJob,Q> queueState, Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet, SimQueue subQueue, int subQueueIndex, DefaultSimQueueState<SimJob,SimQueue> subQueueState, Set<JobQueueVisitLog<SimJob,Q>> subQueueVisitLogsSet)
SimQueueState<SimJob,Q>	createQueueState(Q queue, boolean isROEL) Registers a new SimQueueCompositeStateHandler at the object created by super method, creating appropriate empty DefaultSimQueueStates for the sub-queues.
protected void	departJobs(double time, Q queue, SimQueueState<SimJob,Q> queueState, Set<SimJob> departers, Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)
void	doQueueEvents_SQ_SV_ROEL_U(Q queue, SimQueueState<SimJob,Q> queueState, Set<SimEntitySimpleEventType.Member> queueEventTypes, Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet) Process the next event(s) at a queue with given state.
void	doWorkloadEvents_SQ_SV_ROEL_U(Q queue, WorkloadSchedule_SQ_SV_ROEL_U workloadSchedule, SimQueueState<SimJob,Q> queueState, Set<SimEntitySimpleEventType.Member> workloadEventTypes, Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet) Process the next event(s) from given WorkloadSchedule at a queue with given state.
protected void	dropJobs(double time, Q queue, SimQueueState<SimJob,Q> queueState, Set<SimJob> drops, Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)
double	getNextQueueEventTimeBeyond(Q queue, SimQueueState<SimJob,Q> 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.
protected void	revokeJobs(double time, Q queue, SimQueueState<SimJob,Q> queueState, Set<SimJob> revokers, Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)
protected void	startJobs(double time, Q queue, SimQueueState<SimJob,Q> queueState, Set<SimJob> starters, Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)
void	updateToTime(Q 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, toString, 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

createWorkloadSchedule_SQ_SV_ROEL_U, createWorkloadSchedule_SQ_SV, doWorkloadEvents_SQ_SV

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

hasServerAccessCredits, isQueueAccessVacation, isStartArmed

Constructor Detail

AbstractSimQueuePredictor_Composite_LocalStart

public AbstractSimQueuePredictor_Composite_LocalStart(List<AbstractSimQueuePredictor> subQueuePredictors)

Method Detail

createQueueState

public SimQueueState<SimJob,Q> createQueueState(Q queue,
                                                boolean isROEL)

Registers a new SimQueueCompositeStateHandler at the object created by super method, creating appropriate empty DefaultSimQueueStates for the sub-queues.

Specified by:

createQueueState in interface SimQueueEventPredictor<Q extends AbstractSimQueueComposite_LocalStart>

Overrides:

createQueueState in class AbstractSimQueuePredictor_Composite<Q extends AbstractSimQueueComposite_LocalStart>

Parameters:

queue - The queue, non-null.

isROEL - Whether or not the event list used is a Random-Order Event List.

Returns:

A new suitable SimQueueState object for this predictor and given queue.

updateToTime

public void updateToTime(Q 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)

getNextQueueEventTimeBeyond

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

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.

Throws:

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

See Also:

SimJQSimpleEventType.START, SimJQSimpleEventType.DEPARTURE

doWorkloadEvents_SQ_SV_ROEL_U

public void doWorkloadEvents_SQ_SV_ROEL_U(Q queue,
                                          WorkloadSchedule_SQ_SV_ROEL_U workloadSchedule,
                                          SimQueueState<SimJob,Q> queueState,
                                          Set<SimEntitySimpleEventType.Member> workloadEventTypes,
                                          Set<JobQueueVisitLog<SimJob,Q>> 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(Q queue,
                                       SimQueueState<SimJob,Q> queueState,
                                       Set<SimEntitySimpleEventType.Member> queueEventTypes,
                                       Set<JobQueueVisitLog<SimJob,Q>> 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)

dropJobs

protected void dropJobs(double time,
                        Q queue,
                        SimQueueState<SimJob,Q> queueState,
                        Set<SimJob> drops,
                        Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)

revokeJobs

protected void revokeJobs(double time,
                          Q queue,
                          SimQueueState<SimJob,Q> queueState,
                          Set<SimJob> revokers,
                          Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)

startJobs

protected void startJobs(double time,
                         Q queue,
                         SimQueueState<SimJob,Q> queueState,
                         Set<SimJob> starters,
                         Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)
                  throws SimQueuePredictionException

Throws:

SimQueuePredictionException

departJobs

protected void departJobs(double time,
                          Q queue,
                          SimQueueState<SimJob,Q> queueState,
                          Set<SimJob> departers,
                          Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet)
                   throws SimQueuePredictionException

Throws:

SimQueuePredictionException

checkSubQueueVisitLogsSet

protected void checkSubQueueVisitLogsSet(double time,
                                         Q queue,
                                         SimQueueState<SimJob,Q> queueState,
                                         Set<JobQueueVisitLog<SimJob,Q>> visitLogsSet,
                                         SimQueue subQueue,
                                         int subQueueIndex,
                                         DefaultSimQueueState<SimJob,SimQueue> subQueueState,
                                         Set<JobQueueVisitLog<SimJob,Q>> subQueueVisitLogsSet)
                                  throws SimQueuePredictionException

Throws:

SimQueuePredictionException