enq

   'enq' <set> <set> ['set' <setname> ]|->
            ['rec' <x-value>|'_' <y-value>|'_' <z-value>|'_' ]|->
            ['cx'|'cy'|'cz' <r-value>|'_' <fi-value(deg)>|'_' ->
              <axis-value>|'_' ] -> 
             <tol> 'i'|'a'|'h'|'l' [<value>]
This command is used to locate entities from a certain set (first provided set) and stores them in the second set. The following entities are handled: nodes, points, lines, surfaces. But surfaces can only be identified if the command “rep <setname>” was issued before. In case of nodes with related values (results) it will also determine the highes or lowest value in the specified range, or, all nodes above or below a certain value. The coordinates might be taken from one node or point in a given 3rd set or given in cartesian coordinates (option rec) or cylindrical coordinates (option cx, cy, cz). Some coordinates might be omitted to specify an infinite range. The '_' key has to be used in this case. The mode is defined by the keys 'i' individual, 'a' all, 'h' high, 'l' low, were h and l will search the highest or lowest value in range. This value will also be written to a file for automatic processing purposes. For example

enq all newset rec 10. _ 100. 0.1 i

will search for entities in set 'all' at the given location x:10. y:_(infinite range, triggered by the '_' key) z:100. with a tolerance of 0.1 and only the closest entity of all kinds of entities are stored in set 'newset', triggered by the 'i' key. With the 'a' key all in range would be stored. The key 'h' or 'l' would trigger a search for the highest or lowest value in the specified range.

In combination with a certain value

enq all newset rec 10. _ 100. 0.1 h 1013.

all nodes with a value above “1013.” would be stored in set “newset”. The command

enq domain1 newset cx 100. 180. 10. 0.1 a

will search for entities in set 'domain1' at radius:100. around x at fi:180 degree and x:10. with a tolerance of 0.1. All entities in range are stored in set 'newset'.

The following example illustrates the use of “enq” to find the highest value close to a location given by a node-number:

# activate dataset 3 with entity 7:
ds 3 e 7
# read a file with one node to define a set:
read pos1.frd pos1
# search the highest value around a radius of 1:
enq all t set pos1 1. h
# move the file with the search result to a meaningfull name:
sys mv enq_lc3_e7_1.out pos1.out

One important remark: The command will select not only nodes in the selection range but also geometric entities (lines etc.) which in turn reference their related nodes. This behaviour can mix up the desired result when the user expects to find just nodes in the selection range. Therefore it is better to first generate a set only with nodes as a basis for 'enq':

seta nodeset n all
enq nodeset new ...

The command writes to the ”stack”.