nancumsum
nancumsum: Cumulative sum of a matrix, with user-specified treatment of NaNs.
Computes the cumulative sum of matrix A along dimension DIM, allowing the user to replace NaNs with zeros, to skip over them, or to reset on NaNs, maintaining NaNs as placeholders.
USAGE: B = nancumsum(A, DIM, NMODE)
ARGUMENTS:
A: Input matrix.
B: Output cumulative sum matrix, treating NaNs as determined by nmode.
DIM: B = nancumsum(A, DIM) returns the nan-cumulative sum of the elements
along the dimension of A specified by scalar DIM. For example,nancumsum(A,1) works down the columns, nancumsum(A,2) works across the rows. If DIM is not specified, it defaults to the first non-singleton dimension of A.
NMODE: specifies how NaNs should be treated. Acceptable values are:
1: REPLACE NaNs with zeros (default).
2: MAINTAIN NaNs as position holders in B. (Skip NaNs without reset.)
3: RESET sum on NaNs, replacing NaNs with zeros.
4: RESET sum on NaNs, maintaining NaNs as position holders.
See also: cumsum, nansum, nancumprod, nanmean, nanmedian, ...
(nancumprod is available from the FEX. Other nan* may require Toolboxes)
Cite As
Brett Shoelson (2024). nancumsum (https://www.mathworks.com/matlabcentral/fileexchange/14895-nancumsum), MATLAB Central File Exchange. Retrieved .
MATLAB Release Compatibility
Platform Compatibility
Windows macOS LinuxCategories
- MATLAB > Language Fundamentals > Data Types > Numeric Types > NaNs >
Tags
Community Treasure Hunt
Find the treasures in MATLAB Central and discover how the community can help you!
Start Hunting!Discover Live Editor
Create scripts with code, output, and formatted text in a single executable document.
Version | Published | Release Notes | |
---|---|---|---|
1.5.0.1 | Updated license |
||
1.5.0.0 | Fixes an issue with the vectorization of mode 3. |
||
1.3.0.0 | This submission fixes a bug pointed out by a couple of attentive users. Also, note that I have added new options for the treatment of NaNs, and eliminated one for special treatment of vectors. (Not necessary!) |
||
1.2.0.0 | Updated M file and license text file copyright to The MathWorks, Inc. |
||
1.1.0.0 | added copyright |
||
1.0.0.0 | Fixing a bug (failed for scalar inputs). |