Class: QgsMultiLineString

class qgis.core.QgsMultiLineString

Bases: QgsMultiCurve

Multi line string geometry collection.

Added in version 2.10.

QgsMultiLineString() Constructor for an empty multilinestring geometry.

QgsMultiLineString(a0: QgsMultiLineString)

Methods

addGeometry

param g:

asGml2

param doc:

asGml3

param doc:

calculateBoundingBox

Default calculator for the minimal bounding box for the geometry.

calculateBoundingBox3D

childCount

childGeometry

childPoint

Returns point at index (for geometries without child geometries - i.e. curve / point).

clear

clearCache

clone

rtype:

Optional[QgsMultiLineString]

compareToSameClass

createEmptyWithSameType

rtype:

Optional[QgsMultiLineString]

fromCollectionWkt

Reads a collection from a WKT string.

fromWkt

param wkt:

geometryType

rtype:

str

hasChildGeometries

Returns whether the geometry has any child geometries (False for point / curve, True otherwise)

insertGeometry

param g:

lineStringN

Returns the line string with the specified index.

setZMTypeFromSubGeometry

Updates the geometry type based on whether sub geometries contain z or m values.

sortIndex

Returns the sort index for the geometry, used in the compareTo() method to compare geometries of different types.

toCurveType

Returns the geometry converted to the more generic curve type QgsMultiCurve

wktOmitChildType

rtype:

bool

addGeometry(self, g: QgsAbstractGeometry | None) bool
Parameters:

g (Optional[QgsAbstractGeometry])

Return type:

bool

asGml2(self, doc: QDomDocument, precision: int = 17, ns: str | None = '', axisOrder: QgsAbstractGeometry.AxisOrder = QgsAbstractGeometry.AxisOrder.XY) QDomElement
Parameters:
  • doc (QDomDocument)

  • precision (int = 17)

  • ns (Optional[str] = '')

  • axisOrder (QgsAbstractGeometry.AxisOrder = QgsAbstractGeometry.AxisOrder.XY)

Return type:

QDomElement

asGml3(self, doc: QDomDocument, precision: int = 17, ns: str | None = '', axisOrder: QgsAbstractGeometry.AxisOrder = QgsAbstractGeometry.AxisOrder.XY) QDomElement
Parameters:
  • doc (QDomDocument)

  • precision (int = 17)

  • ns (Optional[str] = '')

  • axisOrder (QgsAbstractGeometry.AxisOrder = QgsAbstractGeometry.AxisOrder.XY)

Return type:

QDomElement

calculateBoundingBox(self) QgsRectangle

Default calculator for the minimal bounding box for the geometry. Derived classes should override this method if a more efficient bounding box calculation is available.

calculateBoundingBox3D(self) QgsBox3D
childCount(self) int
childGeometry(self, index: int) QgsAbstractGeometry | None
childPoint(self, index: int) QgsPoint

Returns point at index (for geometries without child geometries - i.e. curve / point)

Note

used for vertex_iterator implementation

Added in version 3.0.

clear(self)
clearCache(self)
clone(self) QgsMultiLineString | None
Return type:

Optional[QgsMultiLineString]

compareToSameClass(self, other: QgsAbstractGeometry | None) int
createEmptyWithSameType(self) QgsMultiLineString | None
Return type:

Optional[QgsMultiLineString]

fromCollectionWkt(self, wkt: str | None, subtypes: Iterable[QgsAbstractGeometry], defaultChildWkbType: str | None = '') bool

Reads a collection from a WKT string.

fromWkt(self, wkt: str | None) bool
Parameters:

wkt (Optional[str])

Return type:

bool

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

Added in version 3.0.

insertGeometry(self, g: QgsAbstractGeometry | None, index: int) bool
Parameters:
Return type:

bool

lineStringN(self, index: int) QgsLineString

Returns the line string with the specified index.

Raises:

IndexError – if no line string with the specified index exists.

Added in version 3.16.

Parameters:

index (int)

Return type:

QgsLineString

setZMTypeFromSubGeometry(self, subggeom: QgsAbstractGeometry | None, baseGeomType: Qgis.WkbType)

Updates the geometry type based on whether sub geometries contain z or m values.

sortIndex(self) int

Returns the sort index for the geometry, used in the compareTo() method to compare geometries of different types.

Added in version 3.20.

toCurveType(self) QgsMultiCurve | None

Returns the geometry converted to the more generic curve type QgsMultiCurve

Return type:

Optional[QgsMultiCurve]

Returns:

the converted geometry. Caller takes ownership

wktOmitChildType(self) bool
Return type:

bool