Scopus_ReadCSV

0th

Percentile

Import bibliography entries from a CSV file.

Reads bibliography entries from a UTF-8 encoded CSV file.

Usage
Scopus_ReadCSV(filename, stopOnErrors = TRUE, dbIdentifier = "Scopus", alternativeIdPattern = "^.*\\id=|\\&.*$", ...)
Arguments
filename
the name of the file which the data are to be read from, see read.csv.
stopOnErrors
logical; TRUE to stop on all potential parse errors or just warn otherwise.
dbIdentifier
character or NA; database identifier, helps detect parse errors, see above.
alternativeIdPattern
character; regular expression used to extract AlternativeId, NA to get the id as is,
...
further arguments to be passed to read.csv.
Details

The read.csv function is used to read the bibliography. You may therefore freely modify its behavior by passing further arguments (...), see the manual page of read.table for details.

The CSV file should consist at least of the following columns.

  1. Authors: Author name(s) (surname first; multiple names are comma-separated, e.g. “Smith John, Nowak G. W.”),
  2. Title: Document title,
  3. Year: Year of publication,
  4. Source.title: Source title, e.g. journal name,
  5. Volume: Volume number,
  6. Issue: Issue number,
  7. Page.start: Start page number,
  8. Page.end: End page number,
  9. Cited.by: Number of citations received,
  10. Link: String containing unique document identifier, by default of the form ...id=UNIQUE_ID&... (see alternativeIdPattern parameter),
  11. Document.Type: Document type, one of: “Article”, “Article in Press”, “Book”, “Conference Paper”, “Editorial”, “Erratum”, “Letter”, “Note”, “Report”, “Review”, “Short Survey”, or NA (other categories are treated as NAs),
  12. Source: Data source identifier, must be the same as the dbIdentifier parameter value. It is used for parse errors detection.

The CSV file to be read may, for example, be created by SciVerse Scopus (Export format=comma separated file, .csv (e.g. Excel), Output=Complete format or Citations only). Note that the exported CSV file sometimes needs to be corrected by hand (wrong page numbers, single double quotes in character strings instead of two-double quotes etc.). We suggest to make the corrections in a “Notepad”-like application (in plain text). The function tries to indicate line numbers causing potential problems.

Value

A data.frame containing the following 11 columns:
Authors
Author name(s), comma-separated, surnames first.
Title
Document title.
Year
Year of publication.
AlternativeId
Unique document identifier.
SourceTitle
Title of the source containing the document.
Volume
Volume.
Issue
Issue.
PageStart
Start page; numeric.
PageEnd
End page; numeric.
Citations
Number of citations; numeric.
DocumentType
Type of the document; see above.
The object returned may be imported into a local bibliometric storage via lbsImportDocuments.

See Also

Scopus_ASJC, Scopus_SourceList, lbsConnect, Scopus_ImportSources, read.table, lbsImportDocuments

Aliases
  • Scopus_ReadCSV
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.