ComfyUI Node: random number

random number:

The number-util-random-num node is designed to generate random numbers of various types, including integers, floating-point numbers, and boolean values. This node is particularly useful for AI artists who need to introduce randomness into their projects, whether for procedural generation, random sampling, or other creative applications. By specifying a range and a seed, you can control the randomness to ensure reproducibility or explore different outcomes. The node leverages Python's random module to produce the desired random values, making it a versatile tool for a wide range of artistic and computational tasks.

random number Input Parameters:

number_type

This parameter determines the type of random number to generate. You can choose from three options: integer, float, or bool. Selecting integer will generate a whole number within the specified range, float will produce a decimal number, and bool will return a boolean value (True or False). This flexibility allows you to tailor the randomness to your specific needs.

minimum

The minimum parameter sets the lower bound of the range from which the random number will be generated. It accepts a floating-point number and has a default value of 0. The minimum value can be as low as -18446744073709551615, providing a wide range for generating random numbers. This parameter is crucial for defining the starting point of your random number range.

maximum

The maximum parameter sets the upper bound of the range for the random number generation. Like the minimum parameter, it accepts a floating-point number and defaults to 0. The maximum value can be as high as 18446744073709551615. This parameter is essential for defining the endpoint of your random number range, ensuring that the generated number falls within the desired limits.

seed

The seed parameter is an integer that initializes the random number generator. By setting a specific seed value, you can ensure that the sequence of random numbers is reproducible, which is useful for debugging or creating consistent results across different runs. The seed value ranges from 0 to 0xffffffffffffffff, providing a vast number of possible initial states for the random number generator.

random number Output Parameters:

NUMBER

This output provides the generated random number in its original type as specified by the number_type parameter. If number_type is integer, this will be an integer; if float, a floating-point number; and if bool, a boolean value. This output is the primary result of the node's execution.

FLOAT

This output converts the generated random number to a floating-point number, regardless of the original number_type. This can be useful if you need a consistent numeric type for further processing or calculations.

INT

This output converts the generated random number to an integer, regardless of the original number_type. This is particularly useful if you need a whole number for subsequent operations or logic.

random number Usage Tips:

• To ensure reproducibility in your projects, always set a specific seed value. This will allow you to generate the same sequence of random numbers across different runs.
• Use the minimum and maximum parameters to tightly control the range of your random numbers, especially when working on projects that require specific bounds.

random number Common Errors and Solutions:

ValueError: empty range for randrange() (minimum, maximum, minimum)

• Explanation: This error occurs when the minimum value is greater than the maximum value, resulting in an invalid range for random number generation.
• Solution: Ensure that the minimum value is less than or equal to the maximum value.

TypeError: '>' not supported between instances of 'str' and 'int'

• Explanation: This error occurs when non-numeric values are provided for the minimum or maximum parameters.
• Solution: Verify that both minimum and maximum parameters are set to numeric values (either integers or floats).

ValueError: Seed must be between 0 and 0xffffffffffffffff

• Explanation: This error occurs when the seed value is outside the acceptable range.
• Solution: Ensure that the seed value is within the range of 0 to 0xffffffffffffffff.