ListVectorPlot
ListVectorPlot[varr]
generates a vector plot from an array varr of vectors.
ListVectorPlot[{{{x1,y1},{vx1,vy1}},…}]
generates a vector plot from vectors {vxi,vyi} given at specified points {xi,yi}.
ListVectorPlot[{data1,data2,…}]
plots data for several vector fields.
Details and Options
- ListVectorPlot is also known as field plot and direction plot.
- ListVectorPlot displays a vector field by drawing arrows normalized to a fixed length. The arrows are colored by default according to the magnitude of the vector field.
- The plot visualizes the set , where is the region for which is defined.
- ListVectorPlot interpolates the data into field functions .
- For regular data, the vector field has value varr〚i,j〛 at .
- For irregular data, the vector field has value {vxi,vyi} at .
- ListVectorPlot[varr] arranges successive rows of varr up the page and successive columns across.
- ListVectorPlot by default interpolates the data given and plots vectors for the vector field at a specified grid of positions.
- ListVectorPlot has the same options as Graphics, with the following additions and changes: [List of all options]
-
AspectRatio 1 ratio of height to width ClippingStyle Automatic how to display arrows outside the vector range DataRange Automatic the range of x and y values to assume for data Frame True whether to draw a frame around the plot FrameTicks Automatic frame tick marks Method Automatic methods to use for the plot PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotLayout Automatic how to position fields PlotLegends None legends for vector fields PlotRange {Full,Full} range of x, y values to include PlotRangePadding Automatic how much to pad the range of values PlotTheme $PlotTheme overall theme for the plot RegionFunction (True&) determine what region to include RegionBoundaryStyle Automatic how to style plot region boundaries RegionFillingStyle Automatic how to style plot region interiors ScalingFunctions None how to scale individual coordinates VectorAspectRatio Automatic width to length ratio for arrows VectorColorFunction Automatic how to color arrows VectorColorFunctionScaling True whether to scale the argument to VectorColorFunction VectorMarkers Automatic shape to use for arrows VectorPoints Automatic the number or placement of arrows VectorRange Automatic range of vector lengths to show VectorScaling None how to scale the sizes of arrows VectorSizes Automatic sizes of displayed arrows VectorStyle Automatic how to draw vectors - The individual arrows are scaled to fit inside bounding circles around each point.
- With the setting VectorPoints->All, ListVectorPlot instead shows vectors associated with the particular vector field data points given.
- VectorScaling scales the magnitudes of the vectors into the range of arrow sizes smin to smax given by VectorSizes.
- VectorScaling->Automatic will scale the arrow lengths depending on the vector magnitudes:
- Possible settings for PlotLayout that show a single group of vectors in multiple plot panels include:
-
"Column" use separate group of vectors in a column of panels "Row" use separate group of vectors in a row of panels {"Column",k},{"Row",k} use k columns or rows {"Column",UpTo[k]},{"Row",UpTo[k]} use at most k columns or rows - The arrow markers given by VectorMarkers are drawn inside a box whose width and length are in the proportion specified by VectorAspectRatio.
- Common markers include:
-
"Segment" line segment aligned in the field direction "PinDart" pin dart aligned along the field "Dart" dart-shaped marker "Drop" drop-shaped marker - VectorColorFunction->None will draw the arrows with the style specified by VectorStyle.
- The arguments supplied to functions in RegionFunction and VectorColorFunction are x, y, vx, vy, Norm[{vx,vy}].
- Possible settings for ScalingFunctions are:
-
{sx,sy} scale x and y axes - Common built-in scaling functions s include:
-
"Log" log scale with automatic tick labeling "Log10" base-10 log scale with powers of 10 for ticks "SignedLog" log-like scale that includes 0 and negative numbers "Reverse" reverse the coordinate direction "Infinite" infinite scale -
AlignmentPoint Center the default point in the graphic to align with AspectRatio 1 ratio of height to width Axes False whether to draw axes AxesLabel None axes labels AxesOrigin Automatic where axes should cross AxesStyle {} style specifications for the 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 ClippingStyle Automatic how to display arrows outside the vector range ContentSelectable Automatic whether to allow contents to be selected CoordinatesToolOptions Automatic detailed behavior of the coordinates tool DataRange Automatic the range of x and y values to assume for data Epilog {} primitives rendered after the main plot FormatType TraditionalForm the default format type for text Frame True whether to draw a frame around the plot FrameLabel None frame labels FrameStyle {} style specifications for the frame FrameTicks Automatic frame tick marks FrameTicksStyle {} style specifications for frame ticks GridLines None grid lines to draw GridLinesStyle {} style specifications for grid lines ImageMargins 0. the margins to leave around the graphic ImagePadding All what extra padding to allow for labels etc. ImageSize Automatic the absolute size at which to render the graphic LabelStyle {} style specifications for labels Method Automatic methods to use for the plot PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotLabel None an overall label for the plot PlotLayout Automatic how to position fields PlotLegends None legends for vector fields PlotRange {Full,Full} range of x, y values to include PlotRangeClipping False whether to clip at the plot range PlotRangePadding Automatic how much to pad the range of values PlotRegion Automatic the final display region to be filled PlotTheme $PlotTheme overall theme for the plot PreserveImageOptions Automatic whether to preserve image options when displaying new versions of the same graphic Prolog {} primitives rendered before the main plot RegionBoundaryStyle Automatic how to style plot region boundaries RegionFillingStyle Automatic how to style plot region interiors RegionFunction (True&) determine what region to include RotateLabel True whether to rotate y labels on the frame ScalingFunctions None how to scale individual coordinates Ticks Automatic axes ticks TicksStyle {} style specifications for axes ticks VectorAspectRatio Automatic width to length ratio for arrows VectorColorFunction Automatic how to color arrows VectorColorFunctionScaling True whether to scale the argument to VectorColorFunction VectorMarkers Automatic shape to use for arrows VectorPoints Automatic the number or placement of arrows VectorRange Automatic range of vector lengths to show VectorScaling None how to scale the sizes of arrows VectorSizes Automatic sizes of displayed arrows VectorStyle Automatic how to draw vectors
List of all options
Examples
open allclose allBasic Examples (4)
Scope (16)
Sampling (6)
Plot vectors for a regular collection of vectors, and give a data range for the domain:
Plot an irregular collection of vectors:
Show all of the specified field vectors:
Explicitly set the number of vectors in each direction:
Specify a list of points for showing field vectors:
Plot a vector field with vectors placed with specified densities:
Presentation (10)
Plot a vector field with arrows scaled according to their magnitudes:
Use a single color for the arrows:
Plot a vector field with arrows of specified size:
Plot a vector field with arrows colored according to the magnitude of the field:
Set the style for multiple vector fields:
Use a named appearance to draw the vectors:
Combine the theme with a specific style for the vectors:
Show multiple vector fields in separate panels:
Options (95)
AspectRatio (3)
By default, ListVectorPlot uses the same width and height:
Use numerical value to specify the height to width ratio:
AspectRatioAutomatic determines the ratio from the plot ranges:
Axes (4)
By default, ListVectorPlot uses a frame instead of axes:
Use AxesOrigin to specify where the axes intersect:
AxesOrigin (2)
AxesStyle (4)
DataRange (1)
ImageSize (5)
Use named sizes such as Tiny, Small, Medium and Large:
Specify the width of the plot:
Specify the height of the plot:
Allow the width and height to be up to a certain size:
Specify the width and height for a graphic, padding with space if necessary:
Setting AspectRatioFull will fill the available space:
PerformanceGoal (2)
PlotLayout (3)
PlotLegends (2)
PlotRange (7)
PlotTheme (1)
Use a theme with gridlines, dark background and bold colors:
Change the VectorColorFunction:
RegionBoundaryStyle (5)
Show the region defined by a region function:
The boundaries of full rectangular regions are not shown:
Use None to not show the boundary:
Omit the interior filling as well:
RegionFillingStyle (5)
Show the region defined by a region function:
The interior of full rectangular regions are not shown:
Use None to not show the interior filling:
Omit the boundary curve as well:
RegionFunction (3)
ScalingFunctions (3)
VectorColorFunction (4)
Color the vectors according to their norms:
Use any named color gradient from ColorData:
Color the vectors according to their values:
Use VectorColorFunctionScaling->False to get unscaled values:
VectorColorFunctionScaling (4)
By default, scaled values are used:
Use VectorColorFunctionScaling->False to get unscaled values:
Use unscaled coordinates in the direction and scaled coordinates in the direction:
Explicitly specify the scaling for each color function argument:
VectorMarkers (9)
VectorPoints (8)
Use automatically determined vector points:
Show all of the specified field vectors:
Use symbolic names to specify the set of field vectors:
Create a regular grid of field vectors with the same number of arrows for and :
Create a regular grid of field vectors with a different number of arrows for and :
Specify a list of points for showing field vectors:
Use a different number of field vectors on a hexagonal grid:
The location for vectors is given in the middle of the drawn vector:
VectorRange (4)
VectorScaling (2)
Use automatically determined vector scales:
With the vector scaling function set to None, all vectors have the same size:
VectorSizes (2)
VectorStyle (7)
VectorColorFunction has precedence over VectorStyle for colors:
Use VectorColorFunctionNone to style the displayed vectors with VectorStyle:
Set the style for multiple vector fields:
Use Arrowheads to specify an explicit style of the arrowheads:
Specify both arrow tail and head:
Graphics primitives without Arrowheads are scaled based on the VectorSizes:
Change the scaling using the VectorSizes option:
Applications (3)
Properties & Relations (15)
Use VectorPlot to plot functions:
Use StreamPlot to plot streams instead of vectors:
Use ListStreamPlot to plot data with streamlines instead of vectors:
Use VectorDensityPlot to add a density plot of a scalar field:
Use StreamDensityPlot to use streams instead of vectors:
Use ListVectorDensityPlot for plotting data with a density plot of the scalar field:
Use ListStreamDensityPlot to plot streams instead of vectors:
Use ListLineIntegralConvolutionPlot to plot the line integral convolution of vector field data:
Use VectorDisplacementPlot to visualize the effect of a displacement vector field on a specified region:
Use ListVectorDisplacementPlot to visualize the effect of displacement field data on a region:
Use VectorPlot3D and StreamPlot3D to visualize 3D vector fields:
Use ListVectorPlot3D and ListStreamPlot3D to visualize 3D vector field data:
Plot vectors on surfaces with SliceVectorPlot3D:
Plot data vectors on surfaces with ListSliceVectorPlot3D:
Plot complex functions as a vector field with ComplexVectorPlot:
Plot streams instead of vectors with ComplexStreamPlot:
Use VectorDisplacementPlot3D to visualize the effect of a displacement vector field on a specified 3D region:
Use ListVectorDisplacementPlot3D to visualize the effect of a 3D displacement vector field based on data:
Use GeoVectorPlot to plot vectors on a map:
Use GeoStreamPlot to use streams instead of vectors:
Text
Wolfram Research (2008), ListVectorPlot, Wolfram Language function, https://reference.wolfram.com/language/ref/ListVectorPlot.html (updated 2022).
CMS
Wolfram Language. 2008. "ListVectorPlot." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2022. https://reference.wolfram.com/language/ref/ListVectorPlot.html.
APA
Wolfram Language. (2008). ListVectorPlot. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ListVectorPlot.html