Fixed-Point Toolbox™

rescale - Change scaling of fi object

Syntax

b = rescale(a, fractionlength)
b = rescale(a, slope, bias)
b = rescale(a, slopeadjustmentfactor, fixedexponent, bias)
b = rescale(a, ..., PropertyName, PropertyValue, ...)

Description

The rescale function acts similarly to the fi copy function with the following exceptions:

• The fi copy constructor preserves the real-world value, while rescale preserves the stored integer value.

• rescale does not allow the Signed and WordLength properties to be changed.

Examples

In the following example, fi object a is rescaled to create fi object b. The real-world values of a and b are different, while their stored integer values are the same:

p = fipref('FimathDisplay','none',...
		'NumericTypeDisplay','short');
a = fi(10, 1, 8, 3) 

a =
 
    10
      s8,3
 
b = rescale(a, 1) 

b =
 
    40
      s8,1
 
stored_integer_a = a.int;
stored_integer_b = b.int;
isequal(stored_integer_a, stored_integer_b)

ans =

1

See Also

fi

repmat

reset