Package org.jacop.core
Class SmallDenseDomain
java.lang.Object
org.jacop.core.Domain
org.jacop.core.IntDomain
org.jacop.core.SmallDenseDomain
- All Implemented Interfaces:
Cloneable
Defines small dense domain based on bits within a long number.
- Version:
- 4.8
-
Field Summary
FieldsModifier and TypeFieldDescriptionlong
It stores information about presence of the elements in the domain.static final SmallDenseDomain
It is an empty domain returned by default when empty domain becomes a result of any function.(package private) long
private static final Random
private int
int
The minimal value present in this domain encoding.private static final long[]
private boolean
private int
private static final long[]
Fields inherited from class org.jacop.core.IntDomain
ANY, BOUND, BoundDomainID, emptyIntDomain, eventsInclusion, GROUND, IntervalDomainID, MaxInt, MinInt, previousDomain, SmallDenseDomainID
Fields inherited from class org.jacop.core.Domain
failException, modelConstraints, modelConstraintsToEvaluate, NOINFO, NONE, searchConstraints, searchConstraintsCloned, searchConstraintsToEvaluate, stamp
-
Constructor Summary
ConstructorsConstructorDescriptionIt creates an empty domain.SmallDenseDomain
(int min, int max) It creates a domain with values between min and max inclusive.SmallDenseDomain
(int min, long bits) It creates a domain of type small dense. -
Method Summary
Modifier and TypeMethodDescriptionprivate void
adaptMin()
void
It adds values as specified by the parameter to the domain.It checks if the domain has correct state.void
clear()
It removes all elements.clone()
It clones the domain object.It clones the domain object, only data responsible for encoding domain values is cloned.It creates a complement of a domain.boolean
contains
(int value) It checks if value belongs to the domain.boolean
contains
(int min, int max) It checks if an interval min..max belongs to the domain.boolean
It specifies if the current domain contains the domain given as a parameter.int
domainID()
It returns an unique identifier of the domain.boolean
It specifies if the other int domain is equal to this one.int
getElementAt
(int index) It access the element at the specified position.getInterval
(int position) It returns required interval.It returns domain at earlier level at which the change has occurred.int
It returns a random value from the domain.int
getSize()
It returns the size of the domain.int
getSize
(long input) It computes the number of 1's in the binary representation of the number given in the field input.void
It updates the domain to have values only within the interval min..max.void
void
It updates the domain to have values only within the domain.void
inComplement
(int storeLevel, Var var, int complement) It updates the domain to not contain the value complement.void
inComplement
(int storeLevel, Var var, int minComplement, int maxComplement) It updates the domain so it does not contain the supplied interval.void
It updates the domain according to the maximum value and stamp value.void
It updates the domain according to the minimum value and stamp value.void
It updates the domain to contain the elements as specifed by the domain, which is shifted.intersect
(int min, int max) In intersects current domain with the interval min..max.It intersects current domain with the one given as a parameter.intersect
(IntervalDomain input, int shift) int
intersectAdapt
(int min, int max) It computes an intersection of this domain with an interval [min..max].int
intersectAdapt
(IntDomain domain) It computes an intersection with a given domain and stores it in this domain.It returns interval enumeration of the domain values.boolean
isEmpty()
It returns true if given domain is empty.boolean
isIntersecting
(int min, int max) It checks if interval min..max intersects with current domain.boolean
isIntersecting
(IntDomain domain) Checks if two domains intersect.boolean
It specifies if domain is a finite domain of numeric values (integers).boolean
It specifies if the domain type is more suited to representing sparse domain.int
leftElement
(int intervalNo) It returns the left most element of the given interval.int
max()
It returns the maximum value in a domain.int
min()
It returns the minimum value in a domain.int
nextValue
(int value) It gives next value in the domain from the given one (lexigraphical ordering).int
It returns number of intervals required to represent this domain.int
previousValue
(int value) It gives previous value in the domain from the given one (lexigraphical ordering).recentDomainPruning
(int storeLevel) It returns the values which have been removed at current store level.void
removeLevel
(int level, Var var) It removes the specified level.int
rightElement
(int intervalNo) It returns the right most element of the given interval.void
setDomain
(int min, int max) It sets this domain to contain exactly all values between min and max.void
It sets the domain to the specified domain.void
shift
(int shift) It shifts the domain.boolean
It returns true if given domain has only one element.boolean
singleton
(int c) It returns true if given domain has only one element equal c.int
It returns all constraints which are associated with variable, even the ones which are already satisfied.int
sizeOfIntersection
(IntDomain domain) It computes the size of the intersection between this domain and the domain supplied as a parameter.subtract
(int value) It intersects with the domain which is a complement of value.subtract
(int min, int max) It subtracts interval min..max.It subtracts domain from current domain and returns the result.void
subtractAdapt
(int value) It removes value from the domain.void
subtractAdapt
(int min, int max) It removes all values between min and max to the domain.toString()
It returns string description of the domain (only values in the domain).It returns string description of the constraints attached to the domain.It returns complete string description containing all relevant information about the domain.union
(int value) It computes union of this domain and value.union
(int min, int max) It computes union of this domain and the interval.It computes union of the supplied domain with this domain.void
unionAdapt
(int value) It adds a values to the domain.void
unionAdapt
(int min, int max) It adds all values between min and max to the domain.void
It adds interval of values to the domain.It returns value enumeration of the domain values.Methods inherited from class org.jacop.core.IntDomain
addInt, divBounds, divIntBounds, elementsSmallerThan, getEventsInclusion, in, inValue, lex, mulBounds, multiplyInt, noConstraints, putModelConstraint, putSearchConstraint, removeModelConstraint, removeSearchConstraint, removeSearchConstraint, singleton, squareBounds, subtractInt, toIntArray, unionAdapt, value
Methods inherited from class org.jacop.core.Domain
constraints, noSearchConstraints, searchConstraints, setStamp, sizeConstraints, stamp
-
Field Details
-
emptyDomain
It is an empty domain returned by default when empty domain becomes a result of any function. -
min
public int minThe minimal value present in this domain encoding. The domain can only encode small domains within a range [min .. min + 63]. -
bits
public long bitsIt stores information about presence of the elements in the domain. If the least significant bit is set then min + 63 is present. The most significant bit is always set as this domain maintains invariant that minimum value always belongs to the domain. -
singleton
private boolean singleton -
size
private int size -
max
private int max -
first8
long first8 -
TWO_N_ARRAY
private static final long[] TWO_N_ARRAY -
SEQ_ARRAY
private static final long[] SEQ_ARRAY -
generator
-
-
Constructor Details
-
SmallDenseDomain
public SmallDenseDomain()It creates an empty domain. -
SmallDenseDomain
public SmallDenseDomain(int min, long bits) It creates a domain of type small dense.- Parameters:
min
- the minimum value present in this domain.bits
- the bits representing presence of any value from the range [ min .. min + 63].
-
SmallDenseDomain
public SmallDenseDomain(int min, int max) It creates a domain with values between min and max inclusive.- Parameters:
min
- min element in the domainmax
- max element in the domain
-
-
Method Details
-
addDom
Description copied from class:IntDomain
It adds values as specified by the parameter to the domain. -
complement
Description copied from class:IntDomain
It creates a complement of a domain.- Specified by:
complement
in classIntDomain
- Returns:
- it returns the complement of this domain.
-
getPreviousDomain
Description copied from class:IntDomain
It returns domain at earlier level at which the change has occurred.- Specified by:
getPreviousDomain
in classIntDomain
- Returns:
- previous domain
-
contains
Description copied from class:IntDomain
It specifies if the current domain contains the domain given as a parameter. -
contains
public boolean contains(int value) Description copied from class:IntDomain
It checks if value belongs to the domain. -
eq
Description copied from class:IntDomain
It specifies if the other int domain is equal to this one. -
getElementAt
public int getElementAt(int index) Description copied from class:IntDomain
It access the element at the specified position.- Specified by:
getElementAt
in classIntDomain
- Parameters:
index
- the position of the element, indexing starts from 0.- Returns:
- the value at a given position in the domain.
-
getInterval
Description copied from class:IntDomain
It returns required interval.- Specified by:
getInterval
in classIntDomain
- Parameters:
position
- the position of the interval.- Returns:
- the interval, or null if the required interval does not exist.
-
getSize
public int getSize()Description copied from class:IntDomain
It returns the size of the domain. -
getSize
public int getSize(long input) It computes the number of 1's in the binary representation of the number given in the field input.- Parameters:
input
- the 64bits for which calculation of number of 1's takes place.- Returns:
- the number of 1's.
-
in
It updates the domain to have values only within the interval min..max. The type of update is decided by the value of stamp. It informs the variable of a change if it occurred. -
adaptMin
private void adaptMin() -
in
-
in
Description copied from class:IntDomain
It updates the domain to have values only within the domain. The type of update is decided by the value of stamp. It informs the variable of a change if it occurred. -
inComplement
Description copied from class:IntDomain
It updates the domain to not contain the value complement. It informs the variable of a change if it occurred.- Overrides:
inComplement
in classIntDomain
- Parameters:
storeLevel
- level of the store at which the update occurs.var
- variable for which this domain is used.complement
- value which is removed from the domain if it belonged to the domain.
-
inComplement
Description copied from class:IntDomain
It updates the domain so it does not contain the supplied interval. It informs the variable of a change if it occurred.- Specified by:
inComplement
in classIntDomain
- Parameters:
storeLevel
- level of the store at which the update occurs.var
- variable for which this domain is used.minComplement
- the left bound of the interval (inclusive).maxComplement
- the right bound of the interval (inclusive).
-
inMax
Description copied from class:IntDomain
It updates the domain according to the maximum value and stamp value. It informs the variable of a change if it occurred. -
inMin
Description copied from class:IntDomain
It updates the domain according to the minimum value and stamp value. It informs the variable of a change if it occurred. -
inShift
Description copied from class:IntDomain
It updates the domain to contain the elements as specifed by the domain, which is shifted. E.g. {1..4} + 3 = 4..7 -
intersect
-
intersect
Description copied from class:IntDomain
It intersects current domain with the one given as a parameter. -
intersect
Description copied from class:IntDomain
In intersects current domain with the interval min..max. -
intersectAdapt
Description copied from class:IntDomain
It computes an intersection with a given domain and stores it in this domain.- Specified by:
intersectAdapt
in classIntDomain
- Parameters:
domain
- domain with which the intersection is being computed.- Returns:
- type of event which has occurred due to the operation.
-
intersectAdapt
public int intersectAdapt(int min, int max) Description copied from class:IntDomain
It computes an intersection of this domain with an interval [min..max]. It adapts this domain to the result of the intersection.- Specified by:
intersectAdapt
in classIntDomain
- Parameters:
min
- the minimum value of the interval used in the intersection computation.max
- the maximum value of the interval used in the intersection computation.- Returns:
- it returns information about the pruning event which has occurred due to this operation.
-
intervalEnumeration
Description copied from class:IntDomain
It returns interval enumeration of the domain values.- Specified by:
intervalEnumeration
in classIntDomain
- Returns:
- intervalEnumeration which can be used to enumerate intervals in this domain.
-
isIntersecting
Description copied from class:IntDomain
Checks if two domains intersect.- Overrides:
isIntersecting
in classIntDomain
- Parameters:
domain
- the domain for which intersection is checked.- Returns:
- true if domains are intersecting.
-
isIntersecting
public boolean isIntersecting(int min, int max) Description copied from class:IntDomain
It checks if interval min..max intersects with current domain.- Specified by:
isIntersecting
in classIntDomain
- Parameters:
min
- the left bound of the interval.max
- the right bound of the interval.- Returns:
- true if domain intersects with the specified interval.
-
leftElement
public int leftElement(int intervalNo) Description copied from class:IntDomain
It returns the left most element of the given interval.- Overrides:
leftElement
in classIntDomain
- Parameters:
intervalNo
- the interval number.- Returns:
- the left bound of the specified interval.
-
max
public int max()Description copied from class:IntDomain
It returns the maximum value in a domain. -
min
public int min()Description copied from class:IntDomain
It returns the minimum value in a domain. -
nextValue
public int nextValue(int value) Description copied from class:IntDomain
It gives next value in the domain from the given one (lexigraphical ordering). If no value can be found then returns the same value. -
noIntervals
public int noIntervals()Description copied from class:IntDomain
It returns number of intervals required to represent this domain.- Specified by:
noIntervals
in classIntDomain
- Returns:
- the number of intervals in the domain.
-
previousValue
public int previousValue(int value) Description copied from class:IntDomain
It gives previous value in the domain from the given one (lexigraphical ordering). If no value can be found then returns the same value.- Specified by:
previousValue
in classIntDomain
- Parameters:
value
- before which a value is seeked for.- Returns:
- it returns the value before the one specified as a parameter.
-
recentDomainPruning
Description copied from class:IntDomain
It returns the values which have been removed at current store level.- Specified by:
recentDomainPruning
in classIntDomain
- Parameters:
storeLevel
- the current store level.- Returns:
- emptyDomain if domain did not change at current level, or the set of values which have been removed at current level.
-
rightElement
public int rightElement(int intervalNo) Description copied from class:IntDomain
It returns the right most element of the given interval.- Overrides:
rightElement
in classIntDomain
- Parameters:
intervalNo
- the interval number.- Returns:
- the right bound of the specified interval.
-
setDomain
Description copied from class:IntDomain
It sets the domain to the specified domain. -
setDomain
public void setDomain(int min, int max) Description copied from class:IntDomain
It sets this domain to contain exactly all values between min and max. -
singleton
public boolean singleton(int c) Description copied from class:IntDomain
It returns true if given domain has only one element equal c. -
sizeOfIntersection
Description copied from class:IntDomain
It computes the size of the intersection between this domain and the domain supplied as a parameter.- Overrides:
sizeOfIntersection
in classIntDomain
- Parameters:
domain
- the domain with which the intersection is computed.- Returns:
- the size of the intersection.
-
subtract
Description copied from class:IntDomain
It intersects with the domain which is a complement of value. -
subtract
Description copied from class:IntDomain
It subtracts domain from current domain and returns the result. -
subtractAdapt
public void subtractAdapt(int min, int max) Description copied from class:IntDomain
It removes all values between min and max to the domain.- Specified by:
subtractAdapt
in classIntDomain
- Parameters:
min
- the left bound of the interval being removed.max
- the right bound of the interval being removed.
-
subtract
Description copied from class:IntDomain
It subtracts interval min..max. -
subtractAdapt
public void subtractAdapt(int value) Description copied from class:IntDomain
It removes value from the domain. It adapts current (this) domain.- Specified by:
subtractAdapt
in classIntDomain
- Parameters:
value
- the value for which the complement is computed
-
union
Description copied from class:IntDomain
It computes union of the supplied domain with this domain. -
union
Description copied from class:IntDomain
It computes union of this domain and the interval. -
union
Description copied from class:IntDomain
It computes union of this domain and value. -
unionAdapt
Description copied from class:IntDomain
It adds interval of values to the domain.- Overrides:
unionAdapt
in classIntDomain
- Parameters:
i
- Interval which needs to be added to the domain.
-
unionAdapt
public void unionAdapt(int min, int max) Description copied from class:IntDomain
It adds all values between min and max to the domain.- Specified by:
unionAdapt
in classIntDomain
- Parameters:
min
- the left bound of the interval being added.max
- the right bound of the interval being added.
-
unionAdapt
public void unionAdapt(int value) Description copied from class:IntDomain
It adds a values to the domain.- Overrides:
unionAdapt
in classIntDomain
- Parameters:
value
- value being added to the domain.
-
valueEnumeration
Description copied from class:IntDomain
It returns value enumeration of the domain values.- Specified by:
valueEnumeration
in classIntDomain
- Returns:
- valueEnumeration which can be used to enumerate one by one value from this domain.
-
checkInvariants
Description copied from class:Domain
It checks if the domain has correct state.- Specified by:
checkInvariants
in classDomain
- Returns:
- null if everything is ok, otherwise a string describing the problem.
-
clear
public void clear()Description copied from class:Domain
It removes all elements. -
clone
Description copied from class:Domain
It clones the domain object. -
domainID
public int domainID()Description copied from class:Domain
It returns an unique identifier of the domain. -
isEmpty
public boolean isEmpty()Description copied from class:Domain
It returns true if given domain is empty. -
isNumeric
public boolean isNumeric()Description copied from class:Domain
It specifies if domain is a finite domain of numeric values (integers). -
isSparseRepresentation
public boolean isSparseRepresentation()Description copied from class:Domain
It specifies if the domain type is more suited to representing sparse domain.- Specified by:
isSparseRepresentation
in classDomain
- Returns:
- true if sparse, false otherwise.
-
cloneLight
It clones the domain object, only data responsible for encoding domain values is cloned. All other fields must be set separately.- Specified by:
cloneLight
in classIntDomain
- Returns:
- It returns a clone of this domain.
-
removeLevel
Description copied from class:Domain
It removes the specified level. This function may re-instantiate the old copy of the domain (previous value) or recover from changes done at stamp level to get the previous value at level lower at provided level.- Specified by:
removeLevel
in classDomain
- Parameters:
level
- the level which is being removed.var
- the variable to which this domain belonged to.
-
singleton
public boolean singleton()Description copied from class:Domain
It returns true if given domain has only one element. -
sizeConstraintsOriginal
public int sizeConstraintsOriginal()Description copied from class:Domain
It returns all constraints which are associated with variable, even the ones which are already satisfied.- Specified by:
sizeConstraintsOriginal
in classDomain
- Returns:
- the number of constraints attached to the original domain of the variable associated with this domain.
-
toString
Description copied from class:Domain
It returns string description of the domain (only values in the domain). -
toStringConstraints
Description copied from class:Domain
It returns string description of the constraints attached to the domain.- Specified by:
toStringConstraints
in classDomain
- Returns:
- the string description.
-
toStringFull
Description copied from class:Domain
It returns complete string description containing all relevant information about the domain.- Specified by:
toStringFull
in classDomain
- Returns:
- complete description of the domain.
-
getRandomValue
public int getRandomValue()Description copied from class:IntDomain
It returns a random value from the domain.- Overrides:
getRandomValue
in classIntDomain
- Returns:
- random value.
-
contains
public boolean contains(int min, int max) Description copied from class:IntDomain
It checks if an interval min..max belongs to the domain. -
shift
public void shift(int shift) It shifts the domain.- Parameters:
shift
- how much should the domain be shifted.
-
toIntervalDomain
-