hsbExport | 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.

BLOCK_INFO_START

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

BLOCK__END

Filter Settings

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

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.

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:

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.

BLOCK_INFO_START

To use tags the Action setting must be set to Tag

BLOCK__END

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.