Name of an object

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.

Value Summary

OptionalText string

Graphics Primitives

ObjectsName Default Values
plot::AmbientLight, plot::Arc2d, plot::Arc3d, plot::Arrow2d, plot::Arrow3d, plot::Bars2d, plot::Bars3d, plot::Box, plot::Boxplot, plot::Camera, plot::Canvas, plot::Circle2d, plot::Circle3d, plot::ClippingBox, plot::Cone, plot::Conformal, plot::CoordinateSystem2d, plot::CoordinateSystem3d, plot::Curve2d, plot::Curve3d, plot::Cylinder, plot::Cylindrical, plot::Density, plot::DistantLight, plot::Dodecahedron, plot::Ellipse2d, plot::Ellipse3d, plot::Ellipsoid, plot::Function2d, plot::Function3d, plot::Group2d, plot::Group3d, plot::Hatch, plot::Hexahedron, plot::Histogram2d, plot::Icosahedron, plot::Implicit2d, plot::Implicit3d, plot::Inequality, plot::Integral, plot::Iteration, plot::Line2d, plot::Line3d, plot::Listplot, plot::Lsys, plot::Matrixplot, plot::MuPADCube, plot::Octahedron, plot::Ode2d, plot::Ode3d, plot::Parallelogram2d, plot::Parallelogram3d, plot::Piechart2d, plot::Piechart3d, plot::Plane, plot::Point2d, plot::Point3d, plot::PointLight, plot::PointList2d, plot::PointList3d, plot::Polar, plot::Polygon2d, plot::Polygon3d, plot::Prism, plot::Pyramid, plot::QQplot, plot::Raster, plot::Rectangle, plot::Reflect2d, plot::Reflect3d, plot::Rootlocus, plot::Rotate2d, plot::Rotate3d, plot::Scale2d, plot::Scale3d, plot::Scatterplot, plot::Scene2d, plot::Scene3d, plot::Sequence, plot::SparseMatrixplot, plot::Sphere, plot::Spherical, plot::SpotLight, plot::Streamlines2d, plot::Sum, plot::Surface, plot::SurfaceSet, plot::SurfaceSTL, plot::Sweep, plot::Tetrahedron, plot::Text2d, plot::Text3d, plot::Transform2d, plot::Transform3d, plot::Translate2d, plot::Translate3d, plot::Tube, plot::Turtle, plot::VectorField2d, plot::VectorField3d, plot::Waterman, plot::XRotate, plot::ZRotate 


The attribute Name sets the name of a graphical object. The object is displayed by this name in the legend and the interactive object browser of the graphics tool.

Giving a name to a graphical object has no significance whatsoever for the graphical appearance of the object. The main purpose of the name is to make it easier to identify the object in the interactive “object browser” of the MuPAD® graphics tool (see section Viewer, Browser, and Inspector: Interactive Manipulation of this document).

If no name is specified, the type of the object is diplayed in the object browser.

If the legend is “switched on” by setting LegendVisible to TRUE, the name slot of an object is used (if if exists), unless the object has a specific LegendText.

Name has a special technical semantics for objects of type plot::Hatch. The bounding functions or curves of the hatch are referenced via their name slot. If the bounding function or curve has no name slot, it is set implicitly by plot::Hatch to the output of expr2text of the function/curve. Cf. Example 2Example 2.


Example 1

The first two of the following function objects are given the names Sin and Cos, respectively. Generate the graphics and doubleclick on the plot. The two function objects are visible under their names in the object browser. The third function is just labeled as a 'Function2d' object. Also the legend uses this labeling:

plot(plot::Function2d(sin(x), x = -PI..PI, Name = "Sin",
                      Color = RGB::Red),
     plot::Function2d(cos(x), x = -PI..PI, Name = "Cos",
                      Color = RGB::Green),
     plot::Function2d(x/PI , x = -PI..PI, Color = RGB::Blue),
     LegendVisible = TRUE)

Example 2

By default, an object does not have a Name entry:

f := plot::Function2d(cos(x), x=0..PI):

When creating a plot::Hatch object, the Name slot is set implicitly for the border function(s):

h := plot::Hatch(f):

We plot the hatch with its bounding function:

plot(h, f)

Doubleclick on the graphics and observe the way the objects are labeled in the object inspector.

delete f, h:

See Also

MuPAD Functions