From 4efcd533dad2b0938de99c118e34be2a99859906 Mon Sep 17 00:00:00 2001
From: William Joye Controls blocking parameters. For RGB frames, sets the current color channel to blue. 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. Sets the current working directory. exit 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. Lock all other frames to the current frame. Select log scale function for the current frame. Match all other frames to the current frame. Load FITS multiple extension file as data cube. Controls the current image cursor location for the current
frame. Display/Hide the pixel table. To create a new plot, use the plot new command. Load PNG image into current frame. Controls printing. Use print option to set printing options. Raise in the window stacking order. Load raw data array cube into rgb frame. 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. Set display mode to single. 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. Sets/Returns the current working directory. Set current image display area. Export loaded image data of current frame in specified image
format. Optional parameters: array endian, nrrd endian, jpeg
quality (1-100) and tiff compression method. Query currently loaded file information.
- -block [<value>]
- [<value>
- <value>]
- [to <value>]
- [to <value>
- <value>]
- [in]
- [out]
- [to fit]
- [match]
- [lock [yes|no]]
- [open|close]
-
- Example:
- $ds9 -block 4
- $ds9 -block 4 2
- $ds9 -block to 4
- $ds9 -block to 4 2
- $ds9 -block in
- $ds9 -block
- out
- $ds9 -block to fit
- $ds9 -block match
- $ds9 -block lock yes
- $ds9 -block open
- $ds9 -block close
+ Syntax:
+ -block [<value>]
+ [<value>
+ <value>]
+ [to <value>]
+ [to <value>
+ <value>]
+ [in]
+ [out]
+ [to fit]
+ [match]
+ [lock [yes|no]]
+ [open|close]
+
+ Example:
+ $ds9 -block
+ 4
+ $ds9 -block 4 2
+ $ds9 -block
+ to 4
+ $ds9 -block to 4 2
+ $ds9 -block in
+ $ds9 -block
+ out
+ $ds9 -block to
+ fit
+ $ds9 -block match
+ $ds9 -block lock yes
+ $ds9 -block open
+ $ds9 -block close
- -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]
- [2mass|iras]
- [csc|xmm|rosat]
- [first|nvss]
-
- [chandralog|cfhtlog|esolog|stlog|xmmlog]
- [cds <catalogname>]
- [cds
- <catalogid>]
-
- [load <filename>]
- [import sb|tsv
- <filename>]
-
- [<ref>]
- [<ra> <dec> <coordsys>]
- [<ref>] [allcols]
-
- [<ref>] [allrows]
- [<ref>]
- [cancel]
- [<ref>]
- [clear]
- [<ref>] [close]
- [<ref>]
- [crosshair]
- [<ref>] [dec
- <col>]
- [<ref>] [edit
- yes|no]
- [<ref>]
- [export sb|tsv <filename>]
-
- [<ref>] [filter <string>]
- [<ref>] [filter load
- <filename>]
- [<ref>]
- [header]
- [<ref>] [location
- <code>]
- [<ref>]
- [match <ref> <ref>]
-
+ 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]
+
+ [2mass|iras]
+
+ [csc|xmm|rosat]
+ [first|nvss]
+
+ [chandralog|cfhtlog|esolog|stlog|xmmlog]
+ [cds
+ <catalogname>]
+ [cds
+ <catalogid>]
+
+ [load
+ <filename>]
+ [import sb|tsv
+ <filename>]
+
+
+ [<ref>] [<ra> <dec>
+ <coordsys>]
+
+ [<ref>] [allcols]
+
+ [<ref>] [allrows]
+
+ [<ref>] [cancel]
+
+ [<ref>] [clear]
+
+ [<ref>] [close]
+
+ [<ref>] [crosshair]
+
+ [<ref>] [dec <col>]
+
+ [<ref>] [edit yes|no]
+
+ [<ref>] [export sb|tsv <filename>]
+
- [<ref>] [match]
- [<ref>]
-[match
+ [<ref>] [filter <string>]
+ [<ref>]
+ [filter load <filename>]
+
+ [<ref>] [header]
+
+ [<ref>] [location <code>]
+
+ [<ref>] [match <ref> <ref>]
+
- error <value> degrees|arcmin|arcsec]
- [<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>] [plot
- <xcol> <ycol> <xerrcol> <yerrcol>]
- [<ref>] [print]
- [<ref>] [psky
- <skyframe>]
- [<ref>] [psystem
- <coordsys>]
- [<ref>] [ra
- <col>]
- [<ref>]
- [regions]
- [<ref>] [retrieve]
- [<ref>]
- [samp]
- [<ref>] [samp
- broadcast]
- [<ref>] [samp
- send <application>]
-
- [<ref>] [save <filename>]
- [<ref>]
- [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>] [symbol
- [#]
+
+ [<ref>] [match]
+
+ [<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>] [maxrows <number>]
+ [<ref>]
+ [name <object>]
+
+
+ [<ref>] [panto yes|no]
+
+ [<ref>] [plot <xcol> <ycol> <xerrcol>
+ <yerrcol>]
+ [<ref>]
+ [print]
+
+ [<ref>] [psky <skyframe>]
+
+ [<ref>] [psystem <coordsys>]
+
+ [<ref>] [ra <col>]
+
+ [<ref>] [regions]
+ [<ref>]
+ [retrieve]
+
+ [<ref>] [samp]
+ [<ref>]
+ [samp broadcast]
+ [<ref>]
+ [samp send <application>]
+
+
+ [<ref>] [save <filename>]
+
+ [<ref>] [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>] [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 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>] [x
- <col>]
- [<ref>] [y
- <col>]
-
- Example:
- $ds9 -catalog new
- $ds9 -catalog 2mass
- $ds9 -catalog cds 2mass
- $ds9 -catalog cds "I/252"
-
- $ds9 -catalog load foo.xml
- $ds9 -catalog import tsv foo.tsv
-
- $ds9 -catalog 202.48 47.21 fk5
- $ds9 -catalog allrows
- $ds9 -catalog allcols
- $ds9 -catalog cancel
- $ds9 -catalog clear
- $ds9 -catalog close
- $ds9 -catalog crosshair
- $ds9 -catalog dec DEC
- $ds9 -catalog edit yes
- $ds9 -catalog export tsv bar.tsv
- $ds9 -catalog filter '\$Jmag>15'
- $ds9 -catalog filter load foo.flt
- $ds9 -catalog header
- $ds9 -catalog location 500
- $ds9 -catalog match error 2 arcsec
- $ds9 -catalog match function 1and2
- $ds9 -catalog match unique no
- $ds9 -catalog match return 1only
- $ds9 -catalog match # last two catalogs loaded
- $ds9 -catalog match 2mass csc
- $ds9 -catalog maxrows 2000
- $ds9 -catalog name m51
- $ds9 -catalog panto no
- $ds9 -catalog plot '\$Jmag' '\$Hmag'
- '\$e_Jmag' '\$e_Hmag'
- $ds9 -catalog print
- $ds9 -catalog psky fk5
- $ds9 -catalog psystem wcs
- $ds9 -catalog ra RA
- $ds9 -catalog regions
- $ds9 -catalog retrieve
- $ds9 -catalog samp broadcast
- $ds9 -catalog samp send aladin
- $ds9 -catalog save foo.xml
- $ds9 -catalog server sao
- $ds9 -catalog show yes
- $ds9 -catalog radius 1 degrees
- $ds9 -catalog symbol condition '\$Jmag>15'
- $ds9 -catalog symbol 2 shape "boxcircle point"
- $ds9 -catalog symbol color red
- $ds9 -catalog symbol font times
- $ds9 -catalog symbol fontsize 14
- $ds9 -catalog symbol fontweight bold
- $ds9 -catalog symbol fontslant italic
- $ds9 -catalog symbol add
- $ds9 -catalog symbol 2 remove
- $ds9 -catalog symbol load foo.sym
- $ds9 -catalog symbol save bar.sym
- $ds9 -catalog sky fk5
- $ds9 -catalog skyformat degrees
- $ds9 -catalog sort "Jmag" incr
- $ds9 -catalog system wcs
- $ds9 -catalog update
- $ds9 -catalog x RA
- $ds9 -catalog y DEC
+ <value>]
+
+ [<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]
+
+
+ [<ref>] [symbol add| [#] remove]
+ [<ref>]
+ [symbol save|load <filename>]
+
+ [<ref>] [system <coordsys>]
+
+ [<ref>] [update]
+
+ [<ref>] [x <col>]
+
+ [<ref>] [y <col>]
+
+ Example:
+ $ds9 -catalog new
+ $ds9 -catalog 2mass
+ $ds9 -catalog cds 2mass
+ $ds9 -catalog cds "I/252"
+
+ $ds9 -catalog load foo.xml
+ $ds9 -catalog import tsv foo.tsv
+
+ $ds9 -catalog 202.48 47.21 fk5
+ $ds9 -catalog allrows
+ $ds9 -catalog allcols
+ $ds9 -catalog cancel
+ $ds9 -catalog clear
+ $ds9 -catalog close
+ $ds9 -catalog crosshair
+ $ds9 -catalog dec DEC
+ $ds9 -catalog edit yes
+ $ds9 -catalog export tsv bar.tsv
+ $ds9 -catalog filter '\$Jmag>15'
+ $ds9 -catalog filter load foo.flt
+ $ds9 -catalog header
+ $ds9 -catalog location 500
+ $ds9 -catalog match error 2 arcsec
+ $ds9 -catalog match function 1and2
+ $ds9 -catalog match unique no
+ $ds9 -catalog match return 1only
+ $ds9 -catalog match # last two
+ catalogs loaded
+ $ds9 -catalog match 2mass csc
+ $ds9 -catalog maxrows 2000
+ $ds9 -catalog name m51
+ $ds9 -catalog panto no
+ $ds9 -catalog plot '\$Jmag'
+ '\$Hmag' '\$e_Jmag' '\$e_Hmag'
+ $ds9 -catalog print
+ $ds9 -catalog psky fk5
+ $ds9 -catalog psystem wcs
+ $ds9 -catalog ra RA
+ $ds9 -catalog regions
+ $ds9 -catalog retrieve
+ $ds9 -catalog samp broadcast
+ $ds9 -catalog samp send aladin
+ $ds9 -catalog save foo.xml
+ $ds9 -catalog server sao
+ $ds9 -catalog show yes
+ $ds9 -catalog radius 1 degrees
+ $ds9 -catalog symbol condition '\$Jmag>15'
+ $ds9 -catalog symbol 2 shape "boxcircle point"
+ $ds9 -catalog symbol color red
+ $ds9 -catalog symbol font times
+ $ds9 -catalog symbol fontsize 14
+ $ds9 -catalog symbol fontweight
+ bold
+ $ds9 -catalog symbol fontslant
+ italic
+ $ds9 -catalog symbol add
+ $ds9 -catalog symbol 2 remove
+ $ds9 -catalog symbol load foo.sym
+ $ds9 -catalog symbol save bar.sym
+ $ds9 -catalog sky fk5
+ $ds9 -catalog skyformat degrees
+ $ds9 -catalog sort "Jmag" incr
+ $ds9 -catalog system wcs
+ $ds9 -catalog update
+ $ds9 -catalog x RA
+ $ds9 -catalog y DEC
@@ -644,6 +665,7 @@
[ticks]
+
[match]
[lock
[yes|no]]
@@ -774,6 +796,7 @@
[match
+
<coordsys>]
[lock
<coordsys>|none]
@@ -933,6 +956,7 @@
Example:
$ds9 -envi foo.hdr
$ds9
+
-envi foo.hdr foo.bsq
@@ -954,24 +978,29 @@
extension is used to determine the output format. Optional
parameters: jpeg quality (1-100) and tiff compression method.
- -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 <filename>.jpeg [1-100]
- -export <filename>.tiff
- [none|jpeg|packbits|deflate]
-
- Example:
- $ds9 -export array foo.arr little
- $ds9 -export nrrd foo.nrrd little
- $ds9 -export envi foo.hdr little
- $ds9 -export envi foo.hdr foo.bsq little
- $ds9 -export tiff foo.tiff jpeg
- $ds9 -export jpeg foo.jpeg 75
- $ds9 -export png foo.png
+ Syntax:
+ -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 <filename>.jpeg
+ [1-100]
+ -export <filename>.tiff
+
+ [none|jpeg|packbits|deflate]
+
+ Example:
+ $ds9 -export array foo.arr little
+ $ds9 -export nrrd foo.nrrd little
+ $ds9 -export envi foo.hdr little
+ $ds9 -export envi foo.hdr foo.bsq
+ little
+ $ds9 -export tiff foo.tiff jpeg
+ $ds9 -export jpeg foo.jpeg 75
+ $ds9 -export png foo.png
- -lock [frame <coordsys>|none]
- [crosshair
- <coordsys>|none]
- [crop <coordsys>|none]
- [slice <coordsys>|none]
- [bin [yes|no]]
- [axes [yes|no]]
- [scale [yes|no]]
- [scalelimits [yes|no]]
- [colorbar [yes|no]]
- [block [yes|no]]
- [smooth [yes|no]]
- [3d [yes|no]]
-
- Example:
- $ds9 -lock frame wcs
- $ds9 -lock crosshair wcs
- $ds9 -lock crop wcs
- $ds9 -lock slice wcs
- $ds9 -lock bin yes
- $ds9 -lock axes yes
- $ds9 -lock scale yes
- $ds9 -lock scalelimits yes
- $ds9 -lock colorbar yes
- $ds9 -lock block yes
- $ds9 -lock smooth yes
+ Syntax:
+ -lock [frame
+ <coordsys>|none]
+ [crosshair
+ <coordsys>|none]
+ [crop
+ <coordsys>|none]
+ [slice
+ <coordsys>|none]
+ [bin [yes|no]]
+ [axes [yes|no]]
+ [scale [yes|no]]
+ [scalelimits [yes|no]]
+ [colorbar [yes|no]]
+ [block [yes|no]]
+
+ [smooth [yes|no]]
+ [3d [yes|no]]
+
+ Example:
+ $ds9 -lock frame wcs
+ $ds9 -lock crosshair wcs
+ $ds9 -lock crop wcs
+ $ds9 -lock slice wcs
+ $ds9 -lock bin yes
+ $ds9 -lock axes yes
+ $ds9 -lock scale yes
+ $ds9 -lock scalelimits yes
+ $ds9 -lock colorbar yes
+ $ds9 -lock block yes
+ $ds9 -lock smooth yes
$ds9 -lock 3d yes
+
log
- -match [frame <coordsys>]
- [crosshair
- <coordsys>]
- [crop
- <coordsys>]
- [slice <coordsys>]
- [bin]
- [axes]
- [scale]
- [scalelimits]
- [colorbar]
- [block]
- [smooth]
- [3d]
-
- Example:
- $ds9 -match frame wcs
- $ds9 -match crosshair wcs
- $ds9 -match crop wcs
- $ds9 -match slice wcs
- $ds9 -match bin
- $ds9 -match axes
- $ds9 -match scale
- $ds9 -match scalelimits
- $ds9 -match colorbar
- $ds9 -match block
- $ds9 -match smooth
- $ds9 -match 3d
+ Syntax:
+ -match [frame
+ <coordsys>]
+ [crosshair
+
+ <coordsys>]
+
+ [crop <coordsys>]
+ [slice
+ <coordsys>]
+ [bin]
+ [axes]
+ [scale]
+ [scalelimits]
+ [colorbar]
+ [block]
+ [smooth]
+
+ [3d]
+
+ Example:
+ $ds9 -match frame wcs
+ $ds9 -match crosshair wcs
+ $ds9 -match crop wcs
+ $ds9 -match slice wcs
+ $ds9 -match bin
+ $ds9 -match axes
+ $ds9 -match scale
+ $ds9 -match scalelimits
+ $ds9 -match colorbar
+ $ds9 -match block
+ $ds9 -match smooth
+ $ds9 -match 3d
mecube
@@ -1541,12 +1579,15 @@
degrees|sexagesimal]
+
[pan]
+
[crosshair]
+
[open|close]
Example:
@@ -1632,27 +1673,29 @@
- -pan [<x> <h> <coordsys> [<skyframe>]] #
- relative
- [to <x> <h>
- <coordsys> [<skyframe>]] # absolute
- [open|close]
-
- Example:
- $ds9 -pan 200 200 image # pan relative
- $ds9 -pan to 400 400 physical # pan to physical
- coords
- $ds9 -pan to 13:29:55 47:11:50 wcs fk # pan to wcs
- coords
- $ds9 -pan open
- $ds9 -pan close
+ Syntax:
+ -pan [<x> <h> <coordsys>
+ [<skyframe>]] # relative
+ [to <x> <h>
+ <coordsys> [<skyframe>]] # absolute
+ [open|close]
+
+ Example:
+ $ds9 -pan 200 200 image # pan
+ relative
+ $ds9 -pan to 400 400 physical # pan
+ to physical coords
+ $ds9 -pan to 13:29:55 47:11:50 wcs fk #
+ pan to wcs coords
+ $ds9 -pan open
+ $ds9 -pan close
-pixeltable []
+
[yes|open]
[no|close]
@@ -1677,178 +1720,188 @@
- # create new empty plot window
- -plot [line|bar|scatter]
-
- # 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>]
+ # create new empty plot window
+ -plot [line|bar|scatter]
+
+ # 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 <filename>]
- [[<plotname>] saveconfig
- <filename>]
- [[<plotname>] pagesetup
- orient portrait|landscape]
- [[<plotname>] pagesetup size
+
+ [[<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
- <filename>]
- [[<plotname>] print color
- rgb|gray]
- [[<plotname>]
- close]
- [[<plotname>] mode
- pointer|zoom]
-
- # configure graph
- -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 min
- <value>]
- [[<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
- size <value>]
- [[<plotname>] font title|labels|numbers
- weight normal|bold]
- [[<plotname>] font title|labels|numbers
- slant roman|italic]
- [[<plotname>] title
- <string>]
- [[<plotname>] title x|y
- <string>]
- [[<plotname>]
- barmode normal|stacked|aligned|overlap]
-
- # 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>]
+
+ [[<plotname>] print]
+
+ [[<plotname>] print destination printer|file]
+
+ [[<plotname>] print command <command>]
+
+ [[<plotname>] print filename <filename>]
+
+ [[<plotname>] print color rgb|gray]
+ [[<plotname>]
- error yes|no]
- [[<plotname>]
-
- error color <value>]
- [[<plotname>]
- color <value>]
- [[<plotname>]
+ close]
+ [[<plotname>]
+ mode pointer|zoom]
+
+ # configure graph
+ -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 min <value>]
+
+ [[<plotname>] axis x|y max <value>]
+
+ [[<plotname>] axis x|y format <string>]
+ [[<plotname>]
- error width <value>]
- [[<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
+ weight normal|bold]
+
+ [[<plotname>] font title|labels|numbers
+ slant roman|italic]
+
+ [[<plotname>] title <string>]
+
+ [[<plotname>] title x|y <string>]
+ [[<plotname>]
- name <string>]
-
- # select current dataset
- -plot [[<plotname>] select <value>]
-
- Example:
- # create new empty plot window
- $ds9 -plot bar
-
- # existing plot
- $ds9 -plot load xy.dat
- $ds9 -plot save foo.dat
- $ds9 -plot clear
- $ds9 -plot duplicate 1
- $ds9 -plot stats yes
- $ds9 -plot list yes
- $ds9 -plot loadconfig foo.plt
- $ds9 -plot saveconfig foo.plt
- $ds9 -plot pagesetup orient portrait
- $ds9 -plot pagesetup size letter
- $ds9 -plot print
- $ds9 -plot print destination file
- $ds9 -plot print command lp
- $ds9 -plot print filename foo.ps
- $ds9 -plot print color rgb
- $ds9 -plot close
- $ds9 -plot mode pointer
-
- # configure plot
- $ds9 -plot axis x grid yes
- $ds9 -plot axis x log yes
- $ds9 -plot axis x flip yes
- $ds9 -plot axis x auto no
- $ds9 -plot axis x min 1
- $ds9 -plot axis x max 100
- $ds9 -plot axis x format '%f'
-
- $ds9 -plot legend yes
- $ds9 -plot legend position left
-
- $ds9 -plot font numbers font times
- $ds9 -plot font numbers size 12
- $ds9 -plot font numbers weight bold
- $ds9 -plot font numbers slant italic
-
- $ds9 -plot title 'This is a Title'
- $ds9 -plot title x 'X Axis'
- $ds9 -plot title y 'Y Axis'
- $ds9 -plot title legend 'This is the Legend'
-
- $ds9 -plot barmode aligned
-
- # configure current dataset
- $ds9 -plot show yes
- $ds9 -plot shape circle
- $ds9 -plot shape fill no
- $ds9 -plot shape color cyan
- $ds9 -plot smooth step
- $ds9 -plot color red
- $ds9 -plot width 2
- $ds9 -plot dash yes
- $ds9 -plot error yes
- $ds9 -plot error color red
- $ds9 -plot error width 2
- $ds9 -plot name 'My Data'
-
- # select current dataset
- $ds9 -plot select 2
+ barmode normal|stacked|aligned|overlap]
+
+ # 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 color <value>]
+
+ [[<plotname>] color <value>]
+
+ [[<plotname>] error width <value>]
+
+ [[<plotname>] name <string>]
+
+ # select current dataset
+ -plot [[<plotname>] select
+ <value>]
+
+ Example:
+ # create new empty plot window
+ $ds9 -plot bar
+
+ # existing plot
+ $ds9 -plot load xy.dat
+ $ds9 -plot save foo.dat
+ $ds9 -plot clear
+ $ds9 -plot duplicate 1
+ $ds9 -plot stats yes
+ $ds9 -plot list yes
+ $ds9 -plot loadconfig foo.plt
+ $ds9 -plot saveconfig foo.plt
+ $ds9 -plot pagesetup orient
+ portrait
+ $ds9 -plot pagesetup size letter
+ $ds9 -plot print
+ $ds9 -plot print destination file
+ $ds9 -plot print command lp
+ $ds9 -plot print filename foo.ps
+ $ds9 -plot print color rgb
+ $ds9 -plot close
+ $ds9 -plot mode pointer
+
+ # configure plot
+ $ds9 -plot axis x grid yes
+ $ds9 -plot axis x log yes
+ $ds9 -plot axis x flip yes
+ $ds9 -plot axis x auto no
+ $ds9 -plot axis x min 1
+ $ds9 -plot axis x max 100
+ $ds9 -plot axis x format '%f'
+
+ $ds9 -plot legend yes
+ $ds9 -plot legend position left
+
+ $ds9 -plot font numbers font times
+ $ds9 -plot font numbers size 12
+ $ds9 -plot font numbers weight bold
+ $ds9 -plot font numbers slant
+ italic
+
+ $ds9 -plot title 'This is a Title'
+ $ds9 -plot title x 'X Axis'
+ $ds9 -plot title y 'Y Axis'
+ $ds9 -plot title legend 'This is
+ the Legend'
+
+ $ds9 -plot barmode aligned
+
+ # configure current dataset
+ $ds9 -plot show yes
+ $ds9 -plot shape circle
+ $ds9 -plot shape fill no
+ $ds9 -plot shape color cyan
+ $ds9 -plot smooth step
+ $ds9 -plot color red
+ $ds9 -plot width 2
+ $ds9 -plot dash yes
+ $ds9 -plot error yes
+ $ds9 -plot error color red
+ $ds9 -plot error width 2
+ $ds9 -plot name 'My Data'
+
+ # select current dataset
+ $ds9 -plot select 2
- -print [destination printer|file]
- [command <command>]
- [filename <filename>]
- [color
- rgb|cmyk|gray]
- [level 1|2]
- [resolution
- 53|72|75|150|300|600]
-
- Example:
- $ds9 -print
- $ds9 -print destination file
- $ds9 -print command lp
- $ds9 -print filename foo.ps
- $ds9 -print color cmyk
- $ds9 -print level 2
- $ds9 -print resolution 75
+ Syntax:
+ -print [destination printer|file]
+ [command
+ <command>]
+ [filename
+ <filename>]
+
+ [color rgb|cmyk|gray]
+ [level 1|2]
+ [resolution
+ 53|72|75|150|300|600]
+
+ Example:
+ $ds9 -print
+ $ds9 -print destination file
+ $ds9 -print command lp
+ $ds9 -print filename foo.ps
+ $ds9 -print color cmyk
+ $ds9 -print level 2
+ $ds9 -print resolution 75
@@ -2141,8 +2196,7 @@
$ds9 -rgb lock block yes
$ds9 -rgb lock smooth yes
$ds9 -rgb open
- $ds9 -rgb close
-
+ $ds9 -rgb close
Example:
@@ -2309,51 +2364,60 @@
- -sia [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr]
-
- [<ref>]
- [cancel]
- [<ref>] [clear]
- [<ref>] [close]
- [<ref>] [coordinate <ra>
- <dec> <coordsys>]
- [<ref>]
- [crosshair]
- [<ref>] [export sb|tsv
- <filename>]
- [<ref>] [name <object>]
- [<ref>] [print]
- [<ref>] [retrieve]
- [<ref>] [save
- <filename>]
- [<ref>] [radius <value>
- degrees|arcmin|arcsec]
- [<ref>] [sky <skyframe>]
- [<ref>] [skyformat
- <skyformat>]
- [<ref>] [system
- <coordsys>]
- [<ref>]
- [update]
-
- Example:
- $ds9 -sia 2mass
- $ds9 -sia cancel
- $ds9 -sia clear
- $ds9 -sia close
- $ds9 -sia coordinate 202.48 47.21 fk5
- $ds9 -sia crosshair
- $ds9 -sia export tsv bar.tsv
- $ds9 -sia name m51
- $ds9 -sia print
- $ds9 -sia retrieve
- $ds9 -sia save foo.xml
- $ds9 -sia radius 1 degrees
- $ds9 -sia sky fk5
- $ds9 -sia skyformat degrees
- $ds9 -sia system wcs
- $ds9 -sia update
+ Syntax:
+ -sia [2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr]
+
+
+ [<ref>] [cancel]
+
+ [<ref>] [clear]
+ [<ref>]
+ [close]
+ [<ref>]
+ [coordinate <ra> <dec> <coordsys>]
+ [<ref>]
+
+ [crosshair]
+ [<ref>] [export
+ sb|tsv <filename>]
+ [<ref>]
+ [name <object>]
+ [<ref>]
+ [print]
+ [<ref>]
+ [retrieve]
+
+ [<ref>] [save <filename>]
+ [<ref>] [radius
+ <value> degrees|arcmin|arcsec]
+ [<ref>] [sky
+ <skyframe>]
+
+ [<ref>] [skyformat <skyformat>]
+
+ [<ref>] [system <coordsys>]
+ [<ref>]
+
+ [update]
+
+ Example:
+ $ds9 -sia 2mass
+ $ds9 -sia cancel
+ $ds9 -sia clear
+ $ds9 -sia close
+ $ds9 -sia coordinate 202.48 47.21
+ fk5
+ $ds9 -sia crosshair
+ $ds9 -sia export tsv bar.tsv
+ $ds9 -sia name m51
+ $ds9 -sia print
+ $ds9 -sia retrieve
+ $ds9 -sia save foo.xml
+ $ds9 -sia radius 1 degrees
+ $ds9 -sia sky fk5
+ $ds9 -sia skyformat degrees
+ $ds9 -sia system wcs
+ $ds9 -sia update
single
+
[sigma <value>]
+
[sigmaminor <value>]
[angle
+
<value>]
[match]
@@ -2465,8 +2532,10 @@
$ds9
-smooth
+
sigmaminor 2.0
$ds9
+
-smooth angle 45
$ds9 -smooth
match
diff --git a/ds9/doc/ref/samp.html b/ds9/doc/ref/samp.html
index 6776582..43a0314 100644
--- a/ds9/doc/ref/samp.html
+++ b/ds9/doc/ref/samp.html
@@ -454,199 +454,217 @@
- 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]
-
- [2mass|iras]
- [csc|xmm|rosat]
- [first|nvss]
-
- [chandralog|cfhtlog|esolog|stlog|xmmlog]
- [cds <catalogname>]
- [cds
- <catalogid>]
-
- [load <filename>]
- [import sb|tsv
- <filename>]
-
- [<ref>]
- [<ra> <dec> <coordsys>]
- [<ref>] [allcols]
-
- [<ref>] [allrows]
- [<ref>]
- [cancel]
- [<ref>]
- [clear]
- [<ref>] [close]
- [<ref>]
- [crosshair]
- [<ref>] [dec
- <col>]
- [<ref>] [edit
- yes|no]
- [<ref>]
- [export sb|tsv <filename>]
-
- [<ref>] [filter <string>]
- [<ref>] [filter load
- <filename>]
- [<ref>]
- [header]
- [<ref>] [location
- <code>]
- [<ref>]
- [match]
-
+ 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]
+
+
+ [2mass|iras]
+
+ [csc|xmm|rosat]
+ [first|nvss]
+
+ [chandralog|cfhtlog|esolog|stlog|xmmlog]
+ [cds
+ <catalogname>]
+ [cds
+ <catalogid>]
+
+ [load
+ <filename>]
+ [import sb|tsv
+ <filename>]
+
+
+ [<ref>] [<ra> <dec>
+ <coordsys>]
+
+ [<ref>] [allcols]
+
+ [<ref>] [allrows]
+
+ [<ref>] [cancel]
+
+ [<ref>] [clear]
+
+ [<ref>] [close]
+
+ [<ref>] [crosshair]
+
+ [<ref>] [dec <col>]
+
+ [<ref>] [edit yes|no]
+
+ [<ref>] [export sb|tsv <filename>]
+
- [<ref>] [match <ref> <ref>]
- [<ref>]
-[match
+ [<ref>] [filter <string>]
+ [<ref>]
+ [filter load <filename>]
+
+ [<ref>] [header]
+
+ [<ref>] [location <code>]
+
+ [<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>] [maxrows
- <number>]
- [<ref>] [name
- <object>]
-
- [<ref>] [panto yes|no]
- [<ref>] [plot
- <xcol> <ycol> <xerrcol> <yerrcol>]
- [<ref>] [print]
- [<ref>] [psky
- <skyframe>]
- [<ref>] [psystem
- <coordsys>]
- [<ref>] [ra
- <col>]
- [<ref>] [regions]
- [<ref>]
- [retrieve]
- [<ref>] [samp]
- [<ref>] [samp
- broadcast]
- [<ref>] [samp
- send <application>]
-
- [<ref>] [save <filename>]
- [<ref>]
- [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>] [symbol
- [#]
+
+ [<ref>] [match <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>] [maxrows <number>]
+ [<ref>]
+ [name <object>]
+
+
+ [<ref>] [panto yes|no]
+
+ [<ref>] [plot <xcol> <ycol> <xerrcol>
+ <yerrcol>]
+ [<ref>]
+ [print]
+
+ [<ref>] [psky <skyframe>]
+
+ [<ref>] [psystem <coordsys>]
+
+ [<ref>] [ra <col>]
+
+ [<ref>] [regions]
+
+ [<ref>] [retrieve]
+ [<ref>]
+ [samp]
+ [<ref>]
+ [samp broadcast]
+ [<ref>]
+ [samp send <application>]
+
+
+ [<ref>] [save <filename>]
+
+ [<ref>] [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>] [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 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>] [x
- <col>]
- [<ref>] [y
- <col>]
-
- Example:
- string value = ds9.get(string cmd)
- catalog
- catalog header
-
- ds9.set(string cmd)
- catalog new
- catalog 2mass
- catalog cds 2mass
- catalog cds {I/252}
-
- catalog load foo.xml
- catalog import tsv foo.tsv
-
- catalog allrows
- catalog allcols
- catalog cancel
- catalog clear
- catalog close
- catalog coordinate 202.48 47.21 fk5
- catalog crosshair
- catalog dec DEC
- catalog edit yes
- catalog export tsv bar.tsv
- catalog filter {$Jmag>10}
- catalog filter load foo.flt
- catalog header
- catalog location 500
- catalog match error 2 arcsec
- catalog match function 1and2
- catalog match unique no
- catalog match return 1only
- catalog match # last two catalogs loaded
- catalog match 2mass csc
- catalog maxrows 2000
- catalog name m51
- catalog panto no
- catalog plot {$Jmag} {$Hmag} {$e_Jmag}
- {$e_Hmag}
- catalog print
- catalog psky fk5
- catalog psystem wcs
- catalog ra RA
- catalog regions
- catalog retrieve
- catalog samp broadcast
- catalog samp send aladin
- catalog save foo.xml
- catalog server sao
- catalog show yes
- catalog radius 1 degrees
- catalog symbol condition {$Jmag>15}
- catalog symbol 2 shape {boxcircle point}
- catalog symbol color red
- catalog symbol font times
- catalog symbol fontsize 14
- catalog symbol fontweight bold
- catalog symbol fontslant italic
- catalog symbol add
- catalog symbol 2 remove
- catalog symbol load foo.sym
- catalog symbol save bar.sym
- catalog sky fk5
- catalog skyformat degrees
- catalog sort {Jmag} incr
- catalog system wcs
- catalog update
- catalog x RA
- catalog y DEC
+ <value>]
+
+ [<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]
+
+ [<ref>] [symbol add| [#] remove]
+ [<ref>]
+ [symbol save|load <filename>]
+
+ [<ref>] [system <coordsys>]
+
+ [<ref>] [update]
+
+ [<ref>] [x <col>]
+
+ [<ref>] [y <col>]
+
+ Example:
+ string value = ds9.get(string cmd)
+ catalog
+ catalog header
+
+ ds9.set(string cmd)
+ catalog new
+ catalog 2mass
+ catalog cds 2mass
+ catalog cds {I/252}
+
+ catalog load foo.xml
+ catalog import tsv foo.tsv
+
+ catalog allrows
+ catalog allcols
+ catalog cancel
+ catalog clear
+ catalog close
+ catalog coordinate 202.48 47.21 fk5
+ catalog crosshair
+ catalog dec DEC
+ catalog edit yes
+ catalog export tsv bar.tsv
+ catalog filter {$Jmag>10}
+ catalog filter load foo.flt
+ catalog header
+ catalog location 500
+ catalog match error 2 arcsec
+ catalog match function 1and2
+ catalog match unique no
+ catalog match return 1only
+ catalog match # last two catalogs
+ loaded
+ catalog match 2mass csc
+ catalog maxrows 2000
+ catalog name m51
+ catalog panto no
+ catalog plot {$Jmag}
+ {$Hmag} {$e_Jmag} {$e_Hmag}
+ catalog print
+ catalog psky fk5
+ catalog psystem wcs
+ catalog ra RA
+ catalog regions
+ catalog retrieve
+ catalog samp broadcast
+ catalog samp send aladin
+ catalog save foo.xml
+ catalog server sao
+ catalog show yes
+ catalog radius 1 degrees
+ catalog symbol condition {$Jmag>15}
+ catalog symbol 2 shape {boxcircle
+ point}
+ catalog symbol color red
+ catalog symbol font times
+ catalog symbol fontsize 14
+ catalog symbol fontweight bold
+ catalog symbol fontslant italic
+ catalog symbol add
+ catalog symbol 2 remove
+ catalog symbol load foo.sym
+ catalog symbol save bar.sym
+ catalog sky fk5
+ catalog skyformat degrees
+ catalog sort {Jmag} incr
+ catalog system wcs
+ catalog update
+ catalog x RA
+ catalog y DEC
@@ -770,6 +788,7 @@
[load
levels <filename>]
+
[save levels <filename>]
[copy]
[paste
@@ -842,23 +861,26 @@
- crop [<x> <y> <width> <height>
- [<coordsys>][<skyframe>][degrees|arcmin|arcsec]
- [match <coordsys>]
- [lock <coordsys>|none]
- [reset]
- [3d zmin zmax
- <coordsys>]
- [open|close]
-
- Example:
- string value = ds9.get(string cmd)
- crop # get crop in physical coords
- crop wcs galactic sexagesimal arcsec
- crop lock
- ds9.set(string cmd)
- crop 40 30 10 20 # set crop in physical coords
+ Syntax:
+ crop [<x> <y> <width> <height>
+ [<coordsys>][<skyframe>][degrees|arcmin|arcsec]
+
+ [match <coordsys>]
+ [lock
+ <coordsys>|none]
+ [reset]
+ [3d zmin
+ zmax <coordsys>]
+ [open|close]
+
+ Example:
+ string value = ds9.get(string cmd)
+ crop # get crop in physical coords
+ crop wcs galactic sexagesimal
+ arcsec
+ crop lock
+ ds9.set(string cmd)
+ crop 40 30 10 20 # set crop in physical coords
crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs
galactic arcsec
crop match wcs
@@ -1102,24 +1124,29 @@
- 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 jpeg <filename> [1-100]
- export tiff <filename> [none|jpeg|packbits|deflate]
-
- Example:
- ds9.set (string cmd)
- export array foo.arr little
- export nrrd foo.nrrd little
- export envi foo.hdr little
- export envi foo.hdr foo.bsq little
- export tiff foo.tiff jpeg
- export jpeg foo.jpeg 75
- export png foo.png
+ Syntax:
+ 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 jpeg <filename>
+ [1-100]
+ export tiff <filename>
+ [none|jpeg|packbits|deflate]
+
+ Example:
+ ds9.set (string cmd)
+ export array foo.arr little
+ export nrrd foo.nrrd little
+ export envi foo.hdr little
+ export envi foo.hdr foo.bsq little
+ export tiff foo.tiff jpeg
+ export jpeg foo.jpeg 75
+ export png foo.png
@@ -1576,6 +1603,7 @@
$x, $y, $z. See Analysis
+
Macros for more information.
Lock all other frames to the current frame.
- Syntax:Lower in the window stacking order.
@@ -2054,270 +2087,306 @@To create a new plot, use the plot new command.
Syntax:Load PNG image into current frame.
Set region and coordinate output format precision.
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.
- Syntax:Select Single Display mode
@@ -2968,15 +3041,19 @@ [radiusminor <value>]Export loaded image data of current frame in specified image format. Optional parameters: array endian, nrrd endian, jpeg quality (1-100) and tiff compression method.
- Syntax:Load FITS mosaic segment into current frame.
- Syntax:Load FITS mosaic image into current frame.
@@ -1792,20 +1808,19 @@Load an NRRD (Nearly Raw Raster Data) file. Optional parameter:
array endian.
Support for NRAO VLA Sky Survey.
Syntax:To create a new plot, use the plot new command.
Syntax:Load PNG image into current frame.
Load FITS rgbimage into rgb 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.
- Syntax:Load TIFF image into current frame. Optional parameters: tiff compression method.
- Syntax:Controls the tile display mode.
Syntax:Invoke an connection to a Virtual Observatory site.
Syntax: