Ellipses

class sage.plot.ellipse.Ellipse(x, y, r1, r2, angle, options)

Bases: sage.plot.primitive.GraphicPrimitive

Primitive class for the Ellipse graphics type. See ellipse? for information about actually plotting ellipses.

INPUT:

  • x,y - coordinates of the center of the ellipse
  • r1, r2 - radii of the ellipse
  • angle - angle
  • options - dictionary of options

EXAMPLES:

Note that this construction should be done using ellipse:

sage: from sage.plot.ellipse import Ellipse
sage: Ellipse(0, 0, 2, 1, pi/4, {})
Ellipse centered at (0.0, 0.0) with radii (2.0, 1.0) and angle 0.785398163397
get_minmax_data()

Returns a dictionary with the bounding box data.

The bounding box is computed to be as minimal as possible.

EXAMPLES:

An example without an angle:

sage: p = ellipse((-2, 3), 1, 2)
sage: d = p.get_minmax_data()
sage: d['xmin']
-3.0
sage: d['xmax']
-1.0
sage: d['ymin']
1.0
sage: d['ymax']
5.0

The same example with a rotation of angle \pi/2:

sage: p = ellipse((-2, 3), 1, 2, pi/2)
sage: d = p.get_minmax_data()
sage: d['xmin']
-4.0
sage: d['xmax']
0.0
sage: d['ymin']
2.0
sage: d['ymax']
4.0
plot3d()

Plotting in 3D is not implemented.

TESTS:

sage: from sage.plot.ellipse import Ellipse
sage: Ellipse(0,0,2,1,pi/4,{}).plot3d()
Traceback (most recent call last):
...
NotImplementedError
sage.plot.ellipse.ellipse(*args, **kwds)

Return an ellipse centered at a point center = (x,y) with radii = r1,r2 and angle angle. Type ellipse.options to see all options.

INPUT:

  • center - 2-tuple of real numbers - coordinates of the center
  • r1, r2 - positive real numbers - the radii of the ellipse
  • angle - real number (default: 0) - the angle between the first axis and the horizontal

OPTIONS:

  • alpha - default: 1 - transparency
  • fill - default: False - whether to fill the ellipse or not
  • thickness - default: 1 - thickness of the line
  • rgbcolor - default: (0,0,0) - color of the ellipse (overwrites edgecolor and facecolor)
  • linestyle - default: ‘solid’
  • edgecolor - default: ‘black’ - color of the contour
  • facecolor - default: ‘red’ - color of the filling

EXAMPLES:

An ellipse centered at (0,0) with major and minor axes of lengths 2 and 1:

sage: ellipse((0,0),2,1)

More complicated examples with tilted axes and drawing options:

sage: ellipse((0,0),3,1,pi/6,fill=True,alpha=0.3)
sage: ellipse((0,0),3,1,pi/6,fill=True,edgecolor='blue',facecolor='red')

One cannot yet plot ellipses in 3D:

sage: ellipse((0,0,0),2,1)
Traceback (most recent call last):
...
NotImplementedError: plotting ellipse in 3D is not implemented

Previous topic

Disks

Next topic

Line Plots

This Page