HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » pipeline » expressions » Expression Numbers
visual3d:documentation:pipeline:expressions:expression_numbers

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
visual3d:documentation:pipeline:expressions:expression_numbers [2024/06/26 20:25] – created sgrangervisual3d:documentation:pipeline:expressions:expression_numbers [2025/06/20 19:07] (current) – Added headers and cleaned up <code> tags. wikisysop
Line 1: Line 1:
-====== Expression_Numbers ======+====== Expression Numbers ======
  
-==== Random ====+There is current a single "numbers"-related expression function. 
 + 
 +===== Random =====
  
 rand(lo_value,hi_value,signal) - random number in the range (lo_value,hi_value) rand(lo_value,hi_value,signal) - random number in the range (lo_value,hi_value)
  
-Example : rand() will generate a random number in the range 0 to 1 +==== Example: Generate a random number in the range 0 to 1 ==== 
-[[Visual3D:Documentation:Pipeline:Pipeline_Commands:Set_Pipeline_Parameter_From_Expression|Set_Pipeline_Parameter_From_Expression]]+ 
 +<code> 
 +Set_Pipeline_Parameter_From_Expression
 /PARAMETER_NAME=TEST1 /PARAMETER_NAME=TEST1
 /EXPRESSION=RAND() /EXPRESSION=RAND()
 /AS_INTEGER=FALSE /AS_INTEGER=FALSE
-**;** +; 
-::TEST1 = 0.220525 + 
-Example : rand(lo_value,hi_value) will generate a random number in the range lo_value to hi_value + TEST1 = 0.220525 
-[[Visual3D:Documentation:Pipeline:Pipeline_Commands:Set_Pipeline_Parameter_From_Expression|Set_Pipeline_Parameter_From_Expression]]+</code> 
 + 
 +The default range for the random number is from 0 to 1. 
 + 
 +==== Example: Generate a random number within a range ====  
 + 
 +<code> 
 +Set_Pipeline_Parameter_From_Expression
 /PARAMETER_NAME=TEST2 /PARAMETER_NAME=TEST2
 /EXPRESSION=RAND(2,3) /EXPRESSION=RAND(2,3)
 /AS_INTEGER=FALSE /AS_INTEGER=FALSE
-**;** +; 
-::TEST2 = 2.232995 + 
-Example : rand(lo_value,hi_value,signal) will generate a random number in the range lo_value to hi_value with the same number of components and frames as **signal**. + TEST2 = 2.232995 
-[[Visual3D:Documentation:Pipeline:Pipeline_Commands:Set_Pipeline_Parameter_From_Expression|Set_Pipeline_Parameter_From_Expression]]+</code> 
 + 
 +The output value occurs in the range from lo_value to hi_value. 
 + 
 +==== Example: Generate a random number in a range to match a signal ====  
 + 
 +<code> 
 +Set_Pipeline_Parameter_From_Expression
 /PARAMETER_NAME=TEST3 /PARAMETER_NAME=TEST3
 /EXPRESSION=RAND(2,3,FRAME_NUMBERS::ORIGINAL::FRAMES) /EXPRESSION=RAND(2,3,FRAME_NUMBERS::ORIGINAL::FRAMES)
 /AS_INTEGER=FALSE /AS_INTEGER=FALSE
-**;**+; 
 ::TEST3 = 2.808424+2.582592+2.346721+2.697052+2.662510+2.861250+2.843808+...(to number of frames) ::TEST3 = 2.808424+2.582592+2.346721+2.697052+2.662510+2.861250+2.843808+...(to number of frames)
-Example : rand(lo_value,hi_value,signal). If signal is a number, that number of values are returned. +</code> 
-[[Visual3D:Documentation:Pipeline:Pipeline_Commands:Set_Pipeline_Parameter_From_Expression|Set_Pipeline_Parameter_From_Expression]]+ 
 +Using all three arguments will produce a random number in the range from lo_value to hi_value with the same number of components and frames as the argument signal. 
 + 
 +==== Example: Generate a specific number of random values ====  
 + 
 +<code> 
 +Set_Pipeline_Parameter_From_Expression
 /PARAMETER_NAME=TEST4 /PARAMETER_NAME=TEST4
 /EXPRESSION=RAND(2,3,3) /EXPRESSION=RAND(2,3,3)
 /AS_INTEGER=FALSE /AS_INTEGER=FALSE
-**;**+; 
 ::TEST4 = 2.446495 + 2.718410 + 2.201863 ::TEST4 = 2.446495 + 2.718410 + 2.201863
-Example : Create a TARGET with random values between 0 and 1 +</code> 
-[[Visual3D:Documentation:Pipeline:Signal_Commands:Create_Target|Create_Target]]+ 
 +If the signal argument is a number, then that number of random values from the range lo_value to hi_value are returned. 
 + 
 +==== Example: Create a TARGET with random values between 0 and 1 ==== 
 + 
 +<code> 
 +Create_Target
 /SIGNAL_NAMES=TEST5 /SIGNAL_NAMES=TEST5
 ! /SIGNAL_DESCRIPTION= ! /SIGNAL_DESCRIPTION=
 /EXPRESSION=RAND(0,1,TARGET::ORIGINAL::LFT1) /EXPRESSION=RAND(0,1,TARGET::ORIGINAL::LFT1)
 ! /INCLUDE_CALFILE=FALSE ! /INCLUDE_CALFILE=FALSE
-**;** +; 
-View the resulting signal in the 3D viewer by turning on the target trail + 
-{{random_target.jpg}} +</code> 
-Example: create a TARGET with random values between 0 and 1. + 
-[[Visual3D:Documentation:Pipeline:Signal_Commands:Create_Target|Create_Target]]+View the resulting signal in the 3D viewer by turning on the target trail: 
 + 
 +{{:random_target.jpg}} 
 + 
 +==== Example: create a TARGET with random values between 0 and 1 ==== 
 + 
 +<code> 
 +Create_Target
 /SIGNAL_NAMES=TEST6 /SIGNAL_NAMES=TEST6
 ! /SIGNAL_DESCRIPTION= ! /SIGNAL_DESCRIPTION=
 /EXPRESSION=VECTOR(RAND(0,1,FRAME_NUMBERS::ORIGINAL::FRAMES),RAND(0,1,FRAME_NUMBERS::ORIGINAL::FRAMES),RAND(0,1,FRAME_NUMBERS::ORIGINAL::FRAMES)) /EXPRESSION=VECTOR(RAND(0,1,FRAME_NUMBERS::ORIGINAL::FRAMES),RAND(0,1,FRAME_NUMBERS::ORIGINAL::FRAMES),RAND(0,1,FRAME_NUMBERS::ORIGINAL::FRAMES))
 ! /INCLUDE_CALFILE=FALSE ! /INCLUDE_CALFILE=FALSE
-**;**+; 
 +</code> 
 Note that all components contain different values Note that all components contain different values
  
-{{Random7.jpg}}{{random7view.jpg}} +{{:Random7.jpg}} {{:random7view.jpg}} 
-Example : Create a TARGET where each frame is on a random location on the surface of a sphere of radius 1 + 
-**Evaluate_Expression**+==== Example: Create a TARGET where each frame is on a random location on the surface of a sphere of radius 1 ==== 
 + 
 +<code> 
 +Evaluate_Expression
 /EXPRESSION=RAND(-PI(),PI(),FRAME_NUMBERS::ORIGINAL::FRAMES) /EXPRESSION=RAND(-PI(),PI(),FRAME_NUMBERS::ORIGINAL::FRAMES)
 /RESULT_TYPES=DERIVED /RESULT_TYPES=DERIVED
Line 59: Line 103:
 /RESULT_NAME=VERTICAL /RESULT_NAME=VERTICAL
 ! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=FALSE ! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=FALSE
-**;** +; 
-**Evaluate_Expression**+ 
 +Evaluate_Expression
 /EXPRESSION=RAND(0,2*PI(),FRAME_NUMBERS::ORIGINAL::FRAMES) /EXPRESSION=RAND(0,2*PI(),FRAME_NUMBERS::ORIGINAL::FRAMES)
 /RESULT_TYPES=DERIVED /RESULT_TYPES=DERIVED
Line 66: Line 111:
 /RESULT_NAME=HORIZONTAL /RESULT_NAME=HORIZONTAL
 ! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=FALSE ! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=FALSE
-**;** +; 
-[[Visual3D:Documentation:Pipeline:Signal_Commands:Create_Target|Create_Target]]+ 
 +Create_Target
 /SIGNAL_NAMES=SPHERE /SIGNAL_NAMES=SPHERE
 ! /SIGNAL_DESCRIPTION= ! /SIGNAL_DESCRIPTION=
Line 75: Line 121:
 SIN(DERIVED::RADIUS::VERTICAL)) SIN(DERIVED::RADIUS::VERTICAL))
 ! /INCLUDE_CALFILE=FALSE ! /INCLUDE_CALFILE=FALSE
-**;** +; 
-{{random8view.jpg}}+</code>
  
 +{{:random8view.jpg}}
  
visual3d/documentation/pipeline/expressions/expression_numbers.1719433500.txt.gz · Last modified: 2024/06/26 20:25 by sgranger