Title: Visualisation and Annotation of 360 Degree Imagery
Version: 1.0.0.4
Description: Provides a customisable R 'shiny' app for immersively visualising, mapping and annotating panospheric (360 degree) imagery. The flexible interface allows annotation of any geocoded images using up to 4 user specified dropdown menus. The app uses 'leaflet' to render maps that display the geo-locations of images and panellum https://pannellum.org/, a lightweight panorama viewer for the web, to render images in virtual 360 degree viewing mode. Key functions include the ability to draw on & export parts of 360 images for downstream applications. Users can also draw polygons and points on map imagery related to the panoramic images and export them for further analysis. Downstream applications include using annotations to train Artificial Intelligence/Machine Learning (AI/ML) models and geospatial modelling and analysis of camera based survey data.
License: GPL (≥ 3)
URL: https://github.com/NunzioKnerr/pannotator_package_source
BugReports: https://github.com/NunzioKnerr/pannotator_package_source/issues
Imports: bslib, colourpicker, config, configr, dplyr, exiftoolr, geojsonsf, ggplot2, golem, graphics, grDevices, htmlwidgets, jpeg, jsonify, jsonlite, leaflet, leaflet.extras, leafpm, magrittr, readr, scales, sf, shiny, shinyFiles, shinyhelper, shinyjs, shinythemes, shinyWidgets, stringr, tools, utils
Suggests: knitr, rmarkdown, spelling, testthat (≥ 3.0.0)
VignetteBuilder: knitr
Config/testthat/edition: 3
Encoding: UTF-8
Language: en-US
RoxygenNote: 7.3.2
NeedsCompilation: no
Packaged: 2024-11-08 11:56:18 UTC; kne01b
Author: Nunzio Knerr ORCID iD [aut, cre], Robert Godfree ORCID iD [aut], Matthew Petroff [ctb], CSIRO [cph]
Maintainer: Nunzio Knerr <Nunzio.Knerr@csiro.au>
Repository: CRAN
Date/Publication: 2024-11-11 20:30:02 UTC

Pipe operator

Description

See magrittr::%>% for details.

Usage

lhs %>% rhs

Arguments

lhs

A value or the magrittr placeholder.

rhs

A function call using the magrittr semantics.

Value

The result of calling 'rhs(lhs)'.

Run the Shiny Application

Description

'run_app()' starts the Shiny application contained in this package, with an option to load settings from a YAML file using additional option: projectSettingsFile = "pathToYamlFile".

Usage

run_app(
  onStart = NULL,
  options = list(),
  enableBookmarking = NULL,
  uiPattern = "/",
  ...
)

Arguments

onStart

A function that will be called before the app is actually run. This is only needed for shinyAppObj, since in the shinyAppDir case, a global.R file can be used for this purpose.

options

Named options that should be passed to the runApp call (these can be any of the following: "port", "launch.browser", "host", "quiet", "display.mode" and "test.mode"). You can also specify width and height parameters which provide a hint to the embedding environment about the ideal height/width for the app.

enableBookmarking

Can be one of "url", "server", or "disable". The default value, NULL, will respect the setting from any previous calls to enableBookmarking(). See enableBookmarking() for more information on bookmarking your app.

uiPattern

A regular expression that will be applied to each GET request to determine whether the ui should be used to handle the request. Note that the entire request path must match the regular expression in order for the match to be considered successful.

...

Additional arguments to pass to 'golem_opts'. See '?golem::get_golem_options' for more details.

Details

This function initializes and runs the Shiny app developed with the golem framework. It optionally loads application-specific settings from a YAML file, which can be useful for project-specific configurations.

Value

No return value, called for side effects. Launches the Shiny app.

Examples

if (interactive()) {
  # Example: Run the application with default settings
  run_app()

  # Example: Run the application with a specific YAML configuration file
  run_app(projectSettingsFile = "C:/test-project.yml")
}