matlab doc updates

Signed-off-by: Thorsten Liebig <Thorsten.Liebig@gmx.de>
This commit is contained in:
Thorsten Liebig 2013-01-23 09:11:36 +01:00
parent 3b44620278
commit 081038db62
2 changed files with 23 additions and 11 deletions

View File

@ -1,7 +1,7 @@
function [CSX, port] = AddLumpedPort( CSX, prio, portnr, R, start, stop, dir, excite, varargin ) function [CSX, port] = AddLumpedPort( CSX, prio, portnr, R, start, stop, dir, excite, varargin )
% [CSX, port] = AddLumpedPort( CSX, prio, portnr, R, start, stop, dir, excite, varargin ) % [CSX, port] = AddLumpedPort( CSX, prio, portnr, R, start, stop, dir, excite, varargin )
% %
% Add a 3D lumped port as an excitation. % Add a lumped port as an excitation.
% %
% A lumped port consists of an excitation, a lumped resistor, a voltage and % A lumped port consists of an excitation, a lumped resistor, a voltage and
% current probe. % current probe.
@ -18,10 +18,10 @@ function [CSX, port] = AddLumpedPort( CSX, prio, portnr, R, start, stop, dir, ex
% varargin (optional): additional excitations options, see also AddExcitation % varargin (optional): additional excitations options, see also AddExcitation
% %
% example: % example:
% start = [-0.1 -width/2 0]; % start = [0 -width/2 0];
% stop = [ 0.1 width/2 height]; % stop = [0 width/2 height];
% [CSX] = AddLumpedPort(CSX, 5 ,1 , 50, start, stop, [0 0 1], 'excite'); % [CSX] = AddLumpedPort(CSX, 5 ,1 , 50, start, stop, [0 0 1], true);
% this defines a lumped port in z-direction with a 50 Ohm port impedence % %this defines an active lumped port in z-direction with a 50 Ohm port impedence
% %
% openEMS matlab interface % openEMS matlab interface
% ----------------------- % -----------------------

View File

@ -1,5 +1,5 @@
function mesh = AddPML( mesh, numcells, CoordSystem ) function mesh = AddPML( mesh, numcells, CoordSystem )
%mesh = AddPML( mesh, numcells, <CoordSystem> ) % mesh = AddPML( mesh, numcells, <CoordSystem> )
% %
% Adds equidistant cells to the specified directions of the simulation % Adds equidistant cells to the specified directions of the simulation
% area. This is used to put a PML (perfectly matched layer) absorber there. % area. This is used to put a PML (perfectly matched layer) absorber there.
@ -10,19 +10,31 @@ function mesh = AddPML( mesh, numcells, CoordSystem )
% %
% input: % input:
% mesh: mesh structure % mesh: mesh structure
% .x: 1xn vector (lines in x direction)
% .y: 1xn vector (lines in y direction)
% .z: 1xn vector (lines in z direction)
% numcells: 1x6 vector (xmin,xmax,ymin,ymax,zmin,zmax) with number of % numcells: 1x6 vector (xmin,xmax,ymin,ymax,zmin,zmax) with number of
% cells to add to this direction % cells to add to this direction
% CoordSystem (optional): set to 1 in case of cylindrical mesh using
% mesh.r, mesh.a and mesh.z
% %
% output: % output:
% mesh: new mesh % mesh: new mesh with the added lines
%
% example:
% % some fixed mesh lines
% mesh.x = [-100 0 100];
% mesh.y = [-100 0 100];
% mesh.z = [0 500];
% mesh = DetectEdges(CSX, mesh); %detect edges
% mesh = SmoothMesh(mesh, c0/fmax/20/unit); % smooth the mesh
%
% mesh = AddPML(mesh, 8); % add 8 lines to all directions
% % or
% mesh = AddPML(mesh, [0 0 0 0 8 8]); % add 8 lines in both z-directions
%
% See also DefineRectGrid, SmoothMesh, DetectEdges
% %
% openEMS matlab interface % openEMS matlab interface
% ----------------------- % -----------------------
% Sebastian Held <sebastian.held@uni-due.de> % Sebastian Held <sebastian.held@uni-due.de>
% See also DefineRectGrid
% check % check
error( nargchk(2,3,nargin) ); error( nargchk(2,3,nargin) );