About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: December 2007

URL: http://cxc.harvard.edu/ciao4.0/ciao.par.html
Hardcopy (PDF): A4 | Letter
AHELP for CIAO 4.0 ciao.par Context: gui

Synopsis

Parameter file to configure options for CIAO applications.

Syntax

Example:
pset ciao.par pattern='*'

Description

The ciao.par parameter file is utilized by various CIAO applications to configure a consistent 'CIAO session environment' so that tools such as prism, ChIPS, and toolagent can interact with each other in a coherent, integrated workspace. The file contains entries which outline the interactive behavior between applications.

Since the file is only read when applications are started, changes to the file only affect subsequent invocations of the tools. The 'workdir' parameter is an exception to this; it is read and written each time file selection dialogs are invoked if "dir_option=SESSION".

Parameters

name type def min max
maxinstances integer 3 1 10
toolagent string DISPLAY    
dir_option string APPLICATION    
workdir string ))pwd    
pattern string *.fits    
paramlist string name,value,prompt,min,max    
seed_infile boolean yes    
showhidden boolean yes    
clobber boolean no    
term string xterm    
termopts string      

Detailed Parameter Descriptions

Parameter=maxinstances (integer default=3 min=1 max=10)

Maximum number of instances of each session application

This parameter specifies the maximum number of instances of each application (prism, ChIPS, taskmonitor) which may be run at the same time in a single CIAO analysis session.

Parameter=toolagent (string default=DISPLAY)

Toolagent applications launched in display window or background?

This parameter controls the behavior of toolagent when an application is invoked from the "Tools" menu. If set to "DISPLAY", an instance of taskmonitor is invoked to display the stderr and stdout of the application being run; this is the default behavior. If it is set to "BACKGROUND", the requested tool will be run in the background. The user will not be able to view the stderr or stdout of the tool, but the exit status will be provided in an information dialog.

Parameter=dir_option (string default=APPLICATION)

Session- or application-specific directories for file selections

This parameter specifies whether the user wishes for file selection dialog directories to be application-specific or session-specific. If set to APPLICATION, each application will maintain the last directory from which a file was selected and start the next file selection dialog in that directory. If set to SESSION, the selection dialogs of any application running will use the directory specified in the workdir parameter as its starting directory. When a file is selected, the workdir parameter is updated to store the directory so that the next selection dialog will start in that directory (the workdir param update only occurs if dir_option is set to SESSION). The default value is APPLICATION.

Parameter=workdir (string default=))pwd)

Session-specific directory for file selections

This parameter allows the user to specify the initial directory for file selection dialogs. The default is to use the directory from which the application was invoked, which then gets updated whenever a file is loaded into the GUI. It is only used when dir_option is set to SESSION.

Parameter=pattern (string default=*.fits)

Default file selection search pattern

This parameter allows the user to set the default filter pattern to use the first time a file selection dialog box is opened in prism. The default value is set to "*.fits".

The value should contain at least 1 wildcard character (? or *) or the code will internally default to "*". The last specified filter is used the next time a file selection dialog box is opened, but will not be updated in ciao.par.

Parameter=paramlist (string default=name,value,prompt,min,max)

Fields to display in the parameter editor

This parameter controls which fields are brought up by default in toolagent's parameter file editor. There are two required entries, name and value, which will be added automatically if they are missing. The remaining options are type, prompt, min, max, default, and mode.

Parameter=seed_infile (boolean default=yes)

Automatically set infile value in parameter editor?

This parameter specifies whether the infile value of a parameter file in toolagent is seeded with the session-specified analysis file. If set to "no", the existing value in the tool's parameter file is used.

Parameter=showhidden (boolean default=yes)

Display 'hidden' parameters in parameter editor?

This parameter controls whether or not hidden parameters are displayed in toolagent's parameter editor by default.

Parameter=clobber (boolean default=no)

Overwrite the session save file if it already exists

This parameter is used to specify whether an existing CIAO session save file should be overwritten if a save request is made using the name of an already existing file. The default is no.

Parameter=term (string default=xterm)

Default terminal to use when creating additional windows

This parameter controls the terminal window that is launched from the GUI "Analysis" menu, e.g. when starting a session of Sherpa.

Parameter=termopts (string default=)

Additional startup options for launched terminal windows

This parameter can be used, for example, to pass command-line startup options to the terminal.

CHANGES IN CIAO 4.0 Beta 2

The filtwin_init and max_savestates parameters have been removed from ciao.par, since filtwin is no longer part of CIAO.

Hardcopy (PDF): A4 | Letter
Last modified: December 2007



The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory.
60 Garden Street, Cambridge, MA 02138 USA.    Email: cxcweb@head.cfa.harvard.edu
Smithsonian Institution, Copyright © 1998-2004. All rights reserved.