**elset

Description

This command creates an element set according to various input data. If the element set already exists, new elements will simply be added. Elements will be included in the set only once.

Syntax

The elset command takes a variety of options to specify the elements to be added (and each of them may be specified more than once):

**elset name \(~\,\) [ *add_elset eset1  …  esetN ] \(~\,\) [ *allow_partial ] \(~\,\) [ *attached_to_nodes \(id_1\) … \(id_N\) ] \(~\,\) [ *attached_to_nset nset1  …  nsetN ] \(~\,\) [ *elements \(id_1\) … \(id_N\) ] \(~\,\) [ *func function ; ] \(~\,\) [ *not_in_elsets eset1  …  esetN ] \(~\,\) [ *remove_elset eset1  …  esetN ] \(~\,\) [ *sequence start_id  end_id [ increment ] ] \(~\,\) [ *use_elsets eset1  …  esetN ]

where the options can be taken from the following:

*add_elset

Adds all the elements in the named (pre-existing) element sets.

*allow_partial

Indicates that a function describing element node positions for the elset is true if one or more of the nodes meet the given function criteria. By default, all nodes must fit the equation.

*attached_to_nodes

indicates that all elements attached to nodes with the given ids are to be added to the elset.

*attached_to_nset

indicates that all elements attached to nodes within the given nset names are to be added to the elset.

*elements

Enter element ids in directly. Non-existing element ids will be silently ignored.

*func

Enter a function which is used to select the elements. The function should be a chain of multiplied boolean expressions in the coordinate space (see example below).

*not_in_elsets

will add the complement to the given element sets as a new elset. Not compatible with other options such as *func and so on.

*remove_elset

will remove the elements of the given element sets from the list of currently added elements. This operation is executed after all other **elset subcommands.

*sequence

will add a sequence of elements from start_id to end_id with increment increment (Z-set 8.4 and newer). The latter can be negative, but in that case, start_id should be greater than end_id. If this is not the case, -increment will be used instead. If increment is omitted, a default value of 1 is used. Non-existing element ids generated with this command will be silently ignored.

*use_elsets

use only the elements in the named element sets to check the given function against. The default is to use all elements in the mesh.

Example

Here is an example of how to use this command.

% Shows the use of functions
  **elset front
   *func x>0.0;
  **elset bottom
   *func y<0.0;
  **elset look
   *func (y<0.0)*(z>20.0);
   *allow_partial

% Creates/adds to the elset "first_10" with elements 1 through 10
% (better use the *sequence command)
  **elset first_10
   *elements 1 2 3 4 5 6 7 8 9 10

% Creates/adds to the elset "sequence_example" with elements
% 1 4 29 30 32 34 ... 48 50 53
  **elset sequence_example
   *elements 1 4 29
   *sequence 30 50 2
   *elements 53

% Creates/adds to the elset "inverse_sequence" with elements
% 50 48 46 ... 32 30
  **elset inverse_sequence
   *sequence 50 30 -2

% Creates/adds to the elset "twice" with elements 1 through 15
  **elset twice
   *sequence 1 10
  **elset twice
   *sequence 5 15