XMM-Newton SAS Home Page
XMM-Newton Science Analysis System


imgdisplay (imgdisplay-1.51) [xmmsas_20230412_1735-21.0.0]

Parameters

This section documents the parameters recognized by this task (if any).

ParameterMand Type Default Constraints
startviewernobooleantruefalse$\vert$true
If startviewer is set to true imgdisplay attempts to establish a communication link between itself and an active Ds9/SAOtng process upon invocation. If a Ds9/SAOtng is active already, either started manually or through a previous invocation of imgdisplay with stopviewer=false, its main window must have the title[*] ds9 or ds9-username for imgdisplay to be able to connect to it. username is the value of the environment variable LOGNAME which is usually the user's login name. If no running Ds9/SAOtng could be found imgdisplay spawns one with the window title SAOtng-username such that subsequent task invocations can find and connect to this process. Please note: Ds9/SAOtng are big programs, even on modern workstations is can take up to several seconds before the main window appears on the screen. startviewer=true is a prerequisite that any given additional commands can succeed. If set to “false” the task exits immediately — all following commands are ignored in this case.
 
withimagefilenobooleanfalsefalse$\vert$true
A boolean switch determining whether a new image should be loaded into Ds9/SAOtng. If set to “true” the name of the image data set must be given via the parameter imagefile. When a new image is loaded any previously displayed one is lost.
 
imagefilenostring name of existing image data set
The name of the image data set to load into Ds9/SAOtng when withimagefile is set to “true”.
 
withregionnobooleanfalsefalse$\vert$true
A boolean switch determining whether region specifications should be read from Ds9/SAOtng and stored in the regions parameter. Not applicable to interactive usage.
 
regionsnostring list  
This serves as an output parameter to hold region specifications read from Ds9/SAOtng when requested with. Not applicable to interactive usage. withregion=true.
 
withregiontablenobooleanfalsefalse$\vert$true
A boolean switch determining whether the contents of an CXC-region file should be displayed in the form of markers on top of the currently displayed image. If set to true, the below parameter regiontable must be given the name of the region table.
 
regiontablenostring name of existing CXC-region table
The name of the CXC-region table to be visualized.
 
flipxnobooleanfalsefalse$\vert$true
A boolean switch determining whether the image currently displayed in Ds9/SAOtng should be flipped around the X-axis.
 
flipynobooleanfalsefalse$\vert$true
A boolean switch determining whether the image currently displayed in Ds9/SAOtng should be flipped around the Y-axis.
 
viewernostring ENV or name of viewer executable
A string determining which image viewer shall be used: SAOtng or Ds9. viewer can also be assigned the value ENV in which case the environment variable
SAS_IMAGEVIEWER
must specify either of the two supported programs. Please note: If viewer is just given the name of the viewer executable it must be reachable via the PATH environment variable. However, viewer may also contain the full path to the executable, e.g. /usr/local/bin/ds9.
 
stopviewernobooleanfalsefalse$\vert$true
A boolean switch determining whether a running Ds9/SAOtng process should be terminated.
 
withcommandsnobooleanfalsefalse$\vert$true
Controlling boolean switch for commands parameter.
 
commandsnolist of strings list of valid Ds9/SAOtng commands
If withcommands is set to true the value is supposed to be list of Ds9/SAOtng commands that are to be send to an already spawned image displayer. E.g. withcommands=true commands="zoom to 2" will set the zoom factor in the currently displayed image to 2.
 
withreceivenobooleanfalsefalse$\vert$true
Controlling boolean switch for receive parameter.
 
receivenolist of strings  
This is an output parameter which is only useful in the context of metatask programming. If withreceive is set to true output from a running Ds9/SAOtng process (resulting from a preceding execution of commands via withcommands/commands) shall be collected in this parameter as a list of strings. The parameter is not accessible as part of imgdisplay's parameter dialog.
 
ParameterMand Type Default Constraints

XMM-Newton SOC -- 2023-04-16