Class: QgsLayoutAtlas

Used to render QgsLayout as an atlas, by iterating over the features from an associated vector layer.

QgsLayoutAtlas implement the QgsAbstractLayoutIterator interface, allowing them to be used directly with QgsLayoutExporter to automatically output all pages from the atlas.

For QgsPrintLayout layouts, it is not necessary to manually construct a QgsLayoutAtlas object. Instead, the atlas attached to the print layout should be used. This can be retrieved by calling QgsPrintLayout.atlas().

Class Hierarchy

Base classes

QObject
QgsAbstractLayoutIterator	An abstract base class for QgsLayout based classes which can be exported by QgsLayoutExporter.
QgsLayoutSerializableObject	An interface for layout objects which can be stored and read from DOM elements.
QgsLayoutUndoObjectInterface	Interface for layout objects which support undo/redo commands.
QgsExpressionContextGenerator	Abstract interface for generating an expression context.

class qgis.core.QgsLayoutAtlas

Bases: QObject, QgsAbstractLayoutIterator, QgsLayoutSerializableObject, QgsExpressionContextGenerator

__init__(layout: QgsLayout | None)

Constructor for new QgsLayoutAtlas.

Parameters:

layout (Optional[QgsLayout])

signal changed

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

coverageLayer(self) → QgsVectorLayer | None

Returns the coverage layer used for the atlas features.

See also

setCoverageLayer()

Return type:

Optional[QgsVectorLayer]

signal coverageLayerChanged

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

currentFeatureNumber(self) → int

Returns the current feature number, where a value of 0 corresponds to the first feature.

Return type:

int

currentFilename(self) → str

Returns the current feature filename.

See also

filenameExpression()

See also

setFilenameExpression()

Return type:

str

enabled(self) → bool

Returns whether the atlas generation is enabled

See also

setEnabled()

Return type:

bool

signal featureChanged

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

filenameExpression(self) → str

Returns the filename expression used for generating output filenames for each atlas page.

See also

setFilenameExpression()

See also

currentFilename()

Return type:

str

filterExpression(self) → str

Returns the expression used for filtering features in the coverage layer.

This property has no effect is filterFeatures() is False.

See also

setFilterExpression()

See also

filterFeatures()

Return type:

str

filterFeatures(self) → bool

Returns True if features should be filtered in the coverage layer.

See also

filterExpression()

See also

setFilterExpression()

Return type:

bool

first(self) → bool

Seeks to the first feature, returning False if no feature was found.

See also

next()

See also

previous()

See also

last()

See also

seekTo()

Return type:

bool

hideCoverage(self) → bool

Returns True if the atlas is set to hide the coverage layer.

See also

setHideCoverage()

Return type:

bool

last(self) → bool

Seeks to the last feature, returning False if no feature was found.

See also

next()

See also

previous()

See also

first()

See also

seekTo()

Return type:

bool

limitCoverageLayerRenderToCurrentFeature(self) → bool

Returns True if the atlas is set to limit rendering on the coverage layer to the current feature.

See also

setHideCoverage()

Added in version 4.0.

Return type:

bool

signal messagePushed

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

nameForPage(self, page: int) → str

Returns the calculated name for a specified atlas page number. Page numbers start at 0.

See also

pageNameExpression()

Parameters:

page (int)

Return type:

str

signal numberFeaturesChanged

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

pageNameExpression(self) → str

Returns the expression (or field name) used for calculating the page name.

See also

setPageNameExpression()

See also

nameForPage()

Return type:

str

previous(self) → bool

Iterates to the previous feature, returning False if no previous feature exists.

See also

next()

See also

last()

See also

first()

See also

seekTo()

Return type:

bool

refreshCurrentFeature(self)

Refreshes the current atlas feature, by refetching its attributes from the vector layer provider

signal renderBegun

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

signal renderEnded

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

seekTo(self, feature: int) → bool

Seeks to the specified feature number.

See also

first()

See also

previous()

See also

next()

See also

last()

seekTo(self, feature: QgsFeature) -> bool Seeks to the specified feature.

See also

first()

See also

previous()

See also

next()

See also

last()

Parameters:

feature (int)

Return type:

bool

setCoverageLayer(self, layer: QgsVectorLayer | None)

Sets the coverage layer to use for the atlas features.

See also

coverageLayer()

Parameters:

layer (Optional[QgsVectorLayer])

setEnabled(self, enabled: bool)

Sets whether the atlas is enabled.

See also

enabled()

Parameters:

enabled (bool)

setFilenameExpression(self, expression: str | None)

Sets the filename expression used for generating output filenames for each atlas page. If an invalid expression is passed, False will be returned and errorString will be set to the expression error.

See also

filenameExpression()

See also

currentFilename()

Parameters:

expression (Optional[str]) -> (bool)

setFilterExpression(self, expression: str | None)

Sets the expression used for filtering features in the coverage layer.

This property has no effect is filterFeatures() is False.

If an invalid expression is passed, False will be returned and errorString will be set to the expression error.

See also

filterExpression()

See also

setFilterFeatures()

Parameters:

expression (Optional[str]) -> (bool)

setFilterFeatures(self, filtered: bool)

Sets whether features should be filtered in the coverage layer.

See also

filterFeatures()

See also

setFilterExpression()

Parameters:

filtered (bool)

setHideCoverage(self, hide: bool)

Sets whether the coverage layer should be hidden in map items in the layouts.

See also

hideCoverage()

Parameters:

hide (bool)

setLimitCoverageLayerRenderToCurrentFeature(self, limit: bool)

Sets whether the rendering of the coverage layer should be limited to the current feature.

See also

hideCoverage()

Added in version 4.0.

Parameters:

limit (bool)

setPageNameExpression(self, expression: str | None)

Sets the expression (or field name) used for calculating the page name.

See also

pageNameExpression()

Parameters:

expression (Optional[str])

setSortAscending(self, ascending: bool)

Sets whether features should be sorted in an ascending order.

This property has no effect is sortFeatures() is False.

See also

setSortFeatures()

See also

sortAscending()

See also

setSortExpression()

Parameters:

ascending (bool)

setSortExpression(self, expression: str | None)

Sets the expression (or field name) to use for sorting features.

This property has no effect is sortFeatures() is False.

See also

setSortFeatures()

See also

setSortAscending()

See also

sortExpression()

Parameters:

expression (Optional[str])

setSortFeatures(self, enabled: bool)

Sets whether features should be sorted in the atlas.

See also

sortFeatures()

See also

setSortAscending()

See also

setSortExpression()

Parameters:

enabled (bool)

sortAscending(self) → bool

Returns True if features should be sorted in an ascending order.

This property has no effect is sortFeatures() is False.

See also

sortFeatures()

See also

setSortAscending()

See also

sortExpression()

Return type:

bool

sortExpression(self) → str

Returns the expression (or field name) to use for sorting features.

This property has no effect is sortFeatures() is False.

See also

sortFeatures()

See also

sortAscending()

See also

setSortExpression()

Return type:

str

sortFeatures(self) → bool

Returns True if features should be sorted in the atlas.

See also

setSortFeatures()

See also

sortAscending()

See also

sortExpression()

Return type:

bool

signal toggled

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

updateFeatures(self) → int

Requeries the current atlas coverage layer and applies filtering and sorting. Returns number of matching features.

Return type:

int