CITAN (version 2011.08-1)

lbsSearchDocuments: Find documents meeting given criteria

Description

Searches for documents meeting given criteria (e.g. document titles, documents' authors identifiers, number of citations, number of pages, publication years or document types).

Usage

lbsSearchDocuments(conn, titles.like, idAuthors, citations.expr,
    pages.expr, year.expr, documentTypes, surveyDescription)

Arguments

conn

a connection object as produced by lbsConnect.

titles.like

a character vector of SQL-LIKE patterns to match documents' titles or NULL.

idAuthors

a numeric or integer vector with author identifiers (see column IdAuthor in the table Biblio_Authors) or NULL.

citations.expr

an expression determining the desired number of citations or NULL, see Examples below.

pages.expr

an expression determining the desired number of pages or NULL, see Examples below.

year.expr

an expression determining the desired publication year or NULL, see Examples below.

documentTypes

character vector or NULL; specifies document types to restrict to; a combination of Article, Article in Press, Book, Conference Paper, Editorial, Erratum, Let

surveyDescription

single character string or NULL; survey description to restrict to or NULL.

Value

• Integer vector of documents' identifiers matching given criteria.

Details

titles.like is a set of search patterns in an SQL LIKE format, i.e. an underscore _ matches a single character and a percent sign % matches any set of characters. The search is case-insensitive.

The expressions passed as parameters citations.expr, pages.expr, year.expr must be acceptable by SQL WHERE clause in the form WHERE field , see Examples below.

See Also

lbsGetInfoAuthors, lbsSearchAuthors, lbsGetInfoDocuments, lbsFindDuplicateTitles

Examples

conn <- dbBiblioConnect("Bibliometrics.db");
## ...
idd <- lbsSearchDocuments(conn, pages.expr=">= 400",
year.expr="BETWEEN 1970 AND 1972");
lbsGetInfoDocuments(conn, idd);
## ...