create_citation: Create a citation for an <epiparameter> object

View source: R/epiparameter-utils.R

create_citationR Documentation

Create a citation for an ⁠<epiparameter>⁠ object

Description

A helper function when creating an ⁠<epiparameter>⁠ object to create a citation list with sensible defaults, type checking and arguments to help remember which citation information is accepted in the list.

Usage

create_citation(
  author = utils::person(),
  year = NA_integer_,
  title = NA_character_,
  journal = NA_character_,
  doi = NA_character_,
  pmid = NA_integer_
)

Arguments

author

Either a ⁠<person>⁠, a character string, or a vector or list of characters in the case of multiple authors. Specify the full name (⁠"<given name>" "<family name>"⁠). When using characters make sure the name can be converted to a ⁠<person>⁠ (see as.person()). Use white space separation between names. Multiple names can be stored within a single ⁠<person>⁠ (see person()).

year

A numeric of the year of publication.

title

A character string with the title of the article that published the epidemiological parameters.

journal

A character string with the name of the journal that published the article that published the epidemiological parameters. This can also be a pre-print server, e.g., medRxiv.

doi

A character string of the Digital Object Identifier (DOI) assigned to papers which are unique to each paper.

pmid

A character string with the PubMed unique identifier number (PMID) assigned to papers to give them a unique identifier within PubMed.

Details

This function acts as a wrapper around bibentry() to create citations for sources reporting epidemiological parameters.

Value

A ⁠<bibentry>⁠ object of the citation

Examples

create_citation(
  author = person(given = "John", family = "Smith"),
  year = 2002,
  title = "COVID-19 incubation period",
  journal = "Epi Journal",
  doi = "10.19832/j.1366-9516.2012.09147.x"
)

epiparameter documentation built on April 3, 2025, 5:50 p.m.