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 relax takes 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_change is negative.
  • E1304: the weight is not above 0 and at most 1.
  • E0104: the progression, min_change or 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.

See also

  • relax: the base command, and the list of faces smoothed as one system.
  • tmei: the Thomas-Middlecoff smoother with a progression.
  • Concepts: progressions and the i suffix.

James 0.8.0.

This site uses Just the Docs, a documentation theme for Jekyll.