PartAnalysis
[Desktop Automation]
This object is used to run analyses on a mesh. Those include the default, center of gravity, wall thickness, support volume, shadow area and upskin/downskin analyses. The available methods run the analyses, the properties can then be used to get results, with each analysis having a property to indicate successful calculation. The object is created from a mesh object by:
TLUAPartAnalysis analysis = mesh:createanalyzer()Properties
| Property | Read/write | Type | Description | Applies to |
|---|---|---|---|---|
| averagewallthickness | Read | Number | Returns the average wall thickness | Wall thickness analysis |
| badedges | Read | Number | Returns the number of invalid edges | Default analysis |
| boundaryedges | Read | Number | Returns the number of edges making up holes | Default analysis |
| boundarylength | Read | Number | Returns the total length of all boundary edges | Default analysis |
| centerofgravityx | Read | Number | Returns the x value of the mesh's center of gravity | Center of gravity analysis |
| centerofgravityy | Read | Number | Returns the y value of the mesh's center of gravity | Center of gravity analysis |
| centerofgravityz | Read | Number | Returns the z value of the mesh's center of gravity | Center of gravity analysis |
| coganalysiswassuccessful | Read | Boolean | Returns true if no errors occurred during the calculation of the analysis | Center of gravity analysis |
| defaultanalysiswassuccessful | Read | Boolean | Returns true if no errors occurred during the calculation of the analysis | Default analysis |
| downskinangle | Read | Number | Returns the entered downskin angle threshold between the z plane and the triangle | Upskin/Downskin analysis |
| downskinarea | Read | Number | Returns the total area of all downskin triangles | Upskin/Downskin analysis |
| downskincomponentcount | Read | Number | Returns the number of downskin components | Upskin/Downskin analysis |
| edgecount | Read | Number | Returns the number of edges | Default analysis |
| facecount | Read | Number | Returns the number of triangles | Default analysis |
| flippedtrianglecount | Read | Number | Returns the number of flipped triangles | Default analysis |
| holecount | Read | Number | Returns the number of holes | Default analysis |
| isorientable | Read | Boolean | Returns true when the mesh triangles can be flipped to form a closed mesh | Default analysis |
| mesharea | Read | Number | Returns the total area of the mesh's triangles | Default analysis |
| meshisclosed | Read | Boolean | Returns true if the mesh has no holes | Default analysis |
| meshisok | Read | Boolean | Returns true if the mesh is orientable and closed | Default analysis |
| meshvolume | Read | Number | Returns the volume of the closed mesh or 0 if the mesh contains flipped triangles or is open | Default analysis |
| nodecoount | Read | Number | Returns the number of nodes | Default Analysis |
| outboxmaxx | Read | Number | Returns the max_x of the outbox (in mm) | Default analysis |
| outboxmaxy | Read | Number | Returns the max_y of the outbox (in mm) | Default analysis |
| outboxmaxz | Read | Number | Returns the max_z of the outbox (in mm) | Default analysis |
| outboxminx | Read | Number | Returns the min_x of the outbox (in mm) | Default analysis |
| outboxminy | Read | Number | Returns the min_y of the outbox (in mm) | Default analysis |
| outboxminz | Read | Number | Returns the min_z of the outbox (in mm) | Default analysis |
| outboxsizex | Read | Number | Returns the length of the outbox in x direction | Default analysis |
| outboxsizey | Read | Number | Returns the length of the outbox in y direction | Default analysis |
| outboxsizez | Read | Number | Returns the length of the outbox in x direction | Default analysis |
| simpledownskinangle | Read | Number | Returns the entered downskin angle threshold between the z plane and the triangle | Simple upskin/downskin analysis |
| simpledownskinarea | Read | Number | Returns the total area of all downskin triangles | Simple upskin/downskin analysis |
| simpleupdownskinanalysiswassuccessful | Read | Boolean | Returns true if no errors occurred during the calculation of the analysis | Simple upskin/downskin analysis |
| simpleupskinangle | Read | Number | Returns the entered upskin angle threshold between the z plane and the triangle | Simple upskin/downskin analysis |
| simpleupskinarea | Read | Number | Returns the total area of all upskin triangles | Simple upskin/downskin analysis |
| shadowarea | Read | Number | Returns the area of the mesh's shadow at z = 0 | Shadow area analysis |
| shadowareaanalysiswassuccessful | Read | Boolean | Returns true if no errors occurred during the calculation of the analysis | Shadow area analysis |
| supportangle | Read | Number | Returns the angle used to calculate support clusters used as basis for the support shells | Support volume analysis |
| supportvolume | Read | Number | Returns the volume of the support shells | Support volume analysis |
| supportvolumeanalysiswassuccessful | Read | Boolean | Returns true if no errors occurred during the calculation of the analysis | Support volume analysis |
| testcriticaldistance | Read | Number | Returns 1 the test passed, 0 otherwise | Wall thickness analysis |
| updownskinanalysiswassuccessful | Read | Boolean | Returns true if no errors occurred during the calculation of the analysis | Upskin/Downskin analysis |
| upskinangle | Read | Number | Returns the entered upskin angle threshold between the Z plane and the triangle | Upskin/Downskin analysis |
| upskinarea | Read | Number | Returns the total area of all upskin triangles | Upskin/Downskin analysis |
| upskincomponentcount | Read | Number | Returns the number of upskin components | Upskin/Downskin analysis |
| wallthicknessanalysiswassuccessful | Read | Boolean | Returns true if no errors occurred during the calculation of the analysis | Wall thickness analysis |
| wallthicknessareabelowthreshold | Read | Number | Returns the area below the wallthicknesscriticaldistance threshold | Wall thickness analysis |
| wallthicknessclustercount | Read | Number | Returns the number of detected clusters | Wall thickness analysis |
| wallthicknesscriticaldistance | Read | Number | Returns the entered failing threshold in mm below which the cluster's area counts towards the failed area | Wall thickness analysis |
| wallthicknesscriticalsurface | Read | Number | Returns the entered percentage threshold of the surface below which the test fails | Wall thickness analysis |
| wallthicknesslargestclusterarea | Read | Number | Returns the area of the largest cluster | Wall thickness analysis |
Methods
| Name | Syntax | Description |
|---|---|---|
| createdefaultanalysis | partanalyser:createdefaultanalysis() | Runs a default analysis on the given part |
| createcenterofgravityanalysis | partanalyser: createcenterofgravityanalysis() | Runs a center of gravity analysis on the given part |
| createshadowareaanalysis | partanalyser:createshadowareaanalysis() | Runs a shadow area analysis on the given part |
| createsupportvolumeanalysis | partanalyser:createsupportvolumeanalysis (Angle:number) | Runs a shadow area analysis on the given part. Angle: threshold used for support cluster detection |
| createwallthicknessanalysis | partanalyser:createwallthicknessanalysis(Distance, AreaPercentage: number, CancelOnFail: Boolean) | Runs a wall thickness analysis on the given part. Distance: minimal passing wall thickness. AreaPercentage: Area below minimal passing thickness still allowed to pass. CancelOnFail: cancel if test already failing without waiting for result |
| createupskindownskinanalysis | partanalyser:createupskindownskinanalysis( UpskinAngle, DownskinAngle, MinAreaSize:number, FilterSmallTriangles:Boolean) | Runs a upskin downskin analysis on the given part. UpskinAngle: minimum angle between triangle and z plane to be counted as upskin. DownskinAngle: minimum angle between triangle and Z plane to be counted as downskin. MinAreaSize: minimal area a cluster must have to count towards the upskin or downskin. FilterSmallTriangles: flag to exclude very small triangles. |
| createsimpleupskindownskinanalysis | partanalyser:createsimpleupskindownskinanalysis(UpskinAngle, DownskinAngle,) | Runs a simple upskin downskin analysis on the given part. UpskinAngle: minimum angle between triangle and z plane to be counted as upskin. DownskinAngle: minimal angle between triangle and z plane to be counted as downskin |