lbsImportDocuments: 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
)

Value

TRUE on success.

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.

Examples

Run this code

if (FALSE) {
conn <- lbsConnect("Bibliometrics.db");
## ...
data <- Scopus_ReadCSV("db_Polish_MATH/Poland_MATH_1987-1993.csv");
lbsImportDocuments(conn, data, "Poland_MATH");
## ...
lbsDisconnect(conn);}