PSCONTOUR

Section: Misc. Reference Manual Pages (l)
Updated: DATE
Index Return to Main Contents

#ifdef SI #define UNIT cm #define G_OPT 10 #else #define UNIT inch #define G_OPT 4 #endif

NAME

pscontour - Contour xyz-data by direct triangulation

SYNOPSIS

pscontour xyzfile -Ccptfile -Jparameters -Rwest/east/south/north[r] [ -A[ffont_size][aangle][/r/g/b][o]] ] [ -Btickinfo ] [ -D[dumpfile] ] [ -Eview_az/view_el ] [ -Fred/green/blue ] [ -Ggap ] [ -H ] [ -I ] [ -K ] [ -M[flag] ] [ -N ] [ -O ] [ -P ] [ -Tindexfile ] [ -U[/dx/dy/][label] ] [ -V ] [ -Wpen ] [ -Xx-shift ] [ -Yy-shift ] [ -ccopies ] [ -: ] [ -b[d] ]

DESCRIPTION

pscontour reads an ASCII [or binary] xyz-file and produces a raw contour plot by triangulation. By default, the optimal Delaunay triangulation is performed, but the user may optionally provide a second file with network information, such as a triangular mesh used for finite element modeling. In addition to contours, the area between contours may be painted according to the color palette file.

xyzfile: Raw xyz data to be contoured.
-C: name of the color palette file. Must have discrete colors if you want to paint the surface (-G). Only contours that have anotation flags set will be anotated. #include "explain_-j.txt" #include "explain_-R.txt"

OPTIONS

No space between the option flag and the associated arguments.

-A: Several anotation formatting options can be set to modify the form of the annotation. Append ffont_size to change font size [9], append /r/g/b to change color of text fill box [PAGE_COLOR], append aangle to fix annotation angle [Default follows contour], and append 'o' to draw the outline of the surrounding text box [Default is no outline]. #include "explain_-b.txt"
-D: Dump the (x,y,z) coordinates of each contour to separate files, one for each contour segment. The files will be named dumpfile_cont_segment[_i].xyz, where cont is the contour value and segment is a running segment number for each contour interval (for closed contours we append _i.) However, when -M is used in conjunction with -D a single multisegment file is created instead.
-E: Sets the view point by specifying azimuth and elevation in degrees. [Default is 180/90]
-F: Sets the color used for Frame and annotation. [Default is black]
-G: gap is distance in UNIT between each annotation along the same contour [Default is G_OPT]. #include "explain_-H.txt"
-I: Color the triangles using the color palette table. #include "explain_-K.txt"
-M: When used in conjunction with -D a single multisegment file is created, and each contour section is preceeded by a header record whose first column is flag followed by the contour level. -N Do NOT clip contours or image at the boundaries [Defaults will clip to fit inside region -R). #include "explain_-O.txt" #include "explain_-P.txt"
-T: Give name of file with network information. Each record must contain triplets of node numbers for a triangle [Default computes these using Delaunay triangulation (see triangulate)]. #include "explain_-U.txt" #include "explain_-V.txt"
-W: Select contouring and set contour pen attributes. #include "explain_-XY.txt" #include "explain_-c.txt" #include "explain_-t.txt"
-b: Expect binary, single precision triplets for xyz (and binary 4-byte integer triplets for node ids) rather than ASCII input. [Default is ASCII]. Append d to indicate double precision for binary data [Default is single].

EXAMPLES

To make a raw contour plot from the file topo.xyz and drawing the contours (pen = 2) given in the color palette file topo.cpt on a Lambert map at 0.5"/degree along the standard parallels 18 and 24, try

pscontour topo.xyz -R320/330/20/30 -Jl18/24/0.5 -Ctopo.cpt -W2 > topo.ps

To create a color PostScript plot of the numerical temperature solution obtained on a triangular mesh whose node coordinates and temperatures are stored in temp.xyz and mesh arrangement is given by the file mesh.ijk, using the colors in temp.cpt, try

pscontour temp.xyz -R0/150/0/100 -Jx0.1 -Ctemp.cpt -G -W1 > temp.ps

This document was created by man2html, using the manual pages.
Time: 07:11:30 GMT, January 07, 2025