plot::Circle3d

3D circles

MuPAD® notebooks will be removed in a future release. Use MATLAB® live scripts instead.

MATLAB live scripts support most MuPAD functionality, though there are some differences. For more information, see Convert MuPAD Notebooks to MATLAB Live Scripts.

Syntax

plot::Circle3d(r, [x, y, z], <[nx, ny, nz]>, <a = amin .. amax>, options)

Description

plot::Circle3d(r, [x, y, z], [nx, ny, nz]) creates a circle in 3D with the radius r, center (x, y, z), and normal vector (nx, ny, nz).

The attribute LineColor or, equivalently, Color serves for setting the line color.

Use the attribute Filled = TRUE to create circular discs.

Attributes

AttributePurposeDefault Value
AffectViewingBoxinfluence of objects on the ViewingBox of a sceneTRUE
Centercenter of objects, rotation center[0, 0, 0]
CenterXcenter of objects, rotation center, x-component0
CenterYcenter of objects, rotation center, y-component0
CenterZcenter of objects, rotation center, z-component0
Colorthe main colorRGB::Blue
Filledfilled or transparent areas and surfacesFALSE
FillColorcolor of areas and surfacesRGB::LightBlue
Framesthe number of frames in an animation50
Legendmakes a legend entry 
LegendTextshort explanatory text for legend 
LegendEntryadd this object to the legend?FALSE
LineColorcolor of linesRGB::Blue
LineWidthwidth of lines0.35
LineStylesolid, dashed or dotted lines?Solid
LinesVisiblevisibility of linesTRUE
LineColorDirectionthe direction of color transitions on lines[0, 0, 1]
LineColorDirectionXx-component of the direction of color transitions on lines0
LineColorDirectionYy-component of the direction of color transitions on lines0
LineColorDirectionZz-component of the direction of color transitions on lines1
Namethe name of a plot object (for browser and legend) 
Normalnormal vector of circles and discs, etc. in 3D[0, 0, 1]
NormalXnormal vector of circles and discs, etc. in 3D, x-component0
NormalYnormal vector of circles and discs, etc. in 3D, y-component0
NormalZnormal vector of circles and discs, etc. in 3D, z-component1
ParameterEndend value of the animation parameter 
ParameterNamename of the animation parameter 
ParameterBegininitial value of the animation parameter 
ParameterRangerange of the animation parameter 
Radiusradius of circles, spheres etc.1
TimeEndend time of the animation10.0
TimeBeginstart time of the animation0.0
TimeRangethe real time span of an animation0.0 .. 10.0
Titleobject title 
TitleFontfont of object titles[" sans-serif ", 11]
TitlePositionposition of object titles 
TitleAlignmenthorizontal alignment of titles w.r.t. their coordinatesCenter
TitlePositionXposition of object titles, x component 
TitlePositionYposition of object titles, y component 
TitlePositionZposition of object titles, z component 
VisiblevisibilityTRUE
VisibleAfterobject visible after this time value 
VisibleBeforeobject visible until this time value 
VisibleFromToobject visible during this time range 
VisibleAfterEndobject visible after its animation time ended?TRUE
VisibleBeforeBeginobject visible before its animation time starts?TRUE

Examples

Example 1

Create the following circle in 3D and animate its normal vector:

normal_ := plot::Arrow3d(
      [0, 0, 0], 
      [sin(2*a), sin(a)*cos(2*a), cos(a)*cos(2*a)],
      a = 0..2*PI):
circle := plot::Circle3d(1, [0, 0, 0], normal_::To,
                         a = 0..2*PI, Filled):
plot(normal_, circle)

Parameters

r

The radius: a real numerical value or an arithmetical expression in the animation parameter a.

r is equivalent to the attribute Radius.

x, y, z

The center. The coordinates x, y, z must be real numerical values or arithmetical expressions in the animation parameter a. If no center is specified, a circle centered at the origin is created.

x, y, z are equivalent to the attributes CenterX, CenterY, CenterZ.

nx, ny, nz

The normal vector. The components nx, ny, nz must be real numerical values or arithmetical expressions in the animation parameter a. If no normal is specified, the normal (0, 0, 1) is used.

nx, ny, nz are equivalent to the attributes NormalX, NormalY, NormalZ.

a

Animation parameter, specified as a = amin..amax, where amin is the initial parameter value, and amax is the final parameter value.

See Also

MuPAD Functions

MuPAD Graphical Primitives