wikiTools (version 1.2.8)

w_Property: Get properties of Wikidata entities

Description

Search the entities of the entity_list for property or properties. If searched properties can have more than one language, then the parameter langsorder set the order of language used. If parameter includeQ is TRUE, also is returned the Wikidata entities for the properties. The Wikidata class of which the entities are instances of are returned too. Duplicated entities are deleted before search. Index of the data-frame is also set to entity_list.

Usage

w_Property(
  entity_list,
  Pproperty,
  includeQ = FALSE,
  langsorder = "en",
  nlimit = 10000,
  debug = FALSE
)

Value

A data-frame with the entity, the entities of the properties and the labels in langsorder for them.

Arguments

entity_list

A vector with de Wikidata entities.

Pproperty

Wikidata properties to search, separated with '|', mandatory. For example, is Pproperty="P21", the results contain information of the sex of entities. If Pproperty="P21|P569" also searches for birthdate. If Pproperty='P21|P569|P214' also searches for VIAF identifier.

includeQ

If the value is TRUE the function returns the Wikidata entity (Qxxx) of the Pproperty. If also langsorder has language(s), the labels, if any, are returned too. Note that includeQ is only effective if Pproperty corresponds with a Wikidata entity, else the same values that label are returned.

langsorder

Order of languages in which the information will be returned, separated with '|'. If no information is given in the first language, next is used. This parameter is mandatory if parameter includeQ if FALSE. If includeQ=TRUE and langsorder='' no labels are returned.

nlimit

If the number of entities exceeds this number, chunked queries are done. This is the number of entities requested in each chunk. Please, reduce the default value if error is raised.

debug

For debugging purposes (default FALSE). If debug='info' information about chunked queries is shown. If debug='query' also the query launched is shown.

Author

Angel Zazo, Department of Computer Science and Automatics, University of Salamanca

Examples

if (FALSE) {
w_Property(c("Q1252859", "Q712609", "Q381800"), Pproperty='P21|P569|P214', langsorder='en|es')
# Large list
df <- w_SearchByOccupation(Qoc='Q2306091') # ~ 20000
l <- df$entity
p <- w_Property(l, Pproperty='P21|P569|P214', langsorder='es|en', debug='info')
# Get birth-place (P19)
p <- w_Property(l, Pproperty='P19', langsorder='es|en', includeQ=TRUE, debug='info')
}