correctError: The ZooImage error correction (manual validation) tools

In SciViews/zooimage: Analysis of Numerical Plankton Images

The ZooImage error correction (manual validation) tools

Description

Open a web page for manual validation and error correction of predicted abundances in samples.

Usage

correctError(zidb, classifier, data = zidbDatRead(zidb), mode = "validation",
fraction = 0.05, sample.min = 100, sample.max = 200, grp.min = 2,
random.sample = 0.1, algorithm = "rf", diff.max = 0.2, prop.bio = NULL,
reset = TRUE, result = NULL)

addItemsToTrain(train, CtxSmp, add.mode = "SV+NSV", threshold = NA,
    dropItemsToTrain = dropItemsToTrain)
dropItemsToTrain(train, cl, drop.nb)

activeLearning(train, add.mode = "SV+NSV", threshold = NA)

Arguments

zidb	Path to a Zidb file.
classifier	A ZIClass object appropriate for this sample and the desired classification.
data	A ZIDat or a ZITest object matching that sample (by default, it is the ZIDat object contained in the zidb file).
mode	The mode to use for error correction. By default, mode = "validation", where particles are manually validated. mode = "demo" is the same one, but it sorts particles according to the Class variable in data, ignoring changes made in the user interface (so that one can explain the logic of the process without care about how particles are manually resorted). Finally, mode = "stat" do not display the user interface at all and calculates all steps directly to show gain from the process from 0 to 100% of the particles validated.
fraction	The fraction of items to validate at each step (1/20th by default).
sample.min	Minimal number of items to take at each step.
sample.max	Maximal number of items to take at each step. In case the sample contains a very large number of items, the number of particles that are validated at each step are constrained by this parameter, and consequently, the total number of steps becomes large than 1/fraction, but usually, error correction allows to stop earlier.
grp.min	Minimal number of items to take for each group, on average.
random.sample	Fraction of random sample considered, when validating suspect items.
algorithm	Machine learning algorithm used to detect suspect items.
diff.max	Maximum difference allowed between probabilities in first and second class before considering the item is suspect.
prop.bio	Weight to apply to the groups for considering them as suspects (use biological or external considerations to build this).
reset	Do we reset analysis in the case a temporary file already exists for that sample (recommended).
result	Name of the object in the calling environment where the results will be stored (ZITest object). If not provided or NULL, it is the basename of the zidb file without extension plus _valid.
train	the training set to complete.
CtxSmp	the contextual samples containing validated items.
add.mode	the mode for adding items, "SV": Validated Suspects, "NSV": Validated Non-Suspects, or "SV+NSV": both (by default)).
threshold	the maximal number of items in each class of training set. This is used to decide when to drop items for the reworked training set.
dropItemsToTrain	the function to use to drop items in the training set (depending on threshold). By default, it is dropItemsToTrain(), but it could also be a custom function that has the same arguments.
cl	the class to consider.
drop.nb	the number of items to drop.

Value

correctError() returns nothing. It is called for its side-effect to install a web interface for manual validation of samples.

Author(s)

Philippe Grosjean <[e-mail]>

See Also

zidbDatRead

Examples

# TODO...

SciViews/zooimage documentation built on March 4, 2023, 4:03 a.m.