PPLOT(1) USER COMMANDS PPLOT(1) NAME pplot - CIF to postcript filter SYNOPSIS pplot [ options ] input-file DESCRIPTION Pplot takes a description in CalTech Intermediate Form (CIF) and produces a plot on a PostScript printer. CIF is a low- level graphics language suitable for describing integrated circuit layouts. To get a plot call pplot with the name of the CIF file to be plotted. If the CIF description is divided among several files, you must concatenate the files into one before cal- ling pplot as it will only read one input file. After read- ing the CIF description but before plotting, pplot will print an estimate of the size of the plot and the number of (8.5 x 11.0 inch) pages required and then ask if it should continue to produce a plot, at which point it's possible to abort the plot or change the scaling factor. Type y to proceed, n to abort, and c to change the scale factor. A typical run might look as follows: % pplot mipsx.cif Scale = 0.078236 (1987x) The Plot will be 8.5 by 10.1 inches (1 pages) Do you want a plot (Yes/No/ChangeScale) [yes] ? After typing y pplot will produce a PostScript file and write it to stdout. Pplot recognizes several command line options. These can be used to change the size and scale of the plot, change default plot options, and to select the output printer. Several options may be selected. A dash(-) must precede each option specifier. The following is a list of options that may be included on the command line: -s float (scale) The -s option sets the scale of the plot. If no scale is specified the scale is set, by default, so that the plot will best fit in 1 page (rotating it, if necessary). Float is a floating point number specify- ing the number of inches which represent 1 micron. If float is followed by an `x', it will be interpreted as the magnification factor; so that the command pplot -s 100x a.cif will produce a plot of file a.cif magnfied 100 times. -l layer_list (layer) Normally all layers are plotted. The -l option specifies which layers NOT to plot (see '-' below). The layer_list consists of the layer names separated by commas, no spaces. There are some reserved names: allText, bbox, outline, text, pointName, symbolName, and `-'. Including the layer name allText in the list suppresses the plotting of any type of text. bbox suppresses the bounding box around symbols. outline suppresses the thin outline that borders each layer. The keywords text, pointName, and symbolName suppress the plotting of certain text created by local extension commands. text eliminates text created by user exten- sion 2. pointName eliminates text created by user extension 94. symbolName eliminates text created by user extension 9. Including `-' as one of the layers will reverse the meaning of the -l switch; ONLY the layers specified WILL be plotted. -C Generate color postscript. The default is black and white. -S Generate stippled color postscript. The default is black and white. (This option overrides -C.) -c n (copies) will instruct the printer to make n copies of each page. -d n (depth) This option lets you limit the amount of detail plotted in a hierarchically designed chip. It will only instanciate the plot down n levels of calls. -L n (Label-depth) Only plot labels down to n levels of calls. -I (non-Interactive) Do not ask for confirmation. Always plot. -Dformat (date) Print the date on the top side of the plot, as specified by the format string. Which should be of the form: [m][w][d][y][h]: (month, weekday, day of the month, year, hour). The order in which these items appear in the format string will determine what gets printed and in what order. If format is omitted the following default will be used: "wmdy" => "Thu 20 Feb 1986". Any other characters in the format string will cause a '*' to be printed in that position. -b "text" (banner) Print the text at the top of the plot. By default, the input filename is printed (after stripping any path components). -Pprinter Send the output to printer (by means of lpr(1) ). If no printer is specified, the PRINTER environment variable will be used. -T technolgy The -T option lets you specify what type of technology is being used, so that the appropriate pattern_file (see below) is used. The default technology is "cmos- su". -p pattern_file (Pattern) The -p option lets you specify your own layers and stipple patterns. By default, pplot will use the pattern files located in the cad directory (see CADDIR below) which are named "pat.techname.bw" for black and white postscript, "pat.techname.color" for color postscript, and "pat.techname.colstip" for stip- pled color postscript. Techname is the name of the technology (set by the `-T' switch). Pattern_file may contain up to 200 layer descriptors. A layer descriptor for a monochrome file is the layer name in double quotes, followed by 8 integers. Each integer specifies 32 bits where ones are black and zeroes are white. Thus the 8 integers specify a 32 by 8 bit stipple pattern. The integers may be in decimal, octal, or hex. Hex numbers start with '0x'; octal numbers start with '0'. The CIF syntax requires that layer names be made up of only uppercase letters and digits, and not longer than four characters. The fol- lowing is an example of a stipple pattern for some layer in a monochrome pattern file. "CPP" 0x08080808 0x04040404 0x02020202 0x01010101 0x80808080 0x40404040 0x20202020 0x10101010 A layer descriptor for a color pattern file contains a list of overlapping layer names each in double quotes followed by 3 floating point numbers from 0.0 to 1.0 specifying the rgb color to be used for regions that all the layers specified overlapped. A color of -1,- 1,-1 can be used to specify a transparent layer. "CPP",-1.0,-1.0,-1.0 "CPP","CPG",...,1.0,1.0,1.0 A layer descriptor in a pattern file for stippled colors consists of a single layer name in double quotes followed by the concatenation of a stipple description and a color description, as described above. -F font_name (Font) The -F option indicates which font you want for your text. The font must be one of the stan- dard PostScript fonts. The default font is Hel- vetica. Obviously, this option is only useful if you have text on your plot. -f float This option allows you to determine what size font should be used to display text. The default is 5.0 point. -o filename Write the PostScript output in filename, rather than writing it to stdout. -R (don't-Rotate) Generally, pplot will rotate the plot so that it best fits the page (for 8.5x11 pages, the longest side will be plotted verti- cally). This option instructs the program to plot the circuit as is, without rotation. -fp filename (PostScript file) Use filename as the PostScript prologue instead of the standard file containing the necessary function definitions. This option is mostly useful for debuging. -V device Generate postscript for the given device. Presently, the only difference between devices is the sheet size. The devices currently recognized are PS (letter size; default), PS11x17 (11 x 17), PSB (12 x 18), PSC (18 x 24), PSD (24 x 36), and PSE (36 x 48). In the definition of CIF provisions were made for local extensions. All extension commands begin with a number. The following is a list of extensions recog- nized by pplot. 9 name; (Name symbol) name is associated with the current symbol. 94 name x y; (Name point) name is associated with the point (x, y). Any mask geometry crossing this point is also associated with name. If layer is present then just geometry crossing the point on that layer is associated with name. ENVIRONMENT CADDIR Pplot tries to locate the pattern files and the postscript startup file in ~cad/lib/pplot. The default cad directory (~cad) by setting the CADDIR environment variable to whatever directory is appropriate, forcing pplot to look for the cad directory there. FILES ~cad/lib/pplot/pplot.ps PostScript header file ~cad/lib/pplot/pat.* Default pattern files. /usr/tmp/pplot#.[0-z] Temporary files. /usr/tmp/pplot#.ps Output file. SEE ALSO cadrc(5) lpr(1) hplot(1) AUTHOR Arturo Salz, Stanford University 1986. Color PostScript Support by: Bob Durie and Christos Zoulas, Cornell University 1991. Lars Svensson (svensson@isi.edu) added support for Manhattan wires and polygons, and for stippled color plots. BUGS The program only handles manhattan geometry (polygons and rotations may only be in multiples of 90 degrees). The roundflash and delete cell commands are not supported.