R语言 flowCore包 split-methods()函数中文帮助文档(中英文对照)

loveR

split-methods(flowCore)
split-methods()所属R语言包：flowCore

                                         Methods to split flowFrames and flowSets according to filters
                                         根据分裂flowFrames和flowSets，过滤器的方法

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

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

Divide a flow cytometry data set into several subset according to the results of a filtering operation. There are also methods available to split according to a factor variable.
划分成若干子集，根据一个过滤操作的结果流式单元数据。也有方法可以根据一个因素变量分裂。


Details

详情----------Details----------

The splitting operation in the context of flowFrames and flowSets is the logical extension of subsetting. While the latter only returns the events contained within a gate, the former splits the data into the groups of events contained within and those not contained within a particular gate. This concept is extremely useful in applications where gates describe the distinction between positivity and negativity for a particular marker.
在分裂操作flowFrame的背景和flowSet的子集的逻辑延伸。而后者只返回包含在门事件，前者分成组内和那些不包含在一个特定的门中的事件数据。这个概念是非常有用的应用，盖茨描述一个特定的标记之间的积极和消极的区分。

The flow data structures in flowCore can be split into subsets on various levels:
flowCore可以分裂成各级子集流数据结构：

flowFrame: row-wise splitting of the raw data. In most cases, this will be done according to the outcome of a filtering operation, either using a filter that identifiers more than one sub-population or by a logical filter, in which case the data is split into two populations: "in the filter" and "not in the filter". In addition, the data can be split according to a factor (or a numeric or character vector that can be coerced into a factor).
flowFrame：行明智的原始数据的分裂。在大多数情况下，这将根据过滤操作的结果，或者使用过滤器，一个人口超过或逻辑过滤器的标识符，在这种情况下，数据被分裂成两个群体：“在过滤器“和”不过滤器“。此外，数据可以被分割的一个因素（或一个数字或字符的向量，可以进入一个因素裹挟）。

flowSet: can be either split into subsets of flowFrames according to a factor or a vector that can be coerced into a factor, or each individual flowFrame into subpopulations based on the filters or filterResults provided as a list of equal length.
flowSet：可以flowFrame的子集或分割成的一个因素，可分为强制的一个因素或一个向量，每一个人flowFrame到<X基于亚>或filter的长度相等的列表提供。

Splitting has a special meaning for filters that result in multipleFilterResults or manyFilterResults, in which case simple subsetting doesn't make much sense (there are multiple populations that are defined by the gate and it is not clear which of those should be used for the subsetting operation). Accordingly, splitting of multipleFilterResults creates multiple subsets. The argument population can be used to limit the output to only one or some of the resulting subsets. It takes as values a character vector of names of the populations of interest. See the documentation of the different filter classes on how population names can be defined and the respective default values. For splitting of logicalFilterResults, the population argument can be used to set the population names since there is no reasonable default other than the name of the gate. The content of the argument prefix will be prepended to the population names and '+' or '-' are finally appended allowing for more flexible naming schemes.
分裂具有特殊意义的一个过滤器，结果在“multipleFilterResult或manyFilterResult的简单子集，在这种情况下，没有多大意义（定义门和它是不是有多个种群明确那些应的子集操作）。因此，分裂的multipleFilterResults创建多个子集。参数population可用于限制输出到只有一个或一些由此产生的子集。它需要为值特征向量的利益群体的名称。见人口名称如何可以定义不同的过滤器类的文件和各自的默认值。为logicalFilterResult的分裂，population参数可以用来设置人口的名称，因为没有合理的默认门的名称以外。内容的说法prefix将追加到人口的名称和“+”或“ - ”终于追加允许更灵活的命名方案。

The default return value for any of the split methods is a list, but the optional logical argument filterSet can be used to return a flowSet instead. This only applies when splitting flowFrames, splitting of flowSets always results in lists of flowSet objects.
任何split方法的默认返回值是一个列表，但可选的逻辑论证filterSet可以使用，而不是返回flowSet，。这仅适用于flowFrame的分裂，分裂flowSet的结果总是在flowSet对象名单。


方法----------Methods----------

flowFrame methods:
flowFrame方法：




x = "flowFrame", f = "ANY", drop = "ANY"  Catch all input and
X =“flowFrame”，F =“任何”，降“任何”捕捉所有的输入和




x = "flowFrame", f = "factor", drop = "ANY"  Split a flowFrame by a factor variable. Length of f should be the same as nrow(x), otherwise it will be recycled, possibly leading to undesired outcomes. The optional argument drop works in the usual way, in that it removes
=“flowFrame”，F =“因子”，降=“任何分割的一个因素变量flowFrame的。 f长度应该作为nrow(x)，否则将被回收利用，可能导致意外的结果相同。可选的参数drop工程在通常的方式，它消除




x = "flowFrame", f = "character", drop = "ANY"  Coerce
x =“flowFrame”，F =“字符”，降“任何”要挟




x = "flowFrame", f = "numeric", drop = "ANY"  Coerce f to
x =“flowFrame”，F =“数值”，降“任何”要挟“f




x = "flowFrame", f = "filter", drop = "ANY"  First applies the filter to the flowFrame and then splits on the resulting
X =“flowFrame”，F =“过滤器”，降“任何”第一套用到filterflowFrame然后分裂产生的




x = "flowFrame", f = "filterSet", drop = "ANY"  First applies the filterSet to the flowFrame and then splits on the resulting
X =“flowFrame”，F =“filterSet”，降=“任何”第一filterSetflowFrame然后由此产生的分裂




x = "flowFrame", f = "logicalFilterResult", drop = "ANY"  Split into the two subpopulations (in and out of the gate). The optional argument population can be used to control the names of the
=“flowFrame”，F =的“logicalFilterResult”，下降=“ANY”，分为两个亚群的分割（出了大门）。可选的参数population可以用来控制的名称




x = "flowFrame", f = "manyFilterResult", drop = "ANY"  Split into the several subpopulations identified by the filtering operation. Instead of returning a list, the additional logical argument codeflowSet makes the method return an object of class flowSet. The optional population argument takes a character vector indicating the subpopulations to use for splitting (as identified by the population name in the
X =“flowFrame”，F =“manyFilterResult”，降“任何”拆分到过滤操作所确定的几个亚。返回一个列表，而不是额外的逻辑论证codeflowSet使得该方法返回一个对象的类flowSet。可选population参数字符向量表示，亚分裂（在人口名称确定

Split into the several subpopulations identified by the filtering operation. Instead of returning a list, the additional logical argument codeflowSet makes the method return an object of class flowSet. The optional population argument takes a character vector indicating the subpopulations to use for splitting (as identified by the population name in the filterDetails slot). Alternatively, this can be a list of characters, in which case the populations for each list item are
过滤操作所确定的几个亚分成。返回一个列表，而不是额外的逻辑论证codeflowSet使得该方法返回一个对象的类flowSet。可选的population参数需要一个特征向量表示，亚分裂使用（如人口名称确定在filterDetails插槽）。另外，这可以是一个字符列表，在这种情况下，每个列表项的人口

flowSet methods:
flowSet方法：




x = "flowSet", f = "ANY", drop = "ANY"  Catch all input and cast
X =“flowSet”，F =“任何”，降“任何”抓住所有的输入和演员




x = "flowSet", f = "factor", drop = "ANY"  Split a flowSet by a factor variable. Length of f needs to be the same as length(x). The optional argument drop works in the usual way, in that it removes empty
x =“flowSet”，F =“因素”，降“任何”拆分flowSet的一个因素变量。长度的f需要length(x)的。可选的参数drop工程在通常的方式，因为它删除空




x = "flowSet", f = "character", drop = "ANY"  Coerce f to
x =“flowSet”，F =“字符”，降=“任何”要挟f




x = "flowSet", f = "numeric", drop = "ANY"  Coerce f
x =“flowSet”，F =“数值”，降“任何”要挟“f




x = "flowSet", f = "list", drop = "ANY"  Split a flowSet by a list of filterResults (as typically returned by filtering operations on a flowSet). The length of the list has to be equal to the length of the flowSet and every list item needs to be a filterResult of equal class with the same parameters.  Instead of returning a list, the additional logical argument codeflowSet makes the method return an object of class flowSet. The optional population argument takes a character vector indicating the subpopulations to use for splitting (as identified by the population name in the filterDetails slot).  Alternatively, this can be a list of characters, in which case the populations for each list item are collapsed into one flowFrame. Note that using the population argument implies common population names for allfilterResults in the list and there will
x =“flowSet”，F =“名单”，下降的“ANY”拆分由flowSet的名单的filterResult（过滤操作通常返回一个flowSet ）。列表的长度是相等的长度flowSet和每一个列表项需要是一个平等类filterResult的具有相同的参数。返回一个列表，而不是额外的逻辑论证codeflowSet使得该方法返回一个对象的类flowSet。可选的population参数需要一个特征向量表示，亚分裂使用（如人口名称确定在filterDetails插槽）。另外，这可以是一个字符列表，在这种情况下，每个列表项的人口进入一个flowFrame倒塌。注意使用population参数意味着列表中的所有filterResult的共同人口的名称和有


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


F Hahne, B. Ellis, N. Le Meur



举例----------Examples----------



data(GvHD)
qGate <- quadGate(filterId="qg", "FSC-H"=200, "SSC-H"=400)

## split a flowFrame by a filter that creates[＃创建一个过滤器，分裂1 flowFrame]
## a multipleFilterResult[＃multipleFilterResult]
samp <- GvHD[[1]]
fres <- filter(samp, qGate)
split(samp, qGate)

## return a flowSet rather than a list[＃返回flowSet，而不是一个列表。]
split(samp, fres, flowSet=TRUE)

## only keep one population[＃只保留一个人口]
names(fres)
##split(samp, fres, population="FSC-Height+SSC-Height+")[＃分裂（桑普，FRES，人口=“FSC高度+ SSC的高+”）]


## split the whole set, only keep two populations[＃分裂整套，只保留两个群体]
##split(GvHD, qGate, population=c("FSC-Height+SSC-Height+",[分裂（移植物抗宿主病，qGate，人口= C（“FSC高度+ SSC的高度+”＃，]
##"FSC-Height-SSC-Height+"))[＃“FSC高度南南合作高+”））]

## now split the flowSet according to a factor[＃现在分裂因素的flowSet]
split(GvHD, pData(GvHD)$Patient)


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


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