lbsImportDocuments {CITAN}

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)