Applies a function to each entry of an N-dimensional array comprised of vectors.
Updated 20 Feb 2012

View License

M = vecfun (f, A, dim)

vecfun applies a function f with column vector input to an N-dimensional array:

A: size [d1,d2, ... ,dD]

where one of the dimensions of A is comprised of possible vector inputs into f, and f returns an array of P elements.

Therefore, the output of vecfun applied to f on A along dimension dim will be of the same number of dimensions as A and have:

M: size [d1,d2, ... , P , ... , dD]

where d[dim] = P.


A = randn(2,3,5,7);
f = @(p) [p(1)+p(2);p(2)+p(3); ...
% f takes a five element column vector p
% and returns a four element output
M = vecfun(f,A,3);

% returns [2,3,4,7]
% f:R5 -> R4 has acted along the third
% dimension of A as required.

See also my function `chooseargs' (ID 35115) which works well in conjunction with vecfun.

Example of combined usage:

for k=1:20

can be replaced with:

Ai=vecfun(@(s) chooseargs(@min,2,[],s),A,2);


Cite As

Adam Gripton (2024). vecfun (, MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2011b
Compatible with any release
Platform Compatibility
Windows macOS Linux
Find more on Matrices and Arrays in Help Center and MATLAB Answers

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes

Added extra information about combined usage with the `chooseargs' function.