Synopsis
Set parameter values on the command line
Syntax
pset toolname pset toolname value1 ... pset toolname param1=value1 param2=value2 ...
Description
pset is used to set parameters for CIAO tools. The parameters can be specified on the command line in the order they appear in the parameter file or by using the parameter=value pair. If no parameters or values are specified, the tool will prompt for all the parameter (hidden and queried) in the specified parameter file.
In addition to setting parameter values, one can also change the behavior of the tool by setting the parameter attributes. The available attributes are listed below, and they are set using the name parameter.attribute (as shown in example 4 below).
Parameter Attributes
| Setting | Description |
|---|---|
| p_mode | Changes whether a parameter is prompted for or not. |
| p_value | Changes the parameter value. Same as if no ".attribute" is specified |
| p_min | Reset the parameter minimum allowed value |
| p_max | Reset the parameter maximum allowed value |
| p_prompt | Change the parameter prompt |
Note: Users cannot change the data type of a parameter using the "p_type" attribute.
Resetting the min and max values of a parameter file should be done with EXTREME caution. Changing the mode of the parameter may cause unexpected results -- specifically, changing hidden parameters to automatic/querried will change the command line behavior if the parameter=value syntax is not used. The parameter prompt is safe to change to suit the user's tastes.
Examples
Example 1
pset dmlist
This will prompt the user for all the parameter in the dmlist.par file.
Example 2
pset dmlist my_file
This will set the first non-hidden parameter in the dmlist.par file, which happens to be "infile", to be set to "my_file".
Example 3
pset /tmp/dmlist.par infile=my_file outfile=""
This sets the infile parameter in /tmp/dmlist.par to be "my_file" and sets the outfile parameter to be blank.
Example 4
pset dmlist infile.p_prompt="Your most excellent Chandra observation file"
This replaces the prompt of the infile parameter of dmlist with the specified string. Whenever this parameter is prompted for again, it will display the message above.
Bugs
There are no known bugs for this tool.