User Tools

Site Tools


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/06/19 12:52] sgrangervisual3d:documentation:pipeline:pipeline_commands:set_pipeline_parameter [2024/07/17 15:46] (current) – created sgranger
Line 1: Line 1:
-pipeline parameters can be created in the pipeline and used as variables in other commands in the same pipeline.+====== Set Pipeline Parameter ======
  
-|**set_pipeline_parameter**        |                                                                                                                                                                                                                                                                                                                                                           | | | +Pipeline parameters can be created in the pipeline and used as variables in other commands in the same pipeline.
-|**/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 commandif 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=**  |                                                                                                                                                                                                                                                                                                                                                           | | | +
-|**/parameter_value_replace_with=**|a string of characters that will replace the "search for" string. this can be useful if you want to replace some of the terms within an existing global parameter value                                                                                                                                                                                    | | | +
-|**/multi_pass=**                  |false                                                                                                                                                                                                                                                                                                                                                      |-|;|+
  
-===== example: set pipeline values via search and replace =====+|**Set_Pipeline_Parameter**        |                                                                                                                                                                                                                                                                                                                                                           | | | 
 +|**/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=**  |                                                                                                                                                                                                                                                                                                                                                           | | | 
 +|**/Parameter_Value_Replace_With=**|A string of characters that will replace the "search for" string. This can be useful if you want to replace some of the terms within an existing Global Parameter value                                                                                                                                                                                    | | | 
 +|**/Multi_Pass=**                  |FALSE                                                                                                                                                                                                                                                                                                                                                      |-|;|
  
-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**.+==== 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> <code>
-!set the pipeline parameter original to the value replacethexxxx +!Set the Pipeline parameter original to the value replacethexxxx 
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=original   +/PARAMETER_NAME=original   
-/parameter_value=replacethexxxx+/PARAMETER_VALUE=replacethexxxx
  
  
-set the pipeline parameter newparameter to a new value replacethezzzz by replacing+Set the Pipeline parameter newparameter to a new value replacethezzzz by replacing
 ! part of the string zzzz for xxxx ! part of the string zzzz for xxxx
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=newparameter   +/PARAMETER_NAME=newparameter   
-/parameter_value=replacethexxxx   +/PARAMETER_VALUE=replacethexxxx   
-/parameter_value_search_for=xxxx   +/PARAMETER_VALUE_SEARCH_FOR=xxxx   
-/parameter_value_replace_with=zzzz+/PARAMETER_VALUE_REPLACE_WITH=zzzz
 ; ;
 </code> </code>
  
-===== exampleset pipeline parameter value to a string =====+==== ExampleSet Pipeline Parameter Value to a String ====
  
-for example, the following command creates a global parameter **signals** which contains the string **rightfoot1+rightfoot2+rightfoot3**. low pass filter is run on the pipeline parameter **signals**.+For example, the following command creates a global parameter **SIGNALS** which contains the string **RightFoot1+RightFoot2+RightFoot3**. low pass filter is run on the pipeline parameter **SIGNALS**.
  
 <code> <code>
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=signals +/Parameter_Name=SIGNALS 
-/parameter_value=rightfoot1+rightfoot2+rightfoot3+/Parameter_Value=RightFoot1+RightFoot2+RightFoot3
 ; ;
  
-all three signals will be processed with low pass filter  +All three signals will be processed with low pass filter  
-lowpass_filter +Lowpass_Filter 
-/signal_types=original+original+original +/Signal_Types=ORIGINAL+ORIGINAL+ORIGINAL 
-/signal_names=::signals+/Signal_Names=::SIGNALS
 ; ;
 </code> </code>
  
-===== examplesearch and replace sign =====+==== ExampleSearch 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:+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> <code>
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=test +/PARAMETER_NAME=TEST 
-/parameter_value=b +/PARAMETER_VALUE=B 
-/parameter_value_search_for=\+ +/PARAMETER_VALUE_SEARCH_FOR=\+ 
-/parameter_value_replace_with=-+/PARAMETER_VALUE_REPLACE_WITH=-
 ; ;
 </code> </code>
  
-**result: ::test b**+**Result: ::TEST B**
  
 <code> <code>
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=test +/PARAMETER_NAME=TEST 
-/parameter_valueb +/PARAMETER_VALUEB 
-/parameter_value_search_for=- +/PARAMETER_VALUE_SEARCH_FOR=- 
-/parameter_value_replace_with=\++/PARAMETER_VALUE_REPLACE_WITH=\+
 ; ;
 </code> </code>
  
-**result: ::test b**+**Result: ::TEST B**
  
-===== exampleset pipeline parameter multi-pass =====+==== ExampleSet Pipeline Parameter Multi-Pass ====
  
-multipass was introduced january 21, 2014+MultiPass was introduced january 21, 2014
  
-the resulting parameter could be a new pipeline parameter+The resulting parameter could be a new pipeline parameter
  
-for example, the resulting string could be ::value +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+If MultiPass were true, this should return the value of the parameter VALUE not the string ::VALUE
 example: example:
  
 <code> <code>
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=test +/PARAMETER_NAME=TEST 
-/parameter_value=scott +/PARAMETER_VALUE=SCOTT 
-! /parameter_value_search_for+! /PARAMETER_VALUE_SEARCH_FOR
-! /parameter_value_replace_with+! /PARAMETER_VALUE_REPLACE_WITH
-! /parameter_value_prefix+! /PARAMETER_VALUE_PREFIX
-! /parameter_value_append=+! /PARAMETER_VALUE_APPEND=
 ; ;
 </code> </code>
  
-pipeline parameter : ::test scott+Pipeline Parameter : ::TEST SCOTT
  
 <code> <code>
Line 100: Line 102:
  
 <code> <code>
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=one +/PARAMETER_NAME=ONE 
-/parameter_value=keith +/PARAMETER_VALUE=KEITH 
-! /parameter_value_search_for+! /PARAMETER_VALUE_SEARCH_FOR
-! /parameter_value_replace_with+! /PARAMETER_VALUE_REPLACE_WITH
-! /parameter_value_prefix+! /PARAMETER_VALUE_PREFIX
-! /parameter_value_append=+! /PARAMETER_VALUE_APPEND=
 ; ;
 </code> </code>
  
-pipeline parameter : ::one keith+Pipeline Parameter : ::ONE KEITH
  
 <code> <code>
Line 117: Line 119:
  
 <code> <code>
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=scottkeith +/PARAMETER_NAME=SCOTTKEITH 
-/parameter_value=7 +/PARAMETER_VALUE=7 
-! /parameter_value_search_for+! /PARAMETER_VALUE_SEARCH_FOR
-! /parameter_value_replace_with+! /PARAMETER_VALUE_REPLACE_WITH
-! /parameter_value_prefix+! /PARAMETER_VALUE_PREFIX
-! /parameter_value_append=+! /PARAMETER_VALUE_APPEND=
 ; ;
 </code> </code>
  
-pipeline parameter : ::scottkeith = 7+Pipeline Parameter : ::SCOTTKEITH = 7
  
 <code> <code>
Line 133: Line 135:
 </code> </code>
  
-if we set multi_passfalse+if we set MULTI_PASSFALSE
  
 <code> <code>
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=final +/PARAMETER_NAME=FINAL 
-/parameter_value=::scottkeith +/PARAMETER_VALUE=::SCOTTKEITH 
-! /parameter_value_search_for+! /PARAMETER_VALUE_SEARCH_FOR
-! /parameter_value_replace_with+! /PARAMETER_VALUE_REPLACE_WITH
-! /parameter_value_prefix+! /PARAMETER_VALUE_PREFIX
-! /parameter_value_append+! /PARAMETER_VALUE_APPEND
-! /multi_pass=false+! /MULTI_PASS=FALSE
 ; ;
 </code> </code>
  
-pipeline parameter : ::final = ::scottkeith+Pipeline Parameter : ::FINAL = ::SCOTTKEITH
  
-if we set multi_passtrue+if we set MULTI_PASSTRUE
  
 <code> <code>
-set_pipeline_parameter +Set_Pipeline_Parameter 
-/parameter_name=final +/PARAMETER_NAME=FINAL 
-/parameter_value=::scottkeith +/PARAMETER_VALUE=::SCOTTKEITH 
-! /parameter_value_search_for+! /PARAMETER_VALUE_SEARCH_FOR
-! /parameter_value_replace_with+! /PARAMETER_VALUE_REPLACE_WITH
-! /parameter_value_prefix+! /PARAMETER_VALUE_PREFIX
-! /parameter_value_append+! /PARAMETER_VALUE_APPEND
-/multi_pass=true+/MULTI_PASS=true
 ; ;
 </code> </code>
  
-pipeline parameter : ::final = 7+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".+**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.1718801552.txt.gz · Last modified: 2024/06/19 12:52 by sgranger