Description Usage Arguments Details Value Suggested Workflow Examples
This function allows for the construction of complex queries to search and retrieve data from the Lens. The default search groups documents by family and will return up to 50 results per page. The maximum number of results that can be retrieved is 500 (10 pages). For larger result sets use the free Lens online Collection facility to download upto 10,000 records. See details for information on the use of ranking and date measures to sort the data.
1 2 3 4 5 6 7 8 9 | lens_search(query, boolean = "NULL", type = "NULL", applicant = NULL,
applicant_boolean = "NULL", inventor = NULL, inventor_boolean = "NULL",
publn_date_start = NULL, publn_date_end = NULL,
filing_date_start = NULL, filing_date_end = NULL, rank_family = "NULL",
rank_citing = "NULL", rank_sequences = "NULL",
rank_latest_publn = "NULL", rank_earliest_publn = "NULL",
rank_latest_filing = "NULL", rank_earliest_filing = "NULL",
jurisdiction = "NULL", families = TRUE, results = NULL, timer = 20,
stemming = FALSE)
|
query |
One or more terms to search in the patent database. |
boolean |
Select the type of boolean ("OR" or "AND") where using multiple search terms. |
type |
Either fulltext (default), title, abstract, claims, or "tac" for 'title or abstract or claims'. abstract and claims (tac). Quoted. |
applicant |
An applicant name or vector of applicant names |
applicant_boolean |
"AND" or "OR". |
inventor |
An inventor name or vector of inventor names. |
inventor_boolean |
"AND" or "OR". |
publn_date_start |
Publication date limit to start at as YYYMMDD (numeric). |
publn_date_end |
Publication date limit to end at as YYYMMDD (numeric). |
filing_date_start |
Filing date limit to start at as YYYMMDD (numeric). |
filing_date_end |
Filing date limit to end at as YYYMMDD (numeric). |
rank_family |
Whether to sort the Lens results by the number of family members (descending). Useful for retrieving important documents. See details. |
rank_citing |
Whether to sort the Lens results by the top citing (descending). Useful for retrieving important documents. See details. |
rank_sequences |
Rank results on whether the documents contain a dna or amino acid sequence. See details. |
rank_latest_publn |
Sort results by the latest publication date. Useful for retrieving the most recent documents. See details. |
rank_earliest_publn |
Sort results by the earliest publication date. See details. |
rank_latest_filing |
Sort results by the latest filing (priority) date. Useful for identifying the latest filings (note that they are the latest filings that have a publication). See details. |
rank_earliest_filing |
Sort results by the earliest publication date. See details. |
jurisdiction |
Limit the search to a single jurisdiction (default is all) e.g. "US" or choose inbuilt group "main" for the United States (US), European Patent Office (EP), Japan (JP) or the World Intellectual Property Organization (WO) for the Patent Cooperation Treaty. |
families |
Either return the publication count and family numbers or if TRUE (default) return the patent families (deduplicates a set of publications to the first publication of the root "priority" or first filing). |
results |
The number of results to return, either 50 or 500 (maximum). |
timer |
Where retrieving over 50 results, the delay between sending requests to the Lens (default is 20 seconds, used internally by ops_iterate()). |
stemming |
Word stemming is set to FALSE by default. |
Ranking: Only one ranking measure may be used per query. For example, it is possible to rank by family scores but not family scores and latest publications or earliest publications.
a data.frame or tibble
A suggested work flow is to retrieve the latest publications, then rank by family and then rank_citing. This will allow the most recent and the most important documents to be retrieved in three steps for a given query.
Inventor Names: In patent databases the general convention is to list the surname (family name) and then the first names (given names). Name reversals can and do occur but normal practice is to use <surname, first name then initial> e.g. "Kirk James T" rather than "James T Kirk". However, be aware that there will be variations.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | ## Not run: lens_search("synthetic biology", timer = 30)
# Use boolean terms OR or AND to connect phrases
lens_search(synbio, boolean = "OR", timer = 30)
lens_search(synbio, boolean = "AND", timer = 30)
# search title, abstract, title, abstract or claims and rank by family size
lens_search(synbio, boolean = "OR", type = "title", rank_family = TRUE, timer = 30)
lens_search(synbio, boolean = "OR", type = "abstract", rank_family = TRUE, timer = 30)
lens_search(synbio, boolean = "OR", type = "tac", rank_family = TRUE, timer = 30)
# search title or abstract or claims and rank by citing
lens_search(synbio, boolean = "OR", type = "tac", rank_citing = TRUE, timer = 30)
# search for keyword, inventor and applicant names
lens_search(query = "synthetic genomics", inventor = "Venter Craig", applicant = "Synthetic Genomics")
lens_search(query = "synthetic genomics", inventor = "Venter Craig")
lens_search(query = "synthetic genomics", applicant = "Synthetic Genomics")
## End(Not run)
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.