mirror of
https://github.com/qgis/QGIS.git
synced 2025-10-11 00:04:09 -04:00
271 lines
9.5 KiB
Python
271 lines
9.5 KiB
Python
"""
|
|
***************************************************************************
|
|
hillshade.py
|
|
---------------------
|
|
Date : October 2013
|
|
Copyright : (C) 2013 by Alexander Bruy
|
|
Email : alexander dot bruy 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__ = "Alexander Bruy"
|
|
__date__ = "October 2013"
|
|
__copyright__ = "(C) 2013, Alexander Bruy"
|
|
|
|
import os
|
|
|
|
from qgis.core import (
|
|
QgsRasterFileWriter,
|
|
QgsProcessingException,
|
|
QgsProcessingParameterDefinition,
|
|
QgsProcessingParameterRasterLayer,
|
|
QgsProcessingParameterBand,
|
|
QgsProcessingParameterBoolean,
|
|
QgsProcessingParameterNumber,
|
|
QgsProcessingParameterString,
|
|
QgsProcessingParameterRasterDestination,
|
|
)
|
|
from processing.algs.gdal.GdalAlgorithm import GdalAlgorithm
|
|
from processing.algs.gdal.GdalUtils import GdalUtils
|
|
|
|
pluginPath = os.path.split(os.path.split(os.path.dirname(__file__))[0])[0]
|
|
|
|
|
|
class hillshade(GdalAlgorithm):
|
|
INPUT = "INPUT"
|
|
BAND = "BAND"
|
|
COMPUTE_EDGES = "COMPUTE_EDGES"
|
|
ZEVENBERGEN = "ZEVENBERGEN"
|
|
Z_FACTOR = "Z_FACTOR"
|
|
SCALE = "SCALE"
|
|
AZIMUTH = "AZIMUTH"
|
|
ALTITUDE = "ALTITUDE"
|
|
COMBINED = "COMBINED"
|
|
MULTIDIRECTIONAL = "MULTIDIRECTIONAL"
|
|
OPTIONS = "OPTIONS"
|
|
CREATION_OPTIONS = "CREATION_OPTIONS"
|
|
EXTRA = "EXTRA"
|
|
OUTPUT = "OUTPUT"
|
|
|
|
def __init__(self):
|
|
super().__init__()
|
|
|
|
def initAlgorithm(self, config=None):
|
|
self.addParameter(
|
|
QgsProcessingParameterRasterLayer(self.INPUT, self.tr("Input layer"))
|
|
)
|
|
self.addParameter(
|
|
QgsProcessingParameterBand(
|
|
self.BAND,
|
|
self.tr("Band number"),
|
|
1,
|
|
parentLayerParameterName=self.INPUT,
|
|
)
|
|
)
|
|
self.addParameter(
|
|
QgsProcessingParameterNumber(
|
|
self.Z_FACTOR,
|
|
self.tr("Z factor (vertical exaggeration)"),
|
|
type=QgsProcessingParameterNumber.Type.Double,
|
|
minValue=0.0,
|
|
defaultValue=1.0,
|
|
)
|
|
)
|
|
self.addParameter(
|
|
QgsProcessingParameterNumber(
|
|
self.SCALE,
|
|
self.tr("Scale (ratio of vertical units to horizontal)"),
|
|
type=QgsProcessingParameterNumber.Type.Double,
|
|
minValue=0.0,
|
|
defaultValue=1.0,
|
|
)
|
|
)
|
|
self.addParameter(
|
|
QgsProcessingParameterNumber(
|
|
self.AZIMUTH,
|
|
self.tr("Azimuth of the light"),
|
|
type=QgsProcessingParameterNumber.Type.Double,
|
|
minValue=0.0,
|
|
maxValue=360,
|
|
defaultValue=315.0,
|
|
)
|
|
)
|
|
self.addParameter(
|
|
QgsProcessingParameterNumber(
|
|
self.ALTITUDE,
|
|
self.tr("Altitude of the light"),
|
|
type=QgsProcessingParameterNumber.Type.Double,
|
|
minValue=0.0,
|
|
defaultValue=45.0,
|
|
)
|
|
)
|
|
self.addParameter(
|
|
QgsProcessingParameterBoolean(
|
|
self.COMPUTE_EDGES, self.tr("Compute edges"), defaultValue=False
|
|
)
|
|
)
|
|
self.addParameter(
|
|
QgsProcessingParameterBoolean(
|
|
self.ZEVENBERGEN,
|
|
self.tr("Use Zevenbergen&Thorne formula instead of the Horn's one"),
|
|
defaultValue=False,
|
|
)
|
|
)
|
|
self.addParameter(
|
|
QgsProcessingParameterBoolean(
|
|
self.COMBINED, self.tr("Combined shading"), defaultValue=False
|
|
)
|
|
)
|
|
self.addParameter(
|
|
QgsProcessingParameterBoolean(
|
|
self.MULTIDIRECTIONAL,
|
|
self.tr("Multidirectional shading"),
|
|
defaultValue=False,
|
|
)
|
|
)
|
|
|
|
# backwards compatibility parameter
|
|
# TODO QGIS 4: remove parameter and related logic
|
|
options_param = QgsProcessingParameterString(
|
|
self.OPTIONS,
|
|
self.tr("Additional creation options"),
|
|
defaultValue="",
|
|
optional=True,
|
|
)
|
|
options_param.setFlags(
|
|
options_param.flags() | QgsProcessingParameterDefinition.Flag.Hidden
|
|
)
|
|
options_param.setMetadata({"widget_wrapper": {"widget_type": "rasteroptions"}})
|
|
self.addParameter(options_param)
|
|
|
|
creation_options_param = QgsProcessingParameterString(
|
|
self.CREATION_OPTIONS,
|
|
self.tr("Additional creation options"),
|
|
defaultValue="",
|
|
optional=True,
|
|
)
|
|
creation_options_param.setFlags(
|
|
creation_options_param.flags()
|
|
| QgsProcessingParameterDefinition.Flag.FlagAdvanced
|
|
)
|
|
creation_options_param.setMetadata(
|
|
{"widget_wrapper": {"widget_type": "rasteroptions"}}
|
|
)
|
|
self.addParameter(creation_options_param)
|
|
|
|
extra_param = QgsProcessingParameterString(
|
|
self.EXTRA,
|
|
self.tr("Additional command-line parameters"),
|
|
defaultValue=None,
|
|
optional=True,
|
|
)
|
|
extra_param.setFlags(
|
|
extra_param.flags() | QgsProcessingParameterDefinition.Flag.FlagAdvanced
|
|
)
|
|
self.addParameter(extra_param)
|
|
|
|
self.addParameter(
|
|
QgsProcessingParameterRasterDestination(self.OUTPUT, self.tr("Hillshade"))
|
|
)
|
|
|
|
def name(self):
|
|
return "hillshade"
|
|
|
|
def displayName(self):
|
|
return self.tr("Hillshade")
|
|
|
|
def group(self):
|
|
return self.tr("Raster analysis")
|
|
|
|
def groupId(self):
|
|
return "rasteranalysis"
|
|
|
|
def commandName(self):
|
|
return "gdaldem"
|
|
|
|
def getConsoleCommands(self, parameters, context, feedback, executing=True):
|
|
arguments = ["hillshade"]
|
|
inLayer = self.parameterAsRasterLayer(parameters, self.INPUT, context)
|
|
if inLayer is None:
|
|
raise QgsProcessingException(
|
|
self.invalidRasterError(parameters, self.INPUT)
|
|
)
|
|
input_details = GdalUtils.gdal_connection_details_from_layer(inLayer)
|
|
|
|
arguments.append(input_details.connection_string)
|
|
|
|
out = self.parameterAsOutputLayer(parameters, self.OUTPUT, context)
|
|
self.setOutputValue(self.OUTPUT, out)
|
|
arguments.append(out)
|
|
|
|
output_format = QgsRasterFileWriter.driverForExtension(os.path.splitext(out)[1])
|
|
if not output_format:
|
|
raise QgsProcessingException(self.tr("Output format is invalid"))
|
|
|
|
arguments.append("-of")
|
|
arguments.append(output_format)
|
|
|
|
arguments.append("-b")
|
|
arguments.append(str(self.parameterAsInt(parameters, self.BAND, context)))
|
|
arguments.append("-z")
|
|
arguments.append(
|
|
str(self.parameterAsDouble(parameters, self.Z_FACTOR, context))
|
|
)
|
|
arguments.append("-s")
|
|
arguments.append(str(self.parameterAsDouble(parameters, self.SCALE, context)))
|
|
|
|
multidirectional = self.parameterAsBoolean(
|
|
parameters, self.MULTIDIRECTIONAL, context
|
|
)
|
|
# azimuth and multidirectional are mutually exclusive
|
|
if not multidirectional:
|
|
arguments.append("-az")
|
|
arguments.append(
|
|
str(self.parameterAsDouble(parameters, self.AZIMUTH, context))
|
|
)
|
|
|
|
arguments.append("-alt")
|
|
arguments.append(
|
|
str(self.parameterAsDouble(parameters, self.ALTITUDE, context))
|
|
)
|
|
|
|
if self.parameterAsBoolean(parameters, self.COMPUTE_EDGES, context):
|
|
arguments.append("-compute_edges")
|
|
|
|
if self.parameterAsBoolean(parameters, self.ZEVENBERGEN, context):
|
|
arguments.append("-alg")
|
|
arguments.append("ZevenbergenThorne")
|
|
|
|
combined = self.parameterAsBoolean(parameters, self.COMBINED, context)
|
|
if combined and not multidirectional:
|
|
arguments.append("-combined")
|
|
elif multidirectional and not combined:
|
|
arguments.append("-multidirectional")
|
|
elif multidirectional and combined:
|
|
raise QgsProcessingException(
|
|
self.tr("Options -multirectional and -combined are mutually exclusive.")
|
|
)
|
|
|
|
options = self.parameterAsString(parameters, self.CREATION_OPTIONS, context)
|
|
# handle backwards compatibility parameter OPTIONS
|
|
if self.OPTIONS in parameters and parameters[self.OPTIONS] not in (None, ""):
|
|
options = self.parameterAsString(parameters, self.OPTIONS, context)
|
|
if options:
|
|
arguments.extend(GdalUtils.parseCreationOptions(options))
|
|
|
|
if self.EXTRA in parameters and parameters[self.EXTRA] not in (None, ""):
|
|
extra = self.parameterAsString(parameters, self.EXTRA, context)
|
|
arguments.append(extra)
|
|
|
|
if input_details.credential_options:
|
|
arguments.extend(input_details.credential_options_as_arguments())
|
|
|
|
return [self.commandName(), GdalUtils.escapeAndJoin(arguments)]
|