vignettes/vignette_3_cite.md

In kamclean/impactr:

title: "2 - Citation of Research Outputs" date: "2020-10-04" always_allow_html: yes output: md_document: variant: gfm vignette: > %\VignetteIndexEntry{Vignette Title} %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8}

Citation of Research Outputs

The most common vehicles for research impact tend to be for presentations and publications of the work conducted. These often are often listed at both an individual- (CV) and institutional-level to demonstrate scholary activity.

1. ref_publication()

The ref_publication() function will accept direct input from both extract_pmid() and extract_doi(), however will also accept other dataframes with the prerequisite columns. These columns can be specified within the function. Other features include:

• Highlighting any missing data essential for citation (e.g. author, journal, etc). The issue, pmid, and doi are considered optional (depending on whether the dataset was generated from extract_pmid() or extract_doi()).

• Automatically displaying all authors, however the auth_max can be set from 1 to n to add "et al." for any authors beyond that number.

• The format can be customised via ref_format to match preferred referencing style (default is as shown below - Vancouver). Note the variable names in the string must exactly match an essential column (e.g. "author" not "Author" or "AUTHOR")

 out_doi %>%
  # If a single-authorship collaborative publication (e.g. "STARSurg Collaborative") then display that
  dplyr::mutate(author = ifelse(is.na(author_group)==TRUE, author, author_group)) %>%

  impactr::ref_publication(journal = "journal_full", max_auth = 10,
                   ref_format = "author. title. journal. year; volume (issue): pages. PMID: pmid. DOI: doi.") %>%

  dplyr::mutate(citation = gsub("\\]", "", gsub("\\[", "", as.character(citation)))) %>%
  dplyr::select(citation) %>%
  knitr::kable(format="html") %>% kableExtra::kable_styling(bootstrap_options = "striped", full_width = F)

citation Incomplete citation data: author. Nepogodiev D, Chapman SJ, Glasbey J, Kelly M, Khatri C, Drake TM, Kong CY, Mitchell H, Harrison EM, Fitzgerald JE, et al. Determining Surgical Complications in the Overweight (DISCOVER): a multicentre observational cohort study to evaluate the role of obesity as a risk factor for postoperative complications in general surgery. BMJ Open. 2015; 5 (7): e008811. DOI: http://dx.doi.org/10.1136/bmjopen-2015-008811. STARSurg Collaborative. Prognostic model to predict postoperative acute kidney injury in patients undergoing major gastrointestinal surgery based on a national prospective observational cohort study. BJS Open. 2018; 2 (6): 400-410. DOI: http://dx.doi.org/10.1002/bjs5.86.

 

2. ref_presentation()

Presentations of academic work are important additional research outputs, yet are often not recorded online and so cannot be extracted. Therefore, the ref_presentation() function will accept any dataframe with the prerequisite columns. The columns can be specified within the function. Other features include:

• Highlighting any missing data essential for citation (e.g. author, name of meeting/conference, etc). The type or level or presentation, and the date of the meeting/conference are considered optional for the purposes of citation.

• The format can be customised via ref_format to match preferred referencing style. Note the variable names in the string must exactly match an essential column (e.g. "author" not "Author" or "AUTHOR")

type level title con org con name con date start con date end con city con country author Poster International The effects of perioperative Angiotensin Converting Enzyme Inhibitors and Angiotensin Receptor Blockers on acute kidney injury in major elective non-cardiac surgery. A multicentre, prospective cohort study. ESCP (European Society of Coloproctology) International Conference 2018 2018-09-26 2018-09-28 Nice France STARSurg Collaborative Poster International The impact of intravenous contrast on post-operative acute kidney injury following major gastrointestinal and liver surgery ESCP (European Society of Coloproctology) International Conference 2018 2018-09-26 2018-09-28 Nice France STARSurg Collaborative Oral International EuroSurg Student Initiative - IMAGINE Study: Preliminary Results ESCP (European Society of Coloproctology) International Conference 2018 2018-09-26 2018-09-28 Nice France EuroSurg Collaborative Oral International NA RSM (Royal Society of Medicine) doctor as a scholar and a scientist: international research course for medical students and foundation year doctors 2018-10-13 2018-10-13 London UK STARSurg Collaborative Oral-Poster International Perioperative non-steroidal anti-inflammatory drugs (NSAID) administration and Acute Kidney Injury (AKI) in major gastrointestinal surgery: A national, multicentre, propensity matched cohort study ASiT (Association of Surgeons in Training) ASIT Conference 2019-03-22 2019-03-23 Belfast United Kingdom NA

 

impactr::ref_presentation(data_presentations, ref_format = "author. title. con_org con_name, con_date_range, con_city (con_country).") %>%

  dplyr::mutate(citation = gsub("\\]", "", gsub("\\[", "", as.character(citation)))) %>%
  dplyr::select(citation) %>%
  knitr::kable(format="html") %>% kableExtra::kable_styling(bootstrap_options = "striped", full_width = F)

citation STARSurg Collaborative. The effects of perioperative Angiotensin Converting Enzyme Inhibitors and Angiotensin Receptor Blockers on acute kidney injury in major elective non-cardiac surgery. A multicentre, prospective cohort study. ESCP (European Society of Coloproctology) International Conference 2018, 26th to 28th September 2018, Nice (France). STARSurg Collaborative. The impact of intravenous contrast on post-operative acute kidney injury following major gastrointestinal and liver surgery. ESCP (European Society of Coloproctology) International Conference 2018, 26th to 28th September 2018, Nice (France). EuroSurg Collaborative. EuroSurg Student Initiative - IMAGINE Study: Preliminary Results. ESCP (European Society of Coloproctology) International Conference 2018, 26th to 28th September 2018, Nice (France). Incomplete citation data: title. Incomplete citation data: author.

 

kamclean/impactr documentation built on Jan. 11, 2023, 2:51 p.m.