mirror of
https://github.com/qgis/QGIS.git
synced 2025-04-21 00:03:05 -04:00
6a2625664e
This is a subclass of QgsProcessingParameterNumber, but specifically for numeric parameters which represent distances. It is linked to a parent parameter, from which the distance unit will be determined, and is shown using a dedicated distance widget within the processing parameters panel. This widget shows the distance unit. This avoids the confusion when running algorithms which use distances where the unit depends on a layer or CRS parameter - e.g. the distance parameter in the buffer algorithm gives the distance in layer units... so now we can show those units directly within the dialog. Hopefully this leads to less user confusion and accidental "1000 degree buffers"! Additionally - if the unit is in degrees, a small warning icon is shown next to the parameter. The tooltip for this icon advises users to reproject data into a suitable projected local coordinate system. Initially implemented for the native buffer and single sided buffer algorithm only - but more will be added. Fixes #16290
283 lines
11 KiB
Python
Executable File
283 lines
11 KiB
Python
Executable File
# -*- coding: utf-8 -*-
|
|
|
|
"""
|
|
***************************************************************************
|
|
NumberInputPanel.py
|
|
---------------------
|
|
Date : August 2012
|
|
Copyright : (C) 2012 by Victor Olaya
|
|
Email : volayaf at gmail dot com
|
|
***************************************************************************
|
|
* *
|
|
* This program is free software; you can redistribute it and/or modify *
|
|
* it under the terms of the GNU General Public License as published by *
|
|
* the Free Software Foundation; either version 2 of the License, or *
|
|
* (at your option) any later version. *
|
|
* *
|
|
***************************************************************************
|
|
"""
|
|
|
|
__author__ = 'Victor Olaya'
|
|
__date__ = 'August 2012'
|
|
__copyright__ = '(C) 2012, Victor Olaya'
|
|
|
|
# This will get replaced with a git SHA1 when you do a git archive
|
|
|
|
__revision__ = '$Format:%H$'
|
|
|
|
import os
|
|
import math
|
|
import sip
|
|
|
|
from qgis.PyQt import uic
|
|
from qgis.PyQt.QtCore import pyqtSignal, QSize
|
|
from qgis.PyQt.QtWidgets import QDialog, QLabel
|
|
|
|
from qgis.core import (QgsApplication,
|
|
QgsExpression,
|
|
QgsProperty,
|
|
QgsUnitTypes,
|
|
QgsMapLayer,
|
|
QgsCoordinateReferenceSystem,
|
|
QgsProcessingParameterNumber,
|
|
QgsProcessingOutputNumber,
|
|
QgsProcessingParameterDefinition,
|
|
QgsProcessingModelChildParameterSource,
|
|
QgsProcessingFeatureSourceDefinition,
|
|
QgsProcessingUtils)
|
|
from qgis.gui import QgsExpressionBuilderDialog
|
|
from processing.tools.dataobjects import createExpressionContext, createContext
|
|
|
|
pluginPath = os.path.split(os.path.dirname(__file__))[0]
|
|
NUMBER_WIDGET, NUMBER_BASE = uic.loadUiType(
|
|
os.path.join(pluginPath, 'ui', 'widgetNumberSelector.ui'))
|
|
WIDGET, BASE = uic.loadUiType(
|
|
os.path.join(pluginPath, 'ui', 'widgetBaseSelector.ui'))
|
|
|
|
|
|
class ModelerNumberInputPanel(BASE, WIDGET):
|
|
|
|
"""
|
|
Number input panel for use inside the modeler - this input panel
|
|
is based off the base input panel and includes a text based line input
|
|
for entering values. This allows expressions and other non-numeric
|
|
values to be set, which are later evalauted to numbers when the model
|
|
is run.
|
|
"""
|
|
|
|
hasChanged = pyqtSignal()
|
|
|
|
def __init__(self, param, modelParametersDialog):
|
|
super().__init__(None)
|
|
self.setupUi(self)
|
|
|
|
self.param = param
|
|
self.modelParametersDialog = modelParametersDialog
|
|
if param.defaultValue():
|
|
self.setValue(param.defaultValue())
|
|
self.btnSelect.clicked.connect(self.showExpressionsBuilder)
|
|
self.leText.textChanged.connect(lambda: self.hasChanged.emit())
|
|
|
|
def showExpressionsBuilder(self):
|
|
context = createExpressionContext()
|
|
processing_context = createContext()
|
|
scope = self.modelParametersDialog.model.createExpressionContextScopeForChildAlgorithm(self.modelParametersDialog.childId, processing_context)
|
|
context.appendScope(scope)
|
|
|
|
highlighted = scope.variableNames()
|
|
context.setHighlightedVariables(highlighted)
|
|
|
|
dlg = QgsExpressionBuilderDialog(None, str(self.leText.text()), self, 'generic', context)
|
|
|
|
dlg.setWindowTitle(self.tr('Expression Based Input'))
|
|
if dlg.exec_() == QDialog.Accepted:
|
|
exp = QgsExpression(dlg.expressionText())
|
|
if not exp.hasParserError():
|
|
self.setValue(dlg.expressionText())
|
|
|
|
def getValue(self):
|
|
value = self.leText.text()
|
|
for param in self.modelParametersDialog.model.parameterDefinitions():
|
|
if isinstance(param, QgsProcessingParameterNumber):
|
|
if "@" + param.name() == value.strip():
|
|
return QgsProcessingModelChildParameterSource.fromModelParameter(param.name())
|
|
|
|
for alg in list(self.modelParametersDialog.model.childAlgorithms().values()):
|
|
for out in alg.algorithm().outputDefinitions():
|
|
if isinstance(out, QgsProcessingOutputNumber) and "@%s_%s" % (alg.childId(), out.name()) == value.strip():
|
|
return QgsProcessingModelChildParameterSource.fromChildOutput(alg.childId(), out.outputName())
|
|
|
|
try:
|
|
return float(value.strip())
|
|
except:
|
|
return QgsProcessingModelChildParameterSource.fromExpression(self.leText.text())
|
|
|
|
def setValue(self, value):
|
|
if isinstance(value, QgsProcessingModelChildParameterSource):
|
|
if value.source() == QgsProcessingModelChildParameterSource.ModelParameter:
|
|
self.leText.setText('@' + value.parameterName())
|
|
elif value.source() == QgsProcessingModelChildParameterSource.ChildOutput:
|
|
name = "%s_%s" % (value.outputChildId(), value.outputName())
|
|
self.leText.setText(name)
|
|
elif value.source() == QgsProcessingModelChildParameterSource.Expression:
|
|
self.leText.setText(value.expression())
|
|
else:
|
|
self.leText.setText(str(value.staticValue()))
|
|
else:
|
|
self.leText.setText(str(value))
|
|
|
|
|
|
class NumberInputPanel(NUMBER_BASE, NUMBER_WIDGET):
|
|
|
|
"""
|
|
Number input panel for use outside the modeler - this input panel
|
|
contains a user friendly spin box for entering values.
|
|
"""
|
|
|
|
hasChanged = pyqtSignal()
|
|
|
|
def __init__(self, param):
|
|
super(NumberInputPanel, self).__init__(None)
|
|
self.setupUi(self)
|
|
|
|
self.spnValue.setExpressionsEnabled(True)
|
|
|
|
self.param = param
|
|
if self.param.dataType() == QgsProcessingParameterNumber.Integer:
|
|
self.spnValue.setDecimals(0)
|
|
else:
|
|
# Guess reasonable step value
|
|
if self.param.maximum() is not None and self.param.minimum() is not None:
|
|
try:
|
|
self.spnValue.setSingleStep(self.calculateStep(float(self.param.minimum()), float(self.param.maximum())))
|
|
except:
|
|
pass
|
|
|
|
if self.param.maximum() is not None:
|
|
self.spnValue.setMaximum(self.param.maximum())
|
|
else:
|
|
self.spnValue.setMaximum(999999999)
|
|
if self.param.minimum() is not None:
|
|
self.spnValue.setMinimum(self.param.minimum())
|
|
else:
|
|
self.spnValue.setMinimum(-999999999)
|
|
|
|
self.allowing_null = False
|
|
# set default value
|
|
if param.flags() & QgsProcessingParameterDefinition.FlagOptional:
|
|
self.spnValue.setShowClearButton(True)
|
|
min = self.spnValue.minimum() - 1
|
|
self.spnValue.setMinimum(min)
|
|
self.spnValue.setValue(min)
|
|
self.spnValue.setSpecialValueText(self.tr('Not set'))
|
|
self.allowing_null = True
|
|
|
|
if param.defaultValue() is not None:
|
|
self.setValue(param.defaultValue())
|
|
if not self.allowing_null:
|
|
try:
|
|
self.spnValue.setClearValue(float(param.defaultValue()))
|
|
except:
|
|
pass
|
|
elif self.param.minimum() is not None:
|
|
try:
|
|
self.setValue(float(self.param.minimum()))
|
|
if not self.allowing_null:
|
|
self.spnValue.setClearValue(float(self.param.minimum()))
|
|
except:
|
|
pass
|
|
elif not self.allowing_null:
|
|
self.setValue(0)
|
|
self.spnValue.setClearValue(0)
|
|
|
|
# we don't show the expression button outside of modeler
|
|
self.layout().removeWidget(self.btnSelect)
|
|
sip.delete(self.btnSelect)
|
|
self.btnSelect = None
|
|
|
|
if not self.param.isDynamic():
|
|
# only show data defined button for dynamic properties
|
|
self.layout().removeWidget(self.btnDataDefined)
|
|
sip.delete(self.btnDataDefined)
|
|
self.btnDataDefined = None
|
|
else:
|
|
self.btnDataDefined.init(0, QgsProperty(), self.param.dynamicPropertyDefinition())
|
|
self.btnDataDefined.registerEnabledWidget(self.spnValue, False)
|
|
|
|
self.spnValue.valueChanged.connect(lambda: self.hasChanged.emit())
|
|
|
|
def setDynamicLayer(self, layer):
|
|
try:
|
|
self.btnDataDefined.setVectorLayer(self.getLayerFromValue(layer))
|
|
except:
|
|
pass
|
|
|
|
def getLayerFromValue(self, value):
|
|
context = createContext()
|
|
if isinstance(value, QgsProcessingFeatureSourceDefinition):
|
|
value, ok = value.source.valueAsString(context.expressionContext())
|
|
if isinstance(value, str):
|
|
value = QgsProcessingUtils.mapLayerFromString(value, context)
|
|
return value
|
|
|
|
def getValue(self):
|
|
if self.btnDataDefined is not None and self.btnDataDefined.isActive():
|
|
return self.btnDataDefined.toProperty()
|
|
elif self.allowing_null and self.spnValue.value() == self.spnValue.minimum():
|
|
return None
|
|
else:
|
|
return self.spnValue.value()
|
|
|
|
def setValue(self, value):
|
|
try:
|
|
self.spnValue.setValue(float(value))
|
|
except:
|
|
return
|
|
|
|
def calculateStep(self, minimum, maximum):
|
|
value_range = maximum - minimum
|
|
if value_range <= 1.0:
|
|
step = value_range / 10.0
|
|
# round to 1 significant figrue
|
|
return round(step, -int(math.floor(math.log10(step))))
|
|
else:
|
|
return 1.0
|
|
|
|
|
|
class DistanceInputPanel(NumberInputPanel):
|
|
|
|
"""
|
|
Distance input panel for use outside the modeler - this input panel
|
|
contains a label showing the distance unit.
|
|
"""
|
|
|
|
def __init__(self, param):
|
|
super().__init__(param)
|
|
|
|
self.label = QLabel('')
|
|
label_margin = self.fontMetrics().width('X')
|
|
self.layout().insertSpacing(1, label_margin / 2)
|
|
self.layout().insertWidget(2, self.label)
|
|
self.layout().insertSpacing(3, label_margin / 2)
|
|
self.warning_label = QLabel()
|
|
icon = QgsApplication.getThemeIcon('mIconWarning.svg')
|
|
size = max(24, self.spnValue.height() * 0.5)
|
|
self.warning_label.setPixmap(icon.pixmap(icon.actualSize(QSize(size, size))))
|
|
self.warning_label.setToolTip(self.tr('Distance is in geographic degrees. Consider reprojecting to a projected local coordinate system for accurate results.'))
|
|
self.layout().insertWidget(4, self.warning_label)
|
|
self.layout().insertSpacing(5, label_margin)
|
|
self.setUnits(QgsUnitTypes.DistanceUnknownUnit)
|
|
|
|
def setUnits(self, units):
|
|
self.label.setText(QgsUnitTypes.toString(units))
|
|
self.warning_label.setVisible(units == QgsUnitTypes.DistanceDegrees)
|
|
|
|
def setUnitParameterValue(self, value):
|
|
units = QgsUnitTypes.DistanceUnknownUnit
|
|
layer = self.getLayerFromValue(value)
|
|
if isinstance(layer, QgsMapLayer):
|
|
units = layer.crs().mapUnits()
|
|
elif isinstance(value, QgsCoordinateReferenceSystem):
|
|
units = value.mapUnits()
|
|
self.setUnits(units)
|