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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
.help pcol Sep91 plot
.ih
NAME
pcol -- plot an image column
.ih
USAGE
pcol image col
.ih
PARAMETERS
.ls image
Input image containing column to be plotted.
.le
.ls col
The column to be plotted.
.le
.ls wcs = "logical"
The world coordinate system (\fIwcs\fR) to be used for axis labeling when
input is f rom images.
The following standard world systems are predefined.
.ls logical
Logical coordinates are image pixel coordinates relative to the image currently
being displayed.
.le
.ls physical
The physical coordinate system is invariant with respect to linear
transformations of the physical image matrix. For example, if the reference
image was created by extracting a section of another image, the physical
coordinates of an object in the reference image will be the pixel coordinates
of the same object in the original image. The physical coordinate system
thus provides a consistent coordinate system (a given object always has the
same coordinates) for all images, regardless of whether any user world
coordinate systems have been defined.
.le
.ls world
The "world" coordinate system is the \fIcurrent default WCS\fR.
The default world system is the system named by the environment variable
\fIdefwcs\fR if defined in the user environment and present in the reference
image WCS description, else it is the first user WCS defined for the image
(if any), else physical coordinates are returned.
.le
.le
.ls wx1=0., wx2=0., wy1=0., wy2=0.
The range of window (user) coordinates to be included in the plot. If
the range of values in x or y = 0, the plot is automatically scaled
from the minimum to maximum data values along the degenerate axis.
.le
.ls vx1=0., vx2=0., vy1=0., vy2=0.
NDC coordinates (0-1) of the device plotting viewport. If not set by
user, a suitable viewport which allows sufficient room for all labels
is used.
.le
.ls pointmode = no
Plot individual points instead of a line?
.le
.ls marker = "box"
Marker or line type to be drawn. If \fBpointmode\fR = yes the markers are
"point", "box", "cross", "plus", "circle", "hebar", "vebar", "hline",
"vline" or "diamond". Any other value defaults to "box". If drawing lines,
\fBpointmode\fR = no, the values are "line", "lhist", "bhist". Any other
value defaults to "line". "bhist" (box histogram) draws lines to the
bottom of the graph while "lhist" does not. In both cases the
horizontal histogram lines run between the half way points (reflected
at the ends).
.le
.ls szmarker = 0.005
The size of the marker drawn when \fBpointmode\fR = yes.
.le
.ls logx = no, logy = no
Draw the x or y axis in log units, versus linear?
.le
.ls xlabel = "wcslabel", ylabel = ""
Label for the X-axis or Y-axis. if \fBxlabel\fR = "wcslabel"
the world coordinate system label in the image, if defined, is used.
.le
.ls xformat = "wcsformat"
The numerical format for the coordinate labels. The values may be ""
(an empty string), %f for decimal format, %h and %H for xx:xx:xx format, and
%m and %M for xx:xx.x format. The upper case %H and %M convert degrees
to hours. Some images have a recommended x coordinate format defined as
a WCS attribute. If the xformat value is "wcsformat" the WCS attribute
format will be used. Any other value will override the image attribute.
.le
.ls title = "imtitle"
Title for plot. If not changed from the default, the title string from the
image header, appended with the columns being plotted, is used.
.le
.ls majrx=5, minrx=5, majry=5, minry=5
The number of major and minor divisions along the x or y axis.
.le
.ls round = no
Round axes up to nice values?
.le
.ls fill = yes
Fill plotting viewport regardless of device aspect ratio?
.le
.ls append = no
Append to an existing plot?
.le
.ls device="stdgraph"
Output device.
.le
.ih
DESCRIPTION
Plot a specified column of an image. The user can control the
plot size and placement, the scaling and labeling of axes. The column can be
plotted as a continuous line or individual points with a specified marker.
If \fBappend\fR is enabled, previous values for \fBbox\fR,
\fBfill\fR, \fBround\fR, the plotting viewport (\fBvx1\fR, \fBvx2\fR,
\fBvy1\fR, \fBvy2\fR), and the plotting window (\fBwx1\fR, \fBwx2\fR,
\fBwy1\fR, \fBwy2\fR) are used.
If the plotting viewport was not set by the user, \fBpcol\fR
automatically sets a viewport centered on the device. The default value
of \fBfill\fR = yes means the plot spans equal amounts of NDC space in
x and y. Setting
the value of \fBfill\fR to "no" means the viewport will be adjusted so
that the square plot will span equal physical lengths in x and y
when plotted. That is, when \fBfill = no\fR, a unity aspect ratio is
enforced, and plots
appear square regardless of the device aspect ratio. On devices with non
square full device viewports (e.g., the vt640), a plot drawn by \fIpcol\fR
appears extended in the x direction unless \fBfill\fR = no.
.ih
EXAMPLES
1. Plot column 128 of image crab.5009 with default parameters:
.nf
cl> pcol crab.5009 128
.fi
2. Overplot column 128 of crab.red using boxes to mark the added points:
.nf
cl> pcol crab.red 128 append+ pointmode+
.fi
3. Annotate the axes of a column plot:
.nf
cl> pcol crab.5009 64 xlabel="Row Number" ylabel=Intensity
.fi
.ih
TIME REQUIREMENTS
\fBpcol\fR requires about 1.6 cp seconds to plot a column of a 512 square
image.
.ih
BUGS
.ih
SEE ALSO
prow, prows, pcols
.endhelp
|
