annotate scripts/plot/appearance/__clabel__.m @ 20830:b65888ec820e draft default tip gccjit

dmalcom gcc jit import
author Stefan Mahr <dac922@gmx.de>
date Fri, 27 Feb 2015 16:59:36 +0100
parents 4197fc428c7d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
19898
4197fc428c7d maint: Update copyright notices for 2015.
John W. Eaton <jwe@octave.org>
parents: 19367
diff changeset
1 ## Copyright (C) 2008-2015 David Bateman
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
2 ##
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
3 ## This file is part of Octave.
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
4 ##
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
5 ## Octave is free software; you can redistribute it and/or modify it
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
6 ## under the terms of the GNU General Public License as published by
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
7 ## the Free Software Foundation; either version 3 of the License, or (at
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
8 ## your option) any later version.
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
9 ##
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
10 ## Octave is distributed in the hope that it will be useful, but
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
11 ## WITHOUT ANY WARRANTY; without even the implied warranty of
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
12 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
13 ## General Public License for more details.
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
14 ##
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
15 ## You should have received a copy of the GNU General Public License
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
16 ## along with Octave; see the file COPYING. If not, see
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
17 ## <http://www.gnu.org/licenses/>.
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
18
8812
7d48766c21a5 use consistent format for doc strings of internal functions
John W. Eaton <jwe@octave.org>
parents: 8507
diff changeset
19 ## -*- texinfo -*-
7d48766c21a5 use consistent format for doc strings of internal functions
John W. Eaton <jwe@octave.org>
parents: 8507
diff changeset
20 ## @deftypefn {Function File} {@var{h} =} __clabel__ (@var{c}, @var{v}, @var{hparent}, @var{label_spacing}, @var{z}, @var{varargin})
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
21 ## Undocumented internal function.
8812
7d48766c21a5 use consistent format for doc strings of internal functions
John W. Eaton <jwe@octave.org>
parents: 8507
diff changeset
22 ## @end deftypefn
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
23
8507
cadc73247d65 style fixes
John W. Eaton <jwe@octave.org>
parents: 8289
diff changeset
24 function h = __clabel__ (c, v, hparent, label_spacing, z, varargin)
17176
abf384f5d243 maint: Remove unneeded input validation from internal fcns in private/ directories.
Rik <rik@octave.org>
parents: 14868
diff changeset
25
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
26 hax = ancestor (hparent, "axes");
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
27 units = get (hax, "units");
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
28 set (hax, "units", "points");
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
29 axpos = get (hax, "position");
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
30 set (hax, "units", units);
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
31 lims = axis ();
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
32 xspacing = axpos(3) / (lims(2) - lims (1));
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
33 yspacing = axpos(4) / (lims(4) - lims (3));
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
34
14868
5d3a684236b0 maint: Use Octave coding conventions for cuddling parentheses in scripts directory
Rik <octave@nomad.inbox5.com>
parents: 14138
diff changeset
35 if (isscalar (hparent) && ishandle (hparent)
11149
fe3c3dfc07eb style fix: break lines before && and ||, not after
John W. Eaton <jwe@octave.org>
parents: 10549
diff changeset
36 && strcmp (get (hparent, "type"), "hggroup"))
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
37 x = get (hparent, "xdata");
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
38 xmin = min (x(:));
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
39 xmax = max (x(:));
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
40 y = get (hparent, "ydata");
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
41 ymin = min (y(:));
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
42 ymax = max (y(:));
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
43 else
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
44 xmin = xmax = ymin = ymax = NaN;
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
45 i = 1;
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
46 while (i < length (c))
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
47 clen = c(2,i);
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
48 data = c(:, i+(1:clen));
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
49
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
50 xmin = min ([xmin, data(1,:)]);
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
51 xmax = max ([xmax, data(1,:)]);
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
52 ymin = min ([ymin, data(2,:)]);
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
53 ymax = max ([ymax, data(2,:)]);
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
54
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
55 i += clen+1;
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
56 endwhile
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
57 endif
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
58
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
59 ## Decode contourc output format and place labels.
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
60 h = [];
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
61 i = 1;
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
62 while (i < length (c))
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
63 clev = c(1,i);
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
64 clen = c(2,i);
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
65
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
66 if (! isempty (v) && ! any (v == clev))
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
67 i += clen+1;
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
68 continue;
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
69 endif
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
70
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
71 p = bsxfun (@times, c(:, i+(1:clen)), [xspacing; yspacing]);
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
72 d = sqrt (sumsq (diff (p, 1, 2)));
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
73 cumd = cumsum (d);
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
74 td = cumd(end);
8507
cadc73247d65 style fixes
John W. Eaton <jwe@octave.org>
parents: 8289
diff changeset
75 ntag = ceil (td / label_spacing);
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
76
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
77 if (all (c(:,i+1) == c(:,i+clen)))
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
78 ## Closed contour
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
79 ## FIXME: This spreads the tags uniformly around the contour which
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
80 ## looks nice, but it does not respect the label_spacing attribute.
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
81 ## Should we follow user input, which can result in two labels being
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
82 ## quite close to each other?
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
83 spacing = td / ntag;
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
84 pos = spacing/2 + spacing*[0:ntag-1];
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
85 else
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
86 ## Open contour
14868
5d3a684236b0 maint: Use Octave coding conventions for cuddling parentheses in scripts directory
Rik <octave@nomad.inbox5.com>
parents: 14138
diff changeset
87 pos = zeros (1, ntag);
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
88 pos(1) = (td - label_spacing*(ntag - 1)) / 2;
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
89 pos(2:ntag) = pos(1) + label_spacing*[1:ntag-1];
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
90 endif
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
91
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
92 tlabel = sprintf ("%.5g", clev);
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
93
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
94 for tagpos = pos
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
95
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
96 j = find (cumd > tagpos, 1);
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
97 if (isempty (j))
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
98 j = clen;
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
99 endif
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
100 tpos = sum (c(:,i+j-1:i+j), 2) / 2;
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
101
17176
abf384f5d243 maint: Remove unneeded input validation from internal fcns in private/ directories.
Rik <rik@octave.org>
parents: 14868
diff changeset
102 if ( tpos(1) != xmin && tpos(1) != xmax
abf384f5d243 maint: Remove unneeded input validation from internal fcns in private/ directories.
Rik <rik@octave.org>
parents: 14868
diff changeset
103 && tpos(2) != ymin && tpos(2) != ymax)
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
104 trot = 180 / pi * atan2 (diff (c(2,i+j-1:i+j)),
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
105 diff (c(1,i+j-1:i+j)));
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
106 if (abs (trot) > 90)
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
107 trot += 180;
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
108 endif
10549
95c3e38098bf Untabify .m scripts
Rik <code@nomad.inbox5.com>
parents: 9896
diff changeset
109 if (ischar (z))
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
110 ht = text (tpos(1), tpos(2), clev, tlabel, "rotation", trot,
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
111 "horizontalalignment", "center", "userdata", clev,
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
112 "parent", hparent, varargin{:});
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
113 elseif (! isempty (z))
11587
c792872f8942 all script files: untabify and strip trailing whitespace
John W. Eaton <jwe@octave.org>
parents: 11523
diff changeset
114 ht = text (tpos(1), tpos(2), z, tlabel, "rotation", trot,
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
115 "horizontalalignment", "center", "userdata", clev,
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
116 "parent", hparent, varargin{:});
10549
95c3e38098bf Untabify .m scripts
Rik <code@nomad.inbox5.com>
parents: 9896
diff changeset
117 else
95c3e38098bf Untabify .m scripts
Rik <code@nomad.inbox5.com>
parents: 9896
diff changeset
118 ht = text (tpos(1), tpos(2), tlabel, "rotation", trot,
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
119 "horizontalalignment", "center", "userdata", clev,
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
120 "parent", hparent, varargin{:});
10549
95c3e38098bf Untabify .m scripts
Rik <code@nomad.inbox5.com>
parents: 9896
diff changeset
121 endif
95c3e38098bf Untabify .m scripts
Rik <code@nomad.inbox5.com>
parents: 9896
diff changeset
122 h = [h; ht];
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
123 endif
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
124 endfor
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
125 i += clen+1;
8289
ac7f334d9652 Add contour group objects and the clabel function
David Bateman <dbateman@free.fr>
parents:
diff changeset
126 endwhile
17470
576cf0589c6d Overhaul contour labeling functions.
Rik <rik@octave.org>
parents: 17338
diff changeset
127
14868
5d3a684236b0 maint: Use Octave coding conventions for cuddling parentheses in scripts directory
Rik <octave@nomad.inbox5.com>
parents: 14138
diff changeset
128 endfunction
17338
1c89599167a6 maint: End m-files with 1 blank line.
Rik <rik@octave.org>
parents: 17176
diff changeset
129
19367
cd554c5b65ee Mark __clabel__ and __getlegenddata__ as internal functions not requiring BIST.
Rik <rik@octave.org>
parents: 17744
diff changeset
130
cd554c5b65ee Mark __clabel__ and __getlegenddata__ as internal functions not requiring BIST.
Rik <rik@octave.org>
parents: 17744
diff changeset
131 ## No test needed for internal helper function.
cd554c5b65ee Mark __clabel__ and __getlegenddata__ as internal functions not requiring BIST.
Rik <rik@octave.org>
parents: 17744
diff changeset
132 %!assert (1)
cd554c5b65ee Mark __clabel__ and __getlegenddata__ as internal functions not requiring BIST.
Rik <rik@octave.org>
parents: 17744
diff changeset
133