Num-Transform

The `Num-Transform` category contains nodes that modify numeric values. 

Round

This node rounds a numeric value to a configured number of decimal places.

Inputs

1. input - Numeric input value.
   

Outputs

1. output - Input value rounded to configured number of decimal places.
   

Settings

1. Name - Name of the node.
   
2. Decimal Places (Limit 5) - Required number of decimal places to round the input to (maximum of 5 decimal places).
   

Operation

1. 'output' is the 'input' value rounded to the configured number of  decimal places.  The number of decimal places can be configured  from settings (limited to 5 decimal places).
   

Limit

This node clamps numeric input values within the configured limit range. 

Inputs

1. input - Numeric input value.
   
2. [min] - Minimum limit setting value.
   
3. [max] - Maximum limit setting value.
   

Outputs

1. output - Numeric output value (limited to range between `min` and `max`.
   

Settings

1. Name - Name of the node.
   
2. Min - Minimum limit setting value.
3. Max - Maximum limit setting value.

Operation

‘output' follows the 'input' value when it is between the 'min' and 'max'  values.  If 'input' is greater than the 'max' value, 'output' will be the  'max' value.  If 'input' is less than the 'min' value, 'output' will be the  'min' value.   'max' and 'min' values can be configured from settings.

Scale

This node scales (remaps) a numeric input value from an configured input range to a configured output range. 

Inputs

1. input - Numeric input value
   
2. [in-min] - Minimum input range value.
3. [in-max] - Maximum input range value.
4. [out-min] - Minimum output range value.
5. [out-max] - Maximum output range value.

Outputs

1. output - Scaled numeric value.
   

Settings

1. Name - Name of the node.
   
2. Minimum Input - Minimum input range value.
3. Maximum Input - Maximum input range value.
4. Minimum Output - Minimum output range value.
5. Maximum Output - Maximum output range value.

Operation

Performs a linear interpolation of the 'input' value based configured settings.   When 'input' value is between 'in-min' and 'in-max' it is linearly interpolated between 'out-min' and 'out-max'.  If 'input' is  greater than the 'in-max' value, 'output' will be the 'out-max' value.  If  'input' is less than the 'in-min' value, 'output' will be the 'out-min' value.  'in-max', 'in-min', 'out-max', and 'out-min' values can be configured  from settings.

Linear-Interpolate

This node allows a numeric input to be interpolated along a linear scale with multiple inflection points.

Inputs

1. input - Numeric input value.
   
2. [x#] -> [y#] - At this time the inputs (1 per inflection point) do not change the function of the node, they are only for reference of the configured settings values.
   

Outputs

1. output - Numeric output value.
   
2. belowRange - Boolean output.  If `input` is below the maximum configured X axis range, `output` is `true`.
   
3. aboveRange - Boolean output.  If `input` is above the minimum configured X axis range, `output` is `true`.

Settings

1. Name - Name of the node.
   
2. Inflection Points Count - Number of inflection points.
   
3. x1/x2/x#... - X and Y values configurations for each inflection point.
   

Operation

Performs a linear interpolation of the 'input' value between configured inflection points.  The number of inflection points and their X and Y values can be configured in settings.   When the 'input' value is between configured inflection points the 'output' value will be  the linear interpolation of the 'input' value between the adjacent  inflection point values.

Fade

This node provides a numeric output that ramps up or down over a configured range over a set period of time.

Inputs

1. enable - Boolean input to enable the node operation.
   
2. [interval] - Numeric interval time setting.
   
3. [from] - Numeric fade range starting value setting.
   
4. [to] - Numeric fade range ending value setting.

Outputs

1. output - Numeric output value.
   
2. out=to - Boolean output: `true` if `output` has reached the configured `to` value.
   

Settings

1. Name - Name of the node.
   
2. Interval - Numeric interval setting (units can be configured).
   
3. Units - Time unit of `Interval`.
   
4. To Value - Numeric fade range ending value setting.
5. From Value - Numeric fade range starting value setting.

Operation

This node makes a smooth transition from 'from' value to 'to' value over the 'interval' period when 'enable' transitions from 'false' to 'true'; after this  'interval' period 'output' will match the 'to' value while 'enable' is 'true'.  During the 'interval' period, the rate of 'output' change cannot be  changed.  Once the 'interval' period is complete 'out=to' becomes  'true' until 'enable' becomes 'false' again.

Rate-Limit

This node limits the rate of change of a numeric input.  The rate of change is limited to a configured step size for each periodic update interval.   

Inputs

1. input - Numeric value that `output` will ramp up/down towards.
   
2. [enable] - Boolean input to enable or disable the node.
   
3. [step] - Numeric value for the maximum step size.
   
4. [interval] - Numeric value for the stepping interval time. units are configured from settings.
   

Outputs

1. output - Numeric output that steps towards `input` value.
   

Settings

1. Name - Name of the node.
   
2. Enable - Toggle switch to enable or disable the node.
   
3. Step Size - Numeric value for the maximum step size.
4. Update Interval - Numeric value for the update interval.  
   
5. Units - Time unit selection for Update Interval (Milliseconds, Seconds, Hours, Minutes).
   

Operation

This node makes a rate limited transition from its current `output` value to the ‘input’ value.  When ‘enable’ is ‘true’, ‘output’ is permitted to change towards the ‘input’ value based on settings values.  ‘output’ can change by ‘step’ size every `interval’ period.  ‘output’ will be ‘null’ when ‘enable’ is ‘false’.

Related Articles:

1. Rubix Wires: Working with Nodes