Grain Characterisation

Grain Characterisation

UPXO provides comprehensive tools for characterising grain morphology, topology, and spatial properties in both 2D and 3D grain structures.

---

Morphological Properties

Calculated per grain and accessible via the property table (pxt.gs[gsid]):

• Area (2D) / Volume (3D)
• Aspect ratio
• Solidity
• Major and minor axis lengths
• Intercept grain size (3D)
• Equivalent diameter

Key module: charops/mchar.py, pxtalops/Characterizer.py

---

Grid Operations (gsdataops/grid_ops.py)

Utilities for resampling, stretching, and interpolating grain structure images:

• resample_grid_2d — downsample/upsample a 2D state matrix
• stretch_grid_2d — anisotropic physical stretching
• rescale_grid_2d — scale by a uniform factor

---

Feature ID Operations (gsdataops/gid_ops.py)

Operations on grain ID arrays — relabelling, merging, filtering grains by property thresholds.

---

Morphological Property Operations (propOps/mpropOps.py)

Statistical summaries and distributions of morphological properties across the grain ensemble.

---

Topological Characterisation

• Grain network construction (netops/)
• Coordination number, neighbour lists
• Graph-based grain topology metrics

---

Coming Soon

• Texture characterisation (crystallographic orientation)
• EBSD data mapping and analysis (viz/ebsdviz.py)