TfLogisticDecay

汇总

定义一个逻辑衰减变换函数，该函数是根据最大值、最小值和 y 截距百分比这三个形状控制参数，以及确定函数应用范围的阈值上限和下限确定的。

了解有关各参数对此变换函数作用的详细信息

讨论

使用 TfLogisticDecay 对象的工具为 按函数重设等级 。

函数值的范围为从 0 到 100，此范围随后将转换为评估等级。

如果设置的 minimum 参数大于 lowerThreshold 值，或者设置的 maximum 参数小于 upperThreshold 值，则函数曲线将以较快速率下降。如果设置的 minimum 参数小于 lowerThreshold 值，或者设置的 maximum 参数大于 upperThreshold 值，则函数曲线将以较慢速率下降。

语法

TfLogisticDecay({minimum}, {maximum}, {yInterceptPercent}, {lowerThreshold}, {valueBelowThreshold}, {upperThreshold}, {valueAboveThreshold})

名称	说明	数据类型
minimum （可选）	逻辑衰减变换函数的起点。 最小值必须小于最大值。 (默认值为 None)	Double
maximum （可选）	逻辑衰减变换函数的终点。 最小值必须小于最大值。 (默认值为 None)	Double
yInterceptPercent （可选）	确定逻辑衰减曲线的下降部分的取值范围。 yinterceptPercent 越大，曲线衰减部分的输入值范围就越小，但输入值对应的优先级会加速下降。 yinterceptPercent 越大，逻辑衰减曲线越明显。 yInterceptPercent 必须介于 50 和 100 之间。 (默认值为 99.0)	Double
lowerThreshold （可选）	定义开始应用指定变换函数的起始值。在输出栅格上与 lowerThreshold 对应的输入值将分配到 自等级 评估等级值。低于 lowerThreshold 的输入值将分配到 valueBelowThreshold ，并且不会计入函数值范围。 lowerThreshold 必须小于 upperThreshold 。 (默认值为 None)	Double
valueBelowThreshold （可选）	此用户定义的值用于分配输入值小于 lowerThreshold 的输出像元位置。 valueBelowThreshold 的值可以为浮点数、整数或 NoData 。在工具对话框内， NoData 左右不使用引号；但在编写脚本时需要使用引号，即 "NoData" 。 (默认值为 None)	Variant
upperThreshold （可选）	定义终止应用指定变换函数的结束值。在输出栅格上与 upperThreshold 对应的输入值将分配到 至等级 评估等级值。高于 upperThreshold 的输入值将分配到 valueAboveThreshold ，并且不会计入函数值范围。 lowerThreshold 必须小于 upperThreshold 。 (默认值为 None)	Double
valueAboveThreshold （可选）	此用户定义的值用于分配输入值大于 upperThreshold 的输出像元位置。 valueAboveThreshold 的值可以为浮点数、整数或 NoData 。在工具对话框内， NoData 左右不使用引号；但在编写脚本时需要使用引号，即 "NoData" 。 (默认值为 None)	Variant

属性

名称	说明	数据类型
minimum （读取和写入）	变换函数的 最小值 ，用于定义函数的起点。	Double
maximum （读取和写入）	变换函数的 最大值 ，用于定义函数的终点。	Double
yInterceptPercent （读取和写入）	变换函数的 y 截距百分比 值，用于确定逻辑衰减曲线中处于下降部分的值范围。	Double
lowerThreshold （读取和写入）	变换函数的 lowerThreshold 的值，用于定义开始应用指定变换函数的起始值。	Double
valueBelowThreshold （读取和写入）	输入值低于 lowerThreshold 的值将被分配到输出像元。	Variant
upperThreshold （读取和写入）	变换函数的 upperThreshold 值，用于定义停止应用指定函数的终止值。	Double
valueAboveThreshold （读取和写入）	输入值高于 upperThreshold 的值将被分配到输出像元。	Variant

代码示例

逻辑衰减变换函数示例 1（Python 窗口）

演示如何创建 TfLogisticDecay 类以及如何在 Python 窗口的 RescaleByFunction 工具中使用该类。

import arcpy
from arcpy.sa import *
from arcpy import env
env.workspace = "c:/sapyexamples/data"
outRescale = RescaleByFunction("elevation", TfLogisticDecay(421, 4450, 75, "#", "#", "#", "#"), 1, 10)
outRescale.save("c:/sapyexamples/rescaletfld1")

逻辑衰减变换函数示例 2（独立脚本）

演示如何通过 TfLogisticDecay 类在 RescaleByFunction 工具中转换输入数据。

# Name: TfLogisticDecay_Ex_02.py
# Description: Rescales input raster data using a LogisticDecay function and
#     transforms the function values onto a specified evaluation scale.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"

# Create the TfLogisticDecay object
minimum = 421
maximum = 4450
yintercept = 75
lowerthresh = "#"
valbelowthresh = "#"
upperthresh = "#"
valabovethresh = "#"
myTfFunction = TfLogisticDecay(minimum, maximum, yintercept, lowerthresh, valbelowthresh, upperthresh, valabovethresh)

# Set evaluation scale
fromscale = 1
toscale = 10

# Run RescaleByFunction
outRescale = RescaleByFunction(inRaster, myTfFunction, fromscale, toscale)

# Save the output
outRescale.save("c:/sapyexamples/rescaletfld2")

相关主题

• Spatial Analyst 类概述
• 变换类概述