Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/sas/5.4.1/doc/implot/node13.html
Дата изменения: Fri Jan 10 22:39:39 2003
Дата индексирования: Sat Dec 22 08:11:48 2007
Кодировка:

Поисковые слова: п п п п п п п п п п п п п п п п п п п п п
Parameters XMM-Newton SAS Home Page
XMM-Newton Science Analysis System


implot (implot-2.5.2) [xmmsas_20030110_1802-5.4.1]

User-added sources. Home Page Errors Home Index

Meta Index / Home Page

Parameters

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

ParameterMand Type Default Constraints
setyesdataset 
Name of the image dataset to plot.
 
devicenostring/xs 
PGPLOT device, e.g. /GIF /CPS (colour Postscript) or /XW (X-windows). These are not case-sensitive.
 
gridstylenostringticksticks|grid|none
Style of grid overlay.
 
imagestylenostringimageimage|contour
Whether to draw a colour-coded image or a contour plot.
 
zscaletypenostringlinearlinear|log|sqrt
The image transfer function.
 
colourmapnointeger7-2 to 7
Colour scale: -2=reverse-rainbow, -1=reverse-greyscale, 1=grey, 2=rainbow, 3=heat, 4=IRAF, 5=AIPS, 6=TJP, 7=Rainbow+white (default).
 
contourstylenostringnumbernumber|separation
Style of calculation of the contour separation.
 
ncontoursnointeger5ncontours$>$1
Number of contours (valid if contourstyle=`number').
 
contourseparationnoreal0.2contourseparation$>$0
Separation of contours as a fraction of the distance between maximum and minimum (clipped) values of the image (valid if contourstyle=`separation').
 
withzclipnobooleanyes 
Truncate brightest and faintest pixels?
 
zhistolonoreal0.0$0.0\le$zhistolo$\le 1.0$
Active only if withzclip=yes. The pixels are ordered in order of increasing brightness; the minimum image brightness is then defined to be that value such that only zhistolo (as a fraction of the total number) of the pixels are fainter than this. Fainter pixels are then set to equal this lower limiting value.
 
zhistohinoreal0.999$0.0\le$zhistohi$\le 1.0$
Active only if withzclip=yes. The pixels are ordered in order of increasing brightness; the maximum image brightness is then defined to be that value such that zhistohi (as a fraction of the total number) of the pixels are fainter than this. Brighter pixels are then set to equal this upper limiting value.
 
trimbordernobooleanyes 
Trim any blank (ie, zero- or null-valued) border from the displayed image?
 
withframenobooleanyes 
Include the frame plus anciliary information to the side.
 
withxyclipnobooleanno 
Display only a part of the image?
 
xfraclonoreal0.0$0.0\le$xfraclo$\le 1.0$
Active only if withxyclip=yes. Suppose the size of the image in the x-direction (after any blank border has been removed) is $P$ pixels. Only that part of the image starting at pixel xfraclo$\times P$ is displayed. Note that xfraclo must be smaller than xfrachi.
 
xfrachinoreal1.0$0.0\le$xfrachi$\le 1.0$
Active only if withxyclip=yes. Suppose the size of the image in the x-direction (after any blank border has been removed) is $P$ pixels. Only that part of the image ending at pixel xfrachi$\times P$ is displayed. Note that xfraclo must be smaller than xfrachi.
 
yfraclonoreal0.0$0.0\le$yfraclo$\le 1.0$
Active only if withxyclip=yes. Suppose the size of the image in the y-direction (after any blank border has been removed) is $Q$ pixels. Only that part of the image starting at pixel yfraclo$\times Q$ is displayed. Note that yfraclo must be smaller than yfrachi.
 
yfrachinoreal1.0$0.0\le$yfrachi$\le 1.0$
Active only if withxyclip=yes. Suppose the size of the image in the y-direction (after any blank border has been removed) is $Q$ pixels. Only that part of the image ending at pixel yfrachi$\times Q$ is displayed. Note that yfraclo must be smaller than yfrachi.
 
withsrclisttabnobooleanyes 
Plot circles around source positions?
 
srclisttabnotablesrclist.ds:SRCLIST
Name of the dataset+table containing the source list. Note that the name should be in two parts, separated by a colon, these comprising the name of the dataset followed by the name of the table. If the colon + table name is omitted, the first table in the dataset is used.
 
expressionnostring  
Source selection expression, possibly involving column names, keyword values or constants. See selectlib for the grammar. Only those sources for which the expression evaluates to TRUE are plotted. The default (an empty expression) is TRUE for all sources.
 
ncutsortstylenostring`none'radiusup|radiusdown|expr|rownumber|none
This parameter controls how the source list is sorted before being truncated at number ncut. See the description of this parameter in subsection 3.4 but, briefly: if ncutsortstyle = `expr', the task evaluates ncutsortexpression, sorts the sources in increasing order of the result, then plots only the first ncut of them; if ncutsortstyle = `none', no sorting or truncation is done: all of the (selected) sources are plotted.
 
ncutsortexpressionnostringRATE 
If ncutsortstyle = `expr', the task evaluates ncutsortexpression and sorts the sources in increasing order of the result. The parameter ncut is then read and only the first ncut sources are plotted.
 
ncutnointeger30$0\le$ncut
Maximum number of sources to plot. This parameter has no effect when ncutsortstyle = `none'.
 
addusersourcesnobooleanno 
Plot additional sources at user-supplied positions?
 
userrasnoreal list $0.0\le$userras$\le 360.0$
A list of Right Ascensions of the user-added sources. This and parameter userdecs are of type `angle' described in the param task documentation.
 
userdecsnoreal list $-90.0\le$userdecs$\le 90.0$
A list of Declinations of the user-added sources. This and parameter userras are of type `angle' described in the param task documentation.
 
userlabelsnostring list  
A list of label text strings for the user-added sources.
 
usercoloursnointeger list $0\le$usercolours$\le 7$
A list of colour indices for the user-added sources. These are defined as follows:
  • 0: black.
  • 1: white.
  • 2: red.
  • 3: green.
  • 4: blue.
  • 5: cyan.
  • 6: purple.
  • 7: yellow.

 
radiusstylenostringexprexpr|psf
This parameter controls how the radii of the source circles are scaled. If radiusstyle=`psf', an ellipse is plotted about each source that represents the locus at which the intensity of the source's Point Spread Function (PSF) is equal to the background level. If radiusstyle=`expr', the expression (involving in general keywords, column names etc) found in radiusexpression is evaluated and the radii scaled from that. See subsection 3.5.
 
withellipsenobooleanno 
Use an elliptical locus abround sources (radiusstyle=`psf')? (Otherwise use a circle with radius equal to the larger semiradius of the ellipse.)
 
bkgfractionnoreal1.0bkgfraction$>$ 0.0
If radiusstyle=`psf', an ellipse is generated at the locus at which the source counts per pixel (obtained from the column SCTS) equal bkgfraction times the background counts per pixel (obtained from the column BG_RATE).
 
radiusexpressionnostringRATE 
This parameter specifies an arithmetical expression, possibly involving column names, keyword values or constants. The result is used to scale the radii of the plotted circles.
 
maxradiusnoreal15.0$1.0\le$maxradius$\le 100.0$
The maximum radius (in image pixels) of the plotted circles.
 
labelstylenostringnoneradiusup|radiusdown|expr|rownumber|none
This parameter controls how source labels are assigned. See the description of this parameter in subsection 3.6.
 
labelexpressionnostringBOX_ID_SRC 
If labelstyle = `expr', the task evaluates labelexpression and assigns the ordered, integer-valued source labels from the result.
 
labelcolournointeger7$0\le$labelcolour$\le 7$
Colour index of the plotted circle and associated label text.
 
labelsizenoreal1.0$0.0\le$labelsize
The font size to use for labels.
 
thicknessnointeger1$1\le$thickness$\le 5$
The line thickness to use for source circles.
 
ParameterMand Type Default Constraints


User-added sources. Home Page Errors Home Index

XMM-Newton SOC/SSC -- 2003-01-10