misc: add list of publications citing the package

Author: aoles

.Rbuildignore

@@ -2,6 +2,7 @@
 ^\.Rproj\.user$
 ^man-roxygen$
 ^README\.Rmd$
+^references.*$
 ^Makefile$
 ^pkgdown$
 ^docs$

Makefile

@@ -7,7 +7,9 @@ RSCRIPT = Rscript --vanilla
 %.md: %.Rmd
 	${RSCRIPT} -e 'rmarkdown::render("$<")'
 
-README.md: vignettes/${PKGNAME}.Rmd NEWS.md
+README.md: vignettes/${PKGNAME}.Rmd NEWS.md references.md
+
+references.md: references.bib
 
 readme: README.md
 

README.Rmd

@@ -44,7 +44,7 @@ cat(sprintf(opts_str, paste0(ors_paths, collapse = paste(",", indent, sep="\n"))
 options(openrouteservice.path = list(directions = "v2/directions"))
 ```
 
-## Package News
+## Recent package news
 
 ```{r news, echo = FALSE, results = 'asis'}
 lines = readLines("NEWS.md")
@@ -58,3 +58,15 @@ news = lines[from:to]
 news = gsub("^(#+)(.*)", "##\\1\\2", news)
 cat(paste(news, collapse = "\n"))
 ```
+
+## Publications citing openrouteservice R package
+
+Please feel free to reach out if you would like to have your work added to the list below.
+
+```{r references, echo = FALSE, results = 'asis'}
+lines = readLines("references.md")
+lines = gsub('^<span class="csl-left-margin">', '', lines)
+lines = gsub('^</span><span class="csl-right-inline">', '', lines)
+lines = gsub(' </span>$', '', lines)
+cat(paste(lines, collapse = "\n"))
+```

README.md

@@ -68,7 +68,7 @@ defaults are equivalent of having
                                           optimization = "optimization",
                                           snap = "v2/snap"))
 
-## Package News
+## Recent package news
 
 ### version 0.5.2
 
@@ -87,3 +87,30 @@ defaults are equivalent of having
 #### NEW FEATURES
 
 -   Enable snap endpoint.
+
+## Publications citing openrouteservice R package
+
+Please feel free to reach out if you would like to have your work added
+to the list below.
+
+1.  Baumer BS, Kaplan DT, Horton NJ. Modern data science with r.
+    Chapman; Hall/CRC; 2017.
+
+2.  Shields N, Willis C, Imms C, McKenzie G, Van Dorsselaer B, Bruder
+    AM, et al. Feasibility of scaling-up a community-based exercise
+    program for young people with disability. Disability and
+    Rehabilitation. 2022;44(9):1669–81.
+
+3.  Cubells J, Miralles-Guasch C, Marquet O. E-scooter and bike-share
+    route choice and detours: Modelling the influence of built
+    environment and sociodemographic factors. Journal of transport
+    geography. 2023;111:103664.
+
+4.  Bhowon Y, Prendergast LA, Taylor NF, Shields N. Using geospatial
+    analysis to determine the proximity of community gyms for a
+    population-based cohort of young people with cerebral palsy.
+    Physiotherapy Canada. 2023;e20220064.
+
+5.  Jain A, LaValley M, Dukes K, Lane K, Winter M, Spangler KR, et
+    al. Modeling health and well-being measures using ZIP code spatial
+    neighborhood patterns. Scientific Reports. 2024;14(1):9180.

references.Rmd

@@ -0,0 +1,6 @@
+---
+output: rmarkdown::md_document   
+bibliography: references.bib
+csl: references.csl
+nocite: '@*'
+---

references.bib

@@ -0,0 +1,47 @@
+@book{baumer2017modern,
+  title={Modern data science with R},
+  author={Baumer, Benjamin S and Kaplan, Daniel T and Horton, Nicholas J},
+  year={2017},
+  publisher={Chapman and Hall/CRC}
+}
+
+@article{shields2022feasibility,
+  title={Feasibility of scaling-up a community-based exercise program for young people with disability},
+  author={Shields, Nora and Willis, Claire and Imms, Christine and McKenzie, Georgia and Van Dorsselaer, Ben and Bruder, Andrea M and Kennedy, Rachel A and Bhowon, Yeshna and Southby, Alesha and Prendergast, Luke A and others},
+  journal={Disability and Rehabilitation},
+  volume={44},
+  number={9},
+  pages={1669--1681},
+  year={2022},
+  publisher={Taylor \& Francis}
+}
+
+@article{cubells2023scooter,
+  title={E-scooter and bike-share route choice and detours: modelling the influence of built environment and sociodemographic factors},
+  author={Cubells, Jer{\`o}nia and Miralles-Guasch, Carme and Marquet, Oriol},
+  journal={Journal of transport geography},
+  volume={111},
+  pages={103664},
+  year={2023},
+  publisher={Elsevier}
+}
+
+@article{bhowon2023using,
+  title={Using Geospatial Analysis to Determine the Proximity of Community Gyms for a Population-based Cohort of Young People with Cerebral Palsy},
+  author={Bhowon, Yeshna and Prendergast, Luke A and Taylor, Nicholas F and Shields, Nora},
+  journal={Physiotherapy Canada},
+  pages={e20220064},
+  year={2023},
+  publisher={University of Toronto Press}
+}
+
+@article{jain2024modeling,
+  title={Modeling health and well-being measures using ZIP code spatial neighborhood patterns},
+  author={Jain, Abhi and LaValley, Michael and Dukes, Kimberly and Lane, Kevin and Winter, Michael and Spangler, Keith R and Cesare, Nina and Wang, Biqi and Rickles, Michael and Mohammed, Shariq},
+  journal={Scientific Reports},
+  volume={14},
+  number={1},
+  pages={9180},
+  year={2024},
+  publisher={Nature Publishing Group UK London}
+}