by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Auxiliary function
Introduced first in SolidGeometry 1.0, Creation date: 2013-01-04, Last change: 2025-09-14
[VL1,ELn,EL1,varargout]=VLELcat(VL1,EL1,[])
VL1: | Vertex list 1 | |
EL1: | Vertex list 2 |
[1,EL1,) - returns the connection of several VLs and ELs
% (by Tim Lueth, SG-Lib, 2013-JAN-04 as class: AUXILIARY PROCEDURES)
%
% VLELcat uses VLELcat2 - the simple concatenation
%
% The n vertex lists are just concatenated, also the n edge lists are just
% concatenated. The variable output parameter are the changed edge lists from 2
% to n. (Status of: 2025-08-18)
%
% Introduced first in SolidGeometry 1.0
%
% [VL1,ELn,EL1,varargout]=VLELcat(VL1,EL1,[])
% === INPUT PARAMETERS ===
% VL1: Vertex list 1
% EL1: Vertex list 2
% === OUTPUT RESULTS ======
% [L1,ELn,EL1,varargout]=VLELcat (VL1,EL1,varargin)
%
% ELn=EL1]: Concatenated vertex list
% [L1,ELn,EL1,varargout]=VLELcat (VL1,EL1,varargin)
%
% ELn=EL1]: Concatenated edge list
% EL1: corrected edge list EL1
% varargout: corrected edge list EL2 ... ELn
%
%
% Copyright 2013-2025 Tim C. Lueth
function [VL1,ELn,EL1,varargout]=VLELcat (VL1,EL1,varargin)
ELn=EL1]: | Concatenated vertex list | |
[1,EL1,) - returns the connection of several VLs and ELs
% (by Tim Lueth, SG-Lib, 2013-JAN-04 as class: AUXILIARY PROCEDURES)
%
% VLELcat uses VLELcat2 - the simple concatenation
%
% The n vertex lists are just concatenated, also the n edge lists are just
% concatenated. The variable output parameter are the changed edge lists from 2
% to n. (Status of: 2025-08-18)
%
% Introduced first in SolidGeometry 1.0
%
% [VL1,ELn,EL1,varargout]=VLELcat(VL1,EL1,[])
% === INPUT PARAMETERS ===
% VL1: Vertex list 1
% EL1: Vertex list 2
% === OUTPUT RESULTS ======
% [L1,ELn,EL1,varargout]=VLELcat (VL1,EL1,varargin)
%
% ELn=EL1]: Concatenated vertex list
% [L1,ELn,EL1,varargout]=VLELcat (VL1,EL1,varargin)
%
% ELn=EL1]: Concatenated edge list
% EL1: corrected edge list EL1
% varargout: corrected edge list EL2 ... ELn
%
%
% Copyright 2013-2025 Tim C. Lueth
function [VL1,ELn,EL1,varargout]=VLELcat (VL1,EL1,varargin)
ELn=EL1]: | Concatenated edge list | |
EL1: | corrected edge list EL1 | |
varargout: | corrected edge list EL2 ... ELn |
This function, VLELcat, is designed to concatenate multiple vertex lists (VLs) and edge lists (ELs). It is part of the SolidGeometry library and was introduced by Tim Lueth.
The function begins by initializing ELn to EL1. It also prepares a cell array varargout to store the corrected edge lists for each additional pair of vertex and edge lists provided in varargin.
The function then enters a loop, iterating over the additional vertex and edge list pairs. The loop increments by 2 because each pair consists of a vertex list and an edge list. For each pair, the function calls VLELcat2, a helper function that performs the actual concatenation of the current vertex and edge lists with the new pair.
Within each iteration, the function updates VL1 and ELn with the results from VLELcat2. It also stores the corrected edge list in the varargout array.
By the end of the loop, VL1 contains the concatenated vertex list, ELn contains the concatenated edge list, and varargout contains the corrected edge lists for each additional pair.