FSofSGfacet
by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - FS/Feature Surfaces
Introduced first in SolidGeometry 4.4, Creation date: 2018-11-16, Last change: 2025-09-14
returns the facet index list of a Feature Surface for a given facet index
Description
This function searches for the corresponding feature surface (FS) based on a single facet index (fi).
See Also: , FSofSG
, FSplot
, FSselect
Example Illustration
Syntax
[FIL,fcl]=FSofSGfacet(SG,fi,[alpha])
Input Parameter
SG: | | Solid Geoemtry |
fi: | | Facet index |
alpha: | | Alpha angle; default is .76 |
Output Parameter
FIL: | | Facet index list for one feature surface |
fcl: | | facet connectionlist |
Examples
FSofSGfacet(SGsample(25),210)
FSofSGfacet(SGsample(25))
Copyright 2018-2025 Tim C. Lueth. All rights reserved. The code is the property of Tim C. Lueth and may not be redistributed or modified without explicit written permission. This software may be used free of charge for academic research and teaching purposes only. Commercial use, redistribution, modification, or reverse engineering is strictly prohibited. Access to source code is restricted and granted only under specific agreements. For licensing inquiries or commercial use, please contact: Tim C. Lueth
Algorithm (Workflow)
This function, FSofSGfacet, identifies the feature surface (FS) associated with a given facet index in a solid geometry (SG). It is part of the SG-Library and was introduced in SolidGeometry 4.4.
Input Parameters
- SG: Solid Geometry object.
- fi: Facet index. If not provided, it is selected using
SGselect3d.
- alpha: Alpha angle, with a default value of 0.76 radians.
Output Results
- FIL: List of facet indices for one feature surface.
- fcl: Facet connection list.
Algorithm Steps
- Retrieve the facet index
fi from the input parameters or use SGselect3d to select it if not provided.
- Retrieve the alpha angle from the input parameters, defaulting to 0.76 if not specified.
- Calculate the neighbor angles using
TR3neighborsAngle to get NAL and NBL.
- Determine the feature surface using
neighborsAngleSurface with NAL, NBL, alpha, and fi to obtain FIL and fcl.
- If no output is requested, visualize the result using
SGfigure and SGplot, highlighting the facets and feature surface with annotations.
Example Usage
To use the function, you can call it with a sample solid geometry and a facet index:
FSofSGfacet(SGsample(25), 210)
FSofSGfacet(SGsample(25))
Algorithm explaination created using ChatGPT on 2025-08-19 06:59. (Please note: No guarantee for the correctness of this explanation)
Last html export of this page out of FM database by TL: 2025-09-21