6. Object Analysis Statistics

This section explains how to create and edit Object Analysis Statistics.

6.1. Usage

An object analysis statistics is an algorithm that will used to extract information about each object (labelized voxels) contained in a MultiROI.

6.2. File location

To be recognized by the application, object analysis statistics should be located in one of these folders:

  • %LocalAppData%/ORS/Dragonfly31/pythonUserExtensions/PythonPluginExtensions/ObjectAnalysis/PythonScriptsStatisticsGenerators (available for the current user)
  • %ProgramData%/ORS/Dragonfly31/pythonAllUsersExtensions/PythonPluginExtensions/ObjectAnalysis/PythonScriptsStatisticsGenerators (available for all users)
  • %ProgramData%/ORS/Dragonfly31/python/OrsPythonPlugins/OrsObjectAnalysis/PythonScriptsStatisticsGenerators (distributed with the application)

6.3. File creation

To create an object analysis statistics, start the application, start the OrsPythonPlugins.OrsObjectAnalysisStatisticsGenerator_5cb03bdc68a611e79023448a5b5d70c0.OrsObjectAnalysisStatisticsGenerator_5cb03bdc68a611e79023448a5b5d70c0 (found in Developer/Object Analysis Statistics Generator), fill in the required fields and press the button Create statistics.

6.4. File edition

Open the file in a text editor. Fill in the required methods.

6.5. Demos

Statistics on object geometry

In this demonstration, the objective is to get a measure of the empty portion included by an object (like a shell). There is 2 statistics computed based on the geometry of each object:

  • “Porous volume”: the volume of the empty portion of the object;
  • “Porous volume fraction”: the volume of the empty portion of the object on the volume occupied by the filled object.

Source code example:

  1. Download the file;
  2. Put that file into an object analysis statistics extension folder;
  3. Start the application;
  4. Create a ROI having multiple disconnected 3D objects, some of those having holes completely included;
  5. Right-click on the ROI and select New Connectivity Multi-ROI Analysis...;
  6. Open the Statistical Properties panel (button in the the top-left section of the Object Analysis window);
  7. In the left column (Available datasets:), make sure the No dataset required item is selected;
  8. In the right column (Statistical properties:), select the items Porous volume and Porous volume fraction;
  9. Press the OK button to compute these statistics.

Statistics on data

In this demonstration, the objective is to get a measure of the data outliers included over each object. There is 2 statistics computed based on the data of each object:

  • “Outlier count”: the count of data samples identified as outliers accordingly to the modified Thompson Tau Test;
  • “Outlier fraction”: the count of data samples identified as outliers accordingly to the modified Thompson Tau Test on the total data samples of that object.

Source code example:

  1. Download the file;
  2. Put that file into an object analysis statistics extension folder;
  3. Start the application;
  4. Import a dataset;
  5. Create a ROI from this dataset, having multiple disconnected 3D objects;
  6. Right-click on the ROI and select New Connectivity Multi-ROI Analysis...;
  7. Open the Statistical Properties panel (button in the the top-left section of the Object Analysis window);
  8. In the left column (Available datasets:), select the item with the title of the dataset;
  9. In the right column (Statistical properties:), select the items Outlier count and Outlier fraction;
  10. Press the OK button to compute these statistics.