3-D parametric curve plotter - MATLAB fplot3 (2024)

3-D parametric curve plotter

collapse all in page

  • 3-D parametric curve plotter - MATLAB fplot3 (1)

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

x=sin(t)y=cos(t)z=t

over the default parameter range [-5 5].

xt = @(t) sin(t);yt = @(t) cos(t);zt = @(t) t;fplot3(xt,yt,zt)

3-D parametric curve plotter - MATLAB fplot3 (2)

Specify Parameter Range

Plot the parametric line

x=e-t/10sin(5t)y=e-t/10cos(5t)z=t

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])

3-D parametric curve plotter - MATLAB fplot3 (3)

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

3-D parametric curve plotter - MATLAB fplot3 (4)

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

3-D parametric curve plotter - MATLAB fplot3 (5)

Modify 3-D Parametric Line After Creation

Open Live Script

Plot the parametric line

x=e-|t|/10sin(5|t|)y=e-|t|/10cos(5|t|)z=t.

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)

3-D parametric curve plotter - MATLAB fplot3 (6)

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';

3-D parametric curve plotter - MATLAB fplot3 (7)

Add Title and Axis Labels and Format Ticks

Open Live Script

For t values in the range -2π to 2π, plot the parametric line

x=ty=t/2z=sin(6t).

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

3-D parametric curve plotter - MATLAB fplot3 (8)

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'};

3-D parametric curve plotter - MATLAB fplot3 (9)

Input Arguments

collapse all

funxParametric 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);

funyParametric 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);

funzParametric 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;

tintervalInterval 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].

axAxes object
axes object

Axes object. If you do not specify an axes object, then fplot3 usesthe current axes (gca).

LineSpecLine 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 StyleDescriptionResulting Line
"-"Solid line

3-D parametric curve plotter - MATLAB fplot3 (10)

"--"Dashed line

3-D parametric curve plotter - MATLAB fplot3 (11)

":"Dotted line

3-D parametric curve plotter - MATLAB fplot3 (12)

"-."Dash-dotted line

3-D parametric curve plotter - MATLAB fplot3 (13)

MarkerDescriptionResulting Marker
"o"Circle

3-D parametric curve plotter - MATLAB fplot3 (14)

"+"Plus sign

3-D parametric curve plotter - MATLAB fplot3 (15)

"*"Asterisk

3-D parametric curve plotter - MATLAB fplot3 (16)

"."Point

3-D parametric curve plotter - MATLAB fplot3 (17)

"x"Cross

3-D parametric curve plotter - MATLAB fplot3 (18)

"_"Horizontal line

3-D parametric curve plotter - MATLAB fplot3 (19)

"|"Vertical line

3-D parametric curve plotter - MATLAB fplot3 (20)

"square"Square

3-D parametric curve plotter - MATLAB fplot3 (21)

"diamond"Diamond

3-D parametric curve plotter - MATLAB fplot3 (22)

"^"Upward-pointing triangle

3-D parametric curve plotter - MATLAB fplot3 (23)

"v"Downward-pointing triangle

3-D parametric curve plotter - MATLAB fplot3 (24)

">"Right-pointing triangle

3-D parametric curve plotter - MATLAB fplot3 (25)

"<"Left-pointing triangle

3-D parametric curve plotter - MATLAB fplot3 (26)

"pentagram"Pentagram

3-D parametric curve plotter - MATLAB fplot3 (27)

"hexagram"Hexagram

3-D parametric curve plotter - MATLAB fplot3 (28)

Color NameShort NameRGB TripletAppearance
"red""r"[1 0 0]

3-D parametric curve plotter - MATLAB fplot3 (29)

"green""g"[0 1 0]

3-D parametric curve plotter - MATLAB fplot3 (30)

"blue""b"[0 0 1]

3-D parametric curve plotter - MATLAB fplot3 (31)

"cyan" "c"[0 1 1]

3-D parametric curve plotter - MATLAB fplot3 (32)

"magenta""m"[1 0 1]

3-D parametric curve plotter - MATLAB fplot3 (33)

"yellow""y"[1 1 0]

3-D parametric curve plotter - MATLAB fplot3 (34)

"black""k"[0 0 0]

3-D parametric curve plotter - MATLAB fplot3 (35)

"white""w"[1 1 1]

3-D parametric curve plotter - MATLAB fplot3 (36)

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.

3-D parametric curve plotter - MATLAB fplot3 (37)

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)

Asia Pacific

  • Australia (English)
  • India (English)
  • New Zealand (English)
  • 中国
  • 日本 (日本語)
  • 한국 (한국어)

Contact your local office

3-D parametric curve plotter - MATLAB fplot3 (2024)
Top Articles
Latest Posts
Article information

Author: Nicola Considine CPA

Last Updated:

Views: 5243

Rating: 4.9 / 5 (49 voted)

Reviews: 88% of readers found this page helpful

Author information

Name: Nicola Considine CPA

Birthday: 1993-02-26

Address: 3809 Clinton Inlet, East Aleisha, UT 46318-2392

Phone: +2681424145499

Job: Government Technician

Hobby: Calligraphy, Lego building, Worldbuilding, Shooting, Bird watching, Shopping, Cooking

Introduction: My name is Nicola Considine CPA, I am a determined, witty, powerful, brainy, open, smiling, proud person who loves writing and wants to share my knowledge and understanding with you.