Icon
Related news and articles
Using
To use the plugin, select an existing configuration or create a new one. To create a new configuration, click 
The selected configuration can be renamed by typing the name in the text field with the tooltip "Enter configuration name", duplicated by pressing 
button or deleted by pressing 
button:
Duplicate configurations are only available in the full version of the plugin.
Each configuration contains a set of strategies. The strategies differ in the algorithm of element processing. Clicking the Add Strategy button displays a dialog box with a list of available strategies with a short description:
The strategy list has a checkbox to disable/enable the strategy, a system strategy name, a custom strategy name, as well as buttons to duplicate and delete .png)
strategies, which are displayed on mouseover:
Duplicate strategies are only available in the full version of the plugin.
Strategies of the current configuration can be exported to Excel by clicking the Export button and imported from Excel by clicking the Import button.
At the bottom left of the plugin window are buttons that allow you to check all strategies in the current configuration 
, uncheck all checkboxes 
, and delete all strategies in the current configuration 
.
When a strategy is selected, its contents are displayed on the right side of the plugin window, including a text box for entering a custom name, a description of the strategy, a table of rules:
For some strategies there may be general settings, which are located in the settings panel, called by pressing the appropriate button in the upper right corner of the window:
Each strategy consists of rules. A rule specifies ways to filter processed items and the formula applied to the processed items. Element filters by category and parameters are used to filter elements. Depending on the strategy, a rule can contain filters for conditionally source elements (for InHost strategy these are Host elements, for InGroup strategy these are groups, for SolidTouch strategy these are touched elements, etc.). Also, depending on the strategy, filters by category can be absent.
To add a rule to the table use . To delete selected rules use , and to duplicate selected rules use .
Duplicate rules are only available in the full version of the plugin.
The rules of the current strategy can be copied to clipboard 
and pasted from clipboard 
both in the current strategy and in the other strategies.
Rules of the current strategy can be exported to Excel by pressing 
or imported from Excel by pressing 
.
All strategy rules can be checked with and unchecked from all selected rules by pressing .
Rules in the list can be moved with the mouse. After you have moved the rules, you can renumber them according to their position in the table by clicking 
.
Each rule can be excluded from work by unchecking the checkbox in the corresponding cell in the table.
Double-clicking in the Formula cell or in the Formula options cell opens the formula editor:
At the top of the formula editor is a link that, when clicked, opens detailed instructions for the formula editor:
The formula consists of expressions, which allows to perform several calculations to elements that match the filtering criteria of the parent rule. In addition to expressions the formula contains several options:
- Tolerance - sets the tolerance that is used when comparing numeric values. For example, if the tolerance is set to 0.1, the condition "10.05 = 10.06" will be considered true.
- Case sensitive - specifies the rule for comparing string values: whether to compare them case-sensitive or not.
- Write empty result - specifies whether to write an empty result, obtained by calculating the expression, to the target parameter. For string parameters an empty result is an empty string. For numeric parameters an empty result is value 0.
- Dissociate - allows to remove the association of the target parameter with the global project parameter, if there is an association.
There are auxiliary buttons to the right of the formula editing field:
is used to add a target element parameter to the formula. The parameter list is available if two conditions are met: 1. At least one category is specified in the target element filter; 2. The model has at least one instance of the element of the specified categories. If both conditions are not met, the button will be inactive.
is used to add conditional source element parameters to the formula. The parameter list is available if two conditions are met: 1. At least one category is specified in the conditional source element filter; 2. There is at least one instance of the element of the specified categories in the model. If both conditions are not met, the button will be inactive. If the parent strategy does not assume a conditional source element, the button will not be displayed.
is used to add an arithmetic or conditional function to a formula.
In the plugin settings window there is a button Mapping function names, which opens a window where you can define your own names for the functions in the formula editor:
Figure 13
On the right side of the formula editor window are Fields, allowing you to replace parts of formulas with keys. Fields can be inserted into each other.
To add a new field, click the button on the right side of the window or select part of the formula in the editor field and, by right-clicking, select Create field.
When hovering over the field, commands become available to duplicate the field , remove the field , add the field 
or remove the field 
from the list of favorite fields. The button 
on the right side of the window opens an editor from which you can insert selected favorite fields (you can select them with Ctrl or Shift) into the list of fields of the current formula. This editor can also be opened from the plugin settings window to edit existing or add new favorite fields. Fields from the list of favorite fields can be used in formulas of other rules and you can update field values in all rules of all configurations 
:
When you hover your cursor over a Formula cell, a button appears that allows you to show/hide the formula in the list of rules:
Before starting parametrization on the current configuration it is necessary to specify the option of element selection:
Each selection option has nuances depending on the strategies:
Process picked elements. If there is a Types strategy, only the types of the selected elements will be processed. If there is a strategy in which elements within other elements are processed (InRoom, InSolid, InMass, etc.), all elements must be selected, not only parent elements.
Process elements on current View. Recommended option! If there is a Types strategy, the element types on the current View will be processed. For some strategies, it is important to consider the current View. For example, InRoom strategy will not work in 3D View, because rooms have no geometry in 3D View. You should also take into account that the level of detail of the current View can affect the result of geometry-related strategies (InRoom, InSolid, SolidTouch, etc.).
Process elements in Document. If there is a Types strategy, all document types will be processed. For strategies that work with the geometry of elements (such as InRoom, InSolid, SolidTouch, etc.) is not recommended to use this selection option, since the elements will be taken geometry that does not take into account the interaction with other elements, which may lead to incorrect results.
To start the parameterization, click Execute and wait for the results.
WORK WITH GEOMETRY
For the strategies InRoom, InSpace, InMass, InSolid there is an opportunity to choose one of the two algorithms for determining the entry of solids:
Identification of the entry is performed through auxiliary rays dropped from the centroid of the solid of the target element in 4 directions in the XY plane. If all 4 rays intersect the solid of the parent element, the target element is considered to be inside the parent:
For the InRoom strategy, the intersection of 3 of the 4 rays is considered a positive result.
This algorithm is fast, but it only allows to determine the entry of a solid into a single parent solid. The position of the solid's centroid is important.
Determining the entry is done through the Boolean operations provided in the Revit API. Essentially, this algorithm determines the intersection of solids. For example, the algorithm will count a beam hit in both walls:
This algorithm is slow, but it allows to determine the solid's entry into several intersecting parent solids.
For both algorithms, there is a solid volume check - the volume of the parent solid must be larger than the volume of the target solid.
In the SolidTouch strategy, the adjacency is checked only through the parallel planar faces of the solids.
In all strategies - InRoom, InSpace, InMass, InSolid, SolidTouch - elements will not be processed if they do not have Solids in their geometry