Package org.gbif.api.model.checklistbank
Class DatasetMetrics
java.lang.Object
org.gbif.api.model.checklistbank.DatasetMetrics
Simple metrics about a single, processed checklist dataset in time.
The created timestamp with the dataset key should be unique and can be used to create graphs over time.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionboolean
@javax.validation.constraints.Max(100L),@javax.validation.constraints.Min(0L) int
@javax.validation.constraints.Min(0L) int
@NotNull Map<NameUsageIssue,
Integer> @javax.validation.constraints.Min(0L) int
getCountByIssue
(NameUsageIssue issue) Get the metrics by name usage issue.@javax.validation.constraints.Min(0L) int
getCountByKingdom
(Kingdom kingdom) For an occurrence dataset get the number of records that are interpreted to belong to a certain nub kingdom.@javax.validation.constraints.Min(0L) int
getCountByOrigin
(Origin origin) Get the metrics by name usage origin.@javax.validation.constraints.Min(0L) int
getCountByRank
(Rank rank) Get the metrics by taxonomic rank, i.e.@javax.validation.constraints.Min(0L) int
getCountNamesByLanguage
(Language language) Number of vernacular names in this checklist dataset by language.@NotNull @Past Date
@NotNull UUID
@javax.validation.constraints.Min(0L) int
@NotNull @Past Date
@javax.validation.constraints.Min(0L) int
getExtensionRecordCount
(Extension extension) Number of extension records found in the dataset.int
getKey()
@javax.validation.constraints.Max(100L),@javax.validation.constraints.Min(0L) int
@javax.validation.constraints.Min(0L) int
@javax.validation.constraints.Min(0L) int
getOtherCount
(String key) Get the metrics for other dynamic counts.@javax.validation.constraints.Min(0L) int
@javax.validation.constraints.Min(0L) int
int
hashCode()
void
setColCoveragePct
(int colCoveragePct) void
setColMatchingCount
(int colMatchingCount) void
setCountByConstituent
(Map<UUID, Integer> countByConstituent) void
setCountByIssue
(Map<NameUsageIssue, Integer> countByIssue) void
setCountByKingdom
(Map<Kingdom, Integer> countByKingdom) void
setCountByOrigin
(Map<Origin, Integer> countByOrigin) void
setCountByRank
(Map<Rank, Integer> countByRank) void
setCountExtRecordsByExtension
(Map<Extension, Integer> countExtRecordsByExtension) void
setCountNamesByLanguage
(Map<Language, Integer> countNamesByLanguage) void
setCreated
(Date created) void
setDatasetKey
(UUID datasetKey) void
setDistinctNamesCount
(int distinctNamesCount) void
setDownloaded
(Date downloaded) void
setKey
(int key) void
setNubCoveragePct
(int nubCoveragePct) void
setNubMatchingCount
(int nubMatchingCount) void
setOtherCount
(Map<String, Integer> otherCount) void
setSynonymsCount
(int synonymsCount) void
setUsagesCount
(int usagesCount) toString()
-
Constructor Details
-
DatasetMetrics
public DatasetMetrics()
-
-
Method Details
-
getKey
-
setKey
-
getColCoveragePct
@Max(100L) @Min(0L) public @javax.validation.constraints.Max(100L),@javax.validation.constraints.Min(0L) int getColCoveragePct()- Returns:
- percentage of distinct names that match a name in the Catalogue of Life
-
setColCoveragePct
-
getCountByConstituent
-
setCountByConstituent
-
getCountByKingdom
-
setCountByKingdom
-
getCountByRank
-
setCountByRank
-
getDistinctNamesCount
- Returns:
- the number of distinct canonical name strings
-
setDistinctNamesCount
-
getCountExtRecordsByExtension
-
setCountExtRecordsByExtension
-
getColMatchingCount
- Returns:
- number of records matching a name in the Catalogue of Life
-
setColMatchingCount
-
getNubMatchingCount
- Returns:
- number of records matching a name in the GBIF backbone taxonomy
-
setNubMatchingCount
-
getCountNamesByLanguage
-
setCountNamesByLanguage
-
getSynonymsCount
- Returns:
- number of records with a taxonomic status of a synonym. For occurrence records the nub taxonomy status is used
-
setSynonymsCount
-
getUsagesCount
- Returns:
- total number of name usage records in checklistbank
-
setUsagesCount
-
getCountByOrigin
- Returns:
- map of total name usage counts by their origin
-
setCountByOrigin
-
getCountByIssue
- Returns:
- map of total name usage counts by their interpretation issue
-
setCountByIssue
-
getCreated
- Returns:
- date this metric was generated. Roughly equivalent with date of indexing
-
setCreated
-
getDownloaded
- Returns:
- date new dataset data was downloaded/harvested last time
-
setDownloaded
-
getDatasetKey
-
setDatasetKey
-
getNubCoveragePct
@Max(100L) @Min(0L) public @javax.validation.constraints.Max(100L),@javax.validation.constraints.Min(0L) int getNubCoveragePct()- Returns:
- percentage of distinct names that match a name in the GBIF backbone taxonomy
-
setNubCoveragePct
-
getCountByKingdom
For an occurrence dataset get the number of records that are interpreted to belong to a certain nub kingdom. For checklists the number of usages belonging to a certain nub kingdom. Note this is not the kingdom as explicitly given by the checklist, but the nub kingdom after matching the usages to the nub.- Parameters:
kingdom
- to get metrics for- Returns:
- the number of records found in the respective kingdom
-
getCountByRank
Get the metrics by taxonomic rank, i.e. the lowest rank to which an occurrence record was identified or the rank of the name usage in a checklist.- Parameters:
rank
- to get metrics for. Mayor Linnéan ranks only down to species plus INFRASPECIFIC_NAME.- Returns:
- the number of records for the given taxonomic rank.
-
getCountByOrigin
Get the metrics by name usage origin. -
getCountByIssue
Get the metrics by name usage issue. -
getOtherCount
Get the metrics for other dynamic counts. -
getCountNamesByLanguage
@Min(0L) public @javax.validation.constraints.Min(0L) int getCountNamesByLanguage(Language language) Number of vernacular names in this checklist dataset by language. For occurrence datasets always 0.- Parameters:
language
- of common names- Returns:
- the number of records found for the extension
-
getExtensionRecordCount
@Min(0L) public @javax.validation.constraints.Min(0L) int getExtensionRecordCount(Extension extension) Number of extension records found in the dataset.- Returns:
- the number of records found for the extension
-
getOtherCount
-
setOtherCount
-
equals
-
hashCode
-
toString
-