% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/pubs.R
\docType{data}
\name{pubs}
\alias{pubs}
\title{Bibliographic Records for INLPO Publications}
\format{
An object of class 'pub' that inherits from the 'data.frame' class and
includes the following columns:
\describe{
\item{\code{pub_id}}{Unique identifier for the publication (the table's primary
key), in upper camel case (for example, \code{"FisherOthers2012"}).}
\item{\code{institution}}{Name of the institution that published and/or sponsored
the report.}
\item{\code{type}}{Type of publication, such as \code{"Open-File Report"},
\code{"Data Series"}, or \code{"Manual"}.}
\item{\code{text_ref}}{Text reference (the in-text citation) excluding the year of
publication, such as \code{"Dietz"} or \code{"Treinen and others"}.}
\item{\code{year}}{Year of publication.}
\item{\code{author_id}}{A named list of character vectors giving the identifier(s)
of the contributing author(s), in author order; each value is a foreign key
referencing the \code{author_id} primary key of the \code{\link{authors}} table. List names
match \code{pub_id}.}
\item{\code{title}}{Title of publication.}
\item{\code{bibentry}}{A named list of \link[utils:bibentry]{bibentry} objects holding
the full bibliographic record, from which formatted citations and BibTeX
entries are derived. List names match \code{pub_id}.}
\item{\code{abstract}}{Abstract of publication, or \code{NA} when unavailable.}
\item{\code{annotation}}{Annotation summarizing the publication, or \code{NA} when none
is provided.}
\item{\code{annotation_src}}{Identifier (\code{pub_id}) of the publication the annotation
was taken from, or \code{NA} when not applicable
(Knobel and others, 2005; Bartholomay, 2022).}
\item{\code{files}}{A named list of character vectors naming the file(s) associated
with the publication, primary document first, or \code{NULL} when no files are
recorded. List names match \code{pub_id}.}
}
}
\source{
Many of these publications are available through the
\href{https://pubs.usgs.gov/}{USGS Publications Warehouse}.
}
\usage{
pubs
}
\description{
Bibliographic information for reports, articles, maps, and theses
related to scientific monitoring and research conducted by the U.S. Geological
Survey (USGS), Idaho Water Science Center, Idaho National Laboratory Project
Office (INLPO).
}
\examples{
# Subset Fisher and others (2012) and display its structure:
id <- "FisherOthers2012"
pub <- pubs[id, ]
str(pub, max.level = 3, width = 75, strict.width = "cut")

# Print the suggested citation:
attr(unclass(pub$bibentry[[1]])[[1]], which = "textVersion")

# Print the authors' full names:
format(pub$bibentry[[1]]$author, include = c("given", "family"))

# Print the abstract:
pub$abstract
}
\references{
Bartholomay, R.C., 2022, Historical development of the U.S. Geological Survey
hydrological monitoring and investigative programs at the Idaho National Laboratory, Idaho, 2002-2020:
U.S. Geological Survey Open-File Report 2022-1027 (DOE/ID-22256), 54 p., \doi{10.3133/ofr20221027}.

Knobel, L.L., Bartholomay, R.C., and Rousseau, J.P., 2005,
Historical development of the U.S. Geological Survey hydrologic monitoring and investigative programs
at the Idaho National Engineering and Environmental Laboratory, Idaho, 1949 to 2001:
U.S. Geological Survey Open-File Report 2005--1223 (DOE/ID--22195), 93 p.,
\doi{10.3133/ofr20051223}.
}
\seealso{
\code{\link{authors}} for the contributing authors referenced by \code{author_id},
\code{\link{terms}} for term frequencies derived from publication text, and
\code{\link{search_terms}} to query publications by term.
}
\keyword{datasets}
