From 5a332c5a21c4f8613cc2c5e407bf6e46f4827818 Mon Sep 17 00:00:00 2001
From: William Joye DS9 will process each command line option, one at a time, as
- the
- last step in the initialization process. Therefore, it is
- possible
- to use command line options as a little script. For example, the
- following command line option is used:
First DS9 is put in tile mode, then foo.fits is - loaded. - Then the colormap for foo.fits is changed to Heat + loaded. Then the colormap for foo.fits is changed to Heat and the scale changed to zscale. Next, bar.fits is loaded and the colormap for bar.fits is changed to I8.
@@ -159,11 +156,9 @@ Syntax:Control external analysis tasks. Tasks are numbered as they are loaded, starting with 0. Can also be used to display a message - and - display text in the text dialog window.
+ and display text in the text dialog window. Syntax:Select ASINH scale function for the current frame.
@@ -334,10 +315,8 @@ [factor <value> [<value>]]Support for catalogs. The first three commands will create a - new - catalog search. All other commands operated on the last search - created, unless indicated otherwise.
+ new catalog search. All other commands operated on the last + search created, unless indicated otherwise. Syntax:Controls the colormap for the current frame. The colormap name is not case sensitive. A valid contrast value is from 0 to - 10 - and bias value from 0 to 1.
+ 10 and bias value from 0 to 1. Syntax:Load an ENVI header and file. Optional parameter: array
- endian.
+
Load an ENVI header and file. Optional parameter: array endian.
Export loaded image data of current frame in specified image
format, at native resolution, using current colormap and
contrast/bias settings. NOTE: not scaling, rotation, or
- translation
- is applied. If no format specified, the file name extension is
- used
- to determine the output format. Optional parameters: jpeg
- quality
- (1-100) and tiff compression method.
+ translation is applied. If no format specified, the file name
+ extension is used to determine the output format. Optional
+ parameters: jpeg quality (1-100) and tiff compression method.
Set the name of the IRAF input and output fifos. The default is - /dev/imt1. These fifos are used by IRAF to communicate with - DS9.
+ /dev/imt1. These fifos are used by IRAF to communicate with DS9. Syntax:Controls frame functions. Frames may be created, deleted, - reset, - and centered. While return the current frame number. If you goto - a - frame that does not exists, it will be created. If the frame is - hidden, it will be shown. The 'frameno' option is available for - backward compatibility.
+ reset, and centered. While return the current frame number. If + you goto a frame that does not exists, it will be created. If + the frame is hidden, it will be shown. The 'frameno' option is + available for backward compatibility. Syntax:Define the initial window geometry. This includes all of the - ds9 - window, not just the image space. see X(1).
+ ds9 window, not just the image space. see X(1). Syntax:Set the height of the image display window. Use the geometry command to set the - overall - width and height of the ds9 window.
+ overall width and height of the ds9 window. Syntax:Select histogram equalization scale function for the current @@ -1454,37 +1325,30 @@
Lock all other frames to the current frame.
Syntax:Match all other frames to the current frame.
Syntax:Load FITS multiple extension file as data cube.
@@ -1588,8 +1446,7 @@
Example:
$ds9 -mecube foo.fits
- $cat foo.fits | ds9
- -mecube -
+ $cat foo.fits | ds9 -mecube -
This is how DS9 determines the min and max data values from the data. SCAN will scan all data.
@@ -1619,10 +1476,8 @@Create mpeg1 movie from snap shots of the DS9 window. A
- slice movie cycles though all slices of a cube. A
- frame movie cycles through all active frames. A
- 3d movie cycles through specified viewing angles. The
- default is frame. Optional parameters for 3d:
- number of frames, azimuth from/to, elevation from/to, slice
- from/to, oscillate/repeat times.
+
Create mpeg1 movie from snap shots of the DS9 window. A slice
+ movie cycles though all slices of a cube. A frame
+ movie cycles through all active frames. A 3d movie
+ cycles through specified viewing angles. The default is frame.
+ Optional parameters for 3d: number of frames, azimuth
+ from/to, elevation from/to, slice from/to, oscillate/repeat
+ times.
Specify a directory of translation tables to be loaded.
Syntax:Support Name Server functions. Coordinates are in fk5.
Syntax:Controls the current image cursor location for the current frame.
Syntax:Display/Hide the pixel table.
Syntax:Display and configure data plots. All plot commands take an optional second command, the plot name. If no plot name is specified, the last plot created is assumed. Plot data is - assumed - to be a pair of coordinates, with optional error values. The - follow - are valid data descriptions:
+ assumed to be a pair of coordinates, with optional error values. + The follow are valid data descriptions:xy x and y coordinates
xyex x,y coordinates with x errors
xyey x,y coordinates with y errors
@@ -1827,258 +1674,178 @@
To create a new plot, use the plot new command.
Syntax:Load PNG image into current frame.
Set the IRAF port number, used by IRAF to communicate with DS9. - The default is 5137, the standard IRAF port used by - ximtool.
+ The default is 5137, the standard IRAF port used by ximtool. Syntax:Set region and coordinate output format precision.
Syntax:Controls printing. Use print option to set printing
- options.
+
Controls printing. Use print option to set printing options.
Raise in the window stacking order.
Syntax:Load FITS rgbimage into rgb frame.
Controls the rotation angle (in degrees) of the current frame.<
@@ -2446,8 +2193,7 @@ Example:Support for VO Simple Image Access protocol. The first command will create a new search. All other commands operated on the - last - search created, unless indicated otherwise.
+ last search created, unless indicated otherwise. Syntax:Controls the tile display mode.
@@ -2860,9 +2576,8 @@ form, the first argument is the number of the fits HDU (starting with 1) and the remaining args are a bounding box in IMAGE coordinates. By default, the screen is updated the next - available - idle cycle. However, you may force an immediate update by - specifying the NOW option. + available idle cycle. However, you may force an immediate update + by specifying the NOW option. Syntax:Controls the World Coordinate System for the current frame. If the wcs system, skyframe, or skyformat is modified, the info - panel, - compass, grid, and alignment will be modified accordingly. Also, - a - new WCS specification can be loaded and used by the current - image - regardless of the WCS that was contained in the image file. - Please - see WCS for more information.
+ panel, compass, grid, and alignment will be modified + accordingly. Also, a new WCS specification can be loaded and + used by the current image regardless of the WCS that was + contained in the image file. Please see WCS + for more information. Syntax:Set the width of the image display window. Use the geometry command to set the - overall - width and height of the ds9 window.
+ overall width and height of the ds9 window. Syntax:2mass name clearSAMP is a messaging protocol that enables astronomy software tools to interoperate and communicate. Broadly speaking, SAMP is - an - abstract framework for loosely-coupled, asynchronous, RPC-like - and/or event-based communication, based on a central service - providing multi-directional publish/subscribe message brokering. - The message semantics are extensible and use structured but - weakly-typed data. For more information on SAMP, please click - here.
+ an abstract framework for loosely-coupled, asynchronous, + RPC-like and/or event-based communication, based on a central + service providing multi-directional publish/subscribe message + brokering. The message semantics are extensible and use + structured but weakly-typed data. For more information on SAMP, + please click here.The samp implementation for DS9 is based on the XPA model with 2 private calls:
ds9.get
@@ -163,8 +163,7 @@ [<ra> <dec>] # in wcs fk5
[size <width> - <height> - degrees|arcmin|arcsec]
+ <height> degrees|arcmin|arcsec]
[save yes|no]
[frame new|current]
[update frame|crosshair]
@@ -183,10 +182,8 @@ 2mass
2mass m31
2mass name m31
- - 2mass name clear
- 2mass 00:42:44.404 - +41:16:08.78
+
Control external analysis tasks. Tasks are numbered as they are loaded, starting with 0. Can also be used to display a message - and - display text in the text dialog window.
+ and display text in the text dialog window. Syntax:Create a backup save set.
@@ -362,13 +344,11 @@Controls binning factor, binning buffer size, and binning function for binning FITS bin tables. The access point blocking - is - provided for backward compatibility.
+ is provided for backward compatibility. Syntax:Support for catalogs. The first three commands will create a - new - catalog search. All other commands operated on the last search - created, unless indicated otherwise.
+ new catalog search. All other commands operated on the last + search created, unless indicated otherwise. Syntax:Controls the colormap for the current frame. The colormap name is not case sensitive. A valid contrast value is from 0 to - 10 - and bias value from 0 to 1.
+ 10 and bias value from 0 to 1. Syntax:Return an array of data values given a lower left corner and a
width and height in specified coordinate system. The last
- argument
- of yes indicates to strip the coordinates from the output and
- just
- list the data values. The default is yes.
+ argument of yes indicates to strip the coordinates from the
+ output and just list the data values. The default is yes.
dsssao
dss
@@ -1054,11 +962,9 @@
Syntax:
dsssao []
[<object>]
- [name
- <object>|clear]
+ [name <object>|clear]
[<ra> <dec>] #
- in
- wcs fk5
+ in wcs fk5
[size <width>
<height> degrees|arcmin|arcsec]
[save yes|no]
@@ -1077,10 +983,8 @@
dsssao
dsssao m31
dsssao name m31
-
- dsssao name clear
- dsssao 00:42:44.404
- +41:16:08.78
+ dsssao name clear
+ dsssao 00:42:44.404 +41:16:08.78
dsssao size 60 60 arcmin
dsssao save yes
dsssao frame current
@@ -1093,11 +997,9 @@
Syntax:
dsseso []
[<object>]
- [name
- <object>|clear]
+ [name <object>|clear]
[<ra> <dec>] #
- in
- wcs fk5
+ in wcs fk5
[size <width>
<height> degrees|arcmin|arcsec]
[save yes|no]
@@ -1119,10 +1021,8 @@
dsseso
dsseso m31
dsseso name m31
-
- dsseso name clear
- dsseso 00:42:44.404
- +41:16:08.78
+ dsseso name clear
+ dsseso 00:42:44.404 +41:16:08.78
dsseso size 60 60 arcmin
dsseso save yes
dsseso frame current
@@ -1166,10 +1066,8 @@
dssstsci
dssstsci m31
dssstsci name m31
-
- dssstsci name clear
- dssstsci 00:42:44.404
- +41:16:08.78
+ dssstsci name clear
+ dssstsci 00:42:44.404 +41:16:08.78
dssstsci size 60 60 arcmin
dssstsci save yes
dssstsci frame current
@@ -1178,8 +1076,7 @@
dssstsci open
dssstsci close
Load an ENVI header and file. Optional parameter: array
- endian.
+
Load an ENVI header and file. Optional parameter: array endian.
Syntax:
Controls frame functions. Frames may be created, deleted, - reset, - and centered. While return the current frame number. If you goto - a - frame that does not exists, it will be created. If the frame is - hidden, it will be shown. The 'frameno' option is available for - backward compatibility.
+ reset, and centered. While return the current frame number. If + you goto a frame that does not exists, it will be created. If + the frame is hidden, it will be shown. The 'frameno' option is + available for backward compatibility. Syntax:Interactive examine function. A blinking cursor will indicate - to - the user to click on a point on an image. The specified - information - will be returned at that time. The default event is + to the user to click on a point on an image. The specified + information will be returned at that time. The default event is button. In the last form, the following macros will be expanded if present: $width, $height, $depth, $bitpix, $filename, $regions, $filename[$regions], $env, $pan, $value, - $x, - $y, $z. See See Analysis + Macros for more information.
Syntax:Set/Get IIS Filename. Optional mosaic number maybe supplied.
@@ -1766,34 +1612,29 @@ iis filename foo.fitsLoad JPEG image into current frame. Optional parameters: - jpeg quality (1-100)
+Load JPEG image into current frame. Optional parameters: jpeg + quality (1-100)
Syntax:Lock all other frames to the current frame.
Syntax:Match all other frames to the current frame.
Syntax:Create mpeg1 movie from snap shots of the DS9 window. A - slice movie cycles though all slices of a cube. A - frame movie cycles through all active frames. A - 3d movie cycles through specified viewing angles. The - default is frame. Optional parameters for 3d: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times.
+Create mpeg1 movie from snap shots of the DS9 window. A slice + movie cycles though all slices of a cube. A frame + movie cycles through all active frames. A 3d movie + cycles through specified viewing angles. The default is frame. + Optional parameters for 3d: number of frames, azimuth + from/to, elevation from/to, slice from/to, oscillate/repeat + times.
Syntax:Load FITS multiple extension file as multiple images.
Support Name Server functions. Coordinates are in fk5.
Syntax:Display and configure data plots. All plot commands take an optional second command, the plot name. If no plot name is specified, the last plot created is assumed. Plot data is - assumed - to be a pair of coordinates, with optional error values. The - follow - are valid data descriptions:
+ assumed to be a pair of coordinates, with optional error values. + The follow are valid data descriptions:xy x and y coordinates
xyex x,y coordinates with x errors
xyey x,y coordinates with y errors
@@ -2243,394 +2051,251 @@
To create a new plot, use the plot new command.
Syntax:Set region and coordinate output format precision.
Syntax:Raise in the window stacking order.
Syntax:Load FITS rgbcube into rgb frame.
Controls the rotation angle (in degrees) of the current - frame.
+Controls the rotation angle (in degrees) of the current frame.
Syntax:Support for VO Simple Image Access protocol. The first command will create a new search. All other commands operated on the - last - search created, unless indicated otherwise.
+ last search created, unless indicated otherwise. Syntax:Set number of process threads for functions which are
@@ -3416,24 +3034,20 @@
Example:
string value = ds9.get(string cmd)
-
- threads
+ threads
ds9.set(string cmd)
threads 8
Load TIFF image into current frame. Optional parameters: - tiff compression method.
+Load TIFF image into current frame. Optional parameters: tiff + compression method.
Syntax:Returns the current version of DS9.
Syntax:Controls the World Coordinate System for the current frame. If the wcs system, skyframe, or skyformat is modified, the info - panel, - compass, grid, and alignment will be modified accordingly. Also, - using this access point, a new WCS specification can be loaded - and - used by the current image regardless of the WCS that was - contained - in the image file. WCS specification can be sent to DS9 as an - ASCII - file . Please see WCS for more - information.
+ panel, compass, grid, and alignment will be modified + accordingly. Also, using this access point, a new WCS + specification can be loaded and used by the current image + regardless of the WCS that was contained in the image file. WCS + specification can be sent to DS9 as an ASCII file . Please see WCS for more information. Syntax:The XPA - messaging - system provides seamless communication between DS9 and other - Unix - programs, including X programs, Perl, S-Lang, and Tcl/Tk. It also provides an easy way for users to - communicate - with DS9 by executing XPA client commands in the shell or by - utilizing such commands in scripts. Because XPA works both at - the - programming level and the shell level, it is a powerful tool for - unifying any analysis environment.
+ communicate with DS9 by executing XPA client commands in the + shell or by utilizing such commands in scripts. Because XPA + works both at the programming level and the shell level, it is a + powerful tool for unifying any analysis environment. 2mass
3d
about
@@ -136,16 +132,13 @@ [<ra> <dec>] # in wcs fk5
[size <width> - <height> - degrees|arcmin|arcsec]
+ <height> degrees|arcmin|arcsec]
[save yes|no]
[frame new|current]
[update frame|crosshair]
[survey j|h|k]
- - [open|close]
- -
+ [open|close]
+
Example:
$xpaget ds9 2mass name
$xpaget ds9 2mass coord
@@ -155,19 +148,15 @@ $xpaget ds9 2mass survey
$xpaset -p ds9 2mass
$xpaset -p ds9 2mass m31
- - $xpaset -p ds9 2mass name m31
- - $xpaset -p ds9 2mass name clear
- $xpaset - -p ds9 2mass 00:42:44.404 +41:16:08.78
+ $xpaset -p ds9 2mass name m31
+ $xpaset -p ds9 2mass name clear
+ $xpaset -p ds9 2mass 00:42:44.404 +41:16:08.78
$xpaset -p ds9 2mass size 60 60 arcmin
$xpaset -p ds9 2mass save yes
$xpaset -p ds9 2mass frame current
$xpaset -p ds9 2mass update frame
$xpaset -p ds9 2mass survey j
- $xpaset -p ds9 2mass - open
+ $xpaset -p ds9 2mass open
$xpaset -p ds9 2mass close
Support for 3D frame.
@@ -179,19 +168,15 @@ [scale <scale>]
[method mip|aip]
[background none|azimuth|elevation]
- - [border yes|no]
+ [border yes|no]
[border color <color>]
[highlite yes|no]
[highlite color <color>]
- - [compass yes|no]
+ [compass yes|no]
[compass color <color>]
- - [match]
+ [match]
[lock [yes|no]]
- - [open|close]
+ [open|close]
Example:
$xpaget ds9 3d view
@@ -199,44 +184,34 @@ $xpaget ds9 3d el
$xpaget ds9 3d scale
$xpaget ds9 3d method
- $xpaget ds9 3d - background
+ $xpaget ds9 3d background
$xpaget ds9 3d border
$xpaget ds9 3d border color
$xpaget ds9 3d highlite
$xpaget ds9 3d highlite color
- $xpaget ds9 3d - compass
- $xpaget ds9 3d compass - color
- $xpaget ds9 3d - lock
- $xpaset -p ds9 3d # create new 3D - frame
+ $xpaget ds9 3d compass
+ $xpaget ds9 3d compass color
+ $xpaget ds9 3d lock
+ $xpaset -p ds9 3d # create new 3D frame
$xpaset -p ds9 3d view 45 30
$xpaset -p ds9 3d az 45
$xpaset -p ds9 3d el 30
$xpaset -p ds9 3d scale 10
$xpaset -p ds9 3d method mip
$xpaset -p ds9 3d background azimuth
- $xpaset -p - ds9 3d border yes
+ $xpaset -p ds9 3d border yes
$xpaset -p ds9 3d border color red
$xpaset -p ds9 3d highlite yes
$xpaset -p ds9 3d highlite color red
- $xpaset - -p ds9 3d compass yes
- - $xpaset -p ds9 3d compass color - red
- - $xpaset -p ds9 3d - match
+ $xpaset -p ds9 3d compass yes
+ $xpaset -p ds9 3d + compass color red
+ $xpaset + -p ds9 3d match
$xpaset -p ds9 3d lock yes
- $xpaset - -p ds9 3d open
+ $xpaset -p ds9 3d open
$xpaset -p ds9 3d close
@@ -261,8 +236,7 @@Control external analysis tasks. Tasks are numbered as they are loaded, starting with 0. Can also be used to display a message - and - display text in the text dialog window.
+ and display text in the text dialog window. Syntax:
analysis [<task number>]
@@ -278,8 +252,7 @@ ok|okcancel|yesno <message>]
[entry <message>]
- - [text]
+ [text]
Example:
$xpaget ds9 analysis
@@ -311,10 +284,8 @@ $xpaget ds9 array > foo.arr
$xpaget ds9 array little > foo.arr
$xpaset -p ds9 array foo.arr[dim=512,bitpix=-32,endian=little]
- $xpaset -p ds9 array new - foo.arr[dim=512,bitpix=-32,endian=little]
- $xpaset -p ds9 array mask - foo.arr[dim=512,bitpix=-32,endian=little]
+ $xpaset -p ds9 array new foo.arr[dim=512,bitpix=-32,endian=little]
+ $xpaset -p ds9 array mask foo.arr[dim=512,bitpix=-32,endian=little]
$cat foo.arr | xpaset ds9 array [dim=512,bitpix=-32,endian=little]
$cat foo.arr | xpaset ds9 array new @@ -340,8 +311,7 @@Controls binning factor, binning buffer size, and binning function for binning FITS bin tables. The access point blocking - is - provided for backward compatibility.
+ is provided for backward compatibility. Syntax:
bin [about <x> <y>]
[about center]
@@ -351,10 +321,8 @@ [factor <value> [<vector>]]
[depth <value>]
[filter <string>]
- - [filter clear]
- - [function average|sum]
+ [filter clear]
+ [function average|sum]
[in]
[out]
[to fit]
@@ -417,8 +385,7 @@ <value>]
[in]
[out]
- - [to fit]
+ [to fit]
[match]
[lock [yes|no]]
[open|close]
@@ -426,41 +393,34 @@ Example:
$xpaget ds9 block
$xpaget ds9 block lock
- $xpaset -p ds9 - block 4
+ $xpaset -p ds9 block 4
$xpaset -p ds9 block 4 2
- - $xpaset -p ds9 block to - 4
+ $xpaset -p ds9 block + to 4
$xpaset -p ds9 block to 4 2
- - $xpaset -p ds9 block in
- - $xpaset -p ds9 block + $xpaset -p ds9 block in
+ $xpaset -p ds9 block out
- $xpaset -p ds9 block - to fit
+ $xpaset -p ds9 block to + fit
$xpaset -p ds9 block match
$xpaset -p ds9 block lock yes
$xpaset -p ds9 block open
- $xpaset -p ds9 block - close
+ $xpaset -p ds9 block close
Support for catalogs. The first three commands will create a - new - catalog search. All other commands operated on the last search - created, unless indicated otherwise.
+ new catalog search. All other commands operated on the last + search created, unless indicated otherwise. Syntax:
catalog [new]
[ned|simbad|denis|skybot]
[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|sdss7|sdss8|sdss9|tycho]
- - [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1]
+ [ua2|ub1|ucac2|ucac2sup|ucac3|ucac4|urat1]
[2mass|iras]
[csc|xmm|rosat]
[first|nvss]
@@ -474,31 +434,26 @@ [import sb|tsv <filename>]
- - [<ref>] [<ra> <dec> - <coordsys>]
- - [<ref>] [allcols]
- - [<ref>] - [allrows]
+ [<ref>] + [<ra> <dec> <coordsys>]
+ [<ref>] [allcols]
+ + [<ref>] [allrows]
[<ref>] [cancel]
- - [<ref>] [clear]
- - [<ref>] [close]
- - [<ref>] [crosshair]
+ [<ref>] + [clear]
+ [<ref>] [close]
+ [<ref>] + [crosshair]
[<ref>] [dec <col>]
[<ref>] [edit yes|no]
[<ref>] [export sb|tsv <filename>]
- - [<ref>] - [filter <string>]
+ + [<ref>] [filter <string>]
[<ref>] [filter load <filename>]
[<ref>] @@ -507,28 +462,25 @@ <code>]
[<ref>] [match]
- - + + [<ref>] [match <ref> <ref>]
- - [<ref>] + [<ref>] [match + error <value> degrees|arcmin|arcsec]
- - [<ref>] [match function 1and2|1not2|2not1]
- - - [<ref>] [match return 1and2|1only|2only]
- - [<ref>] [match unique yes|no]
+ [<ref>] + [match function 1and2|1not2|2not1]
+ [<ref>] + [match return 1and2|1only|2only]
+ [<ref>] + [match unique yes|no]
[<ref>] [maxrows <number>]
[<ref>] [name <object>]
- - [<ref>] - [panto - yes|no]
+ + [<ref>] [panto yes|no]
[<ref>] [plot <xcol> <ycol> <xerrcol> <yerrcol>]
[<ref>] [print]
@@ -538,55 +490,48 @@ <coordsys>]
[<ref>] [ra <col>]
- [<ref>] - [regions]
- [<ref>] - [retrieve]
+ [<ref>] [regions]
+ [<ref>] [retrieve]
[<ref>] [samp]
[<ref>] [samp broadcast]
[<ref>] [samp - send - <application>]
- - [<ref>] [save - <filename>]
+ send <application>]
+ + [<ref>] [save <filename>]
[<ref>] - [server - cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]
+ [server cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]
[<ref>] [show yes|no]
[<ref>] [radius <value> degrees|arcmin|arcsec]
[<ref>] [sky <skyframe>]
- - [<ref>] [skyformat - <skyformat>]
- - [<ref>] [sort <col> - incr|decr]
+ [<ref>] + [skyformat <skyformat>]
+ [<ref>] + [sort <col> incr|decr]
[<ref>] [symbol [#] condition|shape|color|text|font|fontsize|fontweight|fontslant <value>]
- - [<ref>] [symbol [#] text|size|size2|units|angle - <value>]
- - [<ref>] [symbol shape circle|ellipse|box|text|point]
+ [<ref>] + [symbol [#] text|size|size2|units|angle <value>]
+ [<ref>] + [symbol shape circle|ellipse|box|text|point]
[<ref>] [symbol - shape circle point|box point|diamond - point|cross point|x point|arrow point|boxcircle point]
+ + shape circle point|box point|diamond point|cross + point|x point|arrow point|boxcircle point]
[<ref>] [symbol add| [#] remove]
[<ref>] [symbol save|load <filename>]
[<ref>] [system <coordsys>]
- - [<ref>] [update]
+ [<ref>] + [update]
[<ref>] [x <col>]
[<ref>] [y @@ -594,12 +539,10 @@
Example:
$xpaget ds9 catalog
- $xpaget ds9 catalog - header
+ $xpaget ds9 catalog header
$xpaset -p ds9 catalog new
- $xpaset - -p ds9 catalog 2mass
+ $xpaset -p ds9 catalog 2mass
$xpaset -p ds9 catalog cds 2mass
$xpaset -p ds9 catalog cds {I/252}
@@ -607,79 +550,58 @@ $xpaset -p ds9 catalog import tsv foo.tsv
$xpaset -p ds9 catalog 202.48 47.21 fk5
- - $xpaset -p ds9 catalog allrows
+ $xpaset -p ds9 catalog allrows
$xpaset -p ds9 catalog allcols
- $xpaset -p ds9 catalog - cancel
+ $xpaset -p ds9 catalog cancel
$xpaset -p ds9 catalog clear
- - $xpaset -p ds9 catalog close
- $xpaset -p ds9 - catalog crosshair
- $xpaset -p ds9 catalog dec - DEC
+ $xpaset -p ds9 catalog close
+ $xpaset -p ds9 catalog crosshair
+ $xpaset -p ds9 catalog dec DEC
$xpaset -p ds9 catalog edit yes
- - $xpaset -p ds9 catalog export tsv bar.tsv
- $xpaset - -p ds9 catalog filter '$Jmag>10'
+ $xpaset -p ds9 catalog export tsv bar.tsv
+ $xpaset -p ds9 catalog filter '$Jmag>10'
$xpaset -p ds9 catalog filter load foo.flt
$xpaset -p ds9 catalog header
- $xpaset -p ds9 catalog - location 500
+ $xpaset -p ds9 catalog location 500
$xpaset -p ds9 catalog match error 2 arcsec
$xpaset -p ds9 catalog match function 1and2
$xpaset -p ds9 catalog match unique no
$xpaset -p ds9 catalog match return 1only
- $xpaset -p - ds9 catalog match # last two catalogs loaded
- $xpaset - -p ds9 catalog match 2mass csc
- $xpaset -p ds9 catalog - maxrows 2000
+ $xpaset -p ds9 catalog match # last two catalogs loaded
+ $xpaset -p ds9 catalog match 2mass csc
+ $xpaset -p ds9 catalog maxrows 2000
$xpaset -p ds9 catalog name m51
$xpaset -p ds9 catalog panto no
- $xpaset -p ds9 catalog - plot '$Jmag' '$Hmag' '$e_Jmag' '$e_Hmag'
- $xpaset -p - ds9 catalog print
+ $xpaset -p ds9 catalog plot '$Jmag' '$Hmag' '$e_Jmag' + '$e_Hmag'
+ $xpaset -p ds9 catalog print
$xpaset -p ds9 catalog psky fk5
$xpaset -p ds9 catalog psystem wcs
$xpaset -p ds9 catalog ra RA
$xpaset -p ds9 catalog regions
$xpaset -p ds9 catalog retrieve
- $xpaset -p ds9 - catalog samp broadcast
+ $xpaset -p ds9 catalog samp broadcast
$xpaset -p ds9 catalog samp send aladin
$xpaset -p ds9 catalog save foo.xml
- $xpaset -p ds9 - catalog server sao
- $xpaset -p ds9 catalog show - yes
+ $xpaset -p ds9 catalog server sao
+ $xpaset -p ds9 catalog show yes
$xpaset -p ds9 catalog radius 1 degrees
$xpaset -p ds9 catalog symbol condition '$Jmag>15'
$xpaset -p ds9 catalog symbol 2 shape {boxcircle point}
$xpaset -p ds9 catalog symbol color red
$xpaset -p ds9 catalog symbol font times
- $xpaset -p - ds9 catalog symbol fontsize 14
- $xpaset -p ds9 catalog - symbol fontweight bold
- $xpaset -p ds9 catalog symbol - fontslant italic
+ $xpaset -p ds9 catalog symbol fontsize 14
+ $xpaset -p ds9 catalog symbol fontweight bold
+ $xpaset -p ds9 catalog symbol fontslant italic
$xpaset -p ds9 catalog symbol add
$xpaset -p ds9 catalog symbol 2 remove
$xpaset -p ds9 catalog symbol load foo.sym
$xpaset -p ds9 catalog symbol save bar.sym
$xpaset -p ds9 catalog sky fk5
$xpaset -p ds9 catalog skyformat degrees
- $xpaset -p - ds9 catalog sort {Jmag} incr
- $xpaset -p ds9 catalog - system wcs
- $xpaset -p ds9 catalog - update
+ $xpaset -p ds9 catalog sort {Jmag} incr
+ $xpaset -p ds9 catalog system wcs
+ $xpaset -p ds9 catalog update
$xpaset -p ds9 catalog x RA
$xpaset -p ds9 catalog y DEC
@@ -694,21 +616,17 @@Controls the colormap for the current frame. The colormap name is not case sensitive. A valid contrast value is from 0 to - 10 - and bias value from 0 to 1.
+ 10 and bias value from 0 to 1. Syntax:
cmap [<colormap>]
[file]
[load <filename>]
- - [save <filename>]
- - [invert yes|no]
+ [save <filename>]
+ [invert yes|no]
[<constrast> <bias>]
[tag [load|save] <filename>]
[tag delete]
- - [open|close]
+ [open|close]
Example:
$xpaget ds9 cmap
@@ -717,15 +635,13 @@ $xpaget ds9 cmap value
$xpaset -p ds9 cmap Heat
$xpaset -p ds9 cmap load foo.sao
- $xpaset -p ds9 cmap - save bar.sao
+ $xpaset -p ds9 cmap save bar.sao
$xpaset -p ds9 cmap invert yes
$xpaset -p ds9 cmap 5 .5
$xpaset -p ds9 cmap tag load foo.tag
$xpaset -p ds9 cmap tag save foo.tag
$xpaset -p ds9 cmap tag delete
- $xpaset -p ds9 cmap - open
+ $xpaset -p ds9 cmap open
$xpaset -p ds9 cmap close
colorbar
@@ -978,10 +884,8 @@
@@ -751,8 +667,7 @@ roman|italic]
[size]
[ticks]
- - [match]
+ [match]
[lock [yes|no]]
@@ -811,8 +726,7 @@ <filename>]
[copy]
[paste - [<coordsys> - <color> <width> yes|no]]
+ [<coordsys> <color> <width> yes|no]]
[color <color>]
[width <width>]
[dash yes|no]
@@ -829,8 +743,7 @@ [limits <min> <max>]
[levels <value - value - value...>]
+ value value...>]
[open|close]
Example:
@@ -852,21 +765,16 @@ $xpaset -p ds9 contour yes
$xpaset -p ds9 contour clear
$xpaset -p ds9 contour generate
- $xpaset -p ds9 - contour load ds9.ctr
- $xpaset -p ds9 contour - save ds9.ctr
- $xpaset -p ds9 contour save ds9.ctr wcs - fk5
+ $xpaset -p ds9 contour load ds9.ctr
+ $xpaset -p ds9 contour save ds9.ctr
+ $xpaset -p ds9 contour save ds9.ctr wcs fk5
$xpaset -p ds9 contour convert
$xpaset -p ds9 contour load levels ds9.ctr
$xpaset -p ds9 contour save levels ds9.lev
- $xpaset - -p ds9 contour copy
- $xpaset -p ds9 contour - paste
- $xpaset -p ds9 contour paste wcs - red 2 no
+ $xpaset -p ds9 contour copy
+ $xpaset -p ds9 contour paste
+ $xpaset -p ds9 contour paste wcs red 2 + no
$xpaset -p ds9 contour color yellow
$xpaset -p ds9 contour width 2
$xpaset -p ds9 contour dash yes
@@ -902,10 +810,8 @@ 22.000204 wcs galactic arcsec
$xpaset -p ds9 crop match wcs
$xpaset -p ds9 crop lock wcs
- $xpaset -p ds9 crop - reset
- $xpaset -p ds9 crop 3d .25 .50 - wcs
+ $xpaset -p ds9 crop reset
+ $xpaset -p ds9 crop 3d .25 .50 wcs
$xpaset -p ds9 crop open
$xpaset -p ds9 crop closeReturn an array of data values given a lower left corner and a width and height in specified coordinate system. The last - argument - of yes indicates to strip the coordinates from the output and - just - list the data values. The default is yes.
+ argument of yes indicates to strip the coordinates from the + output and just list the data values. The default is yes. Syntax:
data [<coordsys> [<skyframe>] <x> <y> <width> <height> [yes|no]]
@@ -1001,11 +905,9 @@ Syntax:
dsssao []
[<object>]
- [name - <object>|clear]
+ [name <object>|clear]
[<ra> <dec>] # - in - wcs fk5
+ in wcs fk5
[size <width> <height> degrees|arcmin|arcsec]
[save yes|no]
@@ -1021,29 +923,23 @@ $xpaget ds9 dsssao frame
$xpaset -p ds9 dsssao
$xpaset -p ds9 dsssao m31
- $xpaset -p ds9 dsssao - name m31
- $xpaset -p ds9 dsssao name - clear
- $xpaset -p ds9 dsssao 00:42:44.404 - +41:16:08.78
+ $xpaset -p ds9 dsssao name m31
+ $xpaset -p ds9 dsssao name clear
+ $xpaset -p ds9 dsssao 00:42:44.404 +41:16:08.78
$xpaset -p ds9 dsssao size 60 60 arcmin
$xpaset -p ds9 dsssao save yes
$xpaset -p ds9 dsssao frame current
$xpaset -p ds9 dsssao update frame
$xpaset -p ds9 dsssao open
- $xpaset -p ds9 dsssao - close
+ $xpaset -p ds9 dsssao close
Support for Digital Sky Survey at ESO.
Syntax:
dsseso []
[<object>]
- [name - <object>|clear]
+ [name <object>|clear]
[<ra> <dec>] # - in - wcs fk5
+ in wcs fk5
[size <width> <height> degrees|arcmin|arcsec]
[save yes|no]
@@ -1062,20 +958,16 @@ $xpaget ds9 dsseso survey
$xpaset -p ds9 dsseso
$xpaset -p ds9 dsseso m31
- $xpaset -p ds9 dsseso - name m31
- $xpaset -p ds9 dsseso name - clear
- $xpaset -p ds9 dsseso 00:42:44.404 - +41:16:08.78
+ $xpaset -p ds9 dsseso name m31
+ $xpaset -p ds9 dsseso name clear
+ $xpaset -p ds9 dsseso 00:42:44.404 +41:16:08.78
$xpaset -p ds9 dsseso size 60 60 arcmin
$xpaset -p ds9 dsseso save yes
$xpaset -p ds9 dsseso frame current
$xpaset -p ds9 dsseso update frame
$xpaset -p ds9 dsseso survey DSS2-red
$xpaset -p ds9 dsseso open
- $xpaset -p ds9 dsseso - close
+ $xpaset -p ds9 dsseso close
Support for Digital Sky Survey at STSCI.
Syntax:
@@ -1109,12 +1001,9 @@ $xpaget ds9 dssstsci survey
$xpaset -p ds9 dssstsci
$xpaset -p ds9 dssstsci m31
- $xpaset -p ds9 - dssstsci name m31
- $xpaset -p ds9 dssstsci - name clear
- $xpaset -p ds9 dssstsci 00:42:44.404 - +41:16:08.78
+ $xpaset -p ds9 dssstsci name m31
+ $xpaset -p ds9 dssstsci name clear
+ $xpaset -p ds9 dssstsci 00:42:44.404 +41:16:08.78
$xpaset -p ds9 dssstsci size 60 60 arcmin
$xpaset -p ds9 dssstsci save yes
$xpaset -p ds9 dssstsci frame current
@@ -1123,8 +1012,7 @@ $xpaset -p ds9 dssstsci open
$xpaset -p ds9 dssstsci close
-Load an ENVI header and file. Optional parameter: array - endian.
+Load an ENVI header and file. Optional parameter: array endian.
Syntax:
envi [new] <header> [<filename>]
@@ -1132,8 +1020,7 @@ Example:
$xpaset -p ds9 envi foo.hdr
$xpaset -p ds9 envi new foo.hdr
- - $xpaset -p ds9 envi foo.hdr + $xpaset -p ds9 envi foo.hdr foo.bsq
exit
@@ -1153,32 +1040,23 @@ format. Optional parameters: array endian, nrrd endian, jpeg quality (1-100) and tiff compression method. Syntax:
- export - [array|nrrd|envi|gif|tiff|jpeg|png] + export [array|nrrd|envi|gif|tiff|jpeg|png] <filename>
- export array - <filename> [big|little|native]
- - export nrrd <filename> - [big|little|native]
- export envi <header> [<filename>] - [big|little|native]
+ export array <filename> [big|little|native]
+ export nrrd <filename> [big|little|native]
+ export envi <header> [<filename>] [big|little|native] +
export jpeg <filename> [1-100]
- - export tiff <filename> - [none|jpeg|packbits|deflate]
+ export tiff <filename> [none|jpeg|packbits|deflate]
Example:
- $xpaset -p ds9 export array foo.arr - little
+ $xpaset -p ds9 export array foo.arr little
$xpaset -p ds9 export nrrd foo.nrrd little
- $xpaset -p ds9 export envi foo.hdr - little
- - $xpaset -p ds9 export envi - foo.hdr foo.bsq little
- $xpaset -p - ds9 export tiff foo.tiff jpeg
+ $xpaset -p ds9 export envi foo.hdr little
+ $xpaset + -p ds9 export envi foo.hdr foo.bsq little
+ $xpaset -p ds9 export tiff + foo.tiff jpeg
$xpaset -p ds9 export jpeg foo.jpeg 75
$xpaset -p ds9 export png foo.png
@@ -1193,10 +1071,8 @@ loaded image.
Syntax:
- fits [new|mask|slice] - [<filename>]
- - [width|height|depth|bitpix]
+ fits [new|mask|slice] [<filename>]
+ [width|height|depth|bitpix]
[size [wcs|wcsa...wcsz] [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]
[header [<ext>] [keyword @@ -1210,8 +1086,7 @@ $xpaget ds9 fits depth
$xpaget ds9 fits bitpix
$xpaget ds9 fits size
- $xpaget ds9 fits size wcs - fk5 arcmin
+ $xpaget ds9 fits size wcs fk5 arcmin
$xpaget ds9 fits header # primary
$xpaget ds9 fits header 2 # hdu 2
$xpaget ds9 fits header -2 # hdu 2 with inherit
@@ -1220,8 +1095,7 @@ $xpaget ds9 fits image > foo.fits
$xpaget ds9 fits table > bar.fits
$xpaget ds9 fits slice > foo.fits
- $xpaset -p ds9 fits - foo.fits
+ $xpaset -p ds9 fits foo.fits
$xpaset -p ds9 fits new foo.fits
$xpaset -p ds9 fits bar.fits[bin=detx,dety]
$xpaset -p ds9 fits slice foo.fits
@@ -1234,12 +1108,10 @@Controls frame functions. Frames may be created, deleted, - reset, - and centered. While return the current frame number. If you goto - a - frame that does not exists, it will be created. If the frame is - hidden, it will be shown. The 'frameno' option is available for - backward compatibility.
+ reset, and centered. While return the current frame number. If + you goto a frame that does not exists, it will be created. If + the frame is hidden, it will be shown. The 'frameno' option is + available for backward compatibility. Syntax:
frame [center [#|all]]
[clear [#|all]]
@@ -1259,32 +1131,27 @@ [last]
[frameno #]
[#]
- - [match <coordsys>]
- [lock - <coordsys>|none]
+ [match <coordsys>]
+ [lock <coordsys>|none]
[has [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]]
[has contour [aux]]]
[has fits [bin|cube|mosaic]]
[has marker [highlite|paste|select|undo]]
- [has system - <coordsys>]
- - [has wcs + [has system <coordsys>]
+ [has wcs [<wcssys>]]
- [has wcs - celestial [<wcssys>]]
- - [has wcs linear [<wcssys>]]
+ [has wcs celestial + [<wcssys>]]
+ [has wcs linear + [<wcssys>]]
Example:
$xpaget ds9 frame # returns the id of the current frame
$xpaget ds9 frame frameno # returns the id of the current frame
$xpaget ds9 frame all # returns the id of all frames
- $xpaget ds9 frame active # returns the id of all active - frames
+ $xpaget ds9 frame active # returns the id of all active frames
$xpaget ds9 frame lock
$xpaget ds9 frame has amplifier
$xpaget ds9 frame has datamin
@@ -1343,15 +1210,13 @@ $xpaget ds9 gif > foo.gif
$xpaset -p ds9 gif foo.gif
$xpaset -p ds9 gif new foo.gif
- - $xpaset -p ds9 gif slice foo.gif
- $cat - foo.gif | xpaset ds9 gif # not available windows
+ $xpaset -p ds9 gif slice foo.gif
+ $cat foo.gif | xpaset ds9 gif # not available + windows
$cat foo.gif | xpaset ds9 gif new # not - available - windows
- $cat foo.gif | xpaset ds9 gif slice - # not available windows + available windows
+ $cat foo.gif | xpaset ds9 gif slice # + not available windowsControls coordinate grid. For grid numeric format syntax, click here.
@@ -1367,14 +1232,11 @@ [grid width <value>]
[grid dash yes|no]
[grid gap1 <value>]
- - [grid gap2 + [grid gap2 <value>]
- - [grid gap3 - <value>]
- [axes - yes|no]
+ [grid + gap3 <value>]
+ [axes yes|no]
[axes color <color>]
[axes width <value>]
[axes dash yes|no]
@@ -1394,22 +1256,17 @@ [numerics yes|no]
[numerics font times|helvetica|courier]
- [numerics fontsize - <value>]
- [numerics fontweight - normal|bold]
- [numerics fontslant - roman|italic]
+ [numerics fontsize <value>]
+ [numerics fontweight normal|bold]
+ [numerics fontslant roman|italic]
[numerics color <color>]
- [numerics gap1 - <value>]
- - [numerics gap2 <value>]
- - [numerics gap3 - <value>]
- - [numerics type interior|exterior]
+ [numerics gap1 <value>]
+ [numerics gap2 + <value>]
+ [numerics + gap3 <value>]
+ [numerics type + interior|exterior]
[numerics vertical yes|no]
[title yes|no]
[title text <text>]
@@ -1422,20 +1279,15 @@ [title fontslant roman|italic]
[title color <color>]
[labels yes|no]
- - [labels def1 yes|no]
+ [labels def1 yes|no]
[labels def2 yes|no]
- - [labels text1 <text>]
- - [labels text2 + [labels text1 <text>]
+ [labels text2 <text>]
- - [labels gap1 <value>]
- - [labels gap2 <value>]
- - [labels font + [labels gap1 + <value>]
+ [labels gap2 <value>]
+ [labels font times|helvetica|courier]
[labels fontsize <value>]
[labels fontweight normal|bold]
@@ -1457,10 +1309,8 @@ $xpaget ds9 grid grid width
$xpaget ds9 grid grid dash
$xpaget ds9 grid grid gap1
- $xpaget ds9 grid grid - gap2
- $xpaget ds9 grid grid - gap3
+ $xpaget ds9 grid grid gap2
+ $xpaget ds9 grid grid gap3
$xpaget ds9 grid axes
$xpaget ds9 grid axes color
$xpaget ds9 grid axes width
@@ -1484,10 +1334,8 @@ $xpaget ds9 grid numerics fontslant
$xpaget ds9 grid numerics color
$xpaget ds9 grid numerics gap1
- $xpaget ds9 grid - numerics gap2
- $xpaget ds9 grid numerics - gap3
+ $xpaget ds9 grid numerics gap2
+ $xpaget ds9 grid numerics gap3
$xpaget ds9 grid numerics type
$xpaget ds9 grid numerics vertical
$xpaget ds9 grid title
@@ -1523,8 +1371,7 @@ $xpaset -p ds9 grid grid dash yes
$xpaset -p ds9 grid grid gap1 10
$xpaset -p ds9 grid grid gap2 10
- $xpaset -p ds9 - grid grid gap3 10
+ $xpaset -p ds9 grid grid gap3 10
$xpaset -p ds9 grid axes yes
$xpaset -p ds9 grid axes color red
$xpaset -p ds9 grid axes width 2
@@ -1548,12 +1395,9 @@ $xpaset -p ds9 grid numerics fontslant italic
$xpaset -p ds9 grid numerics color red
$xpaset -p ds9 grid numerics gap1 10
- $xpaset -p - ds9 grid numerics gap2 10
- $xpaset -p ds9 - grid numerics gap3 10
- $xpaset -p ds9 grid numerics - type exterior
+ $xpaset -p ds9 grid numerics gap2 10
+ $xpaset -p ds9 grid numerics gap3 10
+ $xpaset -p ds9 grid numerics type exterior
$xpaset -p ds9 grid numerics vertical yes
$xpaset -p ds9 grid title yes
$xpaset -p ds9 grid title text {Hello World}
@@ -1584,8 +1428,7 @@Display current fits header dialog. Optional extension number - maybe specified. Please note, this differs from xpa fits - header.
+ maybe specified. Please note, this differs from xpa fits header. Syntax:
header [<ext>]
[close [<ext>]]
@@ -1619,17 +1462,13 @@ $xpaset -p ds9 iconify yes
Interactive examine function. A blinking cursor will indicate - to - the user to click on a point on an image. The specified - information - will be returned at that time. The default event is + to the user to click on a point on an image. The specified + information will be returned at that time. The default event is button. In the last form, the following macros will be expanded if present: $width, $height, $depth, $bitpix, $filename, $regions, $filename[$regions], $env, $pan, $value, - $x, - $y, $z. See Analysis - Macros - for more information.
Syntax:
+ $x, $y, $z. See Analysis + Macros for more information.
iexam []
@@ -1637,15 +1476,14 @@ <coordsys> [<skyframe>] [<skyformat>]
[[]|button|key|any] data [width][height]
- - [[]|button|key|any] <macro string>]
+ [[]|button|key|any] + <macro string>]
Example:
$xpaget ds9 iexam # image coordinates
- $xpaget ds9 - iexam coordinate image
- $xpaget ds9 iexam key coordinate - image # return coordinate and key event
+ $xpaget ds9 iexam coordinate image
+ $xpaget ds9 iexam key coordinate image # return coordinate + and key event
$xpaget ds9 iexam coordinate wcs fk5 degrees
$xpaget ds9 iexam coordinate wcs galactic sexagesimal
$xpaget ds9 iexam coordinate fk5
@@ -1665,8 +1503,8 @@ $xpaset -p ds9 iis filename foo.fits
$xpaset -p ds9 iis filename bar.fits 4
-Load JPEG image into current frame. Optional parameters: - jpeg quality (1-100)
+Load JPEG image into current frame. Optional parameters: jpeg + quality (1-100)
Syntax:
jpeg [new|slice] [<filename>] [1-100]
@@ -1675,43 +1513,34 @@ $xpaget ds9 jpeg 100 > foo.jpeg
$xpaset -p ds9 jpeg foo.jpeg
$xpaset -p ds9 jpeg new foo.jpeg
- - $xpaset -p ds9 jpeg slice foo.jpeg
- $cat - foo.jpeg | xpaset ds9 jpeg # not available - windows
- $cat foo.jpeg | xpaset ds9 jpeg new - # not available windows
- $cat - foo.jpeg | xpaset ds9 jpeg slice # - not - available windows + $xpaset -p ds9 jpeg slice foo.jpeg
+ $cat foo.jpeg | xpaset ds9 jpeg # + not available windows
+ $cat foo.jpeg | xpaset ds9 jpeg new # + not available windows
+ $cat foo.jpeg | xpaset ds9 jpeg slice # + not available windowsLock all other frames to the current frame.
Syntax:
lock [frame <coordsys>|none]
[crosshair <coordsys>|none]
- - [crop <coordsys>|none]
- [slice - <coordsys>|none]]
- [bin - [yes|no]]
+ [crop <coordsys>|none]
+ [slice <coordsys>|none]]
+ [bin [yes|no]]
[axes [yes|no]]
[scale [yes|no]]
[scalelimites [yes|no]]
[colorbar [yes|no]]
[block [yes|no]]
- - [smooth [yes|no]]
+ [smooth [yes|no]]
[3d [yes|no]]
Example:
$xpaget -p ds9 lock frame
$xpaget -p ds9 lock crosshair
- $xpaget -p ds9 lock - crop
+ $xpaget -p ds9 lock crop
$xpaget -p ds9 lock slice
$xpaget -p ds9 lock bin
$xpaget -p ds9 lock axes
@@ -1719,23 +1548,17 @@ $xpaget -p ds9 lock scalelimits
$xpaget -p ds9 lock colorbar
$xpaget -p ds9 lock block
- $xpaget -p ds9 lock - smooth
- $xpaget -p ds9 lock - 3d
+ $xpaget -p ds9 lock smooth
+ $xpaget -p ds9 lock 3d
$xpaset -p ds9 lock frame wcs
- - $xpaset -p ds9 lock crosshair wcs
- $xpaset -p ds9 - lock crop wcs
+ $xpaset -p ds9 lock crosshair wcs
+ $xpaset -p ds9 lock crop wcs
$xpaset -p ds9 lock slice wcs
$xpaset -p ds9 lock bin yes
$xpaset -p ds9 lock axes yes
- $xpaset -p ds9 lock scale - yes
+ $xpaset -p ds9 lock scale yes
$xpaset -p ds9 lock scalelimits yes
- $xpaset -p ds9 - lock colorbar yes
+ $xpaset -p ds9 lock colorbar yes
$xpaset -p ds9 lock block yes
$xpaset -p ds9 lock smooth yes
$xpaset -p ds9 lock 3d yes
@@ -1792,14 +1615,11 @@Match all other frames to the current frame.
Syntax:
- match [frame - <coordsys>]
+ match [frame <coordsys>]
[crosshair <coordsys>]
- - [crop <coordsys>]
- [slice - <coordsys>]
+ [crop <coordsys>]
+ [slice <coordsys>]
[bin]
[axes]
[scale]
@@ -1809,15 +1629,12 @@ [smooth]
[3d]
- - Example:
+ Example:
$xpaset -p ds9 match frame wcs
- $xpaset -p ds9 match - crosshair wcs
+ $xpaset -p ds9 match crosshair wcs
$xpaset -p ds9 match crop wcs
$xpaset -p ds9 match slice wcs
- $xpaset -p - ds9 match bin
+ $xpaset -p ds9 match bin
$xpaset -p ds9 match axes
$xpaset -p ds9 match scale
$xpaset -p ds9 match scalelimits
@@ -1836,14 +1653,13 @@ $xpaget ds9 mecube > foo.fits
$xpaset -p ds9 mecube foo.fits
$xpaset -p ds9 mecube new foo.fits
- $cat foo.fits | - xpaset ds9 mecube
+ $cat foo.fits | xpaset ds9 mecube
$cat foo.fits | xpaset ds9 mecube newThis is how DS9 determines the min and max data values - from the data. SCAN will scan all - data. DATAMIN and IRAFMIN will use the - values of the keywords if present.
Syntax:
+ from the data. SCAN will scan all data. DATAMIN + and IRAFMIN will use the values of the keywords if + present.
minmax [scan|sample|datamin|irafmin]
@@ -1877,14 +1693,11 @@ $xpaset -p ds9 mosaic foo.fits
$xpaset -p ds9 mosaic wcs foo.fits
$xpaset -p ds9 mosaic wcs new foo.fits
- $xpaset -p ds9 mosaic wcs mask - foo.fits
- $cat foo.fits | xpaset - ds9 mosaic
+ $xpaset -p ds9 mosaic wcs mask foo.fits
+ $cat foo.fits | xpaset ds9 mosaic
$cat foo.fits | xpaset ds9 mosaic wcs
$cat foo.fits | xpaset ds9 mosaic wcs new
- $cat - foo.fits | xpaset ds9 mosaic wcs mask
+ $cat foo.fits | xpaset ds9 mosaic wcs mask
Load FITS mosaic image into current frame.
@@ -1897,35 +1710,31 @@ $xpaset -p ds9 mosaicimage foo.fits
$xpaset -p ds9 mosaicimage wcs foo.fits
$xpaset -p ds9 mosaicimage wcs new foo.fits
- $xpaset -p ds9 mosaicimage wcs mask - foo.fits
- $cat foo.fits | xpaset - ds9 mosaicimage
+ $xpaset -p ds9 mosaicimage wcs mask foo.fits
+ $cat foo.fits | xpaset ds9 mosaicimage
$cat foo.fits | xpaset ds9 mosaicimage wcs
$cat foo.fits | xpaset ds9 mosaicimage wcs new
- - $cat foo.fits | xpaset ds9 mosaicimage wcs mask
+ $cat foo.fits | xpaset ds9 mosaicimage wcs mask
-Create mpeg1 movie from snap shots of the DS9 window. A - slice movie cycles though all slices of a cube. A - frame movie cycles through all active frames. A - 3d movie cycles through specified viewing angles. The - default is frame. Optional parameters for 3d: - number of frames, azimuth from/to, elevation from/to, slice - from/to, oscillate/repeat times.
+Create mpeg1 movie from snap shots of the DS9 window. A slice + movie cycles though all slices of a cube. A frame + movie cycles through all active frames. A 3d movie + cycles through specified viewing angles. The default is frame. + Optional parameters for 3d: number of frames, azimuth + from/to, elevation from/to, slice from/to, oscillate/repeat + times.
Syntax:
movie [slice|frame|3d] <filename>
- - movie 3d <filename> + movie 3d <filename> [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat <#>]
Example:
$xpaset -p ds9 movie slice ds9.mpg
- $xpaset -p ds9 - movie 3d ds9.mpg number 10 azfrom -60 azto 60 oscillate 1
+ $xpaset -p ds9 movie 3d ds9.mpg number 10 azfrom -60 + azto 60 oscillate 1
Load FITS multiple extension file as multiple images.
@@ -1934,20 +1743,16 @@
Example:
$xpaset -p ds9 multiframe foo.fits
- $cat - foo.fits | xpaset ds9 multiframe # not - available - windows
+ $cat foo.fits | xpaset ds9 multiframe # + not available windows
Support Name Server functions. Coordinates are in fk5.
Syntax:
nameserver [<object>]
- [name - <object>]
+ [name <object>]
- [server - ned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds]
+ [server ned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds]
[skyformat degrees|sexagesimal]
@@ -1992,10 +1797,8 @@ $xpaget ds9 nrrd
$xpaget ds9 nrrd big
$xpaset -p ds9 nrrd foo.nrrd
- $xpaset -p ds9 nrrd new - foo.nrrd
- $xpaset -p ds9 nrrd mask - foo.nrrd
+ $xpaset -p ds9 nrrd new foo.nrrd
+ $xpaset -p ds9 nrrd mask foo.nrrd
$cat foo.nrrd | xpaset ds9 nrrd
$cat foo.nrrd | xpaset ds9 nrrd new
@@ -2022,19 +1825,15 @@ $xpaget ds9 nvss frame
$xpaset -p ds9 nvss
$xpaset -p ds9 nvss m31
- $xpaset -p ds9 nvss name - m31
- $xpaset -p ds9 nvss name - clear
- $xpaset -p ds9 nvss 00:42:44.404 - +41:16:08.78
+ $xpaset -p ds9 nvss name m31
+ $xpaset -p ds9 nvss name clear
+ $xpaset -p ds9 nvss 00:42:44.404 +41:16:08.78
$xpaset -p ds9 nvss size 60 60 arcmin
$xpaset -p ds9 nvss save yes
$xpaset -p ds9 nvss frame current
$xpaset -p ds9 nvss update frame
$xpaset -p ds9 nvss open
- $xpaset -p ds9 nvss - close
+ $xpaset -p ds9 nvss close
Controls the orientation of the current frame.
Syntax:
@@ -2072,8 +1871,8 @@ pan [<coordsys> [<skyframe>] [<skyformat>]] # get current coords
- pan [<x> <y> <coordsys> - [<skyframe>]] # relative
+ pan [<x> <y> <coordsys> [<skyframe>]] # + relative
[to <x> <y> <coordsys> [<skyframe>]] # absolute
[open|close]
@@ -2106,10 +1905,8 @@Display and configure data plots. All plot commands take an optional second command, the plot name. If no plot name is specified, the last plot created is assumed. Plot data is - assumed - to be a pair of coordinates, with optional error values. The - follow - are valid data descriptions:
+ assumed to be a pair of coordinates, with optional error values. + The follow are valid data descriptions:xy x and y coordinates
xyex x,y coordinates with x errors
xyey x,y coordinates with y errors
@@ -2118,425 +1915,263 @@To create a new plot, use the plot new command.
Syntax:
- # create new empty plot - window
+ # create new empty plot window
plot []
- - [line|bar|scatter]
- - [new]
- - [new - line|bar|scatter]
- - [new name <plotname>]
- - [new name <plotname> + [line|bar|scatter]
+ [new]
+ [new line|bar|scatter]
+ [new name <plotname>]
+ [new name <plotname> line|bar|scatter]
- # create new - plot with data from stdin
- plot [new - <title> <xaxis label> <yaxis label> - xy|xyex|xyey|xyexey]
- - [new [line|bar|scatter] - <title> <xaxis label> <yaxis label> - xy|xyex|xyey|xyexey]
- - [new name + # create new plot with data from stdin
+ plot [new <title> <xaxis label> + <yaxis label> xy|xyex|xyey|xyexey]
+ [new + [line|bar|scatter] <title> <xaxis label> <yaxis + label> xy|xyex|xyey|xyexey]
+ [new name <plotname> <title> <xaxis label> - <yaxis label> - xy|xyex|xyey|xyexey]
- - [new name + <yaxis label> xy|xyex|xyey|xyexey]
+ [new name <plotname> line|bar|scatter <title> - <xaxis - label> <yaxis label> - xy|xyex|xyey|xyexey]
+ <xaxis label> <yaxis label> xy|xyex|xyey|xyexey]
- - # create new plot with data from stdin which includes - title/dim - headers
- plot [new - stdin]
- - [new [line|bar|scatter] - stdin]
- - [new name <plotname> - stdin]
- - [new name <plotname> line|bar|scatter + # create new plot with data from stdin which includes + title/dim headers
+ plot [new stdin]
+ [new [line|bar|scatter] stdin]
+ [new name + <plotname> stdin]
+ [new name + <plotname> line|bar|scatter stdin]
- # - load data into existing plot from stdin
- - plot [[<plotname>] data - xy|xyex|xyey|xyexey]
+ # load data into existing plot from stdin
+ plot [[<plotname>] data xy|xyex|xyey|xyexey]
- # existing - plot
+ # existing plot
plot [[<plotname>] load <filename> xy|xyex|xyey|xyexey]
- - [[<plotname>] save - <filename>]
- - [[<plotname>] clear]
- - [[<plotname>] - duplicate - [#]]
- - [[<plotname>] stats yes|no]
- - [[<plotname>] list - yes|no]
- - [[<plotname>] loadconfig + [[<plotname>] save <filename>]
- - [[<plotname>] saveconfig <filename>]
- - [[<plotname>] pagesetup orient - portrait|landscape]
- - [[<plotname>] pagesetup size - letter|legal|tabloid|poster|a4]
- - [[<plotname>] - print]
- - [[<plotname>] print destination - printer|file]
- - [[<plotname>] print command - <command>]
- - [[<plotname>] print filename + [[<plotname>] clear]
+ [[<plotname>] + duplicate [#]]
+ [[<plotname>] + stats yes|no]
+ [[<plotname>] + list yes|no]
+ [[<plotname>] + loadconfig <filename>]
+ [[<plotname>] saveconfig <filename>]
- - [[<plotname>] print color rgb|gray]
- - [[<plotname>] + [[<plotname>] pagesetup + orient portrait|landscape]
+ [[<plotname>] pagesetup + size letter|legal|tabloid|poster|a4]
+ [[<plotname>] print]
+ [[<plotname>] print + destination printer|file]
+ [[<plotname>] print + command <command>]
+ [[<plotname>] print + filename <filename>]
+ [[<plotname>] print + color rgb|gray]
+ [[<plotname>] close]
- - [[<plotname>] mode pointer|zoom]
- -
+ [[<plotname>] + mode pointer|zoom]
+
# configure graph
- plot - [[<plotname>] axis x|y grid yes|no]
- - [[<plotname>] axis x|y log + plot [[<plotname>] axis x|y grid yes|no]
+ [[<plotname>] axis x|y + log yes|no]
+ [[<plotname>] axis x|y + flip yes|no]
+ [[<plotname>] axis x|y auto yes|no]
- - [[<plotname>] axis x|y flip yes|no]
- - [[<plotname>] axis x|y auto - yes|no]
- - [[<plotname>] axis x|y min <value>]
- - [[<plotname>] axis x|y max + [[<plotname>] axis x|y min <value>]
- - [[<plotname>] axis x|y format + [[<plotname>] axis x|y max + <value>]
+ [[<plotname>] axis x|y format <string>]
- - [[<plotname>] legend yes|no]
- - [[<plotname>] legend position - right|left|top|bottom]
- - [[<plotname>] font title|labels|numbers font - times|helvetica|courier]
- - [[<plotname>] font title|labels|numbers + [[<plotname>] + legend yes|no]
+ [[<plotname>] legend + position right|left|top|bottom]
+ [[<plotname>] font + title|labels|numbers font times|helvetica|courier]
+ [[<plotname>] font title|labels|numbers size <value>]
- - [[<plotname>] font title|labels|numbers + [[<plotname>] font title|labels|numbers weight normal|bold]
- - [[<plotname>] font title|labels|numbers + [[<plotname>] font title|labels|numbers slant roman|italic]
- - [[<plotname>] title <string>]
- - [[<plotname>] title x|y + [[<plotname>] title + <string>]
+ [[<plotname>] title x|y <string>]
- - [[<plotname>] barmode - normal|stacked|aligned|overlap]
+ [[<plotname>] + barmode normal|stacked|aligned|overlap]
- - # configure current dataset
- plot - [[<plotname>] show yes|no]
- - [[<plotname>] shape + # configure current dataset
+ plot [[<plotname>] show yes|no]
+ [[<plotname>] shape circle|square|diamond|plus|splus|scross|triangle|arrow]
[[<plotname>] shape fill yes|no]
- - [[<plotname>] shape - color <value>]
- - [[<plotname>] smooth - step|linear|cubic|quadratic|catrom]
- - [[<plotname>] color - <value>]
- - [[<plotname>] width <value>]
- - [[<plotname>] dash - yes|no]
- - [[<plotname>] error yes|no]
- - [[<plotname>] error + [[<plotname>] + shape color <value>]
+ [[<plotname>] + smooth step|linear|cubic|quadratic|catrom]
+ [[<plotname>] color <value>]
- - [[<plotname>] color <value>]
- - [[<plotname>] error + [[<plotname>] width <value>]
- - [[<plotname>] name - <string>]
+ [[<plotname>] + dash yes|no]
+ [[<plotname>] + error yes|no]
+ [[<plotname>] + error color <value>]
+ [[<plotname>] color + <value>]
+ [[<plotname>] + error width <value>]
+ [[<plotname>] + name <string>]
- # select - current dataset
- plot [[<plotname>] - select <value>]
- -
+ # select current dataset
+ plot [[<plotname>] select <value>]
+
Example:
- # - return all plotnames
- $xpaget ds9 - plot
+ # return all plotnames
+ $xpaget ds9 plot
- # create new empty plot - window
+ # create new empty plot window
$xpaset -p ds9 plot
- - $xpaset -p ds9 plot bar
- $xpaset -p ds9 - plot new
- $xpaset -p ds9 plot new - bar
- $xpaset -p ds9 plot new name - foo
- $xpaset -p ds9 plot new name foo - bar
+ $xpaset -p ds9 plot bar
+ $xpaset -p ds9 plot new
+ $xpaset -p ds9 plot new bar
+ $xpaset -p ds9 plot new name foo
+ $xpaset -p ds9 plot new name foo bar
- # create new plot with data - from stdin
- $cat xy.dat | xpaset ds9 plot new - {The Title} {X Axis} {Y Axis} xy
- $cat xy.dat - | xpaset ds9 plot new bar {The Title} {X Axis} {Y Axis} - xy
- $cat xy.dat | xpaset ds9 plot new name foo - {The Title} {X Axis} {Y Axis} xy
- $cat xy.dat - | xpaset ds9 plot new name foo bar {The Title} {X Axis} {Y Axis} - xy
+ # create new plot with data from stdin
+ $cat xy.dat | xpaset ds9 plot new {The Title} {X Axis} + {Y Axis} xy
+ $cat xy.dat | xpaset ds9 plot new bar {The Title} {X + Axis} {Y Axis} xy
+ $cat xy.dat | xpaset ds9 plot new name foo {The Title} + {X Axis} {Y Axis} xy
+ $cat xy.dat | xpaset ds9 plot new name foo bar {The + Title} {X Axis} {Y Axis} xy
- # create new plot with data - from stdin which includes title/dim headers
- - $cat stdin.2.dat | xpaset ds9 plot new stdin
- - $cat stdin.2.dat | xpaset ds9 plot new line + # create new plot with data from stdin which includes + title/dim headers
+ $cat stdin.2.dat | xpaset ds9 plot new stdin
+ $cat stdin.2.dat | xpaset ds9 plot new line stdin
+ $cat stdin.2.dat | xpaset ds9 plot new name foo stdin
+ $cat stdin.2.dat | xpaset ds9 plot new name foo line stdin
- $cat stdin.2.dat | xpaset ds9 plot new - name foo stdin
- $cat stdin.2.dat | xpaset ds9 - plot new name foo line stdin
- - # load data into existing plot from - stdin
- $cat xy.dat | xpaset ds9 plot data - xy
- $cat xy.dat | xpaset ds9 plot foo data - xy
+ # load data into existing plot from stdin
+ $cat xy.dat | xpaset ds9 plot data xy
+ $cat xy.dat | xpaset ds9 plot foo data xy
- # existing - plot
+ # existing plot
$xpaget ds9 plot stats
- - $xpaget ds9 plot list
- $xpaset -p ds9 plot - load xy.dat xy
- $xpaset -p ds9 plot save - foo.dat
- $xpaset -p ds9 plot - clear
- $xpaset -p ds9 plot duplicate - 1
- $xpaset -p ds9 plot stats - yes
- $xpaset -p ds9 plot list - yes
- $xpaset -p ds9 plot loadconfig - foo.plt
- $xpaset -p ds9 plot saveconfig - foo.plt
- $xpaset -p ds9 plot pagesetup orient - portrait
- $xpaset -p ds9 plot pagesetup size - letter
- $xpaset -p ds9 plot - print
- $xpaset -p ds9 plot print destination - file
- $xpaset -p ds9 plot print command - lp
- $xpaset -p ds9 plot print filename - foo.ps
- $xpaset -p ds9 plot print color - rgb
- $xpaset -p ds9 plot - close
+ $xpaget ds9 plot list
+ $xpaset -p ds9 plot load xy.dat xy
+ $xpaset -p ds9 plot save foo.dat
+ $xpaset -p ds9 plot clear
+ $xpaset -p ds9 plot duplicate 1
+ $xpaset -p ds9 plot stats yes
+ $xpaset -p ds9 plot list yes
+ $xpaset -p ds9 plot loadconfig foo.plt
+ $xpaset -p ds9 plot saveconfig foo.plt
+ $xpaset -p ds9 plot pagesetup orient portrait
+ $xpaset -p ds9 plot pagesetup size letter
+ $xpaset -p ds9 plot print
+ $xpaset -p ds9 plot print destination file
+ $xpaset -p ds9 plot print command lp
+ $xpaset -p ds9 plot print filename foo.ps
+ $xpaset -p ds9 plot print color rgb
+ $xpaset -p ds9 plot close
$xpaget ds9 plot mode
- - $xpaset -p ds9 plot mode pointer
+ $xpaset -p ds9 plot mode pointer
# configure plot
- $xpaget ds9 plot - axis x grid
- $xpaget ds9 plot axis x - log
- $xpaget ds9 plot axis x - flip
- $xpaget ds9 plot axis x - auto
- $xpaget ds9 plot axis x - min
- $xpaget ds9 plot axis x - max
- $xpaget ds9 plot axis x - format
- $xpaset -p ds9 plot axis x grid - yes
- $xpaset -p ds9 plot axis x log - yes
- $xpaset -p ds9 plot axis x flip - yes
- $xpaset -p ds9 plot axis x auto - no
- $xpaset -p ds9 plot axis x min - 1
- $xpaset -p ds9 plot axis x max - 100
- $xpaset -p ds9 plot axis x format - {%f}
+ $xpaget ds9 plot axis x grid
+ $xpaget ds9 plot axis x log
+ $xpaget ds9 plot axis x flip
+ $xpaget ds9 plot axis x auto
+ $xpaget ds9 plot axis x min
+ $xpaget ds9 plot axis x max
+ $xpaget ds9 plot axis x format
+ $xpaset -p ds9 plot axis x grid yes
+ $xpaset -p ds9 plot axis x log yes
+ $xpaset -p ds9 plot axis x flip yes
+ $xpaset -p ds9 plot axis x auto no
+ $xpaset -p ds9 plot axis x min 1
+ $xpaset -p ds9 plot axis x max 100
+ $xpaset -p ds9 plot axis x format {%f}
- $xpaget ds9 plot - legend
- $xpaget ds9 plot legend - position
- $xpaset -p ds9 plot legend - yes
- $xpaset -p ds9 plot legend position - left
+ $xpaget ds9 plot legend
+ $xpaget ds9 plot legend position
+ $xpaset -p ds9 plot legend yes
+ $xpaset -p ds9 plot legend position left
- $xpaget ds9 plot font - numbers font
- $xpaget ds9 plot font numbers - size
- $xpaget ds9 plot font numbers - weight
- $xpaget ds9 plot font numbers - slant
- $xpaset -p ds9 plot font numbers font - times
- $xpaset -p ds9 plot font numbers size - 12
- $xpaset -p ds9 plot font numbers weight - bold
- $xpaset -p ds9 plot font numbers slant - italic
+ $xpaget ds9 plot font numbers font
+ $xpaget ds9 plot font numbers size
+ $xpaget ds9 plot font numbers weight
+ $xpaget ds9 plot font numbers slant
+ $xpaset -p ds9 plot font numbers font times
+ $xpaset -p ds9 plot font numbers size 12
+ $xpaset -p ds9 plot font numbers weight bold
+ $xpaset -p ds9 plot font numbers slant italic
- $xpaget ds9 plot - title
- $xpaget ds9 plot title - xaxis
- $xpaget ds9 plot title - yaxis
- $xpaset -p ds9 plot title {This is a - Title}
- $xpaset -p ds9 plot title x {X - Axis}
- $xpaset -p ds9 plot title y {Y - Axis}
- $xpaset -p ds9 plot title legend {This - is the Legend}
+ $xpaget ds9 plot title
+ $xpaget ds9 plot title xaxis
+ $xpaget ds9 plot title yaxis
+ $xpaset -p ds9 plot title {This is a Title}
+ $xpaset -p ds9 plot title x {X Axis}
+ $xpaset -p ds9 plot title y {Y Axis}
+ $xpaset -p ds9 plot title legend {This is the Legend}
- $xpaget ds9 plot - barmode
- $xpaset -p ds9 plot barmode - aligned
+ $xpaget ds9 plot barmode
+ $xpaset -p ds9 plot barmode aligned
- # configure current - dataset
- $xpaget ds9 plot - show
+ # configure current dataset
+ $xpaget ds9 plot show
$xpaget ds9 plot shape
- - $xpaget ds9 plot shape fill
- $xpaget ds9 - plot shape color
- $xpaget ds9 plot - smooth
- $xpaget ds9 plot - color
- $xpaget ds9 plot - width
+ $xpaget ds9 plot shape fill
+ $xpaget ds9 plot shape color
+ $xpaget ds9 plot smooth
+ $xpaget ds9 plot color
+ $xpaget ds9 plot width
$xpaget ds9 plot dash
- - $xpaget ds9 plot error
- $xpaget ds9 plot - error color
- $xpaget ds9 plot error - width
+ $xpaget ds9 plot error
+ $xpaget ds9 plot error color
+ $xpaget ds9 plot error width
$xpaget ds9 plot name
- - $xpaset -p ds9 plot show yes
- $xpaset -p - ds9 plot shape circle
- $xpaset -p ds9 plot - shape fill no
- $xpaset -p ds9 plot shape color - cyan
- $xpaset -p ds9 plot smooth - step
- $xpaset -p ds9 plot color - red
- $xpaset -p ds9 plot width - 2
- $xpaset -p ds9 plot dash - yes
- $xpaset -p ds9 plot error - yes
- $xpaset -p ds9 plot error color - red
- $xpaset -p ds9 plot error width - 2
- $xpaset -p ds9 plot name {My - Data}
+ $xpaset -p ds9 plot show yes
+ $xpaset -p ds9 plot shape circle
+ $xpaset -p ds9 plot shape fill no
+ $xpaset -p ds9 plot shape color cyan
+ $xpaset -p ds9 plot smooth step
+ $xpaset -p ds9 plot color red
+ $xpaset -p ds9 plot width 2
+ $xpaset -p ds9 plot dash yes
+ $xpaset -p ds9 plot error yes
+ $xpaset -p ds9 plot error color red
+ $xpaset -p ds9 plot error width 2
+ $xpaset -p ds9 plot name {My Data}
- # select current - dataset
- $xpaget ds9 plot - select
+ # select current dataset
+ $xpaget ds9 plot select
$xpaset -p ds9 plot select 2
Load PNG image into current frame.
@@ -2548,25 +2183,20 @@ $xpaget ds9 png > foo.png
$xpaset -p ds9 png foo.png
$xpaset -p ds9 png new foo.png
- - $xpaset -p ds9 png slice foo.png
- $cat - foo.png | xpaset ds9 png # not available - windows
- $cat foo.png | xpaset ds9 png new - # not available windows
- $cat - foo.png | xpaset ds9 png slice # not - available windows
+ $xpaset -p ds9 png slice foo.png
+ $cat foo.png | xpaset ds9 png # + not available windows
+ $cat foo.png | xpaset ds9 png new # + not available windows
+ $cat foo.png | xpaset ds9 png slice # + not available windows
Set region and coordinate output format precision.
Syntax:
precision <linear> <degree> - <hms> - <dms> - <arcmin> - <arcsec>
+ <hms> <dms> + <arcmin> <arcsec>
Example:
$xpaget ds9 precision
@@ -2605,9 +2235,9 @@ [command <command>]
[filename <filename>]
[color rgb|cmyk|gray]
- [level 1|2]
+ [level 1|2|3]
[resolution - 53|72|75|150|300|600]
+ 72|screen|96|144|150|225|300|600|1200]
Example:
$xpaget ds9 print destination
@@ -2622,7 +2252,7 @@ $xpaset -p ds9 print filename foo.ps
$xpaset -p ds9 print color cmyk
$xpaset -p ds9 print level 2
- $xpaset -p ds9 print resolution 75 + $xpaset -p ds9 print resolution 96Raise in the window stacking order.
Syntax:
@@ -2664,12 +2294,10 @@ [skyformat degrees|sexagesimal]
[strip yes|no]
- [shape - <shape>]
+ [shape <shape>]
[color <color>]
- [width - <width>]
+ [width <width>]
[fixed|edit|rotate|delete yes|no]
@@ -2681,23 +2309,20 @@ [template <filename>]
[template <filename> - at - <ra> <dec> <coordsys> <skyframe>]
+ at <ra> <dec> <coordsys> <skyframe>]
[savetemplate <filename>]
[groups]
[group new]
[group <tag> new]
- [group <tag> - update]
+ [group <tag> update]
[group <tag> select]
[group <tag> color <color>]
[group <tag> copy]
- [group <tag> - delete]
+ [group <tag> delete]
[group <tag> cut]
[group <tag> font <font>]
@@ -2708,8 +2333,7 @@ [group <tag> moveback]
[group <tag> - property - <property> yes|no]
+ property <property> yes|no]
[copy]
[cut]
[paste @@ -2723,8 +2347,7 @@ fk4|fk5|icrs|galactic|ecliptic]
[-skyformat degrees|sexagesimal]
- [-delim - [nl|<char>]]
+ [-delim [nl|<char>]]
[-prop select|edit|move|rotate|delete|fixed|include|source 1|0]
[-group <tag>]
@@ -2774,8 +2397,7 @@ $xpaset -p ds9 regions -format ciao bar.reg # load as ciao format
$xpaset -p ds9 regions foo.fits # FITS regions files do not need - a - format specification
+ a format specification
$xpaset -p ds9 regions load foo.reg # load foo.reg into current frame
$xpaset -p ds9 regions load all foo.reg # load foo.reg into all @@ -2812,19 +2434,16 @@ $xpaset -p ds9 regions width 3
$xpaset -p ds9 regions edit yes
$xpaset -p ds9 regions include
- $xpaset -p ds9 regions command '{circle 100 100 20 # - color=red}'
+ $xpaset -p ds9 regions command '{circle 100 100 20 # color=red}'
$xpaset -p ds9 regions composite
$xpaset -p ds9 regions dissolve
$xpaset -p ds9 regions template foo.tpl
$xpaset -p ds9 regions template foo.tpl at 13:29:55.92 - +47:12:48.02 - fk5
+ +47:12:48.02 fk5
$xpaset -p ds9 regions savetemplate foo.tpl
$xpaset -p ds9 regions group new
$xpaset -p ds9 regions group foo new
- $xpaset -p ds9 - regions group foo update
+ $xpaset -p ds9 regions group foo update
$xpaset -p ds9 regions group foo select
$xpaset -p ds9 regions group foo color red
$xpaset -p ds9 regions group foo copy
@@ -2863,8 +2482,7 @@
Example:
$xpaget ds9 rgb channel
- $xpaget ds9 rgb lock - wcs
+ $xpaget ds9 rgb lock wcs
$xpaget ds9 rgb lock crop
$xpaget ds9 rgb lock slice
$xpaget ds9 rgb lock bin
@@ -2882,8 +2500,7 @@ $xpaset -p ds9 rgb channel red # set current channel to red
$xpaset -p ds9 rgb view blue no # turn off blue channel
$xpaset -p ds9 rgb system wcs # set rgb coordinate system
- - $xpaset -p ds9 rgb lock wcs yes
+ $xpaset -p ds9 rgb lock wcs yes
$xpaset -p ds9 rgb lock crop yes
$xpaset -p ds9 rgb lock slice yes
$xpaset -p ds9 rgb lock bin yes
@@ -2907,8 +2524,7 @@ $xpaget ds9 rgbarray little > foo.arr
$xpaset -p ds9 rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]
- $xpaset -p ds9 rgbarray new - foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]
+ $xpaset -p ds9 rgbarray new foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]
$cat foo.arr | xpaset ds9 rgbarray [dim=512,zdim=3,bitpix=-32,endian=little]
$cat foo.arr | xpaset ds9 rgbarray new @@ -2923,8 +2539,7 @@ $xpaget ds9 rgbcube > foo.fits
$xpaset -p ds9 rgbcube foo.fits
$xpaset -p ds9 rgbcube new foo.fits
- $cat foo.fits - | xpaset ds9 rgbcube
+ $cat foo.fits | xpaset ds9 rgbcube
$cat foo.fits | xpaset ds9 rgbcube new
Load FITS rgbimage into rgb frame.
-
@@ -2936,13 +2551,11 @@ $xpaget ds9 rgbimage > foo.fits
$xpaset -p ds9 rgbimage foo.fits
$xpaset -p ds9 rgbimage new foo.fits
- $cat foo.fits - | xpaset ds9 rgbimage
+ $cat foo.fits | xpaset ds9 rgbimage
$cat foo.fits | xpaset ds9 rgbimage new
Controls the rotation angle (in degrees) of the current - frame.
+Controls the rotation angle (in degrees) of the current frame.
Syntax:
rotate [<value>]
[to <value>]
@@ -2968,8 +2581,7 @@ $xpaset -p ds9 save fits foo.fits table
$xpaset -p ds9 save fits foo.fits slice
$xpaset -p ds9 save rgbimage foo.fits
- $xpaset -p - ds9 save rgbcube foo.fits
+ $xpaset -p ds9 save rgbcube foo.fits
$xpaset -p ds9 save mecube foo.fits
$xpaset -p ds9 save mosaic foo.fits
$xpaset -p ds9 save mosaicimage foo.fits
@@ -2981,8 +2593,7 @@ parameters: jpeg quality (1-100) and tiff compression method. Syntax:
- saveimage [fits|eps|gif|tiff|jpeg|png] - <filename>
+ saveimage [fits|eps|gif|tiff|jpeg|png] <filename>
saveimage <filename>.jpeg [1-100]
saveimage <filename>.tiff [none|jpeg|packbits|deflate]
@@ -3072,67 +2683,49 @@Support for VO Simple Image Access protocol. The first command will create a new search. All other commands operated on the - last - search created, unless indicated otherwise.
+ last search created, unless indicated otherwise. Syntax:
- sia - [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr]
+ sia [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr]
- [<ref>] - [cancel]
- [<ref>] - [clear]
- [<ref>] - [close]
+ [<ref>] [cancel]
+ [<ref>] [clear]
+ [<ref>] [close]
[<ref>] [coordinate <ra> <dec> <coordsys>]
- - [<ref>] [crosshair]
+ [<ref>] [crosshair]
[<ref>] [export sb|tsv <filename>]
- [<ref>] - [name <object>]
- [<ref>] - [print]
+ [<ref>] [name <object>]
+ [<ref>] [print]
[<ref>] [retrieve]
- [<ref>] [save - <filename>]
+ [<ref>] [save <filename>]
[<ref>] [radius <value> degrees|arcmin|arcsec]
- [<ref>] [sky - <skyframe>]
- [<ref>] - [skyformat <skyformat>]
- - [<ref>] [system <coordsys>]
- - [<ref>] [update]
+ [<ref>] [sky <skyframe>]
+ [<ref>] [skyformat + <skyformat>]
+ [<ref>] [system + <coordsys>]
+ [<ref>] [update]
Example:
$xpaget ds9 sia
$xpaset -p ds9 sia 2mass
- $xpaset -p ds9 sia - cancel
+ $xpaset -p ds9 sia cancel
$xpaset -p ds9 sia clear
- $xpaset - -p ds9 sia close
- $xpaset -p ds9 sia coordinate 202.48 - 47.21 fk5
+ $xpaset -p ds9 sia close
+ $xpaset -p ds9 sia coordinate 202.48 47.21 fk5
$xpaset -p ds9 sia crosshair
- - $xpaset -p ds9 sia export tsv bar.tsv
- $xpaset -p - ds9 sia name m51
+ $xpaset -p ds9 sia export tsv bar.tsv
+ $xpaset -p ds9 sia name m51
$xpaset -p ds9 sia print
$xpaset -p ds9 sia retrieve
$xpaset -p ds9 sia save foo.xml
- $xpaset -p ds9 sia - radius 1 degrees
+ $xpaset -p ds9 sia radius 1 degrees
$xpaset -p ds9 sia sky fk5
$xpaset -p ds9 sia skyformat degrees
- $xpaset -p ds9 - sia system wcs
+ $xpaset -p ds9 sia system wcs
$xpaset -p ds9 sia update
single @@ -3152,8 +2745,7 @@ [name <object>|clear]
[<ra> - <dec>] - # in wcs fk5
+ <dec>] # in wcs fk5
[size <width> <height> degrees|arcmin|arcsec]
[pixels <width> @@ -3175,12 +2767,9 @@ $xpaget ds9 skyview survey
$xpaset -p ds9 skyview
$xpaset -p ds9 skyview m31
- $xpaset -p ds9 skyview - name m31
- $xpaset -p ds9 skyview name - clear
- $xpaset -p ds9 skyview 00:42:44.404 - +41:16:08.78
+ $xpaset -p ds9 skyview name m31
+ $xpaset -p ds9 skyview name clear
+ $xpaset -p ds9 skyview 00:42:44.404 +41:16:08.78
$xpaset -p ds9 skyview size 60 60 arcmin
$xpaset -p ds9 skyview pixels 600 600
$xpaset -p ds9 skyview save yes
@@ -3188,8 +2777,7 @@ $xpaset -p ds9 skyview update frame
$xpaset -p ds9 skyview survey sdssi
$xpaset -p ds9 skyview open
- $xpaset -p ds9 skyview - close
+ $xpaset -p ds9 skyview close
Delays execution for specified number of seconds. Default is 1 second.
@@ -3215,60 +2802,47 @@ [yes|no]
@@ -3206,8 +2794,7 @@ Boxcar width = 2*radius+1
Tophat diameter = 2*radius+1
Gaussian diameter = 2*radius+1, mean =0
- Elliptical Gaussian diameter = 2*radius+1, mean - =0
+ Elliptical Gaussian diameter = 2*radius+1, mean =0
Syntax:
[function boxcar|tophat|gaussian]
- - [radius + [radius <value>]
- - [radiusminor - <value>]
- - - [sigma - <value>]
- - + + [radiusminor <value>]
+ + + [sigma <value>]
+ + [sigmaminor <value>]
- - + [angle + <value>]
- - [match]
+ + [match]
[lock [yes|no]]
[open|close]
Example:
$xpaget ds9 smooth
$xpaget ds9 smooth function
- $xpaget ds9 smooth - radius
- $xpaget ds9 smooth - radiusminor
- $xpaget ds9 - smooth sigma
- - $xpaget ds9 smooth - sigmaminor
+ $xpaget ds9 smooth radius
+ $xpaget ds9 smooth radiusminor
+ $xpaget ds9 smooth sigma
+ $xpaget + ds9 smooth sigmaminor
$xpaget - ds9 - smooth lock
+ ds9 smooth lock
$xpaset -p ds9 smooth
$xpaset -p ds9 smooth yes
$xpaset -p ds9 smooth function tophat
- $xpaset -p - ds9 smooth radius 4
- $xpaset - -p ds9 smooth radiusminor 4
- - $xpaset -p ds9 smooth sigma - 2.0
- - $xpaset -p ds9 smooth - sigmaminor 2.0
- - $xpaset -p ds9 - smooth angle - 45
+ $xpaset -p ds9 smooth radius 4
+ $xpaset -p ds9 smooth + radiusminor 4
+ $xpaset + -p ds9 smooth sigma 2.0
+ $xpaset + -p ds9 smooth sigmaminor 2.0
+ $xpaset + -p ds9 smooth angle 45
$xpaset -p ds9 smooth match
$xpaset -p ds9 smooth lock yes
@@ -3304,28 +2878,23 @@ $xpaget ds9 threads
$xpaset -p ds9 threads 8
-Load TIFF image into current frame. Optional parameters: - tiff compression method.
+Load TIFF image into current frame. Optional parameters: tiff + compression method.
Syntax:
- tiff [new|slice] [<filename>] - [none|jpeg|packbits|deflate]
+ tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate]
Example:
$xpaget ds9 tiff > foo.tiff
$xpaget ds9 tiff jpeg > foo.tiff
$xpaset -p ds9 tiff foo.tiff
$xpaset -p ds9 tiff new foo.tiff
- - $xpaset -p ds9 tiff slice foo.tiff
- $cat - foo.tiff | xpaset ds9 tiff # not available - windows
- $cat foo.tiff | xpaset ds9 tiff new - # not available windows
- $cat - foo.tiff | xpaset ds9 tiff slice # - not - available windows + $xpaset -p ds9 tiff slice foo.tiff
+ $cat foo.tiff | xpaset ds9 tiff # + not available windows
+ $cat foo.tiff | xpaset ds9 tiff new # + not available windows
+ $cat foo.tiff | xpaset ds9 tiff slice # + not available windowsControls the tile display mode.
Syntax:
@@ -3362,9 +2931,8 @@ form, the first argument is the number of the fits HDU (starting with 1) and the remaining args are a bounding box in IMAGE coordinates. By default, the screen is updated the next - available - idle cycle. However, you may force an immediate update by - specifying the NOW option. + available idle cycle. However, you may force an immediate update + by specifying the NOW option. Syntax:
update []
[# x1 y1 x2 y2]
@@ -3413,8 +2981,7 @@ [units yes|no]
[image|physical|wcs|wcsa...wcsz yes|no]
- [frame - yes|no]
+ [frame yes|no]
[red yes|no]
[green yes|no]
[blue yes|no]
@@ -3437,8 +3004,7 @@ $xpaget ds9 view image
$xpaget ds9 view wcsa
$xpaget ds9 view red
- $xpaget ds9 view - frame
+ $xpaget ds9 view frame
$xpaset -p ds9 view layout vertical
$xpaset -p ds9 view keyvalue BITPIX
$xpaset -p ds9 view info yes
@@ -3454,8 +3020,7 @@ $xpaset -p ds9 view lowhigh yes
$xpaset -p ds9 view units yes
$xpaset -p ds9 view wcsa yes
- $xpaset -p ds9 view - frame yes
+ $xpaset -p ds9 view frame yes
$xpaset -p ds9 view red yes
$xpaset -p ds9 view green yes
$xpaset -p ds9 view blue yes
@@ -3469,8 +3034,7 @@ [<ra> <dec>] # in wcs fk5
[size <width> - <height> - degrees|arcmin|arcsec]
+ <height> degrees|arcmin|arcsec]
[save yes|no]
[frame new|current]
[update frame|crosshair]
@@ -3486,20 +3050,16 @@ $xpaget ds9 vla survey
$xpaset -p ds9 vla
$xpaset -p ds9 vla m31
- $xpaset -p ds9 vla name - m31
- $xpaset -p ds9 vla name - clear
- $xpaset -p ds9 vla 00:42:44.404 - +41:16:08.78
+ $xpaset -p ds9 vla name m31
+ $xpaset -p ds9 vla name clear
+ $xpaset -p ds9 vla 00:42:44.404 +41:16:08.78
$xpaset -p ds9 vla size 60 60 arcmin
$xpaset -p ds9 vla save yes
$xpaset -p ds9 vla frame current
$xpaset -p ds9 vla update frame
$xpaset -p ds9 vla survey stripe82
$xpaset -p ds9 vla open
- $xpaset -p ds9 vla - close
+ $xpaset -p ds9 vla close
Support for NRAO VLSS Sky Survey.
@@ -3523,19 +3083,15 @@ $xpaget ds9 vlss frame
$xpaset -p ds9 vlss
$xpaset -p ds9 vlss m31
- $xpaset -p ds9 vlss name - m31
- $xpaset -p ds9 vlss name - clear
- $xpaset -p ds9 vlss 00:42:44.404 - +41:16:08.78
+ $xpaset -p ds9 vlss name m31
+ $xpaset -p ds9 vlss name clear
+ $xpaset -p ds9 vlss 00:42:44.404 +41:16:08.78
$xpaset -p ds9 vlss size 60 60 arcmin
$xpaset -p ds9 vlss save yes
$xpaset -p ds9 vlss frame current
$xpaset -p ds9 vlss update frame
$xpaset -p ds9 vlss open
- $xpaset -p ds9 vlss - close
+ $xpaset -p ds9 vlss close
Invoke an connection to a Virtual Observatory site.
@@ -3569,16 +3125,12 @@Controls the World Coordinate System for the current frame. If the wcs system, skyframe, or skyformat is modified, the info - panel, - compass, grid, and alignment will be modified accordingly. Also, - using this access point, a new WCS specification can be loaded - and - used by the current image regardless of the WCS that was - contained - in the image file. WCS specification can be sent to DS9 as an - ASCII - file . Please see WCS for more - information.
+ panel, compass, grid, and alignment will be modified + accordingly. Also, using this access point, a new WCS + specification can be loaded and used by the current image + regardless of the WCS that was contained in the image file. WCS + specification can be sent to DS9 as an ASCII file . Please see WCS for more information. Syntax:
wcs [[system] wcs|wcsa...wcsz]
[[sky] fk4|fk5|icrs|galactic|ecliptic]
@@ -3598,11 +3150,9 @@ $xpaset -p ds9 wcs wcs
$xpaset -p ds9 wcs system wcs
$xpaset -p ds9 wcs fk5
- $xpaset -p ds9 wcs sky - fk5
+ $xpaset -p ds9 wcs sky fk5
$xpaset -p ds9 wcs sexagesimal
- - $xpaset -p ds9 wcs skyformat sexagesimal
+ $xpaset -p ds9 wcs skyformat sexagesimal
$xpaset -p ds9 wcs align yes
$xpaset -p ds9 wcs reset
$xpaset -p ds9 wcs reset 3
diff --git a/ds9/doc/release/r8.0.html b/ds9/doc/release/r8.0.html index 135d516..f3c49ea 100644 --- a/ds9/doc/release/r8.0.html +++ b/ds9/doc/release/r8.0.html @@ -99,6 +99,12 @@ incorrectly calculating an index into the data cube.10.18.2018 RELEASE version 8.0rc6 11.03.2018 BACKUP: fixed an issue with soft links. 12.15.2018 RELEASE version 8.0 +12.26.2018 VIEW: fixed view graph command. +01.03.2019 DS9: fixed a problem with MacOS Aqua and Windows unable to locate ds9 parser scripts at startup. +01.03.2019 SCALE: fixed scale command. +01.03.2019 PRINT: add backward compatible options for resolution to command. +01.03.2019 TILE: fix tile grid layout command. +01.07.2019 RELEASE version 8.0.1