diff options
Diffstat (limited to 'ds9/doc/ref/samp.html')
| -rw-r--r-- | ds9/doc/ref/samp.html | 11659 |
1 files changed, 3149 insertions, 8510 deletions
diff --git a/ds9/doc/ref/samp.html b/ds9/doc/ref/samp.html index 5bceb87..a6e0f65 100644 --- a/ds9/doc/ref/samp.html +++ b/ds9/doc/ref/samp.html @@ -1,8520 +1,3159 @@ -<!DOCTYPE doctype PUBLIC "-//w3c//dtd html 4.0 transitional//en"> +<!DOCTYPE doctype PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html> - <head> - <meta http-equiv="Content-Type" content="text/html; - charset=windows-1252"> - <meta name="GENERATOR" content="Mozilla/4.78 [en] (X11; U; Linux - 2.4.7-10 i686) [Netscape]"> - <title>SAMP</title> - </head> - <body vlink="#551a8b" link="#0000ff" alink="#ff0000"> - <h3><img alt="" src="../sun.gif" width="100" height="98" - align="middle"> SAMP</h3> - <blockquote> - <p>SAMP 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 <a - href="http://www.ivoa.net/Documents/latest/SAMP.html">here</a>.</p> - <p>The samp implementation for DS9 is based on the <a - href="xpa.html">XPA</a> model with 2 private calls:</p> - <tt> ds9.get<br> - Arguments<br> - cmd (string) required<br> - url (string) optional<br> - Returned value<br> - OK (samp.result map)<br> - value - (string) optional<br> - - url (string) optional<br> - ERROR (samp.error map)<br> - - samp.errortxt (string)<br> - <br> - ds9.set<br> - Arguments<br> - cmd (string) required<br> - url (string) optional<br> - Returned value<br> - OK<br> - ERROR (samp.error map)<br> - - samp.errortxt (string)<br> - </tt> - <p><tt>ds9.set</tt> maybe called via notification, call and - call/wait. <tt>ds9.get</tt> can only be called via call and - call/wait. Most of the <tt>ds9.get</tt> calls return a value - string, but a few will return a url instead.</p> - <tt> <a href="#2mass">2mass</a><br> - <a href="#3d">3d</a><br> - <a href="#about">about</a><br> - <a href="#analysis">analysis</a><br> - <a href="#array">array</a><br> - <a href="#background">background</a><br> - <a href="#backup">backup</a><br> - <a href="#bin">bin</a><br> - <a href="#blink">blink</a><br> - <a href="#block">block</a><br> - <a href="#catalog">catalog</a><br> - <a href="#cd">cd</a><br> - <a href="#cmap">cmap</a><br> - <a href="#colorbar">colorbar</a><br> - <a href="#console">console</a><br> - <a href="#contour">contour</a><br> - <a href="#crop">crop</a><br> - <a href="#crosshair">crosshair</a><br> - <a href="#cube">cube</a><br> - <a href="#cursor">cursor</a><br> - <a href="#data">data</a><br> - <a href="#dsssao">dsssao</a><br> - <a href="#dsseso">dsseso</a><br> - <a href="#dssstsci">dssstsci</a><br> - <a href="#envi">envi</a><br> - <a href="#exit">exit</a><br> - <a href="#export">export</a><br> - <a href="#file">file</a><br> - <a href="#fits">fits</a><br> - <a href="#frame">frame</a><br> - <a href="#gif">gif</a><br> - <a href="#grid">grid</a><br> - <a href="#header">header</a><br> - <a href="#height">height</a><br> - <a href="#iconify">iconify</a><br> - </tt><tt><tt><a href="#iexam">iexam</a><br> - </tt><a href="#iis">iis</a><br> - <a href="#jpeg">jpeg</a><br> - <a href="#lock">lock</a><br> - <a href="#lower">lower</a><br> - <a href="#magnifier">magnifier</a><br> - <a href="#mask">mask</a><br> - <a href="#match">match</a><br> - <a href="#mecube">mecube</a><br> - <a href="#minmax">minmax</a><br> - <a href="#mode">mode</a><br> - <a href="#mosaic">mosaic</a><br> - <a href="#mosaicimage">mosaicimage</a><br> - <a href="#movie">movie</a><br> - <a href="#multiframe">multiframe</a><br> - <a href="#nameserver">nameserver</a><br> - <a href="#nan">nan</a><br> - <a href="#nrrd">nrrd</a><br> - <a href="#nvss">nvss</a><br> - <a href="#orient">orient</a><br> - <a href="#pagesetup">pagesetup</a><br> - <a href="#pan">pan</a><br> - <a href="#pixeltable">pixeltable</a><br> - <a href="#plot">plot</a><br> - <a href="#png">png</a><br> - <a href="#precision">precision</a><br> - <a href="#prefs">prefs</a><br> - <a href="#preserve">preserve</a><br> - <a href="#psprint">psprint</a><br> - <a href="#print">print</a><br> - <a href="#exit">quit</a><br> - <a href="#raise">raise</a><br> - <a href="#regions">regions</a><br> - <a href="#restore">restore</a><br> - <a href="#rgb">rgb</a><br> - <a href="#rgbarray">rgbarray</a><br> - <a href="#rgbcube">rgbcube</a><br> - <a href="#rgbimage">rgbimage</a><br> - <a href="#rotate">rotate</a><br> - <a href="#samp">samp</a><br> - <a href="#save">save</a><br> - <a href="#saveimage">saveimage</a><br> - <a href="#scale">scale</a><br> - <a href="#shm">shm</a><br> - </tt><tt><tt><a href="#sia">sia</a><br> - </tt><a href="#single">single</a><br> - <a href="#skyview">skyview</a><br> - <a href="#sleep">sleep</a><br> - <a href="#smooth">smooth</a><br> - <a href="#source">source</a><br> - <a href="#tcl">tcl</a><br> - <a href="#threads">threads</a><br> - <a href="#tiff">tiff</a><br> - <a href="#tile">tile</a><br> - <a href="#update">update</a><br> - <a href="#url">url</a><br> - <a href="#version">version</a><br> - <a href="#view">view</a><br> - <a href="#vla">vla</a></tt><br> - <tt><tt><a href="#vlss">vlss</a><br> - </tt> <a href="#vo">vo</a><br> - <a href="#wcs">wcs</a><br> - <a href="#web">web</a><br> - <a href="#width">width</a><br> - <a href="#zscale">zscale</a><br> - <a href="#zoom">zoom</a><br> - </tt> - <p><b> <a name="2mass"></a>2mass</b></p> - <p>Support for 2MASS Digital Sky Survey.</p> - <tt> Syntax: <br> - 2mass []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs - fk5<br> - [size <width> - <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey j|h|k]<br> - [open|close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - 2mass name <br> - 2mass coord <br> - 2mass size<br> - 2mass save<br> - 2mass frame<br> - 2mass survey <br> - ds9.set(string cmd)<br> - 2mass<br> - 2mass m31 <br> - </tt><tt><tt>2mass name m31 <br> - </tt></tt><tt><tt><tt>2mass name clear<br> - </tt></tt>2mass 00:42:44.404 +41:16:08.78<br> - 2mass size 60 60 arcmin<br> - 2mass save yes<br> - 2mass frame current<br> - 2mass update frame<br> - 2mass survey j<br> - 2mass open<br> - 2mass close<br> - </tt> - <p><b> <a name="3d"></a>3d</b></p> - <p>Support for 3D frame.</p> - <tt> Syntax: <br> - </tt><tt>3d []<br> - [view <az> <el>]<br> - [az <az>]<br> - [el <el>]<br> - [scale <scale>]<br> - [method mip|aip]</tt><br> - <tt><tt> [background none|azimuth|elevation]<br> - </tt> </tt><tt> [border yes|no]<br> - [border color <color>]<br> - </tt><tt> [highlite yes|no]<br> - [hightlite color <color>]<br> - </tt><tt><tt> </tt><tt> [compass yes|no]<br> - [compass color <color>]</tt></tt><br> - <tt><tt><tt><tt><tt> [match]<br> - [lock [yes|no]]<br> - </tt></tt></tt> </tt> [open|close]</tt><tt><br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - </tt><tt>3d view<br> - 3d az<br> - 3d el<br> - 3d scale<br> - 3d method</tt><br> - <tt>3d background<br> - </tt><tt>3d border<br> - 3d border color<br> - </tt> <tt> </tt><tt>3d highlite<br> - 3d highlite color<br> - </tt> <tt><tt>3d compass<br> - 3d compass color<br> - 3d lock<br> - </tt> <tt> </tt>ds9.set(string cmd)<br> - </tt><tt>3d # create new 3D frame<br> - 3d view 45 30<br> - 3d az 45<br> - 3d el 30<br> - 3d scale 10<br> - 3d method mip</tt><br> - <tt>3d background azimuth<br> - </tt><tt>3d border yes<br> - 3d border color red<br> - </tt><tt>3d highlite yes<br> - 3d highlite color red<br> - </tt><tt><tt>3d compass yes<br> - 3d compass color red<br> - 3d match<br> - 3d lock yes<br> - </tt>3d open<br> - 3d close</tt><br> - <p><b><a name="about"></a>about</b></p> - <p>Get DS9 credits.</p> - <tt> Syntax: <br> - about <br> - <br> - Example:<br> - string value = ds9.get(string cmd) <br> - about<br> - </tt> - <p><b> <a name="align"></a>align</b></p> - <p>Controls the World Coordinate System alignment for the current - frame.</p> - <tt> Syntax: <br> - align []<br> - [yes|no]<br> - <br> - Example: <br> - </tt><tt><tt>string value = ds9.get(string cmd) <br> - </tt>align<br> - </tt><tt><tt>ds9.set(string cmd)<br> - </tt>align yes</tt><br> - <p><b> <a name="analysis"></a>analysis</b></p> - <p>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. </p> - <tt> Syntax: <br> - analysis [<task number>]<br> - - [<filename>]<br> - [task <task - number>|<task name>]<br> - [load - <filename>]<br> - [clear]<br> - [clear][load - <filename>]<br> - [message - ok|okcancel|yesno <message>]<br> - [entry - <message>]<br> - [text]</tt><tt><tt><tt><tt><tt><br> - </tt></tt> </tt></tt> <br> - Example:<br> - string value = ds9.get(string cmd) <br> - analysis<br> - analysis task<br> - analysis entry {Please enter something}<br> - analysis entry okcancel {Hello World}<br> - ds9.set(string cmd)<br> - analysis 0 # invoke first analysis task<br> - analysis task 0<br> - analysis task foobar<br> - analysis task {foo bar}<br> - analysis my.ans<br> - analysis load my.ans <br> - analysis clear <br> - analysis clear load my.ans<br> - analysis message {This is a message}<br> - analysis text {this is text}</tt><tt><tt><br> - </tt> ds9.set(string cmd, string url)<br> - analysis load <br> - analysis text</tt><b><br> - </b> - <p><b> <a name="array"></a>array</b></p> - <p>Load raw data array into current frame.<br> - </p> - <tt> Syntax:<br> - array [native|little|big]<br> - array [new|mask] +<head> +<meta name="generator" content= +"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 15.18.1), see www.w3.org"> +<meta http-equiv="Content-Type" content= +"text/html; charset=us-ascii"> +<meta name="GENERATOR" content= +"Mozilla/4.78 [en] (X11; U; Linux 2.4.7-10 i686) [Netscape]"> +<title>SAMP</title> +</head> +<body vlink="#551A8B" link="#0000FF" alink="#FF0000"> +<h3><img alt="" src="../sun.gif" width="100" height="98" align= +"middle"> SAMP</h3> +<blockquote> +<p>SAMP 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 +<a href= +"http://www.ivoa.net/Documents/latest/SAMP.html">here</a>.</p> +<p>The samp implementation for DS9 is based on the <a href= +"xpa.html">XPA</a> model with 2 private calls:</p> +<tt>ds9.get<br> + Arguments<br> + cmd (string) required<br> + url (string) optional<br> + Returned value<br> + OK (samp.result map)<br> + value +(string) optional<br> + + url (string) optional<br> + ERROR (samp.error map)<br> + +samp.errortxt (string)<br> + <br> +ds9.set<br> + Arguments<br> + cmd (string) required<br> + url (string) optional<br> + Returned value<br> + OK<br> + ERROR (samp.error map)<br> + +samp.errortxt (string)<br></tt> +<p><tt>ds9.set</tt> maybe called via notification, call and +call/wait. <tt>ds9.get</tt> can only be called via call and +call/wait. Most of the <tt>ds9.get</tt> calls return a value +string, but a few will return a url instead.</p> +<tt><a href="#2mass">2mass</a><br> +<a href="#3d">3d</a><br> +<a href="#about">about</a><br> +<a href="#analysis">analysis</a><br> +<a href="#array">array</a><br> +<a href="#background">background</a><br> +<a href="#backup">backup</a><br> +<a href="#bin">bin</a><br> +<a href="#blink">blink</a><br> +<a href="#block">block</a><br> +<a href="#catalog">catalog</a><br> +<a href="#cd">cd</a><br> +<a href="#cmap">cmap</a><br> +<a href="#colorbar">colorbar</a><br> +<a href="#console">console</a><br> +<a href="#contour">contour</a><br> +<a href="#crop">crop</a><br> +<a href="#crosshair">crosshair</a><br> +<a href="#cube">cube</a><br> +<a href="#cursor">cursor</a><br> +<a href="#data">data</a><br> +<a href="#dsssao">dsssao</a><br> +<a href="#dsseso">dsseso</a><br> +<a href="#dssstsci">dssstsci</a><br> +<a href="#envi">envi</a><br> +<a href="#exit">exit</a><br> +<a href="#export">export</a><br> +<a href="#file">file</a><br> +<a href="#fits">fits</a><br> +<a href="#frame">frame</a><br> +<a href="#gif">gif</a><br> +<a href="#grid">grid</a><br> +<a href="#header">header</a><br> +<a href="#height">height</a><br> +<a href="#iconify">iconify</a><br></tt> <tt><tt><a href= +"#iexam">iexam</a><br></tt> <a href="#iis">iis</a><br> +<a href="#jpeg">jpeg</a><br> +<a href="#lock">lock</a><br> +<a href="#lower">lower</a><br> +<a href="#magnifier">magnifier</a><br> +<a href="#mask">mask</a><br> +<a href="#match">match</a><br> +<a href="#mecube">mecube</a><br> +<a href="#minmax">minmax</a><br> +<a href="#mode">mode</a><br> +<a href="#mosaic">mosaic</a><br> +<a href="#mosaicimage">mosaicimage</a><br> +<a href="#movie">movie</a><br> +<a href="#multiframe">multiframe</a><br> +<a href="#nameserver">nameserver</a><br> +<a href="#nan">nan</a><br> +<a href="#nrrd">nrrd</a><br> +<a href="#nvss">nvss</a><br> +<a href="#orient">orient</a><br> +<a href="#pagesetup">pagesetup</a><br> +<a href="#pan">pan</a><br> +<a href="#pixeltable">pixeltable</a><br> +<a href="#plot">plot</a><br> +<a href="#png">png</a><br> +<a href="#precision">precision</a><br> +<a href="#prefs">prefs</a><br> +<a href="#preserve">preserve</a><br> +<a href="#psprint">psprint</a><br> +<a href="#print">print</a><br> +<a href="#exit">quit</a><br> +<a href="#raise">raise</a><br> +<a href="#regions">regions</a><br> +<a href="#restore">restore</a><br> +<a href="#rgb">rgb</a><br> +<a href="#rgbarray">rgbarray</a><br> +<a href="#rgbcube">rgbcube</a><br> +<a href="#rgbimage">rgbimage</a><br> +<a href="#rotate">rotate</a><br> +<a href="#samp">samp</a><br> +<a href="#save">save</a><br> +<a href="#saveimage">saveimage</a><br> +<a href="#scale">scale</a><br> +<a href="#shm">shm</a><br></tt> <tt><tt><a href= +"#sia">sia</a><br></tt> <a href="#single">single</a><br> +<a href="#skyview">skyview</a><br> +<a href="#sleep">sleep</a><br> +<a href="#smooth">smooth</a><br> +<a href="#source">source</a><br> +<a href="#tcl">tcl</a><br> +<a href="#threads">threads</a><br> +<a href="#tiff">tiff</a><br> +<a href="#tile">tile</a><br> +<a href="#update">update</a><br> +<a href="#url">url</a><br> +<a href="#version">version</a><br> +<a href="#view">view</a><br> +<a href="#vla">vla</a></tt><br> +<tt><tt><a href="#vlss">vlss</a><br></tt> <a href="#vo">vo</a><br> +<a href="#wcs">wcs</a><br> +<a href="#web">web</a><br> +<a href="#width">width</a><br> +<a href="#zscale">zscale</a><br> +<a href="#zoom">zoom</a><br></tt> +<p><b><a name="2mass"></a>2mass</b></p> +<p>Support for 2MASS Digital Sky Survey.</p> +<tt>Syntax:<br> +2mass []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs +fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey j|h|k]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +2mass name<br> +2mass coord<br> +2mass size<br> +2mass save<br> +2mass frame<br> +2mass survey<br> +ds9.set(string cmd)<br> +2mass<br> +2mass m31<br></tt> <tt><tt>2mass name m31<br></tt></tt> +<tt><tt><tt>2mass name clear<br></tt></tt> 2mass 00:42:44.404 ++41:16:08.78<br> +2mass size 60 60 arcmin<br> +2mass save yes<br> +2mass frame current<br> +2mass update frame<br> +2mass survey j<br> +2mass open<br> +2mass close<br></tt> +<p><b><a name="3d"></a>3d</b></p> +<p>Support for 3D frame.</p> +<tt>Syntax:<br></tt> <tt>3d []<br> + [view <az> <el>]<br> + [az <az>]<br> + [el <el>]<br> + [scale <scale>]<br> + [method mip|aip]</tt><br> +<tt><tt> [background none|azimuth|elevation]<br></tt> + </tt><tt> [border yes|no]<br> + [border color <color>]<br></tt> <tt> +[highlite yes|no]<br> + [hightlite color <color>]<br></tt> +<tt><tt> </tt><tt> [compass yes|no]<br> + [compass color <color>]</tt></tt><br> +<tt><tt><tt><tt><tt> [match]<br> + [lock [yes|no]]<br></tt></tt></tt></tt> +[open|close]</tt><tt><br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br></tt> <tt>3d view<br> +3d az<br> +3d el<br> +3d scale<br> +3d method</tt><br> +<tt>3d background<br></tt> <tt>3d border<br> +3d border color<br></tt> <tt>3d highlite<br> +3d highlite color<br></tt> <tt><tt>3d compass<br> +3d compass color<br> +3d lock<br></tt> ds9.set(string cmd)<br></tt> <tt>3d # create new +3D frame<br> +3d view 45 30<br> +3d az 45<br> +3d el 30<br> +3d scale 10<br> +3d method mip</tt><br> +<tt>3d background azimuth<br></tt> <tt>3d border yes<br> +3d border color red<br></tt> <tt>3d highlite yes<br> +3d highlite color red<br></tt> <tt><tt>3d compass yes<br> +3d compass color red<br> +3d match<br> +3d lock yes<br></tt> 3d open<br> +3d close</tt><br> +<p><b><a name="about" id="about"></a>about</b></p> +<p>Get DS9 credits.</p> +<tt>Syntax:<br> +about<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +about<br></tt> +<p><b><a name="align" id="align"></a>align</b></p> +<p>Controls the World Coordinate System alignment for the current +frame.</p> +<tt>Syntax:<br> +align []<br> + [yes|no]<br> + <br> +Example:<br></tt> <tt><tt>string value = ds9.get(string +cmd)<br></tt> align<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> +align yes</tt><br> +<p><b><a name="analysis" id="analysis"></a>analysis</b></p> +<p>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.</p> +<tt>Syntax:<br> +analysis [<task number>]<br> + +[<filename>]<br> + [task <task +number>|<task name>]<br> + [load +<filename>]<br> + [clear]<br> + [clear][load +<filename>]<br> + [message +ok|okcancel|yesno <message>]<br> + [entry +<message>]<br> + +[text]</tt><tt><tt><tt><tt><tt><br></tt></tt> </tt></tt><br> +Example:<br> +string value = ds9.get(string cmd)<br> +analysis<br> +analysis task<br> +analysis entry {Please enter something}<br> +analysis entry okcancel {Hello World}<br> +ds9.set(string cmd)<br> +analysis 0 # invoke first analysis task<br> +analysis task 0<br> +analysis task foobar<br> +analysis task {foo bar}<br> +analysis my.ans<br> +analysis load my.ans<br> +analysis clear<br> +analysis clear load my.ans<br> +analysis message {This is a message}<br> +analysis text {this is text}</tt><tt><tt><br></tt> ds9.set(string +cmd, string url)<br> +analysis load<br> +analysis text</tt><b><br></b> +<p><b><a name="array" id="array"></a>array</b></p> +<p>Load raw data array into current frame.<br></p> +<tt>Syntax:<br> +array [native|little|big]<br> +array [new|mask] [[xdim=<x>,ydim=<y>|dim=<dim>],zdim=<z>,bitpix=<b>,skip=<s>,endian=[little|big]]<br> - <br> - Example: <br> - </tt><tt><tt>string url = ds9.get(string cmd)<br> - </tt>array<br> - array little<br> - </tt><tt><tt>ds9.set(string command, string url)<br> - </tt>array foo.arr[dim=512,bitpix=-32,endian=little]<br> - array new foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> - <tt><tt>array mask foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><tt><br> - </tt> - <p><b> <a name="background"></a>bg<br> - background</b></p> - <p>Set image background color. </p> - <tt> Syntax: <br> - bg <color><br> - <br> - Example:<br> - </tt><tt>string url = ds9.get(string cmd)</tt><tt><br> - bg<br> - </tt><tt>ds9.set(string cmd)<br> - </tt><tt>bg red</tt><tt><br> - <tt>bg red</tt></tt><br> - <p><b> <a name="backup"></a>backup</b></p> - <p>Create a backup save set. </p> - <tt> Syntax: <br> - backup <filename><br> - <br> - Example:<br> - </tt><tt>ds9.set(string cmd)<br> - </tt><tt>backup ds9.bck</tt><br> - <p><b> <a name="bin"></a>bin</b></p> - <p>Controls binning factor, binning buffer size, and binning - function for binning FITS bin tables. The access point blocking - is provided for backward compatibility. </p> - <tt> Syntax: <br> - bin [about <x> <y>]<br> - [about center]<br> - [buffersize <value>] <br> - [cols <x> <y>]<br> - [colsz <x> <y> <z>]<br> - [factor <value> [<vector>]]<br> - [depth <value>] <br> - [filter <string>] <br> - </tt><tt><tt> [filter clear] <br> - </tt> [function average|sum] <br> - [in]<br> - [out]<br> - [to fit] <br> - [match]<br> - [lock [yes|no]]<br> - [open|close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd) <br> - bin about<br> - bin buffersize<br> - bin cols<br> - bin factor<br> - bin depth<br> - bin filter<br> - bin function<br> - bin smooth<br> - bin smooth function<br> - bin smooth radius<br> - bin lock<br> - ds9.set(string cmd)<br> - bin about 4096 4096<br> - bin about center<br> - bin buffersize 512<br> - bin cols detx dety<br> - bin colsz detx dety time<br> - bin factor 4<br> - bin factor 4 2<br> - bin depth 10<br> - bin filter 'pha > 5'<br> - bin filter clear<br> - bin function sum<br> - bin in<br> - bin out<br> - bin to fit<br> - bin match<br> - bin lock yes<br> - bin open<br> - bin close<br> - </tt> - <p><b> <a name="blink"></a>blink</b></p> - <p>Blink mode parameters. Interval is in seconds. <br> - </p> - <tt> Syntax: <br> - blink []<br> - [yes|no]<br> - [interval <value>]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - blink<br> - blink interval<br> - ds9.set(string cmd)<br> - blink<br> - blink yes<br> - blink interval 1</tt><br> - <p><b> <a name="block"></a>block</b></p> - <p>Controls blocking parameters. </p> - <tt> Syntax: <br> - block</tt><tt><tt> [<value>] <br> - [<value> <value>]<br> - [to <value>] <br> - [to <value> - <value>]<br> - [in]<br> - [out]<br> - </tt> [to fit] <br> - [match]<br> - [lock [yes|no]]<br> - [open|close]<br> - <br> - Example: <br> - </tt><tt><tt>string value = ds9.get(string cmd)<br> - </tt>block<br> - block lock<br> - </tt><tt><tt>ds9.set(string cmd)<br> - </tt></tt><tt><tt><tt>block</tt></tt> 4<br> - </tt><tt><tt><tt>block</tt></tt> 4 2<br> - </tt><tt><tt><tt><tt><tt>block</tt></tt> to 4<br> - </tt><tt><tt><tt>block</tt></tt> to 4 2<br> - </tt></tt><tt><tt><tt>block</tt></tt> in<br> - </tt></tt><tt><tt><tt><tt><tt>block</tt></tt> out<br> - </tt></tt></tt><tt><tt><tt>block</tt></tt> to fit<br> - </tt><tt><tt><tt>block</tt></tt> match<br> - </tt><tt><tt><tt>block</tt></tt> lock yes<br> - </tt><tt><tt><tt>block</tt></tt> open<br> - </tt><tt><tt><tt>block</tt></tt> close</tt><tt><br> - </tt> - <p><b> <a name="catalog"></a>catalog<br> - cat<br> - </b></p> - <p>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.</p> - <tt> Syntax:<br> - </tt><tt>catalog [new]<br> - - [ned|simbad|denis|skybot]<br> - </tt><tt><tt> - [aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|</tt><tt>sdss7|sdss8|</tt><tt>sdss9|tycho]<br> - [</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br> - </tt></tt><tt> - [2mass|iras]<br> - [csc|xmm|rosat]<br> - [first|nvss]<br> - - [chandralog|cfhtlog|esolog|stlog|xmmlog]<br> - [cds <catalogname>]<br> - [cds - <catalogid>]<br> - <br> - [load <filename>]<br> - [import sb|tsv - <filename>]<br> - <br> - </tt><tt><tt> [<ref>] - [<ra> <dec> <coordsys>]</tt><tt><br> - </tt> [<ref>] [allcols]<br> - </tt><tt> </tt><tt> - [<ref>] [allrows]<br> - </tt><tt> [<ref>] - [cancel]<br> - </tt><tt> [<ref>] - [clear]<br> - </tt><tt> [<ref>] [close]</tt><br> - <tt> </tt><tt>[<ref>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [crosshair]</tt><br> - <tt> [<ref>] [dec - <col>]</tt><br> - <tt> [<ref>] [edit - yes|no]</tt><br> - <tt> [<ref>] - [export sb|tsv <filename>]<br> - </tt><tt> [<ref>] - [filter <string>]<br> - [<ref>] [filter load - <filename>]</tt><br> - <tt> [<ref>] - [header]</tt><br> - <tt> [<ref>] [location - <code>]</tt><br> - <tt><tt> [<ref>] - [match]<br> - </tt></tt><tt><tt><tt> - [<ref>] [match <ref> <ref>]<br> - </tt></tt> </tt><tt>[<ref>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [match error <value> degrees|arcmin|arcsec]</tt><br> - <tt> </tt><tt>[<ref>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [match function 1and2|1not2|2not1]<br> - </tt><tt> </tt><tt>[<ref>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [match return 1and2|1only|2only]</tt><br> - <tt> </tt><tt>[<ref>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [match unique yes|no]</tt><br> - <tt> [<ref>] [maxrows - <number>]</tt><br> - <tt> [<ref>] [name - <object>]<br> - </tt><tt> [<ref>] - [panto yes|no]</tt><br> - <tt> [<ref>] [plot - <xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> - <tt> [<ref>] [print]</tt><br> - <tt> [<ref>] [psky - <skyframe>]</tt><br> - <tt> [<ref>] [psystem - <coordsys>]</tt><br> - <tt> [<ref>] [ra - <col>]</tt><br> - <tt> [<ref>] [regions]</tt><br> - <tt> </tt><tt><tt> - [<ref>] [retrieve]</tt><br> - <tt> </tt> [<ref>] - [samp]<br> - [<ref>] [samp - broadcast]<br> - [<ref>] [samp - send <application>]</tt><tt><br> - </tt><tt> [<ref>] - [save <filename>]</tt><br> - <tt> [<ref>] - [server </tt><tt><tt>cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt></tt><br> - <tt> [<ref>] [show - yes|no]</tt><br> - <tt> [<ref>] [radius - <value> degrees|arcmin|arcsec]</tt><br> - <tt> </tt><tt> [<ref>] - [sky <skyframe>]<br> - </tt><tt> [<ref>] - [skyformat <skyformat>]<br> - </tt><tt> [<ref>] [sort - <col> incr|decr]</tt><br> - <tt> [<ref>] [symbol - [#] - condition|shape|color|text|font|fontsize|fontweight|fontslant - <value>] <br> - </tt><tt> [<ref>] - [symbol [#] text|size|size2|units|angle <value>] <br> - </tt><tt><tt> [<ref>] - [symbol shape circle|ellipse|box|text|point]<br> - </tt></tt><tt><tt><tt><tt>[<ref>] - - - - - - - - - - - - - - - [symbol shape </tt></tt></tt></tt><tt><tt><tt><tt><tt><tt>circle - - - - - - - - - - - - - - point|box point|diamond point|</tt></tt></tt></tt>cross - - - - - - - - - - - - - - point|x point|arrow point|boxcircle point]<br> - </tt> [<ref>] - [symbol add| [#] remove]<br> - [<ref>] [symbol - save|load <filename>]</tt><br> - <tt> [<ref>] [system - <coordsys>]</tt><tt><br> - </tt><tt> </tt><tt>[<ref>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [update]</tt><br> - <tt> [<ref>] [x - <col>]</tt><br> - <tt> [<ref>] [y - <col>]</tt><br> - <tt> <br> - Example:<br> - string value = ds9.get(string cmd) <br> - catalog<br> - catalog header<br> - <br> - ds9.set(string cmd)<br> - </tt><tt><tt>catalog new<br> - </tt>catalog 2mass<br> - catalog cds 2mass<br> - catalog cds </tt><tt>{I/252}</tt><br> - <tt> <br> - </tt><tt>catalog load foo.xml<br> - catalog import tsv foo.tsv<br> - <br> - </tt><tt>catalog allrows<br> - catalog allcols<br> - </tt><tt>catalog cancel<br> - </tt><tt>catalog clear<br> - </tt><tt>catalog close<br> - </tt><tt>catalog coordinate 202.48 47.21 fk5<br> - </tt><tt>catalog crosshair<br> - </tt><tt>catalog dec DEC<br> - </tt><tt>catalog edit yes<br> - </tt><tt>catalog export tsv bar.tsv<br> - </tt><tt>catalog filter {$Jmag>10}<br> - catalog filter load foo.flt<br> - catalog header<br> - </tt><tt>catalog location 500</tt><br> - <tt>catalog match error 2 arcsec<br> - catalog match function 1and2<br> - catalog match unique no<br> - catalog match return 1only<br> - </tt><tt>catalog match # last two catalogs loaded<br> - </tt><tt>catalog match 2mass csc<br> - </tt><tt>catalog maxrows 2000<br> - </tt><tt>catalog name m51<br> - catalog panto no<br> - </tt><tt>catalog plot </tt><tt>{$Jmag} {$Hmag} {$e_Jmag} - {$e_Hmag}</tt><tt><br> - </tt><tt>catalog print</tt><br> - <tt>catalog psky fk5</tt><br> - <tt>catalog psystem wcs</tt><br> - <tt>catalog ra RA</tt><br> - <tt>catalog regions<br> - </tt><tt>catalog retrieve<br> - </tt><tt> </tt><tt>catalog samp broadcast<br> - catalog samp send aladin<br> - catalog save foo.xml<br> - </tt><tt>catalog server sao<br> - </tt><tt>catalog show yes</tt><br> - <tt> catalog radius 1 degrees</tt><br> - <tt>catalog symbol condition </tt><tt>{$Jmag>15}</tt><br> - <tt> catalog symbol 2 shape </tt><tt>{boxcircle point}</tt><br> - <tt> catalog symbol color red<br> - catalog symbol font times<br> - </tt><tt>catalog symbol fontsize 14<br> - </tt><tt>catalog symbol fontweight bold<br> - </tt><tt>catalog symbol fontslant italic<br> - </tt><tt>catalog symbol add<br> - catalog symbol 2 remove<br> - catalog symbol load foo.sym<br> - catalog symbol save bar.sym</tt><tt><br> - catalog sky fk5<br> - catalog skyformat degrees<br> - </tt><tt>catalog sort {Jmag} incr<br> - </tt><tt>catalog system wcs</tt><tt><br> - </tt><tt>catalog update<br> - </tt><tt>catalog x RA<br> - catalog y DEC</tt><br> - <p><b><a name="cd"></a>cd</b></p> - <p>Sets/Returns the current working directory. </p> - <tt> Syntax: <br> - cd [<directory>] <br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - cd<br> - ds9.set(string cmd)<br> - cd /home/mrbill<br> - </tt> - <p><b> <a name="cmap"></a>cmap</b></p> - <p>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. </p> - <tt> Syntax: <br> - cmap [<colormap>] <br> - [file]<br> - [load <filename>] <br> - [save <filename>]<br> - [invert yes|no] <br> - [<constrast> <bias>] <br> - </tt><tt> [tag [load|save] - <filename>]<br> - [tag delete]</tt><br> - <tt> [open|close]<br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - cmap <br> - cmap file <br> - cmap invert <br> - cmap value <br> - </tt><tt>cmap lock</tt><br> - <tt> ds9.set(string cmd)<br> - cmap Heat <br> - cmap load foo.sao <br> - cmap save bar.sao<br> - cmap invert yes <br> - cmap 5 .5<br> - </tt><tt>cmap tag load foo.tag<br> - cmap tag save foo.tag<br> - cmap tag delete</tt><br> - <tt>cmap open<br> - cmap close<br> - </tt> - <p><b><a name="colorbar"></a>colorbar</b></p> - <p>Controls colorbar parameters.</p> - <tt> Syntax: <br> - colorbar []<br> - [yes|no]<br> - [orientation]<br> - - [horizontal|vertical]<br> - [numerics - yes|no]<br> - [space - value|distance] <br> - [font - times|helvetica|courier]<br> - [fontsize - <value>]<br> - [fontweight - normal|bold]<br> - [fontslant - roman|italic]<br> - [size]<br> - [ticks]</tt><br> - <tt><tt> [match]<br> - [lock - [yes|no]]</tt><br> - <tt> </tt> <br> - Example:<br> - string value = ds9.get(string cmd)<br> - colorbar<br> - colorbar orientation<br> - colorbar numerics<br> - colorbar space<br> - colorbar font<br> - colorbar fontsize<br> - colorbar fontweight<br> - colorbar fontslant<br> - colorbar size<br> - colorbar ticks<br> - ds9.set(string cmd)<br> - colorbar yes<br> - colorbar vertical<br> - colorbar numerics yes<br> - colorbar space value<br> - colorbar font times<br> - colorbar fontsize 14<br> - colorbar fontwieght bold<br> - colorbar fontslant italic<br> - colorbar size 20<br> - colorbar ticks 11</tt><br> - <tt>colorbar match<br> - colorbar lock yes</tt><br> - <tt> </tt> - <p><b> <a name="console"></a>console</b></p> - <p>Display tcl console window.</p> - <tt> Syntax: <br> - -console<br> - <br> - Example:<br> - ds9.set(string cmd)<br> - console<br> - </tt> - <p><b> <a name="contour"></a>contour</b></p> - <p>Controls contours in the current frame. </p> - <tt> Syntax: <br> - contour []<br> - [yes|no]<br> - [<coordsys> - [<skyframe>]]<br> - [clear]<br> - [generate]<br> - [load - <filename>]<br> - [save <filename> - [<coordsys> <skyframe>]]<br> - [convert]<br> - </tt><tt><tt> [load - levels <filename>]<br> - </tt></tt><tt><tt><tt> - [save levels <filename>]<br> - </tt></tt> [copy]<br> - [paste - [<coordsys> <color> <width> yes|no]]<br> - [color <color>]<br> - [width <width>]<br> - [dash yes|no]<br> - [smooth <smooth>]<br> - [method block|smooth]<br> - [nlevels <number of - levels>]<br> - [scale - linear|log|pow|squared|sqrt|asinh|sinh|histequ]<br> - ]scale log exp - <value>]<br> - [mode - minmax|<value>|zscale|zmax]<br> - [scope global|local]<br> - [limits <min> - <max>]<br> - [levels <value - value value...>] <br> - [open|close]<br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - contour<br> - contour color<br> - contour width<br> - contour dash<br> - contour smooth<br> - contour method<br> - contour nlevels<br> - contour scale<br> - contour log exp<br> - contour mode<br> - contour scope<br> - contour limits<br> - contour levels<br> - string url = ds9.get(string cmd)<br> - contour wcs fk5<br> - ds9.set(string cmd)<br> - contour<br> - contour yes<br> - contour clear<br> - contour generate<br> - contour load ds9.ctr<br> - </tt><tt><tt>contour save ds9.con<br> - </tt></tt><tt><tt><tt>contour save ds9.con wcs fk5<br> - </tt></tt>contour convert<br> - </tt><tt><tt>contour load levels ds9.ctr<br> - </tt></tt><tt><tt><tt>contour save levels ds9.lev<br> - </tt></tt>contour copy<br> - </tt><tt><tt>contour paste<br> - </tt></tt><tt><tt><tt>contour paste wcs red 2 no<br> - </tt></tt>contour color yellow<br> - contour width 2<br> - contour dash yes<br> - contour smooth 5<br> - contour method smooth<br> - contour nlevels 10<br> - contour scale sqrt<br> - contour log exp 1000<br> - contour mode zscale<br> - contour scope local<br> - contour limits 1 100<br> - contour levels {1 10 100 1000}<br> - contour open<br> - contour close<br> - </tt> - <p><b><a name="crop"></a>crop</b> </p> - <p>Set current image display area. </p> - <tt> Syntax: <br> - crop [<x> <y> <width> <height> - [<coordsys>][<skyframe>][degrees|arcmin|arcsec]<br> - </tt><tt> [match <coordsys>]<br> - [lock <coordsys>|none]</tt><tt><br> - [reset]<br> - [3d </tt><tt><tt>zmin zmax - <coordsys>]<br> - [open|close]</tt><br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - </tt><tt>crop # get crop in physical coords <br> - </tt><tt>crop wcs galactic sexagesimal arcsec<br> - crop lock<br> - </tt><tt>ds9.set(string cmd)</tt><br> - <tt> crop 40 30 10 20 # set crop in physical coords<br> - crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs - galactic arcsec<br> - crop match wcs<br> - crop lock wcs<br> - crop reset<br> - crop 3d .25 .5 wcs<br> - crop open<br> - crop close<br> - </tt> - <p><b> <a name="crosshair"></a>crosshair</b></p> - <p>Controls the current position of the crosshair in the current - frame. DS9 is placed in crosshair mode when the crosshair is - set. </p> - <tt> Syntax: <br> - crosshair [<x> <y> <coordsys> - [<skyframe>]] <br> - </tt><tt> - [match <coordsys>]<br> - [lock - <coordsys>|none]</tt><br> - <tt> <br> - Example:<br> - string value = ds9.get(string cmd)<br> - crosshair # get crosshair in physical coords <br> - crosshair wcs fk4 sexagesimal # get crosshair in wcs coords <br> - crosshair lock<br> - ds9.set(string cmd)<br> - crosshair 100 100 physical # set crosshair in physical <br> - crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords <br> - crosshair 23:01:00 +58:52:51 wcs fk5<br> - crosshair match wcs<br> - crosshair lock wcs<br> - </tt> - <p><b><a name="cube"></a>cube<br> - </b></p> - <p>Controls FITS cube. </p> - <tt> Syntax: <br> - cube []<br> - [play|stop|next|prev|first|last]<br> - [<slice> - [<coordsys>][<axis>]]<br> - [interval <numeric>]<br> - </tt><tt> [match <coordsys>]<br> - [lock <coordsys>|none]</tt><br> - <tt> [order 123|132|213|231|312|321]<br> - [axes lock [yes|no]]</tt><br> - <tt> [open|close]<br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - cube<br> - cube interval<br> - cube lock<br> - cube order<br> - cube axes lock<br> - ds9.set(string cmd)<br> - cube<br> - cube play<br> - cube last<br> - cube 3<br> - cube 4.5 wcs 3<br> - cube interval 2<br> - cube match wcs<br> - cube lock wcs<br> - cube order 123<br> - cube axes lock yes<br> - cube open<br> - cube close</tt><br> - <p><b> <a name="cursor"></a>cursor</b></p> - <p>Move mouse pointer or crosshair in image pixels in the current - frame. Note, this will move selected Regions also. </p> - <tt> Syntax: <br> - cursor [<x> <y>] <br> - <br> - Example:<br> - ds9.set(string cmd)<br> - cursor 10 10<br> - </tt> - <p><b><a name="data"></a>data</b></p> - <p>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.<br> - </p> - <tt> Syntax: <br> - data [<coordsys> [<skyframe>] <x> <y> - <width> <height> [yes|no]]<br> - <br> - Example:<br> - string url = ds9.get(string cmd) <br> - data image 450 520 3 3 yes<br> - data physical 899 1039 6 6 no<br> - data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no<br> - data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 - 0.00016516669 no</tt><tt><br> - </tt> - <p><b> <a name="dsssao"></a>dsssao<br> - dss<br> - </b></p> - <p>Support for Digital Sky Survey at SAO. </p> - <tt> Syntax:<br> - dsssao []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # - in wcs fk5<br> - [size <width> - <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - dsssao name <br> - dsssao coord <br> - dsssao size<br> - dsssao save<br> - dsssao frame<br> - ds9.set(string cmd)<br> - dsssao<br> - dsssao m31 <br> - </tt><tt><tt>dsssao name m31 <br> - </tt></tt><tt><tt><tt>dsssao name clear<br> - </tt></tt>dsssao 00:42:44.404 +41:16:08.78<br> - dsssao size 60 60 arcmin<br> - dsssao save yes<br> - dsssao frame current<br> - dsssao update frame<br> - dsssao open<br> - dsssao close<br> - </tt> - <p><b> <a name="dsseso"></a>dsseso</b></p> - <p>Support for Digital Sky Survey at ESO. </p> - <tt> Syntax:<br> - dsseso []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # - in wcs fk5<br> - [size <width> - <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey - DSS1|DSS2-red|DSS2-blue|DSS2-infrared]<br> - [open|close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - dsseso name <br> - dsseso coord <br> - dsseso size<br> - dsseso save<br> - dsseso frame<br> - dsseso survey<br> - ds9.set(string cmd)<br> - dsseso<br> - dsseso m31 <br> - </tt><tt><tt>dsseso name m31 <br> - </tt></tt><tt><tt><tt>dsseso name clear<br> - </tt></tt>dsseso 00:42:44.404 +41:16:08.78<br> - dsseso size 60 60 arcmin<br> - dsseso save yes<br> - dsseso frame current<br> - dsseso update frame<br> - dsseso survey DSS2-red <br> - dsseso open<br> - dsseso close<br> - </tt> - <p><b> <a name="dssstsci"></a>dssstsci</b></p> - <p>Support for Digital Sky Survey at STSCI.</p> - <tt> Syntax:<br> - dssstsci []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> - <dec>] # in wcs fk5<br> - [size - <width> <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame - new|current]<br> - [update - frame|crosshair]<br> - [survey - poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue] <br> - [survey - poss1_blue|poss1_red]<br> - [survey - all|quickv|phase2_gsc2|phase2_gsc1]<br> - [open|close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - dssstsci name <br> - dssstsci coord <br> - dssstsci size<br> - dssstsci save<br> - dssstsci frame<br> - dssstsci survey<br> - ds9.set(string cmd)<br> - dssstsci<br> - dssstsci m31 <br> - </tt><tt><tt>dssstsci name m31 <br> - </tt></tt><tt><tt><tt>dssstsci name clear<br> - </tt></tt>dssstsci 00:42:44.404 +41:16:08.78<br> - dssstsci size 60 60 arcmin<br> - dssstsci save yes<br> - dssstsci frame current<br> - dssstsci update frame<br> - dssstsci survey all<br> - dssstsci open<br> - dssstsci close</tt><br> - <p><b> <a name="envi"></a>envi</b></p> - <p>Load an ENVI header and file. Optional parameter: array endian.<br> - </p> - <tt> Syntax: <br> - envi [new] <header> [<filename>]<br> - <br> - Example:<br> - </tt><tt><tt>envi foo.hdr</tt></tt><br> - <tt><tt>envi new foo.hdr</tt></tt><br> - <tt><tt><tt><tt><tt><tt>envi foo.hdr foo.bsq</tt></tt><br> - <br> - </tt></tt></tt></tt><b><a name="exit"></a>exit</b><br> - <p><b> quit<br> - </b></p> - <p>Quits DS9. </p> - <tt> Syntax: <br> - exit<br> - quit<br> - <br> - Example:<br> - ds9.set(string cmd)<br> - exit</tt><br> - <p><b> <a name="export"></a>export<br> - </b></p> - <p>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.</p> - <tt> Syntax: </tt><tt><br> - </tt><tt> export </tt><tt>[array|nrrd|envi|gif|tiff|jpeg|png] </tt><tt><filename></tt><tt><br> - </tt><tt>export array <filename></tt><tt> </tt><tt>[big|little</tt><tt>|native]</tt><tt><br> - </tt><tt>export nrrd <filename> </tt><tt>[big|little</tt><tt>|native]</tt><br> - <tt>export envi <header> [<filename>] </tt><tt>[big|little</tt><tt>|native]</tt><tt><br> - </tt><tt> </tt><tt>export jpeg <filename></tt><tt> [1-100]</tt><tt><br> - </tt><tt> </tt><tt>export tiff <filename</tt><tt>></tt><tt> - [none|jpeg|packbits|deflate]</tt><br> - <tt> <br> - Example: <br> - </tt><tt><tt><tt>ds9.set (string cmd)<br> - </tt>export array foo.arr little</tt></tt><br> - <tt><tt>export nrrd foo.nrrd little<br> - export envi foo.hdr little<br> - export envi foo.hdr foo.bsq little<br> - </tt></tt> <tt><tt><tt><tt>export tiff foo.tiff jpeg</tt></tt></tt><br> - export jpeg foo.jpeg 75<br> - export png foo.png</tt><br> - <p><b> <a name="file"></a>file</b></p> - <p>Query currently loaded file information. </p> - <tt> Syntax:<br> - file <br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - file</tt><tt><br> - </tt> - <p><b> <a name="fits"></a>fits</b></p> - <p>Load a FITS image into the current frame or query the currently - loaded image.<br> - </p> - <tt> Syntax: <br> - fits </tt><tt><tt>[new|mask|slice] [<filename>]</tt><tt><br> - </tt> [width|height|depth|bitpix|type]<br> - [size [wcs|wcsa...wcsz] - [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> - [header [<ext>] [keyword - <string>]]<br> - [image|table|slice]</tt><tt><br> - <br> - Example: </tt><br> - <tt><tt>string value = ds9.get(string cmd)</tt><br> - fits<br> - fits width<br> - fits height<br> - fits depth<br> - fits bitpix</tt><br> - <tt>fits type </tt><br> - <tt><tt>fits size<br> - </tt> fits size wcs fk5 arcmin<br> - fits header # primary<br> - fits header 2 # hdu 2<br> - fits header -2 # hdu 2 with inherit<br> - fits header keyword BITPIX<br> - fits header 1 keyword BITPIX</tt><br> - <tt><tt>fits image<br> - fits table</tt></tt><tt><br> - fits slice<br> - ds9.set(string cmd, string url)</tt><tt><tt><br> - </tt> fits foo.fits<br> - fits new foo.fits<br> - fits bar.fits[bin=detx,dety]<br> - fits slice foo.fits<br> - fits mask foo.fits<br> - fits <br> - fits new<br> - fits -[bin=detx,dety]<br> - fits slice<br> - fits mask</tt> - <p>Syntax: <br> - </p> - <tt> </tt><tt><tt>fits </tt><tt><tt>[new|mask|slice] - [<filename>]</tt><tt><br> - </tt> [width|height|depth|bitpix]<br> - [size [wcs|wcsa...wcsz] - [fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> - [header [<ext>] [keyword - <string>]]<br> - [image|table|slice]</tt><tt><br> - </tt><br> - Example:<br> - string value = ds9.get(string cmd)<br> - </tt><tt><tt>fits width<br> - fits height<br> - fits depth<br> - fits bitpix</tt><br> - <tt><tt>fits size<br> - </tt> fits size wcs fk5 arcmin<br> - fits header # primary<br> - fits header 2 # hdu 2<br> - fits header -2 # hdu 2 with inherit<br> - fits header keyword BITPIX<br> - fits header 1 keyword BITPIX</tt><br> - fits<br> - fits image<br> - </tt><tt><tt>fits table<br> - </tt></tt><tt><tt><tt>fits slice<br> - </tt></tt>ds9.set(string cmd, string url)</tt><tt><br> - fits foo.fits<br> - fits new foo.fits<br> - fits bar.fits[bin=detx,dety]<br> - fits slice foo.fits<br> - fits mask foo.fits<br> - <br> - </tt><b><a name="frame"></a>frame</b> - <p>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. </p> - <tt> Syntax: <br> - frame [center [#|all]]<br> - [clear [#|all]]<br> - [new [rgb|3d]]<br> - [delete [#|all]] <br> - [reset [#|all]]<br> - [refresh [#|all]]<br> - [hide [#|all]]<br> - [show [#|all]]<br> - [move first]<br> - [move back]<br> - [move forward]<br> - [move last]<br> - [first]<br> - [prev]<br> - [next]<br> - [last]<br> - [frameno #]<br> - [#]<br> - [match <coordsys>]<br> - [lock <coordsys>|none]<br> - [has + <br> +Example:<br></tt> <tt><tt>string url = ds9.get(string cmd)<br></tt> +array<br> +array little<br></tt> <tt><tt>ds9.set(string command, string +url)<br></tt> array foo.arr[dim=512,bitpix=-32,endian=little]<br> +array new +foo.arr[dim=512,bitpix=</tt><tt>-32,endian=little]</tt><br> +<tt><tt>array mask +foo.arr[dim=512,bitpix=</tt></tt><tt>-32,endian=little]</tt><tt><br> +</tt> +<p><b><a name="background" id="background"></a>bg<br> +background</b></p> +<p>Set image background color.</p> +<tt>Syntax:<br> +bg <color><br> + <br> +Example:<br></tt> <tt>string url = ds9.get(string cmd)</tt><tt><br> +bg<br></tt> <tt>ds9.set(string cmd)<br></tt> <tt>bg +red</tt><tt><br></tt> bg red<br> +<p><b><a name="backup" id="backup"></a>backup</b></p> +<p>Create a backup save set.</p> +<tt>Syntax:<br> +backup <filename><br> + <br> +Example:<br></tt> <tt>ds9.set(string cmd)<br></tt> <tt>backup +ds9.bck</tt><br> +<p><b><a name="bin" id="bin"></a>bin</b></p> +<p>Controls binning factor, binning buffer size, and binning +function for binning FITS bin tables. The access point blocking is +provided for backward compatibility.</p> +<tt>Syntax:<br> +bin [about <x> <y>]<br> + [about center]<br> + [buffersize <value>]<br> + [cols <x> <y>]<br> + [colsz <x> <y> <z>]<br> + [factor <value> [<vector>]]<br> + [depth <value>]<br> + [filter <string>]<br></tt> +<tt><tt> [filter clear]<br></tt> + [function average|sum]<br> + [in]<br> + [out]<br> + [to fit]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +bin about<br> +bin buffersize<br> +bin cols<br> +bin factor<br> +bin depth<br> +bin filter<br> +bin function<br> +bin smooth<br> +bin smooth function<br> +bin smooth radius<br> +bin lock<br> +ds9.set(string cmd)<br> +bin about 4096 4096<br> +bin about center<br> +bin buffersize 512<br> +bin cols detx dety<br> +bin colsz detx dety time<br> +bin factor 4<br> +bin factor 4 2<br> +bin depth 10<br> +bin filter 'pha > 5'<br> +bin filter clear<br> +bin function sum<br> +bin in<br> +bin out<br> +bin to fit<br> +bin match<br> +bin lock yes<br> +bin open<br> +bin close<br></tt> +<p><b><a name="blink" id="blink"></a>blink</b></p> +<p>Blink mode parameters. Interval is in seconds.<br></p> +<tt>Syntax:<br> +blink []<br> + [yes|no]<br> + [interval <value>]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +blink<br> +blink interval<br> +ds9.set(string cmd)<br> +blink<br> +blink yes<br> +blink interval 1</tt><br> +<p><b><a name="block" id="block"></a>block</b></p> +<p>Controls blocking parameters.</p> +<tt>Syntax:<br> +block</tt> <tt><tt>[<value>]<br> + [<value> <value>]<br> + [to <value>]<br> + [to <value> <value>]<br> + [in]<br> + [out]<br></tt> + [to fit]<br> + [match]<br> + [lock [yes|no]]<br> + [open|close]<br> + <br> +Example:<br></tt> <tt><tt>string value = ds9.get(string +cmd)<br></tt> block<br> +block lock<br></tt> <tt><tt>ds9.set(string cmd)<br></tt></tt> +<tt><tt><tt>block</tt></tt> 4<br></tt> <tt><tt><tt>block</tt></tt> +4 2<br></tt> <tt><tt><tt><tt><tt>block</tt></tt> to 4<br></tt> +<tt><tt><tt>block</tt></tt> to 4 2<br></tt></tt> +<tt><tt><tt>block</tt></tt> in<br></tt></tt> +<tt><tt><tt><tt><tt>block</tt></tt> out<br></tt></tt></tt> +<tt><tt><tt>block</tt></tt> to fit<br></tt> +<tt><tt><tt>block</tt></tt> match<br></tt> +<tt><tt><tt>block</tt></tt> lock yes<br></tt> +<tt><tt><tt>block</tt></tt> open<br></tt> +<tt><tt><tt>block</tt></tt> close</tt><tt><br></tt> +<p><b><a name="catalog" id="catalog"></a>catalog<br> +cat<br></b></p> +<p>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.</p> +<tt>Syntax:<br></tt> <tt>catalog [new]<br> + +[ned|simbad|denis|skybot]<br></tt> +<tt><tt> +[aavso|ac|ascss|cmc|gaia|gsc1|gsc2|gsc3|nomad|ppmx|sao|sdss5|sdss6|</tt><tt>sdss7|sdss8|</tt><tt>sdss9|tycho]<br> + + +[</tt><tt><tt>ua2|ub1|</tt>ucac2|ucac2sup|ucac3|ucac4|urat1]<br></tt></tt> +<tt> [2mass|iras]<br> + [csc|xmm|rosat]<br> + [first|nvss]<br> + +[chandralog|cfhtlog|esolog|stlog|xmmlog]<br> + [cds <catalogname>]<br> + [cds +<catalogid>]<br> +<br> + [load <filename>]<br> + [import sb|tsv +<filename>]<br> +<br></tt> <tt><tt> +[<ref>] [<ra> <dec> +<coordsys>]</tt><tt><br></tt> + [<ref>] [allcols]<br></tt> +<tt> </tt><tt> [<ref>] +[allrows]<br> + </tt><tt> [<ref>] +[cancel]<br></tt> <tt> +[<ref>] [clear]<br></tt> <tt> +[<ref>] [close]</tt><br> +<tt> </tt> +<tt>[<ref>] [crosshair]</tt><br> +<tt> [<ref>] [dec +<col>]</tt><br> +<tt> [<ref>] [edit +yes|no]</tt><br> +<tt> [<ref>] +[export sb|tsv <filename>]<br></tt> +<tt> [<ref>] +[filter <string>]<br> + [<ref>] [filter load +<filename>]</tt><br> +<tt> [<ref>] +[header]</tt><br> +<tt> [<ref>] [location +<code>]</tt><br> +<tt><tt> [<ref>] +[match]<br></tt></tt> +<tt><tt><tt> +[<ref>] [match <ref> <ref>]<br></tt></tt> + </tt> <tt>[<ref>] +[match error <value> degrees|arcmin|arcsec]</tt><br> +<tt> </tt> +<tt>[<ref>] [match function 1and2|1not2|2not1]<br></tt> +<tt> </tt> +<tt>[<ref>] [match return 1and2|1only|2only]</tt><br> +<tt> </tt> +<tt>[<ref>] [match unique yes|no]</tt><br> +<tt> [<ref>] [maxrows +<number>]</tt><br> +<tt> [<ref>] [name +<object>]<br></tt> +<tt> [<ref>] [panto +yes|no]</tt><br> +<tt> [<ref>] [plot +<xcol> <ycol> <xerrcol> <yerrcol>]</tt><br> +<tt> [<ref>] [print]</tt><br> +<tt> [<ref>] [psky +<skyframe>]</tt><br> +<tt> [<ref>] [psystem +<coordsys>]</tt><br> +<tt> [<ref>] [ra +<col>]</tt><br> +<tt> [<ref>] +[regions]</tt><br> +<tt><tt> [<ref>] +[retrieve]</tt><br> + [<ref>] [samp]<br> + [<ref>] [samp +broadcast]<br> + [<ref>] [samp send +<application>]</tt><tt><br></tt> +<tt> [<ref>] [save +<filename>]</tt><br> +<tt> [<ref>] +[server</tt> +<tt><tt>cds|adac|cadc|cambridge|sao|ukirt|iucaa|bejing|saao]</tt></tt><br> + +<tt> [<ref>] [show +yes|no]</tt><br> +<tt> [<ref>] [radius +<value> degrees|arcmin|arcsec]</tt><br> +<tt> [<ref>] [sky +<skyframe>]<br></tt> <tt> + [<ref>] [skyformat +<skyformat>]<br></tt> <tt> + [<ref>] [sort <col> +incr|decr]</tt><br> +<tt> [<ref>] [symbol [#] +condition|shape|color|text|font|fontsize|fontweight|fontslant +<value>]<br></tt> <tt> +[<ref>] [symbol [#] text|size|size2|units|angle +<value>]<br></tt> <tt><tt> + [<ref>] [symbol shape +circle|ellipse|box|text|point]<br> + </tt></tt> +<tt><tt><tt><tt>[<ref>] [symbol shape</tt></tt></tt></tt> +<tt><tt><tt><tt><tt><tt>circle point|box point|diamond +point|</tt></tt></tt></tt>cross point|x point|arrow point|boxcircle +point]<br></tt> +[<ref>] [symbol add| [#] remove]<br> + [<ref>] [symbol +save|load <filename>]</tt><br> +<tt> [<ref>] [system +<coordsys>]</tt><tt><br></tt> <tt> + </tt> <tt>[<ref>] [update]</tt><br> +<tt> [<ref>] [x +<col>]</tt><br> +<tt> [<ref>] [y +<col>]</tt><br> +<tt> <br> +Example:<br> +string value = ds9.get(string cmd)<br> +catalog<br> +catalog header<br> +<br> +ds9.set(string cmd)<br></tt> <tt><tt>catalog new<br></tt> catalog +2mass<br> +catalog cds 2mass<br> +catalog cds</tt> <tt>{I/252}</tt><br> +<tt><br></tt> <tt>catalog load foo.xml<br> +catalog import tsv foo.tsv<br> +<br></tt> <tt>catalog allrows<br> +catalog allcols<br></tt> <tt>catalog cancel<br></tt> <tt>catalog +clear<br></tt> <tt>catalog close<br></tt> <tt>catalog coordinate +202.48 47.21 fk5<br></tt> <tt>catalog crosshair<br></tt> +<tt>catalog dec DEC<br></tt> <tt>catalog edit yes<br></tt> +<tt>catalog export tsv bar.tsv<br></tt> <tt>catalog filter +{$Jmag>10}<br> +catalog filter load foo.flt<br> +catalog header<br></tt> <tt>catalog location 500</tt><br> +<tt>catalog match error 2 arcsec<br> +catalog match function 1and2<br> +catalog match unique no<br> +catalog match return 1only<br></tt> <tt>catalog match # last two +catalogs loaded<br></tt> <tt>catalog match 2mass csc<br></tt> +<tt>catalog maxrows 2000<br></tt> <tt>catalog name m51<br> +catalog panto no<br></tt> <tt>catalog plot</tt> <tt>{$Jmag} {$Hmag} +{$e_Jmag} {$e_Hmag}</tt><tt><br></tt> <tt>catalog print</tt><br> +<tt>catalog psky fk5</tt><br> +<tt>catalog psystem wcs</tt><br> +<tt>catalog ra RA</tt><br> +<tt>catalog regions<br></tt> <tt>catalog retrieve<br></tt> +<tt>catalog samp broadcast<br> +catalog samp send aladin<br> +catalog save foo.xml<br></tt> <tt>catalog server sao<br></tt> +<tt>catalog show yes</tt><br> +<tt>catalog radius 1 degrees</tt><br> +<tt>catalog symbol condition</tt> <tt>{$Jmag>15}</tt><br> +<tt>catalog symbol 2 shape</tt> <tt>{boxcircle point}</tt><br> +<tt>catalog symbol color red<br> +catalog symbol font times<br></tt> <tt>catalog symbol fontsize +14<br></tt> <tt>catalog symbol fontweight bold<br></tt> <tt>catalog +symbol fontslant italic<br></tt> <tt>catalog symbol add<br> +catalog symbol 2 remove<br> +catalog symbol load foo.sym<br> +catalog symbol save bar.sym</tt><tt><br> +catalog sky fk5<br> +catalog skyformat degrees<br></tt> <tt>catalog sort {Jmag} +incr<br></tt> <tt>catalog system wcs</tt><tt><br></tt> <tt>catalog +update<br></tt> <tt>catalog x RA<br> +catalog y DEC</tt><br> +<p><b><a name="cd" id="cd"></a>cd</b></p> +<p>Sets/Returns the current working directory.</p> +<tt>Syntax:<br> +cd [<directory>]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +cd<br> +ds9.set(string cmd)<br> +cd /home/mrbill<br></tt> +<p><b><a name="cmap" id="cmap"></a>cmap</b></p> +<p>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.</p> +<tt>Syntax:<br> +cmap [<colormap>]<br> + [file]<br> + [load <filename>]<br> + [save <filename>]<br> + [invert yes|no]<br> + [<constrast> <bias>]<br></tt> +<tt> [tag [load|save] <filename>]<br> + [tag delete]</tt><br> +<tt> [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +cmap<br> +cmap file<br> +cmap invert<br> +cmap value<br></tt> <tt>cmap lock</tt><br> +<tt>ds9.set(string cmd)<br> +cmap Heat<br> +cmap load foo.sao<br> +cmap save bar.sao<br> +cmap invert yes<br> +cmap 5 .5<br></tt> <tt>cmap tag load foo.tag<br> +cmap tag save foo.tag<br> +cmap tag delete</tt><br> +<tt>cmap open<br> +cmap close<br></tt> +<p><b><a name="colorbar" id="colorbar"></a>colorbar</b></p> +<p>Controls colorbar parameters.</p> +<tt>Syntax:<br> +colorbar []<br> + [yes|no]<br> + [orientation]<br> + +[horizontal|vertical]<br> + [numerics +yes|no]<br> + [space +value|distance]<br> + [font +times|helvetica|courier]<br> + [fontsize +<value>]<br> + [fontweight +normal|bold]<br> + [fontslant +roman|italic]<br> + [size]<br> + [ticks]</tt><br> +<tt><tt> +[match]<br> + [lock +[yes|no]]</tt><br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +colorbar<br> +colorbar orientation<br> +colorbar numerics<br> +colorbar space<br> +colorbar font<br> +colorbar fontsize<br> +colorbar fontweight<br> +colorbar fontslant<br> +colorbar size<br> +colorbar ticks<br> +ds9.set(string cmd)<br> +colorbar yes<br> +colorbar vertical<br> +colorbar numerics yes<br> +colorbar space value<br> +colorbar font times<br> +colorbar fontsize 14<br> +colorbar fontwieght bold<br> +colorbar fontslant italic<br> +colorbar size 20<br> +colorbar ticks 11</tt><br> +<tt>colorbar match<br> +colorbar lock yes</tt><br> +<p><b><a name="console" id="console"></a>console</b></p> +<p>Display tcl console window.</p> +<tt>Syntax:<br> +-console<br> + <br> +Example:<br> +ds9.set(string cmd)<br> +console<br></tt> +<p><b><a name="contour" id="contour"></a>contour</b></p> +<p>Controls contours in the current frame.</p> +<tt>Syntax:<br> +contour []<br> + [yes|no]<br> + [<coordsys> +[<skyframe>]]<br> + [clear]<br> + [generate]<br> + [load +<filename>]<br> + [save <filename> +[<coordsys> <skyframe>]]<br> + [convert]<br></tt> +<tt><tt> [load levels +<filename>]<br></tt></tt> +<tt><tt><tt> [save levels +<filename>]<br></tt></tt> + [copy]<br> + [paste [<coordsys> +<color> <width> yes|no]]<br> + [color <color>]<br> + [width <width>]<br> + [dash yes|no]<br> + [smooth <smooth>]<br> + [method block|smooth]<br> + [nlevels <number of +levels>]<br> + [scale +linear|log|pow|squared|sqrt|asinh|sinh|histequ]<br> + ]scale log exp +<value>]<br> + [mode +minmax|<value>|zscale|zmax]<br> + [scope global|local]<br> + [limits <min> +<max>]<br> + [levels <value value +value...>]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +contour<br> +contour color<br> +contour width<br> +contour dash<br> +contour smooth<br> +contour method<br> +contour nlevels<br> +contour scale<br> +contour log exp<br> +contour mode<br> +contour scope<br> +contour limits<br> +contour levels<br> +string url = ds9.get(string cmd)<br> +contour wcs fk5<br> +ds9.set(string cmd)<br> +contour<br> +contour yes<br> +contour clear<br> +contour generate<br> +contour load ds9.ctr<br></tt> <tt><tt>contour save +ds9.con<br></tt></tt> <tt><tt><tt>contour save ds9.con wcs +fk5<br></tt></tt> contour convert<br></tt> <tt><tt>contour load +levels ds9.ctr<br></tt></tt> <tt><tt><tt>contour save levels +ds9.lev<br></tt></tt> contour copy<br></tt> <tt><tt>contour +paste<br></tt></tt> <tt><tt><tt>contour paste wcs red 2 +no<br></tt></tt> contour color yellow<br> +contour width 2<br> +contour dash yes<br> +contour smooth 5<br> +contour method smooth<br> +contour nlevels 10<br> +contour scale sqrt<br> +contour log exp 1000<br> +contour mode zscale<br> +contour scope local<br> +contour limits 1 100<br> +contour levels {1 10 100 1000}<br> +contour open<br> +contour close<br></tt> +<p><b><a name="crop" id="crop"></a>crop</b></p> +<p>Set current image display area.</p> +<tt>Syntax:<br> +crop [<x> <y> <width> <height> +[<coordsys>][<skyframe>][degrees|arcmin|arcsec]<br></tt> +<tt> [match <coordsys>]<br> + [lock +<coordsys>|none]</tt><tt><br> + [reset]<br> + [3d</tt> <tt><tt>zmin zmax +<coordsys>]<br> + [open|close]</tt><br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br></tt> <tt>crop # get crop in +physical coords<br></tt> <tt>crop wcs galactic sexagesimal +arcsec<br> +crop lock<br></tt> <tt>ds9.set(string cmd)</tt><br> +<tt>crop 40 30 10 20 # set crop in physical coords<br> +crop +104:51:06.915 +68:33:40.761 28.144405 22.000204 wcs +galactic arcsec<br> +crop match wcs<br> +crop lock wcs<br> +crop reset<br> +crop 3d .25 .5 wcs<br> +crop open<br> +crop close<br></tt> +<p><b><a name="crosshair" id="crosshair"></a>crosshair</b></p> +<p>Controls the current position of the crosshair in the current +frame. DS9 is placed in crosshair mode when the crosshair is +set.</p> +<tt>Syntax:<br> +crosshair [<x> <y> <coordsys> +[<skyframe>]]<br></tt> +<tt> [match +<coordsys>]<br> + [lock +<coordsys>|none]</tt><br> +<tt> <br> +Example:<br> +string value = ds9.get(string cmd)<br> +crosshair # get crosshair in physical coords<br> +crosshair wcs fk4 sexagesimal # get crosshair in wcs coords<br> +crosshair lock<br> +ds9.set(string cmd)<br> +crosshair 100 100 physical # set crosshair in physical<br> +crosshair 345 58.8 wcs fk5 # set crosshair in wcs coords<br> +crosshair 23:01:00 +58:52:51 wcs fk5<br> +crosshair match wcs<br> +crosshair lock wcs<br></tt> +<p><b><a name="cube" id="cube"></a>cube<br></b></p> +<p>Controls FITS cube.</p> +<tt>Syntax:<br> +cube []<br> + [play|stop|next|prev|first|last]<br> + [<slice> +[<coordsys>][<axis>]]<br> + [interval <numeric>]<br></tt> +<tt> [match <coordsys>]<br> + [lock <coordsys>|none]</tt><br> +<tt> [order 123|132|213|231|312|321]<br> + [axes lock [yes|no]]</tt><br> +<tt> [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +cube<br> +cube interval<br> +cube lock<br> +cube order<br> +cube axes lock<br> +ds9.set(string cmd)<br> +cube<br> +cube play<br> +cube last<br> +cube 3<br> +cube 4.5 wcs 3<br> +cube interval 2<br> +cube match wcs<br> +cube lock wcs<br> +cube order 123<br> +cube axes lock yes<br> +cube open<br> +cube close</tt><br> +<p><b><a name="cursor" id="cursor"></a>cursor</b></p> +<p>Move mouse pointer or crosshair in image pixels in the current +frame. Note, this will move selected Regions also.</p> +<tt>Syntax:<br> +cursor [<x> <y>]<br> + <br> +Example:<br> +ds9.set(string cmd)<br> +cursor 10 10<br></tt> +<p><b><a name="data" id="data"></a>data</b></p> +<p>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.<br></p> +<tt>Syntax:<br> +data [<coordsys> [<skyframe>] <x> <y> +<width> <height> [yes|no]]<br> + <br> +Example:<br> +string url = ds9.get(string cmd)<br> +data image 450 520 3 3 yes<br> +data physical 899 1039 6 6 no<br> +data fk5 202.47091 47.196811 0.00016516669 0.00016516669 no<br> +data wcs fk5 13:29:53.018 +47:11:48.52 0.00016516669 0.00016516669 +no</tt><tt><br></tt> +<p><b><a name="dsssao" id="dsssao"></a>dsssao<br> +dss<br></b></p> +<p>Support for Digital Sky Survey at SAO.</p> +<tt>Syntax:<br> +dsssao []<br> + [<object>]<br> + [name +<object>|clear]<br> + [<ra> <dec>] # in +wcs fk5<br> + [size <width> +<height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +dsssao name<br> +dsssao coord<br> +dsssao size<br> +dsssao save<br> +dsssao frame<br> +ds9.set(string cmd)<br> +dsssao<br> +dsssao m31<br></tt> <tt><tt>dsssao name m31<br></tt></tt> +<tt><tt><tt>dsssao name clear<br></tt></tt> dsssao 00:42:44.404 ++41:16:08.78<br> +dsssao size 60 60 arcmin<br> +dsssao save yes<br> +dsssao frame current<br> +dsssao update frame<br> +dsssao open<br> +dsssao close<br></tt> +<p><b><a name="dsseso" id="dsseso"></a>dsseso</b></p> +<p>Support for Digital Sky Survey at ESO.</p> +<tt>Syntax:<br> +dsseso []<br> + [<object>]<br> + [name +<object>|clear]<br> + [<ra> <dec>] # in +wcs fk5<br> + [size <width> +<height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey +DSS1|DSS2-red|DSS2-blue|DSS2-infrared]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +dsseso name<br> +dsseso coord<br> +dsseso size<br> +dsseso save<br> +dsseso frame<br> +dsseso survey<br> +ds9.set(string cmd)<br> +dsseso<br> +dsseso m31<br></tt> <tt><tt>dsseso name m31<br></tt></tt> +<tt><tt><tt>dsseso name clear<br></tt></tt> dsseso 00:42:44.404 ++41:16:08.78<br> +dsseso size 60 60 arcmin<br> +dsseso save yes<br> +dsseso frame current<br> +dsseso update frame<br> +dsseso survey DSS2-red<br> +dsseso open<br> +dsseso close<br></tt> +<p><b><a name="dssstsci" id="dssstsci"></a>dssstsci</b></p> +<p>Support for Digital Sky Survey at STSCI.</p> +<tt>Syntax:<br> +dssstsci []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> +<dec>] # in wcs fk5<br> + [size +<width> <height> degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame +new|current]<br> + [update +frame|crosshair]<br> + [survey +poss2ukstu_red|poss2ukstu_ir|poss2ukstu_blue]<br> + [survey +poss1_blue|poss1_red]<br> + [survey +all|quickv|phase2_gsc2|phase2_gsc1]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +dssstsci name<br> +dssstsci coord<br> +dssstsci size<br> +dssstsci save<br> +dssstsci frame<br> +dssstsci survey<br> +ds9.set(string cmd)<br> +dssstsci<br> +dssstsci m31<br></tt> <tt><tt>dssstsci name m31<br></tt></tt> +<tt><tt><tt>dssstsci name clear<br></tt></tt> dssstsci 00:42:44.404 ++41:16:08.78<br> +dssstsci size 60 60 arcmin<br> +dssstsci save yes<br> +dssstsci frame current<br> +dssstsci update frame<br> +dssstsci survey all<br> +dssstsci open<br> +dssstsci close</tt><br> +<p><b><a name="envi" id="envi"></a>envi</b></p> +<p>Load an ENVI header and file. Optional parameter: array +endian.<br></p> +<tt>Syntax:<br> +envi [new] <header> [<filename>]<br> + <br> +Example:<br></tt> <tt><tt>envi foo.hdr</tt></tt><br> +<tt><tt>envi new foo.hdr</tt></tt><br> +<tt><tt><tt><tt><tt><tt>envi foo.hdr foo.bsq</tt></tt><br> +<br></tt></tt></tt></tt> <b><a name="exit" id= +"exit"></a>exit</b><br> +<p><b>quit<br></b></p> +<p>Quits DS9.</p> +<tt>Syntax:<br> +exit<br> +quit<br> + <br> +Example:<br> +ds9.set(string cmd)<br> +exit</tt><br> +<p><b><a name="export" id="export"></a>export<br></b></p> +<p>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.</p> +<tt>Syntax:</tt> <tt><br></tt> <tt>export</tt> +<tt>[array|nrrd|envi|gif|tiff|jpeg|png]</tt> +<tt><filename></tt><tt><br></tt> <tt>export array +<filename></tt> +<tt>[big|little</tt><tt>|native]</tt><tt><br></tt> <tt>export nrrd +<filename></tt> <tt>[big|little</tt><tt>|native]</tt><br> +<tt>export envi <header> [<filename>]</tt> +<tt>[big|little</tt><tt>|native]</tt><tt><br></tt> <tt>export jpeg +<filename></tt> <tt>[1-100]</tt><tt><br></tt> <tt>export tiff +<filename</tt><tt>></tt> +<tt>[none|jpeg|packbits|deflate]</tt><br> +<tt> <br> +Example:<br></tt> <tt><tt><tt>ds9.set (string cmd)<br></tt> export +array foo.arr little</tt></tt><br> +<tt><tt>export nrrd foo.nrrd little<br> +export envi foo.hdr little<br> +export envi foo.hdr foo.bsq little<br></tt></tt> +<tt><tt><tt><tt>export tiff foo.tiff jpeg</tt></tt></tt><br> +export jpeg foo.jpeg 75<br> +export png foo.png</tt><br> +<p><b><a name="file" id="file"></a>file</b></p> +<p>Query currently loaded file information.</p> +<tt>Syntax:<br> +file<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +file</tt><tt><br></tt> +<p><b><a name="fits" id="fits"></a>fits</b></p> +<p>Load a FITS image into the current frame or query the currently +loaded image.<br></p> +<tt>Syntax:<br> +fits</tt> <tt><tt>[new|mask|slice] +[<filename>]</tt><tt><br></tt> +[width|height|depth|bitpix|type]<br> + [size [wcs|wcsa...wcsz] +[fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> + [header [<ext>] [keyword +<string>]]<br> + [image|table|slice]</tt><tt><br> + <br> +Example:</tt><br> +<tt><tt>string value = ds9.get(string cmd)</tt><br> +fits<br> +fits width<br> +fits height<br> +fits depth<br> +fits bitpix</tt><br> +<tt>fits type</tt><br> +<tt><tt>fits size<br></tt> fits size wcs fk5 arcmin<br> +fits header # primary<br> +fits header 2 # hdu 2<br> +fits header -2 # hdu 2 with inherit<br> +fits header keyword BITPIX<br> +fits header 1 keyword BITPIX</tt><br> +<tt><tt>fits image<br> +fits table</tt></tt><tt><br> +fits slice<br> +ds9.set(string cmd, string url)</tt><tt><tt><br></tt> fits +foo.fits<br> +fits new foo.fits<br> +fits bar.fits[bin=detx,dety]<br> +fits slice foo.fits<br> +fits mask foo.fits<br> +fits<br> +fits new<br> +fits -[bin=detx,dety]<br> +fits slice<br> +fits mask</tt> +<p>Syntax:<br></p> +<tt><tt>fits</tt> <tt><tt>[new|mask|slice] +[<filename>]</tt><tt><br></tt> +[width|height|depth|bitpix]<br> + [size [wcs|wcsa...wcsz] +[fk4|fk5|icrs|galactic|ecliptic] [degrees|arcmin|arcsecs]]<br> + [header [<ext>] [keyword +<string>]]<br> + [image|table|slice]</tt><tt><br> + </tt><br> +Example:<br> +string value = ds9.get(string cmd)<br></tt> <tt><tt>fits width<br> +fits height<br> +fits depth<br> +fits bitpix</tt><br> +<tt><tt>fits size<br></tt> fits size wcs fk5 arcmin<br> +fits header # primary<br> +fits header 2 # hdu 2<br> +fits header -2 # hdu 2 with inherit<br> +fits header keyword BITPIX<br> +fits header 1 keyword BITPIX</tt><br> +fits<br> +fits image<br></tt> <tt><tt>fits table<br></tt></tt> +<tt><tt><tt>fits slice<br></tt></tt> ds9.set(string cmd, string +url)</tt><tt><br> +fits foo.fits<br> +fits new foo.fits<br> +fits bar.fits[bin=detx,dety]<br> +fits slice foo.fits<br> +fits mask foo.fits<br> +<br></tt> <b><a name="frame" id="frame"></a>frame</b> +<p>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.</p> +<tt>Syntax:<br> +frame [center [#|all]]<br> + [clear [#|all]]<br> + [new [rgb|3d]]<br> + [delete [#|all]]<br> + [reset [#|all]]<br> + [refresh [#|all]]<br> + [hide [#|all]]<br> + [show [#|all]]<br> + [move first]<br> + [move back]<br> + [move forward]<br> + [move last]<br> + [first]<br> + [prev]<br> + [next]<br> + [last]<br> + [frameno #]<br> + [#]<br> + [match <coordsys>]<br> + [lock <coordsys>|none]<br> + [has [amplifier|datamin|datasec|detector|grid|iis|irafmin|physical|smooth]]<br> - [has contour [aux]]]<br> - [has fits [ |bin|cube|mosaic]]<br> - [has marker - [highlite|paste|select|undo]]<br> - [has system <coordsys>]<br> - </tt><tt><tt><tt><tt> [has wcs - [<wcssys>]]<br> - </tt> [has wcs celestial - [<wcssys>]]<br> - </tt> [has wcs linear - [<wcssys>]]<br> - </tt><br> - Example: <br> - string value = ds9.get(string cmd)<br> - frame # returns the id of the current frame <br> - frame frameno # returns the id of the current frame <br> - frame all # returns the id of all frames <br> - frame active # returns the id of all active frames<br> - frame lock<br> - frame has amplifier<br> - frame has datamin<br> - frame has datasec<br> - frame has detector<br> - frame has grid<br> - frame has iis<br> - frame has irafmin<br> - frame has physical<br> - frame has smooth<br> - frame has contour<br> - frame has contour aux<br> - frame has fits<br> - frame has fits bin<br> - frame has fits cube<br> - frame has fits mosaic<br> - frame has marker highlite<br> - frame has marker paste<br> - frame has marker select<br> - frame has marker undo<br> - frame has system physical<br> - frame has wcs wcsa<br> - frame has wcs celestial wcsa<br> - frame has wcs linear wcsa<br> - ds9.set(string cmd)<br> - frame center # center current frame<br> - frame center 1 # center 'Frame1' <br> - frame center all # center all frames <br> - frame clear # clear current frame<br> - frame new # create new frame <br> - frame new rgb # create new rgb frame<br> - frame delete # delete current frame <br> - frame reset # reset current frame <br> - frame refresh # refresh current frame <br> - frame hide # hide current frame <br> - frame show 1 # show frame 'Frame1'<br> - frame move first # move frame to first in order<br> - frame move back # move frame back in order<br> - frame move forward # move frame forward in order<br> - frame move last # move frame to last in order<br> - frame first # goto first frame <br> - frame prev # goto prev frame <br> - frame next # goto next frame<br> - frame last # goto last frame<br> - frame frameno 4 # goto frame 'Frame4', create if needed<br> - frame 3 # goto frame 'Frame3', create if needed <br> - frame match wcs<br> - frame lock wcs</tt><br> - <p><b> <a name="gif"></a>gif</b></p> - <p>Load GIF image into current frame.<br> - </p> - <tt> Syntax:<br> - gif [new|slice] [<filename>]<br> - <br> - Example: <br> - </tt><tt><tt>string value = ds9.get(string cmd)<br> - </tt>gif</tt><br> - <tt><tt>ds9.set(string cmd)<br> - </tt>gif foo.gif</tt><br> - <tt><tt>gif new foo.gif<br> - </tt></tt><tt><tt><tt>gif slice foo.gif<br> - </tt></tt>gif</tt><br> - <tt><tt>gif</tt><tt> new<br> - </tt>gif</tt><tt> slice</tt> - <p><b> <a name="grid"></a>grid</b></p> - <p> Controls coordinate grid. For grid numeric format - syntax, click <a href="grid.html#Format">here</a>.</p> - <tt> Syntax: <br> - grid []<br> - [yes|no] <br> - [type analysis|publication] <br> - [system <coordsys>] <br> - [sky <skyframe>] <br> - [skyformat <skyformat>]<br> - [grid yes|no]<br> - [grid color <color>]<br> - [grid width <value>]<br> - [grid dash yes|no]<br> - [grid gap1 <value>]<br> - </tt><tt><tt> [grid gap2 - <value>]<br> - </tt></tt><tt><tt><tt> [grid gap3 - <value>]<br> - </tt></tt> [axes yes|no]<br> - [axes color <color>]<br> - [axes width <value>]<br> - [axes dash yes|no]<br> - [axes type interior|exterior]<br> - </tt><tt> [axes origin - lll|llu|lul|luu|ull|ulu|uul|uuu]</tt><br> - <tt> [format1 <format>]<br> - [format2 <format>]<br> - [tickmarks yes|no]<br> - [tickmarks color <color>]<br> - [tickmarks width <value>]<br> - [tickmarks dash yes|no]<br> - [border yes|no]<br> - [border color <color>]<br> - [border width <value>]<br> - [border dash yes|no]<br> - [numerics yes|no]<br> - [numerics font - times|helvetica|courier]<br> - [numerics fontsize <value>]<br> - [numerics fontweight normal|bold]<br> - [numerics fontslant roman|italic]<br> - [numerics color <color>]<br> - [numerics gap1 <value>]<br> - </tt><tt><tt> [numerics gap2 - <value>]<br> - </tt></tt><tt><tt><tt> [numerics - gap3 <value>]<br> - </tt></tt> [numerics type - interior|exterior]<br> - [numerics vertical yes|no]<br> - [title yes|no]<br> - [title text <text>]<br> - [title def yes|no]<br> - [title gap <value>]<br> - [title font - times|helvetica|courier]<br> - [title fontsize <value>]<br> - [title fontweight normal|bold]<br> - [title fontslant roman|italic]<br> - [title color <color>]<br> - [labels yes|no]<br> - [labels text1 <text>]<br> - </tt><tt><tt> [labels text2 - <text>]<br> - </tt> [labels def1 yes|no]<br> - [labels def2 yes|no]<br> - </tt><tt><tt> [labels gap1 - <value>]<br> - </tt> [labels gap2 <value>]<br> - [labels font - times|helvetica|courier]<br> - [labels fontsize <value>]<br> - [labels fontweight normal|bold]<br> - [labels fontslant roman|italic]<br> - [labels color <color>]<br> - [reset]<br> - [load <filename>] <br> - [save <filename>] <br> - [open|close]<br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - grid <br> - grid type <br> - grid system <br> - grid sky <br> - grid skyformat <br> - grid grid <br> - grid grid color <br> - grid grid width <br> - grid grid dash<br> - grid grid gap1 <br> - </tt><tt><tt>grid grid gap2 <br> - </tt></tt><tt><tt><tt>grid grid gap3<br> - </tt></tt>grid axes <br> - grid axes color <br> - grid axes width <br> - grid axes dash<br> - grid axes type <br> - grid axes origin<br> - grid format1<br> - grid format2<br> - grid tickmarks <br> - grid tickmarks color <br> - grid tickmarks width <br> - grid tickmarks dash<br> - grid border <br> - grid border color <br> - grid border width <br> - grid border dash<br> - grid numerics <br> - grid numerics font <br> - grid numerics fontsize <br> - grid numerics fontweight<br> - grid numerics fontslant<br> - grid numerics color <br> - grid numerics gap1 <br> - </tt><tt><tt>grid numerics gap2 <br> - </tt></tt><tt><tt><tt>grid numerics gap3<br> - </tt></tt>grid numerics type <br> - grid numerics vertical <br> - grid title <br> - grid title text<br> - grid title def <br> - grid title gap <br> - grid title font <br> - grid title fontsize <br> - grid title fontweight<br> - grid title fontslant<br> - grid title color <br> - grid labels <br> - grid labels text1 <br> - </tt><tt><tt>grid labels text2 <br> - </tt>grid labels def1 <br> - grid labels def2 <br> - </tt><tt><tt>grid labels gap1 <br> - </tt>grid labels gap2 <br> - grid labels font <br> - grid labels fontsize <br> - grid labels fontweight<br> - grid labels fontslant<br> - grid labels color <br> - ds9.set(string cmd)<br> - grid <br> - grid yes<br> - grid type analysis <br> - grid system wcs <br> - grid sky fk5 <br> - grid skyformat degrees<br> - grid grid yes<br> - grid grid color red<br> - grid grid width 2<br> - grid grid dash yes<br> - grid grid gap1 10<br> - </tt><tt><tt>grid grid gap2 10<br> - </tt></tt><tt><tt><tt>grid grid gap3 10<br> - </tt></tt>grid axes yes<br> - grid axes color red<br> - grid axes width 2<br> - grid axes dash yes<br> - grid axes type exterior<br> - grid axes origin lll<br> - grid format1 d.2<br> - grid format2 d.2<br> - grid tickmarks yes<br> - grid tickmarks color red<br> - grid tickmarks width 2<br> - grid tickmarks dash yes<br> - grid border yes<br> - grid border color red<br> - grid border width 2<br> - grid border dash yes<br> - grid numerics yes<br> - grid numerics font courier<br> - grid numerics fontsize 12<br> - grid numerics fontweight bold<br> - grid numerics fontslant italic<br> - grid numerics color red<br> - grid numerics gap1 10<br> - </tt><tt><tt>grid numerics gap2 10<br> - </tt></tt><tt><tt><tt>grid numerics gap3 10<br> - </tt></tt>grid numerics type exterior<br> - grid numerics vertical yes<br> - grid title yes<br> - grid title text {Hello World}<br> - grid title def yes<br> - grid title gap 10<br> - grid title fontsize 12<br> - grid title font courier<br> - grid title fontweight bold<br> - grid title fontslant italic<br> - grid title color red<br> - grid labels yes<br> - grid labels text1 {Hello World}<br> - </tt><tt><tt>grid labels text2 {Hello World}<br> - </tt>grid labels def1 yes<br> - grid labels def2 yes<br> - </tt><tt><tt>grid labels gap1 10<br> - </tt>grid labels gap2 10<br> - grid labels font courier<br> - grid labels fontsize 12<br> - grid labels fontweight bold<br> - grid labels fontslant italic<br> - grid labels color red<br> - grid reset<br> - grid load foo.grd <br> - grid save foo.grd<br> - grid open<br> - grid close<br> - </tt> - <p><b> <a name="header"></a>header</b></p> - <p>Display current fits header dialog. Optional extension number - maybe specified. Please note, this differs from samp fits - header.</p> - <tt> Syntax: <br> - header [<ext>]<br> - [close [<ext>]]<br> - [save [<ext>] - <filename>]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - header<br> - header 2<br> - header close<br> - </tt> - <p><b> <a name="height"></a>height</b></p> - <p>Set the height of the image display window. </p> - <tt> Syntax: <br> - height [<value>]<br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - height<br> - ds9.set(string cmd)<br> - height 512<br> - </tt> - <p><b> <a name="iconify"></a>iconify</b></p> - <p>Toggles iconification. </p> - <tt> Syntax: <br> - iconify []<br> - [yes|no] <br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - iconify <br> - ds9.set(string cmd)<br> - iconify<br> - iconify yes</tt><br> - <p><b><a name="iexam"></a>iexam</b></p> - <p>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 - <tt>button</tt>. In the last form, the following macros will be - expanded if present: <tt>$width, $height, $depth, $bitpix, - $filename, $regions, $filename[$regions], $env, $pan, $value, - $x, $y, $z.</tt> See <a - href="file:///Users/joye/saods9/doc/ref/analysis.html#macros">Analysis - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Macros</a> for more information.</p> - <tt> Syntax: <br> - iexam []<br> - </tt><tt><tt> [[]|button|key|any] - coordinate <coordsys> [<skyframe>] - [<skyformat>]<br> - [[]|button|key|any] data - [width][height]<br> - </tt><tt><tt> [[]|button|key|any] - <macro string>]<br> - </tt></tt><br> - Example:<br> - string value = ds9.get(string cmd)<br> - </tt><tt><tt>iexam<br> - </tt>iexam coordinate image<br> - iexam key coordinate image # return coordinate and key event<br> - iexam coordinate wcs fk5 degrees<br> - iexam coordinate wcs galactic sexagesimal<br> - iexam coordinate fk5<br> - iexam data # return data value<br> - iexam key data # return data value and key event<br> - iexam data 3 3 # return all data in 3x3 box about selected point<br> - iexam {'Click at $x,$y in file $filename'}</tt><br> - <p><b><a name="iis"></a>iis</b></p> - <p>Set/Get IIS Filename. Optional mosaic number maybe supplied.</p> - <tt> Syntax: <br> - iis [filename <filename> [#]]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - iis filename<br> - iis filename 4<br> - ds9.set(string cmd)<br> - iis filename foo.fits<br> - iis filename bar.fits 4</tt><br> - <p><b> <a name="jpeg"></a>jpeg</b></p> - <p>Load JPEG image into current frame. Optional parameters: <tt>jpeg - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - </tt>quality (1-100) </p> - <tt> Syntax:<br> - jpeg [new|slice] [<filename>] [1-100]<br> - <br> - Example: <br> - </tt><tt><tt>string value = ds9.get(string cmd)<br> - </tt>jpeg</tt><br> - <tt><tt>jpeg 100</tt><br> - </tt><tt><tt>ds9.set(string cmd)<br> - </tt>jpeg foo.jpeg</tt><br> - <tt><tt>jpeg new foo.jpeg<br> - </tt></tt><tt><tt><tt>jpeg slice foo.jpeg<br> - </tt></tt>jpeg</tt><br> - <tt><tt>jpeg</tt><tt> new<br> - </tt>jpeg</tt><tt> slice</tt> - <p><b> <a name="lock"></a>lock</b></p> - <p>Lock all other frames to the current frame. </p> - <tt> Syntax: <br> - </tt><tt>lock</tt><tt> </tt><tt>[frame <coordsys>|none]<br> - </tt><tt>[crosshair - <coordsys>|none] </tt><tt><br> - </tt><tt> [crop <coordsys>|none]</tt><br> - <tt> [slice <coordsys>|none]</tt><br> - <tt> </tt><tt> [bin [yes|no]]<br> - [axes [yes|no]]<br> - [scale [yes|no]]<br> - [scalelimits [yes|no]]<br> - [colorbar [yes|no]]<br> - [block [yes|no]]<br> - </tt><tt> [smooth [yes|no]]</tt><tt><br> - </tt><tt> [3d [yes|no]]</tt><tt><br> - </tt><tt> </tt><tt><br> - Example:<br> - </tt><tt>string value = ds9.get(string cmd) <br> - </tt><tt>lock frame<br> - lock crosshair<br> - </tt><tt>lock crop</tt><br> - <tt> lock slice</tt><br> - <tt>lock bin<br> - lock axes<br> - lock scale<br> - lock scalelimits<br> - lock color</tt><tt>bar<br> - lock block<br> - </tt><tt>lock smooth<br> - </tt><tt>lock 3d<br> - </tt><tt>ds9.set(string cmd)<br> - </tt><tt>lock frame wcs</tt><tt><br> - </tt><tt>lock crosshair wcs<br> - </tt><tt>lock crop wcs</tt><br> - <tt>lock slice wcs</tt><br> - <tt>lock bin yes<br> - lock axes yes<br> - </tt><tt>lock scale yes<br> - lock scalelimits yes<br> - </tt><tt>lock colorbar yes</tt><tt><br> - lock block yes</tt><br> - <tt>lock smooth yes<br> - </tt><tt>lock 3d yes<br> - <br> - </tt><b><a name="lower"></a>lower</b> - <p>Lower in the window stacking order. </p> - <tt> Syntax: <br> - lower <br> - <br> - Example: <br> - ds9.set(string cmd)<br> - lower</tt><tt><br> - </tt> - <p><b> <a name="magnifier"></a>magnifier</b></p> - <p>Controls the magnifier settings. </p> - <tt> Syntax: <br> - magnifier [color <color>]<br> - [zoom - <value>]<br> - [cursor - yes|no]<br> - [region - yes|no]<br> - <br> - Example:<br> - string value = ds9.get(string cmd) <br> - magnifier color<br> - magnifier zoom<br> - magnifier cursor<br> - magnifier region<br> - ds9.set(string cmd)<br> - magnifier color yellow<br> - magnifier zoom 2<br> - magnifier cursor no<br> - magnifier region no<br> - </tt> - <p><b><a name="mask"></a>mask<br> - </b></p> - <p>Controls mask parameters. </p> - <tt> Syntax: <br> - mask [color <color>]<br> - [mark 1|0]<br> - [transparency <value>]<br> - [clear]<br> - [open|close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - mask color<br> - mask mark<br> - mask transparency<br> - ds9.set(string cmd)<br> - mask color red<br> - mask mark 0<br> - mask transparency 50<br> - mask clear<br> - mask open<br> - mask close<br> - </tt> - <p><b> <a name="match"></a>match</b></p> - <p>Match all other frames to the current frame. </p> - <tt> Syntax: <br> - </tt><tt>match </tt><tt>[frame <coordsys>]<br> - </tt><tt>[crosshair - <coordsys>] </tt><tt><br> - </tt><tt> [crop <coordsys>]<br> - </tt><tt> [slice <coordsys>]<br> - </tt><tt> [bin]<br> - [axes]<br> - [scale]<br> - [scalelimits]<br> - [colorbar]<br> - [block]<br> - [smooth]</tt><tt><br> - [3d]<br> - </tt><tt> <br> - Example:<br> - ds9.set(string cmd)<br> - </tt><tt>match frame wcs <br> - </tt><tt>match crosshair wcs<br> - </tt><tt>match crop wcs</tt><br> - <tt> match slice wcs<br> - match bin<br> - match axes<br> - match scale<br> - match scalelimits<br> - match color</tt><tt>bar<br> - match block<br> - match smooth<br> - match 3d<br> - </tt> - <p><b> <a name="mecube"></a>mecube</b></p> - <p>Load FITS multiple extension file as data cube.<br> - </p> - <tt> Syntax:<br> - mecube [new] [<filename>]<br> - <br> - Example: </tt><br> - <tt>string value = ds9.get(string cmd)</tt><tt><tt><br> - </tt>mecube<br> - </tt><tt><tt><tt>ds9.set(string cmd)<br> - </tt></tt>mecube foo.fits</tt><br> - <tt><tt>mecube new foo.fits<br> - </tt>mecube</tt><br> - <tt>mecube</tt><tt> new</tt> - <p><b> <a name="minmax"></a>minmax</b></p> - <p>This is how DS9 determines the min and max data values - from the data. <tt>SCAN</tt> will scan all data.</p> - <tt> Syntax: <br> - minmax [scan|sample|datamin|irafmin] <br> - [mode - scan|sample|datamin|irafmin]<br> - [interval #]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - minmax mode<br> - minmax sample <br> - ds9.set(string cmd)<br> - minmax scan <br> - minmax mode scan<br> - minmax interval 100<br> - </tt> - <p><b> <a name="mode"></a>mode</b></p> - <p>Controls the first mouse button mode. </p> - <tt> Syntax: <br> - mode - [none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine] - <br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - mode <br> - ds9.set(string cmd)<br> - mode crosshair</tt><br> - <p><b> <a name="mosaic"></a>mosaic</b></p> - <p>Load FITS mosaic segment into current frame.</p> - <tt> Syntax:<br> - mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>]<br> - <br> - Example: <br> - </tt><tt><tt>string value = ds9.get(string cmd)<br> - </tt>mosaic</tt><tt><br> - </tt><tt><tt>ds9.set(string cmd)<br> - </tt>mosaic foo.fits</tt><br> - <tt><tt>mosaic wcs foo.fits</tt></tt><br> - <tt><tt>mosaic wcs new foo.fits</tt></tt><br> - <tt><tt>mosaic wcs mask foo.fits</tt></tt><tt><tt><tt><br> - </tt></tt>mosaic</tt><br> - <tt><tt>mosaic wcs<br> - mosaic wcs</tt><tt> new<br> - </tt>mosaic wcs</tt><tt> mask<br> - </tt> - <p><b> <a name="mosaicimage"></a>mosaicimage</b></p> - <p>Load FITS mosaic image into current frame.</p> - <tt> Syntax:<br> - mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] - [<filename>]<br> - <br> - Example: <br> - </tt><tt><tt>string value = ds9.get(string cmd)<br> - </tt>mosaicimage</tt><tt><br> - </tt><tt><tt>ds9.set(string cmd)<br> - </tt>mosaicimage foo.fits</tt><br> - <tt><tt>mosaicimage wcs foo.fits</tt></tt><br> - <tt><tt>mosaicimage wcs new foo.fits</tt></tt><br> - <tt><tt>mosaicimage wcs mask foo.fits</tt></tt><tt><tt><tt><br> - </tt></tt>mosaicimage</tt><br> - <tt><tt>mosaicimage wcs<br> - mosaicimage wcs new</tt><tt><br> - </tt>mosaicimage wcs mask</tt> - <p><b><a name="movie"></a>movie</b></p> - <p>Create mpeg1 movie from snap shots of the DS9 window. A <tt>slice</tt> - movie cycles though all slices of a cube. A <tt>frame</tt> - movie cycles through all active frames. A <tt>3d</tt> movie - cycles through specified viewing angles. The default is <tt>frame</tt>. - Optional parameters for <tt>3d</tt>: number of frames, azimuth - from/to, elevation from/to, slice from/to, oscillate/repeat - times.</p> - <tt> Syntax:<br> - movie </tt><tt>[slice|frame|3d] </tt><tt><filename><br> - </tt><tt>movie 3d <filename> - [number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat - <#>]</tt><br> - <tt> <br> - Example:<br> - ds9.set(string cmd)<br> - movie slice ds9.mpg<br> - </tt><tt>movie 3d ds9.mpg number 10 azfrom -60 azto 60 oscillate 1</tt><br> - <p><b> <a name="multiframe"></a>multiframe</b></p> - <p>Load FITS multiple extension file as multiple images.<br> - </p> - <tt> Syntax:<br> - multiframe [<filename>]<br> - <br> - Example: <br> - </tt><tt><tt>ds9.set(string cmd)<br> - </tt>multiframe foo.fits</tt><tt><tt><br> - </tt>multiframe</tt><br> - <p><b> <a name="nameserver"></a>nameserver</b></p> - <p>Support Name Server functions. Coordinates are in fk5. </p> - <tt> Syntax: <br> - nameserver [<object>] <br> - - [name <object>]<br> - - [server ned-sao|ned-cds|simbad-sao|simbad-cds|</tt><tt><tt>vizier-sao|vizier-cds</tt>]<br> - - [skyformat degrees|sexagesimal]<br> - - [pan]<br> - - [crosshair]<br> - [close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - nameserver<br> - nameserver server<br> - nameserver skyformat<br> - nameserver m31<br> - ds9.set(string cmd)<br> - nameserver m31 <br> - nameserver name m31 <br> - nameserver server ned-sao <br> - nameserver skyformat sexagesimal<br> - nameserver pan<br> - nameserver crosshair<br> - nameserver open<br> - nameserver close<br> - </tt> - <p><b> <a name="nan"></a>nan</b></p> - <p>Set image not-a-number color. </p> - <tt> Syntax: <br> - nan <color><br> - <br> - Example:<br> - </tt><tt>string value = ds9.get(string cmd)<br> - nan</tt><br> - <tt>ds9.set(string cmd)<br> - nan red</tt><br> - <p><b> <a name="nrrd"></a>nrrd</b></p> - <p>Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: - array endian.<br> - </p> - <tt> Syntax: <br> - nrrd [native|little|big]<br> - nrrd [new|mask] [<filename>]<br> - <br> - Example:<br> - </tt><tt><tt>string value = ds9.get(string cmd)<br> - </tt>nrrd</tt><br> - <tt><tt>nrrd big<br> - </tt></tt><tt><tt><tt>ds9.set(string cmd</tt><tt>, string url</tt><tt>)<br> - </tt>nrrd foo.nrrd</tt></tt><br> - <tt><tt><tt><tt>nrrd new foo.nrrd</tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt>nrrd mask foo.nrrd<br> - </tt></tt></tt></tt></tt>nrrd</tt><br> - <tt>nrrd</tt><tt> new<br> - nrrd mask</tt><br> - <p><b> <a name="nvss"></a>nvss</b></p> - <p>Support for NRAO VLA Sky Survey.</p> - <tt> Syntax: <br> - nvss []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs fk5<br> - [size <width> <height> - degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - nvss name <br> - nvss coord <br> - nvss size<br> - nvss save<br> - nvss frame<br> - ds9.set(string cmd)<br> - nvss<br> - nvss m31 <br> - </tt><tt><tt>nvss name m31 <br> - </tt></tt><tt><tt><tt>nvss name clear<br> - </tt></tt>nvss 00:42:44.404 +41:16:08.78<br> - nvss size 60 60 arcmin<br> - nvss save yes<br> - nvss frame current<br> - nvss update frame<br> - nvss open<br> - nvss close<br> - </tt> - <p><b> <a name="orient"></a>orient</b></p> - <p>Controls the orientation of the current frame. </p> - <tt> Syntax: <br> - orient [none|x|y|xy] <br> - [open|close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - orient <br> - ds9.set(string cmd)<br> - orient xy<br> - orient open<br> - orient close<br> - </tt> - <p><b> <a name="pagesetup"></a>pagesetup</b></p> - <p>Controls Page Setup options. </p> - <tt> Syntax: <br> - pagesetup [orient portrait|landscape]</tt><br> - <tt> [scale - <numeric>]</tt><br> - <tt> [size - letter|legal|tabloid|poster|a4]</tt><br> - <tt> <br> - Example:<br> - string value = ds9.get(string cmd)<br> - pagesetup orient<br> - pagesetup scale <br> - pagesetup size <br> - ds9.set(string cmd)<br> - pagesetup orient portrait <br> - pagesetup scale 50<br> - pagesetup size poster<br> - </tt> - <p><b> <a name="pan"></a>pan</b></p> - <p>Controls the current image cursor location for the current - frame. </p> - <tt> Syntax: <br> - pan [<x> <y> <coordsys> - [<skyframe>][<skyformat>]] # relative<br> - [to <x> <y> <coordsys> - [<skyframe>][<skyformat>] # absolute<br> - [open|close]<br> - [close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - pan # get current image coords <br> - pan wcs fk4 sexagesimal # get current wcs coords <br> - ds9.set(string cmd)<br> - pan 200 200 image # pan relative <br> - pan to 400 400 physical # pan to physical coords <br> - pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords<br> - pan open<br> - pan close<br> - </tt> - <p><b> <a name="pixeltable"></a>pixeltable</b></p> - <p>Display/Hide the pixel table. </p> - <tt> Syntax: <br> - pixeltable []<br> - [yes|open] <br> - [no|close]<br> - <br> - Example:<br> - string url = ds9.get(string cmd)<br> - pixeltable <br> - ds9.set(string cmd)<br> - pixeltable<br> - pixeltable yes<br> - pixeltable open<br> - pixeltable close<br> - </tt> - <p><b> <a name="plot"></a>plot</b></p> - <p>Display and configure data plots. All plot commands take an - optional second command, the plot name. If no plot name is - specified, the last plot created is assumed. Plot data is - assumed to be a pair of coordinates, with optional error values. - The follow are valid data descriptions:</p> - <blockquote>xy x and y coordinates<br> - xyex x,y coordinates with x errors<br> - xyey x,y coordinates with y errors<br> - xyexey x,y coordinates with x and y - errors<br> - </blockquote> - <p>To create a new plot, use the plot new command.</p> - <tt> Syntax: <br> - </tt><tt># create new empty plot window<br> - plot []<br> - [line|bar|scatter]<br> - </tt><tt><tt><tt><tt> [new]<br> - </tt></tt> [new line|bar|scatter]<br> - </tt></tt><tt><tt><tt><tt><tt><tt> [new - name <plotname>]<br> - </tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - [new name <plotname> line|bar|scatter]</tt></tt></tt></tt></tt></tt></tt></tt><br> - </tt><tt><br> - </tt><tt><tt># </tt><tt><tt><tt>load data into existing plot from - stdin</tt></tt> <br> - plot [[<plotname>] data xy|xyex|xyey|xyexey]<br> - </tt><tt><tt><br> - </tt></tt># existing plot<br> - plot </tt><tt><tt>[[<plotname>] load <filename> - xy|xyex|xyey|xyexey]<br> - [[<plotname>] save - <filename>]<br> - </tt> [[<plotname>] clear]<br> - </tt><tt><tt><tt><tt><tt><tt> </tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - duplicate [#]]<br> - </tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - </tt>[[<plotname>] stats yes|no]<br> - </tt></tt> </tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - list yes|no]<br> - </tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - loadconfig <filename>]<br> - [[<plotname>] saveconfig - <filename>]<br> - </tt></tt></tt></tt></tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [[<plotname>] pagesetup orient portrait|landscape]<br> - [[<plotname>] pagesetup - size letter|legal|tabloid|poster|a4]</tt><br> - <tt> </tt></tt></tt></tt></tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [[<plotname>] print]<br> - [[<plotname>] print - destination printer|file]<br> - [[<plotname>] print - command <command>]<br> - [[<plotname>] print - filename <filename>]<br> - [[<plotname>] print color - rgb|gray]<br> - </tt> </tt>[[<plotname>] - close</tt></tt></tt><tt><tt><tt><tt><tt><tt><tt>]<br> - </tt>[[<plotname>] - mode pointer|zoom]<br> - </tt></tt></tt></tt></tt></tt><tt><br> - # configure graph<br> - plot [[<plotname>] axis x|y grid yes|no]<br> - [[<plotname>] axis x|y log - yes|no]<br> - </tt><tt> [[<plotname>] axis x|y - flip yes|no]</tt><br> - <tt><tt> [[<plotname>] axis x|y auto - yes|no]<br> - [[<plotname>] axis x|y min - <value>]<br> - [[<plotname>] axis x|y max - <value>]</tt><tt><br> - </tt><tt><tt> [[<plotname>] axis x|y - format <string>]</tt><tt><br> - </tt></tt> </tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - legend yes|no]<br> - [[<plotname>] legend position - right|left|top|bottom]</tt><br> - </tt><tt><tt> [[<plotname>] font - title|labels|numbers font times|helvetica|courier]<br> - [[<plotname>] font </tt></tt><tt><tt><tt><tt>title|labels|numbers</tt></tt> - size <value>]<br> - [[<plotname>] font </tt></tt><tt><tt><tt><tt>title|labels|numbers</tt></tt> - weight normal|bold]<br> - [[<plotname>] font </tt></tt><tt><tt><tt><tt>title|labels|numbers</tt></tt> - slant roman|italic]<br> - </tt></tt><tt> [[<plotname>] title - <string>]</tt><br> - <tt><tt> [[<plotname>] title x|y - <string>]<br> - [</tt></tt><tt><tt><tt><tt>[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - barmode normal|stacked|aligned|overlap]<br> - <br> - </tt> # configure current dataset<br> - </tt>plot [[<plotname>] show yes|no]<br> - </tt> </tt><tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - shape - circle|square|diamond|plus|splus|scross|triangle|arrow]</tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt> <tt> </tt></tt><tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - shape fill yes|no]</tt></tt></tt></tt></tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt><tt><tt><tt> <tt> - </tt></tt><tt><tt><tt><tt>[[<plotname>] - shape color <value>]</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - <tt> </tt></tt><tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - smooth - step|linear|cubic|quadratic|catrom]</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - <tt> </tt></tt><tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - color - <value>]</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - <tt> </tt></tt><tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - width - <value>]<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - <tt> </tt></tt><tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - dash yes|no]</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - <tt> </tt></tt><tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - error yes|no]</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - <tt> </tt></tt><tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - error color - <value>]</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - color - <value>]</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - <tt> </tt></tt><tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - error width - <value>]</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - <tt> </tt></tt><tt><tt><tt><tt>[[<plotname>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - name - <string>]<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><br> - # select current dataset<br> - </tt></tt></tt>plot [[<plotname>] select - <value>]<br> - </tt><tt> </tt><tt> <br> - Example: <br> - # return all plotnames<br> - string value = ds9.get(string cmd)<br> - plot<br> - <br> - # create new empty plot window<br> - ds9.set(string cmd)</tt><br> - <tt><tt>plot<br> - plot bar<br> - plot new<br> - plot new bar<br> - plot new name foo<br> - plot new name foo bar<br> - <br> - </tt># load additional dataset into an existing plot<br> - ds9.set(string cmd, string url)<br> - plot data xy # plot additional data<br> - plot foo data xy # plot additional data<br> - </tt><tt><tt><tt><tt><tt><tt><tt><br> - </tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>string - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - value = ds9.get(string cmd)<br> - </tt></tt></tt></tt></tt></tt>plot - stats<br> - plot list<br> - </tt></tt></tt>ds9.set(string cmd)<br> - </tt></tt></tt></tt>plot load foo.dat xy<br> - plot save foo.dat<br> - </tt></tt><tt><tt>plot clear<br> - plot duplicate 1<br> - plot stats yes<br> - plot list yes<br> - </tt></tt><tt><tt>plot loadconfig foo.plt<br> - plot saveconfig foo.plt<br> - </tt></tt><tt><tt>plot pagesetup orient portrait<br> - plot pagesetup size letter<br> - </tt></tt><tt><tt>plot print<br> - plot print destination file<br> - plot print command lp<br> - plot print filename foo.ps<br> - plot print color rgb<br> - </tt>plot close<br> - </tt></tt><tt><tt><tt><tt><br> - string value = ds9.get(string cmd)<br> - </tt>plot mode<br> - </tt></tt></tt><tt><tt><tt><tt>ds9.set(string cmd)<br> - </tt>plot mode pointer</tt><br> - </tt><tt><br> - # configure plot<br> - </tt></tt><tt><tt><tt><tt><tt><tt>string value = ds9.get(string - cmd)<br> - </tt></tt></tt></tt>plot axis x grid<br> - </tt><tt><tt>plot axis x log<br> - </tt></tt><tt><tt><tt>plot axis x flip</tt></tt></tt><br> - </tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - axis x auto<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - axis x min<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - axis x max<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - axis x format<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - legend<br> - </tt></tt></tt></tt><tt><tt><tt><tt><tt>plot legend - position<br> - </tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt>plot - font numbers font<br> - </tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - font numbers size<br> - </tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - font numbers weight<br> - </tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - font numbers slant<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - title<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - title x<br> - plot barmode<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt> - </tt></tt></tt></tt><tt><tt><tt>ds9.set(string cmd)<br> - </tt>plot axis x grid yes<br> - plot axis x log yes</tt><br> - <tt>plot axis x flip yes</tt><tt><br> - </tt></tt><tt><tt><tt><tt>plot axis x auto no<br> - plot axis x min 0<br> - plot axis x max 100<br> - </tt></tt><tt><tt><tt><tt>plot axis x format "%f"<br> - </tt></tt></tt></tt></tt></tt><br> - <tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>string value = - ds9.get(string cmd)<br> - </tt></tt></tt></tt></tt></tt>plot legend<br> - </tt></tt></tt></tt><tt><tt><tt><tt><tt>plot legend - position<br> - </tt></tt></tt></tt></tt></tt><tt><tt><tt><tt>ds9.set(string - - - - - - - - - - - - - cmd)<br> - </tt></tt></tt>plot legend yes<br> - </tt><tt>plot legend position left</tt><tt><tt><tt><tt><br> - <br> - </tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>string - - - - - - - - - - - - - value = ds9.get(string cmd)<br> - </tt></tt></tt></tt></tt></tt>plot font - numbers font<br> - </tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - font numbers size<br> - </tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - font numbers weight<br> - </tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - font numbers slant<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt>ds9.set(string - - - - - - - - - - - - - cmd)<br> - </tt></tt></tt>plot font numbers font times<br> - plot font numbers size 12<br> - plot font numbers weight bold<br> - plot font numbers slant italic<br> - </tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>string - - - - - - - - - - - - - value = ds9.get(string - cmd)<br> - </tt></tt></tt></tt></tt></tt>plot - - - - - - - - - - - - - title<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - title xaxis</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - title yaxis</tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt>ds9.set(string - - - - - - - - - - - - - cmd)<br> - </tt></tt></tt>plot title "This is a Title"<br> - plot title x "X Axis"<br> - plot title y "Y Axis"<br> - plot title legend "This is the Legend"<br> - </tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>string - - - - - - - - - - - - - value = - ds9.get(string - cmd)<br> - </tt></tt></tt></tt></tt></tt>plot - - - - - - - - - - - - - barmode<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt> - </tt></tt></tt></tt></tt></tt><tt><tt><tt><tt>ds9.set(string - - - - - - - - - - - - - cmd)<br> - </tt></tt></tt>plot barmode aligned<br> - </tt><tt><tt><br> - # configure current dataset<br> - </tt></tt><tt><tt><tt><tt><tt><tt>string value = ds9.get(string - cmd)<br> - </tt></tt></tt></tt>plot show<br> - plot shape</tt> <br> - <tt><tt>plot shape fill<br> - </tt></tt><tt><tt><tt>plot shape color<br> - </tt></tt></tt><tt><tt><tt><tt>plot smooth<br> - </tt></tt></tt></tt><tt><tt><tt><tt><tt>plot color<br> - </tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt>plot - width<br> - </tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - dash<br> - </tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - error<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - error color<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - error width<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>plot - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - name<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt>ds9.set(string - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - cmd)<br> - </tt>plot show yes<br> - plot shape circle<br> - </tt><tt><tt>plot shape fill no<br> - </tt></tt><tt><tt><tt>plot shape color cyan<br> - </tt></tt></tt><tt><tt>plot smooth step<br> - </tt>plot color red<br> - plot width 2<br> - plot dash yes<br> - plot error yes<br> - plot error color red</tt><br> - <tt>plot error width 2</tt><br> - <tt>plot name "My Data"</tt><br> - <tt><br> - # select current dataset<br> - </tt></tt><tt><tt><tt><tt><tt><tt>string value = ds9.get(string - cmd)<br> - </tt></tt></tt></tt>plot select<br> - </tt></tt><tt><tt><tt>ds9.set(string cmd)<br> - </tt>plot select 2</tt><br> - <br> - </tt><b><b><a name="png"></a></b>png</b> - <p>Load PNG image into current frame.<br> - </p> - <tt> Syntax:<br> - png [new|slice] [<filename>]<br> - <br> - Example: <br> - </tt><tt><tt>string value = ds9.get(string cmd)<br> - </tt>png</tt><br> - <tt><tt>ds9.set(string cmd)<br> - </tt>png foo.png</tt><br> - <tt><tt>png new foo.png<br> - </tt></tt><tt><tt><tt>png slice foo.png<br> - </tt></tt>png</tt><br> - <tt><tt>png</tt><tt> new<br> - </tt>png</tt><tt> slice</tt><br> - <p><b> <a name="precision"></a>precision</b></p> - <p>Set region and coordinate output format precision. </p> - <tt> Syntax: <br> - precision <linear> </tt><tt><tt><degree></tt> </tt><tt><tt><hms> - - - - - - - - - - - - - - - - </tt></tt><tt><tt><tt><dms></tt></tt></tt><tt><tt><tt><tt> - <arcmin> </tt></tt></tt></tt><tt><tt><tt><tt><tt><arcsec><br> - <br> - </tt></tt></tt></tt>Example:<br> - string value = ds9.get(string cmd)<br> - precision<br> - ds9.set(string cmd)<br> - precision 8 10 4 3 5 3</tt><br> - <b> </b> - <p><b> <a name="prefs"></a>prefs</b></p> - <p>Controls various preference settings. </p> - <tt> Syntax: <br> - prefs [clear]<br> - [irafalign yes|no]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - prefs irafalign<br> - ds9.set(string cmd)<br> - prefs clear<br> - prefs irafalign<br> - <br> - </tt><b><a name="preserve"></a>preserve</b> - <p>Preserve the follow attributes while loading a new image. </p> - <tt> Syntax: <br> - preserve [pan yes|no]<br> - [regions yes|no]<br> - <br> - Example: <br> - string value = ds9.get(string cmd) <br> - preserve pan<br> - preserve regions<br> - ds9.set(string cmd)<br> - preserve pan yes<br> - preserve regions yes<br> - </tt> - <p><b><a name="psprint"></a>psprint</b></p> - <p>Invokes postscript printing. Please see <a - href="file:///Users/joye/saods9/ds9/doc/ref/command.html#print">print</a> - for further details.</p> - <p><b> <a name="print"></a>print</b></p> - <p>Controls printing. Use print option to set printing options.</p> - <tt> Syntax: <br> - print [destination printer|file] <br> - [command <command>] <br> - [filename <filename>]<br> - [color rgb|cmyk|gray] <br> - [level 1|2] <br> - [resolution 53|72|75|150|300|600] - <br> - <br> - Example: <br> - string value = ds9.get(string cmd) <br> - print destination <br> - print command <br> - print filename <br> - print color<br> - print level <br> - print resolution <br> - ds9.set(string cmd)<br> - print <br> - print destination file <br> - print command lp<br> - print filename foo.ps <br> - print color cmyk <br> - print level 2 <br> - print resolution 75 </tt> - <p><b> <a name="raise"></a>raise</b></p> - <p>Raise in the window stacking order. </p> - <tt> Syntax: <br> - raise <br> - <br> - Example: <br> - ds9.set(string cmd)<br> - raise </tt> - <p><b> <a name="regions"></a>regions</b></p> - <p>Controls regions in the current frame. </p> - <tt> Syntax: <br> - regions [<filename>]<br> - [load [all] - <filename>] <br> - [save - <filename>] <br> - [list [close]]<br> - [epsilon - <integer>]<br> - [show yes|no]<br> - [showtext yes|no]<br> - [centroid]<br> - [centroid auto - yes|no]<br> - [centroid radius - <value>|iteration <value>]<br> - [getinfo]<br> - [move front] <br> - [move back]<br> - [select all]<br> - [select none] <br> - [select invert]<br> - [delete all] <br> - [delete select] <br> - [format - ds9|xml|ciao|saotng|saoimage|pros|xy] <br> - [system - image|physical|wcs|wcsa...wcsz]<br> - [sky - fk4|fk5|icrs|galactic|ecliptic] <br> - [skyformat - degrees|sexagesimal]<br> - [strip yes|no]<br> - [shape <shape>]<br> - [color - &ltcolor>]<br> - [width <width>]<br> - </tt><tt> - [fixed|edit|rotate|delete yes|no]<br> - - [include|exclude|source|background]</tt><br> - <tt> </tt><tt> [command - <marker command>]<br> - [composite]<br> - [dissolve]<br> - [template - <filename>]<br> - [template <filename> - at <ra> <dec> <coordsys> <skyframe>]<br> - [savetemplate - <filename>]<br> - [groups] <br> - [group new]<br> - [group <tag> - new]<br> - [group <tag> - update]<br> - [group <tag> select]<br> - [group <tag> color - <color>] <br> - [group <tag> copy] <br> - [group <tag> delete] - <br> - [group <tag> cut]<br> - [group <tag> font - <font>] <br> - [group <tag> move - <int> <int>]<br> - [group <tag> - movefront] <br> - [group <tag> - moveback] <br> - [group <tag> - property <property> yes|no] <br> - [copy]<br> - [cut]<br> - [paste - image|physical|wcs|wcsa...wcsz]<br> - [undo]<br> - - [include|exclude|source|background|selected]<br> - [-format - ds9|ciao|saotng|saoimage|pros|xy]<br> - [-system - image|physical|wcs|wcsa...wcsz]<br> - [-sky - fk4|fk5|icrs|galactic|ecliptic] <br> - [-skyformat - degrees|sexagesimal]<br> - [-prop - select|edit|move|rotate|delete|fixed|include|source 1|0] <br> - [-group <tag>]<br> - [-strip yes|no]<br> - [-wcs yes|no]<br> - <br> - Example: <br> - string url = ds9.get(string cmd)<br> - regions<br> - regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal - -prop edit 1 -group foo <br> - string value = ds9.get(string cmd) <br> - regions epsilon<br> - regions show<br> - regions showtext<br> - regions centroid<br> - regions centroid auto<br> - regions centroid radius<br> - regions centroid iteration<br> - regions selected<br> - regions format <br> - regions system <br> - regions sky <br> - regions skyformat <br> - regions strip<br> - regions shape <br> - regions color <br> - regions width<br> - regions source <br> - regions background <br> - regions include <br> - regions exclude <br> - regions selected<br> - regions groups<br> - ds9.set(string cmd, string url)<br> - regions -format xy -system wcs -sky fk5<br> - regions -format ds9<br> - ds9.set(string cmd)<br> - regions foo.reg <br> - regions -format ciao bar.reg # load as ciao format<br> - regions foo.fits # FITS regions files do not need a format - specification<br> - regions load foo.reg # load foo.reg into current frame<br> - regions load all foo.reg # load foo.reg into all frames<br> - regions load *.reg# expand *.reg and load into current frame<br> - regions load all *.reg # expand *.reg and load into all frames<br> - regions save foo.reg<br> - regions list <br> - regions list close<br> - regions epsilon 5<br> - regions show yes<br> - regions showtext no<br> - regions centroid<br> - regions centroid auto yes<br> - regions centroid radius 10<br> - regions centroid iteration 20<br> - regions getinfo<br> - regions move back <br> - regions move front <br> - regions select all <br> - regions select none <br> - regions select invert<br> - regions delete all <br> - regions delete select <br> - regions format ds9 <br> - regions system wcs<br> - regions sky fk5 <br> - regions skyformat degrees <br> - regions strip yes<br> - regions shape ellipse <br> - regions color red <br> - regions width 3<br> - regions edit yes<br> - regions include<br> - regions command "circle 100 100 20 # color=red"<br> - regions composite<br> - regions dissolve<br> - regions template foo.tpl<br> - regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5<br> - regions savetemplate foo.tpl<br> - regions group new<br> - regions group foo new<br> - regions group foo update<br> - regions group foo select<br> - regions group foo color red<br> - regions group foo copy<br> - regions group foo delete<br> - regions group foo cut<br> - regions group foo font 'times 14 bold'<br> - regions group foo move 100 100 <br> - regions group foo movefront <br> - regions group foo moveback <br> - regions group foo property delete no <br> - regions copy<br> - regions cut<br> - regions paste wcs<br> - regions undo<br> - </tt> - <p><b> <a name="restore"></a>restore</b></p> - <p>Restore DS9 to a previous state from a backup save set. </p> - <tt> Syntax: <br> - restore <filename><br> - <br> - Example:<br> - restore ds9.bck</tt><br> - <p><b> <a name="rgb"></a>rgb</b></p> - <p>Create RGB frame and control RGB frame parameters.</p> - <tt> Syntax: <br> - rgb []<br> - [red|green|blue]<br> - [channel [red|green|blue]]<br> - [view [red|green|blue] [yes|no]]<br> - [system <coordsys>]<br> - [lock - wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth - [yes|no]]<br> - [open|close]<br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - rgb channel<br> - </tt><tt>rgb lock wcs</tt><br> - <tt>rgb lock crop</tt><br> - <tt>rgb lock slice</tt><br> - <tt> rgb lock bin<br> - rgb lock scale<br> - rgb lock scalelimits<br> - rgb lock colorbar<br> - rgb lock block<br> - rgb lock smooth<br> - rgb system<br> - rgb view red<br> - rgb view green<br> - rgb view blue<br> - ds9.set(string cmd)<br> - rgb # create new rgb frame<br> - rgb red # set current channel to red<br> - rgb channel red # set current channel to red<br> - rgb view blue no # turn off blue channel<br> - rgb system wcs # set rgb coordinate system<br> - </tt><tt>rgb lock wcs yes</tt><br> - <tt>rgb lock crop yes</tt><br> - <tt>rgb lock slice yes</tt><br> - <tt>rgb lock bin yes</tt><br> - <tt> rgb lock scale yes<br> - rgb lock scalelimits yes<br> - rgb lock colorbar yes<br> - rgb lock block yes<br> - rgb lock smooth yes<br> - rgb open<br> - rgb close</tt><br> - <p><b> <a name="rgbarray"></a>rgbarray</b></p> - <p>Load raw data array cube into rgb frame.<br> - </p> - <tt> Syntax:<br> - rgbarray [native|big|little]<br> - rgbarray [new] + [has contour [aux]]]<br> + [has fits [ |bin|cube|mosaic]]<br> + [has marker +[highlite|paste|select|undo]]<br> + [has system +<coordsys>]<br></tt> +<tt><tt><tt><tt> [has wcs +[<wcssys>]]<br></tt> [has wcs +celestial [<wcssys>]]<br></tt> +[has wcs linear [<wcssys>]]<br> + </tt><br> +Example:<br> +string value = ds9.get(string cmd)<br> +frame # returns the id of the current frame<br> +frame frameno # returns the id of the current frame<br> +frame all # returns the id of all frames<br> +frame active # returns the id of all active frames<br> +frame lock<br> +frame has amplifier<br> +frame has datamin<br> +frame has datasec<br> +frame has detector<br> +frame has grid<br> +frame has iis<br> +frame has irafmin<br> +frame has physical<br> +frame has smooth<br> +frame has contour<br> +frame has contour aux<br> +frame has fits<br> +frame has fits bin<br> +frame has fits cube<br> +frame has fits mosaic<br> +frame has marker highlite<br> +frame has marker paste<br> +frame has marker select<br> +frame has marker undo<br> +frame has system physical<br> +frame has wcs wcsa<br> +frame has wcs celestial wcsa<br> +frame has wcs linear wcsa<br> +ds9.set(string cmd)<br> +frame center # center current frame<br> +frame center 1 # center 'Frame1'<br> +frame center all # center all frames<br> +frame clear # clear current frame<br> +frame new # create new frame<br> +frame new rgb # create new rgb frame<br> +frame delete # delete current frame<br> +frame reset # reset current frame<br> +frame refresh # refresh current frame<br> +frame hide # hide current frame<br> +frame show 1 # show frame 'Frame1'<br> +frame move first # move frame to first in order<br> +frame move back # move frame back in order<br> +frame move forward # move frame forward in order<br> +frame move last # move frame to last in order<br> +frame first # goto first frame<br> +frame prev # goto prev frame<br> +frame next # goto next frame<br> +frame last # goto last frame<br> +frame frameno 4 # goto frame 'Frame4', create if needed<br> +frame 3 # goto frame 'Frame3', create if needed<br> +frame match wcs<br> +frame lock wcs</tt><br> +<p><b><a name="gif" id="gif"></a>gif</b></p> +<p>Load GIF image into current frame.<br></p> +<tt>Syntax:<br> +gif [new|slice] [<filename>]<br> + <br> +Example:<br></tt> <tt><tt>string value = ds9.get(string +cmd)<br></tt> gif</tt><br> +<tt><tt>ds9.set(string cmd)<br></tt> gif foo.gif</tt><br> +<tt><tt>gif new foo.gif<br></tt></tt> <tt><tt><tt>gif slice +foo.gif<br></tt></tt> gif</tt><br> +<tt><tt>gif</tt> <tt>new<br></tt> gif</tt> <tt>slice</tt> +<p><b><a name="grid" id="grid"></a>grid</b></p> +<p>Controls coordinate grid. For grid numeric format syntax, +click <a href="grid.html#Format">here</a>.</p> +<tt>Syntax:<br> +grid []<br> + [yes|no]<br> + [type analysis|publication]<br> + [system <coordsys>]<br> + [sky <skyframe>]<br> + [skyformat <skyformat>]<br> + [grid yes|no]<br> + [grid color <color>]<br> + [grid width <value>]<br> + [grid dash yes|no]<br> + [grid gap1 <value>]<br></tt> +<tt><tt> [grid gap2 +<value>]<br></tt></tt> +<tt><tt><tt> [grid gap3 +<value>]<br></tt></tt> [axes +yes|no]<br> + [axes color <color>]<br> + [axes width <value>]<br> + [axes dash yes|no]<br> + [axes type +interior|exterior]<br></tt> <tt> +[axes origin lll|llu|lul|luu|ull|ulu|uul|uuu]</tt><br> +<tt> [format1 <format>]<br> + [format2 <format>]<br> + [tickmarks yes|no]<br> + [tickmarks color <color>]<br> + [tickmarks width <value>]<br> + [tickmarks dash yes|no]<br> + [border yes|no]<br> + [border color <color>]<br> + [border width <value>]<br> + [border dash yes|no]<br> + [numerics yes|no]<br> + [numerics font +times|helvetica|courier]<br> + [numerics fontsize +<value>]<br> + [numerics fontweight +normal|bold]<br> + [numerics fontslant +roman|italic]<br> + [numerics color <color>]<br> + [numerics gap1 +<value>]<br></tt> <tt><tt> +[numerics gap2 <value>]<br></tt></tt> +<tt><tt><tt> [numerics gap3 +<value>]<br></tt></tt> +[numerics type interior|exterior]<br> + [numerics vertical yes|no]<br> + [title yes|no]<br> + [title text <text>]<br> + [title def yes|no]<br> + [title gap <value>]<br> + [title font +times|helvetica|courier]<br> + [title fontsize <value>]<br> + [title fontweight normal|bold]<br> + [title fontslant roman|italic]<br> + [title color <color>]<br> + [labels yes|no]<br> + [labels text1 <text>]<br></tt> +<tt><tt> [labels text2 +<text>]<br></tt> [labels def1 +yes|no]<br> + [labels def2 yes|no]<br></tt> +<tt><tt> [labels gap1 +<value>]<br></tt> [labels gap2 +<value>]<br> + [labels font +times|helvetica|courier]<br> + [labels fontsize <value>]<br> + [labels fontweight normal|bold]<br> + [labels fontslant roman|italic]<br> + [labels color <color>]<br> + [reset]<br> + [load <filename>]<br> + [save <filename>]<br> + [open|close]<br> +<br> +Example:<br> +string value = ds9.get(string cmd)<br> +grid<br> +grid type<br> +grid system<br> +grid sky<br> +grid skyformat<br> +grid grid<br> +grid grid color<br> +grid grid width<br> +grid grid dash<br> +grid grid gap1<br></tt> <tt><tt>grid grid gap2<br></tt></tt> +<tt><tt><tt>grid grid gap3<br></tt></tt> grid axes<br> +grid axes color<br> +grid axes width<br> +grid axes dash<br> +grid axes type<br> +grid axes origin<br> +grid format1<br> +grid format2<br> +grid tickmarks<br> +grid tickmarks color<br> +grid tickmarks width<br> +grid tickmarks dash<br> +grid border<br> +grid border color<br> +grid border width<br> +grid border dash<br> +grid numerics<br> +grid numerics font<br> +grid numerics fontsize<br> +grid numerics fontweight<br> +grid numerics fontslant<br> +grid numerics color<br> +grid numerics gap1<br></tt> <tt><tt>grid numerics +gap2<br></tt></tt> <tt><tt><tt>grid numerics gap3<br></tt></tt> +grid numerics type<br> +grid numerics vertical<br> +grid title<br> +grid title text<br> +grid title def<br> +grid title gap<br> +grid title font<br> +grid title fontsize<br> +grid title fontweight<br> +grid title fontslant<br> +grid title color<br> +grid labels<br> +grid labels text1<br></tt> <tt><tt>grid labels text2<br></tt> grid +labels def1<br> +grid labels def2<br></tt> <tt><tt>grid labels gap1<br></tt> grid +labels gap2<br> +grid labels font<br> +grid labels fontsize<br> +grid labels fontweight<br> +grid labels fontslant<br> +grid labels color<br> +ds9.set(string cmd)<br> +grid<br> +grid yes<br> +grid type analysis<br> +grid system wcs<br> +grid sky fk5<br> +grid skyformat degrees<br> +grid grid yes<br> +grid grid color red<br> +grid grid width 2<br> +grid grid dash yes<br> +grid grid gap1 10<br></tt> <tt><tt>grid grid gap2 10<br></tt></tt> +<tt><tt><tt>grid grid gap3 10<br></tt></tt> grid axes yes<br> +grid axes color red<br> +grid axes width 2<br> +grid axes dash yes<br> +grid axes type exterior<br> +grid axes origin lll<br> +grid format1 d.2<br> +grid format2 d.2<br> +grid tickmarks yes<br> +grid tickmarks color red<br> +grid tickmarks width 2<br> +grid tickmarks dash yes<br> +grid border yes<br> +grid border color red<br> +grid border width 2<br> +grid border dash yes<br> +grid numerics yes<br> +grid numerics font courier<br> +grid numerics fontsize 12<br> +grid numerics fontweight bold<br> +grid numerics fontslant italic<br> +grid numerics color red<br> +grid numerics gap1 10<br></tt> <tt><tt>grid numerics gap2 +10<br></tt></tt> <tt><tt><tt>grid numerics gap3 10<br></tt></tt> +grid numerics type exterior<br> +grid numerics vertical yes<br> +grid title yes<br> +grid title text {Hello World}<br> +grid title def yes<br> +grid title gap 10<br> +grid title fontsize 12<br> +grid title font courier<br> +grid title fontweight bold<br> +grid title fontslant italic<br> +grid title color red<br> +grid labels yes<br> +grid labels text1 {Hello World}<br></tt> <tt><tt>grid labels text2 +{Hello World}<br></tt> grid labels def1 yes<br> +grid labels def2 yes<br></tt> <tt><tt>grid labels gap1 10<br></tt> +grid labels gap2 10<br> +grid labels font courier<br> +grid labels fontsize 12<br> +grid labels fontweight bold<br> +grid labels fontslant italic<br> +grid labels color red<br> +grid reset<br> +grid load foo.grd<br> +grid save foo.grd<br> +grid open<br> +grid close<br></tt> +<p><b><a name="header" id="header"></a>header</b></p> +<p>Display current fits header dialog. Optional extension number +maybe specified. Please note, this differs from samp fits +header.</p> +<tt>Syntax:<br> +header [<ext>]<br> + [close [<ext>]]<br> + [save [<ext>] +<filename>]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +header<br> +header 2<br> +header close<br></tt> +<p><b><a name="height" id="height"></a>height</b></p> +<p>Set the height of the image display window.</p> +<tt>Syntax:<br> +height [<value>]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +height<br> +ds9.set(string cmd)<br> +height 512<br></tt> +<p><b><a name="iconify" id="iconify"></a>iconify</b></p> +<p>Toggles iconification.</p> +<tt>Syntax:<br> +iconify []<br> + [yes|no]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +iconify<br> +ds9.set(string cmd)<br> +iconify<br> +iconify yes</tt><br> +<p><b><a name="iexam" id="iexam"></a>iexam</b></p> +<p>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 +<tt>button</tt>. In the last form, the following macros will be +expanded if present: <tt>$width, $height, $depth, $bitpix, +$filename, $regions, $filename[$regions], $env, $pan, $value, $x, +$y, $z.</tt> See <a href= +"file:///Users/joye/saods9/doc/ref/analysis.html#macros">Analysis +Macros</a> for more information.</p> +<tt>Syntax:<br> +iexam []<br></tt> <tt><tt> +[[]|button|key|any] coordinate <coordsys> [<skyframe>] +[<skyformat>]<br> + [[]|button|key|any] data +[width][height]<br></tt> <tt><tt> +[[]|button|key|any] <macro string>]<br> + </tt></tt><br> +Example:<br> +string value = ds9.get(string cmd)<br></tt> <tt><tt>iexam<br></tt> +iexam coordinate image<br> +iexam key coordinate image # return coordinate and key event<br> +iexam coordinate wcs fk5 degrees<br> +iexam coordinate wcs galactic sexagesimal<br> +iexam coordinate fk5<br> +iexam data # return data value<br> +iexam key data # return data value and key event<br> +iexam data 3 3 # return all data in 3x3 box about selected +point<br> +iexam {'Click at $x,$y in file $filename'}</tt><br> +<p><b><a name="iis" id="iis"></a>iis</b></p> +<p>Set/Get IIS Filename. Optional mosaic number maybe supplied.</p> +<tt>Syntax:<br> +iis [filename <filename> [#]]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +iis filename<br> +iis filename 4<br> +ds9.set(string cmd)<br> +iis filename foo.fits<br> +iis filename bar.fits 4</tt><br> +<p><b><a name="jpeg" id="jpeg"></a>jpeg</b></p> +<p>Load JPEG image into current frame. Optional parameters: +<tt>jpeg</tt> quality (1-100)</p> +<tt>Syntax:<br> +jpeg [new|slice] [<filename>] [1-100]<br> + <br> +Example:<br></tt> <tt><tt>string value = ds9.get(string +cmd)<br></tt> jpeg</tt><br> +<tt><tt>jpeg 100</tt><br></tt> <tt><tt>ds9.set(string cmd)<br></tt> +jpeg foo.jpeg</tt><br> +<tt><tt>jpeg new foo.jpeg<br></tt></tt> <tt><tt><tt>jpeg slice +foo.jpeg<br></tt></tt> jpeg</tt><br> +<tt><tt>jpeg</tt> <tt>new<br></tt> jpeg</tt> <tt>slice</tt> +<p><b><a name="lock" id="lock"></a>lock</b></p> +<p>Lock all other frames to the current frame.</p> +<tt>Syntax:<br></tt> <tt>lock</tt> <tt>[frame +<coordsys>|none]<br> + </tt> <tt>[crosshair +<coordsys>|none]</tt> <tt><br></tt> +<tt> [crop <coordsys>|none]</tt><br> +<tt> [slice <coordsys>|none]</tt><br> +<tt> [bin [yes|no]]<br> + [axes [yes|no]]<br> + [scale [yes|no]]<br> + [scalelimits [yes|no]]<br> + [colorbar [yes|no]]<br> + [block [yes|no]]<br></tt> +<tt> [smooth [yes|no]]</tt><tt><br></tt> +<tt> [3d [yes|no]]</tt><tt><br></tt> +<tt> </tt> <tt><br> +Example:<br></tt> <tt>string value = ds9.get(string cmd)<br></tt> +<tt>lock frame<br> +lock crosshair<br></tt> <tt>lock crop</tt><br> +<tt>lock slice</tt><br> +<tt>lock bin<br> +lock axes<br> +lock scale<br> +lock scalelimits<br> +lock color</tt><tt>bar<br> +lock block<br></tt> <tt>lock smooth<br></tt> <tt>lock 3d<br></tt> +<tt>ds9.set(string cmd)<br></tt> <tt>lock frame +wcs</tt><tt><br></tt> <tt>lock crosshair wcs<br></tt> <tt>lock crop +wcs</tt><br> +<tt>lock slice wcs</tt><br> +<tt>lock bin yes<br> +lock axes yes<br></tt> <tt>lock scale yes<br> +lock scalelimits yes<br></tt> <tt>lock colorbar yes</tt><tt><br> +lock block yes</tt><br> +<tt>lock smooth yes<br></tt> <tt>lock 3d yes<br> +<br></tt> <b><a name="lower" id="lower"></a>lower</b> +<p>Lower in the window stacking order.</p> +<tt>Syntax:<br> +lower<br> + <br> +Example:<br> +ds9.set(string cmd)<br> +lower</tt><tt><br></tt> +<p><b><a name="magnifier" id="magnifier"></a>magnifier</b></p> +<p>Controls the magnifier settings.</p> +<tt>Syntax:<br> +magnifier [color <color>]<br> + [zoom +<value>]<br> + [cursor +yes|no]<br> + [region +yes|no]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +magnifier color<br> +magnifier zoom<br> +magnifier cursor<br> +magnifier region<br> +ds9.set(string cmd)<br> +magnifier color yellow<br> +magnifier zoom 2<br> +magnifier cursor no<br> +magnifier region no<br></tt> +<p><b><a name="mask" id="mask"></a>mask<br></b></p> +<p>Controls mask parameters.</p> +<tt>Syntax:<br> +mask [color <color>]<br> + [mark 1|0]<br> + [transparency <value>]<br> + [clear]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +mask color<br> +mask mark<br> +mask transparency<br> +ds9.set(string cmd)<br> +mask color red<br> +mask mark 0<br> +mask transparency 50<br> +mask clear<br> +mask open<br> +mask close<br></tt> +<p><b><a name="match" id="match"></a>match</b></p> +<p>Match all other frames to the current frame.</p> +<tt>Syntax:<br></tt> <tt>match</tt> <tt>[frame +<coordsys>]<br> + </tt> <tt>[crosshair +<coordsys>]</tt> <tt><br></tt> +<tt> [crop <coordsys>]<br></tt> +<tt> [slice +<coordsys>]<br></tt> <tt> +[bin]<br> + [axes]<br> + [scale]<br> + [scalelimits]<br> + [colorbar]<br> + [block]<br> + [smooth]</tt><tt><br> + [3d]<br></tt> <tt> <br> +Example:<br> +ds9.set(string cmd)<br></tt> <tt>match frame wcs<br></tt> <tt>match +crosshair wcs<br></tt> <tt>match crop wcs</tt><br> +<tt>match slice wcs<br> +match bin<br> +match axes<br> +match scale<br> +match scalelimits<br> +match color</tt><tt>bar<br> +match block<br> +match smooth<br> +match 3d<br></tt> +<p><b><a name="mecube" id="mecube"></a>mecube</b></p> +<p>Load FITS multiple extension file as data cube.<br></p> +<tt>Syntax:<br> +mecube [new] [<filename>]<br> + <br> +Example:</tt><br> +<tt>string value = ds9.get(string cmd)</tt><tt><tt><br></tt> +mecube<br></tt> <tt><tt><tt>ds9.set(string cmd)<br></tt></tt> +mecube foo.fits</tt><br> +<tt><tt>mecube new foo.fits<br></tt> mecube</tt><br> +<tt>mecube</tt> <tt>new</tt> +<p><b><a name="minmax" id="minmax"></a>minmax</b></p> +<p>This is how DS9 determines the min and max data values +from the data. <tt>SCAN</tt> will scan all data.</p> +<tt>Syntax:<br> +minmax [scan|sample|datamin|irafmin]<br> + [mode +scan|sample|datamin|irafmin]<br> + [interval #]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +minmax mode<br> +minmax sample<br> +ds9.set(string cmd)<br> +minmax scan<br> +minmax mode scan<br> +minmax interval 100<br></tt> +<p><b><a name="mode" id="mode"></a>mode</b></p> +<p>Controls the first mouse button mode.</p> +<tt>Syntax:<br> +mode +[none|region|crosshair|colorbar|pan|zoom|rotate|catalog|examine]<br> + + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +mode<br> +ds9.set(string cmd)<br> +mode crosshair</tt><br> +<p><b><a name="mosaic" id="mosaic"></a>mosaic</b></p> +<p>Load FITS mosaic segment into current frame.</p> +<tt>Syntax:<br> +mosaic [wcs|wcsa...wcsz|iraf] [new|mask] [<filename>]<br> + <br> +Example:<br></tt> <tt><tt>string value = ds9.get(string +cmd)<br></tt> mosaic</tt><tt><br></tt> <tt><tt>ds9.set(string +cmd)<br></tt> mosaic foo.fits</tt><br> +<tt><tt>mosaic wcs foo.fits</tt></tt><br> +<tt><tt>mosaic wcs new foo.fits</tt></tt><br> +<tt><tt>mosaic wcs mask +foo.fits</tt></tt><tt><tt><tt><br></tt></tt> mosaic</tt><br> +<tt><tt>mosaic wcs<br> +mosaic wcs</tt> <tt>new<br></tt> mosaic wcs</tt> <tt>mask<br></tt> +<p><b><a name="mosaicimage" id= +"mosaicimage"></a>mosaicimage</b></p> +<p>Load FITS mosaic image into current frame.</p> +<tt>Syntax:<br> +mosaicimage [wcs|wcsa...wcsz|iraf|wfpc2] [new|mask] +[<filename>]<br> + <br> +Example:<br></tt> <tt><tt>string value = ds9.get(string +cmd)<br></tt> mosaicimage</tt><tt><br></tt> <tt><tt>ds9.set(string +cmd)<br></tt> mosaicimage foo.fits</tt><br> +<tt><tt>mosaicimage wcs foo.fits</tt></tt><br> +<tt><tt>mosaicimage wcs new foo.fits</tt></tt><br> +<tt><tt>mosaicimage wcs mask +foo.fits</tt></tt><tt><tt><tt><br></tt></tt> mosaicimage</tt><br> +<tt><tt>mosaicimage wcs<br> +mosaicimage wcs new</tt><tt><br></tt> mosaicimage wcs mask</tt> +<p><b><a name="movie" id="movie"></a>movie</b></p> +<p>Create mpeg1 movie from snap shots of the DS9 window. A +<tt>slice</tt> movie cycles though all slices of a cube. A +<tt>frame</tt> movie cycles through all active frames. A +<tt>3d</tt> movie cycles through specified viewing angles. The +default is <tt>frame</tt>. Optional parameters for <tt>3d</tt>: +number of frames, azimuth from/to, elevation from/to, slice +from/to, oscillate/repeat times.</p> +<tt>Syntax:<br> +movie</tt> <tt>[slice|frame|3d]</tt> <tt><filename><br></tt> +<tt>movie 3d <filename> +[number|azfrom|azto|elfrom|elto|slfrom|slto|oscillate|repeat +<#>]</tt><br> +<tt> <br> +Example:<br> +ds9.set(string cmd)<br> +movie slice ds9.mpg<br></tt> <tt>movie 3d ds9.mpg number 10 azfrom +-60 azto 60 oscillate 1</tt><br> +<p><b><a name="multiframe" id="multiframe"></a>multiframe</b></p> +<p>Load FITS multiple extension file as multiple images.<br></p> +<tt>Syntax:<br> +multiframe [<filename>]<br> + <br> +Example:<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> multiframe +foo.fits</tt><tt><tt><br></tt> multiframe</tt><br> +<p><b><a name="nameserver" id="nameserver"></a>nameserver</b></p> +<p>Support Name Server functions. Coordinates are in fk5.</p> +<tt>Syntax:<br> +nameserver [<object>]<br> + [name +<object>]<br> + +[server +ned-sao|ned-cds|simbad-sao|simbad-cds|</tt><tt><tt>vizier-sao|vizier-cds</tt>]<br> + + +[skyformat degrees|sexagesimal]<br> + +[pan]<br> + +[crosshair]<br> + [close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +nameserver<br> +nameserver server<br> +nameserver skyformat<br> +nameserver m31<br> +ds9.set(string cmd)<br> +nameserver m31<br> +nameserver name m31<br> +nameserver server ned-sao<br> +nameserver skyformat sexagesimal<br> +nameserver pan<br> +nameserver crosshair<br> +nameserver open<br> +nameserver close<br></tt> +<p><b><a name="nan" id="nan"></a>nan</b></p> +<p>Set image not-a-number color.</p> +<tt>Syntax:<br> +nan <color><br> + <br> +Example:<br></tt> <tt>string value = ds9.get(string cmd)<br> +nan</tt><br> +<tt>ds9.set(string cmd)<br> +nan red</tt><br> +<p><b><a name="nrrd" id="nrrd"></a>nrrd</b></p> +<p>Load an NRRD (Nearly Raw Raster Data) file. Optional parameter: +array endian.<br></p> +<tt>Syntax:<br> +nrrd [native|little|big]<br> +nrrd [new|mask] [<filename>]<br> + <br> +Example:<br></tt> <tt><tt>string value = ds9.get(string +cmd)<br></tt> nrrd</tt><br> +<tt><tt>nrrd big<br></tt></tt> <tt><tt><tt>ds9.set(string +cmd</tt><tt>, string url</tt><tt>)<br></tt> nrrd +foo.nrrd</tt></tt><br> +<tt><tt><tt><tt>nrrd new foo.nrrd</tt></tt></tt></tt><br> +<tt><tt><tt><tt><tt><tt>nrrd mask +foo.nrrd<br></tt></tt></tt></tt></tt> nrrd</tt><br> +<tt>nrrd</tt> <tt>new<br> +nrrd mask</tt><br> +<p><b><a name="nvss" id="nvss"></a>nvss</b></p> +<p>Support for NRAO VLA Sky Survey.</p> +<tt>Syntax:<br> +nvss []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +nvss name<br> +nvss coord<br> +nvss size<br> +nvss save<br> +nvss frame<br> +ds9.set(string cmd)<br> +nvss<br> +nvss m31<br></tt> <tt><tt>nvss name m31<br></tt></tt> +<tt><tt><tt>nvss name clear<br></tt></tt> nvss 00:42:44.404 ++41:16:08.78<br> +nvss size 60 60 arcmin<br> +nvss save yes<br> +nvss frame current<br> +nvss update frame<br> +nvss open<br> +nvss close<br></tt> +<p><b><a name="orient" id="orient"></a>orient</b></p> +<p>Controls the orientation of the current frame.</p> +<tt>Syntax:<br> +orient [none|x|y|xy]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +orient<br> +ds9.set(string cmd)<br> +orient xy<br> +orient open<br> +orient close<br></tt> +<p><b><a name="pagesetup" id="pagesetup"></a>pagesetup</b></p> +<p>Controls Page Setup options.</p> +<tt>Syntax:<br> +pagesetup [orient portrait|landscape]</tt><br> +<tt> [scale +<numeric>]</tt><br> +<tt> [size +letter|legal|tabloid|poster|a4]</tt><br> +<tt> <br> +Example:<br> +string value = ds9.get(string cmd)<br> +pagesetup orient<br> +pagesetup scale<br> +pagesetup size<br> +ds9.set(string cmd)<br> +pagesetup orient portrait<br> +pagesetup scale 50<br> +pagesetup size poster<br></tt> +<p><b><a name="pan" id="pan"></a>pan</b></p> +<p>Controls the current image cursor location for the current +frame.</p> +<tt>Syntax:<br> +pan [<x> <y> <coordsys> +[<skyframe>][<skyformat>]] # relative<br> + [to <x> <y> <coordsys> +[<skyframe>][<skyformat>] # absolute<br> + [open|close]<br> + [close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +pan # get current image coords<br> +pan wcs fk4 sexagesimal # get current wcs coords<br> +ds9.set(string cmd)<br> +pan 200 200 image # pan relative<br> +pan to 400 400 physical # pan to physical coords<br> +pan to 13:29:55 47:11:50 wcs fk5 # pan to wcs coords<br> +pan open<br> +pan close<br></tt> +<p><b><a name="pixeltable" id="pixeltable"></a>pixeltable</b></p> +<p>Display/Hide the pixel table.</p> +<tt>Syntax:<br> +pixeltable []<br> + [yes|open]<br> + [no|close]<br> + <br> +Example:<br> +string url = ds9.get(string cmd)<br> +pixeltable<br> +ds9.set(string cmd)<br> +pixeltable<br> +pixeltable yes<br> +pixeltable open<br> +pixeltable close<br></tt> +<p><b><a name="plot" id="plot"></a>plot</b></p> +<p>Display and configure data plots. All plot commands take an +optional second command, the plot name. If no plot name is +specified, the last plot created is assumed. Plot data is assumed +to be a pair of coordinates, with optional error values. The follow +are valid data descriptions:</p> +<blockquote>xy x and y coordinates<br> +xyex x,y coordinates with x errors<br> +xyey x,y coordinates with y errors<br> +xyexey x,y coordinates with x and y +errors<br></blockquote> +<p>To create a new plot, use the plot new command.</p> +<tt>Syntax:</tt><tt><br></tt> <tt># create new empty plot +window</tt><tt><br></tt> <tt>plot []</tt><tt><br></tt> +<tt> [line|bar|scatter]</tt><tt><br></tt> +<tt> [new]</tt><tt><br></tt> +<tt> [new +line|bar|scatter]</tt><tt><br></tt> <tt> +[new name <plotname>]</tt><tt><br></tt> +<tt> [new name <plotname> +line|bar|scatter]</tt><tt><br></tt> <tt><br></tt> <tt>#</tt> +<tt>load data into existing plot from stdin</tt><tt><br></tt> +<tt>plot [[<plotname>] data +xy|xyex|xyey|xyexey]</tt><tt><br></tt> <tt><br></tt> <tt># existing +plot</tt><tt><br></tt> <tt>plot</tt> <tt>[[<plotname>] load +<filename> xy|xyex|xyey|xyexey]</tt><tt><br></tt> +<tt> [[<plotname>] save +<filename>]</tt><tt><br></tt> <tt> +[[<plotname>] clear]</tt><tt><br></tt> +<tt> </tt> <tt>[[<plotname>] duplicate +[#]]</tt><tt><br></tt> <tt> </tt> +<tt>[[<plotname>] stats yes|no]</tt><tt><br></tt> +<tt> </tt> <tt>[[<plotname>] list +yes|no]</tt><tt><br></tt> <tt> </tt> +<tt>[[<plotname>] loadconfig +<filename>]</tt><tt><br></tt> <tt> +[[<plotname>] saveconfig <filename>]</tt><tt><br></tt> +<tt> [[<plotname>] pagesetup orient +portrait|landscape]</tt><tt><br></tt> <tt> +[[<plotname>] pagesetup size +letter|legal|tabloid|poster|a4]</tt><tt><br></tt> +<tt> [[<plotname>] +print]</tt><tt><br></tt> <tt> +[[<plotname>] print destination +printer|file]</tt><tt><br></tt> <tt> +[[<plotname>] print command +<command>]</tt><tt><br></tt> <tt> +[[<plotname>] print filename +<filename>]</tt><tt><br></tt> <tt> +[[<plotname>] print color rgb|gray]</tt><tt><br></tt> +<tt> </tt> <tt>[[<plotname>] +close</tt><tt>]</tt><tt><br></tt> <tt> </tt> +<tt>[[<plotname>] mode pointer|zoom]</tt><tt><br></tt> +<tt><br></tt> <tt># configure graph</tt><tt><br></tt> <tt>plot +[[<plotname>] axis x|y grid yes|no]</tt><tt><br></tt> +<tt> [[<plotname>] axis x|y log +yes|no]</tt><tt><br></tt> <tt> +[[<plotname>] axis x|y flip yes|no]</tt><tt><br></tt> +<tt> [[<plotname>] axis x|y auto +yes|no]</tt><tt><br></tt> <tt> +[[<plotname>] axis x|y min <value>]</tt><tt><br></tt> +<tt> [[<plotname>] axis x|y max +<value>]</tt><tt><br></tt> <tt> +[[<plotname>] axis x|y format +<string>]</tt><tt><br></tt> <tt> </tt> +<tt>[[<plotname>] legend yes|no]</tt><tt><br></tt> +<tt> [[<plotname>] legend position +right|left|top|bottom]</tt><tt><br></tt> <tt> +[[<plotname>] font title|labels|numbers font +times|helvetica|courier]</tt><tt><br></tt> <tt> +[[<plotname>] font</tt> <tt>title|labels|numbers</tt> +<tt>size <value>]</tt><tt><br></tt> <tt> +[[<plotname>] font</tt> <tt>title|labels|numbers</tt> +<tt>weight normal|bold]</tt><tt><br></tt> <tt> +[[<plotname>] font</tt> <tt>title|labels|numbers</tt> +<tt>slant roman|italic]</tt><tt><br></tt> <tt> +[[<plotname>] title <string>]</tt><tt><br></tt> +<tt> [[<plotname>] title x|y +<string>]</tt><tt><br></tt> <tt> +[</tt><tt>[<plotname>] barmode +normal|stacked|aligned|overlap]</tt><tt><br></tt> <tt><br></tt> +<tt># configure current dataset</tt><tt><br></tt> <tt>plot +[[<plotname>] show yes|no]</tt><tt><br></tt> <tt> + </tt> <tt>[[<plotname>] shape +circle|square|diamond|plus|splus|scross|triangle|arrow]</tt><tt><br> +</tt> <tt> </tt> <tt>[[<plotname>] +shape fill yes|no]</tt><tt><br></tt> +<tt> </tt> <tt>[[<plotname>] shape +color <value>]</tt><tt><br></tt> +<tt> </tt> <tt>[[<plotname>] smooth +step|linear|cubic|quadratic|catrom]</tt><tt><br></tt> +<tt> </tt> <tt>[[<plotname>] color +<value>]</tt><tt><br></tt> <tt> </tt> +<tt>[[<plotname>] width <value>]</tt><tt><br></tt> +<tt> </tt> <tt>[[<plotname>] dash +yes|no]</tt><tt><br></tt> <tt> </tt> +<tt>[[<plotname>] error yes|no]</tt><tt><br></tt> +<tt> </tt> <tt>[[<plotname>] error +color <value>]</tt><tt><br></tt> <tt> +[[<plotname>] color <value>]</tt><tt><br></tt> +<tt> </tt> <tt>[[<plotname>] error +width <value>]</tt><tt><br></tt> +<tt> </tt> <tt>[[<plotname>] name +<string>]</tt><tt><br></tt> <tt><br></tt> <tt># select +current dataset</tt><tt><br></tt> <tt>plot [[<plotname>] +select <value>]</tt><tt><br></tt> <tt> </tt> <tt><br> +</tt> <tt>Example:</tt><tt><br></tt> <tt># return all +plotnames</tt><tt><br></tt> <tt>string value = ds9.get(string +cmd)</tt><tt><br></tt> <tt>plot</tt><tt><br></tt> <tt><br></tt> +<tt># create new empty plot window</tt><tt><br></tt> +<tt>ds9.set(string cmd)</tt><tt><br></tt> +<tt>plot</tt><tt><br></tt> <tt>plot bar</tt><tt><br></tt> <tt>plot +new</tt><tt><br></tt> <tt>plot new bar</tt><tt><br></tt> <tt>plot +new name foo</tt><tt><br></tt> <tt>plot new name foo +bar</tt><tt><br></tt> <tt><br></tt> <tt># load additional dataset +into an existing plot</tt><tt><br></tt> <tt>ds9.set(string cmd, +string url)</tt><tt><br></tt> <tt>plot data xy # plot additional +data</tt><tt><br></tt> <tt>plot foo data xy # plot additional +data</tt><tt><br></tt> <tt><br></tt> <tt>string value = +ds9.get(string cmd)</tt><tt><br></tt> <tt>plot +stats</tt><tt><br></tt> <tt>plot list</tt><tt><br></tt> +<tt>ds9.set(string cmd)</tt><tt><br></tt> <tt>plot load foo.dat +xy</tt><tt><br></tt> <tt>plot save foo.dat</tt><tt><br></tt> +<tt>plot clear</tt><tt><br></tt> <tt>plot duplicate +1</tt><tt><br></tt> <tt>plot stats yes</tt><tt><br></tt> <tt>plot +list yes</tt><tt><br></tt> <tt>plot loadconfig +foo.plt</tt><tt><br></tt> <tt>plot saveconfig +foo.plt</tt><tt><br></tt> <tt>plot pagesetup orient +portrait</tt><tt><br></tt> <tt>plot pagesetup size +letter</tt><tt><br></tt> <tt>plot print</tt><tt><br></tt> <tt>plot +print destination file</tt><tt><br></tt> <tt>plot print command +lp</tt><tt><br></tt> <tt>plot print filename +foo.ps</tt><tt><br></tt> <tt>plot print color rgb</tt><tt><br></tt> +<tt>plot close</tt><tt><br></tt> <tt><br></tt> <tt>string value = +ds9.get(string cmd)</tt><tt><br></tt> <tt>plot +mode</tt><tt><br></tt> <tt>ds9.set(string cmd)</tt><tt><br></tt> +<tt>plot mode pointer</tt><tt><br></tt> <tt><br></tt> <tt># +configure plot</tt><tt><br></tt> <tt>string value = ds9.get(string +cmd)</tt><tt><br></tt> <tt>plot axis x grid</tt><tt><br></tt> +<tt>plot axis x log</tt><tt><br></tt> <tt>plot axis x +flip</tt><tt><br></tt> <tt>plot axis x auto</tt><tt><br></tt> +<tt>plot axis x min</tt><tt><br></tt> <tt>plot axis x +max</tt><tt><br></tt> <tt>plot axis x format</tt><tt><br></tt> +<tt>plot legend</tt><tt><br></tt> <tt>plot legend +position</tt><tt><br></tt> <tt>plot font numbers +font</tt><tt><br></tt> <tt>plot font numbers size</tt><tt><br></tt> +<tt>plot font numbers weight</tt><tt><br></tt> <tt>plot font +numbers slant</tt><tt><br></tt> <tt>plot title</tt><tt><br></tt> +<tt>plot title x</tt><tt><br></tt> <tt>plot +barmode</tt><tt><br></tt> <tt>ds9.set(string cmd)</tt><tt><br></tt> +<tt>plot axis x grid yes</tt><tt><br></tt> <tt>plot axis x log +yes</tt><tt><br></tt> <tt>plot axis x flip yes</tt><tt><br></tt> +<tt>plot axis x auto no</tt><tt><br></tt> <tt>plot axis x min +0</tt><tt><br></tt> <tt>plot axis x max 100</tt><tt><br></tt> +<tt>plot axis x format "%f"</tt><tt><br></tt> <tt><br></tt> +<tt>string value = ds9.get(string cmd)</tt><tt><br></tt> <tt>plot +legend</tt><tt><br></tt> <tt>plot legend position</tt><tt><br></tt> +<tt>ds9.set(string cmd)</tt><tt><br></tt> <tt>plot legend +yes</tt><tt><br></tt> <tt>plot legend position +left</tt><tt><br></tt> <tt><br></tt> <tt>string value = +ds9.get(string cmd)</tt><tt><br></tt> <tt>plot font numbers +font</tt><tt><br></tt> <tt>plot font numbers size</tt><tt><br></tt> +<tt>plot font numbers weight</tt><tt><br></tt> <tt>plot font +numbers slant</tt><tt><br></tt> <tt>ds9.set(string +cmd)</tt><tt><br></tt> <tt>plot font numbers font +times</tt><tt><br></tt> <tt>plot font numbers size +12</tt><tt><br></tt> <tt>plot font numbers weight +bold</tt><tt><br></tt> <tt>plot font numbers slant +italic</tt><tt><br></tt> <tt><br></tt> <tt>string value = +ds9.get(string cmd)</tt><tt><br></tt> <tt>plot +title</tt><tt><br></tt> <tt>plot title xaxis</tt><tt><br></tt> +<tt>plot title yaxis</tt><tt><br></tt> <tt>ds9.set(string +cmd)</tt><tt><br></tt> <tt>plot title "This is a +Title"</tt><tt><br></tt> <tt>plot title x "X +Axis"</tt><tt><br></tt> <tt>plot title y "Y Axis"</tt><tt><br></tt> +<tt>plot title legend "This is the Legend"</tt><tt><br></tt> +<tt><br></tt> <tt>string value = ds9.get(string +cmd)</tt><tt><br></tt> <tt>plot barmode</tt><tt><br></tt> +<tt>ds9.set(string cmd)</tt><tt><br></tt> <tt>plot barmode +aligned</tt><tt><br></tt> <tt><br></tt> <tt># configure current +dataset</tt><tt><br></tt> <tt>string value = ds9.get(string +cmd)</tt><tt><br></tt> <tt>plot show</tt><tt><br></tt> <tt>plot +shape</tt><tt><br></tt> <tt>plot shape fill</tt><tt><br></tt> +<tt>plot shape color</tt><tt><br></tt> <tt>plot +smooth</tt><tt><br></tt> <tt>plot color</tt><tt><br></tt> <tt>plot +width</tt><tt><br></tt> <tt>plot dash</tt><tt><br></tt> <tt>plot +error</tt><tt><br></tt> <tt>plot error color</tt><tt><br></tt> +<tt>plot error width</tt><tt><br></tt> <tt>plot +name</tt><tt><br></tt> <tt>ds9.set(string cmd)</tt><tt><br></tt> +<tt>plot show yes</tt><tt><br></tt> <tt>plot shape +circle</tt><tt><br></tt> <tt>plot shape fill no</tt><tt><br></tt> +<tt>plot shape color cyan</tt><tt><br></tt> <tt>plot smooth +step</tt><tt><br></tt> <tt>plot color red</tt><tt><br></tt> +<tt>plot width 2</tt><tt><br></tt> <tt>plot dash +yes</tt><tt><br></tt> <tt>plot error yes</tt><tt><br></tt> <tt>plot +error color red</tt><tt><br></tt> <tt>plot error width +2</tt><tt><br></tt> <tt>plot name "My Data"</tt><tt><br></tt> +<tt><br></tt> <tt># select current dataset</tt><tt><br></tt> +<tt>string value = ds9.get(string cmd)</tt><tt><br></tt> <tt>plot +select</tt><tt><br></tt> <tt>ds9.set(string cmd)<br> +plot select 2<br> +<br></tt> <b><a name="png" id="png"></a>png</b> +<p>Load PNG image into current frame.<br></p> +<tt>Syntax:<br> +png [new|slice] [<filename>]<br> + <br> +Example:<br></tt> <tt><tt>string value = ds9.get(string +cmd)<br></tt> png</tt><br> +<tt><tt>ds9.set(string cmd)<br></tt> png foo.png</tt><br> +<tt><tt>png new foo.png<br></tt></tt> <tt><tt><tt>png slice +foo.png<br></tt></tt> png</tt><br> +<tt><tt>png</tt> <tt>new<br></tt> png</tt> <tt>slice</tt><br> +<p><b><a name="precision" id="precision"></a>precision</b></p> +<p>Set region and coordinate output format precision.</p> +<tt>Syntax:<br> +precision <linear></tt> <tt><tt><degree></tt></tt> +<tt><tt><hms></tt></tt> +<tt><tt><tt><dms></tt></tt></tt> +<tt><tt><tt><tt><arcmin></tt></tt></tt></tt> +<tt><tt><tt><tt><tt><arcsec><br> +<br></tt></tt></tt></tt> Example:<br> +string value = ds9.get(string cmd)<br> +precision<br> +ds9.set(string cmd)<br> +precision 8 10 4 3 5 3</tt><br> +<p><b><a name="prefs" id="prefs"></a>prefs</b></p> +<p>Controls various preference settings.</p> +<tt>Syntax:<br> +prefs [clear]<br> + [irafalign yes|no]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +prefs irafalign<br> +ds9.set(string cmd)<br> +prefs clear<br> +prefs irafalign<br> +<br></tt> <b><a name="preserve" id="preserve"></a>preserve</b> +<p>Preserve the follow attributes while loading a new image.</p> +<tt>Syntax:<br> +preserve [pan yes|no]<br> + [regions yes|no]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +preserve pan<br> +preserve regions<br> +ds9.set(string cmd)<br> +preserve pan yes<br> +preserve regions yes<br></tt> +<p><b><a name="psprint" id="psprint"></a>psprint</b></p> +<p>Invokes postscript printing. Please see <a href= +"file:///Users/joye/saods9/ds9/doc/ref/command.html#print">print</a> +for further details.</p> +<p><b><a name="print" id="print"></a>print</b></p> +<p>Controls printing. Use print option to set printing options.</p> +<tt>Syntax:<br> +print [destination printer|file]<br> + [command <command>]<br> + [filename <filename>]<br> + [color rgb|cmyk|gray]<br> + [level 1|2]<br> + [resolution +53|72|75|150|300|600]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +print destination<br> +print command<br> +print filename<br> +print color<br> +print level<br> +print resolution<br> +ds9.set(string cmd)<br> +print<br> +print destination file<br> +print command lp<br> +print filename foo.ps<br> +print color cmyk<br> +print level 2<br> +print resolution 75</tt> +<p><b><a name="raise" id="raise"></a>raise</b></p> +<p>Raise in the window stacking order.</p> +<tt>Syntax:<br> +raise<br> + <br> +Example:<br> +ds9.set(string cmd)<br> +raise</tt> +<p><b><a name="regions" id="regions"></a>regions</b></p> +<p>Controls regions in the current frame.</p> +<tt>Syntax:<br> +regions [<filename>]<br> + [load [all] +<filename>]<br> + [save +<filename>]<br> + [list [close]]<br> + [epsilon +<integer>]<br> + [show yes|no]<br> + [showtext yes|no]<br> + [centroid]<br> + [centroid auto +yes|no]<br> + [centroid radius +<value>|iteration <value>]<br> + [getinfo]<br> + [move front]<br> + [move back]<br> + [select all]<br> + [select none]<br> + [select invert]<br> + [delete all]<br> + [delete select]<br> + [format +ds9|xml|ciao|saotng|saoimage|pros|xy]<br> + [system +image|physical|wcs|wcsa...wcsz]<br> + [sky +fk4|fk5|icrs|galactic|ecliptic]<br> + [skyformat +degrees|sexagesimal]<br> + [strip yes|no]<br> + [shape +<shape>]<br> + [color +&ltcolor>]<br> + [width +<width>]<br></tt> <tt> +[fixed|edit|rotate|delete yes|no]<br> + +[include|exclude|source|background]</tt><br> +<tt> [command <marker +command>]<br> + [composite]<br> + [dissolve]<br> + [template +<filename>]<br> + [template <filename> at +<ra> <dec> <coordsys> <skyframe>]<br> + [savetemplate +<filename>]<br> + [groups]<br> + [group new]<br> + [group <tag> +new]<br> + [group <tag> +update]<br> + [group <tag> +select]<br> + [group <tag> color +<color>]<br> + [group <tag> copy]<br> + [group <tag> +delete]<br> + [group <tag> cut]<br> + [group <tag> font +<font>]<br> + [group <tag> move +<int> <int>]<br> + [group <tag> +movefront]<br> + [group <tag> +moveback]<br> + [group <tag> property +<property> yes|no]<br> + [copy]<br> + [cut]<br> + [paste +image|physical|wcs|wcsa...wcsz]<br> + [undo]<br> + +[include|exclude|source|background|selected]<br> + [-format +ds9|ciao|saotng|saoimage|pros|xy]<br> + [-system +image|physical|wcs|wcsa...wcsz]<br> + [-sky +fk4|fk5|icrs|galactic|ecliptic]<br> + [-skyformat +degrees|sexagesimal]<br> + [-prop +select|edit|move|rotate|delete|fixed|include|source 1|0]<br> + [-group <tag>]<br> + [-strip yes|no]<br> + [-wcs yes|no]<br> + <br> +Example:<br> +string url = ds9.get(string cmd)<br> +regions<br> +regions -format ds9 -system wcs -sky fk5 -skyformat sexagesimal +-prop edit 1 -group foo<br> +string value = ds9.get(string cmd)<br> +regions epsilon<br> +regions show<br> +regions showtext<br> +regions centroid<br> +regions centroid auto<br> +regions centroid radius<br> +regions centroid iteration<br> +regions selected<br> +regions format<br> +regions system<br> +regions sky<br> +regions skyformat<br> +regions strip<br> +regions shape<br> +regions color<br> +regions width<br> +regions source<br> +regions background<br> +regions include<br> +regions exclude<br> +regions selected<br> +regions groups<br> +ds9.set(string cmd, string url)<br> +regions -format xy -system wcs -sky fk5<br> +regions -format ds9<br> +ds9.set(string cmd)<br> +regions foo.reg<br> +regions -format ciao bar.reg # load as ciao format<br> +regions foo.fits # FITS regions files do not need a format +specification<br> +regions load foo.reg # load foo.reg into current frame<br> +regions load all foo.reg # load foo.reg into all frames<br> +regions load *.reg# expand *.reg and load into current frame<br> +regions load all *.reg # expand *.reg and load into all frames<br> +regions save foo.reg<br> +regions list<br> +regions list close<br> +regions epsilon 5<br> +regions show yes<br> +regions showtext no<br> +regions centroid<br> +regions centroid auto yes<br> +regions centroid radius 10<br> +regions centroid iteration 20<br> +regions getinfo<br> +regions move back<br> +regions move front<br> +regions select all<br> +regions select none<br> +regions select invert<br> +regions delete all<br> +regions delete select<br> +regions format ds9<br> +regions system wcs<br> +regions sky fk5<br> +regions skyformat degrees<br> +regions strip yes<br> +regions shape ellipse<br> +regions color red<br> +regions width 3<br> +regions edit yes<br> +regions include<br> +regions command "circle 100 100 20 # color=red"<br> +regions composite<br> +regions dissolve<br> +regions template foo.tpl<br> +regions template foo.tpl at 13:29:55.92 +47:12:48.02 fk5<br> +regions savetemplate foo.tpl<br> +regions group new<br> +regions group foo new<br> +regions group foo update<br> +regions group foo select<br> +regions group foo color red<br> +regions group foo copy<br> +regions group foo delete<br> +regions group foo cut<br> +regions group foo font 'times 14 bold'<br> +regions group foo move 100 100<br> +regions group foo movefront<br> +regions group foo moveback<br> +regions group foo property delete no<br> +regions copy<br> +regions cut<br> +regions paste wcs<br> +regions undo<br></tt> +<p><b><a name="restore" id="restore"></a>restore</b></p> +<p>Restore DS9 to a previous state from a backup save set.</p> +<tt>Syntax:<br> +restore <filename><br> + <br> +Example:<br> +restore ds9.bck</tt><br> +<p><b><a name="rgb" id="rgb"></a>rgb</b></p> +<p>Create RGB frame and control RGB frame parameters.</p> +<tt>Syntax:<br> +rgb []<br> + [red|green|blue]<br> + [channel [red|green|blue]]<br> + [view [red|green|blue] [yes|no]]<br> + [system <coordsys>]<br> + [lock +wcs|crop|slice|bin|scale|scalelimits|colorbar|block|smooth +[yes|no]]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +rgb channel<br></tt> <tt>rgb lock wcs</tt><br> +<tt>rgb lock crop</tt><br> +<tt>rgb lock slice</tt><br> +<tt>rgb lock bin<br> +rgb lock scale<br> +rgb lock scalelimits<br> +rgb lock colorbar<br> +rgb lock block<br> +rgb lock smooth<br> +rgb system<br> +rgb view red<br> +rgb view green<br> +rgb view blue<br> +ds9.set(string cmd)<br> +rgb # create new rgb frame<br> +rgb red # set current channel to red<br> +rgb channel red # set current channel to red<br> +rgb view blue no # turn off blue channel<br> +rgb system wcs # set rgb coordinate system<br></tt> <tt>rgb lock +wcs yes</tt><br> +<tt>rgb lock crop yes</tt><br> +<tt>rgb lock slice yes</tt><br> +<tt>rgb lock bin yes</tt><br> +<tt>rgb lock scale yes<br> +rgb lock scalelimits yes<br> +rgb lock colorbar yes<br> +rgb lock block yes<br> +rgb lock smooth yes<br> +rgb open<br> +rgb close</tt><br> +<p><b><a name="rgbarray" id="rgbarray"></a>rgbarray</b></p> +<p>Load raw data array cube into rgb frame.<br></p> +<tt>Syntax:<br> +rgbarray [native|big|little]<br> +rgbarray [new] [[xdim=<x>,ydim=<y>|dim=<dim>],[zdim=3],bitpix=<b>,skip=<s>,endian=[little|big]]<br> - <br> - Example: <br> - </tt><tt><tt><tt>string value = ds9.get(string cmd)<br> - </tt></tt>rgbarray<br> - rgbarray little<br> - </tt><tt><tt><tt>ds9.set(string cmd)<br> - </tt></tt>rgbarray - foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> - rgbarray new foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> - <p><b> <a name="rgbcube"></a>rgbcube</b></p> - <p>Load FITS rgbcube into rgb frame.<br> - </p> - <tt> Syntax:<br> - rgbcube [new] [<filename>]<br> - <br> - Example: <br> - </tt><tt><tt>string value = ds9.get(string cmd)<br> - </tt>rgbcube<br> - </tt><tt><tt>ds9.set(string cmd)<br> - </tt>rgbcube foo.fits</tt><br> - <tt><tt>rgbcube new foo.fits<br> - </tt>rgbcube</tt><br> - <tt>rgbcube</tt><tt> new</tt><br> - <p><b> <a name="rgbimage"></a>rgbimage</b></p> - <p>Load FITS rgbimage into rgb frame.<br> - </p> - <tt> Syntax:<br> - rgbimage [new] [<filename>]<br> - <br> - Example: <br> - </tt><tt><tt><tt>string value = ds9.get(string cmd)<br> - </tt></tt>rgbimage<br> - </tt><tt><tt><tt>ds9.set(string cmd)<br> - </tt></tt>rgbimage foo.fits</tt><br> - <tt><tt>rgbimage new foo.fits<br> - </tt>rgbimage</tt><br> - <tt>rgbimage</tt><tt> new</tt> - <p><b> <a name="rotate"></a>rotate</b></p> - <p>Controls the rotation angle (in degrees) of the current frame. - </p> - <tt> Syntax: <br> - rotate [<value>] <br> - [to <value>] <br> - [open|close]<br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - rotate <br> - ds9.set(string cmd)<br> - rotate 45 <br> - rotate to 30<br> - rotate open<br> - rotate close</tt><br> - <p><b><a name="samp"></a>samp</b></p> - <p>Configure SAMP protocol. </p> - <tt> Syntax: <br> - samp [no|disconnect] <br> - [broadcast [image|table]]<br> - [send [image|table] - <application>]<br> - <br> - Example: <br> - </tt><tt><tt>ds9.set(string cmd)<br> - </tt>samp no<br> - </tt><tt><tt>samp disconnect<br> - </tt>samp broadcast image<br> - samp send image aladin</tt> - <p><b> <a name="save"></a>save<br> - </b></p> - <p>Save loaded image data of current frame as FITS.</p> - <tt> Syntax: <br> - save </tt><tt>[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] - <filename> [image|table|slice]</tt> <br> - <tt> <br> - Example: <br> - </tt><tt><tt>ds9.set(string cmd) <br> - </tt>save foo.fits</tt><br> - <tt>save fits foo.fits image</tt><br> - <tt>save fits foo.fits table<br> - save fits foo.fits slice</tt><br> - <tt>save rgbimage foo.fits<br> - </tt><tt>save rgbcube foo.fits</tt><br> - <tt>save mecube foo.fits</tt><br> - <tt>save mosaic foo.fits</tt><br> - <tt>save mosaicimage foo.fits</tt><br> - <p><b> <a name="saveimage"></a>saveimage</b></p> - <p>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: <tt>jpeg</tt> quality (1-100) and <tt>tiff</tt> - compression method. </p> - <tt> Syntax: <br> - saveimage </tt><tt>[fits|eps|gif|tiff|jpeg|png] </tt><tt><filename><br> - saveimage <filename>.jpeg [1-100]<br> - saveimage <filename>.tiff [none|jpeg|packbits|deflate]<br> - <br> - Example:<br> - ds9.set(string cmd) <br> - saveimage ds9.tiff<br> - saveimage jpeg ds9.jpeg 75</tt><br> - <p><b> <a name="scale"></a>scale</b></p> - <p>Controls the limits and color scale distribution. </p> - <tt> Syntax: <br> - scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]<br> - [log exp <value>] <br> - [datasec yes|no] <br> - [limits <minvalue> - <maxvalue>] <br> - [mode - minmax|<value>|zscale|zmax] <br> - [scope local|global]<br> - [match]<br> - [match limits]<br> - [lock [yes|no]]<br> - [lock limits [yes|no]]<br> - [open|close]<br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - scale<br> - scale log exp <br> - scale datasec <br> - scale limits <br> - scale mode <br> - scale scope <br> - scale lock<br> - scale lock limits<br> - ds9.set(string cmd)<br> - scale linear<br> - scale log exp 100<br> - scale datasec yes <br> - scale histequ <br> - scale limits 1 100 <br> - scale mode zscale <br> - scale mode 99.5 <br> - scale scope local<br> - scale match<br> - scale match limits<br> - scale lock yes<br> - scale lock limits yes<br> - scale open<br> - scale close<br> - </tt> - <p><b> <a name="shm"></a>shm</b></p> - <p>Load a shared memory segment into the current frame. </p> - <tt> Syntax: <br> - shm [<key> [<filename>]] <br> - [key <key> [<filename>]] <br> - [shmid <id> [<filename>]]<br> - [fits [key|shmid] <id> - [<filename>]]<br> - [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] - [key|shmid] <id> [<filename>]]<br> - [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] - <id> [<filename>]] <br> - [rgbcube [key|shmid] <id> - [<filename>]<br> - [rgbimage [key|shmid] <id> - [<filename>]]<br> - [rgbarray [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]]<br> - [array [key|shmid] <id> -[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - shm <br> - ds9.set(string cmd)<br> - shm 102 <br> - shm key 102<br> - shm shmid 102 foo<br> - shm fits key 100 foo <br> - shm mosaicimage iraf key 100 foo <br> - shm mosaicimage wcs key 100 foo <br> - shm mosaicimage wcsa key 100 foo <br> - shm mosaicimage wfpc2 key 100 foo <br> - shm mosaic iraf key 100 foo <br> - shm mosaic wcs key 100 foo <br> - shm rgbcube key 100 foo <br> - shm rgbimage key 100 foo<br> - shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32]<br> - shm array shmid 102 [dim=32,bitpix=-32]<br> - <br> - </tt><b><a name="sia"></a>sia<br> - </b> - <p>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.</p> - <tt> Syntax:<br> - sia</tt><tt> </tt><tt><tt><tt>[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]</tt></tt><br> - <br> - </tt><tt> </tt><tt> - [<ref>] [cancel]<br> - </tt><tt> [<ref>] - [clear]<br> - </tt><tt> [<ref>] [close]</tt><br> - <tt> [<ref>] - [coordinate <ra> <dec> <coordsys>]</tt><tt><br> - </tt><tt> </tt><tt>[<ref>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [crosshair]</tt><br> - <tt> [<ref>] - [export sb|tsv <filename>]<br> - </tt><tt> [<ref>] [name - <object>]<br> - </tt><tt> [<ref>] [print]</tt><br> - <tt><tt> [<ref>] - [retrieve]</tt><br> - <tt> </tt></tt><tt> - [<ref>] [save <filename>]</tt><br> - <tt> [<ref>] [radius - <value> degrees|arcmin|arcsec]</tt><br> - <tt> </tt><tt> [<ref>] - [sky <skyframe>]<br> - </tt><tt> [<ref>] - [skyformat <skyformat>]<br> - </tt><tt> [<ref>] - [system <coordsys>]</tt><tt><br> - </tt><tt> </tt><tt>[<ref>] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - [update]</tt><br> - <tt><br> - Example:<br> - string value = ds9.get(string cmd) <br> - sia<br> - <br> - ds9.set(string cmd)<br> - sia</tt><tt> 2mass<br> - sia</tt><tt> cancel<br> - sia</tt><tt> clear<br> - sia</tt><tt> close<br> - sia</tt><tt> coordinate 202.48 47.21 fk5<br> - sia</tt><tt> crosshair<br> - sia</tt><tt> export tsv bar.tsv<br> - sia</tt><tt> name m51<br> - sia</tt><tt> print</tt><br> - <tt>sia</tt><tt> retrieve<br> - sia</tt><tt> save foo.xml<br> - sia</tt><tt> radius 1degrees</tt><br> - <tt>sia</tt><tt> sky fk5<br> - sia skyformat degrees<br> - sia</tt><tt> system wcs</tt><tt><br> - sia</tt><tt> update<br> - <br> - </tt><b><a name="single"></a>single</b> - <p>Select Single Display mode </p> - <tt> Syntax: <br> - single <br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - single <br> - ds9.set(string cmd)<br> - single<br> - </tt> - <p><b><a name="skyview"></a>skyview </b></p> - <p>Support for SkyView image server at HEASARC. </p> - <p> </p> - <tt> Syntax: <br> - skyview []<br> - [<object>]<br> - [name - <object>|clear]<br> - [<ra> - <dec>] # in wcs fk5<br> - [size <width> - <height> degrees|arcmin|arcsec]<br> - [pixels <width> - <height>]<br> - [save yes|no]<br> - [frame new|current]<br> - [update - frame|crosshair]<br> - [survey <survey>] <br> - [open|close]<br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - skyview name <br> - skyview coord <br> - skyview size<br> - skyview pixels<br> - skyview save<br> - skyview frame<br> - skyview survey<br> - ds9.set(string cmd)<br> - skyview<br> - skyview m31 <br> - </tt><tt><tt>skyview name m31 <br> - </tt></tt><tt><tt><tt>skyview name clear<br> - </tt></tt>skyview 00:42:44.404 +41:16:08.78<br> - skyview size 60 60 arcmin<br> - skyview pixels 600 600<br> - skyview save yes<br> - skyview frame current<br> - skyview update frame<br> - skyview survey sdssi<br> - skyview open<br> - skyview close<br> - </tt> - <p><b><a name="sleep"></a>sleep </b></p> - <p>Delays execution for specified number of seconds. Default is 1 - second. </p> - <p> </p> - <tt> Syntax: <br> - sleep [#]<br> - <br> - Example: <br> - ds9.set(string cmd)<br> - sleep<br> - sleep 2<br> - </tt> - <p><b><a name="smooth"></a>smooth</b></p> - <p>Smooth current image or set smooth parameters. <br> - Boxcar width = <i>2*radius+1</i><br> - Tophat diameter = <i>2*radius+1</i><br> - Gaussian diameter = <i>2*radius+1, </i>mean <i>=0</i><br> - Elliptical Gaussian diameter = <i>2*radius+1, </i>mean <i>=0</i> - <tt> </tt><tt>Syntax:</tt><br> - </p> - <tt> smooth []<br> - [yes|no]<br> - [function - boxcar|tophat|gaussian]<br> - </tt><tt> [radius - <value>]<br> - </tt><tt><tt><tt><tt> - [radiusminor <value>]<br> - </tt></tt></tt></tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - [sigma <value>]<br> - </tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - [sigmaminor <value>]<br> - </tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt> - - - - - - - - - - - - - - - - - - - - - - [angle <value>]<br> - </tt></tt></tt></tt></tt></tt></tt></tt><tt> - - - - - - - - - - - - - - - - - - - - - - [match]<br> - [lock [yes|no]]</tt><br> - <tt><tt> [open|close]<br> - </tt> <br> - Example:<br> - string value = ds9.get(string cmd)<br> - smooth<br> - smooth function<br> - </tt><tt><tt>smooth radius<br> - </tt></tt><tt><tt><tt>smooth radiusminor<br> - smooth sigma<br> - smooth sigmaminor<br> - smooth angle<br> - </tt></tt>smooth lock<br> - ds9.set(string cmd)<br> - smooth<br> - smooth yes<br> - smooth function tophat<br> - </tt><tt><tt>smooth radius 4<br> - </tt></tt><tt><tt><tt><tt><tt><tt>smooth radiusminor 4<br> - </tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth - - - - - - - - - - - - - - - - - - - - - - sigma 2.0<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth - - - - - - - - - - - - - - - - - - - - - - sigmaminor 2.0<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth - - - - - - - - - - - - - - - - - - - - - - angle 45<br> - </tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt>smooth - - - - - - - - - - - - - - - - - - - - - - open<br> - smooth close<br> - smooth match<br> - smooth lock yes</tt><br> - <tt>smooth open<br> - smooth close<br> - </tt> - <p><b> <a name="source"></a>source</b></p> - <p>Source TCL code from a file. </p> - <tt> Syntax: <br> - source [filename] <br> - <br> - Example: <br> - ds9.set(string cmd)<br> - source foo.tcl</tt><br> - <p><b> <a name="tcl"></a>tcl</b></p> - <p>Execute one TCL command.<br> - </p> - <tt> Syntax:<br> - tcl <tcl command><br> - <br> - Example: <br> - </tt><tt><tt>ds9.set(string cmd)<br> - </tt>tcl {puts {Hello, World}}<br> - </tt> - <p><b> <a name="threads"></a>threads</b></p> - <p>Set number of process threads for functions which are - multi-threaded. </p> - <tt> Syntax:<br> - threads #<br> - <br> - Example: <br> - </tt><tt>string value = ds9.get(string cmd)<br> - </tt><tt>threads</tt><br> - <tt>ds9.set(string cmd)<br> - </tt><tt>threads 8</tt><br> - <p><b> <a name="tiff"></a>tiff</b></p> - <p>Load TIFF image into current frame. Optional parameters: <tt>tiff - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + <br> +Example:<br></tt> <tt><tt><tt>string value = ds9.get(string +cmd)<br></tt></tt> rgbarray<br> +rgbarray little<br></tt> <tt><tt><tt>ds9.set(string +cmd)<br></tt></tt> rgbarray +foo.arr[dim=512,zdim=3,bitpix=-32,endian=little]<br> +rgbarray new +foo.arr[dim=512,zdim=3,bitpix=</tt><tt>-32,endian=little]</tt><br> +<p><b><a name="rgbcube" id="rgbcube"></a>rgbcube</b></p> +<p>Load FITS rgbcube into rgb frame.<br></p> +<tt>Syntax:<br> +rgbcube [new] [<filename>]<br> + <br> +Example:<br></tt> <tt><tt>string value = ds9.get(string +cmd)<br></tt> rgbcube<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> +rgbcube foo.fits</tt><br> +<tt><tt>rgbcube new foo.fits<br></tt> rgbcube</tt><br> +<tt>rgbcube</tt> <tt>new</tt><br> +<p><b><a name="rgbimage" id="rgbimage"></a>rgbimage</b></p> +<p>Load FITS rgbimage into rgb frame.<br></p> +<tt>Syntax:<br> +rgbimage [new] [<filename>]<br> + <br> +Example:<br></tt> <tt><tt><tt>string value = ds9.get(string +cmd)<br></tt></tt> rgbimage<br></tt> <tt><tt><tt>ds9.set(string +cmd)<br></tt></tt> rgbimage foo.fits</tt><br> +<tt><tt>rgbimage new foo.fits<br></tt> rgbimage</tt><br> +<tt>rgbimage</tt> <tt>new</tt> +<p><b><a name="rotate" id="rotate"></a>rotate</b></p> +<p>Controls the rotation angle (in degrees) of the current +frame.</p> +<tt>Syntax:<br> +rotate [<value>]<br> + [to <value>]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +rotate<br> +ds9.set(string cmd)<br> +rotate 45<br> +rotate to 30<br> +rotate open<br> +rotate close</tt><br> +<p><b><a name="samp" id="samp"></a>samp</b></p> +<p>Configure SAMP protocol.</p> +<tt>Syntax:<br> +samp [no|disconnect]<br> + [broadcast [image|table]]<br> + [send [image|table] +<application>]<br> + <br> +Example:<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> samp +no<br></tt> <tt><tt>samp disconnect<br></tt> samp broadcast +image<br> +samp send image aladin</tt> +<p><b><a name="save" id="save"></a>save<br></b></p> +<p>Save loaded image data of current frame as FITS.</p> +<tt>Syntax:<br> +save</tt> <tt>[fits|rgbimage|rgbcube|mecube|mosaic|mosaicimage] +<filename> [image|table|slice]</tt><br> +<tt> <br> +Example:<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> save +foo.fits</tt><br> +<tt>save fits foo.fits image</tt><br> +<tt>save fits foo.fits table<br> +save fits foo.fits slice</tt><br> +<tt>save rgbimage foo.fits<br></tt> <tt>save rgbcube +foo.fits</tt><br> +<tt>save mecube foo.fits</tt><br> +<tt>save mosaic foo.fits</tt><br> +<tt>save mosaicimage foo.fits</tt><br> +<p><b><a name="saveimage" id="saveimage"></a>saveimage</b></p> +<p>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: <tt>jpeg</tt> quality (1-100) and <tt>tiff</tt> +compression method.</p> +<tt>Syntax:<br> +saveimage</tt> <tt>[fits|eps|gif|tiff|jpeg|png]</tt> +<tt><filename><br> +saveimage <filename>.jpeg [1-100]<br> +saveimage <filename>.tiff [none|jpeg|packbits|deflate]<br> + <br> +Example:<br> +ds9.set(string cmd)<br> +saveimage ds9.tiff<br> +saveimage jpeg ds9.jpeg 75</tt><br> +<p><b><a name="scale" id="scale"></a>scale</b></p> +<p>Controls the limits and color scale distribution.</p> +<tt>Syntax:<br> +scale [linear|log|pow|sqrt|squared|asinh|sinh|histequ]<br> + [log exp <value>]<br> + [datasec yes|no]<br> + [limits <minvalue> +<maxvalue>]<br> + [mode +minmax|<value>|zscale|zmax]<br> + [scope local|global]<br> + [match]<br> + [match limits]<br> + [lock [yes|no]]<br> + [lock limits [yes|no]]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +scale<br> +scale log exp<br> +scale datasec<br> +scale limits<br> +scale mode<br> +scale scope<br> +scale lock<br> +scale lock limits<br> +ds9.set(string cmd)<br> +scale linear<br> +scale log exp 100<br> +scale datasec yes<br> +scale histequ<br> +scale limits 1 100<br> +scale mode zscale<br> +scale mode 99.5<br> +scale scope local<br> +scale match<br> +scale match limits<br> +scale lock yes<br> +scale lock limits yes<br> +scale open<br> +scale close<br></tt> +<p><b><a name="shm" id="shm"></a>shm</b></p> +<p>Load a shared memory segment into the current frame.</p> +<tt>Syntax:<br> +shm [<key> [<filename>]]<br> + [key <key> [<filename>]]<br> + [shmid <id> [<filename>]]<br> + [fits [key|shmid] <id> +[<filename>]]<br> + [mosaicimage [iraf|wcs|wcsa...wcsz|wfpc2] +[key|shmid] <id> [<filename>]]<br> + [mosaic [iraf|wcs|wcsa...wcsz] [key|shmid] +<id> [<filename>]]<br> + [rgbcube [key|shmid] <id> +[<filename>]<br> + [rgbimage [key|shmid] <id> +[<filename>]]<br> + [rgbarray [key|shmid] <id> +[xdim=<x>,ydim=<y>|dim=<dim>,zdim=3],bitpix=<b>,[skip=<s>]]<br> + [array [key|shmid] <id> +[xdim=<x>,ydim=<y>|dim=<dim>],bitpix=<b>,[skip=<s>]]<br> - </tt>compression method. </p> - <tt> Syntax:<br> - tiff [new|slice] [<filename>] [none|jpeg|packbits|deflate]<br> - <br> - Example: <br> - </tt><tt><tt>string value = ds9.get(string cmd)<br> - </tt>tiff</tt><br> - <tt><tt>tiff jpeg</tt><br> - </tt><tt><tt>ds9.set(string cmd)<br> - </tt>tiff foo.tiff<br> - tiff new foo.tiff<br> - tiff slice foo.tiff</tt><tt><tt><br> - </tt>tiff<br> - tiff new<br> - tiff slice</tt><br> - <p><b> <a name="tile"></a>tile</b></p> - <p>Controls the tile display mode. </p> - <tt> Syntax: <br> - tile []<br> - [yes|no] <br> - [mode grid|column|row] <br> - [grid] <br> - [grid mode automatic|manual]<br> - [grid direction x|y]<br> - [grid layout <col> <row>] <br> - [grid gap <pixels>] <br> - [row] <br> - [column] <br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - tile <br> - tile mode <br> - tile grid mode<br> - tile grid direction <br> - tile grid layout <br> - tile grid gap <br> - ds9.set(string cmd)<br> - tile<br> - tile yes <br> - tile mode row <br> - tile grid <br> - tile grid mode manual<br> - tile grid direction x <br> - tile grid layout 5 5 <br> - tile grid gap 10 <br> - tile row <br> - tile column </tt> - <p><b> <a name="update"></a>update</b></p> - <p>Updates 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. </p> - <tt> Syntax: <br> - update [] <br> - [# x1 y1 x2 y2] <br> - [now] <br> - [now # x1 y1 x2 y2]<br> - <br> - Example: <br> - ds9.set(string cmd)<br> - update <br> - update 1 100 100 300 400 <br> - update now <br> - update now 1 100 100 300 400</tt><br> - <p><b> <a name="url"></a>url</b></p> - <p>Load FITS from URL into the current frame</p> - <tt> Syntax: <br> - url <url><br> - <br> - Example: <br> - </tt><tt><tt>ds9.set(string cmd)<br> - </tt>url http://foo.bar.edu/foo.fits </tt> - <p><b> <a name="version"></a>version</b></p> - <p>Returns the current version of DS9. </p> - <tt> Syntax: <br> - version <br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - version </tt> - <p><b> <a name="view"></a>view</b></p> - <p>Controls the GUI. </p> - <tt> Syntax: <br> - view [layout horizontal|vertical]<br> - [keyvalue <string>]<br> - [info yes|no] <br> - [panner yes|no] <br> - [magnifier yes|no] <br> - [buttons yes|no] <br> - [colorbar yes|no]<br> - [colorbar horizontal|vertical]<br> - [colorbar numerics yes|no]<br> - [graph horizontal|vertical - yes|no]<br> - [filename yes|no[<br> - [object yes|no]<br> - [keyword yes|no]<br> - [minmax yes|no]<br> - [lowhigh yes|no]<br> - [units yes|no]<br> - [image|physical|wcs|wcsa...wcsz - yes|no]<br> - </tt><tt><tt> [frame yes|no] <br> - </tt> [red yes|no]<br> - [green yes|no]<br> - [blue yes|no]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - view layout<br> - view keyvalue<br> - view info <br> - view panner<br> - view magnifier<br> - view buttons<br> - view colorbar<br> - view graph horizontal<br> - view filename<br> - view object<br> - view keyword<br> - view minmax<br> - view lowhigh<br> - view units<br> - view image<br> - view wcsa<br> - </tt><tt><tt>view frame<br> - </tt>view red<br> - ds9.set(string cmd)<br> - view layout vertical<br> - view keyvalue BITPIX<br> - view info yes<br> - view panner yes<br> - view magnifier yes<br> - view buttons yes<br> - view colorbar yes<br> - view graph horizontal yes<br> - view filename yes<br> - view object yes<br> - view keyword yes<br> - view minmax yes<br> - view lowhigh yes<br> - view units yes<br> - view wcsa yes<br> - </tt><tt><tt>view frame yes <br> - </tt>view red yes<br> - view green yes<br> - view blue yes</tt><br> - <p><b> <a name="vla"></a>vla</b></p> - <p>Support for VLA Sky Survey. </p> - <tt> Syntax:<br> - vla []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs - fk5<br> - [size <width> - <height> degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [survey first|stripe82]<br> - [open|close]<br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - vla name <br> - vla coord <br> - vla size<br> - vla save<br> - vla frame<br> - vla survey<br> - ds9.set(string cmd)<br> - vla<br> - vla m31 <br> - </tt><tt><tt>vla name m31 <br> - </tt></tt><tt><tt><tt>vla name clear<br> - </tt></tt>vla 00:42:44.404 +41:16:08.78<br> - vla size 60 60 arcmin<br> - vla save yes<br> - vla frame current<br> - vla update frame <br> - vla survey stripe82<br> - vla open<br> - vla close<br> - </tt> - <p><b> <a name="vlss"></a>vlss</b></p> - <p>Support for NRAO VLSS Sky Survey.</p> - <tt> Syntax: <br> - vlss []<br> - [<object>]<br> - [name <object>|clear]<br> - [<ra> <dec>] # in wcs fk5<br> - [size <width> <height> - degrees|arcmin|arcsec]<br> - [save yes|no]<br> - [frame new|current]<br> - [update frame|crosshair]<br> - [open|close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - vlss name <br> - vlss coord <br> - vlss size<br> - vlss save<br> - vlss frame<br> - ds9.set(string cmd)<br> - vlss<br> - vlss m31 <br> - </tt><tt><tt>vlss name m31 <br> - </tt></tt><tt><tt><tt>vlss name clear<br> - </tt></tt>vlss 00:42:44.404 +41:16:08.78<br> - vlss size 60 60 arcmin<br> - vlss save yes<br> - vlss frame current<br> - vlss update frame<br> - vlss open<br> - vlss close</tt><br> - <p><b> <a name="vo"></a>vo</b></p> - <p>Invoke an connection to a Virtual Observatory site. </p> - <tt> Syntax: <br> - vo [method xpa|mime]<br> - [server <url>]<br> - [internal yes|no]<br> - [delay #]<br> - [<url>]<br> - [connect <url>]<br> - [disconnect <url>]<br> - [open|close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - vo<br> - vo method<br> - vo server<br> - vo internal<br> - vo delay<br> - vo connect<br> - ds9.set(string cmd)<br> - vo method xpa<br> - vo server "http://foo.bar.edu/list.txt"<br> - vo internal yes<br> - vo delay 15<br> - vo chandra-ed<br> - vo connect chandra-ed<br> - vo disconnect chandra-ed<br> - vo open<br> - vo close<br> - </tt> - <p><b> <a name="wcs"></a>wcs</b></p> - <p>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 <a - href="file.html#WCS">WCS</a> for more information. </p> - <tt> Syntax: <br> - wcs [[system] wcs|wcsa...wcsz] <br> - [[sky] fk4|fk5|icrs|galactic|ecliptic] <br> - [[skyformat] degrees|sexagesimal] <br> - [align yes|no] <br> - [reset [#]] <br> - [replace [#] <filename>] <br> - [append [#] <filename>] <br> - [open|close]<br> - <br> - Example: <br> - string value = ds9.get(string cmd)<br> - wcs <br> - wcs system <br> - wcs sky <br> - wcs skyformat <br> - wcs align <br> - ds9.set(string cmd)<br> - wcs wcs <br> - wcs system wcs<br> - </tt><tt>wcs fk5<br> - </tt><tt>wcs sky fk5<br> - </tt><tt>wcs sexagesimal <br> - </tt><tt>wcs skyformat sexagesimal <br> - wcs align yes <br> - wcs reset <br> - wcs reset 3<br> - wcs replace foo.wcs <br> - wcs replace 3 foo.wcs <br> - wcs append foo.wcs <br> - wcs append 3 foo.wcs <br> - ds9.set(string cmd, string url)<br> - wcs replace <br> - wcs append<br> - wcs open<br> - wcs close<br> - </tt> - <p><b> <a name="web"></a>web</b></p> - <p>Display specified URL in the web display. </p> - <tt> Syntax:<br> - web </tt><tt><tt>[]<br> - [<url>]<br> - [new <webname> <url>]<br> - </tt> [<webname>] [click - back|forward|stop|reload|#]<br> - [<webname>] [clear]<br> - [<webname>] [close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - web <br> - ds9.set(string cmd)<br> - web www.cnn.com<br> - web new www.cnn.com<br> - web hvweb www.apple.com<br> - web click back<br> - web click 2<br> - web clear<br> - web close<br> - </tt> - <p><b> <a name="width"></a>width</b></p> - <p>Set the width of the image display window.</p> - <tt> Syntax: <br> - width [<value>]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - width<br> - ds9.set(string cmd)<br> - width 512<br> - </tt> - <p><b> <a name="zscale"></a>zscale</b></p> - <p>Set Scale Limits based on the <i>IRAF</i> algorithm. </p> - <tt> Syntax: <br> - zscale []<br> - [contrast]<br> - [sample]<br> - [line]<br> - <br> - Example:<br> - string value = ds9.get(string cmd)<br> - zscale contrast<br> - zscale sample<br> - zscale line<br> - ds9.set(string cmd)<br> - zscale<br> - zscale contrast .25<br> - zscale sample 600<br> - zscale line 120<br> - </tt> - <p><b> <a name="zoom"></a>zoom</b></p> - <p>Controls the current zoom value for the current frame. </p> - <tt> Syntax: <br> - zoom [<value>] <br> - [<value> <value>]<br> - [to <value>] <br> - [to <value> <value>]<br> - [in]<br> - [out]<br> - [to fit] <br> - [open|close]<br> - <br> - Example:<br> - string value = ds9.get(string cmd) <br> - zoom <br> - ds9.set(string cmd)<br> - zoom 2 <br> - zoom 2 4<br> - zoom to 4 <br> - zoom to 2 4<br> - zoom in<br> - zoom out<br> - zoom to fit<br> - zoom open<br> - zoom close<br> - </tt> </blockquote> - </body> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +shm<br> +ds9.set(string cmd)<br> +shm 102<br> +shm key 102<br> +shm shmid 102 foo<br> +shm fits key 100 foo<br> +shm mosaicimage iraf key 100 foo<br> +shm mosaicimage wcs key 100 foo<br> +shm mosaicimage wcsa key 100 foo<br> +shm mosaicimage wfpc2 key 100 foo<br> +shm mosaic iraf key 100 foo<br> +shm mosaic wcs key 100 foo<br> +shm rgbcube key 100 foo<br> +shm rgbimage key 100 foo<br> +shm rgbarray key 100 [dim=200,zdim=3,bitpix=-32]<br> +shm array shmid 102 [dim=32,bitpix=-32]<br> +<br></tt> <b><a name="sia" id="sia"></a>sia<br></b> +<p>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.</p> +<tt>Syntax:<br> +sia</tt> +<tt><tt><tt>[2mass|akari|astrowise|cadc|cxc|mast|sdss|skyview|tgssadr</tt><tt>]</tt></tt><br> + +<br></tt> <tt> </tt><tt> +[<ref>] [cancel]<br></tt> <tt> + [<ref>] [clear]<br></tt> <tt> + [<ref>] [close]</tt><br> +<tt> [<ref>] [coordinate +<ra> <dec> <coordsys>]</tt><tt><br></tt> +<tt> </tt> +<tt>[<ref>] [crosshair]</tt><br> +<tt> [<ref>] +[export sb|tsv <filename>]<br></tt> <tt> + [<ref>] [name <object>]<br></tt> +<tt> [<ref>] [print]</tt><br> +<tt><tt> [<ref>] +[retrieve]</tt><br></tt> +<tt> [<ref>] [save +<filename>]</tt><br> +<tt> [<ref>] [radius +<value> degrees|arcmin|arcsec]</tt><br> +<tt> [<ref>] [sky +<skyframe>]<br></tt> <tt> + [<ref>] [skyformat +<skyformat>]<br></tt> <tt> + [<ref>] [system +<coordsys>]</tt><tt><br></tt> <tt> + </tt> <tt>[<ref>] [update]</tt><br> + <tt><br> +Example:<br> +string value = ds9.get(string cmd)<br> +sia<br> +<br> +ds9.set(string cmd)<br> +sia</tt> <tt>2mass<br> +sia</tt> <tt>cancel<br> +sia</tt> <tt>clear<br> +sia</tt> <tt>close<br> +sia</tt> <tt>coordinate 202.48 47.21 fk5<br> +sia</tt> <tt>crosshair<br> +sia</tt> <tt>export tsv bar.tsv<br> +sia</tt> <tt>name m51<br> +sia</tt> <tt>print</tt><br> +<tt>sia</tt> <tt>retrieve<br> +sia</tt> <tt>save foo.xml<br> +sia</tt> <tt>radius 1degrees</tt><br> +<tt>sia</tt> <tt>sky fk5<br> +sia skyformat degrees<br> +sia</tt> <tt>system wcs</tt><tt><br> +sia</tt> <tt>update<br> +<br></tt> <b><a name="single" id="single"></a>single</b> +<p>Select Single Display mode</p> +<tt>Syntax:<br> +single<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +single<br> +ds9.set(string cmd)<br> +single<br></tt> +<p><b><a name="skyview" id="skyview"></a>skyview</b></p> +<p>Support for SkyView image server at HEASARC.</p> +<tt>Syntax:<br> +skyview []<br> + [<object>]<br> + [name +<object>|clear]<br> + [<ra> <dec>] +# in wcs fk5<br> + [size <width> +<height> degrees|arcmin|arcsec]<br> + [pixels <width> +<height>]<br> + [save yes|no]<br> + [frame new|current]<br> + [update +frame|crosshair]<br> + [survey <survey>]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +skyview name<br> +skyview coord<br> +skyview size<br> +skyview pixels<br> +skyview save<br> +skyview frame<br> +skyview survey<br> +ds9.set(string cmd)<br> +skyview<br> +skyview m31<br></tt> <tt><tt>skyview name m31<br></tt></tt> +<tt><tt><tt>skyview name clear<br></tt></tt> skyview 00:42:44.404 ++41:16:08.78<br> +skyview size 60 60 arcmin<br> +skyview pixels 600 600<br> +skyview save yes<br> +skyview frame current<br> +skyview update frame<br> +skyview survey sdssi<br> +skyview open<br> +skyview close<br></tt> +<p><b><a name="sleep" id="sleep"></a>sleep</b></p> +<p>Delays execution for specified number of seconds. Default is 1 +second.</p> +<tt>Syntax:<br> +sleep [#]<br> + <br> +Example:<br> +ds9.set(string cmd)<br> +sleep<br> +sleep 2<br></tt> +<p><b><a name="smooth" id="smooth"></a>smooth</b></p> +<p>Smooth current image or set smooth parameters.<br> +Boxcar width = <i>2*radius+1</i><br> +Tophat diameter = <i>2*radius+1</i><br> +Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i><br> +Elliptical Gaussian diameter = <i>2*radius+1,</i> mean <i>=0</i> +<tt>Syntax:</tt><br></p> +<tt>smooth []<br> + [yes|no]<br> + [function +boxcar|tophat|gaussian]<br></tt> +<tt> [radius +<value>]<br></tt> +<tt><tt><tt><tt> [radiusminor +<value>]<br></tt></tt></tt></tt> +<tt><tt><tt><tt><tt><tt> [sigma +<value>]<br></tt></tt></tt></tt></tt></tt> +<tt><tt><tt><tt><tt><tt> +[sigmaminor <value>]<br></tt></tt></tt></tt></tt></tt> +<tt><tt><tt><tt><tt><tt><tt><tt> +[angle <value>]<br></tt></tt></tt></tt></tt></tt></tt></tt> +<tt> [match]<br> + [lock [yes|no]]</tt><br> +<tt><tt> [open|close]<br> + </tt><br> +Example:<br> +string value = ds9.get(string cmd)<br> +smooth<br> +smooth function<br></tt> <tt><tt>smooth radius<br></tt></tt> +<tt><tt><tt>smooth radiusminor<br> +smooth sigma<br> +smooth sigmaminor<br> +smooth angle<br></tt></tt> smooth lock<br> +ds9.set(string cmd)<br> +smooth<br> +smooth yes<br> +smooth function tophat<br></tt> <tt><tt>smooth radius +4<br></tt></tt> <tt><tt><tt><tt><tt><tt>smooth radiusminor +4<br></tt></tt></tt></tt></tt></tt> +<tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth sigma +2.0<br></tt></tt></tt></tt></tt></tt></tt></tt></tt> +<tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth sigmaminor +2.0<br></tt></tt></tt></tt></tt></tt></tt></tt></tt> +<tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt><tt>smooth angle +45<br></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt></tt> +smooth open<br> +smooth close<br> +smooth match<br> +smooth lock yes</tt><br> +<tt>smooth open<br> +smooth close<br></tt> +<p><b><a name="source" id="source"></a>source</b></p> +<p>Source TCL code from a file.</p> +<tt>Syntax:<br> +source [filename]<br> + <br> +Example:<br> +ds9.set(string cmd)<br> +source foo.tcl</tt><br> +<p><b><a name="tcl" id="tcl"></a>tcl</b></p> +<p>Execute one TCL command.<br></p> +<tt>Syntax:<br> +tcl <tcl command><br> + <br> +Example:<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> tcl {puts +{Hello, World}}<br></tt> +<p><b><a name="threads" id="threads"></a>threads</b></p> +<p>Set number of process threads for functions which are +multi-threaded.</p> +<tt>Syntax:<br> +threads #<br> + <br> +Example:<br></tt> <tt>string value = ds9.get(string cmd)<br></tt> +<tt>threads</tt><br> +<tt>ds9.set(string cmd)<br></tt> <tt>threads 8</tt><br> +<p><b><a name="tiff" id="tiff"></a>tiff</b></p> +<p>Load TIFF image into current frame. Optional parameters: +<tt>tiff</tt> compression method.</p> +<tt>Syntax:<br> +tiff [new|slice] [<filename>] +[none|jpeg|packbits|deflate]<br> + <br> +Example:<br></tt> <tt><tt>string value = ds9.get(string +cmd)<br></tt> tiff</tt><br> +<tt><tt>tiff jpeg</tt><br></tt> <tt><tt>ds9.set(string +cmd)<br></tt> tiff foo.tiff<br> +tiff new foo.tiff<br> +tiff slice foo.tiff</tt><tt><tt><br></tt> tiff<br> +tiff new<br> +tiff slice</tt><br> +<p><b><a name="tile" id="tile"></a>tile</b></p> +<p>Controls the tile display mode.</p> +<tt>Syntax:<br> +tile []<br> + [yes|no]<br> + [mode grid|column|row]<br> + [grid]<br> + [grid mode automatic|manual]<br> + [grid direction x|y]<br> + [grid layout <col> <row>]<br> + [grid gap <pixels>]<br> + [row]<br> + [column]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +tile<br> +tile mode<br> +tile grid mode<br> +tile grid direction<br> +tile grid layout<br> +tile grid gap<br> +ds9.set(string cmd)<br> +tile<br> +tile yes<br> +tile mode row<br> +tile grid<br> +tile grid mode manual<br> +tile grid direction x<br> +tile grid layout 5 5<br> +tile grid gap 10<br> +tile row<br> +tile column</tt> +<p><b><a name="update" id="update"></a>update</b></p> +<p>Updates 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.</p> +<tt>Syntax:<br> +update []<br> + [# x1 y1 x2 y2]<br> + [now]<br> + [now # x1 y1 x2 y2]<br> + <br> +Example:<br> +ds9.set(string cmd)<br> +update<br> +update 1 100 100 300 400<br> +update now<br> +update now 1 100 100 300 400</tt><br> +<p><b><a name="url" id="url"></a>url</b></p> +<p>Load FITS from URL into the current frame</p> +<tt>Syntax:<br> +url <url><br> + <br> +Example:<br></tt> <tt><tt>ds9.set(string cmd)<br></tt> url +http://foo.bar.edu/foo.fits</tt> +<p><b><a name="version" id="version"></a>version</b></p> +<p>Returns the current version of DS9.</p> +<tt>Syntax:<br> +version<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +version</tt> +<p><b><a name="view" id="view"></a>view</b></p> +<p>Controls the GUI.</p> +<tt>Syntax:<br> +view [layout horizontal|vertical]<br> + [keyvalue <string>]<br> + [info yes|no]<br> + [panner yes|no]<br> + [magnifier yes|no]<br> + [buttons yes|no]<br> + [colorbar yes|no]<br> + [colorbar horizontal|vertical]<br> + [colorbar numerics yes|no]<br> + [graph horizontal|vertical +yes|no]<br> + [filename yes|no[<br> + [object yes|no]<br> + [keyword yes|no]<br> + [minmax yes|no]<br> + [lowhigh yes|no]<br> + [units yes|no]<br> + [image|physical|wcs|wcsa...wcsz +yes|no]<br></tt> <tt><tt> [frame +yes|no]<br></tt> [red yes|no]<br> + [green yes|no]<br> + [blue yes|no]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +view layout<br> +view keyvalue<br> +view info<br> +view panner<br> +view magnifier<br> +view buttons<br> +view colorbar<br> +view graph horizontal<br> +view filename<br> +view object<br> +view keyword<br> +view minmax<br> +view lowhigh<br> +view units<br> +view image<br> +view wcsa<br></tt> <tt><tt>view frame<br></tt> view red<br> +ds9.set(string cmd)<br> +view layout vertical<br> +view keyvalue BITPIX<br> +view info yes<br> +view panner yes<br> +view magnifier yes<br> +view buttons yes<br> +view colorbar yes<br> +view graph horizontal yes<br> +view filename yes<br> +view object yes<br> +view keyword yes<br> +view minmax yes<br> +view lowhigh yes<br> +view units yes<br> +view wcsa yes<br></tt> <tt><tt>view frame yes<br></tt> view red +yes<br> +view green yes<br> +view blue yes</tt><br> +<p><b><a name="vla" id="vla"></a>vla</b></p> +<p>Support for VLA Sky Survey.</p> +<tt>Syntax:<br> +vla []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs +fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [survey first|stripe82]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +vla name<br> +vla coord<br> +vla size<br> +vla save<br> +vla frame<br> +vla survey<br> +ds9.set(string cmd)<br> +vla<br> +vla m31<br></tt> <tt><tt>vla name m31<br></tt></tt> <tt><tt><tt>vla +name clear<br></tt></tt> vla 00:42:44.404 +41:16:08.78<br> +vla size 60 60 arcmin<br> +vla save yes<br> +vla frame current<br> +vla update frame<br> +vla survey stripe82<br> +vla open<br> +vla close<br></tt> +<p><b><a name="vlss" id="vlss"></a>vlss</b></p> +<p>Support for NRAO VLSS Sky Survey.</p> +<tt>Syntax:<br> +vlss []<br> + [<object>]<br> + [name <object>|clear]<br> + [<ra> <dec>] # in wcs fk5<br> + [size <width> <height> +degrees|arcmin|arcsec]<br> + [save yes|no]<br> + [frame new|current]<br> + [update frame|crosshair]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +vlss name<br> +vlss coord<br> +vlss size<br> +vlss save<br> +vlss frame<br> +ds9.set(string cmd)<br> +vlss<br> +vlss m31<br></tt> <tt><tt>vlss name m31<br></tt></tt> +<tt><tt><tt>vlss name clear<br></tt></tt> vlss 00:42:44.404 ++41:16:08.78<br> +vlss size 60 60 arcmin<br> +vlss save yes<br> +vlss frame current<br> +vlss update frame<br> +vlss open<br> +vlss close</tt><br> +<p><b><a name="vo" id="vo"></a>vo</b></p> +<p>Invoke an connection to a Virtual Observatory site.</p> +<tt>Syntax:<br> +vo [method xpa|mime]<br> + [server <url>]<br> + [internal yes|no]<br> + [delay #]<br> + [<url>]<br> + [connect <url>]<br> + [disconnect <url>]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +vo<br> +vo method<br> +vo server<br> +vo internal<br> +vo delay<br> +vo connect<br> +ds9.set(string cmd)<br> +vo method xpa<br> +vo server "http://foo.bar.edu/list.txt"<br> +vo internal yes<br> +vo delay 15<br> +vo chandra-ed<br> +vo connect chandra-ed<br> +vo disconnect chandra-ed<br> +vo open<br> +vo close<br></tt> +<p><b><a name="wcs" id="wcs"></a>wcs</b></p> +<p>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 <a href="file.html#WCS">WCS</a> for more +information.</p> +<tt>Syntax:<br> +wcs [[system] wcs|wcsa...wcsz]<br> + [[sky] fk4|fk5|icrs|galactic|ecliptic]<br> + [[skyformat] degrees|sexagesimal]<br> + [align yes|no]<br> + [reset [#]]<br> + [replace [#] <filename>]<br> + [append [#] <filename>]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +wcs<br> +wcs system<br> +wcs sky<br> +wcs skyformat<br> +wcs align<br> +ds9.set(string cmd)<br> +wcs wcs<br> +wcs system wcs<br></tt> <tt>wcs fk5<br></tt> <tt>wcs sky +fk5<br></tt> <tt>wcs sexagesimal<br></tt> <tt>wcs skyformat +sexagesimal<br> +wcs align yes<br> +wcs reset<br> +wcs reset 3<br> +wcs replace foo.wcs<br> +wcs replace 3 foo.wcs<br> +wcs append foo.wcs<br> +wcs append 3 foo.wcs<br> +ds9.set(string cmd, string url)<br> +wcs replace<br> +wcs append<br> +wcs open<br> +wcs close<br></tt> +<p><b><a name="web" id="web"></a>web</b></p> +<p>Display specified URL in the web display.</p> +<tt>Syntax:<br> +web</tt> <tt><tt>[]<br> + [<url>]<br> + [new <webname> <url>]<br></tt> + [<webname>] [click +back|forward|stop|reload|#]<br> + [<webname>] [clear]<br> + [<webname>] [close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +web<br> +ds9.set(string cmd)<br> +web www.cnn.com<br> +web new www.cnn.com<br> +web hvweb www.apple.com<br> +web click back<br> +web click 2<br> +web clear<br> +web close<br></tt> +<p><b><a name="width" id="width"></a>width</b></p> +<p>Set the width of the image display window.</p> +<tt>Syntax:<br> +width [<value>]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +width<br> +ds9.set(string cmd)<br> +width 512<br></tt> +<p><b><a name="zscale" id="zscale"></a>zscale</b></p> +<p>Set Scale Limits based on the <i>IRAF</i> algorithm.</p> +<tt>Syntax:<br> +zscale []<br> + [contrast]<br> + [sample]<br> + [line]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +zscale contrast<br> +zscale sample<br> +zscale line<br> +ds9.set(string cmd)<br> +zscale<br> +zscale contrast .25<br> +zscale sample 600<br> +zscale line 120<br></tt> +<p><b><a name="zoom" id="zoom"></a>zoom</b></p> +<p>Controls the current zoom value for the current frame.</p> +<tt>Syntax:<br> +zoom [<value>]<br> + [<value> <value>]<br> + [to <value>]<br> + [to <value> <value>]<br> + [in]<br> + [out]<br> + [to fit]<br> + [open|close]<br> + <br> +Example:<br> +string value = ds9.get(string cmd)<br> +zoom<br> +ds9.set(string cmd)<br> +zoom 2<br> +zoom 2 4<br> +zoom to 4<br> +zoom to 2 4<br> +zoom in<br> +zoom out<br> +zoom to fit<br> +zoom open<br> +zoom close<br></tt></blockquote> +</body> </html> |