Code covered by the BSD License

### Highlights from apply

3.25
3.2 | 4 ratings Rate this file 13 Downloads (last 30 days) File Size: 1.68 KB File ID: #16467 Version: 1.0

# apply

### Stephen Lienhard (view profile)

19 Sep 2007 (Updated )

Apply a function looping over a dimension of a matrix

File Information
Description

This function should help when it is difficult to generalize a function to operate on all dimensions.

Examples
--------
Take the eig of each page in the 3rd dimension

b = apply(@eig,rand(4,4,3),3,'uni',0)

Normalize each column
b = apply(@norm, rand(5,3), 2)

Normalize each row
b = apply(@norm, rand(5,3), 1)

MATLAB release MATLAB 7.5 (R2007b)
22 Jul 2010 Ged Ridgway

### Ged Ridgway (view profile)

This looks like a useful helper-function to me. I have what I hope is a complementary helper-function
http://www.mathworks.com/matlabcentral/fileexchange/28255
that can be used when you want to apply a function to vectors along a dimension, rather than (potentially higher dimensional) arrays perpendicular to that dimension.

To clarify the differences, with a 3d array:
r = randn(4,4,4);
the second of the four elements returned by:
n = apply(@norm, r, 3)
gives the matrix norm of the second matrix:
norm(r(:,:,2)
where matrices are stacked in the third dimension.

In contrast,
n = dimfunc(@norm, r, 3)
gives you a 4-by-4 matrix of the vector norms, for vectors running along the third dimension, e.g. element n(2,3) equals:
norm(squeeze(r(2,3,:)))

I hope that both functions will be useful for simplifying code to handle nD arrays.

Comment only
09 Apr 2008 Keith Bensar

Good for clear code but doesn't increase speed.

28 Sep 2007 Marc Cott

Excellent tool.

20 Sep 2007 Jeremy Spear

Examples worked fine. I'll refine rating after error checking and documentation completed.

20 Sep 2007 Jos x@y.z

Do not waste bandwidth with something unfinished ...