Plot

The plot module provides visualization capabilities for Meshes, Selections and Fields. These functions produce Graphics objects that can be displayed with Show.

To use the module, first import it:

import plot

Plotmesh

Visualizes a Mesh object:

var g = plotmesh(mesh)

Plotmesh accepts a number of optional arguments to control what is displayed:

  • selection - Only elements in a provided Selection are drawn.

  • grade - Only draw the specified grade. This can also be a list of multiple grades to draw.

  • color - Draw the mesh in a provided Color.

  • filter and transmit - Used by the povray module to indicate transparency.

Plotmeshlabels

Draws the ids for elements in a Mesh:

var g = plotmeshlabels(mesh)

Plotmeshlabels accepts a number of optional arguments to control the output:

  • grade - Only draw the specified grade. This can also be a list of multiple grades to draw.

  • selection - Only labels in a provided Selection are drawn.

  • offset - Local offset vector for labels. Can be a List, a Matrix or a function.

  • dirn - Text direction for labels. Can be a List, a Matrix or a function.

  • vertical - Text vertical direction. Can be a List, a Matrix or a function.

  • color - Label color. Can be a Color object or a Dictionary of colors for each grade.

  • fontsize - Font size to use.

Plotselection

Visualizes a Selection object:

var g = plotselection(mesh, sel)

Plotselection accepts a number of optional arguments to control what is displayed:

  • grade - Only draw the specified grade. This can also be a list of multiple grades to draw.

  • filter and transmit - Used by the povray module to indicate transparency.

Plotfield

Visualizes a scalar Field object:

var g = plotfield(field)

Plotfield accepts a number of optional arguments to control what is displayed:

  • grade - Draw the specified grade.

  • colormap - A Colormap object to use. The field is automatically scaled.

  • scalebar - A Scalebar object to use.

  • selection - Only elements in a provided Selection are drawn.

  • style - Plot style. See below.

  • filter and transmit - Used by the povray module to indicate transparency.

  • cmin and cmax - Can be used to define the data range covered. Values beyond these limits will be colored by the lower/upper bound of the colormap accordingly.

Supported plot styles:

  • default - Color Mesh elements by the corresponding value of the Field.

  • interpolate - Interpolate Field quantities onto higher elements.

ScaleBar

Represents a scalebar for a plot:

Show(plotfield(field, scalebar=ScaleBar(posn=[1.2,0,0])))

ScaleBars can be created with many adjustable parameters:

  • nticks - Maximum number of ticks to show.

  • posn - Position to draw the ScaleBar.

  • length - Length of ScaleBar to draw.

  • dirn - Direction to draw the ScaleBar in.

  • tickdirn - Direction to draw the ticks in.

  • colormap - ColorMap to use.

  • textdirn - Direction to draw labels in.

  • textvertical - Label vertical direction.

  • fontsize - Fontsize for labels

  • textcolor - Color for labels

You can draw the ScaleBar directly by calling the draw method:

sb.draw(min, max)

where min and max are the minimum and maximum values to display on the scalebar.