roundfrac documentation
This function rounds values to multiples of a fraction.
Contents
Syntax
Xrounded = roundfrac(X,fraction) Xrounded = roundfrac(X,fraction,option)
Description
Xrounded = roundfrac(X,fraction) rounds X to multiples of nearest fraction. If fraction is a scalar, it is applied to all values in X. If dimensions of fraction match dimensions of X, it is applied element-wise. If fraction is 1/3, values of X are rounded to the nearest one third. roundfrac(X,1) is equivalent to round(X).
Xrounded = roundfrac(X,fraction,option) specifies an option string as 'floor', 'ceil', 'fix', or 'round'. Default rounding option is 'round'.
Examples
Create an array of values to round:
x = [-1.4 -1.3 -1.1 0 1.1 1.3 1.4];
Round values of x to the nearest third:
roundfrac(x,1/3)
ans = -1.3333 -1.3333 -1.0000 0 1.0000 1.3333 1.3333
Round x down to the nearest third:
roundfrac(x,1/3,'floor')
ans = -1.6667 -1.3333 -1.3333 0 1.0000 1.0000 1.3333
Round x toward zero to the nearest third:
roundfrac(x,1/3,'fix')
ans = -1.3333 -1.0000 -1.0000 0 1.0000 1.0000 1.3333
Round values of x to the nearest multiple of 2.5:
roundfrac(x,2.5)
ans = -2.5000 -2.5000 0 0 0 2.5000 2.5000
Round each element of x to a different fraction:
roundfrac(x,[1/3 1/2 1/16 3/7 4/7 44 .2])
ans = -1.3333 -1.5000 -1.1250 0 1.1429 0 1.4000
Author Info:
This function was written by Chad A. Greene of the University of Texas Institute for Geophysics (UTIG) on January 6, 2015.
