SGTframeChain

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Kinematics and Frames
Introduced first in SolidGeometry 3.9, Creation date: 2017-06-26, Last change: 2025-09-14

returns a list of frame connections for a cell list if solids

Description

Auxiliary function called from SGTchain. The funxtion can be used to create a frame-link-table of cell elements. The frame-link-table format is
[BaseNr FFrame-SG1ind BFrame-SG2ind SG1ind SG2ind]
BaseNr: Nr of SG in the final cell list; 0=origin
FFrame: Namestring of first (SG1ind) element's frame
BFrame: Namestring of second (SG2ind) element's frame
SG1ind: Index of first element in Geometry List SGc
SG2ind: Index of second element in Geometry List SGc

(Recommendation by Simon Schiele)
NEW FORMAT IN SG-LIB 4.7 (MANDATORY FOR MORE THAN 31 ELEMENTS): Use {} instead of [];
Instead: [SG1ind FFrame SG2ind BFrame] such as [1 'F' 2 'B']
now use: {SG1ind FFrame SG2ind BFrame} such as {1 'F' 2 'B'}

See Also: SGTchain

Example Illustration

 missing image of SGTframeChain(nums,extr,B,F)

Syntax

[LFrm,LL,CCstr]=SGTframeChain(nums,[extr,B,F])

Input Parameter

nums: number, or list of chain elements
extr: extra chaining [SG1ind FFrame SG2ind BFrame] such as [1 'F' 2 'B']
B: Standard Base frame string; default is 'B'
F: Standard follower frame string; default is 'F'

Output Parameter

LFrm: Link Frame Tabe
LL: Link list [start index , End index] in SGc
CCstr: compiled string like the extra chaining

Examples


SGTframeChain(6)
SGTframeChain(1:3,'','BX','FX')
SGTframeChain(1:3,[3 'F' 4 'B'],'BX','FX')
SGTframeChain(1:7,[7 'F1' 8 'B' 7 'F2' 8 'B' 7 'F3' 8 'B'])
SGTframeChain(1:7,{7 'F1' 8 'B' 7 'F2' 8 'B' 7 'F3' 8 'B'}) % New format required for 32 or more elements




Copyright 2017-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

Last html export of this page out of FM database by TL: 2025-09-21