scarabee.gridsearch(scaRabee)
scarabee.gridsearch()所属R语言包：scaRabee
Direct Grid Search Utility
直栏搜索工具
译者：生物统计家园网 机器人LoveR
描述----------Description----------
scarabee.gridsearch is a secondary function called during direct grid search runs. It creates a matrix made of unique vectors of parameter estimates set around the vector of initial estimates and evaluates the objective function (i.e. minus twice the log of the exact likelihood of the observed data, given the structural model, the model of residual variability, and the vector of parameter estimates) at each of those vectors at the population level. The grid of objective function values is then sorted and the best vector is used to simulate the model at the population level. scarabee.gridsearch is typically not called directly by users.
scarabee.gridsearch是一个过程中调用直接电网运行搜索的辅助功能。独特的向量参数估计的初步估计周围的向量，它创建了一个矩阵，并计算目标函数（即减去两倍的log准确的观测数据的可能性，给定的结构模型，该模型的残余变异，在这些向量在群体水平上的向量参数估计值）。目标函数值的网格，然后，排序和最好的向量是用来模拟模型在人口一级。 scarabee.gridsearch通常不直接调用用户。
用法----------Usage----------
scarabee.gridsearch(problem = NULL,
npts = NULL,
alpha = NULL,
files = NULL)
参数----------Arguments----------
参数：problem
A list containing the following levels:
一个列表，其中包含以下几个层次：
dataA list which content depends on the scope of the analysis. If the analysis was run at the level of the subject, data contains as many levels as the number of subjects in the dataset, plus the ids level containing the vector of identification numbers of all subjects included in the analysis population. If the analysis was run at the level of the population, data contains only one level of data and ids is set to 1. Each subject-specific level contains as many levels as there are treatment levels for this subject, plus the trts level listing all treatments for this subject, and the id level giving the identification number of the subject. Each treatment-specific levels is a list containing the following levels:
DATAA列表的内容取决于分析的范围。如果分析被运行在被检体的水平，data中的数据集的数量的受试者包含尽可能多的水平，加上ids水平含有向量的所有主题的识别号码包含在分析人口。如果分析在人口水平运行，data只包含一个电平的数据和ids被设置为1。每个特定主题的多层次，有对这个问题的处理水平，加上trts级以上市对这个问题的所有治疗，和id水平的标识号的主题。每一个具体的治疗水平是一个列表，其中包含以下几个层次：
cov mij x 3 data.frame containing the times of observations of the dependent variables (extracted from the TIME variable), the indicators of the type of dependent variables (extracted from the CMT variable), and the actual dependent variable observations (extracted from the DV variable) for this particular treatment and this particular subject.
覆盖MIJ×3数据框的类型相关的变量（CMT变量提取），而实际的因变量的观测指标（含观测到的因变量（从时间变量中提取）的时代，提取的DV变量）这个特殊的处理，这特定主题。
covmij x c data.frame containing the times of observations of the dependent variables (extracted from the TIME variable) and all the covariates identified for this particular treatment and this particular subject.
covmij XC数据框包含因变量（从时间变量中提取）和这个特殊的治疗和这个特定的主题确定为所有的协变量的观测时间。
bolusbij x 4 data.frame providing the instantaneous inputs for a treatment and individual.
bolusbij×4的数据框提供的治疗和个人的瞬时输入。
infusionfij x (4+c) data.frame providing the zero-order inputs for a treatment and individual.
infusionfij×（4 + c的）数据框提供零阶的输入处理和个人。
trtthe particular treatment identifier.
trtthe特别治疗标识符。
methodA character string, indicating the scale of the analysis. Should be 'population' or 'subject'.
了methodA字符串，表示规模的分析。应该是“人口”或“主题”。
initA data.frame of parameter data with the following columns: 'names', 'type', 'value', 'isfix', 'lb', and 'ub'.
INITA数据框的参数数据有以下几列：名称，类型，价值，isfix，磅，和UB。
debugmodeLogical indicator of debugging mode.
除错模式的debugmodeLogical指标。
modfunModel function.
modfunModel功能。
参数：npts
An integer greater than 2, defining the number of points that the grid should contain per dimension (i.e variable model parameter).
大于2的整数，定义网格应包含每个维度（即变量模型参数）的点的数目。
参数：alpha
A vector of numbers greater than 1, which give the factor(s) used to calculate the evaluation range of each dimension of the search grid (see Details). If alpha length is lower than the number of variable parameters, elements of alpha are recycled. If its length is higher than number of variable parameters, alpha is truncated.
的矢量大于1的数字，从而使该因子（S）来计算的搜索网格的每个维度评估范围（见详情）。如果alpha长度低于可变参数的数目，alpha被再循环的元素。如果它的长度是可变参数的数量高于alpha被截断。
参数：files
A list of input used for the analysis. The following elements are expected and none of them could be null:
用于分析的输入的列表。预计下列元素和他们没有可能为空：
dataA .csv file located in the working directory, which contains the dosing information, the observations of the dependent variable(s) to be modeled, and possibly covariate information. The expected format of this file is described in details in vignette('scaRabee', package='scaRabee').
DATAA。csv文件的工作目录，其中包含的剂量信息，（因变量）的意见进行建模，以及可能的协变量的信息。该文件格式的细节vignette('scaRabee', package='scaRabee')。
paramA .csv file located in the working directory, which contains the initial guess(es) for the model parameter(s) to be optimized or used for model simulation. The expected format of this file is described in details in vignette('scaRabee',package='scaRabee').
帕拉马。csv文件的工作目录，其中包含了最初的猜测（ES）进行优化或用于模型仿真模型参数（S）。该文件格式的细节vignette('scaRabee',package='scaRabee')。
modelA text file located in the working directory, which defines the model. Models specified with explicit, ordinary or delay differential equations are expected to respect a certain syntax and organization detailed in vignette('scaRabee',package='scaRabee').
MODELA工作目录中的文本文件，它定义了模型。指定明确的，普通或延迟微分方程模型应尊重一定的语法和组织中详述vignette('scaRabee',package='scaRabee')。
iterA .csv file reporting the values of the objective function and estimates of model parameters at each iteration. (Not used for direct grid search runs).
迭代。csv文件报告在每次迭代的目标函数和模型参数的估计值。 （不用于直接电网运行搜索的）。
reportA text file reporting the summary tables of ordered objective function values for the various tested vectors of model parameters.
reportA文本文件，报告的汇总表有序的目标函数值的各种模型参数的测试向量。
predA .csv file reporting the predictions and calculated residuals for each individual in the dataset. (Not used for direct grid search runs).
报告的预测和计算残差的每一个人在该数据集的捕食者。csv文件。 （不用于直接电网运行搜索的）。
estA .csv file reporting the final parameter estimates for each individual in the dataset. (Not used for direct grid search runs).
ESTA。csv文件，报告的最后一个参数估计为每个数据集。 （不用于直接电网运行搜索的）。
simA .csv file reporting the simulated model predictions for each individual in the dataset. (Not used for direct grid search runs).
司马。csv文件报告为每个数据集模拟模型的预测结果。 （不用于直接电网运行搜索的）。
Details
详细信息----------Details----------
The actual creation of the grid and the evaluation of the objective function is delegated by scarabee.gridsearch to the fmin.gridsearch function of the neldermead package.
电网的实际创作和评价的目标函数被授予的scarabee.gridsearch函数fmin.gridsearch包neldermead。
This function evaluates the cost function - that is, in the present case, the objective function - at each point of a grid of npts^length(x0) points, where x0 is the vector of model parameters set as variable. If alpha is NULL, the range of the evaluation points is limited by the lower and upper bounds of each parameter of x0 provided in the parameter file. If alpha is not NULL, the range of the evaluation points is defined as [x0/alpha,x0*alpha].
此函数计算成本函数 - 也就是说，在本例中，目标函数 - npts^length(x0)点，在每个点的网格x0是设置为变量的模型参数的向量。如果alpha是NULL，评价点的范围是有限的由x0设置在参数文件中的每个参数的下限和上限。如果alpha是不为NULL，评价点的范围被定义为[x0/alpha,x0*alpha]。
Because fmin.gridsearch can be applied to the evaluation of constrained systems, it also assesses the feasibility of the cost function at each point of the grid (i.e. whether or not the points satisfy the defined constraints). In the context of scaRabee, the objective function is always feasible.
这是因为fmin.gridsearch可以施加约束系统的评价，它也评估的成本函数的可行性，在每个点的网格（即或不点是否满足所定义的约束）。在SCARABEE的背景下，中，目标函数是可行的。
值----------Value----------
Return a data.frame with pe+2 columns. The last 2 columns report the value and the feasibility of the objective function at each specific vector of parameter estimates which is documented in the first pe columns. This data.frame is ordered by feasibility and increasing value of the objective function.
返回数据框PE +2列。最后2列报告的目标函数在每一个具体的PE在第一列向量参数估计值的记录的价值和可行性。数据框的可行性和增加值的目标函数是有序的。
（作者）----------Author(s)----------
Sebastien Bihorel (<a href="mailto:sb.pmlab@gmail.com">sb.pmlab@gmail.com</a>)
参见----------See Also----------
fmin.gridsearch
fmin.gridsearch
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-9-29 22:47:51
