◇◆

vocab Vocabulary/Taxonomy Name

The name of a taxonomy, ontology, database, term list, thesaurus, index, controlled vocabulary (defined formally), generic vocabulary (subject area that is defined informally), etc. that is the source of terms such as keywords and subjects.

Usage/Remarks

There is no fixed list of term sources, and each JATS organization may point to its chosen taxonomies, ontologies, keyword lists, etc. For keywords, named vocabularies include “inspec”, “medical-devices”, etc. For subjects, named vocabularies include “ipc”, “mesh”, “unspsc”, etc. In cases where there is no named vocabulary, the @vocab attribute may be set to “uncontrolled”.
Vocabulary Attributes
Four attributes are used in this Tag Set to identify terms from a controlled or an uncontrolled vocabulary:
vocab
Name of the controlled or uncontrolled vocabulary, taxonomy, ontology, index, database, or similar that is the source of the term. For example, for a subject term, a value might be the IPC Codes (“ipc”) or MESH headings (“mesh”). For an uncontrolled term, the value might be an area of study such as “medical-devices” or merely the word “uncontrolled”.
vocab-identifier
Unique identifier of the vocabulary, such as (but not limited to) a URI or DOI. For example, for Dublin Core (DCC), the identifier may be http://dublincore.org/documents/2012/06/14/dces/. For the NISO CRediT, Contributor Roles Taxonomy, the identifier may be http://credit.niso.org//.
vocab-term
The content of the element is the display version of the vocabulary or taxonomic term. The @vocab-term attribute holds the canonical version of the same term, as it appears in the vocabulary. For example, if the attribute value is “digitized-vor”, the element might contain the display text “Digitized Version of Record”.
vocab-term-identifier
Unique identifier of the term within a specific vocabulary, such as (but not limited to) an item number, a URI, DOI, etc.
OPTIONAL on many elements; click for list and usage

<article-version>, <compound-kwd>, <compound-subject>, <custom-meta>, <extended-by>, <index-term>, <inline-media>, <institution-id>, <kwd>, <kwd-group>, <named-content>, <nested-kwd>, <resource-id>, <restricted-by>, <role>, <see-also>, <subj-group>, <subject>, <term>, <unstructured-kwd-group>

Value Meaning
Text, numbers, or special characters The name of the vocabulary, taxonomy, ontology, database, term list, index, etc. that is the source of the term named in the element’s content.
Restriction @vocab is an optional attribute; there is no default.
Tagged Samples
Vocabulary is a CRediT taxonomy term. 
...
<contrib-group>
 <contrib>
  <string-name><given-names>Barbara</given-names> <surname>Johnston</surname></string-name>
  <role vocab="CRediT" 
    vocab-identifier="http://credit.niso.org/"
    vocab-term="Conceptualization"
    vocab-term-identifier=
    "http://credit.niso.org/contributor-roles/conceptualization/"
    degree-contribution="lead">study designer</role>
 </contrib>
 <contrib>
  <string-name><given-names>Brooke</given-names> <surname>Jackson</surname></string-name>
  <role vocab="CRediT" 
    vocab-identifier="http://credit.niso.org/"
    vocab-term="Writing &#8212; original draft"
    vocab-term-identifier=
    "http://credit.niso.org/contributor-roles/writing-original-draft/"
    degree-contribution="lead">writer</role>
 </contrib>
</contrib-group>
...
Special characters in CRediT attribute values need to be given as Unicode character references. In narrative text, Unicode character references, general entities, or characters may be used. 
...
<contrib-group>
 <contrib>
  <string-name><given-names>Anne</given-names> <surname>Berns</surname></string-name>
  <role vocab="CRediT" 
    vocab-identifier="http://credit.niso.org/"
    vocab-term="Writing &#8212; original draft"
    vocab-term-identifier=
    "http://credit.niso.org/contributor-roles/writing-original-draft/"
    degree-contribution="lead"
    >Article Author &ndash; Original Draft</role>
 </contrib>
</contrib-group>
...
Vocabulary is a NISO JAV article version descriptor. 
...
<article-meta>
 <article-id pub-id-type="other">jBMJ.v324.i7342.pg880</article-id>
 <article-id pub-id-type="pmid">11950738</article-id>
 <article-version vocab="JAV" 
   vocab-identifier="http://www.niso.org/publications/rp/RP-8-2008.pdf"
   article-version-type="VoR"  
   vocab-term="Version of Record">version-of-record</article-version>
 ...
 <title-group>...</title-group>
 ...
</article-meta>
...
Two vocabularies in one keyword group 
...
<kwd-group kwd-group-type="library-classifications">
 <compound-kwd vocab="LOC" 
   vocab-term="Diseases of the respiratory system"
   vocab-term-identifier="RC705-779">
  <compound-kwd-part>RC705-779</compound-kwd-part>
  <compound-kwd-part>Diseases of the respiratory system</compound-kwd-part>
 </compound-kwd>

 <compound-kwd vocab="Dewey Decimal" 
   vocab-term="Diseases of the respiratory system"
   vocab-term-identifier="616.3">
  <compound-kwd-part>616.3</compound-kwd-part>
  <compound-kwd-part>Diseases of the respiratory system</compound-kwd-part>
 </compound-kwd>
</kwd-group>
...
ICD10 vocabulary 
...
<kwd-group kwd-group-type="conditions">
  <compound-kwd vocab="ICD10" vocab-term="J00-J99">
    <compound-kwd-part>J00-J99</compound-kwd-part>
    <compound-kwd-part>Diseases of the respiratory system</compound-kwd-part>
  </compound-kwd>
</kwd-group>
...
Generic subject within Dublin Core subjects 
...
<kwd-group vocab="dublincore" kwd-group-type="classification">
  <nested-kwd vocab="scientific name">
    <kwd vocab="scientific name" vocab-term="kingdom">Plantae</kwd>
    <kwd vocab="scientific name" vocab-term="phylum">Anthophyta</kwd>
    <kwd vocab="scientific name" vocab-term="class">Monocoty</kwd>
    <kwd vocab="scientific name" vocab-term="order">Commelinales</kwd>
    <kwd vocab="scientific name" vocab-term="family">Poaceae</kwd>
    <kwd vocab="scientific name" vocab-term="genus">Zea</kwd>
    <kwd vocab="scientific name" vocab-term="species">Z. mays</kwd>
  </nested-kwd>
</kwd-group>
...
Keywords with vocabulary and vocabulary-term identifiers 
...
<kwd-group kwd-group-type="physh" xml:lang="en"
  vocab="PhySH" vocab-identifier="https://physh.org/">
 <nested-kwd>
  <kwd content-type="facet" 
    vocab="PhySH" vocab-identifier="https://physh.org/" 
    vocab-term-identifier="https://physh.aps.org/browse?facetIds=Research%2520Areas"
   >Research Areas</kwd>
  <nested-kwd>
   <kwd content-type="concept" 
     vocab="PhySH" vocab-identifier="https://physh.org/"
     vocab-term-identifier="https://doi.org/10.29172/ba7ccb8ed7eb4e6f9c1eb622f5b4e242"
    >Atomic &amp; molecular processes in external fields</kwd>
   <nested-kwd>
    <kwd content-type="concept" 
      vocab="PhySH" vocab-identifier="https://physh.org/"
      vocab-term-identifier="https://doi.org/10.29172/da893accf204480b8a7e386479c50687"
     >Coherent control</kwd>
   </nested-kwd>
  </nested-kwd>
 </nested-kwd>
 <nested-kwd>
  <kwd content-type="facet" 
    vocab="PhySH" vocab-identifier="https://physh.org/"
    vocab-term-identifier="https://physh.aps.org/browse?facetIds=Physical%2520Systems"
   >Physical Systems</kwd>
  <nested-kwd>
   <kwd content-type="concept" 
     vocab="PhySH" vocab-identifier="https://physh.org/"
     vocab-term-identifier="https://doi.org/10.29172/bd252d88a60848979416daf84dee7f6b"
    >Atomic Systems</kwd>
   <nested-kwd>
    <kwd content-type="concept" 
      vocab="PhySH" vocab-identifier="https://physh.org/"
      vocab-term-identifier="https://doi.org/10.29172/42e66168abfd4328aa9df6fc3a077f75"
     >Molecules</kwd>
   </nested-kwd>
  </nested-kwd>
 </nested-kwd>
</kwd-group>
...