```{index} single: Filters; Compute GBCD
```
# Compute GBCD

## Group (Subgroup)

Statistics (Crystallographic)

## Description

This **Filter** computes the 5D grain boundary character distribution (GBCD) for a **Triangle Geometry**, which is the relative area of grain boundary for a given misorientation and normal. The GBCD can be visualized by using either the **Write GBCD Pole Figure (GMT)** or the **Write GBCD Pole Figure (VTK)** **Filters**.


### Input Parameter(s)

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| GBCD Spacing (Degrees) | Scalar Value |Float32 | The resolution in degrees for the GBCD calculation |

### Input Triangle Geometry

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Triangle Geometry | Geometry Selection | Triangle | Path to the triangle geometry for which to calculate the GBCD |
| Face Labels | Array Selection | Allowed Types: int32 Comp. Shape: 2 | Array specifying which Features are on either side of each Face |
| Face Normals | Array Selection | Allowed Types: float64 Comp. Shape: 3 | Array specifying the normal of each Face |
| Face Areas | Array Selection | Allowed Types: float64 Comp. Shape: 1 | Array specifying the area of each Face |

### Input Ensemble Data

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Crystal Structures | Array Selection | Allowed Types: uint32 Comp. Shape: 1 | Enumeration representing the crystal structure for each Ensemble |

### Output Feature Data

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Average Euler Angles | Array Selection | Allowed Types: float32 Comp. Shape: 3 | Array specifying three angles defining the orientation of the Feature in Bunge convention (Z-X-Z) |
| Phases | Array Selection | Allowed Types: int32 Comp. Shape: 1 | Specifies to which phase each Feature belongs |

### Output Face Ensemble Data

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Face Ensemble Attribute Matrix | DataObjectName |  | The name of the created face ensemble attribute matrix |
| GBCD | DataObjectName |  | 5 parameter GBCD data. The 6th component is used internally to track the northern vs. southern hemisphere of the Lambert sphere |

## Example Pipelines

+ (04) SmallIN100 GBCD

## 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/discussions) GitHub site where the community of DREAM3D-NX users can help answer your questions.
