TRAMPR (version 1.0-8)

update.TRAMP: Interactively Alter a TRAMP Object

Description

This function allows some manual checking and correction of a TRAMP object. By default, it steps through each sample, and offers to (1) add a new known to the TRAMPknowns database within the TRAMP object (see add.known for details), (2) mark matches to be ignored in future calls to plot.TRAMP (see remove.TRAMP.match), (3) save the current plot as a PDF.

Usage

# S3 method for TRAMP
update(object, sample.fk=labels(object$samples), grouped=FALSE,
       ignore=TRUE, delay.rebuild=FALSE, default.species=NULL,
       filename.fmt="TRAMP_%d.pdf", ...)

Arguments

object

A TRAMP object.

sample.fk

A vector of sample.fk to cycle through. If omitted, this will default to all samples present in the TRAMPsamples component of the TRAMP object.

grouped, ignore

Plotting parameters, as in plot.TRAMP. Currently these cannot be altered from their default values.

delay.rebuild

Logical: Should the rebuild of the TRAMP object be delayed until the function returns? If this is FALSE (the default), then the TRAMP object will rebuild every time a new known is added. This may take a while for large objects, so if set to TRUE, then the TRAMP object will not be rebuilt until all sample.fks have been displayed. This means that any new samples added as knowns will not be included in plots.

default.species

Default species name for newly added knowns. Passed to add.known.

filename.fmt

Format used to generate filenames when saving PDFs. Include a "%d" to stand in for the sample.fk (so "TRAMP_%d.pdf" becomes "TRAMP_12.pdf" for sample.fk 12).

...

Further arguments passed to the plotting function plot.TRAMP.

Warning

If an error occurs while running update, all modifications will be lost.

Examples

# NOT RUN {
## Since this function runs interactively, there can be no sample.
# }