AnalysisOperations
Provides tools for creating, running, and managing analysis objects. Supports wall thickness, deviation, curvature, extrema, gray value, and void/inclusion analyses on mask and surface objects. Enables programmatic access to analysis results and statistics.
Import
import ScriptingApi as api
# Access via Application
app = api.Application()
ops = app.get_analysis_operations()
Methods
Creation
create_wall_thickness_analysis_mask
Creates a wall thickness analysis on a mask object.
Signature:
create_wall_thickness_analysis_mask(analysisName: str, maskName: str, params: WallThicknessParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
maskName | any | Name of the mask object to analyze. |
params | any | Wall thickness analysis parameters. Use api.WallThicknessParams(). |
Returns: str — The name of the created analysis object.
create_wall_thickness_analysis_surface
Creates a wall thickness analysis on a surface object.
Signature:
create_wall_thickness_analysis_surface(analysisName: str, surfaceName: str, params: WallThicknessParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
surfaceName | any | Name of the surface object to analyze. |
params | any | Wall thickness analysis parameters. Use api.WallThicknessParams(). |
Returns: str — The name of the created analysis object.
create_deviation_analysis_mask_vs_mask
Creates a deviation analysis comparing two mask objects.
Signature:
create_deviation_analysis_mask_vs_mask(analysisName: str, actualMaskName: str, referenceMaskName: str, params: DeviationParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
actualMaskName | any | Name of the actual (measured) mask object. |
referenceMaskName | any | Name of the reference (nominal) mask object. |
params | any | Deviation analysis parameters. Use api.DeviationParams(). |
Returns: str — The name of the created analysis object.
create_deviation_analysis_surface_vs_surface
Creates a deviation analysis comparing two surface objects.
Signature:
create_deviation_analysis_surface_vs_surface(analysisName: str, actualSurfaceName: str, referenceSurfaceName: str, params: DeviationParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
actualSurfaceName | any | Name of the actual (measured) surface object. |
referenceSurfaceName | any | Name of the reference (nominal) surface object. |
params | any | Deviation analysis parameters. Use api.DeviationParams(). |
Returns: str — The name of the created analysis object.
create_deviation_analysis_mask_vs_surface
Creates a deviation analysis comparing a mask to a surface object.
Signature:
create_deviation_analysis_mask_vs_surface(analysisName: str, actualMaskName: str, referenceSurfaceName: str, params: DeviationParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
actualMaskName | any | Name of the actual (measured) mask object. |
referenceSurfaceName | any | Name of the reference (nominal) surface object. |
params | any | Deviation analysis parameters. Use api.DeviationParams(). |
Returns: str — The name of the created analysis object.
create_curvature_analysis_mask
Creates a curvature analysis on a mask object.
Signature:
create_curvature_analysis_mask(analysisName: str, maskName: str, params: CurvatureParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
maskName | any | Name of the mask object to analyze. |
params | any | Curvature analysis parameters. Use api.CurvatureParams(). |
Returns: str — The name of the created analysis object.
create_curvature_analysis_surface
Creates a curvature analysis on a surface object.
Signature:
create_curvature_analysis_surface(analysisName: str, surfaceName: str, params: CurvatureParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
surfaceName | any | Name of the surface object to analyze. |
params | any | Curvature analysis parameters. Use api.CurvatureParams(). |
Returns: str — The name of the created analysis object.
create_extrema_analysis_mask
Creates an extrema analysis on a mask object.
Signature:
create_extrema_analysis_mask(analysisName: str, maskName: str, params: ExtremaParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
maskName | any | Name of the mask object to analyze. |
params | any | Extrema analysis parameters. Use api.ExtremaParams(). |
Returns: str — The name of the created analysis object.
create_extrema_analysis_surface
Creates an extrema analysis on a surface object.
Signature:
create_extrema_analysis_surface(analysisName: str, surfaceName: str, params: ExtremaParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
surfaceName | any | Name of the surface object to analyze. |
params | any | Extrema analysis parameters. Use api.ExtremaParams(). |
Returns: str — The name of the created analysis object.
create_gray_value_analysis_mask
Creates a gray value analysis on a mask object.
Signature:
create_gray_value_analysis_mask(analysisName: str, maskName: str, volumeName: str, params: GrayValueParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
maskName | any | Name of the mask object to analyze. |
volumeName | any | Name of the volume object providing gray values. |
params | any | Gray value analysis parameters. Use api.GrayValueParams(). |
Returns: str — The name of the created analysis object.
create_gray_value_analysis_surface
Creates a gray value analysis on a surface object.
Signature:
create_gray_value_analysis_surface(analysisName: str, surfaceName: str, volumeName: str, params: GrayValueParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
surfaceName | any | Name of the surface object to analyze. |
volumeName | any | Name of the volume object providing gray values. |
params | any | Gray value analysis parameters. Use api.GrayValueParams(). |
Returns: str — The name of the created analysis object.
create_void_inclusion_analysis
Creates a void/inclusion analysis on a volume object.
Signature:
create_void_inclusion_analysis(analysisName: str, volumeName: str, roiMaskName: str, params: VoidInclusionParams) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name for the new analysis object. If empty, a name is auto-generated. |
volumeName | any | Name of the volume object to analyze. |
roiMaskName | any | Optional ROI mask name to restrict analysis region. Pass empty string if not used. |
params | any | Void/inclusion analysis parameters. Use api.VoidInclusionParams(). |
Returns: str — The name of the created analysis object.
Properties
run_analysis
Runs the specified analysis and computes results.
Signature:
run_analysis(analysisName: str) -> bool
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object to run. |
Returns: bool — True if the analysis completed successfully.
update_analysis
Updates the visualization of an existing analysis.
Signature:
update_analysis(analysisName: str) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object to update. |
get_analysis_info
Gets information about an analysis object.
Signature:
get_analysis_info(analysisName: str) -> AnalysisInfo
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
Returns: AnalysisInfo — Analysis information structure as a AnalysisInfo structure.
get_analysis_type
Gets the type of an analysis object.
Signature:
get_analysis_type(analysisName: str) -> AnalysisType
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
Returns: AnalysisType — The analysis type as a api.AnalysisType enum value.
get_analysis_type_as_string
Gets the type of an analysis object as a string.
Signature:
get_analysis_type_as_string(analysisName: str) -> str
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
Returns: str — The analysis type as a string.
has_analysis_results
Checks if an analysis has computed results.
Signature:
has_analysis_results(analysisName: str) -> bool
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
Returns: bool — True if the analysis has results available.
get_wall_thickness_analysis_results
Gets detailed results for a wall thickness analysis (mask or surface based).
Signature:
get_wall_thickness_analysis_results(analysisName: str) -> WallThicknessAnalysisResults
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
Returns: WallThicknessAnalysisResults — Wall thickness analysis results as a WallThicknessAnalysisResults structure which includes statistics and raw samples.
get_deviation_analysis_results
Gets detailed results for a deviation analysis (mask vs mask, surface vs surface, mask vs surface).
Signature:
get_deviation_analysis_results(analysisName: str) -> DeviationAnalysisResults
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
Returns: DeviationAnalysisResults — Deviation analysis results as a DeviationAnalysisResults structure which includes statistics and raw samples.
get_curvature_analysis_results
Gets detailed results for a curvature analysis (mask or surface based).
Signature:
get_curvature_analysis_results(analysisName: str) -> CurvatureAnalysisResults
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
Returns: CurvatureAnalysisResults — Curvature analysis results as a CurvatureAnalysisResults structure which includes statistics and raw samples.
get_extrema_analysis_results
Gets detailed results for an extrema analysis (mask or surface based).
Signature:
get_extrema_analysis_results(analysisName: str) -> ExtremaAnalysisResults
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
Returns: ExtremaAnalysisResults — Extrema analysis results as an ExtremaAnalysisResults structure which includes statistics and raw samples.
get_gray_value_analysis_results
Gets detailed results for a gray value analysis (mask or surface based).
Signature:
get_gray_value_analysis_results(analysisName: str) -> GrayValueAnalysisResults
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
Returns: GrayValueAnalysisResults — Gray value analysis results as a GrayValueAnalysisResults structure which includes statistics and raw samples.
get_void_inclusion_results
Gets results from a void/inclusion analysis.
Signature:
get_void_inclusion_results(analysisName: str) -> VoidInclusionResults
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
Returns: VoidInclusionResults — Void/inclusion analysis results as a VoidInclusionResults structure.
restore_visualizations
Restores the visualizations in 2D/3D views for a given analysis. This clears the analysis visualization including color mapping and preview geometry,
Signature:
restore_visualizations(analysisName: str) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
write_wall_thickness_results_to_disk
Writes wall thickness analysis results to disk in a human-readable text format.
Signature:
write_wall_thickness_results_to_disk(results: WallThicknessAnalysisResults, filePath: str) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
results | any | Previously computed wall thickness results WallThicknessAnalysisResults to write. |
filePath | any | Destination file path. |
write_deviation_results_to_disk
Writes deviation analysis results to disk in a human-readable text format.
Signature:
write_deviation_results_to_disk(results: DeviationAnalysisResults, filePath: str) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
results | any | Previously computed deviation results DeviationAnalysisResults to write. |
filePath | any | Destination file path. |
write_curvature_results_to_disk
Writes curvature analysis results to disk in a human-readable text format.
Signature:
write_curvature_results_to_disk(results: CurvatureAnalysisResults, filePath: str) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
results | any | Previously computed curvature results CurvatureAnalysisResults to write. |
filePath | any | Destination file path. |
write_extrema_results_to_disk
Writes extrema analysis results to disk in a human-readable text format.
Signature:
write_extrema_results_to_disk(results: ExtremaAnalysisResults, filePath: str) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
results | any | Previously computed extrema results ExtremaAnalysisResults to write. |
filePath | any | Destination file path. |
write_gray_value_results_to_disk
Writes gray value analysis results to disk in a human-readable text format.
Signature:
write_gray_value_results_to_disk(results: GrayValueAnalysisResults, filePath: str) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
results | any | Previously computed gray value results GrayValueAnalysisResults to write. |
filePath | any | Destination file path. |
write_void_inclusion_results_to_disk
Writes void/inclusion analysis results to disk in a human-readable text format.
Signature:
write_void_inclusion_results_to_disk(results: VoidInclusionResults, filePath: str) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
results | any | Previously computed void/inclusion results VoidInclusionResults to write. |
filePath | any | Destination file path. |
UI
set_display_settings
Sets the display settings for an analysis.
Signature:
set_display_settings(analysisName: str, settings: AnalysisDisplaySettings) -> None
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
settings | any | Display settings structure. |
get_display_settings
Gets the current display settings for an analysis.
Signature:
get_display_settings(analysisName: str) -> AnalysisDisplaySettings
Parameters:
| Parameter | Type | Description |
|---|---|---|
analysisName | any | Name of the analysis object. |
Returns: AnalysisDisplaySettings — Current display settings as an AnalysisDisplaySettings structure.