lbsImportDocuments {CITAN} | R 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 |
data |
11 column |
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 ( |
originalFilename |
original filename; |
excludeRows |
a numeric vector with row numbers of |
updateDocumentIfExists |
logical; if |
warnSourceTitle |
logical; if |
warnExactDuplicates |
logical; |
verbose |
logical; |
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)