FRAMES NO FRAMES

Class IloSchedulerEnv

Definition file: ilsched/iloschedenv.h
Include file: <ilsched/iloscheduler.h>

The class IloSchedulerEnv is the repository of all the default parameters used when creating new modeling objects. There can be at most one IloSchedulerEnv defined on a given instance of IloEnv.

Avoiding Overflows

In order to avoid overflows in computations by Scheduler Engine, an efficient policy is to limit the domain of all extracted integer variables to an interval of [-L,L]. For example, a variable whose lower bound is 0 and upper bound is IloInfinity will be extracted as a variable with the domain [0,L]. This limit L is set by the member function IloSchedulerEnv::setIntMaxAtExtraction. At extraction, this limit is used only for variables that are used by Scheduler objects or constraints, as the start and end times, the capacity variables or the precedence delays. Please note that there is an exception for the cost sum variable (class IloTransitionCost). For this variable, the limit L is not applied because there is usually no overflow with this variable. The default value of this limit is IloIntMax/2, which avoids overflows in most cases.

For more information, see IloNumToNumStepFunction, IloNumToAnySetStepFunction, and IloIntervalList in the extensions section of the IBM ILOG Concert Technology Reference Manual, Parameter Classes.

See Also:

Constructor Summary
public IloSchedulerEnv(const IloEnv env)
public IloSchedulerEnv(IloSchedulerEnvI * impl)
Method Summary
public IloActivityBasicParamgetActivityBasicParam() const
public IloActivityBreakParamgetActivityBreakParam() const
public IloActivityConstraintsParamgetActivityConstraintsParam() const
public IloActivityOverlapParamgetActivityOverlapParam() const
public IloActivityShiftParamgetActivityShiftParam() const
public IloIntervalListgetBreakListParam() const
public IloIntervalListgetCapacityEnforcementIntervalsParam() const
public IloNumToNumStepFunctiongetCapacityMaxParam() const
public IloNumToNumStepFunctiongetCapacityMinParam() const
public IloEnvgetEnv() const
public IloNumgetHorizon() const
public IloSchedulerEnvI *getImpl() const
public IloNumToNumStepFunctiongetInitialOccupationParam() const
public IloIntgetIntMaxAtExtraction() const
public IloTextureParamgetMaxTextureParam() const
public IloTextureParamgetMinTextureParam() const
public IloIntervalListgetMustBeInUseParam() const
public IloNumgetOrigin() const
public IloNumToAnySetStepFunctiongetPossibleStatesParam() const
public IloEnforcementLevelgetPrecedenceEnforcement() const
public IloResourceParamgetResourceParam() const
public IloIntervalListgetTransitionTimeEnforcementIntervalsParam() const
public voidsetActivityBasicParam(const IloActivityBasicParam param) const
public voidsetActivityBreakParam(const IloActivityBreakParam param) const
public voidsetActivityConstraintsParam(const IloActivityConstraintsParam param) const
public voidsetActivityOverlapParam(const IloActivityOverlapParam param) const
public voidsetActivityShiftParam(const IloActivityShiftParam param) const
public voidsetBreakListParam(const IloIntervalList param) const
public voidsetCapacityEnforcementIntervalsParam(const IloIntervalList param) const
public voidsetCapacityMaxParam(const IloNumToNumStepFunction param) const
public voidsetCapacityMinParam(const IloNumToNumStepFunction param) const
public voidsetHorizon(IloNum horizon) const
public voidsetInitialOccupationParam(const IloNumToNumStepFunction param) const
public voidsetIntMaxAtExtraction(IloInt max) const
public voidsetMaxTextureParam(const IloTextureParam param) const
public voidsetMinTextureParam(const IloTextureParam param) const
public voidsetMustBeInUseParam(const IloIntervalList param) const
public voidsetOrigin(IloNum origin) const
public voidsetPossibleStatesParam(const IloNumToAnySetStepFunction param) const
public voidsetPrecedenceEnforcement(IloEnforcementLevel level) const
public voidsetResourceParam(const IloResourceParam param) const
public voidsetTransitionTimeEnforcementIntervalsParam(const IloIntervalList param) const
Constructor Detail

IloSchedulerEnv

public IloSchedulerEnv(const IloEnv env)

This constructor creates a new instance of IloSchedulerEnv if none currently exists on the given instance of IloEnv. If a scheduler environment has already been created on the environment, then the new handle uses it, and points to the same implementation. When created, an instance of IloSchedulerEnv will create all the default parameters and initialize them to their default values.


IloSchedulerEnv

public IloSchedulerEnv(IloSchedulerEnvI * impl)

This constructor creates an instance of the handle class IloSchedulerEnv from the pointer to an instance of the implementation class IloSchedulerEnvI.


Method Detail

getActivityBasicParam

public IloActivityBasicParam getActivityBasicParam() const

This member function returns the default instance of the activity basic parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getActivityBreakParam

public IloActivityBreakParam getActivityBreakParam() const

This member function returns the default instance of the activity break parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getActivityConstraintsParam

public IloActivityConstraintsParam getActivityConstraintsParam() const

This member function returns the default instance of the activity constraints parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getActivityOverlapParam

public IloActivityOverlapParam getActivityOverlapParam() const

This member function returns the default instance of the activity overlap parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getActivityShiftParam

public IloActivityShiftParam getActivityShiftParam() const

This member function returns the default instance of the activity shift parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getBreakListParam

public IloIntervalList getBreakListParam() const

This member function returns the default instance of the break list parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getCapacityEnforcementIntervalsParam

public IloIntervalList getCapacityEnforcementIntervalsParam() const

This member function returns the default instance of the capacity enforcement intervals parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getCapacityMaxParam

public IloNumToNumStepFunction getCapacityMaxParam() const

This member function returns the default instance of the maximal capacity parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getCapacityMinParam

public IloNumToNumStepFunction getCapacityMinParam() const

This member function returns the default instance of the minimal capacity parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getEnv

public IloEnv getEnv() const

This member function returns the instance of IloEnv on which the called object was built.


getHorizon

public IloNum getHorizon() const

This member function returns the time horizon. The time origin and the time horizon are used by default at extraction to initialize the time window over which resource capacity constraints must be enforced. The origin and horizon are also used for setting earliest start times and latest end times of activities when they are created.


getImpl

public IloSchedulerEnvI * getImpl() const

This member function returns a pointer to the implementation object corresponding to the invoking activity (a handle).


getInitialOccupationParam

public IloNumToNumStepFunction getInitialOccupationParam() const

This member function returns the default instance of the initial occupation parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getIntMaxAtExtraction

public IloInt getIntMaxAtExtraction() const

This member function returns the value of the maximum limit of the domain of the integer variables used by Scheduler Engine.

Avoiding Overflows

In order to avoid overflows in computations by Scheduler Engine, an efficient policy is to limit the domain of all extracted integer variables to an interval of [-L,L]. For example, a variable whose lower bound is 0 and upper bound is IloInfinity will be extracted as a variable with the domain [0,L]. This limit L is set by the member function IloSchedulerEnv::setIntMaxAtExtraction. At extraction, this limit is used only for variables that are used by Scheduler objects or constraints, as the start and end times, the capacity variables or the precedence delays. Please note that there is an exception for the cost sum variable (class IloTransitionCost). For this variable, the limit L is not applied because there is usually no overflow with this variable. The default value of this limit is IloIntMax/2, which avoids overflows in most cases.

For more information, see Parameters Organized by Function and IloNumToNumStepFunction in the IBM ILOG Concert Technology Reference Manual.


getMaxTextureParam

public IloTextureParam getMaxTextureParam() const

The member function returns the default instance of the texture parameter on maximum capacity constraints. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getMinTextureParam

public IloTextureParam getMinTextureParam() const

The member function returns the default instance of the texture parameter on minimum capacity constraints. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getMustBeInUseParam

public IloIntervalList getMustBeInUseParam() const

This member function returns the default instance of the must be in use parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getOrigin

public IloNum getOrigin() const

This member function returns the time origin. The time origin and the time horizon are used by default at extraction to initialize the time window over which resource capacity constraints must be enforced. The origin and horizon are also used for setting earliest start times and latest end times of activities when they are created.


getPossibleStatesParam

public IloNumToAnySetStepFunction getPossibleStatesParam() const

This member function returns the default instance of the possible states parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getPrecedenceEnforcement

public IloEnforcementLevel getPrecedenceEnforcement() const

This member function returns the global precedence enforcement level of the scheduler environment.


getResourceParam

public IloResourceParam getResourceParam() const

This member function returns the default instance of the resource parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


getTransitionTimeEnforcementIntervalsParam

public IloIntervalList getTransitionTimeEnforcementIntervalsParam() const

This member function returns the default instance of the transition time enforcement intervals parameter. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


setActivityBasicParam

public void setActivityBasicParam(const IloActivityBasicParam param) const

This member function sets param as the new default activity basic parameter. Subsequently created modeling objects will point to this parameter instance.


setActivityBreakParam

public void setActivityBreakParam(const IloActivityBreakParam param) const

This member function sets param as the new default activity break parameter. Subsequently created modeling objects will point to this parameter instance.


setActivityConstraintsParam

public void setActivityConstraintsParam(const IloActivityConstraintsParam param) const

This member function sets param as the new default activity constraints parameter. Subsequently created modeling objects will point to this parameter instance.


setActivityOverlapParam

public void setActivityOverlapParam(const IloActivityOverlapParam param) const

This member function sets param as the new default activity overlap parameter. Subsequently created modeling objects will point to this parameter instance.


setActivityShiftParam

public void setActivityShiftParam(const IloActivityShiftParam param) const

This member function sets param as the new default activity shift parameter. Subsequently–created modeling objects will point to this parameter instance.


setBreakListParam

public void setBreakListParam(const IloIntervalList param) const

This member function sets param as the new default break list parameter. Subsequently created modeling objects will point to this parameter instance.


setCapacityEnforcementIntervalsParam

public void setCapacityEnforcementIntervalsParam(const IloIntervalList param) const

This member function sets param as the new default capacity enforcement intervals parameter. Subsequently created modeling objects will point to this parameter instance.


setCapacityMaxParam

public void setCapacityMaxParam(const IloNumToNumStepFunction param) const

This member function sets param as the new default maximal capacity parameter. Subsequently created modeling objects will point to this parameter instance.


setCapacityMinParam

public void setCapacityMinParam(const IloNumToNumStepFunction param) const

This member function sets param as the new default minimal capacity parameter. Subsequently created modeling objects will point to this parameter instance.


setHorizon

public void setHorizon(IloNum horizon) const

This member function sets the time horizon to horizon. The time origin and the time horizon are used by default at extraction to initialize the time window over which resource capacity constraints must be enforced. The origin and horizon are also used for setting earliest start times and latest end times of activities when they are created.


setInitialOccupationParam

public void setInitialOccupationParam(const IloNumToNumStepFunction param) const

This member function sets param as the new default initial occupation parameter. Subsequently created modeling objects will point to this parameter instance.


setIntMaxAtExtraction

public void setIntMaxAtExtraction(IloInt max) const

This member function sets max as the new value for the maximum limit of the domain of the integer variables used by Scheduler Engine. See IloSchedulerEnv::getIntMaxAtExtraction for more information on avoiding overflows.


setMaxTextureParam

public void setMaxTextureParam(const IloTextureParam param) const

This member function sets the texture parameter on maximum capacity constraints to param. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


setMinTextureParam

public void setMinTextureParam(const IloTextureParam param) const

This member function sets the texture parameter on minimum capacity constraints to param. Modeling objects that are created will point to this instance, which can thus be shared between several objects.


setMustBeInUseParam

public void setMustBeInUseParam(const IloIntervalList param) const

This member function sets param as the new default must be in use parameter. Subsequently created modeling objects will point to this parameter instance.


setOrigin

public void setOrigin(IloNum origin) const

This member function sets the time origin to origin. The time origin and the time horizon are used by default at extraction to initialize the time window over which resource capacity constraints must be enforced. The origin and horizon are also used for setting earliest start times and latest end times of activities when they are created.


setPossibleStatesParam

public void setPossibleStatesParam(const IloNumToAnySetStepFunction param) const

This member function sets param as the new default possible states parameter. Subsequently created modeling objects will point to this parameter instance.


setPrecedenceEnforcement

public void setPrecedenceEnforcement(IloEnforcementLevel level) const

This member function allows setting level as the new global precedence enforcement level of the scheduler environment. See Resource Enforcement as Global Constraint Declaration for a description of how this enforcement level is interpreted at extraction time by the scheduler engine.


setResourceParam

public void setResourceParam(const IloResourceParam param) const

This member function sets param as the new default resource parameter. Subsequently created modeling objects will point to this parameter instance.


setTransitionTimeEnforcementIntervalsParam

public void setTransitionTimeEnforcementIntervalsParam(const IloIntervalList param) const

This member function sets param as the new default transition time enforcement intervals parameter. Subsequently created modeling objects will point to this parameter instance.