R语言 xpose4specific包 xpose.VPC()函数中文帮助文档(中英文对照)

loveR

xpose.VPC(xpose4specific)
xpose.VPC()所属R语言包：xpose4specific

                                        Visual Predictive Check (VPC) using XPOSE
                                         视觉预测性检查（VPC）XPOSE

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

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

This Function is used to create a VPC in xpose using the output from the  vpc command in Pearl Speaks NONMEM (PsN). The function reads in the output files created by PsN and creates a plot from the data.  The dependent variable, independent variable and conditioning variable are automatically determined from the PsN files.
此功能是用来创建一个VPC XPOSE使用的输出vpc命令珠江说NONMEM（PSN）。该功能可以读取由PSN创建的输出文件，并从数据中创建一个图。因变量，自变量和调节变量自动确定从PSN的文件。


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


xpose.VPC(vpc.info = "vpc_results.csv",  
          vpctab = dir(pattern="^vpctab")[1],
          object = NULL,
          ids=FALSE,
          type="p",
          by=NULL,
          PI=NULL,
          PI.ci="area",
          PI.real=T,
          PI.ci.med.arcol="red",
          subset=NULL,
          main="Default",
          main.sub=NULL,
          main.sub.cex=0.85,
          inclZeroWRES=FALSE,
          force.x.continuous=FALSE,
          funy=NULL,
          logy=FALSE,
          ylb = "Default",
          ...)



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

参数：vpc.info
The results file from the vpc command in PsN. for example "vpc\_results.csv", or if the file is in a separate directory "./vpc\_dir1/vpc\_results.csv".
从vpc命令在PSN结果文件。例如vpc\_results.csv，或者如果该文件是在一个单独的目录./vpc\_dir1/vpc\_results.csv。


参数：vpctab
The "vpctab" from the vpc command in PsN.  For example "vpctab5", or if the file is in a separate directory "./vpc\_dir1/vpctab5".  Can be NULL. The default looks in the current working directory and takes the first file that starts with "vpctab" that it finds.  Note that this default can result in the wrong files being read if there are multiple "vpctab" files in the directory. One of object or vpctab is required.  If both are present then the information from the vpctab will over-ride the xpose data object object (i.e. the values from the vpctab will replace any matching values in the object\@Data portion of the xpose data object).
“”vpctab从vpc命令在PSN。例如vpctab5，或者如果该文件是在一个单独的目录./vpc\_dir1/vpctab5。可以NULL。默认情况下会在当前的工作目录，并开始vpctab它找到的第一个文件。请注意，默认情况下会导致在错误的文件被读取，如果有多个“vpctab目录中的文件。一个object或vpctab需要。如果两者都存在，那么vpctab的信息将过骑的XPOSE的数据对象object（即从vpctab值将取代任何匹配的值在object\@Data部分的XPOSE数据对象）。


参数：object
An xpose data object. Created from xpose.data.  One of object or vpctab is required.  If both are present then the information from the vpctab will over-ride the xpose data object object (i.e. the values from the vpctab will replace any matching values in the object\@Data portion of the xpose data object).
一个XPOSE的数据对象。创建xpose.data。一个object或vpctab需要。如果两者都存在，那么vpctab的信息将过骑的XPOSE的数据对象object（即从vpctab值将取代任何匹配的值在object\@Data部分的XPOSE数据对象）。


参数：ids
A logical value indicating whether text ID labels should be used as plotting symbols (the variable used for these symbols indicated by the idlab xpose data variable). Can be FALSE or TRUE.
一个逻辑值，该值指示是否应作为绘制符号，（用于这些符号的变量表示的idlab的XPOSE数据变量）文本ID标签。可以FALSE或TRUE。


参数：type
Character string describing the way the points in the plot will be displayed. For more details, see plot. Use type="n" if you don't want observations in the plot.
会显示字符串描述的图点。有关详细信息，请参阅plot。使用type="n"“”如果你不想在图的意见。


参数：by
A string or a vector of strings with the name(s) of the conditioning variables. For example by = c("SEX","WT"). Because the function automatically determines the conditioning variable from the PsN input file specified in vpc.info, the by command can control if separate plots are created for each condition (by=NULL), or if a conditioning plot should be created (by="WT" for example).  If the vpc.info file has a conditioning variable then by must match that variable.  If there is no conditioning variable in vpc.info then the PI for each conditioned plot will be the PI for the entire data set (not only for the conditioning subset).
一个字符串或一个字符串矢量的调节变量的名称（S）。例如by = c("SEX","WT")。因为该功能会自动决定从PSN指定的输入文件vpc.info，by命令可以控制单独的图形创建的每个条件（by=NULL），或者如果空调的调节变量图应该被创建（by="WT"例如）。如果vpc.info文件中有一个调节变量，然后by必须与该变量。如果没有空调变量vpc.infoPI为每个空调图将是PI整个数据集（不仅是为的空调子集）。


参数：PI
Either "lines", "area" or "both" specifying whether prediction intervals (as lines, a shaded area or both)  should be added to the plot. NULL means no prediction interval.
无论是“线”，“区域”或“both”指定预测的时间间隔（如线条，阴影区域或两者）是否应加入的图。 NULL是指没有预测区间。


参数：PI.ci
Plot the prediction interval of the simulated data's percentiles for each bin. Values can be "both", "area" or "lines" This can be thought of as a prediction interval about the PI.real or a confidence interval about the PI. However, note that with increasing number of simulations the CI will not go towards zero because the interval is also dependent on the size of the data set.
绘制的模拟数据的百分位的预测区间为每个垃圾桶。值可以是"both", "area" or "lines"这可以被认为是作为预测区间关于PI.real或置信区间的PI的。但是，请注意，随着越来越多的模拟的CI不会向零，因为时间间隔也是依赖于数据集的大小。


参数：PI.real
Plot the percentiles of the real data in the various bins. values can be NULL or TRUE.  Note that for a bin with few actual observations the percentiles will be approximate.  For example, the 95th percentile of 4 data points will always be the largest of the 4 data points.
绘制百分各种箱中的真实数据。值可以是NULL或TRUE。需要注意的是一些实际观测的垃圾桶内的百分近似。例如，第95百分位的4个数据点，将始终是最大的4个数据点。


参数：PI.ci.med.arcol
The color of the median PI.ci.
的颜色中位数的PI.ci。


参数：force.x.continuous
Logical value indicating whether x-values should be taken as continuous, even if categorical.
逻辑值，该值指示是否应被视为连续的x值，即使分类。


参数：funy
String of function to apply to Y data. For example "abs"
字符串的功能，适用于Y数据。例如，“ABS”


参数：logy
Logical value indicating whether the y-axis should be logarithmic, base 10.
逻辑值，该值指示的y轴是否应该是对数的，基座10。


参数：ylb
Label for the y-axis
出版商为y轴


参数：subset
A string giving the subset expression to be applied to the data before plotting. See xsubset.
被应用到的数据，然后绘制一个字符串，给出的子集表达。见xsubset。


参数：main
A string giving the plot title or NULL if none. "Default" creates a default title.
图标题或NULL，如果没有一个字符串，给出。 "Default"创建一个默认的标题。


参数：main.sub
Used for names above each plot when using multiple plots. Should be a vector c("Group 1","Group 2")
用于以上每个小区的名字时，使用多块。应该是一个向量c("Group 1","Group 2")


参数：main.sub.cex
The size of the main.sub titles.
的大小main.sub标题。


参数：inclZeroWRES
Logical value indicating whether rows with WRES=0 is included in the plot.
逻辑值，该值指示是否行与WRES = 0的图。


参数：...
Other arguments passed to  xpose.panel.default,  xpose.plot.default and others. Please see these functions for more descriptions of what you can do.
其他参数传递给xpose.panel.default，xpose.plot.default和其他。请参阅这些功能的详细描述，你可以做什么。


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

A plot or a list of plots.
图或图的列表。


附加参数----------Additional arguments----------

<STRONG>Additional graphical elements available in the VPC plots<br></STRONG>
<STRONG>其他图形元素可用在VPC图<BR>的</ STRONG>




PI.real = NULL or TRUE Plot the percentiles of the real data in the various bins.  Note that for a bin with few actual observations the percentiles will be approximate.  For example, the 95th percentile of 4 data points will always be the largest of
PI.real = NULL or TRUE绘制百分位数的真实数据的各种箱。需要注意的是一些实际观测的垃圾桶内的百分近似。例如，第95百分位数的4个数据点，将永远是最大的




PI.mirror = NULL, TRUE or AN.INTEGER.VALUE Plot the percentiles of one simulated data set in each bin. TRUE takes the first mirror from "vpc\_results.csv" and AN.INTEGER.VALUE can be 1, 2, ... n where n
PI.mirror = NULL, TRUE or AN.INTEGER.VALUE绘制一个模拟数据集在每个容器的百分。 TRUE的第一个镜像从vpc\_results.csv和AN.INTEGER.VALUE是1, 2, ... n其中n




PI.ci = "both", "area" or "lines" Plot the confidence interval  for the simulated data's percentiles for each bin (for each simulated data set compute the percentiles for each bin, then, from all of the percentiles from all of the simulated datasets compute the 95% CI of these percentiles).  These CIs can be used to asses the PI.real values for model misspecification. Again, as with the PI.real, note that with  few observations per bin the CIs will be approximate because the percentiles in each bin will be approximate. For example, the 95th percentile of 4 data points will always be the largest of
PI.ci = "both", "area" or "lines"图的模拟数据的百分每个容器的置信区间为（为每个模拟数据计算百分位数为每个垃圾桶，然后，所有的模拟数据集的百分计算95％CI，这些百分位数）。这些负债证明书，可用于评估PI.real模型误设的值。同样地，与PI.real，请注意，每个二进制的一些意见的CI将是近似的，因为在每个容器的百分近似。例如，第95百分位数的4个数据点，将永远是最大的




PI.limits = c(0.025, 0.975) A vector of two values that describe the limits of the prediction interval that should be displayed.  These limits should be found in the "vpc\_results.csv" file. These limits are also used as the percentages for the PI.real, PI.mirror and PI.ci.  However, the confidence interval in PI.ci is
PI.limits = c(0.025, 0.975)的向量的两个值的描述应该被显示的预测区间的限制。这些限制应在vpc\_results.csv文件。这些限制也可用于的百分比PI.real, PI.mirror和PI.ci。然而，PI.ci的置信区间

<STRONG>Additional options to control the look and feel of the PI.  See See grid.polygon and  plot for more details.<br></STRONG>
<STRONG>其他选项来控制的外观和感觉的PI。见grid.polygon和plot有关详细信息，。<BR> </ STRONG>




PI.arcol The color of the PI
PI.arcolPI的颜色




PI.up.lty The upper line type. can be
PI.up.lty上线类型。可以




PI.up.type The upper type used for
PI.up.type上的类型，用于




PI.up.col The upper line color
PI.up.col上线的颜色




PI.up.lwd The upper line width
PI.up.lwd上线宽度




PI.down.lty The lower line type. can be
PI.down.lty较低的线路类型。可以




PI.down.type The lower type used for
PI.down.type较低的类型，用于




PI.down.col The lower line color
PI.down.col，下面的线颜色




PI.down.lwd The lower line width
PI.down.lwd，下面的线宽度




PI.med.lty The median line type. can be
PI.med.lty中间线类型。可以




PI.med.type The median type used for
PI.med.type中位数类型用于




PI.med.col The median line color
PI.med.col中间线颜色




PI.med.lwd The median line width
PI.med.lwd的中位线宽度

<STRONG>Additional options to control the look and feel of the PI.ci.  See See grid.polygon and  plot for more details.<br></STRONG>
<STRONG>其他选项来控制的外观和感觉的PI.ci。见grid.polygon和plot有关详细信息，。<BR> </ STRONG>




PI.ci.up.arcol The color of the upper
PI.ci.up.arcol的上部的颜色




PI.ci.med.arcol The color of the median
PI.ci.med.arcol中位数的颜色




PI.ci.down.arcol The color of the lower
PI.ci.down.arcol的颜色越低




PI.ci.up.lty The upper line type. can be
PI.ci.up.lty上线类型。可以




PI.ci.up.type The upper type used for
PI.ci.up.type上的类型，用于




PI.ci.up.col The upper line color
PI.ci.up.col上线的颜色




PI.ci.up.lwd The upper line width
PI.ci.up.lwd上线宽度




PI.ci.down.lty The lower line type. can be
PI.ci.down.lty较低的线路类型。可以




PI.ci.down.type The lower type used for
PI.ci.down.type较低的类型，用于




PI.ci.down.col The lower line color
PI.ci.down.col，下面的线颜色




PI.ci.down.lwd The lower line width
PI.ci.down.lwd，下面的线宽度




PI.ci.med.lty The median line type. can be
PI.ci.med.lty中间线类型。可以




PI.ci.med.type The median type used for
PI.ci.med.type中位数类型用于




PI.ci.med.col The median line color
PI.ci.med.col中间线颜色




PI.ci.med.lwd The median line width
PI.ci.med.lwd的中位线宽度




PI.ci.area.smooth Should the "area" for PI.ci be smoothed to match the "lines" argument? Allowed values are TRUE/FALSE. The "area" is set by default to show the bins used in the PI.ci computation.  By smoothing, information is lost and, in general, the confidence intervals will
PI.ci.area.smooth“区”PI.ci进行平滑，以配合“行”的说法吗？允许值是TRUE/FALSE。 “区域”是默认设置箱PI.ci计算中使用的。平滑，信息丢失，并在一般情况下，置信区间

<STRONG>Additional options to control the look and feel of the PI.real. See See grid.polygon and  plot for more details.<br></STRONG>
<STRONG>其他选项来控制的外观和感觉的PI.real。见grid.polygon和plot有关详细信息，。<BR> </ STRONG>




PI.real.up.lty The upper line type. can be
PI.real.up.lty上线类型。可以




PI.real.up.type The upper type used for
PI.real.up.type上的类型，用于




PI.real.up.col The upper line color
PI.real.up.col上线的颜色




PI.real.up.lwd The upper line width
PI.real.up.lwd上线宽度




PI.real.down.lty The lower line type. can be
PI.real.down.lty较低的线路类型。可以




PI.real.down.type The lower type used for
PI.real.down.type较低的类型，用于




PI.real.down.col The lower line color
PI.real.down.col，下面的线颜色




PI.real.down.lwd The lower line width
PI.real.down.lwd，下面的线宽度




PI.real.med.lty The median line type. can be
PI.real.med.lty中间线类型。可以




PI.real.med.type The median type used for
PI.real.med.type中位数类型用于




PI.real.med.col The median line color
PI.real.med.col中间线颜色




PI.real.med.lwd The median line width
PI.real.med.lwd的中位线宽度

<STRONG>Additional options to control the look and feel of the PI.mirror. See See  plot for more details.<br></STRONG>
<STRONG>其他选项来控制的外观和感觉的PI.mirror。参阅plot更多的细节。</ STRONG>




PI.mirror.up.lty The upper line type. can be
PI.mirror.up.lty上线类型。可以




PI.mirror.up.type The upper type used for
PI.mirror.up.type上的类型，用于




PI.mirror.up.col The upper line color
PI.mirror.up.col上线的颜色




PI.mirror.up.lwd The upper line width
PI.mirror.up.lwd上线宽度




PI.mirror.down.lty The lower line type. can be
PI.mirror.down.lty较低的线路类型。可以




PI.mirror.down.type The lower type used for
PI.mirror.down.type较低的类型，用于




PI.mirror.down.col The lower line color
PI.mirror.down.col，下面的线颜色




PI.mirror.down.lwd The lower line width
PI.mirror.down.lwd，下面的线宽度




PI.mirror.med.lty The median line type. can be
PI.mirror.med.lty中间线类型。可以




PI.mirror.med.type The median type used for
PI.mirror.med.type中位数类型用于




PI.mirror.med.col The median line color
PI.mirror.med.col中间线颜色




PI.mirror.med.lwd The median line width
PI.mirror.med.lwd的中位线宽度


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


Andrew Hooker



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

read.vpctab read.npc.vpc.results xpose.panel.default  xpose.plot.default
read.vpctabread.npc.vpc.resultsxpose.panel.defaultxpose.plot.default


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


## Not run: [＃不运行：]
library(xpose4)

xpose.VPC()

## to be more clear about which files should be read in[＃更加清楚哪些文件应该阅读]
vpc.file <- "vpc_results.csv"
vpctab <- "vpctab5"
xpose.VPC(vpc.info=vpc.file,vpctab=vpctab)

## with lines and a shaded area for the prediction intervals[用线和阴影区域的预测区间]
xpose.VPC(vpc.file,vpctab=vpctab,PI="both")

## with the percentages of the real data[＃的百分比的真实数据]
xpose.VPC(vpc.file,vpctab=vpctab,PI.real=T)

## with mirrors (if supplied in 'vpc.file')[用镜子（如果提供在“vpc.file”）]
xpose.VPC(vpc.file,vpctab=vpctab,PI.real=T,PI.mirror=5)

## with CIs[＃与独联体]
xpose.VPC(vpc.file,vpctab=vpctab,PI.real=T,PI.ci="area")
xpose.VPC(vpc.file,vpctab=vpctab,PI.real=T,PI.ci="area",PI=NULL)

## stratification (if 'vpc.file' is stratified)[＃分层（，如果“vpc.file是分层）]
cond.var <- "WT"
xpose.VPC(vpc.file,vpctab=vpctab)
xpose.VPC(vpc.file,vpctab=vpctab,by=cond.var)
xpose.VPC(vpctab=vpctab,vpc.info=vpc.file,PI="both",by=cond.var,type="n")

## with no data points in the plot[＃在图中没有数据点]
xpose.VPC(vpc.file,vpctab=vpctab,by=cond.var,PI.real=T,PI.ci="area",PI=NULL,type="n")

## with different DV and IDV, just read in new files and plot[＃用不同的DV和IDV新的文件和图，只是阅读]
vpc.file <- "vpc_results.csv"
vpctab <- "vpctab5"
cond.var <- "WT"
xpose.VPC(vpctab=vpctab,vpc.info=vpc.file,PI="both",by=cond.var)
xpose.VPC(vpctab=vpctab,vpc.info=vpc.file,PI="both")

## to use an xpose data object instead of vpctab[＃使用XPOSE的数据对象，而不是vpctab]
##[＃]
## In this example[在这个例子中＃]
## we expect to find the required NONMEM run and table files for run[＃我们希望找到所需的NONMEM运行和表文件运行的]
## 5 in the current working directory[排名第5的当前工作目录]
runnumber <- 5
xpdb <- xpose.data(runnumber)
xpose.VPC(vpc.file,object=xpdb)

## to read files in a directory different than the current working directory [＃读取当前的工作目录不同的目录中的文件]
vpc.file <- "./vpc_strat_WT_4_mirror_5/vpc_results.csv"
vpctab <- "./vpc_strat_WT_4_mirror_5/vpctab5"
xpose.VPC(vpc.info=vpc.file,vpctab=vpctab)



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


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


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