Launch the camtrapReport GUI

Launch an interactive Shiny interface for configuring and generating camtrapReport outputs from an existing camReport object.

Usage

gui(object, launch.browser, max_upload_mb, ...)

Arguments

object

A camReport object, usually created with camData().

launch.browser

A logical value (default TRUE) indicating whether the application is opened in the default web browser.

max_upload_mb

A numeric value (default 2000) giving the maximum file-upload size in megabytes.

...

Additional arguments passed to shiny::runApp().

Value

Invisibly returns the supplied camReport object after launching the application.

Details

The function starts a Shiny-based graphical user interface for editing report metadata, selecting report sections, defining focus groups, and generating data-status or ecological reports.

The GUI can be used with an existing camReport object and provides an interactive alternative to configuring reports directly in R. The output directory initially uses the project root from the optional here package when available, otherwise the object's dataset directory. Choose an existing directory explicitly before saving output. Existing report, R Markdown, and saved-object files are protected unless the overwrite checkbox is selected. Generating output does not change the R working directory.

See also

camData(), report(), status(), info()

Other report generation: report()

Examples

if (FALSE) { # interactive()
source_dataset <- system.file(
  "external",
  "dataset",
  package = "camtrapReport"
)
example_dataset <- tempfile("camtrapReport-example-")
dir.create(example_dataset)
invisible(file.copy(
  list.files(source_dataset, full.names = TRUE),
  example_dataset,
  recursive = TRUE
))

cm <- camData(example_dataset)

gui(cm)

unlink(example_dataset, recursive = TRUE, force = TRUE)
}