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

loveR

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

                                         Repeated execution of a command and a reporter in the referenced NetLogo instance while a conditional reporter returns TRUE.
                                         重复执行的命令和引用的NetLogo实例记者在，而有条件记者返回TRUE。

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

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

NLDoReportWhile function is used to execute a NetLogo command (submitted as a string) in the submitted NetLogo instance more than one time  and to execute the reporter after each iteration.  It works like NLDoReport but will be repeated while the conditional reporter returns TRUE.
NLDoReportWhile函数是用来执行的NetLogo命令（作为一个字符串）提交一个以上的时间，并在提交的NetLogo实例在每次迭代中执行的记者。它的工作原理就像NLDoReport但是，将重复，而有条件记者返回TRUE。


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


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



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

参数：condition
A string with a NetLogo conditional reporter.  
一个字符串，其中一个的NetLogo有条件记者。


参数：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 will report a value or a number of values after each iteration. It is usually used to call a procedure (e.g. "go") while a variable is lower a boundary value and to  save the value of a state variable in each simulation step.  Attention: Make sure that the condition switches from TRUE to FALSE sometime,  otherwise you will run an endless loop.
这个函数是用来执行一个命令的一个以上的时间，将报告一个值或一个在每次迭代后的值的数目。它通常用于调用一个过程（例如，“去”），而变量的边界值越低，保存的状态变量的值在每个模拟步骤。注意：请确保切换到TRUE“FALSE一段时间，否则你将运行一个无限循环的条件。


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

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


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



Jan C. Thiele <jthiele@gwdg.de>




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

NLDoCommandWhile, NLReport, NLDoReport
NLDoCommandWhile，NLReport，NLDoReport


实例----------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")
burnedLower2200 <- NLDoReportWhile("burned-trees < 2200", "go",
                                   "burned-trees")

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

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


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