SAMP SAMPSAMP 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.
The samp implementation for DS9 is based on the XPA model with 2 private calls:
ds9.get
Arguments
cmd (string) required
url (string) optional
Returned value
OK (samp.result map)
value (string) optional
url (string) optional
ERROR (samp.error map)
samp.errortxt (string)
ds9.set
Arguments
cmd (string) required
url (string) optional
Returned value
OK
ERROR (samp.error map)
samp.errortxt (string)
ds9.set maybe called via notification, call and call/wait. ds9.get can only be called via call and call/wait. Most of the ds9.get calls return a value string, but a few will return a url instead.
2mass
3d
about
analysis
array
backup
bin
blink
block
catalog
cd
cmap
colorbar
console
contour
crop
crosshair
cube
cursor
data
dsssao
dsseso
dssstsci
envi
exit
export
fade
file
fits
footprint
frame
gif
graph
grid
header
height
iconify
iexam
iis
illustrate
jpeg
lock
lower
magnifier
mask
match
mecube
minmax
mode
mosaic
mosaicimage
movie
multiframe
nameserver
notes
nrrd
nvss
orient
pagesetup
pan
pixeltable
plot
png
prefs
preserve
psprint
prism
quit
raise
region
restore
rgb
rgbarray
rgbcube
rgbimage
rotate
samp
save
saveimage
scale
shm
sia
single
skyview
sleep
smooth
source
tcl
tiff
tile
update
url
version
view
vla
vlss
vo
wcs
web
width
xpa
zscale
zoom
Support for 2MASS Digital Sky Survey.
Syntax:
2mass []
[<object>]
[name <object>|clear]
[<ra> <dec>] # in wcs fk5
[size <width> <height> degrees|arcmin|arcsec]
[save yes|no]
[frame new|current]
[update frame|crosshair]
[survey j|h|k]
[open|close]
Example:
string value = ds9.get(string cmd)
2mass name
2mass coord
2mass size
2mass save
2mass frame
2mass survey
ds9.set(string cmd)
2mass
2mass m31
2mass name m31
2mass name clear
2mass 00:42:44.404 +41:16:08.78
2mass size 60 60 arcmin
2mass save yes
2mass frame current
2mass update frame
2mass survey j
2mass open
2mass close
Support for 3D frame.
Syntax:
3d []
[view <az> <el>]
[az <az>]
[el <el>]
[scale <scale>]
[method mip|aip]
[background none|azimuth|elevation]
[border yes|no]
[border color <color>]
[highlite yes|no]
[hightlite color <color>]
[compass yes|no]
[compass color <color>]
[match]
[lock [yes|no]]
[open|close]
Example:
string value = ds9.get(string cmd)
3d view
3d az
3d el
3d scale
3d method
3d background
3d border
3d border color
3d highlite
3d highlite color
3d compass
3d compass color
3d lock
ds9.set(string cmd)
3d # create new 3D frame
3d view 45 30
3d az 45
3d el 30
3d scale 10
3d method mip
3d background azimuth
3d border yes
3d border color red
3d highlite yes
3d highlite color red
3d compass yes
3d compass color red
3d match
3d lock yes
3d open
3d close
Get DS9 credits.
Syntax:
about
Example:
string value = ds9.get(string cmd)
about
Controls the World Coordinate System alignment for the current frame.
Syntax:
align []
[yes|no]
Example:
string value = ds9.get(string cmd)
align
ds9.set(string cmd)
align yes
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.
Syntax:
analysis [<task number>]
[<filename>]
[task <task number>|<task name>]
[load <filename>]
[clear]
[clear][load <filename>]
[entry <message>]
[message ok|okcancel|yesno <message>]
[filedialog open|save]
[text]
Example:
string value = ds9.get(string cmd)
analysis
analysis task
analysis entry {Please enter something}
analysis message okcancel {Hello World}
analysis filedialog open
ds9.set(string cmd)
analysis 0 # invoke first analysis task
analysis task 0
analysis task foobar
analysis task {foo bar}
analysis my.ans
analysis load my.ans
analysis clear
analysis clear load my.ans
analysis message {This is a message}
analysis text {this is text}
ds9.set(string cmd, string url)
analysis load
analysis text
Load raw data array into current frame.
Syntax:
array [native|little|big]
array [new|mask] [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]]
Example:
string url = ds9.get(string cmd)
array
array little
ds9.set(string command, string url)
array foo.arr[dim=512,bitpix=-32,endian=little]
array new foo.arr[dim=512,bitpix=-32,endian=little]
array mask foo.arr[dim=512,bitpix=-32,endian=little]
Create a backup save set.
Syntax:
backup <filename>
Example:
ds9.set(string cmd)
backup ds9.bck
Controls binning factor, binning buffer size, and binning function for binning FITS bin tables. The access point blocking is provided for backward compatibility.
Syntax:
bin [about <x> <y>]
[about center]
[buffersize <value>]
[cols <x> <y>]
[colsz <x> <y> <z>]
[factor <value> [<vector>]]
[depth <value>]
[filter <string>]
[filter clear]
[function average|sum]
[in]
[out]
[to fit]
[match]
[lock [yes|no]]
[open|close]
Example:
string value = ds9.get(string cmd)
bin about
bin buffersize
bin cols
bin factor
bin depth
bin filter
bin function
bin smooth
bin smooth function
bin smooth radius
bin lock
ds9.set(string cmd)
bin about 4096 4096
bin about center
bin buffersize 512
bin cols detx dety
bin colsz detx dety time
bin factor 4
bin factor 4 2
bin depth 10
bin filter 'pha > 5'
bin filter clear
bin function sum
bin in
bin out
bin to fit
bin match
bin lock yes
bin open
bin close
Blink mode parameters. Interval is in seconds.
Syntax:
blink []
[yes|no]
[interval <value>]
Example:
string value = ds9.get(string cmd)
blink
blink interval
ds9.set(string cmd)
blink
blink yes
blink interval 1
Controls blocking parameters.
Syntax:
block[<value>]
[<value> <value>]
[to <value>]
[to <value> <value>]
[in]
[out]
[to fit]
[match]
[lock [yes|no]]
[open|close]
Example:
string value = ds9.get(string cmd)
block
block lock
ds9.set(string cmd)
block4
block4 2
blockto 4
blockto 4 2
blockin
blockout
blockto fit
blockmatch
blocklock yes
blockopen
blockclose
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.
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>]
[save <filename>]
[import rdb|tsv|fits <filename>]
[export rdb|tsv <filename>]
[allcols]
[allrows]
[cancel]
[clear]
[close]
[coordinate <ra> <dec> <coordsys>]
[crosshair]
[current <ref>]
[dec <col>]
[edit yes|no]
[filter <string>]
[filter load <filename>]
[header]
[location <code>]
[match]
[match <ref> <ref>]
[match error <value> degrees|arcmin|arcsec]
[match function 1and2|1not2|2not1]
[match return 1and2|1only|2only]
[match unique yes|no]
[maxrows <number>]
[name <object>]
[panto yes|no]
[plot <xcol> <ycol> <xerrcol> <yerrcol>]
[print]
[psky <skyframe>]
[psystem <coordsys>]
[ra <col>]
[regions]
[retrieve]
[samp]
[samp broadcast]
[samp send <application>]
[server cds|adac|sao|inasan|iucaa|bejing|saao]
[show yes|no]
[radius <value> degrees|arcmin|arcsec]
[sky <skyframe>]
[skyformat <skyformat>]
[sort <col> incr|decr]
[symbol [#] condition|shape|color|text|font|fontsize|fontweight|fontslant <value>]
[symbol [#] text|size|size2|units|angle <value>]
[symbol shape circle|ellipse|box|text|point]
[symbol shapecircle point|box point|diamond point|cross point|x point|arrow point|boxcircle point]
[symbol add| [#] remove]
[symbol save|load <filename>]
[system <coordsys>]
[update]
[x <col>]
[y <col>]
Example:
string value = ds9.get(string cmd)
catalog
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 current 2mass
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
Sets/Returns the current working directory.
Syntax:
cd [<directory>]
Example:
string value = ds9.get(string cmd)
cd
ds9.set(string cmd)
cd /home/mrbill
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.
Syntax:
cmap [<colormap>]
[file]
[load <filename>]
[save <filename>]
[invert yes|no]
[<constrast> <bias>]
[tag [load|save] <filename>]
[tag delete]
[open|close]
Example:
string value = ds9.get(string cmd)
cmap
cmap file
cmap invert
cmap value
ds9.set(string cmd)
cmap Heat
cmap load foo.sao
cmap save bar.sao
cmap invert yes
cmap 5 .5
cmap tag load foo.tag
cmap tag save foo.tag
cmap tag delete
cmap open
cmap close
Controls colorbar parameters.
Syntax:
colorbar []
[yes|no]
[orientation]
[horizontal|vertical]
[numerics yes|no]
[space value|distance]
[font times|helvetica|courier]
[fontsize <value>]
[fontweight normal|bold]
[fontslant roman|italic]
[size <integer>]
[ticks <integer>]
[match]
[lock [yes|no]]
Example:
string value = ds9.get(string cmd)
colorbar
colorbar orientation
colorbar numerics
colorbar space
colorbar font
colorbar fontsize
colorbar fontweight
colorbar fontslant
colorbar size
colorbar ticks
colorbar lock
ds9.set(string cmd)
colorbar yes
colorbar vertical
colorbar numerics yes
colorbar space value
colorbar font times
colorbar fontsize 14
colorbar fontwieght bold
colorbar fontslant italic
colorbar size 20
colorbar ticks 11
colorbar match
colorbar lock yes
Display tcl console window.
Syntax:
-console
Example:
ds9.set(string cmd)
console
Controls contours in the current frame.
Syntax:
contour []
[yes|no]
[<coordsys> [<skyframe>]]
[clear]
[generate]
[load <filename>]
[save <filename> [<coordsys> <skyframe>]]
[convert]
[load levels <filename>]
[save levels <filename>]
[copy]
[paste [<coordsys> <color> <width> yes|no]]
[color <color>]
[width <width>]
[dash yes|no]
[smooth <smooth>]
[method block|smooth]
[nlevels <number of levels>]
[scale linear|log|pow|squared|sqrt|asinh|sinh|histequ]
[scale log exp <value>]
[mode minmax|<value>|zscale|zmax]
[scope global|local]
[limits <min> <max>]
[levels <value value value...>]
[open|close]
Example:
string value = ds9.get(string cmd)
contour
contour wcs fk5
contour color
contour width
contour dash
contour smooth
contour method
contour nlevels
contour scale
contour log exp
contour mode
contour scope
contour limits
contour levels
ds9.set(string cmd)
contour
contour yes
contour clear
contour generate
contour load ds9.ctr
contour save ds9.con
contour save ds9.con wcs fk5
contour convert
contour load levels ds9.ctr
contour save levels ds9.lev
contour copy
contour paste
contour paste wcs red 2 no
contour color yellow
contour width 2
contour dash yes
contour smooth 5
contour method smooth
contour nlevels 10
contour scale sqrt
contour log exp 1000
contour mode zscale
contour scope local
contour limits 1 100
contour levels 1 10 100 1000
contour open
contour close
Set current image display area.
Syntax:
crop [<x> <y> <width> <height> [<coordsys>][<skyframe>][degrees|arcmin|arcsec]
[match <coordsys>]
[lock <coordsys>|none]
[reset]
[3dzmin 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
crop lock wcs
crop reset
crop 3d .25 .5 wcs
crop open
crop close
Controls the current position of the crosshair in the current frame. DS9 is placed in crosshair mode when the crosshair is set.
Syntax:
crosshair [<x> <y> <coordsys> [<skyframe>]]
[match <coordsys>]
[lock <coordsys>|none]
Example:
string value = ds9.get(string cmd)
crosshair # get crosshair in physical coords
crosshair wcs fk4 sexagesimal # get crosshair in wcs coords
crosshair lock
ds9.set(string cmd)
crosshair 100 100 physical # set crosshair in physical
crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords
crosshair 23:01:00 +58:52:51 wcs fk5
crosshair match wcs
crosshair lock wcs
Controls FITS cube.
Syntax:
cube []
[play|stop|next|prev|first|last]
[<slice> [<coordsys>]]
[interval <numeric>]
[match <coordsys>]
[lock <coordsys>|none]
[order 123|132|213|231|312|321]
[axes lock [yes|no]]
[axis <axis>]
[open|close]
Example:
string value = ds9.get(string cmd)
cube
cube wcs
cube interval
cube lock
cube order
cube axes lock
cube axis
ds9.set(string cmd)
cube
cube play
cube last
cube 3
cube 4.4 wcs
cube interval 2
cube match wcs
cube lock wcs
cube order 123
cube axes lock yes
cube axis 3
cube open
cube close
Move mouse pointer or crosshair in image pixels in the current frame. Note, this will move selected Regions also.
Syntax:
cursor [<x> <y>]
Example:
ds9.set(string cmd)
cursor 10 10
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.
Syntax:
data [<coordsys> [<skyframe>] <x> <y> <width> <height> [yes|no]]
Example:
string url = ds9.get(string cmd)
data image 450 520 3 3 yes
data physical 899 1039 6 6 no
data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no
data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 0.00016516669 no
Support for Digital Sky Survey at SAO.
Syntax:
dsssao []
[<object>]
[name <object>|clear]
[<ra> <dec>] # in wcs fk5
[size <width> <height> degrees|arcmin|arcsec]
[save yes|no]
[frame new|current]
[update frame|crosshair]
[open|close]
Example:
string value = ds9.get(string cmd)
dsssao name
dsssao coord
dsssao size
dsssao save
dsssao frame
ds9.set(string cmd)
dsssao
dsssao m31
dsssao name m31
dsssao name clear
dsssao 00:42:44.404 +41:16:08.78
dsssao size 60 60 arcmin
dsssao save yes
dsssao frame current
dsssao update frame
dsssao open
dsssao close
Support for Digital Sky Survey at ESO.
Syntax:
dsseso []
[<object>]
[name <object>|clear]
[<ra> <dec>] # in wcs fk5
[size <width> <height> degrees|arcmin|arcsec]
[save yes|no]
[frame new|current]
[update frame|crosshair]
[survey DSS1|DSS2-red|DSS2-blue|DSS2-infrared]
[open|close]
Example:
string value = ds9.get(string cmd)
dsseso name
dsseso coord
dsseso size
dsseso save
dsseso frame
dsseso survey
ds9.set(string cmd)
dsseso
dsseso m31
dsseso name m31
dsseso name clear
dsseso 00:42:44.404 +41:16:08.78
dsseso size 60 60 arcmin
dsseso save yes
dsseso frame current
dsseso update frame
dsseso survey DSS2-red
dsseso open
dsseso close
Support for Digital Sky Survey at STSCI.
Syntax:
dssstsci []
[<object>]
[name <object>|clear]
[<ra> <dec>] # in wcs fk5
[size <width> <height> degrees|arcmin|arcsec]
[save yes|no]
[frame new|current]
[update frame|crosshair]
[survey poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue]
[survey poss1_blue|poss1_red]
[survey all|quickv|phase2_gsc2|phase2_gsc1]
[open|close]
Example:
string value = ds9.get(string cmd)
dssstsci name
dssstsci coord
dssstsci size
dssstsci save
dssstsci frame
dssstsci survey
ds9.set(string cmd)
dssstsci
dssstsci m31
dssstsci name m31
dssstsci name clear
dssstsci 00:42:44.404 +41:16:08.78
dssstsci size 60 60 arcmin
dssstsci save yes
dssstsci frame current
dssstsci update frame
dssstsci survey all
dssstsci open
dssstsci close
Load an ENVI header and file. Optional parameter: array endian.
Syntax:
envi [new] <header> [<filename>]
Example:
ds9.set(string cmd)
envi foo.hdr
envi new foo.hdr
envi foo.hdr foo.bsq
exit
quit
Quits DS9.
Syntax:
exit
quit
Example:
ds9.set(string cmd)
exit
Export loaded image data of current frame in specified image format. Optional parameters: array endian, nrrd endian, jpeg quality int(1-100) and tiff compression method.
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>[int(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 foo.bsq little
export tiff foo.tiff jpeg
export jpeg foo.jpeg 75
export png foo.png
Fade mode parameters. Interval is in seconds.
Syntax:
fade []
[yes|no]
[interval <value>]
Example:
string value = ds9.get(string cmd)
fade
fade interval
ds9.set(string cmd)
fade
fade yes
fade interval 2
Query currently loaded file information.
Syntax:
file
Example:
string value = ds9.get(string cmd)
file
Load a FITS image into the current frame or query the currently loaded image.
Syntax:
fits[new|mask|slice] [<filename>]
[width|height|depth|bitpix|type]
[size [wcs|wcsa...wcsz] [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]
[count]
[header [<ext>] [keyword <string>]]
[image|table|slice]
Example:
string value = ds9.get(string cmd)
fits
fits width
fits height
fits depth
fits bitpix
fits size
fits size wcs fk5 arcmin
fits count
fits header # primary
fits header 2 # hdu 2
fits header -2 # hdu 2 with inherit
fits header keyword BITPIX
fits header 1 keyword BITPIX
fits image
fits table
fits slice
ds9.set(string cmd, string url)
fits foo.fits
fits new foo.fits
fits bar.fits[bin=detx,dety]
fits slice foo.fits
fits mask foo.fits
Support for Chandra (CXC) and Hubble Legacy Archive (HLA) footprint servers.
Syntax:
footprint [cxc|hla]
[cancel]
[clear]
[close]
[save <filename>]
[export rdb|tsv <filename>]
[coordinate <ra> <dec> <coordsys>]
[crosshair]
[current <ref>]
[filter <string>]
[filter load <filename>]
[name <object>]
[panto yes|no]
[print]
[regions]
[retrieve]
[show yes|no]
[radius <value> degrees|arcmin|arcsec]
[sky <skyframe>]
[skyformat <skyformat>]
[sort <col> incr|decr]
[system <coordsys>]
[update]
Example:
string value = ds9.get(string cmd)
footprint
ds9.set(string cmd)
footprint cxc
footprint cancel
footprint clear
footprint close
footprint coordinate 202.48 47.21 fk5
footprint crosshair
footprint current cxc
footprint export tsv foo.tsv
footprint filter {$ObsId<10000}
footprint filter load foo.flt
footprint name m51
footprint panto no
footprint print
footprint regions
footprint retrieve
footprint save foo.xml
footprint show yes
footprint radius 1 degrees
footprint sky fk5
footprint skyformat degrees
footprint sort {ObsId} incr
footprint system wcs
footprint update
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.
Syntax:
frame [center [<integer>|all]]
[clear [<integer>|all]]
[new [rgb|3d]]
[delete [<integer>|all]]
[reset [<integer>|all]]
[refresh [<integer>|all]]
[hide [<integer>|all]]
[show [<integer>|all]]
[move first]
[move back]
[move forward]
[move last]
[first|next|prev|last]
[frameno <integer>]
[<integer>]
[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 [<wcssys>]]
[has wcs celestial [<wcssys>]]
[has wcs linear [<wcssys>]]
Example:
string value = ds9.get(string cmd)
frame # returns the id of the current frame
frame frameno # returns the id of the current frame
frame all # returns the id of all frames
frame active # returns the id of all active frames
frame lock
frame has amplifier
frame has datamin
frame has datasec
frame has detector
frame has grid
frame has iis
frame has irafmin
frame has physical
frame has smooth
frame has contour
frame has contour aux
frame has fits
frame has fits bin
frame has fits cube
frame has fits mosaic
frame has marker highlite
frame has marker paste
frame has marker select
frame has marker undo
frame has system physical
frame has wcs wcsa
frame has wcs celestial wcsa
frame has wcs linear wcsa
ds9.set(string cmd)
frame center # center current frame
frame center 1 # center 'Frame1'
frame center all # center all frames
frame clear # clear current frame
frame new # create new frame
frame new rgb # create new rgb frame
frame delete # delete current frame
frame reset # reset current frame
frame refresh # refresh current frame
frame hide # hide current frame
frame show 1 # show frame 'Frame1'
frame move first # move frame to first in order
frame move back # move frame back in order
frame move forward # move frame forward in order
frame move last # move frame to last in order
frame first # goto first frame
frame prev # goto prev frame
frame next # goto next frame
frame last # goto last frame
frame frameno 4 # goto frame 'Frame4', create if needed
frame 3 # goto frame 'Frame3', create if needed
frame match wcs
frame lock wcs
Load GIF image into current frame.
Syntax:
gif [new|slice] [<filename>]
Example:
string value = ds9.get(string cmd)
gif
ds9.set(string cmd)
gif foo.gif
gif new foo.gif
gif slice foo.gif
Controls horizontal and vertical cut graphs.
Syntax:
graph [grid yes|no]
[log yes|no]
[method average|sum]
[font times|helvetica|courier]
[fontsize <value>]
[fontweight normal|bold]
[fontslant roman|italic]
[size <integer>]
[thickness <integer>]
[open|close]
Example:
string value = ds9.get(string cmd)
graph grid
graph log
graph method
graph font
graph fontsize
graph fontweight
graph fontslant
graph size
graph thickness
string value = ds9.get(string cmd)
graph grid yes
graph log no
graph method average
graph font helvetica
graph fontsize 9
graph fontweight normal
graph fontslant roman
graph size 150
graph thickness 1
graph open
graph close
Controls coordinate grid. For grid numeric format syntax, click here.
Syntax:
grid []
[yes|no]
[type analysis|publication]
[system <coordsys>]
[sky <skyframe>]
[skyformat <skyformat>]
[grid yes|no]
[grid color <color>]
[grid width <value>]
[grid dash yes|no]
[grid gap1 <value>]
[grid gap2 <value>]
[grid gap3 <value>]
[axes yes|no]
[axes color <color>]
[axes width <value>]
[axes dash yes|no]
[axes type interior|exterior]
[axes origin lll|llu|lul|luu|ull|ulu|uul|uuu]
[format1 <format>]
[format2 <format>]
[tickmarks yes|no]
[tickmarks color <color>]
[tickmarks width <value>]
[tickmarks dash yes|no]
[border yes|no]
[border color <color>]
[border width <value>]
[border dash yes|no]
[numerics yes|no]
[numerics font times|helvetica|courier]
[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 vertical yes|no]
[title yes|no]
[title text <text>]
[title def yes|no]
[title gap <value>]
[title font times|helvetica|courier]
[title fontsize <value>]
[title fontweight normal|bold]
[title fontslant roman|italic]
[title color <color>]
[labels yes|no]
[labels text1 <text>]
[labels text2 <text>]
[labels def1 yes|no]
[labels def2 yes|no]
[labels gap1 <value>]
[labels gap2 <value>]
[labels font times|helvetica|courier]
[labels fontsize <value>]
[labels fontweight normal|bold]
[labels fontslant roman|italic]
[labels color <color>]
[reset]
[load <filename>]
[save <filename>]
[open|close]
Example:
string value = ds9.get(string cmd)
grid
grid type
grid system
grid sky
grid skyformat
grid grid
grid grid color
grid grid width
grid grid dash
grid grid gap1
grid grid gap2
grid grid gap3
grid axes
grid axes color
grid axes width
grid axes dash
grid axes type
grid axes origin
grid format1
grid format2
grid tickmarks
grid tickmarks color
grid tickmarks width
grid tickmarks dash
grid border
grid border color
grid border width
grid border dash
grid numerics
grid numerics font
grid numerics fontsize
grid numerics fontweight
grid numerics fontslant
grid numerics color
grid numerics gap1
grid numerics gap2
grid numerics gap3
grid numerics type
grid numerics vertical
grid title
grid title text
grid title def
grid title gap
grid title font
grid title fontsize
grid title fontweight
grid title fontslant
grid title color
grid labels
grid labels text1
grid labels text2
grid labels def1
grid labels def2
grid labels gap1
grid labels gap2
grid labels font
grid labels fontsize
grid labels fontweight
grid labels fontslant
grid labels color
ds9.set(string cmd)
grid
grid yes
grid type analysis
grid system wcs
grid sky fk5
grid skyformat degrees
grid grid yes
grid grid color red
grid grid width 2
grid grid dash yes
grid grid gap1 10
grid grid gap2 10
grid grid gap3 10
grid axes yes
grid axes color red
grid axes width 2
grid axes dash yes
grid axes type exterior
grid axes origin lll
grid format1 d.2
grid format2 d.2
grid tickmarks yes
grid tickmarks color red
grid tickmarks width 2
grid tickmarks dash yes
grid border yes
grid border color red
grid border width 2
grid border dash yes
grid numerics yes
grid numerics font courier
grid numerics fontsize 12
grid numerics fontweight bold
grid numerics fontslant italic
grid numerics color red
grid numerics gap1 10
grid numerics gap2 10
grid numerics gap3 10
grid numerics type exterior
grid numerics vertical yes
grid title yes
grid title text {Hello World}
grid title def yes
grid title gap 10
grid title fontsize 12
grid title font courier
grid title fontweight bold
grid title fontslant italic
grid title color red
grid labels yes
grid labels text1 {Hello World}
grid labels text2 {Hello World}
grid labels def1 yes
grid labels def2 yes
grid labels gap1 10
grid labels gap2 10
grid labels font courier
grid labels fontsize 12
grid labels fontweight bold
grid labels fontslant italic
grid labels color red
grid reset
grid load foo.grd
grid save foo.grd
grid open
grid close
Display current fits header dialog. Optional extension number maybe specified. Please note, this differs from samp fits header.
Syntax:
header [<ext>]
[close [<ext>]]
[save [<ext>] <filename>]
Example:
string value = ds9.get(string cmd)
header
header 2
header close
Set the height of the image display window.
Syntax:
height [<value>]
Example:
string value = ds9.get(string cmd)
height
ds9.set(string cmd)
height 512
Toggles iconification.
Syntax:
iconify []
[yes|no]
Example:
string value = ds9.get(string cmd)
iconify
ds9.set(string cmd)
iconify
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 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:
iexam []
[[]|button|key|any] coordinate <coordsys> [<skyframe>] [<skyformat>]
[[]|button|key|any] data [width][height]
[[]|button|key|any] <macro string>]
Example:
string value = ds9.get(string cmd)
iexam
iexam coordinate image
iexam key coordinate image # return coordinate and key event
iexam coordinate wcs fk5 degrees
iexam coordinate wcs galactic sexagesimal
iexam coordinate fk5
iexam data # return data value
iexam key data # return data value and key event
iexam data 3 3 # return all data in 3x3 box about selected point
iexam {'Click at $x,$y in file $filename'}
Set/Get IIS Filename. Optional mosaic number maybe supplied.
Syntax:
iis [filename <filename> [#]]
Example:
string value = ds9.get(string cmd)
iis filename
iis filename 4
ds9.set(string cmd)
iis filename foo.fits
iis filename bar.fits 4
Controls illustrations.
Syntax:
illustrate [<filename>]
[load <filename>]
[save [select|all] <filename>]
[list [select|all]]
[select all|none|invert|front|back]
[move front|back]
[delete [select|all]]
[shape <shape>]
[color <color>]
[fill yes|no]
[width <width>]
[dash yes|no]
[command <region command>]
[copy]
[cut]
[paste]
[undo]
[open|close]
Example:
string value = ds9.get(string cmd)
illustrate
illustrate show
illustrate shape
illustrate color
illustrate fill
illustrate width
illustrate dash
ds9.set(string cmd)
illustrate foo.reg
illustrate load foo.reg # load foo.reg into current frame
illustrate save foo.reg
illustrate save select foo.reg
illustrate list
illustrate list select
illustrate list close
illustrate show yes
illustrate select all
illustrate select none
illustrate select invert
illustrate select front
illustrate select back
illustrate move back
illustrate move front
illustrate delete
illustrate delete select
illustrate color red
illustrate fill yes
illustrate width 3
illustrate dash no
illustrate command "circle 100 100 20 # color=red"
illustrate copy
illustrate cut
illustrate paste
illustrate undo
illustrate open
illustrate close
Load JPEG image into current frame. Optional parameters: jpeg quality (1-100)
Syntax:
jpeg [new|slice] [<filename>] [int(1-100)]
Example:
string value = ds9.get(string cmd)
jpeg
ds9.set(string cmd)
jpeg foo.jpeg
jpeg new foo.jpeg
jpeg slice foo.jpeg
Lock all other frames to the current frame.
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:
string value = ds9.get(string cmd)
lock frame
lock crosshair
lock crop
lock slice
lock bin
lock axes
lock scale
lock scalelimits
lock colorbar
lock block
lock smooth
lock 3d
ds9.set(string cmd)
lock frame wcs
lock crosshair wcs
lock crop wcs
lock slice wcs
lock bin yes
lock axes yes
lock scale yes
lock scalelimits yes
lock colorbar yes
lock block yes
lock smooth yes
lock 3d yes
lowerLower in the window stacking order.
Syntax:
lower
Example:
ds9.set(string cmd)
lower
Controls the magnifier settings.
Syntax:
magnifier [color <color>]
[zoom <value>]
[cursor yes|no]
[region yes|no]
Example:
string value = ds9.get(string cmd)
magnifier color
magnifier zoom
magnifier cursor
magnifier region
ds9.set(string cmd)
magnifier color yellow
magnifier zoom 2
magnifier cursor no
magnifier region no
Controls mask parameters.
Syntax:
mask [color <color>]
[mark zero|nonzero|nan|nonnan|range]
[range <low> <high>]
[transparency <value>]
[blend source|screen|darken|lighten]
[system <coordsys>]
[clear]
[load <filename>]
[open|close]
Example:
string value = ds9.get(string cmd)
mask color
mask mark
mask range
mask transparency
mask blend
mask system
ds9.set(string cmd)
mask color red
mask mark zero
mask range 10 100
mask transparency 50
mask blend source
mask system wcs
mask clear
mask load foo.fits
mask open
mask close
Match all other frames to the current frame.
Syntax:
match[frame <coordsys>]
[crosshair <coordsys>]
[crop <coordsys>]
[slice <coordsys>]
[bin]
[axes]
[scale]
[scalelimits]
[colorbar]
[block]
[smooth]
[3d]
Example:
ds9.set(string cmd)
match frame wcs
match crosshair wcs
match crop wcs
match slice wcs
match bin
match axes
match scale
match scalelimits
match colorbar
match block
match smooth
match 3d
Load FITS multiple extension file as data cube.
Syntax:
mecube [new] [<filename>]
Example:
string value = ds9.get(string cmd)
mecube
ds9.set(string cmd)
mecube foo.fits
mecube new foo.fits
This is how DS9 determines the min and max data values from the data. SCAN will scan all data.
Syntax:
minmax [scan|sample|datamin|irafmin]
[mode scan|sample|datamin|irafmin]
[interval #]
[rescan]
Example:
string value = ds9.get(string cmd)
minmax mode
minmax sample
ds9.set(string cmd)
minmax scan
minmax mode scan
minmax interval 100
minmax rescan
Controls the first mouse button mode.
Syntax:
mode [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine|3d]
Example:
string value = ds9.get(string cmd)
mode
ds9.set(string cmd)
mode crosshair
Load FITS mosaic segment into current frame.
Syntax:
mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>]
Example:
string value = ds9.get(string cmd)
mosaic
ds9.set(string cmd)
mosaic foo.fits
mosaic wcs foo.fits
mosaic wcs new foo.fits
mosaic wcs mask foo.fits
Load FITS mosaic image into current frame.
Syntax:
mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] [<filename>]
Example:
string value = ds9.get(string cmd)
mosaicimage
ds9.set(string cmd)
mosaicimage foo.fits
mosaicimage wcs foo.fits
mosaicimage wcs new foo.fits
mosaicimage wcs mask foo.fits
Create a 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 action is slice. Movie types are either MPEG or Animated GIF, with default MPEG. Optional parameters for 3d: number of frames, azimuth from/to, elevation from/to, slice from/to, oscillate/repeat times.
Syntax:
movie [slice|frame] [mpeg|gif <delay> blink|fade] <filename>
movie 3d [mpeg|gif <delay>] <filename> [number|az from|az to|el from|el to|slice from|slice to|oscillate|repeat <#>]
Example:
ds9.set(string cmd)
movie slice mpeg ds9.mpg
movie frame gif ds9.gif
movie frame gif 100 fade ds9.gif
movie 3d mpeg ds9.mpg number 10 az from -60 az to 60 oscillate 1
Load FITS multiple extension file as multiple images.
Syntax:
multiframe [<filename>]
Example:
ds9.set(string cmd)
multiframe foo.fits
Support Name Server functions. Coordinates are in fk5.
Syntax:
nameserver [<object>]
[name <object>]
[server ned-sao|ned-cds|simbad-sao|simbad-cds|vizier-sao|vizier-cds]
[skyformat degrees|sexagesimal]
[pan]
[crosshair]
[close]
Example:
string value = ds9.get(string cmd)
nameserver
nameserver server
nameserver skyformat
nameserver m31
ds9.set(string cmd)
nameserver m31
nameserver name m31
nameserver server ned-sao
nameserver skyformat sexagesimal
nameserver pan
nameserver crosshair
nameserver open
nameserver close
Display Notebook.
Syntax:
notes [<string>]
[append <string>]
[insert <string>]
[clear]
[load <filename>]
[save <filename>]
[open|close]
Example:
string value = ds9.get(string cmd)
notes
ds9.set(string cmd, string url)
notes {Hello World}
notes append {Hello World}
notes insert {Hello World}
notes clear
notes load foo.txt
notes save foo.txt
notes open
notes close
Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: array endian.
Syntax:
nrrd [native|little|big]
nrrd [new|mask] [<filename>]
Example:
string value = ds9.get(string cmd)
nrrd
nrrd big
ds9.set(string cmd, string url)
nrrd foo.nrrd
nrrd new foo.nrrd
nrrd mask foo.nrrd
Support for NRAO VLA Sky Survey.
Syntax:
nvss []
[<object>]
[name <object>|clear]
[<ra> <dec>] # in wcs fk5
[size <width> <height> degrees|arcmin|arcsec]
[save yes|no]
[frame new|current]
[update frame|crosshair]
[open|close]
Example:
string value = ds9.get(string cmd)
nvss name
nvss coord
nvss size
nvss save
nvss frame
ds9.set(string cmd)
nvss
nvss m31
nvss name m31
nvss name clear
nvss 00:42:44.404 +41:16:08.78
nvss size 60 60 arcmin
nvss save yes
nvss frame current
nvss update frame
nvss open
nvss close
Controls the orientation of the current frame.
Syntax:
orient [none|x|y|xy]
[open|close]
Example:
string value = ds9.get(string cmd)
orient
ds9.set(string cmd)
orient xy
orient open
orient close
Controls Page Setup options.
Syntax:
pagesetup [orient portrait|landscape]
[scale <numeric>]
[size letter|legal|tabloid|poster|a4]
Example:
string value = ds9.get(string cmd)
pagesetup orient
pagesetup scale
pagesetup size
ds9.set(string cmd)
pagesetup orient portrait
pagesetup scale 50
pagesetup size poster
Controls the current image cursor location for the current frame.
Syntax:
pan [<coordsys> [<skyframe>] [<skyformat>]] # get current coords
pan [<x> <y> <coordsys> [<skyframe>]] # relative
[to <x> <y> <coordsys> [<skyframe>]] # absolute
[open|close]
[close]
Example:
string value = ds9.get(string cmd)
pan # get current image coords
pan wcs fk4 sexagesimal # get current wcs coords
ds9.set(string cmd)
pan 200 200 image # pan relative
pan to 400 400 physical # pan to physical coords
pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords
pan open
pan close
Display/Hide the pixel table.
Syntax:
pixeltable []
[yes|open]
[no|close]
Example:
string url = ds9.get(string cmd)
pixeltable
ds9.set(string cmd)
pixeltable
pixeltable yes
pixeltable open
pixeltable close
Display and configure data plots. 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:
xy x and y coordinatesSyntax:
xyex x,y coordinates with x errors
xyey x,y coordinates with y errors
xyexey x,y coordinates with x and y errors
# create new empty plot window
plot [line|bar [<ref>]]
[line|bar [<ref>] <title> <xaxis label> <yaxis label> xy|xyex|xyey|xyexey]
# create new plot from data file
plot [line|bar <filename> [<ref>] xy|xyex|xyey|xyexey]
[line|bar <filename> [<ref>] <title> <xaxis lable> <yaxis lable> xy|xyex|xyey|xyexey]
# existing plot
plot [gui]
[load <filename> xy|xyex|xyey|xyexey]
[save <filename>]
[current <ref>]
[layout grid|row|column|strip]
[layout strip scale <percent>]
[add graph line|bar]
[current graph <graph>]
[delete graph]
[current dataset <dataset>]
[delete dataset]
[duplicate]
[stats yes|no]
[list yes|no]
[backup <filename>]
[restore <filename>]
[pagesetup orient portrait|landscape]
[pagesetup size letter|legal|tabloid|poster|a4]
[print]
[print destination printer|file]
[print command <command>]
[print filename <filename>]
[print color rgb|gray]
[close]
[mode pointer|zoom]
# export
plot [export <filename>]
[export eps|gif|tiff|jpeg|png <filename>]
[export jpeg <filename> [int(1-100)]]
[export tiff <filename> none|jpeg|packbits|deflate]]
# configure graph
plot [axis x|y grid yes|no]
[axis x|y log yes|no]
[axis x|y flip yes|no]
[axis x|y auto yes|no]
[axis x|y min <value>]
[axis x|y max <value>]
[axis x|y format <string>]
[background <value>]
[legend yes|no]
[legend position right|left|top|bottom|plotarea]
[font title|labels|numbers font times|helvetica|courier]
[font title|labels|numbers size <value>]
[font title|labels|numbers weight normal|bold]
[font title|labels|numbers slant roman|italic]
[title <string>]
[title x|y <string>]
# dataset
plot [show yes|no]
[name <string>]
# line dataset
plot [line smooth step|linear|cubic|quadratic|catrom]
[line color <value>]
[line width <value>]
[line dash yes|no]
[line fill yes|no]
[line fill color <value>]
[line shape symbol none|circle|square|diamond|plus|splus|scross|triangle|arrow]
[line shape size <size>]
[line shape color <value>]
[line shape fill yes|no]
# bar dataset
plot [bar border color <value>]
[bar border width <value>]
[bar fill yes|no]
[bar color <value>]
[bar width <value>]
# error bar
plot [error yes|no]
[error color <value>]
[error cap yes|no]
[error width <value>]
Example:
# return all plotnames
string value = ds9.get(string cmd)
plot
# create new empty plot window
ds9.set(string cmd)
plot line
plot bar
# create new plot from data file
ds9.set(string cmd)
plot line xy.dat xy
plot line xy.dat {The Title} {X Axis} {Y Axis} xy
# existing plot
string value = ds9.get(string cmd)
plot layout
plot layout strip scale
plot current
plot current graph
plot current dataset
plot stats
plot list
plot mode
ds9.set(string cmd)
plot gui
plot load xy.dat xy
plot save foo.dat
plot current foo
plot layout strip
plot layout strip scale 30
plot add graph bar
plot current graph 1
plot delete graph
plot current dataset 1
plot delete dataset
plot duplicate
plot stats yes
plot list yes
plot backup foo.bck
plot restore foo.bck
plot pagesetup orient portrait
plot pagesetup size letter
plot print
plot print destination file
plot print command lp
plot print filename foo.ps
plot print color rgb
plot close
plot mode pointer
# export plot
ds9.set(string cmd)
plot export tiff foo.tiff jpeg
plot export jpeg foo.jpeg 75
plot export png foo.png
# configure graph
string value = ds9.get(string cmd)
plot axis x grid
plot axis x log
plot axis x flip
plot axis x auto
plot axis x min
plot axis x max
plot axis x format
plot background
plot legend
plot legend position
plot font numbers font
plot font numbers size
plot font numbers weight
plot font numbers slant
plot title
plot title xaxis
plot title yaxis
ds9.set(string cmd)
plot axis x grid yes
plot axis x log yes
plot axis x flip yes
plot axis x auto no
plot axis x min 1
plot axis x max 100
plot axis x format {%f}
plot background white
plot legend yes
plot legend position left
plot font numbers font times
plot font numbers size 12
plot font numbers weight bold
plot font numbers slant italic
plot title {This is a Title}
plot title x {X Axis}
plot title y {Y Axis}
plot title legend {This is the Legend}
# configure current dataset
string value = ds9.get(string cmd)
plot show
plot name
ds9.set(string cmd)
plot show yes
plot name {My Data}
# line dataset
string value = ds9.get(string cmd)
plot line smooth
plot line color
plot line width
plot line dash
plot line fill
plot line fill color
plot line shape symbol
plot line shape size
plot line shape color
plot line shape fill
ds9.set(string cmd)
plot line smooth step
plot line color red
plot line width 2
plot line dash yes
plot line fill no
plot line fill color red
plot line shape symbol circle
plot line shape size 5
plot line shape color cyan
plot line shape fill no
# bar dataset
string value = ds9.get(string cmd)
plot bar border color
plot bar border width
plot bar fill
plot bar color
plot bar width
ds9.set(string cmd)
plot bar border color red
plot bar border width 2
plot bar fill no
plot bar color red
plot bar width 10
string value = ds9.get(string cmd)
plot error
plot error color
plot error cap
plot error width
ds9.set(string cmd)
plot error yes
plot error color red
plot error cap yes
plot error width 2
pngLoad PNG image into current frame.
Syntax:
png [new|slice] [<filename>]
Example:
string value = ds9.get(string cmd)
png
ds9.set(string cmd)
png foo.png
png new foo.png
png slice foo.png
Controls various preference settings.
Syntax:
prefs [open]
[save]
[clear]
[close]
[bg color yes|no]
[bg color <color>]
[nan color <color>]
[precision <linear> <degree> <hms> <dms> <len linear> <len degree> <len arcmin> <len arcsec> <angle>]
[theme <theme>]
[threads <numeric>]
[irafalign yes|no]
Example:
string value = ds9.get(string cmd)
prefs has bg color
prefs bg color
prefs nan color
prefs precision
prefs theme
prefs threads
prefs irafalign
ds9.set(string cmd)
prefs open
prefs save
prefs clear
prefs close
prefs bg color no
prefs bg color red
prefs nan color blue
prefs precision 8 7 4 3 8 7 5 3 8
prefs theme radiance
prefs threads 8
prefs iraf yes
Preserve the follow attributes while loading a new image.
Syntax:
preserve [pan yes|no]
[regions yes|no]
Example:
string value = ds9.get(string cmd)
preserve pan
preserve regions
ds9.set(string cmd)
preserve pan yes
preserve regions yes
Invokes postscript printing. Please see print for further details.
Controls printing. Use print option to set printing options.
Syntax:
print [destination printer|file]
[command <command>]
[filename <filename>]
[color rgb|cmyk|gray]
[level 1|2|3]
[resolution72|screen|96|144|150|225|300|600|1200]
Example:
string value = ds9.get(string cmd)
print destination
print command
print filename
print color
print level
print resolution
ds9.set(string cmd)
print destination file
print command lp
print filename foo.ps
print color cmyk
print level 2
print resolution 96
Invoke FITS analysis tool.
Syntax:
prism []
[open]
[<filename>]
[load <filename>]
[import xml|rdb|tsv <filename>]
[export xml|rdb|tsv <filename>]
[clear]
[current <ref>]
[ext <int>|<extname>]
[first|next|previous|last]
[goto <int>]
[image]
[mode newplot|newgraph|overplot]
[histogram <col> <numbins> <min> <max>]
[plot <colx> <coly> [<colerrx>] [<colerry>] xy|xyex|xyey|xyexey]
Example:
string value = ds9.get(string cmd)
prism
ds9.set(string cmd)
prism
prism open
prism foo.fits
prism load bar.fits
prism import tsv bar.tsv
prism clear
prism current prism2
prism ext 2
prism ext STDEVT
prism first
prism next
prism goto 20345
prism image
prism mode newplot
prism histogram RAWX 40
prism histogram RAWX 40 0 100
prism plot RAWX RAWY xy
prism plot RAWX RAWY PHA xyex
prism plot RAWX RAWY PHA PHI xyexey
Raise in the window stacking order.
Syntax:
raise
Example:
ds9.set(string cmd)
raiseControls regions in the current frame.
Syntax:
region [<filename>]
[load [all] <filename>]
[save [select] <filename>]
[list [close|select]]
[epsilon <integer>]
[show yes|no]
[showtext yes|no]
[centroid]
[centroid auto yes|no]
[centroid radius <value>|iteration <value>]
[move front|back]
[select all|none|invert|front|back]
[delete [select]]
[delete load <filename>]
[format ds9|xml|ciao|saotng|saoimage|pros|xy]
[system image|physical|wcs|wcsa...wcsz]
[sky fk4|fk5|icrs|galactic|ecliptic]
[skyformat degrees|sexagesimal]
[strip yes|no]
[shape <shape>]
[color <color>]
[fill yes|no]
[width <width>]
[dash yes|no]
[font times|helvetica|courier]
[fontsize <value>]
[fontweight normal|bold]
[fontslant roman|italic]
[fixed|edit|rotate|delete yes|no]
[command <marker command>]
[analysis histogram|panda|plot2d|plot3d|radial|stats [open|close|save]]
[composite]
[dissolve]
[template <filename>]
[template <filename> at <ra> <dec> <coordsys> <skyframe>]
[savetemplate <filename>]
[group new]
[group <tag> new]
[group <tag> update]
[group <tag> select]
[group <tag> color <color>]
[group <tag> copy]
[group <tag> delete]
[group <tag> cut]
[group <tag> font <font>]
[group <tag> move <int> <int>]
[group <tag> movefront]
[group <tag> moveback]
[group <tag> property <property> yes|no]
[copy]
[cut]
[paste image|physical|wcs|wcsa...wcsz]
[undo]
[open|close]
[include|exclude|source|background|selected]
[groups]
[-format ds9|ciao|saotng|saoimage|pros|xy]
[-system image|physical|wcs|wcsa...wcsz]
[-sky fk4|fk5|icrs|galactic|ecliptic]
[-skyformat degrees|sexagesimal]
[-prop select|edit|move|rotate|delete|fixed|include|source 1|0]
[-group <tag>]
[-strip yes|no]
[-wcs yes|no]
Example:
string url = ds9.get(string cmd)
region
region -format ds9 -system wcs -sky fk5 -skyformat sexagesimal -prop edit 1 -group foo
string value = ds9.get(string cmd)
region epsilon
region show
region showtext
region centroid
region centroid auto
region centroid radius
region centroid iteration
region format
region system
region sky
region skyformat
region strip
region shape
region color
region fill
region width
region dash
region font
region fontsize
region fontweight
region fontslant
region source
region background
region include
region exclude
region selected
region groups
ds9.set(string cmd)
region foo.reg
region -format ciao bar.reg # load as ciao format
region foo.fits # FITS region files do not need a format specification
region load foo.reg # load foo.reg into current frame
region load all foo.reg # load foo.reg into all frames
region load *.reg# expand *.reg and load into current frame
region load all *.reg # expand *.reg and load into all frames
region save foo.reg
region save select foo.reg
region list
region list select
region list close
region epsilon 5
region show yes
region showtext no
region centroid
region centroid auto yes
region centroid radius 10
region centroid iteration 20
region info
region move back
region move front
region select all
region select none
region select invert
region select front
region select back
region delete
region delete select
region delete load foo.reg
region format ds9
region system wcs
region sky fk5
region skyformat degrees
region strip yes
region shape ellipse
region color red
region fill yes
region width 3
region dash yes
region font times
region fontsize 24
region fontweight bold
region fontslant italic
region edit yes
region include
region command "circle 100 100 20 # color=red"
region analysis stats region analysis stats close region analysis histograme save region composite
region dissolve
region template foo.tpl
region template foo.tpl at 13:29:55.92 +47:12:48.02 fk5
region savetemplate foo.tpl
region group new
region group foo new
region group foo update
region group foo select
region group foo color red
region group foo copy
region group foo delete
region group foo cut
region group foo font 'times 14 bold'
region group foo move 100 100
region group foo movefront
region group foo moveback
region group foo property delete no
region copy
region cut
region paste wcs
region undo
Restore DS9 to a previous state from a backup save set.
Syntax:
restore <filename>
Example:
restore ds9.bck
Create RGB frame and control RGB frame parameters.
Syntax:
rgb []
[red|green|blue]
[channel [red|green|blue]]
[view [red|green|blue] [yes|no]]
[system <coordsys>]
[lock wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth [yes|no]]
[open|close]
Example:
string value = ds9.get(string cmd)
rgb channel
rgb lock wcs
rgb lock crop
rgb lock slice
rgb lock bin
rgb lock scale
rgb lock scalelimits
rgb lock colorbar
rgb lock block
rgb lock smooth
rgb system
rgb view red
rgb view green
rgb view blue
ds9.set(string cmd)
rgb # create new rgb frame
rgb red # set current channel to red
rgb channel red # set current channel to red
rgb view blue no # turn off blue channel
rgb system wcs # set rgb coordinate system
rgb lock wcs yes
rgb lock crop yes
rgb lock slice yes
rgb lock bin yes
rgb lock scale yes
rgb lock scalelimits yes
rgb lock colorbar yes
rgb lock block yes
rgb lock smooth yes
rgb open
rgb close
Load raw data array cube into rgb frame.
Syntax:
rgbarray [native|big|little]
rgbarray [new] [[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]]
Example:
string value = ds9.get(string cmd)
rgbarray
ds9.set(string cmd)
rgbarray foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]
rgbarray new foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]
Load FITS rgbcube into rgb frame.
Syntax:
rgbcube [new] [<filename>]
Example:
string value = ds9.get(string cmd)
rgbcube
ds9.set(string cmd)
rgbcube foo.fits
rgbcube new foo.fits
Load FITS rgbimage into rgb frame.
Syntax:
rgbimage [new] [<filename>]
Example:
string value = ds9.get(string cmd)
rgbimage
ds9.set(string cmd)
rgbimage foo.fits
rgbimage new foo.fits
Controls the rotation angle (in degrees) of the current frame.
Syntax:
rotate [<value>]
[to <value>]
[open|close]
Example:
string value = ds9.get(string cmd)
rotate
ds9.set(string cmd)
rotate 45
rotate to 30
rotate open
rotate close
Configure SAMP protocol.
Syntax:
samp [connect|disconnect]
[connect|disconnect]
[broadcast [image|table]]
[send [image|table] <application>]
[hub [start|stop|info]]
Example:
string value = ds9.get(string cmd)
samp
ds9.set(string cmd)
samp no
samp disconnect
samp broadcast
samp broadcast table
samp send topcat
samp send table topcat
samp hub info
Save loaded image data of current frame as FITS.
Syntax:
save[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] <filename> [image|table|slice]
Example:
ds9.set(string cmd)
save foo.fits
save fits foo.fits image
save fits foo.fits table
save fits foo.fits slice
save rgbimage foo.fits
save rgbcube foo.fits
save mecube foo.fits
save mosaic foo.fits
save mosaicimage foo.fits
Create a snap shot of the current DS9 window and save in specified image format. If no format specified, the file name extension is used to determine the output format. Optional parameters: jpeg quality int(1-100) and tiff compression method.
Syntax:
saveimage[fits|eps|gif|tiff|jpeg|png]<filename>
saveimage <filename>.jpeg [int(1-100)]
saveimage <filename>.tiff [none|jpeg|packbits|deflate]
Example:
ds9.set(string cmd)
saveimage ds9.tiff
saveimage jpeg ds9.jpeg 75
Controls the limits and color scale distribution.
Syntax:
scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]
[log exp <value>]
[datasec yes|no]
[limits <minvalue> <maxvalue>]
[mode minmax|<value>|zscale|zmax]
[scope local|global]
[match]
[match limits]
[lock [yes|no]]
[lock limits [yes|no]]
[open|close]
Example:
string value = ds9.get(string cmd)
scale
scale log exp
scale datasec
scale limits
scale mode
scale scope
scale lock
scale lock limits
ds9.set(string cmd)
scale linear
scale log exp 100
scale datasec yes
scale histequ
scale limits 1 100
scale mode zscale
scale mode 99.5
scale scope local
scale match
scale match limits
scale lock yes
scale lock limits yes
scale open
scale close
Load a shared memory segment into the current frame.
Syntax:
shm [<key> [<filename>]]
[key <key> [<filename>]]
[shmid <id> [<filename>]]
[fits [key|shmid] <id> [<filename>]]
[mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] [key|shmid] <id> [<filename>]]
[mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] <id> [<filename>]]
[rgbcube [key|shmid] <id> [<filename>]
[rgbimage [key|shmid] <id> [<filename>]]
[rgbarray [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]]
[array [key|shmid] <id> [xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]]
Example:
string value = ds9.get(string cmd)
shm
ds9.set(string cmd)
shm 102
shm key 102
shm shmid 102 foo
shm fits key 100 foo
shm mosaicimage iraf key 100 foo
shm mosaicimage wcs key 100 foo
shm mosaicimage wcsa key 100 foo
shm mosaicimage wfpc2 key 100 foo
shm mosaic iraf key 100 foo
shm mosaic wcs key 100 foo
shm rgbcube key 100 foo
shm rgbimage key 100 foo
shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32]
shm array shmid 102 [dim=32,bitpix=-32]
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 via current command.
Syntax:
sia[2mass|akari|astrowise|cadc|cxc|hla|mast|sdss|skyview|tgssadr]
[cancel]
[clear]
[close]
[save <filename>]
[export rdb|tsv <filename>]
[coordinate <ra> <dec> <coordsys>]
[crosshair]
[current <ref>]
[name <object>]
[print]
[retrieve]
[radius <value> degrees|arcmin|arcsec]
[sky <skyframe>]
[skyformat <skyformat>]
[system <coordsys>]
[update]
Example:
string value = ds9.get(string cmd)
sia
ds9.set(string cmd)
sia 2mass
sia cancel
sia clear
sia close
sia coordinate 202.48 47.21 fk5
sia crosshair
sia current 2mass
sia export tsv bar.tsv
sia name m51
sia print
sia retrieve
sia save foo.xml
sia radius 1degrees
sia sky fk5
sia skyformat degrees
sia system wcs
sia update
Select Single Display mode
Syntax:
single
Example:
string value = ds9.get(string cmd)
single
ds9.set(string cmd)
single
Support for SkyView image server at HEASARC.
Syntax:
skyview []
[<object>]
[name <object>|clear]
[<ra> <dec>] # in wcs fk5
[size <width> <height> degrees|arcmin|arcsec]
[pixels <width> <height>]
[save yes|no]
[frame new|current]
[update frame|crosshair]
[survey <survey>]
[open|close]
Example:
string value = ds9.get(string cmd)
skyview name
skyview coord
skyview size
skyview pixels
skyview save
skyview frame
skyview survey
ds9.set(string cmd)
skyview
skyview m31
skyview name m31
skyview name clear
skyview 00:42:44.404 +41:16:08.78
skyview size 60 60 arcmin
skyview pixels 600 600
skyview save yes
skyview frame current
skyview update frame
skyview survey sdssi
skyview open
skyview close
Delays execution for specified number of seconds. Default is 1 second.
Syntax:
sleep [#]
Example:
ds9.set(string cmd)
sleep
sleep 2
Smooth current image or set smooth parameters.
Boxcar width =2*radius+1
smooth []
Tophat diameter =2*radius+1
Gaussian diameter =2*radius+1,mean=0
Elliptical Gaussian diameter =2*radius+1,mean=0Syntax:
[yes|no]
[function boxcar|tophat|gaussian]
[radius <value>]
[radiusminor <value>]
[sigma <value>]
[sigmaminor <value>]
[angle <value>]
[match]
[lock [yes|no]]
[open|close]
Example:
string value = ds9.get(string cmd)
smooth
smooth function
smooth radius
smooth radiusminor
smooth sigma
smooth sigmaminor
smooth angle
smooth lock
ds9.set(string cmd)
smooth
smooth yes
smooth function tophat
smooth radius 4
smooth radiusminor 4
smooth sigma 2.0
smooth sigmaminor 2.0
smooth angle 45
smooth match
smooth lock yes
smooth open
smooth close
Source TCL code from a file.
Syntax:
source [filename]
Example:
ds9.set(string cmd)
source foo.tcl
Execute one TCL command.
Syntax:
tcl <tcl command>
Example:
ds9.set(string cmd)
tcl {puts {Hello, World}}
Load TIFF image into current frame. Optional parameters: tiff compression method.
Syntax:
tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate]
Example:
string value = ds9.get(string cmd)
tiff
tiff jpeg
ds9.set(string cmd)
tiff foo.tiff
tiff new foo.tiff
tiff slice foo.tiff
Controls the tile display mode.
Syntax:
tile []
[yes|no]
[mode grid|column|row]
[grid]
[grid mode automatic|manual]
[grid direction x|y]
[grid layout <col> <row>]
[grid gap <pixels>]
[row]
[column]
Example:
string value = ds9.get(string cmd)
tile
tile mode
tile grid mode
tile grid direction
tile grid layout
tile grid gap
ds9.set(string cmd)
tile
tile yes
tile mode row
tile grid
tile grid mode manual
tile grid direction x
tile grid layout 5 5
tile grid gap 10
tile row
tile columnUpdates the current frame or region of frame. In the second 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.
Syntax:
update []
[# x1 y1 x2 y2]
[now]
[now # x1 y1 x2 y2]
Example:
ds9.set(string cmd)
update
update 1 100 100 300 400
update now
update now 1 100 100 300 400
Load FITS from URL into the current frame
Syntax:
url <url>
Example:
ds9.set(string cmd)
url http://foo.bar.edu/foo.fitsReturns the current version of DS9.
Syntax:
version
Example:
string value = ds9.get(string cmd)
versionControls the GUI.
Syntax:
view [layout horizontal|vertical|basic|advanced]
[multi yes|no]
[keyvalue <string>]
[info yes|no]
[panner yes|no]
[magnifier yes|no]
[buttons yes|no]
[icons yes|no]
[colorbar yes|no]
[graph horizontal|vertical yes|no]
[filename yes|no[
[object yes|no]
[keyword yes|no]
[minmax yes|no]
[lowhigh yes|no]
[units yes|no]
[image|physical|wcs|wcsa...wcsz yes|no]
[frame yes|no]
[red yes|no]
[green yes|no]
[blue yes|no]
Example:
string value = ds9.get(string cmd)
view layout
view multi
view keyvalue
view info
view panner
view magnifier
view buttons
view icons
view colorbar
view graph horizontal
view filename
view object
view keyword
view minmax
view lowhigh
view units
view image
view wcsa
view frame
view red
ds9.set(string cmd)
view layout vertical
view multi yes
view keyvalue BITPIX
view info yes
view panner yes
view magnifier yes
view buttons yes
view icons yes
view colorbar yes
view graph horizontal yes
view filename yes
view object yes
view keyword yes
view minmax yes
view lowhigh yes
view units yes
view wcsa yes
view frame yes
view red yes
view green yes
view blue yes
Support for VLA Sky Survey.
Syntax:
vla []
[<object>]
[name <object>|clear]
[<ra> <dec>] # in wcs fk5
[size <width> <height> degrees|arcmin|arcsec]
[save yes|no]
[frame new|current]
[update frame|crosshair]
[survey first|stripe82]
[open|close]
Example:
string value = ds9.get(string cmd)
vla name
vla coord
vla size
vla save
vla frame
vla survey
ds9.set(string cmd)
vla
vla m31
vla name m31
vla name clear
vla 00:42:44.404 +41:16:08.78
vla size 60 60 arcmin
vla save yes
vla frame current
vla update frame
vla survey stripe82
vla open
vla close
Support for NRAO VLSS Sky Survey.
Syntax:
vlss []
[<object>]
[name <object>|clear]
[<ra> <dec>] # in wcs fk5
[size <width> <height> degrees|arcmin|arcsec]
[save yes|no]
[frame new|current]
[update frame|crosshair]
[open|close]
Example:
string value = ds9.get(string cmd)
vlss name
vlss coord
vlss size
vlss save
vlss frame
ds9.set(string cmd)
vlss
vlss m31
vlss name m31
vlss name clear
vlss 00:42:44.404 +41:16:08.78
vlss size 60 60 arcmin
vlss save yes
vlss frame current
vlss update frame
vlss open
vlss close
Invoke an connection to a Virtual Observatory site.
Syntax:
vo [method xpa|mime]
[server <url>]
[internal yes|no]
[delay #]
[<url>]
[connect <url>]
[disconnect <url>]
[open|close]
Example:
string value = ds9.get(string cmd)
vo
vo method
vo server
vo internal
vo delay
vo connect
ds9.set(string cmd)
vo method xpa
vo server "http://foo.bar.edu/list.txt"
vo internal yes
vo delay 15
vo chandra-ed
vo connect chandra-ed
vo disconnect chandra-ed
vo open
vo close
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.
Syntax:
wcs [[system] wcs|wcsa...wcsz]
[[sky] fk4|fk5|icrs|galactic|ecliptic]
[[skyformat] degrees|sexagesimal]
[align yes|no]
[reset]
[load <filename>]
[save [<ext>] <filename>]
[open|close]
Example:
string value = ds9.get(string cmd)
wcs
wcs system
wcs sky
wcs skyformat
wcs align
ds9.set(string cmd)
wcs wcs
wcs system wcs
wcs fk5
wcs sky fk5
wcs sexagesimal
wcs skyformat sexagesimal
wcs align yes
wcs reset
wcs load foo.wcs
wcs save foo.wcs
wcs save 1 foo.wcs
wcs open
wcs close
Display specified URL in the web display.
Syntax:
web []
[<url>]
[new <webname> <url>]
[<webname>] [click back|forward|stop|reload|#]
[<webname>] [clear]
[<webname>] [close]
Example:
string value = ds9.get(string cmd)
web
ds9.set(string cmd)
web www.cnn.com
web new www.cnn.com
web hvweb www.apple.com
web click back
web click 2
web clear
web close
Set the width of the image display window.
Syntax:
width [<value>]
Example:
string value = ds9.get(string cmd)
width
ds9.set(string cmd)
width 512
Configure XPA.
Syntax:
xpa [connect|disconnect]
[info]
Example:
string value = ds9.get(string cmd)
xpa connect
xpa info
ds9.set(string cmd)
xpa connect
xpa disconnect
xpa info
Set Scale Limits based on the IRAF algorithm.
Syntax:
zscale []
[contrast]
[sample]
[line]
Example:
string value = ds9.get(string cmd)
zscale contrast
zscale sample
zscale line
ds9.set(string cmd)
zscale
zscale contrast .25
zscale sample 600
zscale line 120
Controls the current zoom value for the current frame.
Syntax:
zoom [<value>]
[<value> <value>]
[to <value>]
[to <value> <value>]
[in]
[out]
[to fit]
[open|close]
Example:
string value = ds9.get(string cmd)
zoom
ds9.set(string cmd)
zoom 2
zoom 2 4
zoom to 4
zoom to 2 4
zoom in
zoom out
zoom to fit
zoom open
zoom close