Assign
- Last UpdatedJul 06, 2023
- 3 minute read
Use the functionality to specify the tests and order in which they are to be performed during automatic assignment of an owner discipline to a clash.
The tests can check the relative priority, class and/or discipline of each element of pairs of clashing elements. The tests can also check a number of discipline assignment rules. The testing process proceeds test-by-test until a result indicates the owner discipline of the clash. The testing process then assigns the owner discipline to that clash and continues by testing the next clash.
In the priority and class tests, the owner discipline is set to the element with the higher order. These orders are as set at the priority and class tabs, respectively.
The element discipline test is normally the last of the sequence and consequently is used when none of the other tests have produced an owner discipline. If the discipline of each clashing element is the same, that discipline is set as the owner. If the disciplines are different, the discipline default (as set at the Discipline) is used. Typically, this is UNALLOCATED.
Each rule in the discipline assignment rules consists of a number of rule expressions'. Rule expressions, which are formed of certain keywords, literals and regular expressions (wildcards), refer to Notes on Rules and Rule Expressions for further information. The first discipline with a rules whose rule expressions all evaluate true becomes the owner discipline, by default. Alternatively a set discipline keyword operator may be used in a rule expression to assign the owner discipline to that of one element or the other, or even to a third unrelated discipline.
A comment is created showing details of the discipline assigned and the rule which matched is automatically attached to the clash and/or clash group record. This comment appears in the Comments section of the Clash Report and on the Comments tab of the Clash Group Properties window.
Note:
Assignment rules may be complicated and time-consuming to develop. A simple method
of testing is available to avoid a (very lengthy) re-computation option, which may
reveal further modifications to the rules are required. The test facilities are available
at the Clash Manager -Test Rules window, which is accessed by selecting Test. The new configuration does not need to be saved prior to using the test facilities.
The names and purposes of the items on the tab are as follows:
|
Order of Application |
For selecting which tests are to be performed and the order (from top to bottom) in which they are carried out. The check box against the test is checked, if the test is to be part of the sequence. The records show the name of the tests. Assignment Rules means Apply the Discipline Assignment Rules. |
|
Up and Down |
For setting the sequence of records as displayed from top to bottom of the pane and hence the sequence of the tests. |
Discipline Assignment Rules pane containing:
|
Discipline Assignment Rules pane showing a hierarchy with Discipline as the primary nodes which, when expanded, display the applicable Assignment Rules |
When an assignment rule is highlighted, its rule syntax is shown in the lower pane. A Popup menu is available (mouse right-click) with options of Edit, Add and Delete. This is used to edit an existing rule name, add a new rule, or remove an existing rule. |
|
Up and Down |
These are used to reposition the highlighted rule in the hierarchy and hence determine the sequence (from top to bottom) in which the rules are applied. |
|
Test |
Displays the Test Rules. |
|
Lower pane showing a list of Rule Expressions under Element, Attribute and Value headings |
The listing shows the syntax of the assignment rule that is highlighted in the upper pane. Popup menus (mouse right-click) are available from the three components of the Rule Expressions. Note: |
|
The Element Popup Menu options are: Editing options - @element-1, @element-2, @general Add Rule Delete |
|
|
The Attribute Popup Menu options are: Editing options - @discipline, @class, @priority, etc, and @gtype Edit - leads to in-place editing options box Add Rule Delete |
|
|
The Value Popup Menu options are: Edit - leads to list-of-values Add Rule Delete PML functions can be used as a rule to assign clash discipline or accept clashes. Refer to PML Assign/Accept Rules for further information. |