update packages

[CreaPhase.git] / octave_packages / m / plot / semilogxerr.m

diff --git a/octave_packages/m/plot/semilogxerr.m b/octave_packages/m/plot/semilogxerr.m
new file mode 100644 (file)
index 0000000..f9d6a6c
--- /dev/null
+++ b/octave_packages/m/plot/semilogxerr.m
@@ -0,0 +1,69 @@
+## 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
+## <http://www.gnu.org/licenses/>.
+
+## -*- texinfo -*-
+## @deftypefn {Function File} {} semilogxerr (@var{args})
+## Produce two-dimensional plots using a logarithmic scale for the @var{x}
+## axis and errorbars at each data point.  Many different combinations of
+## arguments are possible.  The most used form is
+##
+## @example
+## semilogxerr (@var{x}, @var{y}, @var{ey}, @var{fmt})
+## @end example
+##
+## @noindent
+## which produces a semi-logarithmic plot of @var{y} versus @var{x}
+## with errors in the @var{y}-scale defined by @var{ey} and the plot
+## format defined by @var{fmt}.  See @code{errorbar} for available formats and
+## additional information.
+## @seealso{errorbar, loglogerr, semilogyerr}
+## @end deftypefn
+
+## Created: 20.2.2001
+## Author: Teemu Ikonen <tpikonen@pcu.helsinki.fi>
+## Keywords: errorbar, plotting
+
+function retval = semilogxerr (varargin)
+
+  [h, varargin] = __plt_get_axis_arg__ ("semilogxerr", varargin{:});
+
+  oldh = gca ();
+  unwind_protect
+    axes (h);
+    newplot ();
+
+    set (h, "xscale", "log");
+
+    tmp = __errcomm__ ("semilogxerr", h, varargin{:});
+
+    if (nargout > 0)
+      retval = tmp;
+    endif
+  unwind_protect_cleanup
+    axes (oldh);
+  end_unwind_protect
+
+endfunction
+
+%!demo
+%! clf
+%! x = exp (log(0.01):0.2:log(10));
+%! y = wblpdf (x, 2, 2);
+%! ey = 0.5*rand (size (y)) .* y;
+%! semilogxerr (x, y, ey, "#~x-")
+%! xlim (x([1, end]))