Example - BYU-MicrostructureOfMaterials/OpenXY GitHub Wiki

Running the included Steel Sample

A detailed walk-through of running OpenXY on a real scan A \OpenXY... reference refers to files within your local OpenXY directory, usually inside of C:\Users[UserName]\Documents\GitHub\ for Windows users.

The sample set used in this example can be found here. Download or clone the repository. A \Data Sample (Steel)... reference refers to the location of this data set.

Toolboxes Needed: Image Processing Toolbox and Parallel Computing Toolbox

  1. Install OpenXY (for installation instructions click here)
  2. Open and run \OpenXY\Code\RunOpenXY.m in Matlab (Opens MainGUI)
  3. Select Scan File: Click "Select Scan File" and select \Data Sample (Steel)\Steel-Ferrite-Martensite 40000X w 1x1 Pats.ang
  4. Select First Image: Click "Select First Image" and select \Data Sample (Steel)\Steel-Ferrite-Martensite 40000X w 1x1 Pats\Steel Ferrite-Martensite 40000X w 1x1 Pats_x0y0.jpg. Should open within scan file directory.
  5. Select Output File: Click "Select Output File" and select \Data Sample (Steel)[Your choice]
  6. Enable Dislocation Density Calculation: Go to Settings|Advanced Settings. Check "Calculate Dislocation Density". Click "Save & Close" to return to home GUI.
  7. Change Sample Tilt Angle: Go to Settings|Microscope Settings. Change Sample Tilt to 75 degrees. Most scans are taken at 70 deg, but this TSL scan was taken at 75 deg. Click "Save & Close" to return to home GUI.
  8. Run Analysis: Click the "Run" button to start analysis. The PC Calibration GUI will show up after a few seconds.
  9. Select Calibration Points: Click "Select Points". A separate window will appear and your cursor will change over the window. Click at least 3 points (points with higher Image Quality and are further apart from each other will be better). The save the points press the RETURN key or right-click your last point.
  10. Run PC Calibration: Click the "Calibrate" button. This will start up a parallel pool and run the strain minimization routine.
  11. Select Plane Fit: Select "Naive Plane Fit" from the "Plane Fit Type" panel for best results. Click "Save and Close" to continue to the analysis.
  12. Wait: This scan with these settings should take between 10-20 minutes, depending on your system configuration.
  13. Generate Plots: When calculation is finished it will display the OutputPlotting GUI. To plot the strain results, select Strain from the "Available for Calculation" dropdown and select "Add to Plotted Measures". Click "Plot Selected" to display the plots. To generate dislocation density plots, double-click Strain in the "Calculated" listbox to remove it and it's associated components. Select Dislocation Density from the dropdown and repeat the same process.
  14. Access data: To access the actual numeric results, inside of Matlab open the "AnalysisParams_...mat" file. that was generated by OpenXY. This is generate (or replace) a Settings and alpha_data structure in your base workspace. Click here for a definition of variables.