PLaddauxpoints

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - PL/Point Lists
Introduced first in SolidGeometry 5.2, Creation date: 2022-03-09, Last change: 2025-09-15

adds auxilary points to an open point list

Description

same as RLaddauxpoints from 2013--807
In contast to this function PLaddauxpoints, the function PLofCPLequidistant returns just equal distant points

See Also: PLofCPLequidistant , RLaddauxpoints , CPLaddauxpoints , CPLremdensity

Example Illustration

Syntax

PLN=PLaddauxpoints(PL,d)

Input Parameter

`PL`:		Open Point list
`d`:		distance of axuilary points

Output Parameter

PLN: New Point list

Examples


CPLF=[-0 -0 ; 0 20; 30 30]; PLaddauxpoints(CPLF,5); 	% Open Contour   PL add...
CPLF=[-0 -0 ; 0 20; 30 30]; RLaddauxpoints(CPLF,5); 	% Closed Contour RL add..
CPLF=[-0 -0 ; 0 20; 30 30]; CPLaddauxpoints(CPLF,5);	% Nested Contours CPL add..

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, PLaddauxpoints, is designed to add auxiliary points to an open point list. It is part of the SolidGeometry library and was introduced in version 5.2. The function is similar to RLaddauxpoints but is specifically for open point lists.

Input Parameters

PL: This is the open point list to which auxiliary points will be added. It is a matrix where each row represents a point in 2D space.
d: This is the distance between the auxiliary points that will be added to the point list.

Output Results

PLN: This is the new point list that includes the original points from PL as well as the newly added auxiliary points.

Algorithm Steps

The function calls RLaddauxpoints with the parameters PL, d, and false. This function is responsible for adding the auxiliary points to the open point list.
If no output argument is specified (i.e., nargout==0), the function will plot the original and new point lists using the SGfigure and PLplot functions. The original points are plotted in red with a star marker and a line width of 2, while the new points are plotted in green with a star marker and a line width of 1.

Example Usage

Here are some examples of how the function can be used:

CPLF=[-0 -0 ; 0 20; 30 30]; PLaddauxpoints(CPLF,5); - This adds auxiliary points to an open contour.
CPLF=[-0 -0 ; 0 20; 30 30]; RLaddauxpoints(CPLF,5); - This adds auxiliary points to a closed contour.
CPLF=[-0 -0 ; 0 20; 30 30]; CPLaddauxpoints(CPLF,5); - This adds auxiliary points to nested contours.

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