Introduction to Regions


Regions are lists of nodes/elements that can be used for setting properties of all the listed entities at once. Simply replace the node or element number by the region name. This works for all property setting functions. Obviously, for reading values it is useless and it will trigger an error.

The region has to be created prior to being used and the type of the entities must be specified. The types are

but the last one is just a nodal region that can be used only to set gates. The type is specified as a string, but only the first letter (converted to uppercase) is used. The letters are "E", "N" and "G", but type as much as you want. "E", "elem", "Elements" or "Element ReGION" are all the same for LIMS.

The region type has to match that required for the command. If the command adds/substracts data from an existing region, both the type of that region and the type of additional data must match.

Thus, one may now do

REGCREATE "bottom","elems",1,2,3,4,5,6,7,8,9,10,11,12,13,14
SCALEPERM("bottom",10)


The region management uses the following commands

REGCREATE "name","type",i1,i2....

Creates a region with name "name" and type given by the first letter in "type".

REGAPPEND "name","type",i1,i2....

Creates a region with name "name" and type given by the first letter in "type".

REGEXCLUDE "name","type",i1,i2....

Searches for a region with name "name" and type given by the first letter in "type". If found, entities i1, i2 ... are removed from the list. If entity is not already on the list, nothing happens.

REGREMOVE "Wildcard"

Removes any region whose name matches the wildcard string. Wildcards are really simplistic. Star expands into any string. Thus "*" matches all.

REGIONS Wildcard

Directive that will list the defined regions and their type. Wildcards as above, otherwise like WORDS ore VARS.

REGSAVE "FileName","Wildcard",Append

Saves all regions matching "Wildcard" into file "FileName". If Append is non-zero, existing file is appended to, otherwise it is truncated.

REGLOAD "FileName","Wildcard",Append

Loads all regions matching "Wildcard" from file "FileName" to the active region list. If Append is non-zero, existing file is appended to existing regions, otherwise those are erased first.