![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to postmd.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10no / cmd / post.src / postmd|
Return to postmd.1 CVS log | Up to [Research Unix] / researchv10no / cmd / post.src / postmd |
1.1 root 1: .ds dQ /usr/lib/postscript
2: .TH POSTMD 1 "DWB 3.2"
3: .SH NAME
4: .B postmd
5: \- matrix display program for PostScript printers
6: .SH SYNOPSIS
7: \*(mBpostmd\f1
8: .OP "" options []
9: .OP "" files []
10: .SH DESCRIPTION
11: .B postmd
12: reads a series of floating point numbers from
13: .IR files ,
14: translates them into a PostScript gray scale image,
15: and writes the results on the standard output.
16: In a typical application the numbers might be
17: the elements of a large matrix,
18: written in row major order,
19: while the printed image could help locate
20: patterns in the matrix.
21: If no
22: .I files
23: are specified, or if
24: .OP \-
25: is one of the input
26: .IR files ,
27: the standard input is read.
28: The following
29: .I options
30: are understood:
31: .TP 0.75i
32: .OP \-b num
33: Pack the bitmap in the output file using
34: .I num
35: byte patterns.
36: A value of 0 turns off all packing of the output file.
37: By default
38: .I num
39: is 6.
40: .TP
41: .OP \-c num
42: Print
43: .I num
44: copies of each page.
45: By default only one copy is printed.
46: .TP
47: .OP \-d dimen
48: Sets the default matrix dimensions for all input
49: .I files
50: to
51: .IR dimen .
52: The
53: .I dimen
54: string can be given as rows or rows\^\(mu\^columns.
55: If columns is omitted it will be set to rows.
56: By default
57: .B postmd
58: assumes each matrix is square and sets the number of rows
59: and columns to the square root of the number of elements in
60: each input file.
61: .TP
62: .OP \-g list
63: .I list
64: is a comma- or space-separated string of integers, each lying between
65: 0 and 255 inclusive,
66: that assigns PostScript gray scales to the regions of the real line
67: selected by the
68: .OP \-i
69: option.
70: 255 corresponds to white and 0 to black.
71: .B postmd
72: assigns a default gray scale that omits white (i.e., 255) and gets
73: darker as the regions move from left to right along the real line.
74: .TP
75: .OP \-i list
76: .I list
77: is a comma- or space-separated string of
78: .I N
79: floating point numbers that
80: partition the real line into
81: .RI 2 N +1
82: regions.
83: The
84: .I list
85: must be given in increasing numerical order.
86: The partitions are used to map floating point numbers read from the input
87: .I files
88: into gray scale integers that are assigned automatically by
89: .B postmd
90: or arbitrarily selected using the
91: .OP \-g
92: option.
93: The default interval
94: .I list
95: is ``\*(mB\-1,0,1\fP'' which partions the real line into 7 regions.
96: .TP
97: .OP \-m num
98: Magnify each logical page by the factor
99: .IR num .
100: Pages are scaled uniformly about the origin,
101: which by default is located at the center of
102: each page.
103: The default magnification is 1.0.
104: .TP
105: .OP \-n num
106: Print
107: .I num
108: logical pages on each piece of paper,
109: where
110: .I num
111: can be any positive integer.
112: By default
113: .I num
114: is set to 1.
115: .TP
116: .OP \-o list
117: Print pages whose numbers are given in the comma separated
118: .IR list .
119: The list contains single numbers
120: .I N
121: and ranges
122: .IR N1\-\|N2 .
123: A missing
124: .I N1
125: means the lowest numbered page, a missing
126: .I N2
127: means the highest.
128: .TP
129: .OP \-p mode
130: Print
131: .I files
132: in either \*(mBportrait\fP or \*(mBlandscape\fP
133: .IR mode .
134: Only the first character of
135: .I mode
136: is significant.
137: The default
138: .I mode
139: is \*(mBportrait\fP.
140: .TP
141: .OP \-w window
142: .I window
143: is a comma- or space-separated list of four positive integers that
144: select the upper left and lower right corners of a submatrix from
145: each of the input
146: .IR files .
147: Row and column indices start at 1 in the upper left corner and the
148: numbers in the input
149: .I files
150: are assumed to be written in row major order.
151: By default the entire matrix is displayed.
152: .TP
153: .OP \-x num
154: Translate the origin
155: .I num
156: inches along the positive x axis.
157: The default
158: coordinate system has the origin fixed at the
159: center of the page, with positive
160: x to the right and positive y up the page.
161: Positive
162: .I num
163: moves everything right.
164: The default offset is 0 inches.
165: .TP
166: .OP \-y num
167: Translate the origin
168: .I num
169: inches along the positive y axis.
170: Positive
171: .I num
172: moves everything up the page.
173: The default offset is 0.
174: .TP
175: .OP \-E name
176: Set the character encoding for text fonts to
177: .IR name .
178: Requesting
179: .I name
180: means include file
181: .MI \*(dQ/ name .enc \f1.
182: A nonexistent encoding file is silently ignored.
183: The default selects file
184: .MR \*(dQ/Default.enc .
185: .TP
186: .OP \-L file
187: Use
188: .I file
189: as the PostScript prologue.
190: .br
191: The default is
192: .MR \*(dQ/postmd.ps .
193: .PP
194: Three options allow insertion of arbitrary PostScript
195: at controlled points in the translation process:
196: .TP 0.75i
197: .OP \-C file
198: Copy
199: .I file
200: to the output file;
201: .I file
202: must contain legitimate PostScript.
203: .TP
204: .OP \-P string
205: Include
206: .I string
207: in the output file;
208: .I string
209: must be legitimate PostScript.
210: .TP
211: .OP \-R action
212: Requests special
213: .I action
214: (e.g.,
215: .MR manualfeed )
216: on a per page or global basis.
217: The
218: .I action
219: string can be given as
220: .IR request ,
221: .IM request : page\f1\|,
222: or
223: .IM request : page : file\f1\|.
224: If
225: .I page
226: is omitted or given as 0, the request
227: applies to all pages.
228: If
229: .I file
230: is omitted, the request
231: lookup is done in
232: .MR \*(dQ/ps.requests .
233: .PP
234: Only one matrix is displayed on each logical page,
235: and each of the input
236: .I files
237: must contain complete descriptions of exactly one matrix.
238: Matrix elements are floating point numbers arranged in row major order in
239: each input file.
240: White space, including newlines, is not used to determine matrix
241: dimensions.
242: By default
243: .B postmd
244: assumes each matrix is square and sets the number of rows and columns
245: to the square root of the number of elements in the input file.
246: Supplying default dimensions on the command line using the
247: .OP \-d
248: option overrides this default behavior, and in that case the
249: dimensions apply to all input
250: .IR files .
251: .PP
252: An optional header can be supplied with each input file and is used
253: to set the matrix dimensions, the partition of the real line, the gray scale
254: map, and a window into the matrix.
255: The header consists of keyword/value pairs, each on a separate line.
256: It begins on the first line of each input file and ends with the
257: first unrecognized string, which should be the first matrix element.
258: Values set in the header take precedence, but only apply to the
259: current input file.
260: Recognized header keywords are
261: .MR dimension ,
262: .MR interval ,
263: .MR grayscale ,
264: and
265: .MR window .
266: The syntax of the value string that follows each keyword parallels what is
267: accepted by the
268: .OP \-d ,
269: .OP \-i ,
270: .OP \-g ,
271: and
272: .OP \-w
273: options.
274: .SH EXAMPLES
275: For example, suppose
276: .I file
277: initially contains the 1000 numbers
278: in a 20\(mu50 matrix.
279: Then the command line:
280: .EX
281: postmd -d20x50 -i"-100 100" -g0,128,254,128,0 \f2file
282: .EE
283: and prepending the header,
284: .EX
285: dimension 20x50
286: interval -100.0 .100e+3
287: grayscale 0 128 254 128 0
288: .EE
289: to
290: .I file
291: and typing the command line:
292: .EX
293: postmd \f2file
294: .EE
295: produce exactly the same output.
296: The interval list partitions the real line into five regions and
297: the gray scale list maps numbers less than \-100 or greater than 100
298: into 0 (i.e., black), numbers equal to \-100 or 100 into 128
299: (i.e., 50 percent
300: black), and numbers between \-100 and 100 into 254 (i.e., almost white).
301: .SH DIAGNOSTICS
302: A 0 exit status is returned if
303: .I files
304: were successfully processed.
305: .SH WARNINGS
306: The largest matrix that can be adequately displayed is a function
307: of the interval and gray scale lists, the printer resolution,
308: and the paper size.
309: A 600\(mu600 matrix is an optimistic upper bound for a two element interval
310: list (i.e. five regions) using 8.5\(mu11 inch paper on a 300 dpi printer.
311: .PP
312: Using white (i.e., 255) in a gray scale list is not recommended and will not
313: show up in the legend and bar graph that
314: .B postmd
315: displays below each image.
316: .SH FILES
317: .MW \*(dQ/postmd.ps
318: .br
319: .MW \*(dQ/forms.ps
320: .br
321: .MW \*(dQ/ps.requests
322: .SH SEE ALSO
323: .BR dpost (1),
324: .BR postdaisy (1),
325: .BR postdmd (1),
326: .BR postio (1),
327: .BR postprint (1),
328: .BR postreverse (1),
329: .BR posttek (1),
330: .BR psencoding (1)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.