Wiki Documentation Site

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » pipeline » pipeline_commands » Set Pipeline Parameter
visual3d:documentation:pipeline:pipeline_commands:set_pipeline_parameter

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:pipeline_commands:set_pipeline_parameter [2024/07/12 13:30] – removed sgrangervisual3d:documentation:pipeline:pipeline_commands:set_pipeline_parameter [2026/02/04 20:48] (current) – wikisysop
Line 1: Line 1:
 +====== Set Pipeline Parameter ======
 +This command can be used to set the value of a pipeline parameter to a specified value as defined by the user. Also see [[visual3d:documentation:pipeline:pipeline_commands:set_pipeline_parameter_to_data_value|Set Pipeline Parameter to Data Value]] and [[visual3d:documentation:pipeline:pipeline_commands:set_pipeline_parameter_from_expression|Set Pipeline Parameter from Expression]] for other options to define pipeline parameter values. 
 +
 +====Pipeline command====
 +This command can be found in the Pipeline Workshop within the Pipeline Control folder as shown below:
 +<code>
 +Set_Pipeline_Parameter
 +/PARAMETER_NAME=
 +/PARAMETER_VALUE=
 +! /PARAMETER_VALUE_SEARCH_FOR=
 +! /PARAMETER_VALUE_REPLACE_WITH=
 +! /PARAMETER_VALUE_PREFIX=
 +! /PARAMETER_VALUE_APPEND=
 +! /MULTI_PASS=FALSE
 +;
 +</code>
 +
 +====Command Parameters====
 +The following table shows the command parameters that can be used to define the command and their descriptions:
 +
 +|**Parameter**   |**Description**|
 +|**Parameter Name**|The name of the Pipeline Parameter. The parameter is referred to by other commands using two colons (::) in front of the parameter name|
 +|**Parameter Value**|The value of the parameter. If a "+" delimeter is used in the value, the text string is maintained so that the Pipeline parameter is interpreted as multiple values when used in a command. If a "+" delimeter is used in the value, the entries in the line are concatenated, and will be treated as a single value when they are used in another command.|
 +|**Parameter Value Search For**|Search for parameters with this value|
 +|**Parameter Value Replace With**|Replace the searched for value with this value|
 +|**Multi Pass**|True or False: |
 +
 +==== Example: Set Pipeline Values via Search and Replace ====
 +
 +This example sets pipeline parameters and new values via search and replace. The pipeline parameter **original** and the string value **replacethexxxx**, is set to the pipeline parameter **newparameter** and replaced with the string **replacethezzzz**.
 +
 +<code>
 +!Set the Pipeline parameter original to the value replacethexxxx
 +Set_Pipeline_Parameter
 +/PARAMETER_NAME=original  
 +/PARAMETER_VALUE=replacethexxxx
 +; 
 +
 +! Set the Pipeline parameter newparameter to a new value replacethezzzz by replacing
 +! part of the string zzzz for xxxx
 +Set_Pipeline_Parameter
 +/PARAMETER_NAME=newparameter  
 +/PARAMETER_VALUE=replacethexxxx  
 +/PARAMETER_VALUE_SEARCH_FOR=xxxx  
 +/PARAMETER_VALUE_REPLACE_WITH=zzzz
 +;
 +</code>
 +
 +==== Example: Set Pipeline Parameter Value to a String ====
 +
 +For example, the following command creates a global parameter **SIGNALS** which contains the string **RightFoot1+RightFoot2+RightFoot3**. A low pass filter is run on the pipeline parameter **SIGNALS**.
 +
 +<code>
 +Set_Pipeline_Parameter
 +/Parameter_Name=SIGNALS
 +/Parameter_Value=RightFoot1+RightFoot2+RightFoot3
 +;
 +
 +! All three signals will be processed with low pass filter 
 +Lowpass_Filter
 +/Signal_Types=ORIGINAL+ORIGINAL+ORIGINAL
 +/Signal_Names=::SIGNALS
 +;
 +</code>
 +
 +==== Example: Search and Replace + Sign ====
 +
 +The plus sign typically indicates different a list of values, but sometimes a user may want to search and replace a plus sign. This is allowed if the user types \+. An example is below:
 +
 +<code>
 +Set_Pipeline_Parameter
 +/PARAMETER_NAME=TEST
 +/PARAMETER_VALUE=A + B
 +/PARAMETER_VALUE_SEARCH_FOR=\+
 +/PARAMETER_VALUE_REPLACE_WITH=-
 +;
 +</code>
 +
 +**Result: ::TEST = A - B**
 +
 +<code>
 +Set_Pipeline_Parameter
 +/PARAMETER_NAME=TEST
 +/PARAMETER_VALUE= A - B
 +/PARAMETER_VALUE_SEARCH_FOR=-
 +/PARAMETER_VALUE_REPLACE_WITH=\+
 +;
 +</code>
 +
 +**Result: ::TEST = A + B**
 +
 +==== Example: Set Pipeline Parameter Multi-Pass ====
 +
 +MultiPass was introduced january 21, 2014
 +
 +The resulting parameter could be a new pipeline parameter
 +
 +for example, the resulting string could be ::VALUE
 +If MultiPass were true, this should return the value of the parameter VALUE not the string ::VALUE
 +example:
 +
 +<code>
 +Set_Pipeline_Parameter
 +/PARAMETER_NAME=TEST
 +/PARAMETER_VALUE=SCOTT
 +! /PARAMETER_VALUE_SEARCH_FOR=
 +! /PARAMETER_VALUE_REPLACE_WITH=
 +! /PARAMETER_VALUE_PREFIX=
 +! /PARAMETER_VALUE_APPEND=
 +;
 +</code>
 +
 +Pipeline Parameter : ::TEST = SCOTT
 +
 +<code>
 +---------------------------------------------------------------------------
 +</code>
 +
 +<code>
 +Set_Pipeline_Parameter
 +/PARAMETER_NAME=ONE
 +/PARAMETER_VALUE=KEITH
 +! /PARAMETER_VALUE_SEARCH_FOR=
 +! /PARAMETER_VALUE_REPLACE_WITH=
 +! /PARAMETER_VALUE_PREFIX=
 +! /PARAMETER_VALUE_APPEND=
 +;
 +</code>
 +
 +Pipeline Parameter : ::ONE = KEITH
 +
 +<code>
 +---------------------------------------------------------------------------
 +</code>
 +
 +<code>
 +Set_Pipeline_Parameter
 +/PARAMETER_NAME=SCOTTKEITH
 +/PARAMETER_VALUE=7
 +! /PARAMETER_VALUE_SEARCH_FOR=
 +! /PARAMETER_VALUE_REPLACE_WITH=
 +! /PARAMETER_VALUE_PREFIX=
 +! /PARAMETER_VALUE_APPEND=
 +;
 +</code>
 +
 +Pipeline Parameter : ::SCOTTKEITH = 7
 +
 +<code>
 +---------------------------------------------------------------------------
 +</code>
 +
 +if we set MULTI_PASS= FALSE
 +
 +<code>
 +Set_Pipeline_Parameter
 +/PARAMETER_NAME=FINAL
 +/PARAMETER_VALUE=::SCOTTKEITH
 +! /PARAMETER_VALUE_SEARCH_FOR=
 +! /PARAMETER_VALUE_REPLACE_WITH=
 +! /PARAMETER_VALUE_PREFIX=
 +! /PARAMETER_VALUE_APPEND=
 +! /MULTI_PASS=FALSE
 +;
 +</code>
 +
 +Pipeline Parameter : ::FINAL = ::SCOTTKEITH
 +
 +if we set MULTI_PASS= TRUE
 +
 +<code>
 +Set_Pipeline_Parameter
 +/PARAMETER_NAME=FINAL
 +/PARAMETER_VALUE=::SCOTTKEITH
 +! /PARAMETER_VALUE_SEARCH_FOR=
 +! /PARAMETER_VALUE_REPLACE_WITH=
 +! /PARAMETER_VALUE_PREFIX=
 +! /PARAMETER_VALUE_APPEND=
 +/MULTI_PASS=true
 +;
 +</code>
 +
 +Pipeline Parameter : ::FINAL = 7
 +
 +**NOTE:** If the above does not work (if FINAL is not set to 7, and MULTI_PASS is set to TRUE), instead of writing "::SCOTTKEITH", use ":&:&::SCOTTKEITH".
 +
 +
  
visual3d/documentation/pipeline/pipeline_commands/set_pipeline_parameter.1720791059.txt.gz · Last modified: by sgranger