enq

   'enq' <set> <set> ['set' <setname> ]| -> 
            ['rec' <x-value>|'_' <y-value>|'_' <z-value>|'_' ]| ->
            ['cyl' 'x'|'y'|'z' <r-value>|'_' <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 cyl). 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 cyl x 100. 10. 0.1 a

will search for entities in set 'domain1' at radius:100. around x at 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