OriginLab Corporation - Data Analysis and Graphing Software - 2D graphs, 3D graphs, Contour Plots, Statistical Charts, Data Exploration, Statistics, Curve Fitting, Signal Processing, and Peak Analysis     
 
Skip Navigation Links
All BooksExpand All Books
Origin HelpExpand Origin Help
GadgetsExpand Gadgets

11.11 2D Integration Gadget (Pro Only)


Overview

The 2D Integration Gadget tool (uses the addtool_integ2 X-Function) allows you to calculate the 2D integration for a contour or image graph created from uniformly spaced matrix or non-uniformly spaced virtual matrix or XYZ worksheet data.

To use this gadget tool, create a contour plot from your data, activate the graph and select Gadgets:2D Integrate from top menu.

2d integrate.png
Notes: The options for the X-Function of gadget is organized as tree variable, the tree node names to be called for each options/branches are listed in the bracket next to the option name(tree node labels).

ROI Box (roi)

The ROI (region of interest) box is a rectangle shape object, and defines the area for surface integration calculation.

Shape Position (shapeProp)

You can define the position of ROI box by giving values for XY coordinates.

X1 (xFrom) Enter a value for the X coordinate for the leftmost line in the ROI box.
X2 (xTo) Enter a value for the X coordinate for the rightmost line in the ROI box.
Y1 (yFrom) Enter a value for the Y coordinate for the bottom line in the ROI box.
Y2 (yTo) Enter a value for the Y coordinate for the top line in the ROI box.
Fixed(Prevent moving by ROI) (fix_roi_loc) Specify whether to prevent manually moving the ROI box.


Show Tool Name (toolname)

Specify whether to show a tool name at the top left corner of the ROI box. The tool name can be further specified in the text box if this check box is selected.


Show on Center-Top of ROI Box (showtop)

Specify whether to show the results of corresponding quantity on center top of the ROI box.

Volume (topVolume) The volume integrated from base to the source surface.
FWHM (topFwhm) The full width at half the height of the source surface.
N (topN) The number of data points.
Minimum (topMinimum) The minimum Z value.
Maximum (topMaximum) The maximum Z value.
Mean (topMean) The mean of Z values.
Median (topMedian) The median of Z values.
SD (topSD) The standard deviation of all Z values.
Sum (topSum) The sum of Z values.

Fill Color (rectcolor)

Specify the fill color for the ROI box.

Baseline (baseline)

Mode (method) Select a mode for the base.
  • None
    There will be no baseline, the integration will be from the zero plane.
  • Constant
    Use a flat plane parallel to the XY plane at the pre-defined Z value.
  • Plane
    Create a fitted plane as baseline using boundary points.
Constant (constantMode) This is only available when the Mode is set to Constant. It is used to specify the Z value for the baseline plane.
  • Custom
    Use a custom Z value, this is defined in the Z= text box.
  • Minimum
    Use the minimum Z value.
  • Maximum
    Use the maximum Z value.
Z= (zvalue) This is only available when Constant is set to Custom. It is used to specify a custom Z value for baseline plane.
Boundary Tolerance (%) (boundtor) This is only available when Mode is set to Plane. The boundary is determined by the option selected for Range. The tolerance in percentage decides a tolerance width or height. The points whose distance from the boundary is less than the tolerance width or height. Tolerance width/height = Tolerance (%) * Width/Height.
Range (range) This is not available when the Mode is set to None or Custom is selected for the Constant drop-down menu. It is used to specify the data range considered when determining base plane.
  • Full Plot Range
    The full plot range boundary is used to fit base plane, or the min/max value is found within the full plot range.
  • Plot Within ROI
    Only the boundary of the plot within the ROI box is used to fit base plane, or the min/max value is found within the data range defined by ROI box.

Integration (integration)

You can specify options for integration in this tab.

If Interpolate for Missing Values (interpmissing) is checked, the interpolation will also taken consideration the missing values.

If Show Baseline-Subtracted Surface (showsurface) is checked, the subtracted surface (subtracted from source data and baseline plane) will be shown.

Output (Output)

Output Quantities to (outputQuantitiesTo)

Customize the output results.

Script Window (script) Specify whether to output the results to the Script window.
Results Log (reslog) Specify whether to output the result to the Results Log.
Append to Worksheet (appendwks) Specify whether to append the results to a worksheet.
Result Workbook Name (wbkName) This is only available when Append to Worksheet (appendwks) is selected. It is used to specify the name of the worksheet.

Quantities Branch (quantities)

Specify the quantities to be outputted.

Dataset Identifier (name) Specify a dataset identifier in the drop-down list.
Index Range (index_rng) Specify whether to output the indices for the dimension limited by the ROI box. This is only available when the input data is not XYZ range.
X Range (x_rng) Specify whether to output the indices for X range.
Y Range (y_rng) Specify whether to output the indices for Y range.
Max Height (max_height) Specify whether to output the maximum height from source surface to baseline.
Volume (volume) Specify whether to output The volume integrated from base to the source surface.
Area of Surface (area) Specify whether to output the area of the source surface.
Centroid (centroid) Specify whether to output the coordinate of centroid for the selected region.
FWHM (fwhm) Specify whether to output the full width at half the height of the source surface.
Half Width (half_width) Specify whether to output the half width.
Z Max (zmax) Specify whether to output the maximum value of Z.
Index at ZMax (index_zmax) Specify whether to output the column/row index for the data point at maximum Z value.
(x,y) at ZMax (xy_zmax) Specify whether to output the X and Y values for the data point at maximum Z value.
Statistics (QStatistics) Specify whether to output the statistic results based on Z values, available quantities are:
  • N (qsN):Number of data points.
  • Minimum (qsMinimum):Minimum of Z values.
  • Maximum (qsMaximum):Maximum of Z values.
  • Mean (qsMean):Mean of Z values
  • Median (qsMedian):Median of Z values.
  • SD (qsSD):Standard deviation of Z values.
  • Sum (qsSum):Sum of Z values.

Baseline (baselineOutput)

Baseline (baseline) Specify whether to output the baseline information.
Output To (OutputTo) Specify where to output the result .


Notes: The name in the brackets is the tree node name, and the name outside is the tree node label. When an X-function executes by script, you have to assign values to tree nodes using their names. Special characters and spaces are not allowed in tree node names. However, you can use special characters and white space in the tree node label.

The Fly-out Menu

Click the triangle button ROI menu.png near the top right corner of the ROI to open a fly-out menu that offers the following options:

New Output Output the result.
Go to Report Worksheet Go to the result worksheet once the result has been output to worksheet.
Change Data Change the input data.
Expand to Full Plot(s) Range Expand the ROI box to the full Plots range.
Expand to Full Layer Width Expand the ROI box to the full layer width.
Expand to Full Layer Height Expand the ROI box to the full layer height.
Save Theme Save the settings in this dialog as a dialog theme.
Save as <default> Save the setting in this dialog as <default> theme.
Load Theme Load the dialog theme pre-saved.
Preferences Open the Preferences dialog.
 

© OriginLab Corporation. All rights reserved.