Plot and animate imat_shpand/or imat_result in 3-D space
plot(s,fem)
[h,shpout]=plot(shp,fem,res,handle,'title',titlestr,'scale',scale,options)
VTKPLOT displays the shapes supplied in the imat_shp object SHP and/or the results stored in the imat_result object RES using the supplied FEM. In general, the model's displacement is determined by the shape, and its contour by the result.
VTKPLOT expects that FEM information is an IMAT_FEM object. If node geometry is not in the global coordinate system, the coordinate system data must be present so PLOT can transform the node coordinates. The input shape coefficients are assumed to be in the FEM's displacement coordinate system(s).
By default, if a shape is present, only the deformed model will be displayed. The undeformed model can be displayed by using the 'Display' menu. The color is either determined by the result, if one was passed in, or by the displacement of the shape. The contour or shape component displayed can be changed using the 'Result' menu.
The Display menu control what is shown on the plot and how. The 'Complex Display' menu controls how complex data is displayed if the displacement shape is complex. Below this, the clipping menus allow you to set up clipping planes for the model. There are four available clipping planes: three aligned with each axis and a general one that is arbitrary. Each can be enabled using the corresponding 'Enable' menu item. To keep the result of the clipping plane, but remove the plane from view, set the 'Set Invisible' option. To flip the side of the plane that is not visible, select the 'Flip Clipping Direction' option. To further customize the view, you can use the 'Element Visibility' GUI to adjust what kinds of elements are shown on the plot. The 'Baseline Model' and 'Result Model' menus contain options for changing how nodes, elements and tracelines are formatted and can be used so set the transparency of the model.
The view menu allows you to snap the view to the difference defined planes. If the toolbar is visible, each of the view options have a corresponding toolbar icon. From this menu you can also use a 'Zoom Box' to zoom into a portion of the model, or turn on the 3D mode where red/blue 3D glasses can be used to view the model.
To export an image of the model or an animation of the mode shape, use the 'Export' menu. If you want to export all of the mode shapes using the current view, use Export->All Slides.
If displacement shapes are present, the 'Animation' menu controls the animation. Here you can set the scale of the animation, and set whether it will animate as a mode shape or animate as a transient result.
Several optional input arguments are supported:
GROUP is an IMAT_GROUP containing group information. If supplied, you will be able to display subsets of your FEM based on the elements in the group(s).
HANDLE is a figure or panel handle. If a figure handle is supplied, the shape will be displayed on the supplied figure after deleting the contents of the figure. If a panel handle is supplied, the shape will be displayed on the supplied panel after deleting the content of the panel.
OPTIONS is a string containing one of the following strings. Multiple options may be specified. See imat_shp/vtkplot for a list of valid options.
The output argument for VTKPLOT is an IMAT_VTKPLOT object. It contains all of the formatting and contents of the plot. If IDLines are modified during the plotting session, and they need to be retrieved, place the handle to the figure into uiwait, and then retrieve the modified imat_shp object once the user is done editing it.
>> vtkplot(s(1),fem)
>> h = vtkplot(s(1),fem,h,'undeformed')
>> h = vtkplot(shape,fem,h,'title','Mode Shapes','imag','scale',2.3)