```{index} single: Filters; Compute Schmid Factors
```
# Compute Schmid Factors

## Group (Subgroup)

Statistics (Crystallographic)

## Description

This **Filter** calculates the Schmid factor of each **Feature** given its average orientation and a user defined loading axis. The Schmid Factor is the combination of the component of the axial force *F* that lies parallel to the slip direction and the component that lies perpendicular to the slip plane.  The equation for the Schmid Factor is given as:

Schmid Factor = (cos &phi; cos &lambda;)

*The angle &phi; is the angle between the tensile axis and the slip plane normal, and &lambda; is the angle between the tensile axis and the slip direction in the slip plane.*

The **Filter** determines the Schmid factor for each **Feature** by using the above equation for all possible slip systems (given the **Feature's** crystal structure).  The largest Schmid factor from all of the slip systems is stored for the **Feature**. Only the Schmid factor is used in determining which slip system's Schmid factor to report.  The critical resolved shear stress for the different slip systems is not considered.


### Input Parameter(s)

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Loading Direction | Vector of Float32 Values | Order=X,Y,Z | The loading axis for the sample |
| Store Angle Components of Schmid Factor | Bool |  | Whether to store the angle components for each Feature |
| Override Default Slip System | Bool |  | Allows the user to manually input the slip plane and slip direction |
| Slip Plane | Vector of Float32 Values | Order=X,Y,Z | Vector defining the slip plane normal. |
| Slip Direction | Vector of Float32 Values | Order=X,Y,Z | Vector defining the slip direction. |

### Input Feature Data

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Phases | Array Selection | Allowed Types: int32 Comp. Shape: 1 | Specifies to which Ensemble each cell belongs |
| Average Quaternions | Array Selection | Allowed Types: float32 Comp. Shape: 4 | Specifies the average orienation of each Feature in quaternion representation |

### 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 |
|----------------|----------------|-----------------|-------------|
| Schmids | DataObjectName |  | The name of the array containing the value of the Schmid factor for the most favorably oriented slip system (i.e., the one with the highest Schmid factor) |
| Slip Systems | DataObjectName |  | The name of the array containing the enumeration of the slip system that has the highest Schmid factor |
| Poles | DataObjectName |  | The name of the array specifying the crystallographic pole that points along the user defined loading direction |
| Phis | DataObjectName |  | The name of the array containing the angle between tensile axis and slip plane normal.  |
| Lambdas | DataObjectName |  | The name of the array containing the angle between tensile axis and slip direction. |

## Example Pipelines

+ (05) SmallIN100 Crystallographic Statistics

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