R语言 RNetLogo包 NLDoReport()函数中文帮助文档(中英文对照)

loveR

NLDoReport(RNetLogo)
NLDoReport()所属R语言包：RNetLogo

                                         Repeated execution of a command and a reporter in the referenced NetLogo instance for a defined number of repetitions.
                                         重复执行命令，记者在规定数量的重复引用的NetLogo实例。

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

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

NLDoReport function is used to execute a NetLogo command (submitted as a string) in the NetLogo instance for more than one time and to execute the reporter after each iteration.  It works like a combination of NLReport and NLDoCommand.
NLDoReport函数是用来以NetLogo实例中执行的NetLogo命令（作为一个字符串）提交一个以上的时间，并在每次迭代中执行的记者。它的工作原理相结合的NLReport和NLDoCommand。


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


NLDoReport(iterations, command, reporter, as.data.frame=FALSE,
           df.col.names=NULL, nl.obj=NULL)



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

参数：iterations
An interger defining the number of repetitions of the execution.  
的整数限定的执行的重复的数目。


参数：command
A string with the NetLogo command to be executed.   
一个字符串，其中以NetLogo命令被执行。


参数：reporter
A string conataining a NetLogo reporter. (Or a vector/list containing multiple strings with different reporters - but the same effect can be reached via (list var1 var2 var3).)   
的字符串conataining一个的NetLogo记者。 （或者一个矢量/多个字符串列表，其中包含不同的记者 - 但达到同样的效果可以通过(list var1 var2 var3)。）


参数：as.data.frame
(optional) If TRUE the function will return a data.frame instead a list. Default is FALSE which returns a list.  
（可选）如果TRUE的功能将返回一个数据框，而不是一个列表。默认是FALSE返回一个列表。


参数：df.col.names
(optional) If as.data.frame=TRUE you can define the names of the columns of the returned data.frame via this parameter.  Input should be a vector containing the names as strings in the same order as the submitted reporters.   
（可选）如果as.data.frame=TRUE你可以通过这个参数定义的名称，返回的数据框的列。输入应该是一个向量中的字符串相同的顺序提交的记者的名字。


参数：nl.obj
(optional) A variable holding a reference to a NetLogo instance created with NLStart.  
（可选）变量参考到的NetLogo实例的创建与NLStart。


Details

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

This function is used to execute a command for more than one time and report a value or a number of values after each iteration. It is often used to call a procedure (e.g. "go") for a defined number of times and will save the value of a state variable in each simulation step.
这个函数是用来执行一个命令的一个以上的时间，和报告一个值或一个在每次迭代后的值的数目。它经常被用来调用一个过程（例如，“去”）的次数，将节省的状态变量的值在每个模拟步骤。


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

A list/nested list or data.frame with the value(s) of the reporter after each execution of the command.
列表/嵌套列表或数据框的值（S），每个执行该命令后，记者。


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



Jan C. Thiele <jthiele@gwdg.de>




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

NLDoCommand, NLReport, NLDoReportWhile
NLDoCommand，NLReport，NLDoReportWhile


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


## Not run: [＃不运行：]
nl.path <- "C:/Program Files/NetLogo 5.0"
NLStart(nl.path)
model.path <- "/models/Sample Models/Earth Science/Fire.nlogo"
NLLoadModel(paste(nl.path,model.path,sep=""))
NLCommand("setup")
burned10 <- NLDoReport(10, "go", "burned-trees")
initburned10 <- NLDoReport(10, "go", c("initial-trees","burned-trees"),
                as.data.frame=TRUE, df.col.names=c("initial","burned"))

## End(Not run)[＃（不执行）]

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


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