```{index} single: Filters; Write GBCD Pole Figure (GMT 5)
```
# Write GBCD Pole Figure (GMT 5)

## Group (Subgroup)

IO (Output)

## Description

This **Filter** creates a .dat file that can be used in conjunction with [GMT](http://gmt.soest.hawaii.edu/) to generate a grain boundary character distribution (GBCD) pole figure. The user must select the relevant phase for which to write the pole figure by entering the *phase index*.

![GMT Visualization of the Small IN100 GBCD Results](Images/WriteGBCDGMTFile.png)


### Input Parameter(s)

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Phase of Interest | Scalar Value |Int32 | Index of the Ensemble for which to plot the pole figure |
| Misorientation Axis-Angle | Vector of Float32 Values | Order=Angle,h,k,l | Axis-Angle pair values for drawing GBCD |
| Output GMT File | FileSystemPath |  | The output .dat file path |

### Input Triangle Ensemble Data

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| GBCD | Array Selection | Allowed Types: float64 | 5 parameter GBCD data. The 6th component is used internally to track the northern vs. southern hemisphere of the Lambert sphere |
| Crystal Structures | Array Selection | Allowed Types: uint32 Comp. Shape: 1 | Enumeration representing the crystal structure for each Ensemble |

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