lbsImportDocuments: Import bibliographic data into a Local Bibliometric Storage.
In CITAN: CITation ANalysis Toolpack

lbsImportDocuments

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

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.