Allow users to add and subract from default annotations in addition to providing a given set of annotations.
decode_annotations(annotations, annotations.default = "colour.guide")character vector or a list of character vectors.
The recognized annotation names are: "summaries", "peaks",
"peak.labels", "valleys", "valley.labels",
"wls", "wls.labels", "colour.guide",
"color.guide", "boxes", "segments", "labels".
In addition, "+" is interpreted as a request to add to the already
present default annotations, "-" as request to remove annotations
and "=" or missing"+" and "-" as a request to reset
annotations to those requested. If used, "+", "-" or
"=" must be the first member of a character vector, and followed by
one or more of the names given above. To simultaneously add and remove
annotations one can pass a list containing character vectors
each assembled as described. The vectors are applied in the order they
appear in the list. To disable all annotations pass "" or
c("=", "") as argument. Adding a variation of an annotation already
present, replaces the existing one automatically: e.g., adding
"peak.labels" replaces"peaks" if present.
metadata retrieved from object object is
paased to ggplot2::ggtitle() as arguments for title,
subtitle and caption. The specification for the title is
passed as argument to annotations, and consists in the keyword
title with optional modifiers selecting the kind of metatdata to
use, separated by colons. Up to three keywords separated by colons are
accepted, and correspond to title, subtitle and caption. The recognized
keywords are: "objt", "class", "what", "when",
"where", "how", "inst.name", "inst.sn",
"comment" and "none" are recognized as modifiers to
"title"; "none" is a placeholder. Default is
"title:objt" or no title depending on the context.