ListLinePlot3D
ListLinePlot3D[{{x1,y1,z1},{x2,y2,z2},…,{xn,yn,zn}}]
plots a curve through the 3D points {xi,yi,zi}.
ListLinePlot3D[{{z11,z12,…,z1n},…,{zm1,zm2,…,zmn}}]
plots each row {zi1,zi2,…,zin} as a curve in the direction, with successive curves stacked in the direction.
ListLinePlot3D[{data1,data2,…}]
plots curves through multiple sets of {x,y,z} points.
Details and Options
- ListLinePlot3D is also known as 3D line graph, or 3D area graph when the area under the curve is filled. When showing each row of the data as a separate curve, ListLinePlot3D is also known as a ridgeline plot.
- ListLinePlot3D allows you to draw curves in 3D through a given set of points.
- Data values xi, yi and zi can be given in the following forms:
-
xi a real-valued number Quantity[xi,unit] a quantity with a unit Around[xi,ei] value xi with uncertainty ei Interval[{xmin,xmax}] values between xmin and xmax - Values xi, yi and zi that are not of the preceding form are taken to be missing and are not shown.
- The datai have the following forms and interpretations:
-
<"k1"{x1,y1,z1},"k2"{x2,y2,z2},… > values {{x1,y1,z1},{x2,y2,z2},…} {{x1,y1,z1}"lbl1",{x2,y2,z2}"lbl2",…}, data{"lbl1","lbl2",…} values {{x1,y1,z1},{x2,y2,z2},…} with labels {lbl1,lbl2,…} SparseArray values as a normal array QuantityArray magnitudes WeightedData unweighted values - The following wrappers w can be used for the datai:
-
Annotation[datai,label] provide an annotation for the data Button[datai,action] define an action to execute when the data is clicked Callout[datai,label] label the data with a callout Callout[datai,label,pos] place the callout at relative position pos EventHandler[datai,…] define a general event handler for the data Hyperlink[datai,uri] make the data a hyperlink Labeled[datai,label] label the data Labeled[datai,label,pos] place the label at relative position pos Legended[datai,label] identify the data in a legend PopupWindow[datai,cont] attach a popup window to the data StatusArea[datai,label] display in the status area on mouseover Style[datai,styles] show the data using the specified styles Tooltip[datai,label] attach a tooltip to the data Tooltip[datai] use data values as tooltips - Wrappers w can be applied at multiple levels:
-
{{…,w[zi,j],…}} wrap the value zi,j in array data {…,w[{xi,yi,zi}],…} wrap the point {xi,yi,zi} w[datai] wrap the data w[{data1,…}] wrap a collection of datai w1[w2[…]] use nested wrappers - ListLinePlot3D takes the same options as Graphics3D with the following additions and changes: [List of all options]
-
Axes True whether to draw axes BoxRatios {1,1,0.4} bounding 3D box ratios ColorFunction Automatic how to determine the color of points ColorFunctionScaling True whether to scale arguments to ColorFunction DataRange Automatic the range of x and y values to assume for data Filling None how to fill in stems for each point FillingStyle Automatic style to use for filling IntervalMarkers Automatic how to render uncertainty IntervalMarkersStyle Automatic style for uncertainty elements Joined True whether to join the points LabelingFunction Automatic how to label points LabelingSize Automatic size to use for callout and label Mesh None how many mesh points to draw on each line MeshFunctions {#1&} how to determine the placement of mesh points MeshShading None how to shade regions between mesh points MeshStyle Automatic the style for mesh points PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotLabels None labels to use for curves PlotLegends None legends for points PlotMarkers None markers to use for points PlotRange {Full,Full,Automatic} the range of z or other values to include PlotRangePadding Automatic how much to pad the range of values PlotStyle Automatic styles of points PlotTheme $PlotTheme overall theme for the plot RegionFunction (True&) how to determine whether a point should be included RegionBoundaryStyle style to use for a region ScalingFunctions None how to scale individual coordinates - ListLinePlot3D[{{z11,z12,…},…}] by default takes the x and y coordinate values for each data point to be successive integers starting at 1.
- The setting DataRange->{{xmin,xmax},{ymin,ymax}} specifies other ranges of coordinate values to use.
- With the default setting DataRange->Automatic, ListLinePlot3D[{{z11,z12,z13},…,{zn1,zn2,zn3}}] will assume that the data being given is {{x1,y1,z1},…}, rather than an ×3 array of heights.
- ListLinePlot3D[data,DataRange->All] always takes data to represent an array of heights.
- Possible settings for PlotMarkers include:
-
None omit markers when drawing surfaces "Point" use 2D points as markers "Sphere" use 3D spheres as markers {"Point",s},{"Sphere",s} specify the size s of the markers {spec1,spec2,…} use specification speci for expression expri - The marker size s can be a symbolic value such as Tiny, Small, Medium and Large or a scaled fraction of the width of the graphic.
- Possible settings for IntervalMarkers include:
-
"Bars" draw bars to represent errors "Tubes" draw tubes to represent errors - Possible settings for ScalingFunctions include:
-
sz scale the z axis {sx,sy} scale x and y axes {sx,sy,sz} scale x, y and z axes - Each scaling function si is either a string "scale" or {g,g-1}, where g-1 is the inverse of g.
- The arguments supplied to functions in MeshFunctions and RegionFunction are , and . Functions in ColorFunction are by default supplied with scaled versions of these arguments.
-
AlignmentPoint Center the default point in the graphic to align with AspectRatio Automatic ratio of height to width Axes True 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 Boxed True whether to draw the bounding box BoxRatios {1,1,0.4} bounding 3D box ratios BoxStyle {} style specifications for the box ClipPlanes None clipping planes ClipPlanesStyle Automatic style specifications for clipping planes ColorFunction Automatic how to determine the color of points 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 and y 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 Filling None how to fill in stems for each point FillingStyle Automatic style to use for filling 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 IntervalMarkers Automatic how to render uncertainty IntervalMarkersStyle Automatic style for uncertainty elements Joined True whether to join the points LabelingFunction Automatic how to label points LabelingSize Automatic size to use for callout and label LabelStyle {} style specifications for labels Lighting Automatic simulated light sources to use Mesh None how many mesh points to draw on each line MeshFunctions {#1&} how to determine the placement of mesh points MeshShading None how to shade regions between mesh points MeshStyle Automatic the style for mesh points Method Automatic details of 3D graphics methods to use PerformanceGoal $PerformanceGoal aspects of performance to try to optimize PlotLabel None a label for the plot PlotLabels None labels to use for curves PlotLegends None legends for points PlotMarkers None markers to use for points PlotRange {Full,Full,Automatic} the range of z or other values to include PlotRangePadding Automatic how much to pad the range of values PlotRegion Automatic final display region to be filled PlotStyle Automatic styles of points 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 style to use for a region RegionFunction (True&) how to determine whether a point should be included RotationAction "Fit" how to render after interactive rotation ScalingFunctions None how to scale individual coordinates 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
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 (5)
Scope (35)
General Data (7)
For regular data consisting of values, the and data ranges are taken to be integer values:
Provide explicit and data ranges by using DataRange:
For irregular data consisting of triples, the and data ranges are inferred from the data:
Plot multiple sets of irregular data:
Areas around where the data is nonreal are excluded:
PlotRange is selected automatically:
Use PlotRange to focus in on areas of interest:
Use RegionFunction to restrict lines to a region given by inequalities:
Special Data (6)
Use Quantity to include units with the data:
Plot data in a QuantityArray:
Specify the units used with TargetUnits:
Plot data from time series with automatic date ticks:
Specify strings to use as labels:
Plot data in a SparseArray:
Data Wrappers (6)
Use a wrapper to style a specific curve:
Apply a style to all the curves:
Use the value of each point as a tooltip:
Use a specific label for all the points:
Label points with automatically positioned text:
Use PopupWindow to provide additional drilldown information:
Button can be used to trigger any action:
Labeling and Legending (6)
Label points with automatically positioned text:
Specify that labels should be above or below the curve:
Specify label names with LabelingFunction:
Include legends for each point collection:
Specify the maximum size of labels:
For dense sets of points, some labels may be turned into tooltips by default:
Options (68)
Axes (3)
AxesLabel (4)
AxesStyle (4)
BoxRatios (2)
ColorFunction (7)
Use a named gradient from ColorData to color curves by their height:
Color curves by scaled values:
Color curves by scaled values:
Color curves by scaled values:
Colors from ColorFunction are used with the filled regions as well as the curve:
Colors from ColorFunction have higher priority than from PlotStyle:
Colors from ColorFunction combine with non-color styles from PlotStyle:
ColorFunctionScaling (2)
DataRange (4)
Filling (3)
Fill to the bottom, using "stems":
Filling occurs along the region cut by the RegionFunction:
Fill surface 1 to the bottom with blue and surface 2 to the top with red:
ImageSize (7)
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:
Use maximum sizes for the width and height:
Use ImageSizeFull to fill the available space in an object:
Specify the image size as a fraction of the available space:
IntervalMarkers (2)
Joined (3)
PlotLegends (5)
PlotMarkers (4)
ListLinePlot normally shows just the curves:
Include the data points in the plot:
PlotRange (3)
PlotTheme (2)
RegionBoundaryStyle (3)
Applications (6)
Random Walks (3)
Optimization Paths (1)
Show the steps used by an optimization method to arrive at a minimum:
Use StepMonitor to follow the progress of FindMinimum from different starting points:
Properties & Relations (12)
Use ListPlot and ListLinePlot to plot heights in 2D:
Use ListPointPlot3D to show three-dimensional data plots:
Use ListPlot3D to create surfaces from data:
Use Plot3D to visualize functions:
Use ParametricPlot3D to plot a curve from functions:
Use ListLogPlot, ListLogLogPlot and ListLogLinearPlot for logarithmic data plots:
Use ListPolarPlot for polar plots:
Use DateListPlot to show data over time:
Use ListContourPlot to create contours from continuous data:
Use ListDensityPlot to create densities from continuous data:
Use ArrayPlot and MatrixPlot for arrays of discrete values:
Use ParametricPlot for parametric curves:
Text
Wolfram Research (2021), ListLinePlot3D, Wolfram Language function, https://reference.wolfram.com/language/ref/ListLinePlot3D.html.
CMS
Wolfram Language. 2021. "ListLinePlot3D." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/ListLinePlot3D.html.
APA
Wolfram Language. (2021). ListLinePlot3D. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ListLinePlot3D.html