SGTcopyinteralframes

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Kinematics and Frames
Introduced first in SolidGeometry 5.0, Creation date: 2020-10-15, Last change: 2025-09-15

copies frames of a solid which are located into the goal solid

Description

This function is required after cutting a solid into two pieces to find the corresponding frames for each piece

See Also: SGTcopy , SGTcopynames

Example Illustration

missing image of SGTcopyinteralframes(SGA,SGB)

Syntax

SGN=SGTcopyinteralframes(SGA,SGB)

Input Parameter

`SGA`:		Solid to add the frames to
`SGB`:		Solid to copy the frames from

Output Parameter

SGN: Final Solid including the frames ot the Origina

Examples


load ADAM_Aframes.mat; SG=ADAM_Aframes
CPLofSGcutT(SG,SGTget(SG,'VL'),[0 0]); CPL=ans; 
SGofCPLz(CPLbuffer(CPL,1),[-0.5 0.5],SGTget(SG,'VL')); SGX=ans; 
A=SGsubtract(SG,SGX)
SGsurfaces(A); A=ans; B=A{2}; C=A{1};

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, SGTcopyinteralframes, is designed to copy frames from one solid (SGB) to another (SGA) if they are located within the interior of SGA. It is part of the SolidGeometry library and is used after cutting a solid into two pieces to ensure that the corresponding frames are correctly assigned to each piece.

Input Parameters

SGA: The solid to which frames will be added.
SGB: The solid from which frames will be copied.

Output

SGN: The resulting solid, which includes the frames from the original solid (SGB) that are located within SGA.

Algorithm Steps

Initialize the output solid SGN as SGA.
Iterate over each frame in SGB using a loop:

For each frame, check if its position (extracted from the transformation matrix SGB.T{i}(1:3,4)) is inside SGA using the function SGisInterior.
If the frame is inside SGA, copy it to SGN using the function SGTcopy, passing the frame's name SGB.Tname{i}.

If no output argument is specified (nargout==0), plot the resulting solid SGN using SGfigure and SGTplotalpha with a white color ('w').

Example Usage

The example provided in the comments demonstrates loading a solid, cutting it, and then using this function to ensure frames are correctly assigned to the resulting pieces.

Algorithm explaination created using ChatGPT on 2025-08-19 01:02. (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