{"id":18921054,"url":"https://github.com/tzerk/rlumshiny","last_synced_at":"2025-07-28T07:05:34.613Z","repository":{"id":28644958,"uuid":"32164100","full_name":"tzerk/RLumShiny","owner":"tzerk","description":"A collection of shiny applications for the R package Luminescence.","archived":false,"fork":false,"pushed_at":"2025-04-08T06:59:52.000Z","size":1306,"stargazers_count":7,"open_issues_count":0,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-08T07:39:52.267Z","etag":null,"topics":["bootstrap","jscolor","luminescence","luminescence-dating","r","shiny","shiny-applications","tooltip"],"latest_commit_sha":null,"homepage":null,"language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tzerk.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.Rmd","contributing":null,"funding":null,"license":"LICENSE.note","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-03-13T15:34:03.000Z","updated_at":"2025-04-08T06:59:56.000Z","dependencies_parsed_at":"2024-11-08T10:49:59.117Z","dependency_job_id":"5cf584b2-2ac6-4af4-8326-9ce503e23477","html_url":"https://github.com/tzerk/RLumShiny","commit_stats":{"total_commits":300,"total_committers":7,"mean_commits":"42.857142857142854","dds":0.52,"last_synced_commit":"250ca2e4bad034f72c886c92d74bd86a817a4465"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzerk%2FRLumShiny","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzerk%2FRLumShiny/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzerk%2FRLumShiny/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tzerk%2FRLumShiny/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tzerk","download_url":"https://codeload.github.com/tzerk/RLumShiny/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249057448,"owners_count":21205904,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap","jscolor","luminescence","luminescence-dating","r","shiny","shiny-applications","tooltip"],"created_at":"2024-11-08T10:45:07.093Z","updated_at":"2025-07-28T07:05:34.601Z","avatar_url":"https://github.com/tzerk.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"README-\"\n)\n``` \n\n# RLumShiny \u003ca href='https://tzerk.github.io/RLumShiny/'\u003e\u003cimg src='man/figures/logo.png' align=\"right\" height=\"138.5\" /\u003e\u003c/a\u003e\n\n\u003c!-- badges: start --\u003e\n[![CRAN](https://www.r-pkg.org/badges/version/RLumShiny)](https://CRAN.R-project.org/package=RLumShiny)\n[![CRAN DOI](https://img.shields.io/badge/doi-10.32614/CRAN.package.RLumShiny-blue.svg)](https://doi.org/10.32614/CRAN.package.RLumShiny)\n[![Downloads](https://cranlogs.r-pkg.org/badges/grand-total/RLumShiny)](https://www.r-pkg.org/pkg/RLumShiny)\n[![Downloads](https://cranlogs.r-pkg.org/badges/RLumShiny)](https://www.r-pkg.org/pkg/RLumShiny)\n[![Downloads](https://cranlogs.r-pkg.org/badges/last-week/RLumShiny)](https://www.r-pkg.org/pkg/RLumShiny)\n[![Downloads](https://cranlogs.r-pkg.org/badges/last-day/RLumShiny)](https://www.r-pkg.org/pkg/RLumShiny)\n[![R-CMD-check](https://github.com/R-Lum/RLumShiny/actions/workflows/GitHub_Actions_CI.yaml/badge.svg)](https://github.com/R-Lum/RLumShiny/actions)\n\u003c!-- badges: end --\u003e\n\n\u003e Visit the \u003ca href=\"https://tzerk.github.io/RLumShiny/\" target=\"_blank\"\u003eproject page\u003c/a\u003e!\n\n# Overview\n\nA collection of `shiny` applications for the R package `Luminescence`. These mainly, but not exclusively, include applications for plotting chronometric data from e.g. luminescence or radiocarbon dating. It further provides access to twitter bootstraps tooltip and pop over functionality and contains the [jscolor.js library](https://jscolor.com/) with a custom `shiny` output binding.\n\n## Installation\n\nTo install the stable version from CRAN, simply run the following from an R console:\n\n```{r, eval = FALSE}\ninstall.packages(\"RLumShiny\")\n```\n\nTo install the latest development builds directly from GitHub, run\n\n```{r, eval = FALSE}\nif (!require(\"devtools\"))\n  install.packages(\"devtools\")\ndevtools::install_github(\"tzerk/RLumShiny@master\")\n```\n\n## Applications\n\nThe RLumShiny package provides a single function from which all apps can be started: `app_RLum()`. It essentially only takes one argument, which is a unique keyword to specify which app to start. See the table below for a list of available apps and which keywords to use.\n\n| Application | Keyword | Function |\n|-------------|:---------:|----------|\n| Abanico Plot | abanico | `plot_AbanicoPlot` |\n| Histogram | histogram | `plot_Histogram` |\n| Kernel Density Estimate Plot | KDE | `plot_KDE` |\n| Radial Plot | radialplot | `plot_RadialPlot` |\n| Dose Recovery Test | doserecovery | `plot_DRTResults` |\n| Cosmic Dose Rate | cosmicdose | `calc_CosmicDoseRate`|\n| Calculate Aliquot Size | aliquotsize | `calc_AliquotSize` |\n| CW Curve Transformation | transformCW | `convert_CW2pHMi`, `convert_CW2pLM`, `convert_CW2pLMi`, `convert_CW2pPMi` |\n| Plot Filter Combinations | filter | `plot_FilterCombinations` |\n| Calculate Fast Ratio | fastratio | `calc_FastRatio` |\n| Fading measurement analysis and correction | fading | `analyse_FadingMeasurement`, `calc_FadingCorr` |\n| Fading correction after Huntley 2006 | huntley2006 | `calc_Huntley2006` |\n| Analyse IRSAR RF measurements | irsarRF | `analyze_IRSAR.RF` |\n| Calculate Finite Mixture Model | finitemixture | `calc_FiniteMixture` |\n| Fit LM Curve | lmcurve | `fit_LMCurve` |\n| Test OSL/IRSL Stimulation Power | teststimulationpower | `plot_RLum` |\n| Scale Gamma Dose Rate† | scalegamma | `scale_GammaDose()` |\n| Model dose rate evolution in carbonate-rich samples | RCarb | `RCarb::model_DoseRate` |\n\nThe `app_RLum()` function is just a wrapper for `shiny::runApp()`. Via the `...` argument further arguments can be directly passed to `shiny::runApp()`. See `?shiny::runApp` for further details on valid arguments.\n\n\u003c!--- * Not yet available in the official CRAN release.  --\u003e\n† Requires the development version of the `Luminescence` package (\u003e v1.0.1) not yet on CRAN.\n\n## Extending Shiny\n\nIn addition to its main purpose of providing convenient access to the Luminescence shiny applications this package also provides further functions to extend the functionality of `shiny`. From the Bootstrap framework the JavaScript tooltip and popover components can be added to any shiny application via `tooltip()` and `popover()`.\n\nIt further provides a custom input binding to the JavaScript/HTML color picker [JSColor](https://jscolor.com). Offering access to most options provided by the JSColor API the function `jscolorInput()` is easily implemented in a shiny app. RGB colors are returned as hex values and can be directly used in **R**'s base plotting functions without requiring any format conversion.\n\n## Examples\n\n### Abanico Plot app \n\n`app_RLum(\"abanico\")`\n\n![Abanico app](man/figures/abanico.png)\n\n### Tooltip \n\n`tooltip(refId, text, attr = NULL, animation = TRUE, delay = 100, html = TRUE, placement = \"auto\", trigger = \"hover\")`\n\n![tooltip](man/figures/tooltip.png)\n\n### JSColor \n\n`jscolorInput(inputId, label, value, position = \"bottom\", color = \"transparent\", mode = \"HSV\", slider = TRUE, close = FALSE)`\n\n![jscolor.js](man/figures/jscolor.png)\n\n## Contribute\n\nThis package is part of the R [Luminescence](https://r-lum.github.io/Luminescence/) project. The is based on and evolves from ideas, contributions and constructive criticism of its users. Help us to maintain and develop the package, to find bugs and create new functions as well as a user-friendly design. Visit [r-luminescence website](https://r-luminescence.org) or leave a message under https://github.com/tzerk/RLumShiny/issues if anything crosses your mind or if you want your new self-written shiny application to be to implemented. You are kindly invited to bring forward the package with us!\n\n## Note\n\nThis version is a development version and it comes without any guarantee! For stable branches please visit\nthe package on [CRAN 'RLumShiny'](https://CRAN.R-project.org/package=RLumShiny).\n\n## License\n\nThe `'RLumShiny'` package is licensed under the GPL-3. See these files in the main directory for additional details: \n\n- [LICENSE.note](https://github.com/tzerk/RLumShiny/blob/master/LICENSE.note)\n\n## Funding\n\n* contributions from 2025 are supported through the DFG programme \n\"REPLAY: REProducible Luminescence Data AnalYses\" [No 528704761](https://gepris.dfg.de/gepris/projekt/528704761?language=en)\nled by Dr Sebastian Kreutzer (PI at Heidelberg University, DE) and Dr Thomas Kolb (PI at Justus-Liebig-University Giessen, DE).\n\n## Related projects \n\n* [RLumModel](https://github.com/R-Lum/RLumModel)\n* [Luminescence](https://github.com/R-Lum/Luminescence)\n* [RCarb](https://github.com/R-Lum/RCarb)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftzerk%2Frlumshiny","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftzerk%2Frlumshiny","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftzerk%2Frlumshiny/lists"}