Back to module list
With / without measurement
Description
Filter an object collection based on the presence of a specific measurement for each object. Objects which do/don't have the relevant measurement can be removed from the input collection, moved to another collection (and removed from the input collection) or simply counted (but retained in the input collection). The number of objects failing the filter can be stored as a metadata value.
Parameters
- Input objects
- Description: Objects to be filtered.
- Type: InputObjectsP
- Filter mode
- Description: Controls what happens to objects which don't pass the filter:
- "Do nothing" Retains all input objects, irrespective of whether they passed or failed the filter. This is useful when also storing the filter results as metadata values (i.e. just counting the number of objects which pass the filter).
- "Move filtered objects to new class" Objects failing the filter are moved to a new object class. The name of the class is determined by the "Output (filtered) objects" parameter. All existing measurements and relationships are carried forward into the new object collection.
- "Remove filtered objects" (default) Removes objects failing the filter. Once removed, these objects are unavailable for further use by modules and won't be included in exported results.
- Type: ChoiceP
- Default value: Remove filtered objects
- Choices:
- Do nothing
- Move filtered objects to new class
- Remove filtered objects
- Output (filtered) objects
- Description: New object collection containing input objects which did not pass the filter. These objects are only stored if "Filter mode" is set to "Move filtered objects to new class".
- Type: OutputObjectsP
- Method for filtering
- Description: Controls whether objects are removed when a specific measurement is present or not:
- "Remove objects without measurement" Objects without the measurement specified by "Measurement to filter on" are removed, counted or moved (depending on the "Filter mode" parameter).
- "Remove objects with measurement" Objects with the measurement specified by "Measurement to filter on" are removed, counted or moved (depending on the "Filter mode" parameter).
- Type: ChoiceP
- Default value: Remove objects without measurement
- Choices:
- Remove objects with measurement
- Remove objects without measurement
- Measurement to filter on
- Description: Measurement to filter by. The presence or absence of this measurement will determine which of the input objects are counted, removed or moved (depending on the "Filter mode" parameter).
- Type: ObjectMeasurementP
- Store filter results
- Description: When selected, the number of removed (or moved) objects is counted and stored as a metadata item (name in the format "FILTER // NUM_[inputObjectsName] WITHOUT [measurementName] MEASUREMENT").
- Type: BooleanP
- Default value: false