Graphic Display Modifiers

<< Click to Display Table of Contents >>

Navigation:  Problem Descriptor Reference > The Sections of a Descriptor > Monitors and Plots >

Graphic Display Modifiers

Previous pageReturn to chapter overviewNext page

The appearance of any display can be modified by adding one or more of the following clauses:

 

AREA_INTEGRATE                

Causes CONTOUR and SURFACE plots in cylindrical geometry to be integrated with dr*dz element, rather than default 2*pi*r*dr*dz volume element.

See also: LINE_INTEGRATE

 

AS 'string'                

Changes the label on the display from the evaluated expression to string.

 

BLACK                        

Draws current plot in black color only.

 

CONTOURS = number                        

Selects the number of contour lines for CONTOUR plots.  This is a local control equivalent to the global CONTOURS control, but applying only to a single plot.

 

DROPOUT                        

Marks EXPORT and TABLE output points which fall outside the problem domain as "external".  This modifier affects only EXPORTS and TABLES with FORMAT strings (see below).

 

EMF
EMF ( pixels )
EMF ( pixels, penwidth )

Windows version only.  Produces a Microsoft Windows Enhanced Metafile output.  

pixels is the horizontal pixel count of the reference window, which defaults to 1024 if omitted.  

penwidth is an integer (0,1,2 or 3) which specifies the width of drawn lines, in thousandths of the drawing width (0 means thin).  

The export file name is the problem name with plot number and sequence number appended.  

The file name cannot be altered.

Warning: FlexPDE uses Windows rotated fonts to plot Y-labels and axis labels on surface plots.  Microsoft Word can read and resize these pictures, but its picture editor cannot handle them, and immediately "rectifies" them to horizontal.

 

EPS

Produces an Encapsulated PostScript output.  

The graphic is a 10x7.5 inch landscape-mode format with 7200x5400 resolution.

 

EXPORT                        

Causes a disk file to be written containing the data represented by the associated MONITOR or PLOT.

A regular rectangular grid will be constructed, and the data will be printed in a format suitable for reading by the FlexPDE TABLE function.  

The dimension of the grid will be determined by the plot grid density appropriate to the type of plot.

The format of EXPORTED data may be controlled by the FORMAT modifier (see below).

(This is a renaming of the older PRINT modifier)  

 

EXPORT ( n )        

Modifies the EXPORT command by specifying the dimension of the printed data grid.  

For two- or three-dimensional plots, the grid will be (n x n) or (n x n x n).

 

EXPORT ( nx, ny )        
EXPORT ( nx, ny, nz )        

Modifies the EXPORT command by specifying the dimension of the printed data grid.

 

FIELDLINES = n        

Overrides the default number of FIELDMAP field lines and uses n instead.

 

FILE 'string'        

Overrides the default naming convention for files created by the EXPORT or PRINT modifiers, and writes the file named 'string' instead.

 

FIXED RANGE ( arg1, arg2 )        

Changes the dynamically set range used for the variable axis to a minimum value of arg1 and a maximum of arg2.  Data outside this range is not plotted.        

See also: RANGE

 

FORMAT 'string'        

This modifier replaces the default format of the EXPORT or PRINT modifiers, or of the TABLE output command.  When this modifier appears, the output will consist of one line for each point in the export grid.  

The contents of this line will be completely controlled by the format string as follows:

1.        all characters except "#" will be copied literally to the output line.

2.        "#" will be interpreted as an escape character, and various options will be selected by the character following the "#":  

a.#x, #y, #z and #t will print the value of the spatial coordinates or time of the data point;  

b.#1 through #9 will print the value of the corresponding element of the plot function list;

c.#b will write a taB character;  

d.#r will cause the remainder of the format string to be repeated for each plot function in the plot list;  

e.#i inside a repeated string will print the value of the current element of the plot function list.  

See the example problems "export_format" and "export_history".

 

FRAME ( X, Y, Wide, High )        

Forces the plot frame to the specified coordinates, regardless of the size of the problem domain.        

The plot frame will be forced to a 1:1 aspect ratio using the largest of the width and height values.

This allows the creation of consistently-sized plots in moving-mesh problems.  

See "Samples | Moving_Mesh | Piston.pde".

See also: ZOOM

 

GRAY        

Draws current plot with a 32-level gray scale instead of the default color palette.

 

INTEGRATE        

Causes a report of the integral under the plotted function.  

For CONTOUR and SURFACE plots, this is a volume integral (with Cartesian element dx*dy*1 or cylindrical element 2*pi*r*dr*dz).  

For ELEVATIONS, it is a surface integral (with Cartesian element dl*1 and cylindrical element 2*pi*r*dl).  (See also AREA_INTEGRATE, LINE_INTEGRATE).

This integral differs from a REPORT(INTEGRAL(...)) in that this command will integrate on the plot grid, while the REPORT will integrate on the computation grid.

This modifier can be globally imposed by use of PLOTINTEGRATE in the SELECT section.

 

JPEG
JPEG ( pixels )
JPEG ( pixels, penwidth )

Selects automatic creation of a graphic export file in JPEG format.  

pixels is the horizontal pixel count, which defaults to 1024 if omitted.

penwidth is an integer (0,1,2 or 3) which specifies the width of the drawn lines, in thousandths of the pixel width (0 means thin).  

The export file name is the problem name with plot number and sequence number appended.  

The file name cannot be altered.

 

LEVELS = l1, l2, l3.....

Explicitly defines the contour levels for CONTOUR plots.
 

LINE_INTEGRATE        

Causes ELEVATIONS in cylindrical geometry to be integrated with dl element, rather than default 2*pi*r*dl element.

See also: AREA_INTEGRATE

 

LOG
LINLOG
LOGLIN
LOGLOG

Changes the default linear scales used to those specified by the scaling command.  

LOG is the same as LINLOG, and specifies logarithmic scaling in the data coordinate.

 

<lx><ly><lz>        

Changes the default linear scales used to those specified by the scaling command.  

Each of <lx>, <ly> and <lz> can be either LIN or LOG, and controls the scaling in the associated dimension.

 

LOG ( number )
...combinations as above        

Limits the number of decades of data displayed to number.  

This effect can also be achieved globally by the Selector LOGLIMIT.

 

MERGE        

Sends EXPORT output for all stages or plot times to a single output file.

This is the default for TECPLOT output.

This option can be set globally by SELECT PRINTMERGE.        

 

MESH        

In SURFACE plots, causes the surface to be displayed as a hidden-line drawing of the meshed surface.  

This display is more suitable on some hardcopy devices.

 

NOHEADER        

Deletes the problem-identification header from EXPORT output.        

 

NOLINES        

Suppresses mesh lines in grid plot.        

 

NOMERGE        

Sends EXPORT output for each stage or plot time to a separate output file.  

This is the default for EXPORT output.

 

NOMINMAX        

Deletes "o" and "x" marks at min and max values on contour plot.        

 

NORM        

In VECTOR plots, causes all vectors to be drawn with the same length.  Only the color identifies different magnitudes.

 

NOTAGS        

Suppresses labelling tags on contour or elevation plot.  

This can be applied globally with SELECT NOTAGS.

 

NOTIPS        

Plots VECTORS as line segments without heads.  

The line segment will be centered on the reference point.

 

ON <control>

Selects region, surface or layer restrictions of plot domain.  See "Controlling the Plot Domain".

 

PAINTED        

Fills areas between contour lines with color. (This is slower than conventional contour lines.)

 

PAINTMATERIALS
PAINTREGIONS

Draw color-filled grid plot.  

These local flags are equivalent to and override the corresponding global flags set in the SELECT section. They affect only the current plot.

 

PENWIDTH = n

Sets the on-screen pen width for the current plot.

n is an integer (0,1,2,3,...) which specifies the width of the drawn lines, in thousandths of the plot width (0 means thin).  

See also : Global Graphics Controls.

 

PNG
PNG ( pixels )
PNG ( pixels, penwidth )

Selects automatic creation of a graphic export file in PNG format.  

pixels is the horizontal pixel count, which defaults to 1024 if omitted.

penwidth is an integer (0,1,2 or 3) which specifies the width of the drawn lines, in thousandths of the pixel width (0 means thin).  

The export file name is the problem name with plot number and sequence number appended.  

The file name cannot be altered.

 

POINTS = n
POINTS = ( nx , ny )
POINTS = ( nx, ny, nz )        

Overrides the default plot grid size and uses n instead.  

Two and three dimensional exports will use n in all dimensions.

For two-dimensional export commands, the two-dimensional grid can be explicitly controlled.

For three-dimensional exports, the three-dimensional grid can be explicitly controlled.

 

PRINT
PRINT ( n )
PRINT ( nx, ny )
PRINT ( nx, ny, nz )        

Equivalent to EXPORT, EXPORT(n), EXPORT(nx,ny) and EXPORT(nx,ny,nz), respectively.

NOTE : This modifier is deprecated and EXPORT should be used instead. It has been kept only for backward compatibility.

 

 

PRINTONLY        

Supresses graphical output.  Use with PRINT or EXPORT to create text output only.

 

RANGE ( arg1, arg2 )        

Changes the dynamically set range used for the variable axis to a minimum value of arg1 and a maximum of arg2.  

If the calculated value of the variable falls outside of the range argument, the range argument is ignored and the dynamically calculated value is used.  

See also: FIXED RANGE

 

SVG

Produces a Scaled Vector Graphics output.

 

VIEWPOINT( X, Y, angle )        

With SURFACE plots, the VIEWPOINT modifier sets the viewing azimuth and perspective distance and the viewing elevation angle.

 

VOL_INTEGRATE        

Causes CONTOURS and SURFACE plots in cylindrical geometry to be integrated with 2*pi*r*dr*dz element.  

This is the default, and is equivalent to INTEGRATE.  

See also: INTEGRATE, AREA_INTEGRATE

 

 

ZOOM ( X, Y, Wide, High )        

Expands (zooms) a selected area of the display or export, with (X,Y) defining the lower left hand corner of the area and (Wide,High) defining the extent of the expanded area.  

In 3D cut planes, the X and Y coordinates refer to the horizontal and vertical dimensions in the cut plane.

See also: FRAME        

 

ZOOM ( X, Y, Z, Xsize, Ysize, Zsize)        

Expands (zooms) a selected volume of an export, with (X,Y,Z) defining the lowest corner of the volume and (Xsize,Ysize,Zsize) defining the extent of the included volume.