📄 foo
字号:
<HTML><BODY><PRE></PRE><H2>NAME</H2><PRE> plot3d - interactive 3-d plots (perspective plots with hid- den lines removed) of data from FEA files.</PRE><H2>SYNOPSIS</H2><PRE> <STRONG>plot3d</STRONG> [ <STRONG>-d</STRONG> <EM>depth</EM> ] [ <STRONG>-f</STRONG> <STRONG>"</STRONG><EM>field</EM><STRONG>[</STRONG><EM>range</EM><STRONG>]"</STRONG> ] [ <STRONG>-o</STRONG> <EM>orientation</EM> ] [ <STRONG>-r</STRONG> <EM>range</EM> ] [ <STRONG>-x</STRONG> <EM>debug</EM>_<EM>level</EM> ] [ <STRONG>-B</STRONG> <EM>length</EM><STRONG>,</STRONG><EM>width</EM><STRONG>,</STRONG><EM>height</EM> ] [ <STRONG>-</STRONG> <STRONG>I</STRONG> {<STRONG>aAbBcCpP</STRONG>} . . . ] [ <STRONG>-</STRONG> <STRONG>P</STRONG> <EM>param</EM> ] [ <STRONG>-</STRONG> <STRONG>R</STRONG> <EM>bearing</EM><STRONG>,</STRONG><EM>elevation</EM><STRONG>,</STRONG><EM>rotation</EM> ] [ <STRONG>-S</STRONG> <EM>h</EM>_<EM>skew</EM><STRONG>:</STRONG><EM>v</EM>_<EM>skew</EM> ] [ <STRONG>-w</STRONG> ] [ <STRONG>-</STRONG> <STRONG>M</STRONG> ] <EM>file</EM></PRE><H2>DESCRIPTION</H2><PRE> <EM>plot3d</EM> reads data from a specified field of an ESPS FEA file and constructs a three-dimensional plot of the data versus two independent variables. A plot of data from the <EM>re</EM>_<EM>spec</EM>_<EM>val</EM> field of a FEA_SPEC file, for example, could show time along one axis, frequency along another axis, and spectral power density (or its log) along the third axis. In general, the <EM>x</EM>-axis corresponds to the order of records in the file, the <EM>y</EM>-axis corresponds to the order of elements in the field, and the <EM>z</EM>-axis represents the data values. The three-dimensional plot is rendered in a window on the screen as a perspective drawing. The user has complete control over the scaling, orientation, depth of perspective, and angle of view of the plot. These plotting parameters are set initially by command-line options or values in an ESPS parameter file, but they can be adjusted interactively with mouse-operated sliders and other controls in a control-panel window, or with mouse movements in the plot window. Operating the controls causes a wire- frame drawing of the bounding box of the plot to move and change size accordingly, and clicking on a button in the control-panel window causes the plot to be redrawn with the new parameters. The current set of parameters can be saved to a file so that other plots may later be drawn with the same viewpoint. Saved parameter sets may be loaded from a file at any time. Data may be loaded from a file interactively; the file name, range of records to be read, field name, and range of items in the field may all be respecified. A moving cursor, controlled by the mouse, allows the coordi- nates of points of the graph to be read off numerically. In addition to the display on the user's screen; the plot image may be saved in a file, so that it can be printed or imported into a word processing system. The plot image can be saved as either PostScript or PCL. It can be directly sent to a printer, if there is no need to save the image file.</PRE><H2>OPTIONS</H2><PRE> The following options are supported. Values in brackets are defaults. <STRONG>-d</STRONG> <EM>depth</EM> [50] Depth of perspective. A value of 0 corresponds to pro- jection of the 3-dimensional plot onto the 2- dimensional plotting surface from an infinite distancei.e. parallel projection. Positive values of <EM>depth</EM> correspond to projection from inversely propor- tional finite distances with the result that foreground features are shown at a somewhat larger scale than features farther from the viewer. The default value of 50 is reasonable for normal viewing distances. Large values produce highly exaggerated perspective effects. <STRONG>-f</STRONG> <STRONG>"</STRONG><EM>field</EM><STRONG>[</STRONG><EM>range</EM><STRONG>]"</STRONG> ["re_spec_val[0:<<EM>last</EM>>]"] <STRONG>-f</STRONG> <EM>field</EM> Name of a field in an ESPS FEA file and range of ele- ments in field to be plotted. (Numbering of field ele- ments starts with 0.) The quotes are needed only to suppress the shell's usual special interpretation of brackets. The bracketed <EM>range</EM>, if present, may have any of the forms acceptable to <STRONG><A HREF="../man3.html/range_switch.3.html">range_switch(3-ESPSu)</A></STRONG>. <EM>element</EM> A single integer specifies a single field element (not at present useful with <EM>plot3d</EM>). <EM>first</EM><STRONG>:</STRONG><EM>last</EM> A pair of integers specifies an inclusive range of elements. <EM>first</EM><STRONG>:+</STRONG><EM>incr</EM> The form with the plus sign is equivalent to <EM>first</EM><STRONG>:</STRONG><EM>last</EM> with <EM>last</EM> = <EM>first</EM> + <EM>incr</EM>. If the specified range contains elements not present in the field, the range is reduced as necessary. <STRONG>-o</STRONG> <EM>orientation</EM> [L] Left-handed coordinate system ("L") or right-handed ("R")? When the axes are in their default initial position, record number increases with distance from the viewer, element number increases from left to right, and data values increase in the upward direc- tion. For some possible positions, a mirror-reflected orientation may seem more natural. Specifying <EM>R</EM> instead of <EM>L</EM> effectively reverses the direction of the <EM>y</EM> (element number) axis. <STRONG>-r</STRONG> <EM>range</EM> [1:<<EM>end</EM> <EM>of</EM> <EM>file</EM>>] Range of records in the file to be read and plotted (counting the first as number 1.) The allowable forms for <EM>range</EM> are those for <STRONG><A HREF="../man3.html/range_switch.3.html">range_switch(3-ESPSu)</A></STRONG>; see the discussion of <STRONG>-</STRONG> <STRONG>f</STRONG> above or the <EM>range</EM>_<EM>switch</EM> manual entry. <STRONG>-x</STRONG> <EM>debug</EM>_<EM>level</EM> [0] Values greater than 0 cause various debugging messages to be printed as the program runs. Larger values call out more messages. The default level of 0 suppresses all debugging messages. <STRONG>-B</STRONG> <EM>length</EM><STRONG>,</STRONG><EM>width</EM><STRONG>,</STRONG><EM>height</EM> [400,250,150] Dimensions, in pixels, of a rectangular box that bounds the 3-d plot (except for axis labels and the like). <STRONG>-I</STRONG> {<STRONG>aAbBcCpP</STRONG>} . . . [abcp] Initial actions, taken when the plot window is first brought up. Draw axes (a, A), draw bounding box (b, B), bring up control panel (c, C), or plot data (p, P). A lower-case letters (a, b, c, p) invokes the action, and upper-case (A, B, C, P) suppresses it. <STRONG>-P</STRONG> <EM>param</EM>_<EM>file</EM> [params] Name of parameter file to be read initially. <STRONG>-R</STRONG> <EM>bearing</EM><STRONG>,</STRONG><EM>elevation</EM><STRONG>,</STRONG><EM>rotation</EM> [45.00,35.26,0.00] Three angles of rotation (measured in degrees) that describe the relative positions of the 3-dimensional plot and the 2-dimensional plotting window. The <EM>bear-</EM> <EM>ing</EM> and <EM>elevation</EM> determine the direction, relative to the 3-d coordinate system, of the line normal to the window at its center. Changing the bearing lets you look at the plot from various sides, and increasing the elevation lets you look at it from the top. The third degree of freedom, ``<EM>rotation</EM>,'' corresponds to a rota- tion about the line normal to the window at its center and for most purposes is probably best set equal to 0. <STRONG>-S</STRONG> <EM>h</EM>_<EM>skew</EM><STRONG>:</STRONG><EM>v</EM>_<EM>skew</EM> [0,0] Changing <EM>h</EM>_<EM>skew</EM> moves the front parts of the plot one way horizontally and the back parts of the plot the opposite way, in proportion to the distance forward or back with respect to the plane of the plot window. The effect is somewhat similar to adjusting <EM>bearing</EM> ( <STRONG>-</STRONG> <STRONG>R</STRONG> above) in that both adjustments let you see more or less of the left or right side of the plot. However, adjusting <EM>h</EM>_<EM>skew</EM> does not produce a rotation: planes parallel to the plane of the plot window remain so. Similarly, changing <EM>v</EM>_<EM>skew</EM> moves the front parts of the plot one way vertically and the back part of the plot the opposite way. The effect is somewhat similar to adjusting <EM>elevation</EM> in that both adjustments let you see more or less of the top of the plot. However, adjusting <EM>v</EM>_<EM>skew</EM> does not produce a rotation of planes parallel to the plot window. <STRONG>-w</STRONG> This option causes <EM>plot3d</EM> to attempt to connect to an <STRONG><A HREF="../man1.html/xwaves%2B.1.html">xwaves+(1 - ESPS)</A></STRONG> running with its server mode enabled. If this connection is made, then <EM>plot3d</EM> will send cur- sor movement commands to <EM>xwaves</EM>+ to maintain cursor time alignment between the view in <EM>plot3d</EM> and the view in <EM>xwaves</EM>+. Note that <EM>plot3d</EM> has no way of knowing if the files being viewed in <EM>plot3d</EM> and <EM>xwaves</EM>+ are related and if the time alignment makes sense. A side effect of invoking this mode is to put the axis into time and frequency display mode. If the information in the displayed file cannot support this mode then the <STRONG>-w</STRONG> option is ignored. For example, if the displayed file has no <EM>record</EM>_<EM>freq</EM> generic then then it cannot send time cursor movements to <EM>xwaves</EM>+. If the displayed file, is not a FEA_SPEC file, then it cannot send fre- quency cursor movements to <EM>xwaves</EM>+. When this option is used, the environment variable <STRONG>WAVES_HOST</STRONG> is read to determine the name of the host that is running the <EM>xwaves</EM> server. If <STRONG>WAVES_HOST</STRONG> is undefined, then the connection is attempted to an <EM>xwaves</EM>+ on the same host as <EM>plot3d</EM> is running on. The default socket port number of the attempt is determined by a ESPS wide default which is compiled in. If the environment variable <STRONG>WAVES_PORT</STRONG> is defined, then its value is used instead as the socket port. This program uses the facility of <STRONG><A HREF="../man3.html/send_xwaves.3.html">send_xwaves(3 -ESPS)</A></STRONG>. See its manual page for details. <STRONG>-M</STRONG> This option forces <EM>plot3d</EM> to paint everything in black and white (monochrome), useful if you're doing screen- dumps.</PRE><H2>ESPS PARAMETERS</H2><PRE> The parameter file is not required to be present, as there are default values for all parameters. If the file exists, the parameters below may be read. These provide an alterna- tive way of specifying quantities that can also be deter- mined by command-line options. The general rule is that if a command-line option is specified, it takes precedence; if the command-line option is not specified, then the parameter file is consulted; and if a quantity is not given either on the command line or in the parameter file, then a default is used. Eventually this program will support parameter-file entries corresponding to all command-line options except <STRONG>-</STRONG> <STRONG>x</STRONG> and <STRONG>-P</STRONG>. These parameters may also be adjusted interactively from the control panel. Current values may be saved to a file, and new values may be read from a file interactively. (See the discussion of the <EM>load</EM> <EM>params</EM> and <EM>save</EM> <EM>params</EM> items on the <EM>files</EM> button menu under "Control Panel and Menus" below. <EM>box</EM>_<EM>length</EM> - <EM>integer</EM> <EM>box</EM>_<EM>width</EM> - <EM>integer</EM> <EM>box</EM>_<EM>height</EM> - <EM>integer</EM> These correspond to the arguments <EM>length</EM>, <EM>width</EM>, and <EM>height</EM> of the <STRONG>-B</STRONG> option. <EM>depth</EM> - <EM>float</EM> This corresponds to the argument of the <STRONG>-d</STRONG> option. <EM>horizontal</EM>_<EM>skew</EM> - <EM>float</EM> <EM>vertical</EM>_<EM>skew</EM> - <EM>float</EM> These correspond to the arguments <EM>h</EM>_<EM>skew</EM> and <EM>v</EM>_<EM>skew</EM> of the <STRONG>-S</STRONG> option. <EM>orientation</EM> - <EM>string</EM> This corresponds to the argument of the <STRONG>-o</STRONG> option. <EM>bearing</EM> - <EM>float</EM>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -