需要 Spatial Analyst 许可。
摘要
定义一个逻辑衰减变换函数，该函数是根据最大值、最小值和 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
# Author: esri
# 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
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute RescaleByFunction
outRescale = RescaleByFunction(inRaster, myTfFunction, fromscale, toscale)
# Save the output
outRescale.save("c:/sapyexamples/rescaletfld2")