## `plot::density` -- generate two-dimensional density plots

#### Introduction

`plot::density``([x, y, z], u = a..b, v = c..d)` returns a density plot of the surface defined by (u,v) -> (x(u,v); y(u,v); z(u,v)) with (u,v) in [a,b] x [c,d].

#### Call(s)

`plot::density([x, y, z], u = a..b, v = c..d <, option1, option2...>)`

#### Parameters

`x, y, z` | - | arithmetical expressions in `u` and `v`
`u, v` | - | identifiers
`option1, option2, ...` | - | plot option(s) of the form `option = value`

#### Returns

an object of the domain type `plot::Scene`.

#### Related Functions

`plot`, `plot3d`, `plot::contour`

#### Details

- Call `plot(...)` to display the density plot created on the screen.

- Note that `plot::density` does not return a graphical object but a graphical scene consisting of the surface as defined!

  Moreover, the scene returned is of dimension three, but the focal point and the camera point is set such that the plot looks like a two-dimensional plot.

- The plot options `option1`, `option2`... must be valid plot options for three-dimensional graphical scenes. See `plot3d` for details.

#### Example 1

The following call returns an object representing a density plot of the surface defined by (u,v) -> (u, v, 1/2*sin(u^2 + v^2)) with (u,v) in [0,PI] x [0,PI]:

    >> d:= plot::density([u, v, 1/2*sin(u^2 + v^2)], u = [0,PI], v = [0, PI] )

                                   plot::Scene()

To plot this surface on the screen, call `plot`:

    >> plot(d)

#### Changes

- used to be called `plotlib::densityplot`
- `plot::density` is now part of the new plot library `plot`, and its calling syntax and the return value were changed.

Do you have questions or comments?
Copyright © SciFace Software GmbH & Co. KG 2000