Circle

Circle[{x,y},r]

represents a circle of radius r centered at {x,y}.

Circle[{x,y}]

gives a circle of radius 1.

Circle[{x,y},{rx,ry}]

gives an axis-aligned ellipse with semiaxes lengths rx and ry.

Circle[{x,y},,{θ1,θ2}]

gives a circular or ellipse arc from angle θ1 to θ2.

Details

  • Circle with its different parameter settings is also known as arc, circular arc, semicircle, and ellipse.
  • Circle can be used as a geometric region and a graphics primitive.
  • Circle[] is equivalent to Circle[{0,0}]. »
  • Circle represents the curve .
  • Angles are measured in radians counterclockwise from the positive x direction.
  • Circle can be used in Graphics.
  • In graphics, the point {x,y} and radii r and {rx,ry} can be Scaled, Offset, ImageScaled, and Dynamic expressions.
  • Graphics rendering is affected by directives such as Thickness, Dashing, and color.
  • Circle can be used with symbolic points and quantities in GeometricScene.

Background & Context

  • Circle is a graphics and geometry primitive that represents a circle, ellipse, or circular/elliptical arc in the plane. In particular, Circle[{x,y},r] represents the circle of radius r in centered at {x,y}, Circle[{x,y},{rx,ry}] represents the axis-aligned filled ellipse in with center {x,y} and semiaxis lengths rx and ry, and Circle[{x,y},,{θ1,θ2}] represents the (potentially elliptical) arc centered at {x,y} ranging between angles θ1 and θ2 measured in radians counterclockwise from the positive axis. The shorthand form Circle[{x,y}] is equivalent to Circle[{x,y},1], while Circle[] autoevaluates to Circle[{0,0},1].
  • Circle objects can be formatted by placing them inside a Graphics expression. Note that while abstract circles have dimension 1 and zero thickness, for convenience, formatted Circle objects are rendered by default with finite thickness. The appearance of Circle objects in graphics can be modified by specifying thickness directives such as Thickness, AbsoluteThickness, Thick and Thin; dashing directives such as Dashing, AbsoluteDashing, Dashed, Dotted and DotDashed; color directives such as Red; the transparency directive Opacity; and the style option Antialiasing.
  • Circle may also serve as a region specification over which a computation should be performed. For example, Integrate[1,{x, y}Circle[{0,0},r]] and ArcLength[Circle[{x,y},r]] both return the perimeter .
  • CirclePoints may be used to give the positions of equally spaced points around a circle.
  • Circle is related to a number of other symbols. Circle represents the boundary of a disk, as can be computed using RegionBoundary[Disk[{x,y},r]]. Cylinder and Sphere may be thought of as higher-dimensional analogs of circles. Circle[{x,y},r] may be alternately represented using Sphere[{x,y},r], ImplicitRegion[(x-u)2+(y-v)2r2,{u,v}] or ParametricRegion[{x+r Cos[t],y+r Sin[t]},{t,0,2π}]. Precomputed properties of the circle and its variants in standard position are available using PlaneCurveData["entity","property"] or EntityValue[Entity["PlaneCurve","entity"],"property"], where "entity" is one of "Circle", "CircularArc", "Ellipse", "Semicircle", etc.

Examples

open allclose all

Basic Examples  (5)

A unit circle:

A circular arc:

An ellipse:

Differently styled circles:

ArcLength of a circle:

Length or circular arc:

Scope  (23)

Graphics  (13)

Specification  (6)

Specify radii:

Specify centers:

A circular arc:

An ellipse:

An elliptical arc:

Short form for a unit circle at the origin:

Styling  (3)

Circles with different thicknesses:

Thickness in scaled size:

Thickness in printer's points:

Dashed circles:

Colored circles:

Coordinates  (4)

Using Scaled coordinates and radii:

Use ImageScaled coordinates and radii:

Use Offset coordinates:

Use Offset to specify the radii in printer's points:

Regions  (10)

Embedding dimension:

Geometric dimension:

Point membership test:

Get conditions for point membership:

Arc length:

Centroid:

Distance from a point:

The distance to the nearest point for the unit circle:

Signed distance from a point:

Signed distance to the unit circle:

Nearest point in the region:

Nearest points:

A circle is bounded:

Get its range:

Integrate over a circle:

Optimize over a circle:

Solve equations in a circle:

Applications  (8)

The square packing of circles:

The hexagonal packing of circles:

Simulation of elliptical gears:

Find the intersections of a Line and a Circle:

Find the intersections of two circles:

Illustrate a function's radius of curvature:

A circumcircle is a circle in the plane defined by three noncollinear points:

The radius and circumcenter can be extracted from the Circumsphere:

The defining property of a DelaunayMesh is that no input point is contained in the circumcircle of any Triangle in the mesh:

Given electric charge density along a circular wire, use Integrate to find the total charge:

Properties & Relations  (10)

Use Rotate to get all possible ellipses:

To create a filled circle, use Disk:

The 3D generalization is Sphere:

An implicit specification of a circle can be generated by ContourPlot:

A parametric specification of a circle can be generated by ParametricPlot:

Sphere can represent any Circle:

Circumsphere can represent any Circle:

ParametricRegion can represent any Circle:

ImplicitRegion can represent any Circle:

Circle is a norm circle for the Euclidean norm:

Possible Issues  (2)

Using Scaled radii will depend on the PlotRange:

Using ImageScaled sizes will depend on the ImageSize and AspectRatio:

Neat Examples  (4)

Random circles:

The seed of life:

A family of circles:

Yin and yang:

Introduced in 1991
 (2.0)
 |
Updated in 1996
 (3.0)
2014
 (10.0)