Subset functions allow to conveniently split your data. subsetByQuality()
opens a shiny application in which histograms of aspects are displayed that summarize
the quality of a cells coverage.
See details for more information.
subsetByQuality(object, new_name = NULL, verbose = NULL)
object | A valid cypro object. |
---|---|
new_name | Character value. Denotes the name of the output object. If set to NULL the name of the input object is taken and suffixed with '_subset'. |
verbose | Logical. If set to TRUE informative messages regarding the computational progress will be printed. (Warning messages will always be printed.) |
An updated version of the input cypro
-object.
Creating subsets of your data affects analysis results such as clustering and correlation which
is why these results are reset in the subsetted object and must be computed again. To prevent inadvertent overwriting
the default directory is reset as well. Make sure to set a new one via setDefaultDirectory()
.
The mechanism with which you create the subset is stored in the output object. Use printSubsetHistory()
to reconstruct the way from the original object to the current one.
The histograms you see in the application provide insights into the distribution
of coverage quality assessments. (e.g. the distribution of numbers of frames that
have been skipped by cells or the first frame the cells appeared in.) You can
select the columns that contain the cells that match the quality requirements
of your choice. Eventually cells that match all the requirements you specified
are selected and the object is subsetted by subsetByCellId()
.
The requirements you set up are included in the message constructed and
printed by printSubsetHistory()
.