mate

mate sets the default material number of a part: the number every element of the part carries unless an mt or mti region covers it.

Syntax

mate material_number

material_number is a positive integer. It is a label the files carry; it need not name any material model.

What it does

In the Control phase, mate sets the default that every part opened after it starts from. Inside a part, mate sets that part’s own default, which wins over the Control-phase one. The last mate of a phase is the one that counts. A part opened before any mate has material 1.

A material number reaches every file James writes. The neutral file carries it on each element line, the Exodus II file groups each part’s elements into one block per material, and the three solver decks carry it per element with a placeholder material card per number. The merge and output chapter describes each layout.

When James applies it

When it builds the part: the default fills the part’s elements first, and the mt and mti rows then overwrite their regions in input order, wherever mate stood among them. mate is legal in the Control and Part phases.

Rules James adds

  • A Control-phase mate applies to the parts opened after it, not to parts already closed.
  • A mate written after an mt in the same part changes the default and leaves the region’s number alone: mate is the base layer, mt and mti the overrides.
  • The default of a part no mate touched is 1.

Diagnostics

  • E1200: the number is missing, is not an integer, is below 1, or is above 2147483647.
  • E0412: mate in the Merge phase.

Example

The script tests/corpus/182-mate-global-and-local/input.tg, which make test runs:

block 1 2;1 2;1 2;0 1;0 1;0 1;
endpart
mate 3
block 1 2;1 2;1 2;2 3;0 1;0 1;
endpart
block 1 2;1 2;1 2;4 5;0 1;0 1;
mate 4
endpart

The first part closes before any mate, so it keeps material 1. The mate 3 in the Control phase gives the second part material 3. The third part starts from 3 and its own mate 4 wins, so it has material 4. The IR dump shows mate 1, mate 3 and mate 4 on the three part lines.

See also

  • mt: a material for a region of the part.
  • mti: the same with an index progression.
  • Merge and output: where the material goes in each file.

James 0.8.0.

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