TofSGML
by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Analytical Geometry
Introduced first in SolidGeometry 2.4, Creation date: 2015-08-24, Last change: 2025-09-14
returns HT for a mounting face with known number
Description
Similar to TofSGMLez but here, the faces are seleted by the number
See Also: TofSGMLez
, TofVLUL
, TofVLULez
, MLofSG
, MLplot
, TofcrossedSG
Example Illustration
Syntax
[T,SG]=TofSGML(SG,mi,[fe])
Input Parameter
SG: | | Solid Geometry with defined mounting faces ML, MA |
mi: | | mounting face number |
fe: | | feature edge angle; default is 0.5; used only if ML is not defined |
Output Parameter
T: | | Transformation matrix [4x4] |
SG: | | Solid geometry with defined mounting faces ML, MA |
Examples
load AIM_SGrobot
TofSGML(SG3,2);
Copyright 2015-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, TofSGML, calculates a transformation matrix for a specified mounting face of a solid geometry object. It is part of the Solid Geometry Library and was introduced in version 2.4.
Input Parameters
- SG: A structure representing solid geometry with defined mounting faces (ML, MA).
- mi: An integer representing the mounting face number.
- fe (optional): A feature edge angle, defaulting to 0.5, used only if ML is not defined.
Output Results
- T: A 4x4 transformation matrix.
- SG: The solid geometry structure with defined mounting faces.
Algorithm Steps
- Initialize the feature edge angle
fe to 0.5. If a third argument is provided and is not empty, set fe to this value.
- Check if the solid geometry
SG has defined mounting faces (ML). If not, print a message indicating that mounting facets are being calculated with the given fe value, and call MLofSG to define them.
- Use the function
PLofVLFL to calculate the transformation matrix T for the specified mounting face number mi.
- If no output arguments are requested, plot the solid geometry using
SGfigure and VLFLplot functions. Highlight the specified mounting face in red and others in green. Use plotT to visualize the transformation.
Algorithm explaination created using ChatGPT on 2025-08-19 07:27. (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