relaxi
relaxi is relax with an index progression in place of the regions. The i means the command takes a progression. It does not mean inverse.
Syntax
relaxi i_list ; j_list ; k_list ; iterations min_change weight
A progression is three lists, one for i, one for j and one for k, each ending in ;. An empty list means the whole range. Inside a progression a 0 separates unions and never means an extreme. The concepts chapter explains progressions. The three numbers are those of relax.
What it does
James expands the progression into regions and applies relax to each one on its own: unlike a relax list joined by &, the regions are not smoothed as one system, so a face and a block may sit in one progression. relax describes the smoothing.
When James applies it
As relax: step 11 for each face and step 17 for each block the progression expands to. One relaxi may therefore act at both steps. relaxi is legal only in the Part phase.
Rules James adds
- A region that the progression expands to and that is an edge or a vertex is an error (E1300).
- A progression that expands to no region warns (E0107) and the command is ignored; its three numbers are still read and checked.
- Only
relaxtakes a list. A&where the three numbers should begin is an error (E0104), and a&after them is read as a word James does not know (E0105).
Diagnostics
- E1300: a region the progression expands to is an edge or a vertex.
- E1302: the iteration count is missing or is not a positive integer.
- E1303:
min_changeis negative. - E1304: the weight is not above 0 and at most 1.
- E0104: the progression,
min_changeor the weight is missing or not a number, or a&stands where the numbers should begin. - E0105: a
&follows the three numbers. - E0101: a list holds one positive number, which selects nothing, and James warns.
- E0102: a reduced index lies outside the part.
- E0103: an interval is written high to low.
- E0107: the progression expands to no region.
Example
The script tests/corpus/203-relaxi-face-and-block/input.tg, which make test runs:
c relaxi smooths each member of its progression on its own: the top
c face at step 11 and the block at step 17
block 1 5 9;1 5 9;1 5;0 1 2;0 1 2;0 1;
relaxi ;;-2 0 1 2; 20 .001 1
endpart
The k-list -2 0 1 2 pins k at 2 and adds the interval from 1 to 2, so the progression expands to the top face 1 1 2 3 3 2 and the block 1 1 1 3 3 2. James stores both in one row, smooths the face at step 11 and the block at step 17, each on its own, for at most 20 iterations.