summaryrefslogtreecommitdiffstats
path: root/ds9/doc/ref/grid.html
blob: baeeff173429b3ff774d2e3d7a2843bcf26bae96 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
<!DOCTYPE doctype PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<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>Coordinate Grids</title>
</head>
<body alink="#FF0000" bgcolor="#FFFFFF" link="#0000EE" text=
"#000000" vlink="#551A8B">
<h3><img alt="" src="../sun.gif" align="middle" height="98" width=
"100"> Coordinate Grids</h3>
<blockquote>
<p>DS9 can create and display coordinate grids as an overlay on an
image. The Display Coordinate Grid Menu is used to display grids. A
coordinate grid is composed of Grid Lines, Axes, Border, and Title.
Axes include tick marks, title, and numbers. The appearance of the
coordinate grid is specified by parameters. These parameters may be
configured via the Coordinate Grid Parameters dialog box. In
addition to the axes titles and the grid title, the following menus
are available.</p>
<p><b><a name="Format" id="Format"></a>Numeric Formats</b></p>
<p>The user may specify custom numeric formats for either axes. The
format specification can be empty (default) or a print function,
based on the selected coordinate system:<br></p>
<blockquote><tt>image</tt><br>
<tt>physical</tt><br>
<tt>detector</tt><br>
<tt>amplifier</tt><br>
<tt>wcs linear</tt><br>
<tt>wcs equatorial</tt><br></blockquote>
<p>The format specification string to be passed to the C "printf"
function (e.g. "%%1.7G") in order to format a single coordinate
value.</p>
<p>The Format string supplied should contain one or more of the
following characters. These may occur in any order, but the
following is recommended for clarity:</p>
<blockquote>"": Indicates that a plus sign should be prefixed to
positive values. By default, no plus sign is used.<br>
"z": Indicates that leading zeros should be prefixed to the value
so that the first field is of constant width, as would be required
in a fixed-width table (leading zeros are always prefixed to any
fields that follow). By default, no leading zeros are added.<br>
"i": Use the standard ISO field separator (a colon) between fields.
This is the default behaviour.<br>
"b": Use a blank to separate fields.<br>
"l": Use a letter ("h"/"d", "m" or "s" as appropriate) to separate
fields.<br>
"g": Use a letter and symbols to separate fields ("h"/"d", "m" or
"s", etc, as appropriate), but include escape sequences in the
formatted value so that the Plot class will draw the separators as
small super-scripts.<br>
"d": Include a degrees field. Expressing the angle purely in
degrees is also the default if none of "h", "m", "s" or "t" are
given.<br>
"h": Express the angle as a time and include an hours field (where
24 hours correspond to 360 degrees). Expressing the angle purely in
hours is also the default if "t" is given without either "m" or
"s".<br>
"m": Include a minutes field. By default this is not included.<br>
"s": Include a seconds field. By default this is not included. This
request is ignored if "d" or "h" is given, unless a minutes field
is also included.<br>
"t": Express the angle as a time (where 24 hours correspond to 360
degrees). This option is ignored if either "d" or "h" is given and
is intended for use where the value is to be expressed purely in
minutes and/or seconds of time (with no hours field). If "t" is
given without "d", "h", "m" or "s" being present, then it is
equivalent to "h".<br>
".": Indicates that decimal places are to be given for the final
field in the formatted string (whichever field this is). The "."
should be followed immediately by an unsigned integer which gives
the number of decimal places required, or by an asterisk. If an
asterisk is supplied, a default number of decimal places is used
which is based on the value of the Digits
attribute.<br></blockquote>
<p>All of the above format specifiers are case-insensitive. If
several characters make conflicting requests (e.g. if both "i" and
"b" appear), then the character occurring last takes precedence,
except that "d" and "h" always override "t".</p>
<p>The default formats are <tt>d.3</tt> for degrees and
<tt>hms.1</tt> / <tt>dms.1</tt> / <tt>ldms.1</tt> for
sexagesimal.<br></p>
</blockquote>
</body>
</html>