2023-09-28
Life on earth is sustained by complex interactions between organisms and their environment. These biotic interactions can be captured in datasets and published digitally. We describe a review process of such an openly accessible digital interaction datasets of known origin, and discuss their outcome. The dataset under review (aka globalbioticinteractions/cas-ent) contains 17,296 interactions with 4 (e.g., interactsWith) unique types of associations between 1,986 primary taxa (e.g., Euaresta aequalis) and 1,996 associated taxa (e.g., Pseudotsuga menziesii). The report includes detailed summaries of interactions data as well as a taxonomic review from multiple perspectives.
Data review can be a time consuming process, especially when done manually. This review report aims to help facilitate data review of species interaction claims made in datasets registered with Global Biotic Interactions (Poelen, Simons, and Mungall 2014). The review includes summary statistics of, and observations about, the dataset under review:
CAS Entomology Type (TYPE) - Version 1.203 http://ipt.calacademy.org:8080/archive.do?r=type 2023-09-22T22:46:22.947Z 2bbe613531729edaa0f57e775e9e0acbaf853ff743bd26af09167ef80fdcd201
The review is performed through programmatic scripts that leverage tools like Preston, Elton, Nomer combined with third-party tools like grep, mlr, tail and head.
tool name | version |
---|---|
elton | 0.12.7 |
nomer | 0.5.5 |
mlr | 6.0.0 |
pandoc | 3.1.6.1 |
The review process can be described in the form of a script:
# get versioned copy of the dataset under review
elton pull globalbioticinteractions/cas-ent
# generate review notes
elton review globalbioticinteractions/cas-ent\
> review.tsv
# export indexed interaction records
elton interactions globalbioticinteractions/cas-ent\
> interactions.tsv
# export names and align them with the Catalogue of Life using Nomer
elton names globalbioticinteractions/cas-ent\
| nomer append col\
> name-alignment.tsv
or visually, in a process diagram.
You can find a recent copy of the full review script at check-data.sh.
In the following sections, the results of the review are summarized 1. Then, links to the detailed review reports are provided.
In this review, biotic interactions (or biotic associations) are modeled as a primary (aka subject, source) organism interacting with an associate (aka object, target) organism. The dataset under review classified the primary/associate organisms with specific taxa. The primary and associate organisms The kind of interaction is documented as an interaction type.
The dataset under review (aka globalbioticinteractions/cas-ent) contains 17,296 interactions with 4 (e.g., interactsWith) unique types of associations between 1,986 primary taxa (e.g., Euaresta aequalis) and 1,996 associated taxa (e.g., Pseudotsuga menziesii).
An exhaustive list of indexed interaction claims can be found at indexed-interactions (csv/tsv/html). The list was used to create the following data summaries.
sourceTaxonName | interactionTypeName | targetTaxonName | referenceCitation |
---|---|---|---|
Physocyclus globosus (Taczanowski, 1874) | adjacentTo | cave wall in web | urn:catalog:CAS:ENT:9069617 |
Strophiona laeta (LeConte, 1857) | adjacentTo | Quercus dumosa | urn:catalog:CAS:ENT:8383067 |
Strophiona laeta (LeConte, 1857) | adjacentTo | Quercus dumosa | urn:catalog:CAS:ENT:8383083 |
Brachysomida californica (LeConte, 1851) | adjacentTo | Potentilla sp. | urn:catalog:CAS:ENT:8384162 |
interactionTypeName | count |
---|---|
interactsWith | 10745 |
adjacentTo | 6215 |
hasHost | 351 |
eats | 1 |
sourceTaxonName | count |
---|---|
Euaresta aequalis | 332 |
Anthaxia Eschscholtz, 1829 | 298 |
Neoclytus conjunctus (LeConte, 1857) | 268 |
Callidium antennatus ssp. hesperum | 254 |
Callidium antennatum ssp. hesperum | 239 |
Omus californicus ssp. californicus | 230 |
Phymatodes nitidus LeConte, 1874 | 204 |
Campiglossa genalis | 183 |
Acmaeodera holsteni White, 1939 | 180 |
Phymatodes Mulsant, 1839 | 170 |
Anthaxia pseudotsugae Chamberlin | 130 |
Copidosoma | 125 |
Xylotrechus nauticus (Mannerheim, 1843) | 122 |
Tephritis californica | 119 |
Trupanea californica | 118 |
Chimoptesis chrysopyla Powell, 1964 | 108 |
Neoclytus balteatus LeConte, 1873 | 107 |
Phymatodes decussatus ssp. decussatus | 104 |
Euarestoides acutangulus (Thomson, 1869) | 104 |
targetTaxonName | count |
---|---|
Pseudotsuga menziesii | 954 |
Eucalyptus | 368 |
Xanthium canadense | 329 |
Adenostoma fasciculatum | 307 |
Nothofagus | 304 |
Pinus ponderosa | 269 |
Sequoia sempervirens | 260 |
Chrysothamnus sp. | 259 |
Ceanothus | 220 |
Quercus kelloggii | 196 |
juniper | 194 |
snow at night | 186 |
Baccharis pilularis | 185 |
Quercus | 182 |
Casaurina | 174 |
Quercus dumosa | 170 |
Artemisia tridentata | 162 |
Quercus agrifolia | 159 |
Pinus sabiniana | 150 |
sourceTaxonName | interactionTypeName | targetTaxonName | count |
---|---|---|---|
Euaresta aequalis | interactsWith | Xanthium canadense | 326 |
Acmaeodera holsteni White, 1939 | adjacentTo | Adenostoma fasciculatum | 142 |
Callidium antennatus ssp. hesperum | interactsWith | Pseudotsuga menziesii | 136 |
Callidium antennatum ssp. hesperum | interactsWith | Pseudotsuga menziesii | 124 |
Omus californicus ssp. californicus | interactsWith | O. sequoiarum laevis | 121 |
Neoclytus conjunctus (LeConte, 1857) | adjacentTo | madrone | 120 |
Phymatodes Mulsant, 1839 | interactsWith | Pseudotsuga menziesii | 113 |
Tephritis californica | interactsWith | Baccharis pilularis | 105 |
Anthaxia pseudotsugae Chamberlin | interactsWith | Pseudotsuga menziesii | 102 |
Trupanea californica | interactsWith | Gnaphalium chilense | 99 |
Anthaxia retifer LeConte, 1860 | adjacentTo | Notholithocarpus densiflorum | 93 |
Andricus bakkeri | adjacentTo | Quercus dumosa | 86 |
Holopleura marginata LeConte, 1873 | interactsWith | Pseudotsuga menziesii | 80 |
Phymatodes maculicollis LeConte, 1878 | adjacentTo | Pseudotsuga menziesii | 79 |
Campiglossa genalis | interactsWith | Senecio jacobaea | 77 |
Nebria turmaduodecima Kavanaugh, 1981 | adjacentTo | snow at night | 75 |
Aciurina maculata | interactsWith | Chrysothamnus sp. | 73 |
Neoclytus balteatus LeConte, 1873 | interactsWith | Ceanothus thyrsiflorus | 70 |
Nebria spatulata ssp. sierrae | adjacentTo | snow at night | 69 |
The figures below provide a graph view on the dataset under review. The first shows a summary network on the kingdom level, and the second shows how interactions on the family level. Note that both network graphs were first aligned taxonomically via the Catalogue of Life. Please refer to the original (or verbatim) taxonomic names for a more original view on the interaction data.
You can download the indexed dataset under review at indexed-interactions.csv. A tab-separated file can be found at indexed-interactions.tsv
Learn more about the structure of this download at GloBI website, by opening a GitHub issue, or by sending an email.
Another way to discover the dataset under review is by searching for it on the GloBI website.
As part of the review, all names are aligned against various name catalogs (e.g., col ncbi discoverlife gbif itis globi mdd tpt). These alignments may serve as a way to review name usage or aid in selecting of a suitable taxonomic name resource to use.
providedName | relationName | resolvedCatalogName | resolvedName |
---|---|---|---|
NONE | ncbi | ||
NONE | discoverlife | ||
NONE | globi | ||
Aaphiolepis | NONE | col | Aaphiolepis |
resolvedCatalogName | resolvedRank | count |
---|---|---|
tpt | NA | 3645 |
tpt | species | 133 |
tpt | genus | 22 |
tpt | family | 2 |
ncbi | NA | 2291 |
ncbi | species | 951 |
ncbi | genus | 417 |
ncbi | family | 97 |
ncbi | order | 16 |
ncbi | subspecies | 12 |
ncbi | subgenus | 11 |
ncbi | varietas | 6 |
ncbi | class | 4 |
ncbi | subfamily | 4 |
ncbi | clade | 2 |
ncbi | subclass | 1 |
ncbi | tribe | 1 |
ncbi | suborder | 1 |
ncbi | phylum | 1 |
mdd | NA | 3802 |
itis | NA | 1900 |
itis | species | 1353 |
itis | genus | 374 |
itis | family | 99 |
itis | subspecies | 32 |
itis | variety | 19 |
itis | order | 16 |
itis | class | 4 |
itis | subfamily | 2 |
itis | subclass | 1 |
itis | suborder | 1 |
itis | phylum | 1 |
itis | subgenus | 1 |
itis | kingdom | 1 |
globi | NA | 1900 |
globi | species | 1744 |
globi | genus | 764 |
globi | family | 117 |
globi | subspecies | 112 |
globi | subgenus | 59 |
globi | variety | 44 |
globi | order | 19 |
globi | class | 11 |
globi | phylum | 5 |
globi | tribe | 4 |
globi | suborder | 4 |
globi | subfamily | 3 |
globi | subclass | 2 |
globi | superfamily | 2 |
globi | form | 2 |
globi | infraclass | 1 |
globi | superorder | 1 |
globi | section | 1 |
globi | infraorder | 1 |
globi | parvorder | 1 |
globi | kingdom | 1 |
gbif | species | 1751 |
gbif | NA | 1416 |
gbif | genus | 470 |
gbif | family | 101 |
gbif | subspecies | 57 |
gbif | variety | 23 |
gbif | order | 13 |
gbif | class | 4 |
gbif | phylum | 1 |
gbif | kingdom | 1 |
discoverlife | NA | 3785 |
discoverlife | species | 18 |
col | species | 1665 |
col | NA | 1534 |
col | genus | 441 |
col | family | 95 |
col | subspecies | 42 |
col | subgenus | 20 |
col | variety | 18 |
col | order | 13 |
col | class | 4 |
col | infraspecific name | 2 |
col | subfamily | 2 |
col | section | 1 |
col | phylum | 1 |
col | parvorder | 1 |
col | kingdom | 1 |
col | tribe | 1 |
resolvedCatalogName | relationName | count |
---|---|---|
col | NONE | 1556 |
col | HAS_ACCEPTED_NAME | 2229 |
col | SYNONYM_OF | 624 |
discoverlife | NONE | 3920 |
discoverlife | HAS_ACCEPTED_NAME | 15 |
discoverlife | SYNONYM_OF | 6 |
gbif | NONE | 1436 |
gbif | HAS_ACCEPTED_NAME | 2532 |
gbif | SYNONYM_OF | 805 |
globi | NONE | 1372 |
globi | SAME_AS | 19989 |
itis | NONE | 1927 |
itis | HAS_ACCEPTED_NAME | 1866 |
itis | SYNONYM_OF | 186 |
mdd | NONE | 3916 |
mdd | HAS_ACCEPTED_NAME | 18 |
ncbi | NONE | 2333 |
ncbi | SAME_AS | 1516 |
ncbi | SYNONYM_OF | 92 |
ncbi | COMMON_NAME_OF | 30 |
tpt | NONE | 3776 |
tpt | HAS_ACCEPTED_NAME | 159 |
tpt | SYNONYM_OF | 34 |
catalog name | alignment results |
---|---|
col | associated names alignments (csv/tsv/html) |
ncbi | associated names alignments (csv/tsv/html) |
discoverlife | associated names alignments (csv/tsv/html) |
gbif | associated names alignments (csv/tsv/html) |
itis | associated names alignments (csv/tsv/html) |
globi | associated names alignments (csv/tsv/html) |
mdd | associated names alignments (csv/tsv/html) |
tpt | associated names alignments (csv/tsv/html) |
Elton, Nomer, and other tools may have difficulties interpreting existing species interaction datasets. Or, they may misbehave, or otherwise show unexpected behavior. As part of the review process, detailed review notes are kept that document possibly misbehaving, or confused, review bots. An sample of review notes associated with this review can be found below.
reviewDate | reviewCommentType | reviewComment |
---|---|---|
2023-09-28T01:23:31Z | summary | https://github.com/globalbioticinteractions/cas-ent/archive/47d385b73a63aa379cd5e6d3615005ba78b0ffc1.zip |
2023-09-28T01:23:31Z | summary | 17312 interaction(s) |
2023-09-28T01:23:31Z | summary | 0 note(s) |
2023-09-28T01:23:31Z | summary | 4 info(s) |
In addtion, you can find the most frequently occurring notes in the table below.
: Most frequently occurring review notes, if any.
For more exhaustive list of review notes, please have a look at the Review Notes (csv/tsv/html).
As part of the review, a review badge is generated. This review badge can be included in webpages to indicate the review status of the dataset under review.
Note that if the badge is green, no review notes were generated. If the badge is yellow, the review bots may need some help with interpreting the species interaction data.
If the dataset under review has been registered with GloBI, and has been succesfully indexed by GloBI, the GloBI Index Status Badge will turn green. This means that the dataset under review was indexed by GloBI and is available through GloBI services and derived data products.
If you’d like to keep track of reviews or index status of the dataset under review, please visit GloBI’s dataset index 4 for badge examples.
This review is intended to provide a perspective on the dataset to aid understanding of species interaction claims discovered. However, this review should not be considered as fitness of use or other kind of quality assessment. Instead, the review may be used as in indication of the open-ness5 and FAIRness (Wilkinson et al. 2016; Trekels et al. 2023) of the dataset: in order to perform this review, the data was likely openly available, Findable, Accessible, Interoperable and Reusable. Currently, this Open-FAIR assessment is qualitative, and with measurement units specified, a more quantitative approach can be implemented.
We thank the many humans that created us and those who created and maintained the data, software and other intellectual resources that were used for producing this review. In addition, we are grateful for the natural resources providing the basis for these human and bot activities.