CITAN (version 2022.1.1)

lbsSearchDocuments: Find documents that satisfy 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 = NULL,
  idAuthors = NULL,
  citations.expr = NULL,
  pages.expr = NULL,
  year.expr = NULL,
  documentTypes = NULL,
  alternativeId = NULL,
  surveyDescription = NULL
)

Arguments

conn

connection object, see lbsConnect.

titles.like

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

idAuthors

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

citations.expr

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

pages.expr

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

year.expr

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, Letter, Note, Report, Review, Short Survey. NULL means no such restriction.

alternativeId

character vector of documents' AlternativeIds.

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 <expression>, see Examples below.

See Also

lbsGetInfoAuthors, lbsSearchAuthors, lbsGetInfoDocuments

Examples

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