{"Package":"SDGdetector","Title":"Detect SDGs and Targets in Text","Version":"2.7.3","Authors@R":"c(\nperson(\"Yingjie\", \"Li\", email = \"yingjieli.edu@gmail.com\", role = c(\"aut\", \"cre\"), comment = c(ORCID = \"0000-0002-8401-0649\")),\nperson(\"Veronica\", \"Frans\", email = \"verofrans@gmail.com\", role = \"aut\", comment = c(ORCID = \"0000-0002-5634-3956\")),\nperson(\"Yongze\", \"Song\", email = \"yongze.song@outlook.com\", role = \"aut\", comment = c(ORCID = \"0000-0003-3420-9622\")),\nperson(\"Meng\", \"Cai\", email = \"mengcai24601@gmail.com\", role = \"aut\", comment = c(ORCID = \"0000-0002-8318-572X\")),\nperson(\"Yuqian\", \"Zhang\", email = \"zhan1364@msu.edu\", role = \"aut\", comment = c(ORCID = \"0000-0001-7576-2526\")),\nperson(\"Jianguo\", \"Liu\", email = \"liuji@msu.edu\", role = \"aut\", comment = c(ORCID = \"0000-0001-6344-0087\"))\n)","Description":"Identify 17 Sustainable Development Goals and associated 169 targets in text.","URL":"https://github.com/Yingjie4Science/SDGdetector","BugReports":"https://github.com/Yingjie4Science/SDGdetector/issues","Imports":"dplyr, magrittr, stringr, ggplot2, tidyr, grDevices,\nrnaturalearth, utils, scales, magick","Depends":"R (>= 3.5.0)","License":"GPL (>= 3)","Encoding":"UTF-8","RoxygenNote":"7.2.3","LazyData":"true","NeedsCompilation":"no","Packaged":"2023-05-23 23:21:45 UTC; pc","Suggests":"testthat (>= 3.0.0)","Config/testthat/edition":"3","Author":"Yingjie Li [aut, cre] (),\nVeronica Frans [aut] (),\nYongze Song [aut] (),\nMeng Cai [aut] (),\nYuqian Zhang [aut] (),\nJianguo Liu [aut] ()","Maintainer":"Yingjie Li ","Repository":"CRAN","Date/Publication":"2023-05-23 23:52:04 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/SDGdetector_2.7.3.tar.gz","jsonAuthors":[{"name":"Yingjie Li","email":"yingjieli.edu@gmail.com","maintainer":true},{"name":"Veronica Frans","email":"verofrans@gmail.com","maintainer":false},{"name":"Yongze Song","email":"yongze.song@outlook.com","maintainer":false},{"name":"Meng Cai","email":"mengcai24601@gmail.com","maintainer":false},{"name":"Yuqian Zhang","email":"zhan1364@msu.edu","maintainer":false},{"name":"Jianguo Liu","email":"liuji@msu.edu","maintainer":false}],"readme":"[![CRAN\\_Status\\_Badge](https://www.r-pkg.org/badges/version/SDGdetector)](https://CRAN.R-project.org/package=SDGdetector)\n[![DOI](https://zenodo.org/badge/431620191.svg)](https://zenodo.org/badge/latestdoi/431620191)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![CRAN downloadcount](https://cranlogs.r-pkg.org/badges/grand-total/SDGdetector)](https://cranlogs.r-pkg.org/badges/grand-total/SDGdetector)\n[![CRAN downloadcount](https://cranlogs.r-pkg.org/badges/SDGdetector)](https://cranlogs.r-pkg.org/badges/SDGdetector)\n![Visitor Badge](https://visitor-badge.laobi.icu/badge?page_id=yingjieli.visitor-badge)\n[![DOI](https://joss.theoj.org/papers/10.21105/joss.05124/status.svg)](https://doi.org/10.21105/joss.05124)\n\n

\n \n

\n\n# SDG Detector\n\nIn 2015, leaders worldwide adopted 17 Sustainable Development Goals (SDGs) with 169 targets to be achieved by 2030 (https://sdgs.un.org). The framework of SDGs serves as a blueprint for shared prosperity for both people and the earth. `SDGdetector` identifies both direct and indirect expressions of SDGs and associated targets in chunks of text. It takes a data frame with a specified column of text to process as inputs, and outputs a data frame with original columns plus matched SDGs and targets.\n\n## Installation\n\nThere are two ways to install the **SDGdetector** R package.\n\n### 1. CRAN\n\n**SDGdetector** is now available on\n[CRAN](https://CRAN.R-project.org/package=SDGdetector), so you can install it with:\n\n``` r\ninstall.packages(\"SDGdetector\")\n```\n\n### 2. GitHub\n\nYou can alternatively install the development version of **SDGdetector** from [GitHub](https://github.com/Yingjie4Science/SDGdetector) as follows:\n\n``` r\nif (!require(\"remotes\")) {\n install.packages(\"remotes\")\n}\n\nremotes::install_github(\"Yingjie4Science/SDGdetector\")\n``` \n \n## Example Usage\n\n**To detect SDGs from text**\n``` r\nlibrary(SDGdetector)\n\n### string as input data\ntext <- 'our goal is to mitigate climate change, end poverty, and reduce inequality globally'\nSDGdetector(x = text)\n\n### dataframe as input data\ndf <- data.frame(col = c(\n 'our goal is to end poverty globally', \n 'this product contributes to slowing down climate change'))\nSDGdetector(x = df, col = col)\n```\n\n**To detect regions/countries in text**\n``` r\nx = 'China and USA devoted the largest efforts on solar energy'\ndetect_region(x)\n```\n\n**To use specific SDG colors**\n``` r\nsdg_color(1)\nsdg_color(x = 1:17)\n```\n\n\n**To use specific SDG icons**\n``` r\nsdg_icon(x = 7, res = 300)\n```\n\n\n**To visualize SDG on a bar plot**\n``` r\ndata(\"sdgstat\")\ndf <- sdgstat\n\n# plot SDG on a bar plot\nplot_sdg_bar(data = df, sdg = SDG, value = Value)\n```\n

\n \n

\n\n**To visualize SDG on a map**\n```r\n# plot SDG by country on a map\nplot_sdg_map(data = df, sdg = SDG, value = Value, country = Country, by_sdg = F)\n```\n

\n \n

\n\n## Accuracy Evaluation\n\nThis package has achieved high accuracy in detecting SDG-related statements within textual data (> 75%, measured by the alignment between the R package results and four experts' manually-coded results; see this [supplementary document](https://drive.google.com/file/d/1EHUV6Jc3N4A-IshKU4dbxtIqlfj50mzi/view?usp=share_link) for more information. The data and code for reproducing the performance metrics can be found in this repo under [`./docs/accuracy_evaluation/`](https://github.com/Yingjie4Science/SDGdetector/tree/main/docs/accuracy_evaluation). \n\n

\n \n

\nThe overall accuracy (left) and the accuracy for each round of inspection (right). The red squared dot in the left plot indicates the mean value and the hollow round dots represent the accuracy values reported by each expert.\n\n\n## License\n\nThe SDGdetector **R** package is distributed under the [GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.en.html).\n\n\n## How to Cite\n\nGet citation information for *SDGdetector* in R doing\n `citation(package = 'SDGdetector')`\n \n```\nTo cite SDGdetector in publications, please use:\n\n Li, Y., Frans, V.F., Song, Y., Cai, M., Zhang, Y., Liu, J. (2023). SDGdetector: an R-based text mining tool for quantifying efforts toward Sustainable Development Goals. Journal of Open Source Software 8(84), 5124. https://doi.org/10.21105/joss.05124.\n\nA BibTeX entry for LaTeX users is\n\n @Article{,\n title = {SDGdetector: an R-based text mining tool for quantifying efforts toward Sustainable Development Goals},\n author = {Yingjie Li and Veronica F. Frans and Yongze Song and Meng Cai and Yuqian Zhang and Jianguo Liu},\n journal = {Journal of Open Source Software},\n year = {2023},\n volume = {8},\n number = {84},\n pages = {5124},\n doi = {10.21105/joss.05124},\n url = {https://github.com/Yingjie4Science/SDGdetector}\n }\n```\n\n\n## Reporting Bugs\n\n*SDGdetector* is distributed as is and without warranty of suitability for application. If you encounter flaws with the software (i.e. bugs) please report the issue. Providing a detailed description of the conditions under which the bug occurred will help to identify the bug. *Use the [Issues tracker](https://github.com/Yingjie4Science/SDGdetector/issues) on GitHub to report issues with the software and to request feature enhancements.* \n","jobInfo":{"package":"SDGdetector","version":"2.7.3","parsingStatus":"success","parserVersion":2,"parsedAt":"2023-05-24T00:30:06+0000"}}

Description

Usage

Value

Arguments

Examples