lbsImportDocuments: Import bibliographic data into a Local Bibliometric Storage.

View source: R/biblio.import.R

lbsImportDocumentsR Documentation

Import bibliographic data into a Local Bibliometric Storage.

Description

Imports bibliographic data from a special 11-column data.frame object (see e.g. Scopus_ReadCSV) into a Local Bibliometric Storage.

Usage

lbsImportDocuments(
  conn,
  data,
  surveyDescription = "Default survey",
  surnameFirstnameCommaSeparated = FALSE,
  originalFilename = attr(data, "filename"),
  excludeRows = NULL,
  updateDocumentIfExists = TRUE,
  warnSourceTitle = TRUE,
  warnExactDuplicates = FALSE,
  verbose = TRUE
)

Arguments

conn

a connection object, see lbsConnect.

data

11 column data.frame with bibliometric entries; see above.

surveyDescription

description of the survey. Allows for documents grouping.

surnameFirstnameCommaSeparated

logical; indicates wher surnames are separated from first names (or initials) by comma or by space (FALSE, default).

originalFilename

original filename; attr(data, "filename") used by default.

excludeRows

a numeric vector with row numbers of data to be excluded or NULL.

updateDocumentIfExists

logical; if TRUE then documents with existing AlternativeId will be updated.

warnSourceTitle

logical; if TRUE then warnings are generated if a given SourceTitle is not found in Biblio_Sources.

warnExactDuplicates

logical; TRUE to warn if exact duplicates are found (turned off by default).

verbose

logical; TRUE to display progress information.

Details

data must consist of the following 11 columns (in order). Otherwise the process will not be executed.

1 Authors character Author(s) name(s), comma-separated, surnames first.
2 Title character Document title.
3 Year numeric Year of publication.
4 SourceTitle character Title of the source containing the document.
5 Volume character Volume.
6 Issue character Issue.
7 PageStart numeric Start page; numeric.
8 PageEnd numeric End page; numeric.
9 Citations numeric Number of citations; numeric.
10 AlternativeId character Alternative document identifier.
11 DocumentType factor Type of the document.

DocumentType is one of “Article”, “Article in Press”, “Book”, “Conference Paper”, “Editorial”, “Erratum”, “Letter”, “Note”, “Report”, “Review”, “Short Survey”, or NA (other categories are interpreted as NA).

Note that if data contains a large number of records (>1000), the whole process may take a few minutes.

Sources (e.g. journals) are identified by SourceTitle (table Biblio_Sources). Note that generally there is no need to concern about missing SourceTitles of conference proceedings.

Each time a function is called, a new record in the table Biblio_Surveys is created. Such surveys may be grouped using the Description field, see lbsCreate.

Value

TRUE on success.

See Also

Scopus_ReadCSV, lbsConnect, lbsCreate

Examples

## Not run: 
conn <- lbsConnect("Bibliometrics.db");
## ...
data <- Scopus_ReadCSV("db_Polish_MATH/Poland_MATH_1987-1993.csv");
lbsImportDocuments(conn, data, "Poland_MATH");
## ...
lbsDisconnect(conn);
## End(Not run)

CITAN documentation built on March 22, 2022, 1:06 a.m.