TLplots

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Kinematics and Frames
Introduced first in SolidGeometry 5.1, Creation date: 2021-03-14, Last change: 2025-09-15

plots a list of HT matrices with plane, normal vector and prthogonal vectors

Description

completely different to tlplot

See Also: tplot , VLNLOLplot

Example Illustration

Syntax

h=TLplots(TL,[]);

Input Parameter

TL: Lust of HT matrices

Output Parameter

h: handle to graphics

Examples


SGfigure(-30,30); TLplots(TLofCVL(VLsample(8),03));

Copyright 2021-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, TLplots, is designed to plot a list of homogeneous transformation (HT) matrices, displaying the plane, normal vector, and orthogonal vectors. It is part of the SolidGeometry library and was introduced in version 5.1.

Input Parameters

TL: A list of HT matrices. These matrices are used to extract vectors for plotting.
varargin: This is a variable-length input argument list, allowing for additional parameters if needed, though not explicitly used in the function.

Output Results

h: A handle to the graphics object created by the plot. This handle can be used for further manipulation or querying of the plot.

Algorithm Steps

The function begins by extracting specific components from the input list of HT matrices, TL:
- VL: Extracted from the fourth column of the first three rows of each matrix in TL. This represents the Z vector.
- NL: Extracted from the second column of the first three rows of each matrix in TL. This represents the Y vector.
- OL: Extracted from the first column of the first three rows of each matrix in TL. This represents the X vector.
The function then calls VLNLOLplot with the extracted vectors VL, NL, and OL as arguments. This function is responsible for plotting the vectors and returning a handle to the graphics object.
The handle h is returned as the output of the function.

Example Usage

An example of how to use this function is provided in the comments:

SGfigure(-30,30); 
TLplots(TLofCVL(VLsample(8),03));

This example suggests setting up a figure with a specific range and then plotting a list of HT matrices generated by TLofCVL and VLsample.

Note: The function relies on another function, VLNLOLplot, to perform the actual plotting, which is not detailed here.

Algorithm explaination created using ChatGPT on 2025-08-18 22:42. (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