Improvements to documentation, and creation of a tests directory for future development.

Author: tobydriscoll

@annulusmap/annulusmap.m

@@ -1,11 +1,11 @@
 function map = annulusmap(rgn)
 %ANNULUSMAP Solve the nonlinear system for D-SC parameter.
-
 %   ANNULUSMAP(RGN) solves the nonlinear system for D-SC parameter of a
-%   doubly connected region RGN. RGN is an object of DSCPOLYGONS.
+%   doubly connected region RGN as created by DSCPOLYGONS.
 %
 %   See also DSCPOLYGONS.
-%   Written by Alfa Heryudono, 2003.
+
+%   Copyright by Alfa Heryudono, 2003.
 
 % Get inner and outer polygons from region rgn
 [p1 p0] = get(rgn);

@annulusmap/display.m

@@ -1,8 +1,8 @@
 function display(map)
-%   Pretty-print D-SC parameters.
+%DISPLAY   Pretty-print D-SC parameters.
+%   Called automatically when a map is displayed at the command line.
 
-%   Modification of POLYGON/DISPLAY.m
-%   Modified by Alfa Heryudono, 2003.
+%   Copyright by Alfa Heryudono, 2003.
 
 fprintf('\n%s = DSC annulusmap:\n\n',inputname(1))
 if imag(map.c) < 0

@annulusmap/dscinvmap.m

@@ -1,15 +1,14 @@
-function w = dscinvmap(z,map)
-% DSCINVMAP Map a pt z to a pt w
+function w = dscinvmap(map,z)
+%DSCINVMAP   Values of the inverse map.
+%   DSCINVMAP(MAP,Z) finds the inverse image of a point Z under the annulusmap 
+%   MAP. That is, it maps from the DC polygonal domain MAP.REGION to the
+%   annulus.
+%
+% See also ANNULUSMAP, ANNULUSMAP.DSCMAP.
 
-% DSCINVMAP(z,map) maps a pt z in the doubly connected region to the
-% annulus. map is an annulusmap object.
+% Copyright by Alfa Heryudono, 2003. 
 
-% see @annulusmap/annulusmap.m
-
-% check if z is in the doubly connected region
-% Not implemented yet.
-%----------------------
-%----------------------
+% TODO: check if z is in the doubly connected region
 
 % z is not allowed to be a vertex.
 % check if z is in Z0.

@annulusmap/plot.m

@@ -1,13 +1,13 @@
 function plot(map,varargin)
-%PLOT Create the graphical representation of the annulusmap.
-%   PLOT(map) creates the graphical representation of the annulusmap.
+%PLOT Graphical representation of an annulusmap.
+%   PLOT(MAP) creates a graphical representation of the annulusmap MAP.
 %   
 %   PLOT(map,'num') or PLOT(map,'lab') also plots dots for the vertices and
 %   numeric labels of inner polygon and outer polygon. For infinite vertices, 
 %   two numeric labels are printed.
 
 %   Modification of dplot.
-%   Modified by Alfa Heryudono, 2003.
+%   Copyright by Alfa Heryudono, 2003.
 
 % Plot the outer and inner polygon first.
 if nargin >1

test.m tests/dctests.m

@@ -1,5 +1,7 @@
+% Tests of doubly-connected maps.
+
 clf;
-IPOLY = 1;
+IPOLY = 4;
 
 % In the file dscsolv.m, between line 98 and 116
 % nonlinear solver can use nesolve, sdogleg, or fsolve (optim toolbox).