Class: QgsGeometryCollection¶
- class qgis.core.QgsGeometryCollection¶
Bases:
QgsAbstractGeometry
Geometry collection
New in version 2.10.
QgsGeometryCollection() Constructor for an empty geometry collection.
QgsGeometryCollection(c:
QgsGeometryCollection
)Methods
Adds a geometry and takes ownership.
- param mValue
- param zValue
- param vertex
- rtype
float
- param doc
- param doc
- param precision
- rtype
QPainterPath
- param flags
- param precision
- rtype
QgsAbstractGeometry
- rtype
QgsRectangle
- param rectangle
- rtype
QgsRectangle
- rtype
int
- param index
Returns point at index (for geometries without child geometries - i.e. curve / point).
- rtype
QgsGeometryCollection
- param pt
- param other
- rtype
object
- rtype
QgsGeometryCollection
- param position
- rtype
int
- param p
- rtype
bool
- rtype
bool
Reads a collection from a WKT string.
- param wkb
- param wkt
Returns a geometry from within the collection.
- rtype
str
Returns whether the geometry has any child geometries (
False
for point / curve,True
otherwise)- rtype
bool
Inserts a geometry before a specified index and takes ownership.
- param position
- rtype
bool
- param flags
- rtype
float
- param position
- rtype
int
- param id
Returns the number of geometries within the collection.
- rtype
int
- rtype
float
- param epsilon
Removes a geometry from the collection by index.
Attempts to allocate memory for at least
size
geometries.- param part
- param startVertex
Returns a geometry without curves.
Updates the geometry type based on whether sub geometries contain z or m values.
- rtype
QgsAbstractGeometry
- param hSpacing
Returns the sort index for the geometry, used in the
compareTo()
method to compare geometries of different types.- rtype
QgsGeometryCollection
- param ct
- param vertex
- param id
- param part
- param id
- param flags
Returns whether child type names are omitted from Wkt representations of the collection
- addGeometry(self, g: QgsAbstractGeometry) bool ¶
Adds a geometry and takes ownership. Returns
True
in case of success.- Parameters
g (QgsAbstractGeometry) –
- Return type
bool
- addMValue(self, mValue: float = 0) bool ¶
- Parameters
mValue (float = 0) –
- Return type
bool
- addZValue(self, zValue: float = 0) bool ¶
- Parameters
zValue (float = 0) –
- Return type
bool
- adjacentVertices(self, vertex: QgsVertexId) Tuple[QgsVertexId, QgsVertexId] ¶
- Parameters
vertex (QgsVertexId) –
- Return type
Tuple[
QgsVertexId
, QgsVertexId]
- area(self) float ¶
- Return type
float
- asGml2(self, doc: QDomDocument, precision: int = 17, ns: str = '', axisOrder: QgsAbstractGeometry.AxisOrder = QgsAbstractGeometry.AxisOrder.XY) QDomElement ¶
- Parameters
doc (QDomDocument) –
precision (int = 17) –
ns (str = '') –
axisOrder (QgsAbstractGeometry.AxisOrder = QgsAbstractGeometry.AxisOrder.XY) –
- Return type
QDomElement
- asGml3(self, doc: QDomDocument, precision: int = 17, ns: str = '', axisOrder: QgsAbstractGeometry.AxisOrder = QgsAbstractGeometry.AxisOrder.XY) QDomElement ¶
- Parameters
doc (QDomDocument) –
precision (int = 17) –
ns (str = '') –
axisOrder (QgsAbstractGeometry.AxisOrder = QgsAbstractGeometry.AxisOrder.XY) –
- Return type
QDomElement
- asKml(self, precision: int = 17) str ¶
- Parameters
precision (int = 17) –
- Return type
str
- asQPainterPath(self) QPainterPath ¶
- Return type
QPainterPath
- asWkb(self, flags: Union[QgsAbstractGeometry.WkbFlags, QgsAbstractGeometry.WkbFlag] = QgsAbstractGeometry.WkbFlags()) QByteArray ¶
- Parameters
flags (Union[QgsAbstractGeometry.WkbFlags) –
- Return type
QByteArray
- asWkt(self, precision: int = 17) str ¶
- Parameters
precision (int = 17) –
- Return type
str
- boundary(self) QgsAbstractGeometry ¶
- Return type
- boundingBox(self) QgsRectangle ¶
- Return type
- boundingBoxIntersects(self, rectangle: QgsRectangle) bool ¶
- Parameters
rectangle (QgsRectangle) –
- Return type
bool
- calculateBoundingBox(self) QgsRectangle ¶
- Return type
- childCount(self) int ¶
- Return type
int
- childGeometry(self, index: int) QgsAbstractGeometry ¶
- Parameters
index (int) –
- Return type
- childPoint(self, index: int) QgsPoint ¶
Returns point at index (for geometries without child geometries - i.e. curve / point)
Note
used for vertex_iterator implementation
New in version 3.0.
- clear(self)¶
- clearCache(self)¶
- clone(self) QgsGeometryCollection ¶
- Return type
- closestSegment(self, pt: QgsPoint, epsilon: float = 4 * DBL_EPSILON) Tuple[float, QgsPoint, QgsVertexId, int] ¶
- Parameters
pt (QgsPoint) –
epsilon (float = 4*DBL_EPSILON) –
- Return type
Tuple[float,
QgsPoint
,QgsVertexId
, int]
- compareToSameClass(self, other: QgsAbstractGeometry) int ¶
- Parameters
other (QgsAbstractGeometry) –
- Return type
int
- coordinateSequence(self) object ¶
- Return type
object
- createEmptyWithSameType(self) QgsGeometryCollection ¶
- Return type
- deleteVertex(self, position: QgsVertexId) bool ¶
- Parameters
position (QgsVertexId) –
- Return type
bool
- dimension(self) int ¶
- Return type
int
- draw(self, p: QPainter)¶
- Parameters
p (QPainter) –
- dropMValue(self) bool ¶
- Return type
bool
- dropZValue(self) bool ¶
- Return type
bool
- fromCollectionWkt(self, wkt: str, subtypes: object, defaultChildWkbType: str = '') bool ¶
Reads a collection from a WKT string.
- Parameters
wkt (str) –
subtypes (object) –
defaultChildWkbType (str = '') –
- Return type
bool
- fromWkb(self, wkb: QgsConstWkbPtr) bool ¶
- Parameters
wkb (QgsConstWkbPtr) –
- Return type
bool
- fromWkt(self, wkt: str) bool ¶
- Parameters
wkt (str) –
- Return type
bool
- geometryN(self, n: int) QgsAbstractGeometry ¶
Returns a geometry from within the collection.
- Parameters
n (int) – index of geometry to return.
:raises IndexError if no geometry with the specified index exists.
- Return type
- geometryType(self) str ¶
- Return type
str
- hasChildGeometries(self) bool ¶
Returns whether the geometry has any child geometries (
False
for point / curve,True
otherwise)Note
used for vertex_iterator implementation
New in version 3.0.
- hasCurvedSegments(self) bool ¶
- Return type
bool
- insertGeometry(self, g: QgsAbstractGeometry, index: int) bool ¶
Inserts a geometry before a specified index and takes ownership. Returns
True
in case of success.- Parameters
g (QgsAbstractGeometry) – geometry to insert. Ownership is transferred to the collection.
index (int) – position to insert geometry before
- Return type
bool
- insertVertex(self, position: QgsVertexId, vertex: QgsPoint) bool ¶
- Parameters
position (QgsVertexId) –
vertex (QgsPoint) –
- Return type
bool
- isEmpty(self) bool ¶
- Return type
bool
- isValid(self, flags: int = 0) Tuple[bool, str] ¶
- Parameters
flags (int = 0) –
- Return type
Tuple[bool, str]
- length(self) float ¶
- Return type
float
- moveVertex(self, position: QgsVertexId, newPos: QgsPoint) bool ¶
- Parameters
position (QgsVertexId) –
newPos (QgsPoint) –
- Return type
bool
- nCoordinates(self) int ¶
- Return type
int
- nextVertex(self, id: QgsVertexId) Tuple[bool, QgsPoint] ¶
- Parameters
id (QgsVertexId) –
- Return type
Tuple[bool, QgsPoint]
- normalize(self)¶
- numGeometries(self) int ¶
Returns the number of geometries within the collection.
- Return type
int
- partCount(self) int ¶
- Return type
int
- perimeter(self) float ¶
- Return type
float
- removeDuplicateNodes(self, epsilon: float = 4 * DBL_EPSILON, useZValues: bool = False) bool ¶
- Parameters
epsilon (float = 4*DBL_EPSILON) –
useZValues (bool = False) –
- Return type
bool
- removeGeometry(self, nr: int) bool ¶
Removes a geometry from the collection by index.
- Return type
bool
- Returns
True
if removal was successful.
:raises IndexError if no geometry with the specified index exists.
- Parameters
nr (int) –
- reserve(self, size: int)¶
Attempts to allocate memory for at least
size
geometries.If the number of geometries is known in advance, calling this function prior to adding geometries will prevent reallocations and memory fragmentation.
New in version 3.10.
- Parameters
size (int) –
- ringCount(self, part: int = 0) int ¶
- Parameters
part (int = 0) –
- Return type
int
- segmentLength(self, startVertex: QgsVertexId) float ¶
- Parameters
startVertex (QgsVertexId) –
- Return type
float
- segmentize(self, tolerance: float = M_PI_2 / 90, toleranceType: QgsAbstractGeometry.SegmentationToleranceType = QgsAbstractGeometry.MaximumAngle) QgsAbstractGeometry ¶
Returns a geometry without curves. Caller takes ownership
- Parameters
tolerance (float = M_PI_2/90) – segmentation tolerance
toleranceType (QgsAbstractGeometry.SegmentationToleranceType = QgsAbstractGeometry.MaximumAngle) – maximum segmentation angle or maximum difference between approximation and curve
- Return type
- setZMTypeFromSubGeometry(self, subggeom: QgsAbstractGeometry, baseGeomType: QgsWkbTypes.Type)¶
Updates the geometry type based on whether sub geometries contain z or m values.
- simplifiedTypeRef(self) QgsAbstractGeometry ¶
- Return type
- snappedToGrid(self, hSpacing: float, vSpacing: float, dSpacing: float = 0, mSpacing: float = 0) QgsGeometryCollection ¶
- Parameters
hSpacing (float) –
vSpacing (float) –
dSpacing (float = 0) –
mSpacing (float = 0) –
- Return type
- sortIndex(self) int ¶
Returns the sort index for the geometry, used in the
compareTo()
method to compare geometries of different types.New in version 3.20.
- swapXy(self)¶
- toCurveType(self) QgsGeometryCollection ¶
- Return type
- transform(self, ct: QgsCoordinateTransform, d: QgsCoordinateTransform.TransformDirection = QgsCoordinateTransform.ForwardTransform, transformZ: bool = False)¶
- transform(self, t: QTransform, zTranslate: float = 0, zScale: float = 1, mTranslate: float = 0, mScale: float = 1) None
- transform(self, transformer: QgsAbstractGeometryTransformer, feedback: QgsFeedback = None) bool
- Parameters
ct (QgsCoordinateTransform) –
d (QgsCoordinateTransform.TransformDirection = QgsCoordinateTransform.ForwardTransform) –
transformZ (bool = False) –
- vertexAngle(self, vertex: QgsVertexId) float ¶
- Parameters
vertex (QgsVertexId) –
- Return type
float
- vertexAt(self, id: QgsVertexId) QgsPoint ¶
- Parameters
id (QgsVertexId) –
- Return type
- vertexCount(self, part: int = 0, ring: int = 0) int ¶
- Parameters
part (int = 0) –
ring (int = 0) –
- Return type
int
- vertexNumberFromVertexId(self, id: QgsVertexId) int ¶
- Parameters
id (QgsVertexId) –
- Return type
int
- wkbSize(self, flags: Union[QgsAbstractGeometry.WkbFlags, QgsAbstractGeometry.WkbFlag] = QgsAbstractGeometry.WkbFlags()) int ¶
- Parameters
flags (Union[QgsAbstractGeometry.WkbFlags) –
- Return type
int
- wktOmitChildType(self) bool ¶
Returns whether child type names are omitted from Wkt representations of the collection
New in version 2.12.
- Return type
bool