View source for Help:Ranking

<languages/>
[[File:Rang wikidata.png|600x256px|thumb|<translate><!--T:39--> Ranks (in red rectangle)</translate>]]
<translate><!--T:1-->
'''Ranks''' provide a mechanism for annotating {{ll|Help:Statements#Multiple values|multiple values for a statement}}. The default rank is the "normal" rank; statements-value pairs may also be marked with "preferred" or "deprecated" ranks.

==What do ranked statements look like?== <!--T:42-->
</translate>
* <translate><!--T:43--> <tvar name="1">{{RankIcon|preferred}}</tvar> - statement has preferred rank</translate>
* <translate><!--T:44--> <tvar name="1">{{RankIcon|normal}}</tvar> - statement has normal rank</translate>
* <translate><!--T:45--> <tvar name="1">{{RankIcon|deprecated}}</tvar> - statement has deprecated rank</translate>

<translate>
==What ranks are for== <!--T:2-->

<!--T:3-->
Some statements naturally have multiple values. For example, {{Q|76}} has two children ({{P|40}}), {{Q|15070044}} and {{Q|15070048}}.

<!--T:4-->
Other statements should ideally only ever have one value, but can contain additional values that may provide historical information, an alternative perspective, or a different result depending on the method of measurement or scientific approach used. For example, the item for {{Q|Q100000001}} could have more than one value for the {{P|2196}} property: one dating from 2012 and one for <tvar name="1">{{#time:Y|-1year|{{TRANSLATIONLANGUAGE}}}}</tvar>.

<!--T:5-->
In this second example, only the <tvar name="1">{{#time:Y|-1year|{{TRANSLATIONLANGUAGE}}}}</tvar> value would be of relevance to those interested in the most recent and up-to-date student count of the school. Ranks are therefore used in order to allow users to easily differentiate between the multiple values of a statement.

===A note on queries=== <!--T:6-->

<!--T:7-->
[<tvar name="query">https://query.wikidata.org/</tvar> WDQS] enable users to perform predefined searches across all items in Wikidata. These searches can be complicated and compound, meaning retrieving results based on two or more conditions. Examples of possible Wikidata queries include "everything with a population of more than 1,000,000 that is a city" and even "every female artist who was born in a city of more than 1,000,000 in Japan."

<!--T:8-->
As you may have realized, it will not always be appropriate for all values of a statement to be returned when performing a query. Ranks therefore allow Wikidata users to improve the results of queries by selecting which values should be included in a search.

== What ranks are not == <!--T:9-->

<!--T:10-->
Ranks should not be confused with references which are used to point to specific sources that back up the data provided in a statement. While a reference will ideally point to a reputable and established source of information, it's possible for a source to provide information that is incorrect or not as accurate as it could be. References merely state where a data value comes from; ranks indicate what data value is considered the most correct and, by extension, what values should be included in queries.

<!--T:11-->
Ranks are not a way of asserting your view for a disputed value, but instead are used for communicating the consensus opinion for a statement. All disputes should be discussed on the item's discussion page. {{ll|Wikidata:Edit warring|Edit warring}} over values is not acceptable.

<!--T:37-->
There is however another way to state that a statement is disputed and by whom: the {{ll|Help:Qualifiers|qualifier}} {{P'|statement disputed by}}.

==Usage== <!--T:12-->

<!--T:13-->
Because ranks are used to differentiate multiple values for the same property, if a statement only has one value, it will have the default normal rank—there is no point adding the preferred rank in this situation.

<!--T:14-->
There can be any number of statements with each rank, i.e. more than one value can be assigned the preferred rank.

=== Normal rank === <!--T:15-->

<!--T:16-->
The ''normal'' rank is assigned to all statements by default. A normal rank provides no judgement or evaluation of a value's accuracy and currency and therefore should be considered neutral.

<!--T:17-->
Normal ranks are typically used for statements that contain relevant information that is believed to be correct, but may be too extensive to be shown by default. They are also used for statements with multiple values when it does not make sense to indicate that one value is "more correct" than any other.

<!--T:18-->
For templates (for e.g. info boxes) and queries (once they are implemented), per default normal ranked values will be used for a property in cases when the property has no preferred rank.

<!--T:19-->
'''Examples:'''
* The item for Barack Obama has two values listed as children; both values should be given the normal rank because neither value is more "correct" than the other
* The item for Hillary Clinton has multiple values listed for the property {{P|39}} including attorney at law, U.S. Senator, U.S. Secretary of State, and First Lady; all positions held in the past should be given the normal rank

=== Preferred rank === <!--T:20-->

<!--T:21-->
The ''preferred'' rank is assigned to the most current statement or statements that best represent consensus (be it scientific consensus or the Wikidata community consensus).

<!--T:22-->
Ideally, the preferred rank will be applied to {{ll|Help:Sources|sourced statements}} and/or statements with {{ll|Help:Qualifiers|qualifiers}} which provide further details in support of the validity of their values, for example, through the use of qualifiers with the properties {{P|585}}, {{P|459}}, etc. It is often useful to indicate the reason for a preferred rank with a {{P|7452}} qualifier.

<!--T:23-->
For templates and queries, per default preferred statement(s) for a property will be used if they exist, otherwise normal statement(s) will be used.

<!--T:24-->
'''Examples:'''
* An item of a city may feature a historic list of its mayors. The current mayor would receive the preferred rank.
* There may be several ways to measure the length of a river resulting in different results depending on to the method used. In such cases, the result of the most commonly used or scientifically valid method should receive the preferred rank.
</translate>
<translate>
<!--T:68-->
* There may be several preferred ranks of an item. E.g. a software project with 2 or more current developers among other formerly active developers or contributors.

=== Deprecated rank === <!--T:25-->
</translate>
{{Warning|1=<translate><!--T:40--> All statements, including deprecated ones, must be verifiable in the sense that a source makes the claim whether or not the claim is true. Deprecation is not an option for information that can not be publicly sourced, e.g. non-public personal information about subject of an item. {{ll|Wikidata:Living people}} applies to all statements, including deprecated ones.</translate>}}

<translate><!--T:26-->
The ''deprecated'' rank is used for statements that are known to include errors (i.e. data produced by flawed measurement processes, inaccurate statements) or that represent outdated knowledge (i.e. information that was never correct, but was at some point thought to be). It is often useful to indicate the reason for a deprecation with a {{P|2241}} qualifier. This ''does not'' apply to correct historical information, such as previous values of a statement, as long as they represent accurate information for the indicated time period. Such statements should instead be annotated with the appropriate {{P|580}}/{{P|582}} qualifiers.

<!--T:38-->
Marking erroneous statements as deprecated instead of simply deleting such statements has three benefits:

<!--T:36-->
# it allows other users to know not to re-add the value to the item
# it provides a mechanism for representing the evolution of theories and ideas and thereby creates a richer context for understanding human knowledge
# it upholds and establishes the integrity of Wikidata as a secondary knowledge base (that collects and links to references), rather than a primary database of facts. Wikidata simply provides information according to specific sources; those sources may or may not reflect contemporary thought or scientific consensus

<!--T:27-->
For templates and queries, deprecated statements will never be used unless that is specifically requested.

<!--T:28-->
'''Examples:'''
* The Earth being the center of the cosmos once was subject of scientific discourse which can be backed by references. However, the geocentric model is now deprecated.

== How to apply ranks == <!--T:29-->

<!--T:30-->
Ranks are added on an item page under the ''Statements'' section. 

<!--T:31-->
# To add a rank to a statement, click on the [edit] button
# Once in edit mode, the ranking mechanism will appear as small blue icon to the left of a statement's value (they appear as the same icons in grey when an item page is not being edited) 
# Click on the icon and select either preferred rank, normal rank, or deprecated rank from the menu
# Check that the rank icon appears as it should:
#: <tvar name="pref">{{RankIcon|preferred}}</tvar> for a preferred rank;
#: <tvar name="norm">{{RankIcon|normal}}</tvar> for a normal rank;
#: <tvar name="depr">{{RankIcon|deprecated}}</tvar> for a deprecated rank
# Click on the [publish] button once done

==How to visualize ranks== <!--T:62-->
</translate>
[[File:Capture d'écran Q108841249.png|thumb|350px]]
<translate>
<!--T:63-->
They are by default visualised with a small icon. 

<!--T:66-->
In addition, statements in preferred rank are shown in green and deprecated rank in red.

<!--T:67-->
One can customise own colours to better distinguish deprecated and preferred ranks thanks to these (sample) codes to be added to your [[<tvar name="1">Special:MyPage/common.css</tvar>|local common.css]] or [[<tvar name="2">:m:special:MyPage/global.css</tvar>|global.css]] page. Of course, you can adapt the colours to your taste and visual abilities. 
</translate>

*<translate><!--T:64--> To put a background colour:</translate>
<syntaxhighlight lang="css">
.wb-deprecated { background-color: #FFE0E0; } /* deprecated claims with red-ish background */ 
.wb-preferred { background-color: #E0FFE0; } /* preferred claims with green-ish background */
</syntaxhighlight>

*<translate><!--T:65--> To put colorized icons:</translate>
<syntaxhighlight lang="css">
/* Color non-default ranks */
.wikibase-rankselector-preferred {
    filter: grayscale(100%) brightness(70%) sepia(100%) hue-rotate(50deg) saturate(1000%);

}
.wikibase-rankselector-deprecated {
	filter: grayscale(100%) brightness(70%) sepia(100%) hue-rotate(-20deg) saturate(1000%)
}
.wikibase-rankselector {
	padding: 1em;
	margin: -1em;
}
.wikibase-snakview-typeselector {
	left: 21px;
}
.wikibase-statementview-mainsnak .wikibase-snakview .wikibase-snakview-value-container {
	margin-left: 25px;
}
</syntaxhighlight>

<translate>

== How to query and filter among ranks == <!--T:41--> 

<!--T:46-->
Wikidata Query Service stores two versions of a statement:
</translate>
# <translate><!--T:47--> One for "best" rank with the value. A statement with best rank is a statement with preferred rank, if there is none: a statement with normal rank.</translate>
# <translate><!--T:48--> One for any rank with value, qualifiers and references.</translate>

<translate>
<!--T:49-->
Sample queries for <tvar name="1">[[Q16#P1082]]</tvar> (Canada's population):
</translate>
# {{SPARQL8|query=SELECT * { wd:Q16 wdt:P1082 ?value } }}
# {{SPARQL8|query=SELECT * { wd:Q16 p:P1082 ?st . ?st ps:P1082 ?value . ?st wikibase:rank ?rank . ?st pq:P585 ?date . } }}

<translate>
<!--T:50-->
The first is equivalent to:
</translate>
*{{SPARQL8|query=SELECT * { wd:Q16 p:P1082 ?st . ?st ps:P1082 ?value . ?st a wikibase:BestRank . ?st pq:P585 ?date . } }}

<translate>
<!--T:51-->
To query for specific ranks for <tvar name="1">[[Q692#P569]]</tvar> (William Shakespeare's date of birth)
</translate>
;<translate><!--T:52--> best rank: <tvar name="1">{{SPARQL8|query=SELECT * { wd:Q692 wdt:P569 ?value } }}</tvar></translate>
;<translate><!--T:53--> best rank: <tvar name="1">{{SPARQL8|query=SELECT * { wd:Q692 p:P569 ?st . ?st ps:P569 ?value . ?st rdf:type wikibase:BestRank  } }}</tvar></translate>
<translate><!--T:54--> you can substitute "rdf:type" with "a" if you prefer syntactic sugar, as they are identical.</translate><ref>[https://www.w3.org/TR/rdf-sparql-query/#abbrevRdfType SPARQL Query Language for RDF - 4.2.4 rdf:type]</ref>
;<translate><!--T:55--> preferred rank: <tvar name="1">{{SPARQL8|query=SELECT * { wd:Q692 p:P569 ?st . ?st ps:P569 ?value . ?st wikibase:rank wikibase:PreferredRank  } }}</tvar></translate>
;<translate><!--T:56--> normal rank: <tvar name="1">{{SPARQL8|query=SELECT * { wd:Q692 p:P569 ?st . ?st ps:P569 ?value . ?st wikibase:rank wikibase:NormalRank  } }}</tvar></translate>
;<translate><!--T:57--> deprecated rank: <tvar name="1">{{SPARQL8|query=SELECT * { wd:Q692 p:P569 ?st . ?st ps:P569 ?value . ?st wikibase:rank wikibase:DeprecatedRank  } }}</tvar></translate>
;<translate><!--T:58--> not deprecated rank: <tvar name="1">{{SPARQL8|query=SELECT * { wd:Q692 p:P569 ?st . ?st ps:P569 ?value . MINUS { ?st wikibase:rank wikibase:DeprecatedRank }   } }}</tvar></translate>
;<translate><!--T:59-->
not deprecated rank: <tvar name="1">{{SPARQL|query= SELECT * WHERE 
 { 
  VALUES ?ranks { wikibase:PreferredRank wikibase:NormalRank }
  wd:Q692 p:P569 ?st. ?st ps:P569 ?value.  ?st wikibase:rank ?ranks. 
 }
|label=[[File:Wikidata Query Service Favicon wbg.svg|18px]]
}}</tvar></translate>

<translate>
<!--T:60-->
For a technical explanation, see [[<tvar name="1">mw:Special:MyLanguage/Wikibase/Indexing/RDF Dump Format#Statement types</tvar>|Wikibase/Indexing/RDF Dump Format#Statement types]].

== See also == <!--T:32-->

<!--T:33-->
For related Help pages, see:

<!--T:34-->
* {{ll|Help:Statements}}, which explains what statements are and what rules they follow
* {{ll|Help:Sources}}, which explains what sources are and what rules they follow
* {{ll|Help:Qualifiers}}, which explains what qualifiers are and what rules they follow
* {{ll|Help:Deprecation}}, which explains justifying decisions to supersede and mark incorrect values
* {{ll|Help:Evolving knowledge}}, which explains how ranks are used to represent data that changes over time and older values.

<!--T:35-->
For additional information and guidance, see:</translate>
{{Help links}}

<translate>
== References == <!--T:61-->
</translate>
<references/>

{{Translation categories}}