Last modified: December 2023

URL: https://cxc.cfa.harvard.edu/ciao/ahelp/pset.html
Jump to: Description · Examples · Bugs · See Also


AHELP for CIAO 4.16

pset

Context: Tools::Parameter

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.

See Also

concept
parameter
tools::header
dmhistory, dmkeypar, dmmakepar, dmreadpar
tools::parameter
paccess, pdump, pget, pline, plist, pquery, punlearn