ListVectorDisplacementPlot3D
ListVectorDisplacementPlot3D[{{{vx11,vy11,vz11},…,{vx1n,vy1n,vz1n}},…,{{vxm1,vym1,vzm1},…,{vxmn,vymn,vzmn}}}]
generates a displacement plot from an array of vector displacements {vxij,vyij,vzij}.
ListVectorDisplacementPlot3D[{{{x1,y1,z1},{vx1,vy1,vz1}},…,{{xn,yn,zn},{vxn,vyn,vzn}}}]
generates a displacement plot from displacements {vxi,vyi,vzi} at point {xi,yi,zi}.
ListVectorDisplacementPlot3D[{{{{vx11,vy11,vz11},s11},…,{{vx1n,vy1n,vz1n},s1n}},…,{{{vxm1,vym1,vzm1},sm1},…,{{vxmn,vymn,vzmn},smn}}]
uses the scalar values sij to color the displaced region.
ListVectorDisplacementPlot3D[{{{x1,y1,z1},{{vx1,vy1,vz1},s1}},…,{{xn,yn,zn},{{vxn,vyn,vzn},sn}}}]
uses the scalar values si at point {xi,yi,zi} to color the displaced region.
ListVectorDisplacementPlot3D[…,reg]
plots the displacement over the region reg.
Details and Options
- ListVectorDisplacementPlot3D generates a displacement plot using the vector field data over a region. By default, the size of the displacement is automatically scaled so that both small and large displacements remain visible. The displaced region is by default colored according to the magnitude of the displacement.
- If no scalar field values are given, they are taken to be the norm of the vector field.
- ListVectorDisplacementPlot3D by default interpolates the data given and plots vectors for the vector field at a regular grid of positions.
- ListVectorDisplacementPlot3D has the same options as Graphics3D, with the following additions and changes: [List of all options]
-
Axes True whether to show axes BoundaryStyle None how to draw RegionFunction boundaries BoxRatios Automatic effective 3D box ratios for simulated lighting ClippingStyle Automatic how to display arrows outside the vector range ColorFunction Automatic how to color background densities ColorFunctionScaling True whether to scale arguments to ColorFunction DataRange Automatic - the range of x, y and z values to assume for data
Mesh None how many mesh lines to draw in the background MeshFunctions {#5&} how to determine the placement of mesh lines MeshStyle Automatic the style of mesh lines Method Automatic methods to use for the plot PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotLegends None legends for color gradients PlotRange {Full,Full} - range of x, y, z values to include
PlotRangePadding Automatic how much to pad the range of values PlotStyle Automatic how to style the deformed region PlotTheme $PlotTheme overall theme for the plot RegionBoundaryStyle Automatic how to style plot region boundaries RegionFunction (True&) determine what region to include VectorColorFunction Automatic how to color vectors VectorColorFunctionScaling True whether to scale the arguments to VectorColorFunction VectorMarkers Automatic shape to use for vectors VectorPoints None the number or placement of vectors to plot VectorRange Automatic range of vector lengths to show VectorScaling Automatic how to scale the sizes of arrows VectorSizes Automatic sizes of displayed arrows VectorStyle Automatic how to draw vectors - The arguments supplied to functions in MeshFunctions, RegionFunction, ColorFunction and VectorColorFunction are x, y, z, vx, vy, vz, s.
- The default setting MeshFunctions{#7&} draws mesh lines for the scalar field s.
- By default, the displacement plot shows a representation of the original region and the displaced region.
- RegionBoundaryStyle and RegionFillingStyle can be used to change the style of the original region.
- Additional settings for VectorPoints to show displacement arrows include:
-
Automatic automatically chosen points All use the original data points "Boundary" points along the boundary of reg - By default, displacement arrows connect locations in the original region with the corresponding displaced locations.
- VectorSizesFull shows the full displacement rather than a scaled representation.
-
AlignmentPoint Center the default point in the graphic to align with AspectRatio Automatic ratio of height to width Axes True whether to show axes Axes False whether to draw axes AxesEdge Automatic on which edges to put axes AxesLabel None axes labels AxesOrigin Automatic where axes should cross AxesStyle {} graphics directives to specify the style for axes Background None background color for the plot BaselinePosition Automatic how to align with a surrounding text baseline BaseStyle {} base style specifications for the graphic BoundaryStyle None how to draw RegionFunction boundaries Boxed True whether to draw the bounding box BoxRatios Automatic effective 3D box ratios for simulated lighting BoxStyle {} style specifications for the box ClippingStyle Automatic how to display arrows outside the vector range ClipPlanes None clipping planes ClipPlanesStyle Automatic style specifications for clipping planes ColorFunction Automatic how to color background densities ColorFunctionScaling True whether to scale arguments to ColorFunction ContentSelectable Automatic whether to allow contents to be selected ControllerLinking False when to link to external rotation controllers ControllerPath Automatic what external controllers to try to use DataRange Automatic - the range of x, y and z values to assume for data
Epilog {} 2D graphics primitives to be rendered after the main plot FaceGrids None grid lines to draw on the bounding box FaceGridsStyle {} style specifications for face grids FormatType TraditionalForm default format type for text ImageMargins 0. the margins to leave around the graphic ImagePadding All what extra padding to allow for labels, etc. ImageSize Automatic absolute size at which to render the graphic LabelStyle {} style specifications for labels Lighting Automatic simulated light sources to use Mesh None how many mesh lines to draw in the background MeshFunctions {#5&} how to determine the placement of mesh lines MeshStyle Automatic the style of mesh lines Method Automatic methods to use for the plot PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotLabel None a label for the plot PlotLegends None legends for color gradients PlotRange {Full,Full} - range of x, y, z values to include
PlotRangePadding Automatic how much to pad the range of values PlotRegion Automatic final display region to be filled PlotStyle Automatic how to style the deformed region PlotTheme $PlotTheme overall theme for the plot PreserveImageOptions Automatic whether to preserve image options when displaying new versions of the same graphic Prolog {} 2D graphics primitives to be rendered before the main plot RegionBoundaryStyle Automatic how to style plot region boundaries RegionFunction (True&) determine what region to include RotationAction "Fit" how to render after interactive rotation SphericalRegion Automatic whether to make the circumscribing sphere fit in the final display area Ticks Automatic specification for ticks TicksStyle {} style specification for ticks TouchscreenAutoZoom False - whether to zoom to fullscreen when activated on a touchscreen
VectorColorFunction Automatic how to color vectors VectorColorFunctionScaling True whether to scale the arguments to VectorColorFunction VectorMarkers Automatic shape to use for vectors VectorPoints None the number or placement of vectors to plot VectorRange Automatic range of vector lengths to show VectorScaling Automatic how to scale the sizes of arrows VectorSizes Automatic sizes of displayed arrows VectorStyle Automatic how to draw vectors ViewAngle Automatic angle of the field of view ViewCenter Automatic point to display at the center ViewMatrix Automatic explicit transformation matrix ViewPoint {1.3,-2.4,2.} viewing position ViewProjection Automatic projection method for rendering objects distant from the viewer ViewRange All range of viewing distances to include ViewVector Automatic position and direction of a simulated camera ViewVertical {0,0,1} direction to make vertical
List of all options
Examples
open allclose allBasic Examples (4)
Scope (15)
Sampling (8)
Visualize a scaled displacement field by comparing a reference and a deformed region:
Specify the coordinates and the vector field:
Specify the coordinates, the vector field and a scalar field:
Generate random points in a vector field:
By default, the reference region is the convex hull of the coordinates:
Vectors are drawn from points in the reference region to corresponding points in the (scaled) deformed region:
Restrict vectors to points on the boundary:
Displacements can be drawn to scale:
Specify the region with a RegionFunction:
The domain may be an ImplicitRegion:
The domain may be a ParametricRegion:
The domain may be a MeshRegion:
The domain may be a BoundaryMeshRegion:
Presentation (7)
Specify the ColorFunction for the deformed region:
Specify the VectorColorFunction independently of the ColorFunction:
Use a single color for the arrows:
Include a legend for the norms of the displacements:
Include a legend for the optional scalar field:
Include a Mesh:
Options (31)
BoxRatios (1)
By default, the aspect ratio is Automatic:
BoundaryStyle (1)
By default, the boundary style matches the interior colors in the deformed region:
Specify the BoundaryStyle:
BoundaryStyle applies to regions cut by RegionFunction:
ColorFunction (4)
By default, the deformed region is colored by the norm of the field:
Specify a scalar field for the colors:
Specify a custom ColorFunction:
ColorFunctionScaling (2)
Use the natural range of norm values:
Control the scaling of the individual arguments of the ColorFunction:
DataRange (1)
Mesh (1)
Specify a Mesh to visualize the displacements:
Show the initial and final sampling mesh:
Specify 10 mesh lines in the direction, 5 in the direction and 3 in the direction:
Use mesh lines at specific values:
Highlight specific mesh lines:
Mesh lines are suppressed in the reference region if the boundary and filling of the reference region are removed:
MeshFunctions (1)
PlotLegends (3)
PlotRange (1)
The full PlotRange is used by default:
Specify an explicit limit that is shared by the , and directions:
PlotStyle (1)
Remove the filling for the deformed region:
Apply a Texture to the deformed region:
ColorFunction has precedence over PlotStyle:
RegionBoundaryStyle (1)
RegionFillingStyle (1)
RegionFunction (1)
Use a RegionFunction to specify the reference region:
VectorAspectRatio (1)
VectorColorFunction (1)
By default, if VectorColorFunction is Automatic, then the VectorColorFunction matches the ColorFunction:
Specify a VectorColorFunction that is different from the ColorFunction:
Use no VectorColorFunction:
VectorMarkers (1)
VectorPoints (2)
No vectors are shown by default:
Show vectors sampled from the entire original region:
Sample vectors from the boundary of the region:
Use symbolic names to specify the density of vectors:
Use symbolic names to specify the arrangement of vectors:
Specify the number of vectors in the , and directions:
Specify a different number of vectors in the , and directions:
VectorScaling (1)
VectorSizes (1)
By default, vectors extend from points in the reference region to corresponding points in the deformed region:
Suppress scaling of the displacement vectors so that a rotation of 45° looks appropriate:
Specify the displacement size relative to the default scaled displacement:
Suppress scaling of the displacement vectors even if no vectors are displayed:
VectorStyle (1)
VectorColorFunction has precedence over VectorStyle:
Applications (14)
Basic Applications (13)
A constant displacement field moves each point in the reference region by the same amount:
Note that the displacements are automatically scaled so that very small and very large displacements are both visible:
Use VectorSizesFull to display the actual sizes of displacements:
Color is used to indicate the magnitude of the displacements:
Color the region by a different scalar function:
Use arrows to indicate initial and final locations for a sample points:
Visualize a dilation in the direction:
Visualize a contraction in the direction:
Visualize dilations in the and directions and a contraction in the direction:
Visualize a shear in the direction applied to the faces :
Solid Mechanics (1)
The face of the displayed region is fixed (no displacement) and a uniform load of 10 kPa is applied to the face in the positive direction:
Obtain data from a numerical solver of the form {location vector, displacement vector} assuming that the region is linearly elastic:
Visualize the deformed region. Since the displacements are exaggerated in the plot, use a legend to indicate the actual sizes of the displacements:
Properties & Relations (8)
Use ListVectorPlot for plotting data:
Use StreamPlot to plot with streamlines instead of vectors:
Use VectorDensityPlot to add a density plot of the scalar field:
Use ListVectorDensityPlot for plotting data with a density plot of the scalar field:
Use LineIntegralConvolutionPlot to plot the line integral convolution of a vector field:
Use VectorPlot3D and StreamPlot3D to visualize 3D vector fields:
Plot vectors on surfaces with SliceVectorPlot3D:
Text
Wolfram Research (2021), ListVectorDisplacementPlot3D, Wolfram Language function, https://reference.wolfram.com/language/ref/ListVectorDisplacementPlot3D.html.
CMS
Wolfram Language. 2021. "ListVectorDisplacementPlot3D." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/ListVectorDisplacementPlot3D.html.
APA
Wolfram Language. (2021). ListVectorDisplacementPlot3D. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ListVectorDisplacementPlot3D.html