lbsSearchDocuments: Find documents that satisfy given criteria

In CITAN: CITation ANalysis Toolpack

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.

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.

Value

Integer vector of documents' identifiers matching given criteria.

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);
## ...
## End(Not run)

CITAN documentation built on Aug. 8, 2025, 6:10 p.m.