X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?p=CreaPhase.git;a=blobdiff_plain;f=octave_packages%2Fm%2Fplot%2Ferrorbar.m;fp=octave_packages%2Fm%2Fplot%2Ferrorbar.m;h=d95dc783260916f606ca31b1b3767432770e90ca;hp=0000000000000000000000000000000000000000;hb=1c0469ada9531828709108a4882a751d2816994a;hpb=63de9f36673d49121015e3695f2c336ea92bc278 diff --git a/octave_packages/m/plot/errorbar.m b/octave_packages/m/plot/errorbar.m new file mode 100644 index 0000000..d95dc78 --- /dev/null +++ b/octave_packages/m/plot/errorbar.m @@ -0,0 +1,176 @@ +## Copyright (C) 2000-2012 Teemu Ikonen +## +## This file is part of Octave. +## +## Octave is free software; you can redistribute it and/or modify it +## under the terms of the GNU General Public License as published by +## the Free Software Foundation; either version 3 of the License, or (at +## your option) any later version. +## +## Octave is distributed in the hope that it will be useful, but +## WITHOUT ANY WARRANTY; without even the implied warranty of +## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +## General Public License for more details. +## +## You should have received a copy of the GNU General Public License +## along with Octave; see the file COPYING. If not, see +## . + +## -*- texinfo -*- +## @deftypefn {Function File} {} errorbar (@var{args}) +## This function produces two-dimensional plots with errorbars. Many +## different combinations of arguments are possible. The simplest form is +## +## @example +## errorbar (@var{y}, @var{ey}) +## @end example +## +## @noindent +## where the first argument is taken as the set of @var{y} coordinates +## and the second argument @var{ey} is taken as the errors of the +## @var{y} values. @var{x} coordinates are taken to be the indices +## of the elements, starting with 1. +## +## If more than two arguments are given, they are interpreted as +## +## @example +## errorbar (@var{x}, @var{y}, @dots{}, @var{fmt}, @dots{}) +## @end example +## +## @noindent +## where after @var{x} and @var{y} there can be up to four error +## parameters such as @var{ey}, @var{ex}, @var{ly}, @var{uy}, etc., +## depending on the plot type. Any number of argument sets may appear, +## as long as they are separated with a format string @var{fmt}. +## +## If @var{y} is a matrix, @var{x} and error parameters must also be matrices +## having same dimensions. The columns of @var{y} are plotted versus the +## corresponding columns of @var{x} and errorbars are drawn from +## the corresponding columns of error parameters. +## +## If @var{fmt} is missing, yerrorbars ("~") plot style is assumed. +## +## If the @var{fmt} argument is supplied, it is interpreted as in +## normal plots. In addition, @var{fmt} may include an errorbar style +## which must precede the line and marker format. The following plot +## styles are supported by errorbar: +## +## @table @samp +## @item ~ +## Set yerrorbars plot style (default). +## +## @item > +## Set xerrorbars plot style. +## +## @item ~> +## Set xyerrorbars plot style. +## +## @item # +## Set boxes plot style. +## +## @item #~ +## Set boxerrorbars plot style. +## +## @item #~> +## Set boxxyerrorbars plot style. +## @end table +## +## Examples: +## +## @example +## errorbar (@var{x}, @var{y}, @var{ex}, ">") +## @end example +## +## @noindent +## produces an xerrorbar plot of @var{y} versus @var{x} with @var{x} +## errorbars drawn from @var{x}-@var{ex} to @var{x}+@var{ex}. +## +## @example +## @group +## errorbar (@var{x}, @var{y1}, @var{ey}, "~", +## @var{x}, @var{y2}, @var{ly}, @var{uy}) +## @end group +## @end example +## +## @noindent +## produces yerrorbar plots with @var{y1} and @var{y2} versus @var{x}. +## Errorbars for @var{y1} are drawn from @var{y1}-@var{ey} to +## @var{y1}+@var{ey}, errorbars for @var{y2} from @var{y2}-@var{ly} to +## @var{y2}+@var{uy}. +## +## @example +## @group +## errorbar (@var{x}, @var{y}, @var{lx}, @var{ux}, +## @var{ly}, @var{uy}, "~>") +## @end group +## @end example +## +## @noindent +## produces an xyerrorbar plot of @var{y} versus @var{x} in which +## @var{x} errorbars are drawn from @var{x}-@var{lx} to @var{x}+@var{ux} +## and @var{y} errorbars from @var{y}-@var{ly} to @var{y}+@var{uy}. +## @seealso{semilogxerr, semilogyerr, loglogerr} +## @end deftypefn + +## Created: 18.7.2000 +## Author: Teemu Ikonen +## Keywords: errorbar, plotting + +function retval = errorbar (varargin) + + [h, varargin] = __plt_get_axis_arg__ ("errorbar", varargin{:}); + + oldh = gca (); + unwind_protect + axes (h); + newplot (); + + tmp = __errcomm__ ("errorbar", h, varargin{:}); + + if (nargout > 0) + retval = tmp; + endif + unwind_protect_cleanup + axes (oldh); + end_unwind_protect + +endfunction + + +%!demo +%! clf +%! rand_1x11_data1 = [0.82712, 0.50325, 0.35613, 0.77089, 0.20474, 0.69160, 0.30858, 0.88225, 0.35187, 0.14168, 0.54270]; +%! rand_1x11_data2 = [0.506375, 0.330106, 0.017982, 0.859270, 0.140641, 0.327839, 0.275886, 0.162453, 0.807592, 0.318509, 0.921112]; +%! errorbar (0:10, rand_1x11_data1, 0.25*rand_1x11_data2); + +%!demo +%! clf +%! rand_1x11_data3 = [0.423650, 0.142331, 0.213195, 0.129301, 0.975891, 0.012872, 0.635327, 0.338829, 0.764997, 0.401798, 0.551850]; +%! rand_1x11_data4 = [0.682566, 0.456342, 0.132390, 0.341292, 0.108633, 0.601553, 0.040455, 0.146665, 0.309187, 0.586291, 0.540149]; +%! errorbar(0:10, rand_1x11_data3, rand_1x11_data4, ">"); + +%!demo +%! clf +%! x = 0:0.5:2*pi; +%! err = x/100; +%! y1 = sin (x); +%! y2 = cos (x); +%! hg = errorbar (x, y1, err, "~", x, y2, err, ">"); + +%!demo +%! clf +%! x = 0:0.5:2*pi; +%! err = x/100; +%! y1 = sin (x); +%! y2 = cos (x); +%! hg = errorbar (x, y1, err, err, "#r", x, y2, err, err, "#~"); + +%!demo +%! clf +%! x = 0:0.5:2*pi; +%! err = x/100; +%! y1 = sin (x); +%! y2 = cos (x); +%! hg = errorbar (x, y1, err, err, err, err, "~>", ... +%! x, y2, err, err, err, err, "#~>-*"); +