tmei
tmei is tme with an index progression in place of the region. The i means the command takes a progression. It does not mean inverse.
Syntax
tmei 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 tme.
What it does
James expands the progression into regions and applies tme to each one on its own. tme describes the smoothing.
When James applies it
As tme: step 12 for each face and step 18 for each block the progression expands to. tmei 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 region the progression expands to that holds a deleted element is an error (E1305), as for
tme. - A progression that expands to no region warns (E0107) and the command is ignored; its three numbers are still read and checked.
- 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.
- E1305: a region the progression expands to holds a deleted element.
- 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/205-tmei-face-and-block/input.tg, which make test runs:
c tmei with a face and a block in one progression holds steps 12 and 18
block 1 5 9;1 5 9;1 5;0 1 2;0 1 2;0 1;
tmei ;;-1 0 1 2; 5 .01 .75
endpart
The progression expands to the bottom face 1 1 1 3 3 1 and the block 1 1 1 3 3 2. James smooths the face at step 12 and the block at step 18, each on its own, for at most five iterations, each node moving three quarters of the way to its new position in each iteration.