sumskipnan

PURPOSE

SYNOPSIS

DESCRIPTION

 SUMSKIPNAN adds all non-NaN values. 

 All NaN's are skipped; NaN's are considered as missing values. 
 SUMSKIPNAN of NaN's only  gives O; and the number of valid elements is return. 
 SUMSKIPNAN is also the elementary function for calculating 
 various statistics (e.g. MEAN, STD, VAR, RMS, MEANSQ, SKEWNESS, 
 KURTOSIS, MOMENT, STATISTIC etc.) from data with missing values.  
 SUMSKIPNAN implements the DIMENSION-argument for data with missing values.
 Also the second output argument return the number of valid elements (not NaNs) 
 
 Y = sumskipnan(x [,DIM])
 [Y,N,SSQ] = sumskipnan(x [,DIM])
 [...] = sumskipnan(x, DIM, W)
 
 x    input data     
 DIM    dimension (default: [])
    empty DIM sets DIM to first non singleton dimension    
 W    weight vector for weighted sum, numel(W) must fit size(x,DIM)
 Y    resulting sum
 N    number of valid (not missing) elements
 SSQ    sum of squares

 the function FLAG_NANS_OCCURED() returns whether any value in x
  is a not-a-number (NaN)

 features:
 - can deal with NaN's (missing values)
 - implements dimension argument. 
 - computes weighted sum 
 - compatible with Matlab and Octave

 see also: FLAG_NANS_OCCURED, SUM, NANSUM, MEAN, STD, VAR, RMS, MEANSQ,
      SSQ, MOMENT, SKEWNESS, KURTOSIS, SEM

CROSS-REFERENCE INFORMATION

• flag_implicit_skip_nan FLAG_IMPLICIT_SKIP_NAN sets and gets default mode for handling NaNs

• center CENTER removes the mean
• coefficient_of_variation COEFFICIENT_OF_VARIATION returns STD(X)/MEAN(X)
• cor COR calculates the correlation matrix
• corrcoef CORRCOEF calculates the correlation matrix from pairwise correlations.
• covm COVM generates covariance matrix
• geomean GEOMEAN calculates the geomentric mean of data elements.
• harmmean HARMMEAN calculates the harmonic mean of data elements.
• kurtosis KURTOSIS estimates the kurtosis
• mad MAD estimates the Mean Absolute deviation
• mean MEAN calculates the mean of data elements.
• meandev MEANDEV estimates the Mean deviation
• meansq MEANSQ calculates the mean of the squares
• moment MOMENT estimates the p-th moment
• naninsttest NANINSTTEST checks whether the functions from NaN-toolbox have been
• nanmean NANMEAN same as SUM but ignores NaN's.
• nanstd NANSTD same as STD but ignores NaN's.
• nansum NANSUM same as SUM but ignores NaN's.
• nantest NANTEST checks several mathematical operations and a few
• rms RMS calculates the root mean square
• sem SEM calculates the standard error of the mean
• skewness SKEWNESS estimates the skewness
• statistic STATISTIC estimates various statistics at once.
• std STD calculates the standard deviation.
• sumsq SUMSQ calculates the sum of squares.
• var VAR calculates the variance.