Package org.jacop.constraints
Class CountBounds
java.lang.Object
org.jacop.constraints.DecomposedConstraint<Constraint>
org.jacop.constraints.Constraint
org.jacop.constraints.PrimitiveConstraint
org.jacop.constraints.CountBounds
- All Implemented Interfaces:
SatisfiedPresent
,StoreAware
CountBounds constraint implements the counting over number of occurrences of
a given value in a list of variables. The number of occurrences is
specified by lower bound and upper bound, lb and ub.
- Version:
- 4.10
-
Field Summary
FieldsModifier and TypeFieldDescription(package private) static final AtomicInteger
(package private) final int
It specifies a lower and upper bounds of occurences of the specified value in a list.final IntVar[]
The list of variables which are checked and counted if equal to specified value.(package private) final int
final int
The value to which is any variable is equal to makes the constraint count it.Fields inherited from class org.jacop.constraints.PrimitiveConstraint
notConsistencyPruningEvents
Fields inherited from class org.jacop.constraints.Constraint
afcWeight, atomicExecution, consistencyPruningEvents, constraintScope, earlyTerminationOK, increaseWeight, numberId, scope, trace, watchedVariableGrounded
Fields inherited from class org.jacop.constraints.DecomposedConstraint
queueIndex
-
Constructor Summary
ConstructorsConstructorDescriptionCountBounds
(List<? extends IntVar> list, int value, int lb, int ub) It constructs a CountBounds constraint.CountBounds
(IntVar[] list, int value, int lb, int ub) It constructs a CountBounds constraint. -
Method Summary
Modifier and TypeMethodDescriptionvoid
consistency
(Store store) It is a (most probably incomplete) consistency function which removes the values from variables domains.int
protected int
void
It imposes the constraint in a given store.void
It provide store for constraints that are not imposed but called from other constraints.void
notConsistency
(Store store) It makes pruning in such a way that constraint is notConsistent.boolean
It checks if constraint would be always not satisfied.boolean
It checks if the constraint is satisfied.private void
swap
(int i, int j) toString()
It produces a string representation of a constraint state.Methods inherited from class org.jacop.constraints.PrimitiveConstraint
getDefaultNestedConsistencyPruningEvent, getDefaultNestedNotConsistencyPruningEvent, getNestedPruningEvent, getNotConsistencyPruningEvent, setNotConsistencyPruningEvent
Methods inherited from class org.jacop.constraints.Constraint
afc, arguments, cleanAfterFailure, decompose, getConsistencyPruningEvent, getGuideConstraint, getGuideValue, getGuideVariable, grounded, grounded, id, impose, imposeDecomposition, increaseWeight, intArrayToString, long2int, numberArgs, queueVariable, removeConstraint, requiresMonotonicity, setConsistencyPruningEvent, setConstraintScope, setScope, setScope, setScope, setScope, setScope, setWatchedVariableGrounded, supplyGuideFeedback, toInt, toInt, updateAFC, watchedVariableGrounded
Methods inherited from class org.jacop.constraints.DecomposedConstraint
auxiliaryVariables, checkInput, checkInput, checkInputForDuplication, checkInputForDuplicationSkipSingletons, checkInputForNullness, checkInputForNullness, checkInputForNullness, derivative, getDubletonsSkipSingletons, imposeDecomposition
-
Field Details
-
idNumber
-
lb
final int lbIt specifies a lower and upper bounds of occurences of the specified value in a list. -
ub
final int ub -
list
The list of variables which are checked and counted if equal to specified value. -
value
public final int valueThe value to which is any variable is equal to makes the constraint count it. -
position
-
equal
-
-
Constructor Details
-
CountBounds
It constructs a CountBounds constraint.- Parameters:
list
- variables which equality to val is counted.value
- value which is countedlb
- minimal number of occurences of value at list.ub
- maximal number of occurences of value at list.
-
CountBounds
It constructs a CountBounds constraint.- Parameters:
list
- variables which equality to val is counted.value
- value which is countedlb
- minimal number of occurences of value at list.ub
- maximal number of occurences of value at list.
-
-
Method Details
-
impose
Description copied from class:Constraint
It imposes the constraint in a given store.- Overrides:
impose
in classPrimitiveConstraint
- Parameters:
store
- the constraint store to which the constraint is imposed to.
-
include
Description copied from interface:StoreAware
It provide store for constraints that are not imposed but called from other constraints.- Specified by:
include
in interfaceStoreAware
- Overrides:
include
in classPrimitiveConstraint
- Parameters:
store
- the constraint store in which context the constraint is executed.
-
getDefaultConsistencyPruningEvent
public int getDefaultConsistencyPruningEvent()- Specified by:
getDefaultConsistencyPruningEvent
in classConstraint
-
getDefaultNotConsistencyPruningEvent
protected int getDefaultNotConsistencyPruningEvent()- Specified by:
getDefaultNotConsistencyPruningEvent
in classPrimitiveConstraint
-
consistency
Description copied from class:Constraint
It is a (most probably incomplete) consistency function which removes the values from variables domains. Only values which do not have any support in a solution space are removed.- Specified by:
consistency
in classConstraint
- Parameters:
store
- constraint store within which the constraint consistency is being checked.
-
notConsistency
Description copied from class:PrimitiveConstraint
It makes pruning in such a way that constraint is notConsistent. It removes values which always belong to a solution.- Specified by:
notConsistency
in classPrimitiveConstraint
- Parameters:
store
- the constraint store in which context the notConsistency technique is evaluated.
-
swap
private void swap(int i, int j) -
satisfied
public boolean satisfied()Description copied from interface:SatisfiedPresent
It checks if the constraint is satisfied. It can return false even if constraint is satisfied but not all variables in its scope are grounded. It needs to return true if all variables in its scope are grounded and constraint is satisfied.Implementations of this interface for constraints that are not PrimitiveConstraint may require constraint imposition and consistency check as a requirement to work correctly.
- Returns:
- true if constraint is possible to verify that it is satisfied.
-
notSatisfied
public boolean notSatisfied()Description copied from class:PrimitiveConstraint
It checks if constraint would be always not satisfied.- Specified by:
notSatisfied
in classPrimitiveConstraint
- Returns:
- true if constraint must be notSatisfied, false otherwise.
-
toString
Description copied from class:Constraint
It produces a string representation of a constraint state.- Overrides:
toString
in classConstraint
-