Subgroup: other

Class: QgsCircle

class qgis.core.QgsCircle

Bases: qgis._core.QgsEllipse

QgsCircle(center: QgsPoint, radius: float, azimuth: float = 0) Constructs a circle by defining all the members.

Parameters:
  • center – The center of the circle.
  • radius – The radius of the circle.
  • azimuth – Angle in degrees started from the North to the first quadrant.

QgsCircle(QgsCircle)

Circle geometry type.

A circle is defined by a center point with a radius and an azimuth. The azimuth is the north angle to the semi-major axis, in degrees. By default, the semi-major axis is oriented to the north (0 degrees).

New in version 3.0: Methods

area
boundingBox
contains Returns true if the circle contains the point.
from2Points Constructs a circle by 2 points on the circle.
from3Points Constructs a circle by 3 points on the circle.
from3Tangents Constructs a circle by 3 tangents on the circle (aka inscribed circle of a triangle).
fromCenterDiameter Constructs a circle by a center point and a diameter.
fromCenterPoint Constructs a circle by a center point and another point.
fromExtent Constructs a circle by an extent (aka bounding box / QgsRectangle).
minimalCircleFrom3Points Constructs the smallest circle from 3 points.
northQuadrant The four quadrants of the ellipse.
perimeter
radius Returns the radius of the circle
setRadius Set the radius of the circle
setSemiMajorAxis Inherited method.
setSemiMinorAxis Inherited method.
toCircularString Returns a circular string from the circle.
toString

Signals

Attributes

area(self) → float
boundingBox(self) → QgsRectangle
contains(self, point: QgsPoint, epsilon: float = 1e-08) → bool

Returns true if the circle contains the point.

from2Points(pt1: QgsPoint, pt2: QgsPoint) → QgsCircle

Constructs a circle by 2 points on the circle. The center point can have m value which is the result from the midpoint operation between pt1 and pt2. Z dimension is also supported and is retrieved from the first 3D point amongst pt1 and pt2. The radius is calculated from the 2D distance between pt1 and pt2. The azimuth is the angle between pt1 and pt2.

Parameters:
  • pt1 – First point.
  • pt2 – Second point.
from3Points(pt1: QgsPoint, pt2: QgsPoint, pt3: QgsPoint, epsilon: float = 1e-08) → QgsCircle

Constructs a circle by 3 points on the circle. M value is dropped for the center point. Z dimension is supported and is retrieved from the first 3D point amongst pt1, pt2 and pt3. The azimuth always takes the default value. If the points are colinear an empty circle is returned.

Parameters:
  • pt1 – First point.
  • pt2 – Second point.
  • pt3 – Third point.
  • epsilon – Value used to compare point.
from3Tangents(pt1_tg1: QgsPoint, pt2_tg1: QgsPoint, pt1_tg2: QgsPoint, pt2_tg2: QgsPoint, pt1_tg3: QgsPoint, pt2_tg3: QgsPoint, epsilon: float = 1e-08) → QgsCircle

Constructs a circle by 3 tangents on the circle (aka inscribed circle of a triangle). Z and m values are dropped for the center point. The azimuth always takes the default value.

Parameters:
  • pt1_tg1 – First point of the first tangent.
  • pt2_tg1 – Second point of the first tangent.
  • pt1_tg2 – First point of the second tangent.
  • pt2_tg2 – Second point of the second tangent.
  • pt1_tg3 – First point of the third tangent.
  • pt2_tg3 – Second point of the third tangent.
  • epsilon – Value used to compare point.
fromCenterDiameter(center: QgsPoint, diameter: float, azimuth: float = 0) → QgsCircle

Constructs a circle by a center point and a diameter. The center point keeps z and m values from center.

Parameters:
  • center – Center point.
  • diameter – Diameter of the circle.
  • azimuth – Azimuth of the circle.
fromCenterPoint(center: QgsPoint, pt1: QgsPoint) → QgsCircle

Constructs a circle by a center point and another point. The center point keeps z and m values from center. Axes are calculated from the 2D distance between center and pt1. The azimuth is the angle between center and pt1.

Parameters:
  • center – Center point.
  • pt1 – A point on the circle.
fromExtent(pt1: QgsPoint, pt2: QgsPoint) → QgsCircle

Constructs a circle by an extent (aka bounding box / QgsRectangle). The center point can have m value which is the result from the midpoint operation between pt1 and pt2. Z dimension is also supported and is retrieved from the first 3D point amongst pt1 and pt2. Axes are calculated from the 2D distance between pt1 and pt2. The azimuth always takes the default value.

Parameters:
  • pt1 – First corner.
  • pt2 – Second corner.
minimalCircleFrom3Points(pt1: QgsPoint, pt2: QgsPoint, pt3: QgsPoint, epsilon: float = 1e-08) → QgsCircle

Constructs the smallest circle from 3 points. Z and m values are dropped for the center point. The azimuth always takes the default value. If the points are colinear an empty circle is returned.

Parameters:
  • pt1 – First point.
  • pt2 – Second point.
  • pt3 – Third point.
  • epsilon – Value used to compare point.
northQuadrant(self) → List[QgsPoint]

The four quadrants of the ellipse. They are oriented and started from North.

Returns:quadrants defined by four points.

See also

quadrant()

perimeter(self) → float
radius(self) → float

Returns the radius of the circle

setRadius(self, radius: float)

Set the radius of the circle

setSemiMajorAxis(self, semiMajorAxis: float)

Inherited method. Use setRadius instead.

See also

radius()

See also

setRadius()

setSemiMinorAxis(self, semiMinorAxis: float)

Inherited method. Use setRadius instead.

See also

radius()

See also

setRadius()

toCircularString(self, oriented: bool = False) → QgsCircularString

Returns a circular string from the circle.

Parameters:oriented – If oriented is true the start point is from azimuth instead from north.
toString(self, pointPrecision: int = 17, radiusPrecision: int = 17, azimuthPrecision: int = 2) → str