Global Constraint Catalog: Crange

5.330. range_ctr

DESCRIPTION

LINKS

GRAPH

Origin

Arithmetic constraint.

Constraint

$𝚛𝚊𝚗𝚐𝚎_𝚌𝚝𝚛 (𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂, 𝙲𝚃𝚁, 𝚁)$

Arguments

$𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂$	$𝚌𝚘𝚕𝚕𝚎𝚌𝚝𝚒𝚘𝚗 (𝚟𝚊𝚛 - 𝚍𝚟𝚊𝚛)$
$𝙲𝚃𝚁$	$𝚊𝚝𝚘𝚖$
$𝚁$	$𝚍𝚟𝚊𝚛$

Restrictions

| 𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂 | > 0

𝚛𝚎𝚚𝚞𝚒𝚛𝚎𝚍

(𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂, 𝚟𝚊𝚛)

𝙲𝚃𝚁 \in [=, \neq, <, \geq, >, \leq]

Purpose

Constraint the difference between the maximum value and the minimum value of a set of domain variables. More precisely, let $𝚁𝙰𝙽𝙶𝙴$ denote the difference between the largest and the smallest variables of the $𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂$ collection plus one. Enforce the following constraint to hold: $𝚁𝙰𝙽𝙶𝙴 𝙲𝚃𝚁 𝚁$ .

Example

(〈1, 9, 4〉, =, 9)

The $𝚛𝚊𝚗𝚐𝚎_𝚌𝚝𝚛$ constraint holds since $max (1, 9, 4) - min (1, 9, 4) + 1$ is equal (i.e., $𝙲𝚃𝚁$ is set to $=$ ) to its last argument $𝚁 = 9$ .

Figure 5.330.1. Illustration of the Example slot: three variables respectively fixed to values 1, 9 and 4, and their corresponding range $𝚁 = 9$

Typical

| 𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂 | > 1

𝚛𝚊𝚗𝚐𝚎

(𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂 . 𝚟𝚊𝚛) > 1

𝙲𝚃𝚁 \in [=, <, \geq, >, \leq]

Symmetries

Items of $𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂$ are permutable.
All occurrences of two distinct values of $𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂 . 𝚟𝚊𝚛$ can be swapped.
One and the same constant can be added to the $𝚟𝚊𝚛$ attribute of all items of $𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂$ .

Arg. properties

Contractible wrt. $𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂$ when $𝙲𝚃𝚁 \in [<, \leq]$ .
Extensible wrt. $𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂$ when $𝙲𝚃𝚁 \in [\geq, >]$ .

Used in

$𝚜𝚑𝚒𝚏𝚝$ .

Keywords

characteristic of a constraint: range.

constraint type: arithmetic constraint.

Arc input(s)

$𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂$

Arc generator

𝑆𝐸𝐿𝐹

\mapsto 𝚌𝚘𝚕𝚕𝚎𝚌𝚝𝚒𝚘𝚗 (𝚟𝚊𝚛𝚒𝚊𝚋𝚕𝚎𝚜)

Arc arity

Arc constraint(s)

𝚃𝚁𝚄𝙴

Graph property(ies)

𝐑𝐀𝐍𝐆𝐄

(𝚅𝙰𝚁𝙸𝙰𝙱𝙻𝙴𝚂, 𝚟𝚊𝚛) 𝙲𝚃𝚁 𝚁

Graph model

Since we want to keep all the vertices of the initial graph we use the $𝑆𝐸𝐿𝐹$ arc generator together with the $𝚃𝚁𝚄𝙴$ arc constraint. This predefined arc constraint always holds.

Parts (A) and (B) of Figure 5.330.2 respectively show the initial and final graph associated with the Example slot. Since we use the $𝚃𝚁𝚄𝙴$ arc constraint both graphs are identical.

Figure 5.330.2. Initial and final graph of the $𝚛𝚊𝚗𝚐𝚎_𝚌𝚝𝚛$ constraint


(a)	(b)

Global Constraint Catalog

5. Global Constraint Catalogue

5.330. range_ctr

Figure 5.330.1. Illustration of the Example slot: three variables respectively fixed to values 1, 9 and 4, and their corresponding range 𝚁=9

Figure 5.330.2. Initial and final graph of the 𝚛𝚊𝚗𝚐𝚎_𝚌𝚝𝚛 constraint

Figure 5.330.1. Illustration of the Example slot: three variables respectively fixed to values 1, 9 and 4, and their corresponding range $𝚁 = 9$

Figure 5.330.2. Initial and final graph of the $𝚛𝚊𝚗𝚐𝚎_𝚌𝚝𝚛$ constraint