hsbexporter filters

When using the hsbexporter/ CNCexporter filters this can be used to get specific selection sets exported.

In most cases the Beamfilter or Sheetfilter is used. Both of these filters are the same in their settings but the Beamfilter only checks Beams and the Sheetfilter only checks Sheets. How to add these filters is explained in the following article: hsbexporter add filters.

In this article beams/sheets are named generally using entities as a name.

Filter Settings

There are different settings that can be used to filter entities. The following table shows a brief overview of these settings.

SettingDescription
ActionChoose whether to remove or tag entities
ComparisationAll or Any (in use with the Filter definition)
EnabledFilter enabled (True or False)
Filter DefinitionFilter on e.g. material, beamcode, label etc.
OperationExclude or include the filter set of entities
TagsWhen the Action is Tag, tags can be set here
ToleranceThe tolerance to use when comparing units
UnitsUnits used

Action

When using a filter there are two options. Entities can be Removed or Tagged. Removing entities can result in a smaller selection set as output. Tagging entities does not remove anything but adds data (a Tag) to the filtered entities. Tags for example can be used to visualize specific entities in the hsbmake client views.

Comparisation

When using multiple filter definitions you can choose to have entities checked for ALL or ANY of these filters.

For example the filters are: “Beamcode = XX” and “Label = 11”.

The comparisation setting gives you the option to check entities for ALL of these filter definitions (a beam must have Beamcode = XX AND Label = 11). Or check the entities for ANY of these filter definitions (a beam must have Beamcode = XX or must have a Label = 11).

Enabled

Using this setting gives you the possibility to turn off the filter quickly without having to remove the filter.

Enabled = True (Filter is active)
Enabled = False (Filter is not active)

Filter Definition

The filter definition gives you the option to filter on many different properties (for example: Beamcode, Material, Label, Length, Width etc.).

To add a filter you need to click on the tree dots behind the Filter Definition, and click Add in the following dialog.

Adding a filter

In the Query Filter dialog that shows, you can choose different filtering options in the first dropdown (For example: Beamcode, Material, Length, Width etc.).

The second dropdown gives you the option to make comparisation rules. The different options and their rules are:

RuleDescription
=Compare one value
For example: Length = 1000 (Length must be 1000)
<>Not equal to
For example: Length <> 1000 (Length may not be equal to 1000)
>Bigger than
For example: Length > 1000 (Length must be bigger than 1000)
<Smaller than
For example: Length < 1000 (Length must be smaller than 1000)
<=Smaller than, or equal to
For example: Length <= 1000 (Length must be smaller than or equal to 1000)
>=Bigger than, or equal to
For example: Length >= 1000 (Length must be bigger than or equal to 1000)
ListList of options (comma separated)
For example: Length “List” 1000, 1500, 2000, 2500 (Length must be equal to one of the options)

Operation

The operation setting makes the filtering include or exclude entities. When using the Remove option at Action and setting the operation to Include, the entities that are filtered will be part of the output selection set.

For example:
Selection set: Beam01 (Beamcode X1), Beam02 (Beamcode X2), Beam03 (beamcode X3).
Action = Remove.
Filtering is done using Beamcode = X1.
Operation = Include.

Output selection set: Beam01 (Beamcode X1)


When using the Remove option at Action and setting the operation to Exclude, the entities that are filtered will be removed (excluded) from the output selection set.

For example:
Selection set: Beam01 (Beamcode X1), Beam02 (Beamcode X2), Beam03 (beamcode X3).
Action = Remove.
Filtering is done using Beamcode = X1.
Operation = Exclude.

Output selection set: Beam02 (Beamcode X2), Beam03 (Beamcode X3)


Tags

Tags can be used to add data to entities. Select the tree dots behind Tag to add tags.

To use tags the Action setting must be set to Tag

Tolerance

When units are used in the filtering, there can be a tolerance set for the comparisation.

Units

Set you preferred units for the filtering here, this could be Millimeter, Centimeter, Meter, Inch or Foot.

Updated on 06/01/2021

Was this article helpful?

Related Articles

Need Support?
Can’t find the answer you’re looking for? Don’t worry we’re here to help!
Contact Support