Posemagnify

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - 4Bar/Linkages
Introduced first in SolidGeometry 5.1, Creation date: 2022-01-20, Last change: 2025-09-15

scales the size of Pose struct dimensions

See Also: PosetransrelCPLE , PosetransrelGPL , Posetransui

Example Illustration

Syntax

PS=Posemagnify(PS,m)

Input Parameter

`PS`:		Pose
`m`:		magnification factor

Output Parameter

PS: Magnified Pose struct

Copyright 2022-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, Posemagnify, is designed to scale the dimensions of a Pose structure by a given magnification factor. It is part of the SolidGeometry library and was introduced in version 5.1. The function is authored by Tim C. Lueth and is categorized under Kinematics and Frames.

Input Parameters

PS: A Pose structure that contains various fields representing different dimensions or components of a pose.
m: A magnification factor by which the dimensions of the Pose structure will be scaled.
varargin: Additional optional parameters, though not explicitly used in the function.

Output

PS: The modified Pose structure with its dimensions scaled by the magnification factor.

Algorithm Steps

The function begins by retrieving all function parameters using getfuncparams, though this is not used further in the code.
A copy of the original Pose structure, PSO, is created for potential plotting purposes.
The function checks for the presence of specific fields within the Pose structure and scales them by the magnification factor m if they exist:

A: Scaled by m if present.
B: Scaled by m if present.
CPLE: Scaled by m if present.
CPLM: Scaled by m if present.
CPLW: Scaled by m if present.
CPLB: Scaled by m if present.
solut: The first 12 columns are scaled by m if the field is present.

Note that the RACK field is commented out, indicating that it will not be changed even if present.
If no output is requested (i.e., nargout == 0), the function will plot the original and magnified Pose structures using SGfigure and Poseplot.

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