3-D parametric curve plotter
collapse all in page
Syntax
fplot3(funx,funy,funz)
fplot3(funx,funy,funz,tinterval)
fplot3(___,LineSpec)
fplot3(___,Name,Value)
fplot3(ax,___)
fp = fplot3(___)
Description
example
fplot3(funx,funy,funz) plotsthe parametric curve defined by x = funx(t), y= funy(t), and z = funz(t) over the defaultinterval [-5,5] for t.
example
fplot3(funx,funy,funz,tinterval) plotsover the specified interval. Specify the interval as a two-elementvector of the form [tmin tmax].
example
fplot3(___,LineSpec) setsthe line style, marker symbol, and line color. For example, '-r' specifiesa red line. Use this option after any of the previous input argumentcombinations.
fplot3(___,Name,Value) specifiesline properties using one or more name-value pair arguments. For example, 'LineWidth',2 specifiesa line width of 2 points.
fplot3(ax,___) plotsinto the axes specified by ax instead of thecurrent axes. Specify the axes as the first input argument.
example
fp = fplot3(___) returnsa ParameterizedFunctionLine object. Use the objectto query and modify properties of a specific line. For a list of properties,see ParameterizedFunctionLine Properties.
Examples
collapse all
Plot 3-D Parametric Line
Open Live Script
Plot the 3-D parametric line
over the default parameter range [-5 5].
xt = @(t) sin(t);yt = @(t) cos(t);zt = @(t) t;fplot3(xt,yt,zt)
Specify Parameter Range
Open Live Script
Plot the parametric line
over the parameter range [-10 10] by specifying the fourth input argument of fplot3.
xt = @(t) exp(-t/10).*sin(5*t);yt = @(t) exp(-t/10).*cos(5*t);zt = @(t) t;fplot3(xt,yt,zt,[-10 10])
Specify Line Properties and Display Markers
Open Live Script
Plot the same 3-D parametric curve three times over different intervals of the parameter. For the first interval, use a line width of 2 points. For the second, specify a dashed red line style with circle markers. For the third, specify a cyan, dash-dotted line style with asterisk markers.
fplot3(@(t)sin(t), @(t)cos(t), @(t)t, [0 2*pi], 'LineWidth', 2)hold onfplot3(@(t)sin(t), @(t)cos(t), @(t)t, [2*pi 4*pi], '--or')fplot3(@(t)sin(t), @(t)cos(t), @(t)t, [4*pi 6*pi], '-.*c')hold off
Plot Multiple Lines in Same Axes
Open Live Script
Plot multiple lines in the same axes using hold on.
fplot3(@(t)t, @(t)t, @(t)t)hold onfplot3(@(t)-t, @(t)t, @(t)-t)hold off
Modify 3-D Parametric Line After Creation
Open Live Script
Plot the parametric line
Assign the parameterized function line object to a variable.
xt = @(t)exp(-abs(t)/10).*sin(5*abs(t));yt = @(t)exp(-abs(t)/10).*cos(5*abs(t));zt = @(t)t;fp = fplot3(xt,yt,zt)
fp = ParameterizedFunctionLine with properties: XFunction: @(t)exp(-abs(t)/10).*sin(5*abs(t)) YFunction: @(t)exp(-abs(t)/10).*cos(5*abs(t)) ZFunction: @(t)t Color: [0 0.4470 0.7410] LineStyle: '-' LineWidth: 0.5000 Use GET to show all properties
Change the range of parameter values to [-10 10] and change the line color to red.
fp.TRange = [-10 10];fp.Color = 'r';
Add Title and Axis Labels and Format Ticks
Open Live Script
For values in the range to , plot the parametric line
Add a title, x-axis label, and y-axis label. Additionally, change the view of the axes and display the axes box outline.
xt = @(t)t;yt = @(t)t/2;zt = @(t)sin(6*t);fplot3(xt,yt,zt,[-2*pi 2*pi],'MeshDensity',30,'LineWidth',1);title('x=t, y=t/2, z=sin(6t) for -2\pi<t<2\pi')xlabel('x');ylabel('y');view(52.5,30)box on
Access the axes object using gca. Specify the x-axis tick values and associated labels using the XTick and XTickLabel properties of the axes object. Similarly, specify the y-axis tick values and associated labels.
ax = gca;ax.XTick = -2*pi:pi/2:2*pi;ax.XTickLabel = {'-2\pi','-3\pi/2','-\pi','-\pi/2','0',... '\pi/2','\pi','3\pi/2','2\pi'};ax.YTick = -pi:pi/2:pi;ax.YTickLabel = {'-\pi','-\pi/2','0','\pi/2','\pi'};
Input Arguments
collapse all
funx — Parametric function for x coordinates
function handle
Parametric function for x coordinates,specified as a function handle to a named or anonymous function.
Specify a function of the form x = funx(t).The function must accept a vector input argument and return a vectoroutput argument of the same size. Use array operators instead of matrixoperators for the best performance. For example, use .* (times)instead of * (mtimes).
Example: funx = @(t) sin(2*t);
funy — Parametric function for y coordinates
function handle
Parametric function for y coordinates,specified as a function handle to a named or anonymous function.
Specify a function of the form y = funy(t).The function must accept a vector input argument and return a vectoroutput argument of the same size. Use array operators instead of matrixoperators for the best performance. For example, use .* (times)instead of * (mtimes).
Example: funy = @(t) cos(2*t);
funz — Parametric function for z coordinates
function handle
Parametric function for z coordinates,specified as a function handle to a named or anonymous function.
Specify a function of the form z = funz(t).The function must accept a vector input argument and return a vectoroutput argument of the same size. Use array operators instead of matrixoperators for the best performance. For example, use .* (times)instead of * (mtimes).
Example: funz = @(t) t;
tinterval — Interval for parameter t
[–5 5] (default) | two-element vector of form [tmin tmax]
Interval for parameter t, specified as atwo-element vector of the form [tmin tmax].
ax — Axes object
axes object
Axes object. If you do not specify an axes object, then fplot3 usesthe current axes (gca).
LineSpec — Line style, marker, and color
string scalar | character vector
Line style, marker, and color, specified as a string scalar or character vector containing symbols. The symbols can appear in any order. You do not need to specify all three characteristics (line style, marker, and color). For example, if you omit the line style and specify the marker, then the plot shows only the marker and no line.
Example: "--or" is a red dashed line with circle markers.
| Line Style | Description | Resulting Line |
|---|---|---|
"-" | Solid line |
|
"--" | Dashed line |
|
":" | Dotted line |
|
"-." | Dash-dotted line |
|
| Marker | Description | Resulting Marker |
|---|---|---|
"o" | Circle |
|
"+" | Plus sign |
|
"*" | Asterisk |
|
"." | Point |
|
"x" | Cross |
|
"_" | Horizontal line |
|
"|" | Vertical line |
|
"square" | Square |
|
"diamond" | Diamond |
|
"^" | Upward-pointing triangle |
|
"v" | Downward-pointing triangle |
|
">" | Right-pointing triangle |
|
"<" | Left-pointing triangle |
|
"pentagram" | Pentagram |
|
"hexagram" | Hexagram |
|
| Color Name | Short Name | RGB Triplet | Appearance |
|---|---|---|---|
"red" | "r" | [1 0 0] |
|
"green" | "g" | [0 1 0] |
|
"blue" | "b" | [0 0 1] |
|
"cyan" | "c" | [0 1 1] |
|
"magenta" | "m" | [1 0 1] |
|
"yellow" | "y" | [1 1 0] |
|
"black" | "k" | [0 0 0] |
|
"white" | "w" | [1 1 1] |
|
Name-Value Arguments
Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.
Before R2021a, use commas to separate each name and value, and enclose Name in quotes.
Example: 'Marker','o','MarkerFaceColor','red'
The properties listed here are only a subset. For a completelist, see ParameterizedFunctionLine Properties.
Output Arguments
collapse all
fp — One or more ParameterizedFunctionLine objects
scalar | vector
One or more ParameterizedFunctionLine objects,returned as a scalar or a vector. You can use these objects to queryand modify properties of a specific ParameterizedFunctionLine object.For details, see ParameterizedFunctionLine Properties.
Version History
Introduced in R2016a
See Also
Functions
- fcontour | fmesh | fplot | fsurf | hold | title | fimplicit3 | fimplicit
Properties
- ParameterizedFunctionLine Properties
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- Deutsch
- English
- Français
- United Kingdom (English)
Contact your local office
