R语言 RSAGA包 wind.shelter()函数中文帮助文档(中英文对照)

loveR

wind.shelter(RSAGA)
wind.shelter()所属R语言包：RSAGA

                                        Wind Shelter Index
                                         避风指数

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

wind.shelter is a function to be used with  focal.function to calculate a topographic wind shelter index from a digital elevation model, which is a proxy for  snow accumulation on the lee side of topographic obstacles. wind.shelter.prep performs some preparatory
wind.shelter是一个函数被使用focal.function计算的地形避风指数从数字高程模型，这是一个代理的背风面地形障碍的雪积累。 wind.shelter.prep进行了一些准备


用法----------Usage----------


wind.shelter(x, prob = NULL, control)
wind.shelter.prep(radius, direction, tolerance, cellsize = 90)



参数----------Arguments----------

参数：x
square matrix of elevation data
方阵高程数据


参数：prob
numeric: quantile of slope values to be used in computing the wind shelter index; if NULL, use max (equivalent to  prob=1)
数字位数的斜率值被用于计算避风指数;如果NULL，使用max（相当于prob=1）


参数：control
required argument: the result of a call to wind.shelter.prep
必需的参数：调用wind.shelter.prep的结果


参数：radius
radius (>1) of circle segment to be used (number of grid cells, not necessarily an integer)
要使用的圆弧半径（> 1）（的格子单元数，不一定是一个整数）


参数：direction
wind direction: direction from which the wind originates; North = 0 = 2*pi, clockwise angles.
风向：风从哪个方向;北= 0 =2*pi，顺时针旋转的角度。


参数：tolerance
directional tolerance
定向公差


参数：cellsize
grid cellsize
格CELLSIZE


Details

详细信息----------Details----------

wind.shelter implements a wind shelter index used by Plattner et al. (2004) for modeling snow accumulation patterns on a glacier in the Austrian Alps. It is a modified version of the algorithm of Winstral et al. (2002). The wind shelter index of Plattner et al. (2004) is defined as:
wind.shelter实现了一个避风的使用由普拉特纳等人指数。 （2004）模型在奥地利阿尔卑斯山冰川上的雪积累模式。这是一个修改版本的Winstral等人的算法。 （2002年）。避风指数的普拉特纳等。 （2004）被定义为：

Shelter index(S) = arctan( max( (z(x0)-z(x)) / |x0-x| : x in S ) ),
Shelter index(S) = arctan( max( (z(x0)-z(x)) / |x0-x| : x in S ) ),

where S = S(x0,a,da,d) is the set of grid nodes within a distance <=d from x0, only considering grid nodes in directions between a-da and a+da from x0.
其中S = S(x0,a,da,d)是网格节点的距离内<=dx0，只考虑方向在a-da和a+da之间的网格节点x0 。

The present implementation generalizes this index by replacing max by the quantile function; the max function is used if prob=NULL, and the same result is obtained
本实施推广该指数取代maxquantile函数;max的函数时使用prob=NULL，并得到同样的结果


值----------Value----------

The function wind.shelter returns the wind shelter index as described above if a numeric matrix x is provided. If it is missing, it returns the character string "windshelter".
的功能wind.shelter返回避风指数的，如果上述提供一个数字矩阵x。如果丢失，则返回的字符串"windshelter"。

wind.shelter.prep returns a list with components mask and dist. Both are square matrices with 2*(ceiling(radius)+1) columns and rows:
wind.shelter.prep返回一个列表的组件mask和dist。 2*(ceiling(radius)+1)列和行的方阵：


参数：mask
indicates which grid cell in the moving window is within the specified circle segment (value FALSE) or not (TRUE)
网格单元格中移动窗口内指定的圆弧（价值FALSE）或不（TRUE）


参数：dist
the precomputed distances of a grid cell to the center of the moving window, in map units
预先计算的距离的网格单元的移动窗口的中心，在图中的单位


注意----------Note----------

The wind shelter index only makes sense if elevation is measured in the same units as the horizontal map units used for the cellsize argument (i.e. usually meters).
避风指数才有意义，如果高程测量在相同的单位使用的图单位的cellsize参数（即通常米）的水平。

wind.shelter and wind.shelter.prep do not restrict the calculation onto a circular area; this is done by focal.function when used in combination with that function (assuming search.mode="circle").
wind.shelter和wind.shelter.prep不限制计算的圆形区域上，这是通过focal.function在组合使用时，与该功能（假设search.mode="circle"）。

Note that the present definition of the wind shelter index returns negative values for surfaces that are completely exposed toward the specified direction. This may make sense if interpreted as a "wind exposure index",
需要注意的是，目前的定义的避风指数返回负值，向指定的方向完全暴露的表面。这可能是有意义的，如果解释为“风曝光指数”，


（作者）----------Author(s)----------


Alexander Brenning



参考文献----------References----------

Spatial variability of snow accumulation on Vernagtferner, Austrian Alps, in winter 2003/2004. Zeitschrift fuer Gletscherkunde und Glazialgeologie, 39: 43-57.
Spatial snow modeling of wind-redistributed snow using terrain-based parameters. Journal of Hydrometeorology, 3: 524-538.

参见----------See Also----------

focal.function, quantile
focal.function，quantile


实例----------Examples----------


# Settings used by Plattner et al. (2004):[普拉特纳等使用的设置。 （2004）：]
ctrl = wind.shelter.prep(6,-pi/4,pi/12,10)
## Not run: focal.function("dem.asc",fun=wind.shelter,control=ctrl,[＃不运行：focal.function（的“dem.asc”，乐趣= wind.shelter，控制= CTRL]
    radius=6,search.mode="circle")
## End(Not run)[＃（不执行）]

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。