Products
  • Wolfram|One

    The definitive Wolfram Language and notebook experience

  • Mathematica

    The original technical computing environment

  • Notebook Assistant + LLM Kit

    All-in-one AI assistance for your Wolfram experience

  • Compute Services
  • System Modeler
  • Finance Platform
  • Wolfram|Alpha Notebook Edition
  • Application Server
  • Enterprise Private Cloud
  • Wolfram Engine
  • Wolfram Player
  • Wolfram Cloud App
  • Wolfram Player App

More mobile apps

Core Technologies of Wolfram Products

  • Wolfram Language
  • Computable Data
  • Wolfram Notebooks
  • AI & Linguistic Understanding

Deployment Options

  • Wolfram Cloud
  • wolframscript
  • Wolfram Engine Community Edition
  • Wolfram LLM API
  • WSTPServer
  • Wolfram|Alpha APIs

From the Community

  • Function Repository
  • Community Paclet Repository
  • Example Repository
  • Neural Net Repository
  • Prompt Repository
  • Wolfram Demonstrations
  • Data Repository
  • Group & Organizational Licensing
  • All Products
Consulting & Solutions

We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

  • Data & Computational Intelligence
  • Model-Based Design
  • Algorithm Development
  • Wolfram|Alpha for Business
  • Blockchain Technology
  • Education Technology
  • Quantum Computation

Wolfram Consulting

Wolfram Solutions

  • Data Science
  • Artificial Intelligence
  • Biosciences
  • Healthcare Intelligence
  • Sustainable Energy
  • Control Systems
  • Enterprise Wolfram|Alpha
  • Blockchain Labs

More Wolfram Solutions

Wolfram Solutions For Education

  • Research Universities
  • Colleges & Teaching Universities
  • Junior & Community Colleges
  • High Schools
  • Educational Technology
  • Computer-Based Math

More Solutions for Education

  • Contact Us
Learning & Support

Get Started

  • Wolfram Language Introduction
  • Fast Intro for Programmers
  • Fast Intro for Math Students
  • Wolfram Language Documentation

More Learning

  • Highlighted Core Areas
  • Demonstrations
  • YouTube
  • Daily Study Groups
  • Wolfram Schools and Programs
  • Books

Grow Your Skills

  • Wolfram U

    Courses in computing, science, life and more

  • Community

    Learn, solve problems and share ideas.

  • Blog

    News, views and insights from Wolfram

  • Resources for

    Software Developers

Tech Support

  • Contact Us
  • Support FAQs
  • Support FAQs
  • Contact Us
Company
  • About Wolfram
  • Career Center
  • All Sites & Resources
  • Connect & Follow
  • Contact Us

Work with Us

  • Student Ambassador Initiative
  • Wolfram for Startups
  • Student Opportunities
  • Jobs Using Wolfram Language

Educational Programs for Adults

  • Summer School
  • Winter School

Educational Programs for Youth

  • Middle School Camp
  • High School Research Program
  • Computational Adventures

Read

  • Stephen Wolfram's Writings
  • Wolfram Blog
  • Wolfram Tech | Books
  • Wolfram Media
  • Complex Systems

Educational Resources

  • Wolfram MathWorld
  • Wolfram in STEM/STEAM
  • Wolfram Challenges
  • Wolfram Problem Generator

Wolfram Initiatives

  • Wolfram Science
  • Wolfram Foundation
  • History of Mathematics Project

Events

  • Stephen Wolfram Livestreams
  • Online & In-Person Events
  • Contact Us
  • Connect & Follow
Wolfram|Alpha
  • Your Account
  • User Portal
  • Wolfram Cloud
  • Products
    • Wolfram|One
    • Mathematica
    • Notebook Assistant + LLM Kit
    • Compute Services
    • System Modeler
    • Finance Platform
    • Wolfram|Alpha Notebook Edition
    • Application Server
    • Enterprise Private Cloud
    • Wolfram Engine
    • Wolfram Player
    • Wolfram Cloud App
    • Wolfram Player App

    More mobile apps

    • Core Technologies
      • Wolfram Language
      • Computable Data
      • Wolfram Notebooks
      • AI & Linguistic Understanding
    • Deployment Options
      • Wolfram Cloud
      • wolframscript
      • Wolfram Engine Community Edition
      • Wolfram LLM API
      • WSTPServer
      • Wolfram|Alpha APIs
    • From the Community
      • Function Repository
      • Community Paclet Repository
      • Example Repository
      • Neural Net Repository
      • Prompt Repository
      • Wolfram Demonstrations
      • Data Repository
    • Group & Organizational Licensing
    • All Products
  • Consulting & Solutions

    We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

    WolframConsulting.com

    Wolfram Solutions

    • Data Science
    • Artificial Intelligence
    • Biosciences
    • Healthcare Intelligence
    • Sustainable Energy
    • Control Systems
    • Enterprise Wolfram|Alpha
    • Blockchain Labs

    More Wolfram Solutions

    Wolfram Solutions For Education

    • Research Universities
    • Colleges & Teaching Universities
    • Junior & Community Colleges
    • High Schools
    • Educational Technology
    • Computer-Based Math

    More Solutions for Education

    • Contact Us
  • Learning & Support

    Get Started

    • Wolfram Language Introduction
    • Fast Intro for Programmers
    • Fast Intro for Math Students
    • Wolfram Language Documentation

    Grow Your Skills

    • Wolfram U

      Courses in computing, science, life and more

    • Community

      Learn, solve problems and share ideas.

    • Blog

      News, views and insights from Wolfram

    • Resources for

      Software Developers
    • Tech Support
      • Contact Us
      • Support FAQs
    • More Learning
      • Highlighted Core Areas
      • Demonstrations
      • YouTube
      • Daily Study Groups
      • Wolfram Schools and Programs
      • Books
    • Support FAQs
    • Contact Us
  • Company
    • About Wolfram
    • Career Center
    • All Sites & Resources
    • Connect & Follow
    • Contact Us

    Work with Us

    • Student Ambassador Initiative
    • Wolfram for Startups
    • Student Opportunities
    • Jobs Using Wolfram Language

    Educational Programs for Adults

    • Summer School
    • Winter School

    Educational Programs for Youth

    • Middle School Camp
    • High School Research Program
    • Computational Adventures

    Read

    • Stephen Wolfram's Writings
    • Wolfram Blog
    • Wolfram Tech | Books
    • Wolfram Media
    • Complex Systems
    • Educational Resources
      • Wolfram MathWorld
      • Wolfram in STEM/STEAM
      • Wolfram Challenges
      • Wolfram Problem Generator
    • Wolfram Initiatives
      • Wolfram Science
      • Wolfram Foundation
      • History of Mathematics Project
    • Events
      • Stephen Wolfram Livestreams
      • Online & In-Person Events
    • Contact Us
    • Connect & Follow
  • Wolfram|Alpha
  • Wolfram Cloud
  • Your Account
  • User Portal
Wolfram Language & System Documentation Center
Circle
  • See Also
    • Disk
    • CircleThrough
    • RoundingRadius
    • Rotate
    • Cylinder
    • Sphere
    • CirclePoints
    • GeometricScene
  • Related Guides
    • Graphics Objects
    • Basic Geometric Regions
    • Maps & Cartography
    • Precollege Education
    • Symbolic Graphics Language
    • Synthetic Geometry
    • Solid Geometry
    • Plane Geometry
    • See Also
      • Disk
      • CircleThrough
      • RoundingRadius
      • Rotate
      • Cylinder
      • Sphere
      • CirclePoints
      • GeometricScene
    • Related Guides
      • Graphics Objects
      • Basic Geometric Regions
      • Maps & Cartography
      • Precollege Education
      • Symbolic Graphics Language
      • Synthetic Geometry
      • Solid Geometry
      • Plane Geometry

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
Details and Options Details and Options
Background & Context
Examples  
Basic Examples  
Scope  
Graphics  
Specification  
Styling  
Coordinates  
Regions  
Applications  
Properties & Relations  
Possible Issues  
Neat Examples  
See Also
Related Guides
Related Links
History
Cite this Page
BUILT-IN SYMBOL
  • See Also
    • Disk
    • CircleThrough
    • RoundingRadius
    • Rotate
    • Cylinder
    • Sphere
    • CirclePoints
    • GeometricScene
  • Related Guides
    • Graphics Objects
    • Basic Geometric Regions
    • Maps & Cartography
    • Precollege Education
    • Symbolic Graphics Language
    • Synthetic Geometry
    • Solid Geometry
    • Plane Geometry
    • See Also
      • Disk
      • CircleThrough
      • RoundingRadius
      • Rotate
      • Cylinder
      • Sphere
      • CirclePoints
      • GeometricScene
    • Related Guides
      • Graphics Objects
      • Basic Geometric Regions
      • Maps & Cartography
      • Precollege Education
      • Symbolic Graphics Language
      • Synthetic Geometry
      • Solid Geometry
      • Plane Geometry

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)2r2,{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 all close 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:

See Also

Disk  CircleThrough  RoundingRadius  Rotate  Cylinder  Sphere  CirclePoints  GeometricScene

Function Repository: Circle3D  SplineCircle  CircleInversion

Related Guides

    ▪
  • Graphics Objects
  • ▪
  • Basic Geometric Regions
  • ▪
  • Maps & Cartography
  • ▪
  • Precollege Education
  • ▪
  • Symbolic Graphics Language
  • ▪
  • Synthetic Geometry
  • ▪
  • Solid Geometry
  • ▪
  • Plane Geometry

Related Links

  • An Elementary Introduction to the Wolfram Language : Basic Graphics Objects
  • An Elementary Introduction to the Wolfram Language : Coordinates and Graphics
  • An Elementary Introduction to the Wolfram Language : Options
  • An Elementary Introduction to the Wolfram Language : Pure Anonymous Functions

History

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

Wolfram Research (1991), Circle, Wolfram Language function, https://reference.wolfram.com/language/ref/Circle.html (updated 2014).

Text

Wolfram Research (1991), Circle, Wolfram Language function, https://reference.wolfram.com/language/ref/Circle.html (updated 2014).

CMS

Wolfram Language. 1991. "Circle." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2014. https://reference.wolfram.com/language/ref/Circle.html.

APA

Wolfram Language. (1991). Circle. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/Circle.html

BibTeX

@misc{reference.wolfram_2025_circle, author="Wolfram Research", title="{Circle}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/Circle.html}", note=[Accessed: 04-February-2026]}

BibLaTeX

@online{reference.wolfram_2025_circle, organization={Wolfram Research}, title={Circle}, year={2014}, url={https://reference.wolfram.com/language/ref/Circle.html}, note=[Accessed: 04-February-2026]}

Top
Introduction for Programmers
Introductory Book
Wolfram Function Repository | Wolfram Data Repository | Wolfram Data Drop | Wolfram Language Products
Top
  • Products
  • Wolfram|One
  • Mathematica
  • Notebook Assistant + LLM Kit
  • Compute Services
  • System Modeler

  • Wolfram|Alpha Notebook Edition
  • Wolfram|Alpha Pro
  • Mobile Apps

  • Wolfram Engine
  • Wolfram Player

  • Volume & Site Licensing
  • Server Deployment Options
  • Consulting
  • Wolfram Consulting
  • Repositories
  • Data Repository
  • Function Repository
  • Community Paclet Repository
  • Neural Net Repository
  • Prompt Repository

  • Wolfram Language Example Repository
  • Notebook Archive
  • Wolfram GitHub
  • Learning
  • Wolfram U
  • Wolfram Language Documentation
  • Webinars & Training
  • Educational Programs

  • Wolfram Language Introduction
  • Fast Introduction for Programmers
  • Fast Introduction for Math Students
  • Books

  • Wolfram Community
  • Wolfram Blog
  • Public Resources
  • Wolfram|Alpha
  • Wolfram Problem Generator
  • Wolfram Challenges

  • Computer-Based Math
  • Computational Thinking
  • Computational Adventures

  • Demonstrations Project
  • Wolfram Data Drop
  • MathWorld
  • Wolfram Science
  • Wolfram Media Publishing
  • Customer Resources
  • Store
  • Product Downloads
  • User Portal
  • Your Account
  • Organization Access

  • Support FAQ
  • Contact Support
  • Company
  • About Wolfram
  • Careers
  • Contact
  • Events
Wolfram Community Wolfram Blog
Legal & Privacy Policy
WolframAlpha.com | WolframCloud.com
© 2026 Wolfram
© 2026 Wolfram | Legal & Privacy Policy |
English