lbsImportDocuments

0th

Percentile

Import bibliographic data into a Local Bibliometric Storage.

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. 1

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

Aliases
  • lbsImportDocuments
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)
Documentation reproduced from package CITAN, version 2015.12-2, License: LGPL (>= 3)

Community examples

Looks like there are no examples yet.