SGTgetframeinfo
by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Kinematics and Frames
Introduced first in SolidGeometry 5.0, Creation date: 2020-10-11, Last change: 2025-09-15
returns some basic information about a frame inside a solid
See Also: SGTsetinternalframe
Example Illustration
Syntax
[cinf,CPL,VLC]=SGTgetframeinfo(SG,T)
Input Parameter
SG: | | Solid Geometru |
T: | | Frame |
Output Parameter
cinf: | | crossing information |
CPL: | | crossing contour |
VLC: | | |
Copyright 2020-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, SGTgetframeinfo, is designed to extract information about a frame within a solid geometry. It is part of the SolidGeometry library and was developed by Tim Lueth.
Input Parameters
- SG: Represents the solid geometry object.
- T: A transformation matrix representing the frame.
Output Results
- cinf: An array containing crossing information, specifically the minimum and maximum radii and distances along the z-axis.
- CPLA: The crossing contour of the solid geometry with the frame.
- VLC: The crosspoints of the solid's vertex list and face list with the frame.
Algorithm Steps
- Check if the frame's origin (T(1:3,4)') is inside the solid geometry using
SGisInterior.
- If the frame is inside:
- Calculate the crossing contour
CPLA using CPLofSGcutT with the transformation matrix T.
- Determine the crosspoints
VLC using crosspointsVLFLofT with the solid's vertex list, face list, and the transformation matrix T.
- Convert the crossing contour to polar coordinates to find the minimum and maximum radii (
rmin and rmax).
- Calculate the distances
zmin and zmax from the frame's origin to the crosspoints using vecnormr.
- Store these values in
cinf.
- Transform the crossing contour
CPLA to the frame's coordinate system using VLtransT and VLaddz.
- If no output arguments are specified:
- Plot the solid geometry using
SGfigure and SGplotalpha.
- Plot the transformed crossing contour
CVLA using CVLplot.
Algorithm explaination created using ChatGPT on 2025-08-19 08:14. (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