imat_ctrace/plot


Purpose

Plot an imat_ctrace in a special figure window.

Syntax

plot(t,fem)
[hp,hl]=plot(t,fem,handle,format,sfact,color,'title',titlestr,'silent','doflabels','nodelabels')

Description

When you PLOT an imat_ctrace, the IMAT toolbox displays the imat_ctrace, t, in a figure. The finite element model must also be provided in a structure with the fields node, elem, tl, and cs, or as individual structures for nodes, elements, coordinate systems, and/or traceline. If node geometry is not in the global coordinate system, the coord inate system structure must be present so PLOT can transform the node coordinates. Several display and format options are provided, and are specified by passing in the appropriate string as an argument.

PLOT displays the FEM in a uipanel. If a figure or uipanel handle is provided as an input argument, and the handle already contains a FEM display, PLOT will display the coordinate trace in that figure/panel without plotting the supplied FEM. Otherwise, it will display the FEM and the imat_ctrace, creating a new figure if necessary. PLOT returns the uipanel handle in H.

The format string is a valid formatting string following builtin PLOT function conventions in MATLAB. The coordinate trace arrows can be scaled by passing in SFACT. SFACT is either a scalar or a vector of the same length as t. You can also change the color of the coordinate trace arrows by passing in a string containing a valid I-deas color.

Other valid display and format arguments and their descriptions are shown in the table below.

General Options  
'title' Must be followed by a string containing the figure title.
'nofem' Do not plot the FEM geometry; just plot the coordinate trace arrows.
'doflabels' Display DOF direction labels of the DOF in the supplied coordinate trace.
'nodelabels' Display node labels of the nodes in the supplied coordinate trace.
'silent' Do not print progress messages when displaying the shape.

 

Formatting only applies to the coordinate trace arrows. To modify the formatting of the FEM, first plot the undeformed geometry using imat_fem/plot, then pass in the handle returned by imat_fem/plot to PLOT. Currently rotational DOF are plotted the same way as translational DOF.

Two optional output arguments are supported. HP is the handle of the uipanel in which the plot is displayed. HL contains the handles of the lines and patches that define the arrows.

This plotting facility is intended to provide simple viewing of an imat_ctrace. Performance is slow for large models. For large models, consider using VTKPLOT.

Examples

>> plot(t,fem)
>> plot(t,fem,':','silent')
>> h=plot(fem);
>> [hp,hl]=plot(t,fem,h,'nofem','*-.','title','This is the title')

See Also

imat_fem/plot, imat_shp/plot, imat_ctrace/vtkplot