Skip to content

JsLth/gretan

Repository files navigation

R-CMD-check codecov License DOI

GRETA Analytics

GRETA Analytics (package name: {gretan}) is the GIS tool of the GRETA project (GReen Energy Transition Actions). The tool serves to present and visualize the research output of the project in an interactive fashion. It is specialized on spatial analysis and visualization, but hosts a variety of other information from the project. The package/app is built using the R Shiny and golemverse frameworks and the UI framework {bs4Dash}/AdminLTE3.

The package is licensed under Apache 2.0.

Access

Web deployment

The app is deployed on shinyapps.io and can be accessed using the following link: https://projectgreta.shinyapps.io/greta-analytics.

Binaries

The app is deployed as an Electron app using {electricShine}. Binaries are available here.

Running in R

The app is built under the {golem} framework and installs like an R package:

devtools::install_github("JsLth/gretan")
library(gretan)

The Shiny app can then be run using the following command:

run_greta()

Note that gretan requires a working Python >= 3.11 installation. Once installed, run_greta() tries to automatically detect Python and optionally installs all required dependencies.

Contributing

GRETA Analytics is designed to incorporate contributions from researchers and stakeholders. If you have conducted research and/or data analyses related to energy citizenship, energy transitions, energy justice, or anything energy in the EU, take a look at our contribution guidelines.

Citation

To cite the gretan package in a publication use:

Lieth, J. (2023). GRETA Analytics: GIS tool of the GRETA project. https://doi.org/10.5281/zenodo.10214281, https://github.com/JsLth/gretan

You can also cite the journal article discussing the development and architecture of the app/package:

Lieth, J., Abel, D., & Jünger, S. (2024). GRETA analytics: Communicating the spatial dimension of energy citizenship using a collaborative Shiny app. SoftwareX, 27, 101800. doi: 10.1016/j.softx.2024.101800

BibTeX entries for LaTeX users:

@Manual{,
  title = {gretan: The official GIS tool of the GRETA project},
  year = {2023},
  author = {Jonas Lieth},
  note = {R package version 0.5.2},
  doi = {10.5281/zenodo.10214281},
  url = {https://github.com/JsLth/gretan}
}
@article{,
  author = {Lieth, Jonas and Abel, Dennis and J{\ifmmode\ddot{u}\else\"{u}\fi}nger, Stefan},
  title = {{GRETA analytics: Communicating the spatial dimension of energy citizenship using a collaborative Shiny app}},
  journal = {SoftwareX},
  volume = {27},
  pages = {101800},
  year = {2024},
  publisher = {Elsevier},
  doi = {10.1016/j.softx.2024.101800}
}

Acknowledgements

GRETA Analytics was mainly developed by Jonas Lieth from GESIS - Leibniz Institute for the Social Sciences. The package and Shiny app was made possible thanks to the valuable contributions from various institutions including:

Institution Contribution
Lappeenranta-Lahti University of Technology
Persona quiz based on energy citizen clusters
Dutch Organization for Applied Scientific Research (TNO)
pLAtYpus model for stakeholder interaction modelling
Case study "Natural gas-free neighborhoods" wrap-up
Tecnalia Research & Innovation
Energy assessment using the Enerkad tool
Case study "UR Beroa" wrap-up
University of Bologna Case study "Pilastro-Roveri" wrap-up
Taxonomy of geographical levels
Fragility index
Fraunhofer Institute for Systems and Innovation Research (ISI)
Case study "Earnest app" wrap-up
Cleanwatts Digital
Case study "Coopérnico" wrap-up
Kaskas Media Minor editing and design inspiration

GRETA Analystics was developed as part of the GRETA project, which has received funding from the European Union's HORIZON 2020 Research and Innovation programme under grant agreement N°101022317.