matrixPLplot

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Auxiliary function
Introduced first in SolidGeometry 4.9, Creation date: 2020-01-08, Last change: 2025-09-14

plots a matrix and a point list

Description

shows the result of path planning

See Also: matrixplot

Example Illustration

Syntax

h=matrixPLplot(M,PL)

Input Parameter

`M`:		Matrix entries
`PL`:		[r c] or [y x] list

Output Parameter

h: handle to graphics objects

Examples


matrixdistancefield(M,[20 70;80 50]); M=ans; whos M
SGfigure; matrixPLplot(M,[1 1; 100 50])

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, matrixPLplot, is designed to plot a matrix and a point list. It is part of the SG-Library and was created by Tim Lueth. The function is used to visualize the result of path planning.

Input Parameters

M: This is the matrix that contains the data to be plotted. Each entry in the matrix represents a value that will be visualized in the plot.
PL: This is a list of points, either in the format [r c] or [y x], which represents the coordinates of points to be plotted on top of the matrix.

Output Results

h: This is the handle to the graphics objects created by the function. It allows further manipulation or querying of the plot after it has been created.

Algorithm Steps

The function begins by calling matrixplot(M), which plots the matrix M. This function is assumed to create a visual representation of the matrix data.
The handle h is initialized with the result of matrixplot(M).
The function PLplot is called with the flipped version of PL and the color 'r-' to plot the point list on top of the matrix. The flipping of PL suggests that the input list is transformed from [r c] to [c r] or [y x] to [x y] before plotting.
The handle h is updated to include the handle from PLplot, allowing both the matrix and the point list to be manipulated together.

The function is straightforward, focusing on plotting a matrix and overlaying a point list. It is useful for visualizing path planning results, where the matrix might represent a grid or map, and the point list represents a path or series of waypoints.

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