Home > freetb4matlab > plot > plotmatrix.m

# plotmatrix

## PURPOSE

% Scatter plot of the columns of one matrix against another. Given the

## SYNOPSIS

function [h, ax, bigax, p, pax] = plotmatrix (varargin)

## DESCRIPTION

```% -*- texinfo -*-
% @deftypefn {Function File} {} plotmatrix (@var{x}, @var{y})
% @deftypefnx {Function File} {} plotmatrix (@var{x})
% @deftypefnx {Function File} {} plotmatrix (@dots{}, @var{style})
% @deftypefnx {Function File} {} plotmatrix (@var{h}, @dots{})
% @deftypefnx {Function File} {[@var{h}, @var{ax}, @var{bigax}, @var{p}, @var{pax}] =} plotmatrix (@dots{})
% Scatter plot of the columns of one matrix against another.  Given the
% arguments @var{x} and @var{y}, that have a matching number of rows,
% @code{plotmatrix} plots a set of axes corresponding to
%
% @example
% plot (@var{x} (:, i), @var{y} (:, j)
% @end example
%
% Given a single argument @var{x}, then this is equivalent to
%
% @example
% plotmatrix (@var{x}, @var{x})
% @end example
%
% @noindent
% except that the diagonal of the set of axes will be replaced with the
% histogram @code{hist (@var{x} (:, i))}.
%
% The marker to use can be changed with the @var{style} argument, that is a
% string defining a marker in the same manner as the @code{plot}
% command.  If a leading axes handle @var{h} is passed to
% @code{plotmatrix}, then this axis will be used for the plot.
%
% The optional return value @var{h} provides handles to the individual
% graphics objects in the scatter plots, whereas @var{ax} returns the
% handles to the scatter plot axis objects.  @var{bigax} is a hidden
% axis object that surrounds the other axes, such that the commands
% @code{xlabel}, @code{title}, etc, will be associated with this hidden
% axis.  Finally @var{p} returns the graphics objects associated with
% the histogram and @var{pax} the corresponding axes objects.
%
% @example
% @group
% plotmatrix (randn (100, 3), 'g+')
% @end group
% @end example
%
% @end deftypefn```

## CROSS-REFERENCE INFORMATION

This function calls:
• axes % Create an axes object and return a handle to it.
• bar % Produce a bar graph from two vectors of x-y data.
• gca % Return a handle to the current axis object. If no axis object
• hist % Produce histogram counts or plots.
• newplot % Prepare graphics engine to produce a new plot. This function should
• plot % Produces two-dimensional plots. Many different combinations of
• text % Create a text object with text @var{label} at position @var{x},
This function is called by:

Generated on Sat 16-May-2009 00:04:49 by m2html © 2003