Documentation Center

  • Trial Software
  • Product Updates

plot::CoordinateSystem3d

Coordinate system to display 3D objects in

Use only in the MuPAD Notebook Interface.

This functionality does not run in MATLAB.

Syntax

plot::CoordinateSystem3d(object1, object2, …, <a = amin .. amax>, options)

Description

plot::CoordinateSystem3d is a container to display graphical 3D objects within. Usually, the user does not need to create such an object explicitly, because a plot command such as plot(object1, object2, …) creates a default object of type plot::CoordinateSystem3d implicitly to display the graphical objects in.

The plot::CoordinateSystem3d object is always visible in the interactive object browser of the MuPAD® graphics tool (see section Viewer, Browser, and Inspector: Interactive Manipulation of this document). It contains the graphical objects as its children. When the coordinate system object is selected, it provides access to a variety of attributes that are associated with the coordinate system. These attributes allow to manipulate:

  • the CoordinateType (linear vs. logarithmic coordinates),

  • the ViewingBox (visibility range),

  • the coordinate axes (axes titles, visibility, alignment, type, tips etc.),

  • the ticks along the coodinate axes (number of tick marks, visibility, tick labels etc.),

  • the coordinate grid (visibility, color, line width etc.),

  • the scaling ratios of the coordinate directions (Constrained vs. UnConstrained).

A complete listing of the attributes associated with the coordinate system is given below. Follow the links to the help pages of the attributes to find more detailed information.

Apart from these attributes of the coordinate system, also attributes for the graphical objects inside the coordinate system can be specified when generating an object of type plot::CoordinateSystem3d. These attribute values are inherited to the graphical objects as new default values.

A graphical scene may contain more than one coordinate system. Each coordinate system provides separate coordinate axes, ticks, grid lines etc.

In such a case, separate plot::CoordinateSystem3d containers must be created explicitly by the user and passed to a plot command (or inserted into a scene of type plot::Scene3d). Cf. Example 2.

Attributes

AttributePurposeDefault Value
Axestype of the coordinate axesBoxed
AxesTipsarrow tips at the coordinate axes?FALSE
AxesOrigincrosspoint of the coordinate axes[0, 0, 0]
AxesTitlestitles for the coordinate axes[" x ", " y ", " z "]
AxesOriginXcrosspoint of the coordinate axes, x-coordinate0
AxesOriginYcrosspoint of the coordinate axes, y-coordinate0
AxesOriginZcrosspoint of the coordinate axes, z-coordinate0
AxesVisibledisplay coordinate axes?TRUE
AxesLineColorcolor of the coordinate axesRGB::Black
AxesLineWidthwidth of the coordinate axes0.18
AxesTitleFontfont of axes titles[" sans-serif ", 10]
AxesTitleAlignmentalignment of axes titlesCenter
GridVisibledisplay a coordinate grid?FALSE
GridLineColorline color of the coordinate gridRGB::Grey60
GridLineWidthwidth of coordinate grid lines0.1
GridLineStyleline style of the coordinate gridSolid
Namethe name of a plot object (for browser and legend) 
Scalingscaling ratiosUnconstrained
SubgridVisibledisplay a coordinate subgrid?FALSE
SubgridLineColorline color of the coordinate subgridRGB::Grey80
SubgridLineWidthwidth of coordinate subgrid lines0.1
SubgridLineStyleline style of the coordinate subgridSolid
TicksAtspecial axes tick marks 
TicksAnchoruser defined start of axes tick marks0
TicksLengthlength of axes tick marks2
TicksNumbernumber of axes tick marksNormal
TicksBetweennumber of minor (unlabeled) axes tick marks between major (labeled) axes tick marks1
TicksVisibledisplay axes tick marks?TRUE
TicksDistanceuser defined axes tick mark distance0
TicksLabelFontfont of tick labels[" sans-serif ", 8]
TicksLabelStyledisplay style of axes tick labelsHorizontal
TicksLabelsVisibledisplay axes tick labels?TRUE
ViewingBoxthe visible coordinate range[Automatic .. Automatic, Automatic .. Automatic, Automatic .. Automatic]
ViewingBoxXMinthe smallest visible x-valuesAutomatic
ViewingBoxYMinthe smallest visible y-valuesAutomatic
ViewingBoxXMaxthe largest visible x-valuesAutomatic
ViewingBoxZMinthe smallest visible z-valuesAutomatic
ViewingBoxYMaxthe largest visible y-valuesAutomatic
ViewingBoxZMaxthe largest visible z-valuesAutomatic
ViewingBoxXRangethe range of x-values visibleAutomatic .. Automatic
ViewingBoxYRangethe range of y-values visibleAutomatic .. Automatic
ViewingBoxZRangethe range of z-values visibleAutomatic .. Automatic
XAxisTitletitle for the x axis" x "
XAxisVisibledisplay x axis?TRUE
XAxisTitleAlignmentalignment of x axis titleCenter
XGridVisibledisplay a coordinate grid in x-direction?FALSE
XSubgridVisibledisplay a coordinate subgrid in x-direction?FALSE
XTicksAtspecial x axis tick marks 
XTicksAnchoruser defined start of x axis tick marks0
XTicksNumbernumber of x axis tick marksNormal
XTicksBetweennumber of minor (unlabeled) x axis tick marks between major (labeled) x axis tick marks1
XTicksVisibledisplay x axis tick marks?TRUE
XTicksDistancedistance of tick marks on x axis0
XTicksLabelStyledisplay style of x axis tick labelsHorizontal
XTicksLabelsVisibledisplay x axis tick labels?TRUE
YAxisTitletitle for the y axis" y "
YAxisVisibledisplay y axis?TRUE
YAxisTitleAlignmentalignment of y axis titleCenter
YGridVisibledisplay a coordinate grid in y-direction?FALSE
YSubgridVisibledisplay a coordinate subgrid in y-direction?FALSE
YTicksAtspecial y axis tick marks 
YTicksAnchoruser defined start of y axis tick marks0
YTicksNumbernumber of y axis tick marksNormal
YTicksBetweennumber of minor (unlabeled) y axis tick marks between major (labeled) y axis tick marks1
YTicksVisibledisplay y axis tick marks?TRUE
YTicksDistancedistance of tick marks on y axis0
YTicksLabelStyledisplay style of y axis tick labelsHorizontal
YTicksLabelsVisibledisplay y axis tick labels?TRUE
ZAxisTitletitle for the z axis" z "
ZAxisVisibledisplay z axis?TRUE
ZAxisTitleAlignmentalignment of z axis titleCenter
ZGridVisibledisplay a coordinate grid in z-direction?FALSE
ZSubgridVisibledisplay a coordinate subgrid in z-direction?FALSE
ZTicksAtspecial z axis tick marks 
ZTicksAnchoruser defined start of z axis tick marks0
ZTicksNumbernumber of z axis tick marksNormal
ZTicksBetweennumber of minor (unlabeled) z axis tick marks between major (labeled) z axis tick marks1
ZTicksVisibledisplay z axis tick marks?TRUE
ZTicksDistancedistance of tick marks on z axis0
ZTicksLabelStyledisplay style of z axis tick labelsHorizontal
ZTicksLabelsVisibledisplay z axis tick labels?TRUE

Examples

Example 1

When executing a plot command, a default plot::CoordinateSystem3d is created implicitly which contains the specified graphical objects:

f := plot::Function3d(sin(x - y)^2, x = -PI..PI, y = -PI..PI):
g := plot::Function3d(cos(x - y)^2, x = -PI..PI, y = -PI..PI):
plot(f, g)

We can also create the coordinate system explicitly. The result is the same:

plot(plot::CoordinateSystem3d(f, g))

delete f, g:

Example 2

The functions f1 = sin(x - y) and f2 = sin(h)(x + y) cannot be plotted simultaneously in one coordinate system over the range x ∈ [- 10, 10], y ∈ [- 10, 10], because they produce function values of different orders of magnitude. To plot them together, we use two different coordinate systems. We request explicit vertical ranges for the (rather different) viewing boxes by the attribute ViewingBoxZRange.

We set various attributes of the coordinate systems to determine the positioning of the axes and their titles:

f1 := plot::Function3d(sin(x - y), x = -10..10, y = -10..10,
                       Submesh = [2, 2],
                       Color = RGB::Red, FillColorType = Flat,
                       Legend = "sin(x - y)"):
CS1 := plot::CoordinateSystem3d(f1):
CS1::Axes := Origin:
CS1::AxesOrigin := [-10, 10, -3]:
CS1::ViewingBoxZRange := -3..3:
CS1::ZAxisTitle := "sin":

f2 := plot::Function3d(sinh(x + y), x = -10..10, y = -10..10,
                       Color = RGB::Blue, FillColorType = Flat,
                       Legend = "sinh(x + y)"):
CS2 := plot::CoordinateSystem3d(f2):
CS2::Axes := Origin:
CS2::AxesOrigin := [10, -10, -3*10^8]:
CS2::ViewingBoxZRange := -3*10^8..3*10^8:
CS2::ZAxisTitle := "sinh":

plot(CS1, CS2):

delete f1, CS1, f2, CS2:

Parameters

object1, object2, …

Graphical 3D objects

See Also

MuPAD Functions

MuPAD Graphical Primitives

Was this topic helpful?