Syntax

hPatch = swplot.ellipsoid(R0, T)

hPatch = swplot.ellipsoid(R0, T, nMesh)

hPatch = swplot.ellipsoid(handle, ...)

Description

hPatch = swplot.ellipsoid(R0,T) creates multiple ellipsoids with a single patch command. The ellipsoids are defined by the position of the center and a \([3\times 3]\) matrix, a qudratic form.

Significant speedup can be achieved using a single patch command to generate many ellipsoids compared to drawing single ellipse per patch.

hPatch = swplot.ellipsoid(R0, T, nMesh) defines the size of the mesh that defines the surface.

hPatch = swplot.ellipsoid(handle, ...) adds the generated patch object to a given axis if handle is an axis handle or adds the ellipsoids to an existing patch object, if the given handle points to a patch object.

Input Arguments

handle
Handle of an axis or triangulated patch object. In case of patch object, the constructed faces will be added to the existing object.
R0
Center of the ellipsoids stored in a column vector with 3 elements or a matrix with dimensions of \([3\times n_{obj}]\) when multiple ellipsoids are defined at once.
T
Transformation matrix that transforms a unit sphere to the desired ellipsoid by applying: R' = T(:,:,i)*R. In case of multiple ellipsoids the parameter is stored in a matrix with dimensions of \([3\times 3\times n_{obj}]\).
nMesh
Mesh of the ellipse surface, a triangulation class object or an integer that used to generate an icosahedron mesh with \(n_{mesh}\) number of additional subdivision into triangles. Default value is stored in swpref.getpref('nmesh'), see also swplot.icomesh.

See Also

triangulation | swplot.icomesh