Queries the Getty ULAN to find matching entries for a given string. You may filter the results by specifying an early or late date.
1 2 3 4 5 6 7 8 9 10 11
ulan_match(names, early_year = -9999, late_year = 2090, strictly_between = FALSE, method = c("sparql", "local"), max_results = 5, cutoff_score = NULL) ulan_id(names, early_year = -9999, late_year = 2090, strictly_between = FALSE, method = c("sparql", "local"), max_results = 1) ulan_data(names, early_year = -9999, late_year = 2090, strictly_between = FALSE, method = c("sparql", "local"), max_results = 1)
A character vector of names to match to a canonical ULAN id.
Match only artists who died after this year. Like
Match only artists who were born before this year.
Method for filtering search results using the early_year/late_year parameters. TRUE will only include artists whose life dates fall within the range [late_year, early_year]. FALSE (the default) will include artists whose life dates intersect with [early_year, late_year]
This value determines which method will be used to match the
name to a canonical ULAN id.
The maximum number of results to return. Defaults to 5.
Depending on the query, the actual number of results returned may be lower.
The minimum similarity score that must be returned by the
chosen method for a candidate to be included in results.
A named list of data.frames, one per submitted name, with 7 columns
and no more than
integer. ULAN id
character. ULAN preferred name
integer. Artist birth year, if assigned.
integer. Artist death year, if assigned
character. Artist gender, if assigned.
character. Artist nationality, if assigned.
numeric. The score of the result. When
"sparql", this is the Lucene index score. When
method = "local", it
will instead be a cosine similarity score. Results with a score below
cutoff_score are dropped.
Unmatched names will return a data.frame with NAs for all values save
ulan_id: Return a vector of matching ULAN IDs. This function is a wrapper around ulan_match that simply returns a
vector of the top match ID for each name given (as if
max_results will be ignored.
ulan_data: Return a dataframe of matching ULAN IDs with attributes, with an additional column
names containing the original input vector. This function is a wrapper around ulan_match.
cutoff_score will be ingored for
method = "sparql" requires an internet connection.
1 2 3 4 5 6
## Not run: ulan_id("Rembrandt", early_year = 1600, late_year = 1700, method = "sparql") ## End(Not run) ## Not run: ulan_id(c("Rembrandt", "Rothko"), early_year = c(1600, 1900), late_year = c(1700, 2000), method = "sparql") ## End(Not run)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.