Particle Analysis Window: Difference between revisions

From Eigenvector Research Documentation Wiki
Jump to navigation Jump to search
imported>Scott
imported>Donal
 
(8 intermediate revisions by 2 users not shown)
Line 3: Line 3:
==Interface==
==Interface==
The Particle Analysis interface has three main areas for the image, particle table, and analysis function settings. The basic workflow:
The Particle Analysis interface has three main areas for the image, particle table, and analysis function settings. The basic workflow:
# Load image data.
# Load image data (via the File menu).
# Adjust function settings.
# Adjust function settings.
# Run the particle analysis.
# Adjust threshold mask and preprocessing.
# Run the particle analysis (see Toolbar).
# Explore the results.
# Explore the results.
# Repeat steps 2-4 until you have the desired results.
# Repeat steps 2-5 until you have the desired results.
# Save or export your results.  
# Save or export your results.  


 
[[Image:Particlegui.png||600px|Particle Analysis Interface]]
[[Image:Particlegui.png|border|600px|Particle Analysis Interface]]


==Menu==
==Menu==
Line 17: Line 17:
** Load Workspace Image - Load image data (numeric or DataSet) from the Workspace.
** Load Workspace Image - Load image data (numeric or DataSet) from the Workspace.
** Import Image - Load an image from a supported file [[Image_File_Readers |format]].
** Import Image - Load an image from a supported file [[Image_File_Readers |format]].
** Load Model - Load a previously saved particle model.
** Save Image - Save image to file or workspace.
** Save Image - Save image to file or workspace.
** Save Table Data - Save particle table data to file or workspace.
** Save Table Data - Save particle table data to file or workspace.
** Clear Data - Clear image and particle table.
** Save Model - Save particle model (includes table).
** Clear
*** Clear Data
*** Clear Model
*** Clear Preprocessing
*** Clear all
** Close - Close Particle Analysis window without saving data.
** Close - Close Particle Analysis window without saving data.
* Edit
* Edit
** Particle GUI Options - Optional settings for Particle Analysis interface.
** Interface Options - Optional settings for Particle Analysis interface.
** Particle Analysis Options - Optional settings for the Particle Analysis function. Note that most of these settings are available in the Settings area of the window.
** Particle Analysis Options - Optional settings for the Particle Analysis function. Note that most of these settings are available in the Settings area of the window.
*Help
*Help
** Particle Analysis Help - Opens this page.
** Particle Analysis Help - Opens this page.
** PLS_Toolbox Help - Opens main help page for PLS_Toolbox.
** PLS_Toolbox Help - Opens main help page for PLS_Toolbox.
==Toolbar==
==Toolbar==
From left to right in the image above the toolbar buttons are:
From left to right in the image above the toolbar buttons are:
* Lambda - Opens the Workspace Browser.
* Lambda - Opens the Workspace Browser.
* Options - Open function options.
* Options - Open function options.
* Import - Open image import dialog.
* Gears - Runs particle analysis using the current settings.
* Gears - Runs particle analysis using the current settings.
* Reset - Reset analysis settings to default values.
* Check Box - Toggles all the selected particles.
* Check Box - Toggles all the selected particles.
* Grayscale - Toggle image from color to grayscale.
* Binary - Toggle alpha mask of binary image (overlay onto image).
* Layers - Changes the background alpha color of the particles. Cycles through Black, White, and Red and can be used to enhance appearance of particles.
* Layers - Changes the background alpha color of the particles. Cycles through Black, White, and Red and can be used to enhance appearance of particles.
* Zoom - Toggle zoom on and off.
* Zoom - Toggle zoom on and off.
* Table Export - Export the particle table to [[analysis]].
* Table Export - Export the particle table to [[analysis]].
* Image Export - Export the image to [[analysis]].
* Plot - Open image in [[plotgui]].
* Read X - Close the window without saving.
* Help - Open help window for interface.
* X - Close the window without saving.


==Settings==
==Settings==


For a detailed explanation of the function setting see [[analyzeparticles]]. Additional settings can be found using Edit>Particle Analysis Options (or clicking the Options toolbar button).
For a detailed explanation of the function setting see [[analyzeparticles]]. Additional settings can be found using Edit>Particle Analysis Options (or clicking the Options toolbar button).


==Image==
==Image==
Depending on the settings, the image displays particles as regions masked with a semitransparent layer (alpha mask) either over each particle or over the non-particle region. The background color can be adjusted (using the toolbar button) to emphasize the regions.
Depending on the settings, the image displays particles as regions masked with a semitransparent layer either over each particle or over the non-particle region. The background color on the transparent portions can be adjusted to emphasize the regions by using the Layers toolbar button. Clicking on a particle will highlight the particle's row in the the particle table and draw an outline around the particle.


==Particle Table==
==Particle Table==
The Particle Table has two particle selection methods. First, you can check/uncheck particles in the Show column. This will turn on/off the particle as show by the alpha mask. You can also select the "row header" (integer row number). This will draw an outline around the particle (see image above).
The Particle Table has two particle selection methods to help identify particles in the image. First, you can check/uncheck the checkboxes in the Show column. When checked, the corresponding particle is highlighted in the image by dimming all non-particle pixels. You can also select one or more rows by clicking on the row number on left edge of table. This will draw an outline around the particle (see image above).
 
Note that the results table shows particle characteristics with dimensional quantities such as Perimiter or Area reported in pixels or in imageaxisscale units. Image Axisscale units are used if the image dataset has imageaxisscales for both x and y dimensions. If only one imageaxisscale is present then its units are used for both x and y dimensions. If there are no imageaxisscales present then units are pixels.

Latest revision as of 14:49, 18 April 2017

The Particle Analysis window is an interface into the analyzeparticles function. Included in the interface are controls for adjusting settings for the particle analysis and exploring the results. Once the particle analysis is complete you can export the resulting image and or table to analysis. When an image is exported to analysis, the particles identified by Particle Analysis are identified in class-sets associated with each particle. One classset has a class for each particle. Pixels within particle j have class = j. Non particle pixels have class = 0. Second classset has one class for all particles. Pixels within any particle have class = 1. Non particle pixels have class = 0.

Interface

The Particle Analysis interface has three main areas for the image, particle table, and analysis function settings. The basic workflow:

  1. Load image data (via the File menu).
  2. Adjust function settings.
  3. Adjust threshold mask and preprocessing.
  4. Run the particle analysis (see Toolbar).
  5. Explore the results.
  6. Repeat steps 2-5 until you have the desired results.
  7. Save or export your results.

Particle Analysis Interface

Menu

  • File
    • Load Workspace Image - Load image data (numeric or DataSet) from the Workspace.
    • Import Image - Load an image from a supported file format.
    • Load Model - Load a previously saved particle model.
    • Save Image - Save image to file or workspace.
    • Save Table Data - Save particle table data to file or workspace.
    • Save Model - Save particle model (includes table).
    • Clear
      • Clear Data
      • Clear Model
      • Clear Preprocessing
      • Clear all
    • Close - Close Particle Analysis window without saving data.
  • Edit
    • Interface Options - Optional settings for Particle Analysis interface.
    • Particle Analysis Options - Optional settings for the Particle Analysis function. Note that most of these settings are available in the Settings area of the window.
  • Help
    • Particle Analysis Help - Opens this page.
    • PLS_Toolbox Help - Opens main help page for PLS_Toolbox.

Toolbar

From left to right in the image above the toolbar buttons are:

  • Lambda - Opens the Workspace Browser.
  • Options - Open function options.
  • Import - Open image import dialog.
  • Gears - Runs particle analysis using the current settings.
  • Reset - Reset analysis settings to default values.
  • Check Box - Toggles all the selected particles.
  • Grayscale - Toggle image from color to grayscale.
  • Binary - Toggle alpha mask of binary image (overlay onto image).
  • Layers - Changes the background alpha color of the particles. Cycles through Black, White, and Red and can be used to enhance appearance of particles.
  • Zoom - Toggle zoom on and off.
  • Table Export - Export the particle table to analysis.
  • Plot - Open image in plotgui.
  • Help - Open help window for interface.
  • X - Close the window without saving.

Settings

For a detailed explanation of the function setting see analyzeparticles. Additional settings can be found using Edit>Particle Analysis Options (or clicking the Options toolbar button).

Image

Depending on the settings, the image displays particles as regions masked with a semitransparent layer either over each particle or over the non-particle region. The background color on the transparent portions can be adjusted to emphasize the regions by using the Layers toolbar button. Clicking on a particle will highlight the particle's row in the the particle table and draw an outline around the particle.

Particle Table

The Particle Table has two particle selection methods to help identify particles in the image. First, you can check/uncheck the checkboxes in the Show column. When checked, the corresponding particle is highlighted in the image by dimming all non-particle pixels. You can also select one or more rows by clicking on the row number on left edge of table. This will draw an outline around the particle (see image above).

Note that the results table shows particle characteristics with dimensional quantities such as Perimiter or Area reported in pixels or in imageaxisscale units. Image Axisscale units are used if the image dataset has imageaxisscales for both x and y dimensions. If only one imageaxisscale is present then its units are used for both x and y dimensions. If there are no imageaxisscales present then units are pixels.