NAME

mul - multiply a table associated with a table-handle by a constant value or point-by-point with another table-handle table.

mul(table_handle1, table_handle2/constant)

mul operates on each element of the function table referred to by table_handle1 and multiplies it either by the value constant or by each corresponding element of the table associated with table_handle2. If the two tables are of different sizes, the values will be interpolated relative to the length of each table. The interpolation scheme used depends upon the original setting of the optional specifier for interpolation used in the original maketable scorefile command that was used to create the table.

NOTE: The functionality of mul has largely been duplicated by the pfield-enabled capabilities of RTcmix instruments. However, the mul function is still useful for Perl and shell-script front-ends to RTcmix.

table_handle1

The table-handle identifier for the first table to be multiplied

table_handle2

The table-handle identifier for the second table to be multiplied against the first, or

constant

the constant value that will be used to multiply all the values of the first table

Returns a table-handle referring to the mutliplied table

   table1 = maketable("literal", "nonorm", 5, 1.0, 2.0, 3.0, 4.0, 5.0)
   table2 = maketable("literal", "nonorm", 5, 0.1, 0.2, 0.3, 0.4, 0.5)
   newtable1 = mul(table1, 2.0)
   newtable2 = mul(table1, table2)

The table-handle newtable1 will be associated with a new table that will contain the following sequence of elements:

2.0, 4.0, 6.0, 8.0, 10.0

0.1, 0.2, 0.9, 1.6, 2.5

maketable, modtable, makefilter, makeconverter, tablelen, copytable, add, div, sub