CITAN (version 2014.12-1)

Scopus_ReadCSV: Import bibliography entries from a CSV file.

Description

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.

Value

• A data.frame containing the following 11 columns: ll{ 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.

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&... (seealternativeIdPatternparameter),
11. Document.Type: Document type, one of:Article,Article in Press,Book,Conference Paper,Editorial,Erratum,Letter,Note,Report,Review,Short Survey, orNA(other categories are treated asNAs),
12. Source: Data source identifier, must be the same as thedbIdentifierparameter 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.

See Also

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

Examples

conn <- lbsConnect("Bibliometrics.db");
## ...
data <- Scopus_ReadCSV("db_Polish_MATH/Poland_MATH_1987-1993.csv");
lbsImportDocuments(conn, data, "Poland_MATH");
## ...
lbsDisconnect(conn);