```{index} single: Filters; Remove Flagged Edges
```
# Remove Flagged Edges

## Group (Subgroup)

Surface Meshing (Misc)

## Description

This **Filter** removes **Edges** from the supplied **Edges Geometry** that are flagged by a (boolean|uint8) mask array as **true|1**.  A new reduced **Edge Geometry** is created that contains all the remaining **Edges**.  It is unknown until run time how many **Edges** will be removed from the **Geometry**. Therefore, this **Filter** requires that a new **EdgeGeom** be created to contain the reduced **Edge Geometry**. This new **Geometry** will *NOT* contain copies of any **Feature Attribute Matrix** or **Ensemble Attribute Matrix** from the original **Geometry**. The mask is expected to be over the edges themselves so it should be based on something from the **Edge Data Attribute Matrix**.

## Data Handling

For each of the vertex and edge data attribute matrices, the user can select to copy none, some or all of the associated data arrays into the newly created geometry. If the user wishes to not copy any of the data, just leave the choice to "Copy Selected XXX Data" [0] but do not populate the list with any selections.

*Note:* Since it cannot be known before run time how many **Edges** will be removed, the new **Edge Geometry** and all associated **Edge** data to be copied will be initialized to have size 0.

## Example Output

- The next figure shows an edge geometry that has had a mask generated. Yellow parts are flagged as true.

![Masked edge geometries for removal.](Images/RemoveFlaggedEdges_1.png)

- The next figure shows the result of running the filter.

![Resulting edge geometry](Images/RemoveFlaggedEdges_2.png)


### Input Data Objects

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Edge Geometry | Geometry Selection | Edge | The Edge Geometry that will be processed. |
| Mask | Array Selection | Allowed Types: uint8, boolean Comp. Shape: 1 | The DataArrayPath to the mask array that marks each edge as either true (remove) or false(keep). |

### Output Geometry

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Created Geometry | DataGroupCreation |  | The name of the created Edge Geometry |

### Vertex Data Handling

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Vertex Data Handling | Choices |  | How to handle Data that resides on the edges |
| Vertex Data | AttributeMatrixSelection |  | Vertex Attribute Matrix that will be copied to the reduced geometry |
| Vertex Attribute Arrays to Copy | MultiArraySelection |  | Vertex DataPaths to copy |

### Edge Data Handling

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Edge Data Handling | Choices |  | How to handle Data that resides on the edges |
| Edge Data | AttributeMatrixSelection |  | Edge Attribute Matrix that will be copied to the reduced geometry |
| Edge Attribute Arrays to Copy | MultiArraySelection |  | Edge DataPaths to copy |

## License & Copyright

Please see the description file distributed with this plugin.

## DREAM3D-NX Help

If you need help, need to file a bug report or want to request a new feature, please head over to the [DREAM3DNX-Issues](https://github.com/BlueQuartzSoftware/DREAM3DNX-Issues) GitHub site where the community of DREAM3D-NX users can help answer your questions.
