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

loveR

rsaga.insolation(RSAGA)
rsaga.insolation()所属R语言包：RSAGA

                                        Incoming Solar Radiation (Insolation)
                                         入射的太阳辐射（日照）

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

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

This function calculates the amount of incoming solar radiation (insolation) depending on slope, aspect, and atmospheric properties. Module not available in SAGA GIS
此函数计算量的入射太阳辐射（日照）根据坡度，坡向和大气特性。在SAGA GIS模块不可用


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


rsaga.insolation(in.dem, in.vapour, in.latitude, in.longitude,
    out.direct, out.diffuse, out.total, horizontal = FALSE,
    solconst = 8.164, atmosphere = 12000, water.vapour.pressure = 10,
    type = c("moment", "day", "range.of.days", "same.moment.range.of.days"),
    time.step = 1, day.step = 5, days, moment, latitude, bending = FALSE,
    radius = 6366737.96, lat.offset = "user", lat.ref.user = 0,
    lon.offset = "center", lon.ref.user = 0, ...)



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

参数：in.dem
Name of input digital elevation model (DEM) grid in SAGA grid format (default extension: .sgrd)  
名称输入数字高程模型（DEM）在SAGA网格栅格式（默认扩展名：.sgrd）


参数：in.vapour
Optional input: SAGA grid file giving the water vapour pressure in mbar
可选的输入：SAGA网格文件，让水蒸汽压力毫巴


参数：in.latitude
Optional input: SAGA grid file giving for each pixel the latitude in degree
可选的输入：SAGA网格文件，给每个像素的纬度度


参数：in.longitude
Optional input: SAGA grid file giving for each pixel the longitude in degree
可选的输入：SAGA网格文件，给每个像素的经度度


参数：out.direct
Optional output grid file for direct insolation
可选的输出网格文件的直接暴晒


参数：out.diffuse
Optional output grid file for diffuse insolation
弥漫性日晒可选的输出网格文件


参数：out.total
Optional output grid file for total insolation, i.e. the sum of direct and diffuse insolation
可选的输出网格文件的总日照量，即直接和散射太阳辐射的总和


参数：horizontal
logical; project radiation onto a horizontal surface? (default: FALSE, i.e. use the actual inclined surface as a reference area)  
水平表面上的逻辑，项目辐射？ （默认：FALSE，即使用实际的倾斜面作为参考）


参数：solconst
solar constant in Joule; default: 8.164 J/cm2/min (=1360.7 kWh/m2; the more commonly used solar constant of 1367 kWh/m2 corresponds to 8.202 J/cm2/min)
太阳常数焦耳;默认：8.164 J/cm2/min（= 1360.7 kWh/m2比较常用的太阳常数的1367 kWh/m2对应8.202 J/cm2/min）


参数：atmosphere
height of atmosphere in m; default: 12000m
高度的大气中米;默认值：12000米


参数：water.vapour.pressure
if no water vapour grid is given, this argument specifies a constant water vapour pressure that is uniform in space; in mbar, default 10 mbar
如果没有水蒸汽网格，这个参数指定一个稳定的水蒸汽压力，在空间上是均匀的，默认为10毫巴毫巴


参数：type
type of time period: "moment" (equivalent: 0) for a single instant, "day" (or 1) for a single day, "range.of.days" (or 2), or "same.moment.range.of.days" (or 3) for the same moment in a range of days; default: "moment"  
类型的时间段："moment"（相当于：0）为一个单一的时刻，"day"（1）的单日，"range.of.days"（ 2），或"same.moment.range.of.days"（或3）的同一时刻，在一定范围内的天数;默认："moment"


参数：time.step
time resolution in hours for discretization within a day
时间分辨率的离散时间在一天之内


参数：day.step
time resolution in days for a range of days
时间分辨率天的天数范围


参数：days
numeric vector of length 2, specifying the first and last day of a range of days (for types 2 and 3)
数值向量长度为2，指定天数范围的第一天和最后一天的（types 2和3）


参数：moment
if type="moment" or "same.moment.range.of.days", moment specifies the time of the day (hour between 0 and 24) for which the insolation is to be calculated
如果type="moment"或"same.moment.range.of.days"，moment指定的日照来计算一天的时间（小时0至24之间）


参数：latitude
if no in.latitude grid is given, this will specify a fixed geographical latitude for the entire grid
如果没有in.latitude网格给出，这将整个网格指定一个固定的GEO纬度


参数：bending
should planetary bending be modeled? (default: FALSE)
行星弯曲模仿？ （默认：FALSE）


参数：radius
planetary radius
行星半径


参数：lat.offset
latitude relates to grids "bottom" (equivalent code: 0), "center" (1), "top" (2), or "user"-defined reference (default: "user"); in the latter case, lat.ref.user defines the reference
latitude涉及到电网"bottom"（相当于代码：0）"center"（1），"top"（2），或"user"定义参考（默认为："user"）;在后一种情况下，lat.ref.user定义参考


参数：lat.ref.user
if in.latitude is missing and lat.offset="user", then this numeric value defines the latitudinal reference (details??)
如果in.latitude失踪，lat.offset="user"，那么这个数值定义的纬度引用（？？）


参数：lon.offset
local time refers to grid's "left" edge (code 0), "center" (1), "right" edge (2), or a  "user"-defined reference.
本地时间是指网格的"left"边缘（代码0），"center"（1），"right"边缘（2），或"user"定义的参考。


参数：lon.ref.user
if in.longitude is missing and lon.offset="user", then this numeric value defines the reference of the local time (details??)
如果in.longitude失踪，lon.offset="user"，那么这个数值定义的参考本地时间（详细资料？？）


参数：...
optional arguments to be passed to rsaga.geoprocessor, including the env RSAGA geoprocessing environment
可选参数传递给rsaga.geoprocessor，包括env RSAGAGEO处理环境


Details

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

Calculation of incoming solar radiation (insolation). Based on the  SADO (System for the Analysis of Discrete Surfaces) routines developed
的入射太阳辐射（日照）计算。佐渡（系统基于离散曲面分析）例程


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

The type of object returned depends on the intern argument passed to the rsaga.geoprocessor. For intern=FALSE it is a numerical error code (0: success), or otherwise (default)
返回的对象的类型取决于intern参数传递的rsaga.geoprocessor。对于intern=FALSE它是一个数字错误代码（0：成功），或以其他方式（默认）


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

This function uses module Insolation (code: 3) from SAGA library ta_lighting. It is availble in SAGA GIS 2.0.4 and 2.0.5 but not 2.0.6
此功能使用模块Insolation（代码：3），从的SAGA库ta_lighting。这是availble在SAGA GIS 2.0.4和2.0.5，但没有2.0.6


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


Alexander Brenning (R interface), Olaf Conrad (SAGA module)



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

rsaga.solar.radiation, rsaga.pisr,
rsaga.solar.radiation，rsaga.pisr，

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


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