Home > freetb4matlab > statistics > nanstd.m

# nanstd

## PURPOSE

% Compute the standard deviation while ignoring NaN values.

## SYNOPSIS

function v = nanstd (X, opt, varargin)

## DESCRIPTION

% -*- texinfo -*-
% @deftypefn {Function File} {@var{v} =} nanstd (@var{X})
% @deftypefnx{Function File} {@var{v} =} nanstd (@var{X}, @var{opt})
% @deftypefnx{Function File} {@var{v} =} nanstd (@var{X}, @var{opt}, @var{dim})
% Compute the standard deviation while ignoring NaN values.
%
% @code{nanstd} is identical to the @code{std} function except that NaN values are
% ignored.  If all values are NaN, the standard deviation is returned as NaN.
% If there is only a single non-NaN value, the deviation is returned as 0.
%
% The argument @var{opt} determines the type of normalization to use. Valid values
% are
%
% @table @asis
% @item 0:
%   normalizes with @math{N-1}, provides the square root of best unbiased estimator of
%   the variance [default]
% @item 1:
%   normalizes with @math{N}, this provides the square root of the second moment around
%   the mean
% @end table
%
% The third argument @var{dim} determines the dimension along which the standard
% deviation is calculated.
%
% @seealso{std, nanmin, nanmax, nansum, nanmedian, nanmean}
% @end deftypefn

## CROSS-REFERENCE INFORMATION

This function calls:
This function is called by:

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