tmdinosaurcenter
/
dwc
mirror of https://github.com/tdwg/dwc.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #386 from tdwg/cv_proofreading 

CV proofreading regenerate lists of terms docs
This commit is contained in:
John Wieczorek 2021-09-06 10:56:34 -03:00 committed by GitHub
parent 9eff3c452d 720fee413b
commit 4a6e13508e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
12 changed files with 5090 additions and 264 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

325
build/doe-cv-build/doe_build.py Normal file
View File

@ -0,0 +1,325 @@
# Script to build Markdown pages that provide term metadata for simple vocabularies
# Steve Baskauf 2020-06-28 CC0
# This script merges static Markdown header and footer documents with term information tables (in Markdown) generated from data in the rs.tdwg.org repo from the TDWG Github site
# Note: this script calls a function from http_library.py, which requires importing the requests, csv, and json modules
import re
import requests # best library to manage HTTP transactions
import csv # library to read/write/parse CSV files
import json # library to convert JSON to Python data structures
import pandas as pd
# -----------------
# Configuration section
# -----------------
# !!!! Note !!!!
# This is an example of a simple vocabulary without categories. For a complex example
# with multiple namespaces and several categories, see build-page-categories.ipynb
# This is the base URL for raw files from the branch of the repo that has been pushed to GitHub. In this example,
# the branch is named "pathway"
githubBaseUri = 'https://raw.githubusercontent.com/tdwg/rs.tdwg.org/master/'
headerFileName = 'termlist-header.md'
footerFileName = 'termlist-footer.md'
outFileName = '../../docs/doe/index.md'
# This is a Python list of the database names of the term lists to be included in the document.
termLists = ['degreeOfEstablishment']
# NOTE! There may be problems unless every term list is of the same vocabulary type since the number of columns will differ
# However, there probably aren't any circumstances where mixed types will be used to generate the same page.
vocab_type = 2 # 1 is simple vocabulary, 2 is simple controlled vocabulary, 3 is c.v. with broader hierarchy
# Terms in large vocabularies like Darwin and Audubon Cores may be organized into categories using tdwgutility_organizedInClass
# If so, those categories can be used to group terms in the generated term list document.
organized_in_categories = False
# If organized in categories, the display_order list must contain the IRIs that are values of tdwgutility_organizedInClass
# If not organized into categories, the value is irrelevant. There just needs to be one item in the list.
display_order = ['']
display_label = ['Vocabulary'] # these are the section labels for the categories in the page
display_comments = [''] # these are the comments about the category to be appended following the section labels
display_id = ['Vocabulary'] # these are the fragment identifiers for the associated sections for the categories
# ---------------
# Function definitions
# ---------------
# replace URL with link
#
def createLinks(text):
def repl(match):
if match.group(1)[-1] == '.':
return '<a href="' + match.group(1)[:-1] + '">' + match.group(1)[:-1] + '</a>.'
return '<a href="' + match.group(1) + '">' + match.group(1) + '</a>'
pattern = '(https?://[^\s,;\)"]*)'
result = re.sub(pattern, repl, text)
return result
# 2021-08-06 Replace the createLinks() function with functions copied from the QRG build script written by S. Van Hoey
def convert_code(text_with_backticks):
"""Takes all back-quoted sections in a text field and converts it to
the html tagged version of code blocks <code>...</code>
"""
return re.sub(r'`([^`]*)`', r'<code>\1</code>', text_with_backticks)
def convert_link(text_with_urls):
"""Takes all links in a text field and converts it to the html tagged
version of the link
"""
def _handle_matched(inputstring):
"""quick hack version of url handling on the current prime versions data"""
url = inputstring.group()
return "<a href=\"{}\">{}</a>".format(url, url)
regx = "(http[s]?://[\w\d:#@%/;$()~_?\+-;=\\\.&]*)(?<![\)\.,])"
return re.sub(regx, _handle_matched, text_with_urls)
term_lists_info = []
frame = pd.read_csv(githubBaseUri + 'term-lists/term-lists.csv', na_filter=False)
for termList in termLists:
term_list_dict = {'list_iri': termList}
term_list_dict = {'database': termList}
for index,row in frame.iterrows():
if row['database'] == termList:
term_list_dict['pref_ns_prefix'] = row['vann_preferredNamespacePrefix']
term_list_dict['pref_ns_uri'] = row['vann_preferredNamespaceUri']
term_list_dict['list_iri'] = row['list']
term_lists_info.append(term_list_dict)
# Create column list
column_list = ['pref_ns_prefix', 'pref_ns_uri', 'term_localName', 'label', 'definition', 'usage', 'notes', 'term_modified', 'term_deprecated', 'type']
if vocab_type == 2:
column_list += ['controlled_value_string']
elif vocab_type == 3:
column_list += ['controlled_value_string', 'skos_broader']
if organized_in_categories:
column_list.append('tdwgutility_organizedInClass')
column_list.append('version_iri')
# Create list of lists metadata table
table_list = []
for term_list in term_lists_info:
# retrieve versions metadata for term list
versions_url = githubBaseUri + term_list['database'] + '-versions/' + term_list['database'] + '-versions.csv'
versions_df = pd.read_csv(versions_url, na_filter=False)
# retrieve current term metadata for term list
data_url = githubBaseUri + term_list['database'] + '/' + term_list['database'] + '.csv'
frame = pd.read_csv(data_url, na_filter=False)
for index,row in frame.iterrows():
row_list = [term_list['pref_ns_prefix'], term_list['pref_ns_uri'], row['term_localName'], row['label'], row['definition'], row['usage'], row['notes'], row['term_modified'], row['term_deprecated'], row['type']]
if vocab_type == 2:
row_list += [row['controlled_value_string']]
elif vocab_type == 3:
if row['skos_broader'] =='':
row_list += [row['controlled_value_string'], '']
else:
row_list += [row['controlled_value_string'], term_list['pref_ns_prefix'] + ':' + row['skos_broader']]
if organized_in_categories:
row_list.append(row['tdwgutility_organizedInClass'])
# Borrowed terms really don't have implemented versions. They may be lacking values for version_status.
# In their case, their version IRI will be omitted.
found = False
for vindex, vrow in versions_df.iterrows():
if vrow['term_localName']==row['term_localName'] and vrow['version_status']=='recommended':
found = True
version_iri = vrow['version']
# NOTE: the current hack for non-TDWG terms without a version is to append # to the end of the term IRI
if version_iri[len(version_iri)-1] == '#':
version_iri = ''
if not found:
version_iri = ''
row_list.append(version_iri)
table_list.append(row_list)
# Turn list of lists into dataframe
terms_df = pd.DataFrame(table_list, columns = column_list)
terms_sorted_by_label = terms_df.sort_values(by='label')
terms_sorted_by_localname = terms_df.sort_values(by='term_localName')
terms_sorted_by_label
# generate the index of terms grouped by category and sorted alphabetically by lowercase term local name
text = '### 3.1 Index By Term Name\n\n'
text += '(See also [3.2 Index By Label](#32-index-by-label))\n\n'
for category in range(0,len(display_order)):
text += '**' + display_label[category] + '**\n'
text += '\n'
if organized_in_categories:
filtered_table = terms_sorted_by_localname[terms_sorted_by_localname['tdwgutility_organizedInClass']==display_order[category]]
filtered_table.reset_index(drop=True, inplace=True)
else:
filtered_table = terms_sorted_by_localname
filtered_table.reset_index(drop=True, inplace=True)
for row_index,row in filtered_table.iterrows():
curie = row['pref_ns_prefix'] + ":" + row['term_localName']
curie_anchor = curie.replace(':','_')
text += '[' + curie + '](#' + curie_anchor + ')'
if row_index < len(filtered_table) - 1:
text += ' |'
text += '\n'
text += '\n'
index_by_name = text
text = '\n\n'
# Comment out the following two lines if there is no index by local names
#text = '### 3.2 Index By Label\n\n'
#text += '(See also [3.1 Index By Term Name](#31-index-by-term-name))\n\n'
for category in range(0,len(display_order)):
if organized_in_categories:
text += '**' + display_label[category] + '**\n'
text += '\n'
filtered_table = terms_sorted_by_label[terms_sorted_by_label['tdwgutility_organizedInClass']==display_order[category]]
filtered_table.reset_index(drop=True, inplace=True)
else:
filtered_table = terms_sorted_by_label
filtered_table.reset_index(drop=True, inplace=True)
for row_index,row in filtered_table.iterrows():
if row_index == 0 or (row_index != 0 and row['label'] != filtered_table.iloc[row_index - 1].loc['label']): # this is a hack to prevent duplicate labels
curie_anchor = row['pref_ns_prefix'] + "_" + row['term_localName']
text += '[' + row['label'] + '](#' + curie_anchor + ')'
if row_index < len(filtered_table) - 2 or (row_index == len(filtered_table) - 2 and row['label'] != filtered_table.iloc[row_index + 1].loc['label']):
text += ' |'
text += '\n'
text += '\n'
index_by_label = text
decisions_df = pd.read_csv('https://raw.githubusercontent.com/tdwg/rs.tdwg.org/master/decisions/decisions-links.csv', na_filter=False)
# generate a table for each term, with terms grouped by category
# generate the Markdown for the terms table
text = '## 4 Vocabulary\n'
for category in range(0,len(display_order)):
if organized_in_categories:
text += '### 4.' + str(category + 1) + ' ' + display_label[category] + '\n'
text += '\n'
text += display_comments[category] # insert the comments for the category, if any.
filtered_table = terms_sorted_by_localname[terms_sorted_by_localname['tdwgutility_organizedInClass']==display_order[category]]
filtered_table.reset_index(drop=True, inplace=True)
else:
filtered_table = terms_sorted_by_localname
filtered_table.reset_index(drop=True, inplace=True)
for row_index,row in filtered_table.iterrows():
text += '<table>\n'
curie = row['pref_ns_prefix'] + ":" + row['term_localName']
curieAnchor = curie.replace(':','_')
text += '\t<thead>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<th colspan="2"><a id="' + curieAnchor + '"></a>Term Name ' + curie + '</th>\n'
text += '\t\t</tr>\n'
text += '\t</thead>\n'
text += '\t<tbody>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Term IRI</td>\n'
uri = row['pref_ns_uri'] + row['term_localName']
text += '\t\t\t<td><a href="' + uri + '">' + uri + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Modified</td>\n'
text += '\t\t\t<td>' + row['term_modified'] + '</td>\n'
text += '\t\t</tr>\n'
if row['version_iri'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td>Term version IRI</td>\n'
text += '\t\t\t<td><a href="' + row['version_iri'] + '">' + row['version_iri'] + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Label</td>\n'
text += '\t\t\t<td>' + row['label'] + '</td>\n'
text += '\t\t</tr>\n'
if row['term_deprecated'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td></td>\n'
text += '\t\t\t<td><strong>This term is deprecated and should no longer be used.</strong></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Definition</td>\n'
text += '\t\t\t<td>' + row['definition'] + '</td>\n'
text += '\t\t</tr>\n'
if row['usage'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td>Usage</td>\n'
text += '\t\t\t<td>' + convert_link(convert_code(row['usage'])) + '</td>\n'
text += '\t\t</tr>\n'
if row['notes'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td>Notes</td>\n'
text += '\t\t\t<td>' + convert_link(convert_code(row['notes'])) + '</td>\n'
text += '\t\t</tr>\n'
if (vocab_type == 2 or vocab_type == 3) and row['controlled_value_string'] != '': # controlled vocabulary
text += '\t\t<tr>\n'
text += '\t\t\t<td>Controlled value</td>\n'
text += '\t\t\t<td>' + row['controlled_value_string'] + '</td>\n'
text += '\t\t</tr>\n'
if vocab_type == 3 and row['skos_broader'] != '': # controlled vocabulary with skos:broader relationships
text += '\t\t<tr>\n'
text += '\t\t\t<td>Has broader concept</td>\n'
curieAnchor = row['skos_broader'].replace(':','_')
text += '\t\t\t<td><a href="#' + curieAnchor + '">' + row['skos_broader'] + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Type</td>\n'
if row['type'] == 'http://www.w3.org/1999/02/22-rdf-syntax-ns#Property':
text += '\t\t\t<td>Property</td>\n'
elif row['type'] == 'http://www.w3.org/2000/01/rdf-schema#Class':
text += '\t\t\t<td>Class</td>\n'
elif row['type'] == 'http://www.w3.org/2004/02/skos/core#Concept':
text += '\t\t\t<td>Concept</td>\n'
else:
text += '\t\t\t<td>' + row['type'] + '</td>\n' # this should rarely happen
text += '\t\t</tr>\n'
# Look up decisions related to this term
for drow_index,drow in decisions_df.iterrows():
if drow['linked_affected_resource'] == uri:
text += '\t\t<tr>\n'
text += '\t\t\t<td>Executive Committee decision</td>\n'
text += '\t\t\t<td><a href="http://rs.tdwg.org/decisions/' + drow['decision_localName'] + '">http://rs.tdwg.org/decisions/' + drow['decision_localName'] + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t</tbody>\n'
text += '</table>\n'
text += '\n'
text += '\n'
term_table = text
text = index_by_label + term_table
# read in header and footer, merge with terms table, and output
headerObject = open(headerFileName, 'rt', encoding='utf-8')
header = headerObject.read()
headerObject.close()
footerObject = open(footerFileName, 'rt', encoding='utf-8')
footer = footerObject.read()
footerObject.close()
output = header + text + footer
outputObject = open(outFileName, 'wt', encoding='utf-8')
outputObject.write(output)
outputObject.close()
print('done')

9
build/doe-cv-build/termlist-header.md
View File

@ -10,7 +10,7 @@ Preferred namespace abbreviation
: dwcdoe:
Date version issued
: 2020-10-13
: 2021-09-01
Date created
: 2020-10-13
@ -19,11 +19,14 @@ Part of TDWG Standard
: <http://www.tdwg.org/standards/450>
This document version
: <http://rs.tdwg.org/dwc/doc/doe/2020-10-13>
: <http://rs.tdwg.org/dwc/doc/doe/2021-09-01>
Latest version of document
: <http://rs.tdwg.org/dwc/doc/doe/>
Previous version
: <http://rs.tdwg.org/dwc/doc/doe/2020-10-13>
Abstract
: The Darwin Core term `degreeOfEstablishment` provides information about degree to which an Organism survives, reproduces, and expands its range at the given place and time.. The Degree of Establishment Controlled Vocabulary provides terms that should be used as values for `dwc:degreeOfEstablishment` and `dwciri:degreeOfEstablishment`.
@ -34,7 +37,7 @@ Creator
: TDWG Darwin Core Maintenance Group
Bibliographic citation
: Darwin Core Maintenance Group. 2020. Degree of Establishment Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/doe/2020-10-13>
: Darwin Core Maintenance Group. 2021. Degree of Establishment Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/doe/2021-09-01>
## 1 Introduction

325
build/em-cv-build/em_build.py Normal file
View File

@ -0,0 +1,325 @@
# Script to build Markdown pages that provide term metadata for simple vocabularies
# Steve Baskauf 2020-06-28 CC0
# This script merges static Markdown header and footer documents with term information tables (in Markdown) generated from data in the rs.tdwg.org repo from the TDWG Github site
# Note: this script calls a function from http_library.py, which requires importing the requests, csv, and json modules
import re
import requests # best library to manage HTTP transactions
import csv # library to read/write/parse CSV files
import json # library to convert JSON to Python data structures
import pandas as pd
# -----------------
# Configuration section
# -----------------
# !!!! Note !!!!
# This is an example of a simple vocabulary without categories. For a complex example
# with multiple namespaces and several categories, see build-page-categories.ipynb
# This is the base URL for raw files from the branch of the repo that has been pushed to GitHub. In this example,
# the branch is named "pathway"
githubBaseUri = 'https://raw.githubusercontent.com/tdwg/rs.tdwg.org/master/'
headerFileName = 'termlist-header.md'
footerFileName = 'termlist-footer.md'
outFileName = '../../docs/em/index.md'
# This is a Python list of the database names of the term lists to be included in the document.
termLists = ['establishmentMeans']
# NOTE! There may be problems unless every term list is of the same vocabulary type since the number of columns will differ
# However, there probably aren't any circumstances where mixed types will be used to generate the same page.
vocab_type = 2 # 1 is simple vocabulary, 2 is simple controlled vocabulary, 3 is c.v. with broader hierarchy
# Terms in large vocabularies like Darwin and Audubon Cores may be organized into categories using tdwgutility_organizedInClass
# If so, those categories can be used to group terms in the generated term list document.
organized_in_categories = False
# If organized in categories, the display_order list must contain the IRIs that are values of tdwgutility_organizedInClass
# If not organized into categories, the value is irrelevant. There just needs to be one item in the list.
display_order = ['']
display_label = ['Vocabulary'] # these are the section labels for the categories in the page
display_comments = [''] # these are the comments about the category to be appended following the section labels
display_id = ['Vocabulary'] # these are the fragment identifiers for the associated sections for the categories
# ---------------
# Function definitions
# ---------------
# replace URL with link
#
def createLinks(text):
def repl(match):
if match.group(1)[-1] == '.':
return '<a href="' + match.group(1)[:-1] + '">' + match.group(1)[:-1] + '</a>.'
return '<a href="' + match.group(1) + '">' + match.group(1) + '</a>'
pattern = '(https?://[^\s,;\)"]*)'
result = re.sub(pattern, repl, text)
return result
# 2021-08-06 Replace the createLinks() function with functions copied from the QRG build script written by S. Van Hoey
def convert_code(text_with_backticks):
"""Takes all back-quoted sections in a text field and converts it to
the html tagged version of code blocks <code>...</code>
"""
return re.sub(r'`([^`]*)`', r'<code>\1</code>', text_with_backticks)
def convert_link(text_with_urls):
"""Takes all links in a text field and converts it to the html tagged
version of the link
"""
def _handle_matched(inputstring):
"""quick hack version of url handling on the current prime versions data"""
url = inputstring.group()
return "<a href=\"{}\">{}</a>".format(url, url)
regx = "(http[s]?://[\w\d:#@%/;$()~_?\+-;=\\\.&]*)(?<![\)\.,])"
return re.sub(regx, _handle_matched, text_with_urls)
term_lists_info = []
frame = pd.read_csv(githubBaseUri + 'term-lists/term-lists.csv', na_filter=False)
for termList in termLists:
term_list_dict = {'list_iri': termList}
term_list_dict = {'database': termList}
for index,row in frame.iterrows():
if row['database'] == termList:
term_list_dict['pref_ns_prefix'] = row['vann_preferredNamespacePrefix']
term_list_dict['pref_ns_uri'] = row['vann_preferredNamespaceUri']
term_list_dict['list_iri'] = row['list']
term_lists_info.append(term_list_dict)
# Create column list
column_list = ['pref_ns_prefix', 'pref_ns_uri', 'term_localName', 'label', 'definition', 'usage', 'notes', 'term_modified', 'term_deprecated', 'type']
if vocab_type == 2:
column_list += ['controlled_value_string']
elif vocab_type == 3:
column_list += ['controlled_value_string', 'skos_broader']
if organized_in_categories:
column_list.append('tdwgutility_organizedInClass')
column_list.append('version_iri')
# Create list of lists metadata table
table_list = []
for term_list in term_lists_info:
# retrieve versions metadata for term list
versions_url = githubBaseUri + term_list['database'] + '-versions/' + term_list['database'] + '-versions.csv'
versions_df = pd.read_csv(versions_url, na_filter=False)
# retrieve current term metadata for term list
data_url = githubBaseUri + term_list['database'] + '/' + term_list['database'] + '.csv'
frame = pd.read_csv(data_url, na_filter=False)
for index,row in frame.iterrows():
row_list = [term_list['pref_ns_prefix'], term_list['pref_ns_uri'], row['term_localName'], row['label'], row['definition'], row['usage'], row['notes'], row['term_modified'], row['term_deprecated'], row['type']]
if vocab_type == 2:
row_list += [row['controlled_value_string']]
elif vocab_type == 3:
if row['skos_broader'] =='':
row_list += [row['controlled_value_string'], '']
else:
row_list += [row['controlled_value_string'], term_list['pref_ns_prefix'] + ':' + row['skos_broader']]
if organized_in_categories:
row_list.append(row['tdwgutility_organizedInClass'])
# Borrowed terms really don't have implemented versions. They may be lacking values for version_status.
# In their case, their version IRI will be omitted.
found = False
for vindex, vrow in versions_df.iterrows():
if vrow['term_localName']==row['term_localName'] and vrow['version_status']=='recommended':
found = True
version_iri = vrow['version']
# NOTE: the current hack for non-TDWG terms without a version is to append # to the end of the term IRI
if version_iri[len(version_iri)-1] == '#':
version_iri = ''
if not found:
version_iri = ''
row_list.append(version_iri)
table_list.append(row_list)
# Turn list of lists into dataframe
terms_df = pd.DataFrame(table_list, columns = column_list)
terms_sorted_by_label = terms_df.sort_values(by='label')
terms_sorted_by_localname = terms_df.sort_values(by='term_localName')
terms_sorted_by_label
# generate the index of terms grouped by category and sorted alphabetically by lowercase term local name
text = '### 3.1 Index By Term Name\n\n'
text += '(See also [3.2 Index By Label](#32-index-by-label))\n\n'
for category in range(0,len(display_order)):
text += '**' + display_label[category] + '**\n'
text += '\n'
if organized_in_categories:
filtered_table = terms_sorted_by_localname[terms_sorted_by_localname['tdwgutility_organizedInClass']==display_order[category]]
filtered_table.reset_index(drop=True, inplace=True)
else:
filtered_table = terms_sorted_by_localname
filtered_table.reset_index(drop=True, inplace=True)
for row_index,row in filtered_table.iterrows():
curie = row['pref_ns_prefix'] + ":" + row['term_localName']
curie_anchor = curie.replace(':','_')
text += '[' + curie + '](#' + curie_anchor + ')'
if row_index < len(filtered_table) - 1:
text += ' |'
text += '\n'
text += '\n'
index_by_name = text
text = '\n\n'
# Comment out the following two lines if there is no index by local names
#text = '### 3.2 Index By Label\n\n'
#text += '(See also [3.1 Index By Term Name](#31-index-by-term-name))\n\n'
for category in range(0,len(display_order)):
if organized_in_categories:
text += '**' + display_label[category] + '**\n'
text += '\n'
filtered_table = terms_sorted_by_label[terms_sorted_by_label['tdwgutility_organizedInClass']==display_order[category]]
filtered_table.reset_index(drop=True, inplace=True)
else:
filtered_table = terms_sorted_by_label
filtered_table.reset_index(drop=True, inplace=True)
for row_index,row in filtered_table.iterrows():
if row_index == 0 or (row_index != 0 and row['label'] != filtered_table.iloc[row_index - 1].loc['label']): # this is a hack to prevent duplicate labels
curie_anchor = row['pref_ns_prefix'] + "_" + row['term_localName']
text += '[' + row['label'] + '](#' + curie_anchor + ')'
if row_index < len(filtered_table) - 2 or (row_index == len(filtered_table) - 2 and row['label'] != filtered_table.iloc[row_index + 1].loc['label']):
text += ' |'
text += '\n'
text += '\n'
index_by_label = text
decisions_df = pd.read_csv('https://raw.githubusercontent.com/tdwg/rs.tdwg.org/master/decisions/decisions-links.csv', na_filter=False)
# generate a table for each term, with terms grouped by category
# generate the Markdown for the terms table
text = '## 4 Vocabulary\n'
for category in range(0,len(display_order)):
if organized_in_categories:
text += '### 4.' + str(category + 1) + ' ' + display_label[category] + '\n'
text += '\n'
text += display_comments[category] # insert the comments for the category, if any.
filtered_table = terms_sorted_by_localname[terms_sorted_by_localname['tdwgutility_organizedInClass']==display_order[category]]
filtered_table.reset_index(drop=True, inplace=True)
else:
filtered_table = terms_sorted_by_localname
filtered_table.reset_index(drop=True, inplace=True)
for row_index,row in filtered_table.iterrows():
text += '<table>\n'
curie = row['pref_ns_prefix'] + ":" + row['term_localName']
curieAnchor = curie.replace(':','_')
text += '\t<thead>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<th colspan="2"><a id="' + curieAnchor + '"></a>Term Name ' + curie + '</th>\n'
text += '\t\t</tr>\n'
text += '\t</thead>\n'
text += '\t<tbody>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Term IRI</td>\n'
uri = row['pref_ns_uri'] + row['term_localName']
text += '\t\t\t<td><a href="' + uri + '">' + uri + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Modified</td>\n'
text += '\t\t\t<td>' + row['term_modified'] + '</td>\n'
text += '\t\t</tr>\n'
if row['version_iri'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td>Term version IRI</td>\n'
text += '\t\t\t<td><a href="' + row['version_iri'] + '">' + row['version_iri'] + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Label</td>\n'
text += '\t\t\t<td>' + row['label'] + '</td>\n'
text += '\t\t</tr>\n'
if row['term_deprecated'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td></td>\n'
text += '\t\t\t<td><strong>This term is deprecated and should no longer be used.</strong></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Definition</td>\n'
text += '\t\t\t<td>' + row['definition'] + '</td>\n'
text += '\t\t</tr>\n'
if row['usage'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td>Usage</td>\n'
text += '\t\t\t<td>' + convert_link(convert_code(row['usage'])) + '</td>\n'
text += '\t\t</tr>\n'
if row['notes'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td>Notes</td>\n'
text += '\t\t\t<td>' + convert_link(convert_code(row['notes'])) + '</td>\n'
text += '\t\t</tr>\n'
if (vocab_type == 2 or vocab_type == 3) and row['controlled_value_string'] != '': # controlled vocabulary
text += '\t\t<tr>\n'
text += '\t\t\t<td>Controlled value</td>\n'
text += '\t\t\t<td>' + row['controlled_value_string'] + '</td>\n'
text += '\t\t</tr>\n'
if vocab_type == 3 and row['skos_broader'] != '': # controlled vocabulary with skos:broader relationships
text += '\t\t<tr>\n'
text += '\t\t\t<td>Has broader concept</td>\n'
curieAnchor = row['skos_broader'].replace(':','_')
text += '\t\t\t<td><a href="#' + curieAnchor + '">' + row['skos_broader'] + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Type</td>\n'
if row['type'] == 'http://www.w3.org/1999/02/22-rdf-syntax-ns#Property':
text += '\t\t\t<td>Property</td>\n'
elif row['type'] == 'http://www.w3.org/2000/01/rdf-schema#Class':
text += '\t\t\t<td>Class</td>\n'
elif row['type'] == 'http://www.w3.org/2004/02/skos/core#Concept':
text += '\t\t\t<td>Concept</td>\n'
else:
text += '\t\t\t<td>' + row['type'] + '</td>\n' # this should rarely happen
text += '\t\t</tr>\n'
# Look up decisions related to this term
for drow_index,drow in decisions_df.iterrows():
if drow['linked_affected_resource'] == uri:
text += '\t\t<tr>\n'
text += '\t\t\t<td>Executive Committee decision</td>\n'
text += '\t\t\t<td><a href="http://rs.tdwg.org/decisions/' + drow['decision_localName'] + '">http://rs.tdwg.org/decisions/' + drow['decision_localName'] + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t</tbody>\n'
text += '</table>\n'
text += '\n'
text += '\n'
term_table = text
text = index_by_label + term_table
# read in header and footer, merge with terms table, and output
headerObject = open(headerFileName, 'rt', encoding='utf-8')
header = headerObject.read()
headerObject.close()
footerObject = open(footerFileName, 'rt', encoding='utf-8')
footer = footerObject.read()
footerObject.close()
output = header + text + footer
outputObject = open(outFileName, 'wt', encoding='utf-8')
outputObject.write(output)
outputObject.close()
print('done')

9
build/em-cv-build/termlist-header.md
View File

@ -10,7 +10,7 @@ Preferred namespace abbreviation
: dwcem:
Date version issued
: 2020-10-13
: 2021-09-01
Date created
: 2020-10-13
@ -19,11 +19,14 @@ Part of TDWG Standard
: <http://www.tdwg.org/standards/450>
This document version
: <http://rs.tdwg.org/dwc/doc/em/2020-10-13>
: <http://rs.tdwg.org/dwc/doc/em/2021-09-01>
Latest version of document
: <http://rs.tdwg.org/dwc/doc/em/>
Previous version
: <http://rs.tdwg.org/dwc/doc/em/2020-10-13>
Abstract
: The Darwin Core term `establishmentMeans` provides information about whether an organism or organisms have been introduced to a given place and time through the direct or indirect activity of modern humans. The Establishment Means Controlled Vocabulary provides terms that should be used as values for `dwc:establishmentMeans` and `dwciri:establishmentMeans`.
@ -34,7 +37,7 @@ Creator
: TDWG Darwin Core Maintenance Group
Bibliographic citation
: Darwin Core Maintenance Group. 2020. Establishment Means Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/em/2020-10-13>
: Darwin Core Maintenance Group. 2021. Establishment Means Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/em/2021-09-01>
## 1 Introduction

326
build/pw-cv-build/pw_build.py Normal file
View File

@ -0,0 +1,326 @@
# Script to build Markdown pages that provide term metadata for simple vocabularies
# Steve Baskauf 2020-06-28 CC0
# This script merges static Markdown header and footer documents with term information tables (in Markdown) generated from data in the rs.tdwg.org repo from the TDWG Github site
# Note: this script calls a function from http_library.py, which requires importing the requests, csv, and json modules
import re
import requests # best library to manage HTTP transactions
import csv # library to read/write/parse CSV files
import json # library to convert JSON to Python data structures
import pandas as pd
# -----------------
# Configuration section
# -----------------
# !!!! Note !!!!
# This is an example of a simple vocabulary without categories. For a complex example
# with multiple namespaces and several categories, see build-page-categories.ipynb
# This is the base URL for raw files from the branch of the repo that has been pushed to GitHub. In this example,
# the branch is named "pathway"
githubBaseUri = 'https://raw.githubusercontent.com/tdwg/rs.tdwg.org/master/'
headerFileName = 'termlist-header.md'
footerFileName = 'termlist-footer.md'
outFileName = '../../docs/pw/index.md'
# This is a Python list of the database names of the term lists to be included in the document.
termLists = ['pathway']
# NOTE! There may be problems unless every term list is of the same vocabulary type since the number of columns will differ
# However, there probably aren't any circumstances where mixed types will be used to generate the same page.
vocab_type = 3 # 1 is simple vocabulary, 2 is simple controlled vocabulary, 3 is c.v. with broader hierarchy
# Terms in large vocabularies like Darwin and Audubon Cores may be organized into categories using tdwgutility_organizedInClass
# If so, those categories can be used to group terms in the generated term list document.
organized_in_categories = False
# If organized in categories, the display_order list must contain the IRIs that are values of tdwgutility_organizedInClass
# If not organized into categories, the value is irrelevant. There just needs to be one item in the list.
display_order = ['']
display_label = ['Vocabulary'] # these are the section labels for the categories in the page
display_comments = [''] # these are the comments about the category to be appended following the section labels
display_id = ['Vocabulary'] # these are the fragment identifiers for the associated sections for the categories
# ---------------
# Function definitions
# ---------------
# replace URL with link
#
def createLinks(text):
def repl(match):
if match.group(1)[-1] == '.':
return '<a href="' + match.group(1)[:-1] + '">' + match.group(1)[:-1] + '</a>.'
return '<a href="' + match.group(1) + '">' + match.group(1) + '</a>'
pattern = '(https?://[^\s,;\)"]*)'
result = re.sub(pattern, repl, text)
return result
# 2021-08-06 Replace the createLinks() function with functions copied from the QRG build script written by S. Van Hoey
def convert_code(text_with_backticks):
"""Takes all back-quoted sections in a text field and converts it to
the html tagged version of code blocks <code>...</code>
"""
return re.sub(r'`([^`]*)`', r'<code>\1</code>', text_with_backticks)
def convert_link(text_with_urls):
"""Takes all links in a text field and converts it to the html tagged
version of the link
"""
def _handle_matched(inputstring):
"""quick hack version of url handling on the current prime versions data"""
url = inputstring.group()
return "<a href=\"{}\">{}</a>".format(url, url)
regx = "(http[s]?://[\w\d:#@%/;$()~_?\+-;=\\\.&]*)(?<![\)\.,])"
return re.sub(regx, _handle_matched, text_with_urls)
term_lists_info = []
frame = pd.read_csv(githubBaseUri + 'term-lists/term-lists.csv', na_filter=False)
for termList in termLists:
term_list_dict = {'list_iri': termList}
term_list_dict = {'database': termList}
for index,row in frame.iterrows():
if row['database'] == termList:
term_list_dict['pref_ns_prefix'] = row['vann_preferredNamespacePrefix']
term_list_dict['pref_ns_uri'] = row['vann_preferredNamespaceUri']
term_list_dict['list_iri'] = row['list']
term_lists_info.append(term_list_dict)
# Create column list
column_list = ['pref_ns_prefix', 'pref_ns_uri', 'term_localName', 'label', 'definition', 'usage', 'notes', 'term_modified', 'term_deprecated', 'type']
if vocab_type == 2:
column_list += ['controlled_value_string']
elif vocab_type == 3:
column_list += ['controlled_value_string', 'skos_broader']
if organized_in_categories:
column_list.append('tdwgutility_organizedInClass')
column_list.append('version_iri')
# Create list of lists metadata table
table_list = []
for term_list in term_lists_info:
# retrieve versions metadata for term list
versions_url = githubBaseUri + term_list['database'] + '-versions/' + term_list['database'] + '-versions.csv'
versions_df = pd.read_csv(versions_url, na_filter=False)
# retrieve current term metadata for term list
data_url = githubBaseUri + term_list['database'] + '/' + term_list['database'] + '.csv'
frame = pd.read_csv(data_url, na_filter=False)
for index,row in frame.iterrows():
row_list = [term_list['pref_ns_prefix'], term_list['pref_ns_uri'], row['term_localName'], row['label'], row['definition'], row['usage'], row['notes'], row['term_modified'], row['term_deprecated'], row['type']]
if vocab_type == 2:
row_list += [row['controlled_value_string']]
elif vocab_type == 3:
if row['skos_broader'] =='':
row_list += [row['controlled_value_string'], '']
else:
row_list += [row['controlled_value_string'], term_list['pref_ns_prefix'] + ':' + row['skos_broader']]
if organized_in_categories:
row_list.append(row['tdwgutility_organizedInClass'])
# Borrowed terms really don't have implemented versions. They may be lacking values for version_status.
# In their case, their version IRI will be omitted.
found = False
for vindex, vrow in versions_df.iterrows():
if vrow['term_localName']==row['term_localName'] and vrow['version_status']=='recommended':
found = True
version_iri = vrow['version']
# NOTE: the current hack for non-TDWG terms without a version is to append # to the end of the term IRI
if version_iri[len(version_iri)-1] == '#':
version_iri = ''
if not found:
version_iri = ''
row_list.append(version_iri)
table_list.append(row_list)
# Turn list of lists into dataframe
terms_df = pd.DataFrame(table_list, columns = column_list)
terms_sorted_by_label = terms_df.sort_values(by='label')
terms_sorted_by_localname = terms_df.sort_values(by='term_localName')
terms_sorted_by_label
# generate the index of terms grouped by category and sorted alphabetically by lowercase term local name
text = '### 3.1 Index By Term Name\n\n'
text += '(See also [3.2 Index By Label](#32-index-by-label))\n\n'
for category in range(0,len(display_order)):
text += '**' + display_label[category] + '**\n'
text += '\n'
if organized_in_categories:
filtered_table = terms_sorted_by_localname[terms_sorted_by_localname['tdwgutility_organizedInClass']==display_order[category]]
filtered_table.reset_index(drop=True, inplace=True)
else:
filtered_table = terms_sorted_by_localname
filtered_table.reset_index(drop=True, inplace=True)
for row_index,row in filtered_table.iterrows():
curie = row['pref_ns_prefix'] + ":" + row['term_localName']
curie_anchor = curie.replace(':','_')
text += '[' + curie + '](#' + curie_anchor + ')'
if row_index < len(filtered_table) - 1:
text += ' |'
text += '\n'
text += '\n'
index_by_name = text
text = '\n\n'
# Comment out the following two lines if there is no index by local names
#text = '### 3.2 Index By Label\n\n'
#text += '(See also [3.1 Index By Term Name](#31-index-by-term-name))\n\n'
for category in range(0,len(display_order)):
if organized_in_categories:
text += '**' + display_label[category] + '**\n'
text += '\n'
filtered_table = terms_sorted_by_label[terms_sorted_by_label['tdwgutility_organizedInClass']==display_order[category]]
filtered_table.reset_index(drop=True, inplace=True)
else:
filtered_table = terms_sorted_by_label
filtered_table.reset_index(drop=True, inplace=True)
for row_index,row in filtered_table.iterrows():
if row_index == 0 or (row_index != 0 and row['label'] != filtered_table.iloc[row_index - 1].loc['label']): # this is a hack to prevent duplicate labels
curie_anchor = row['pref_ns_prefix'] + "_" + row['term_localName']
text += '[' + row['label'] + '](#' + curie_anchor + ')'
if row_index < len(filtered_table) - 2 or (row_index == len(filtered_table) - 2 and row['label'] != filtered_table.iloc[row_index + 1].loc['label']):
text += ' |'
text += '\n'
text += '\n'
index_by_label = text
decisions_df = pd.read_csv('https://raw.githubusercontent.com/tdwg/rs.tdwg.org/master/decisions/decisions-links.csv', na_filter=False)
# generate a table for each term, with terms grouped by category
# generate the Markdown for the terms table
text = '## 4 Vocabulary\n'
for category in range(0,len(display_order)):
if organized_in_categories:
text += '### 4.' + str(category + 1) + ' ' + display_label[category] + '\n'
text += '\n'
text += display_comments[category] # insert the comments for the category, if any.
filtered_table = terms_sorted_by_localname[terms_sorted_by_localname['tdwgutility_organizedInClass']==display_order[category]]
filtered_table.reset_index(drop=True, inplace=True)
else:
filtered_table = terms_sorted_by_localname
filtered_table.reset_index(drop=True, inplace=True)
for row_index,row in filtered_table.iterrows():
text += '<table>\n'
curie = row['pref_ns_prefix'] + ":" + row['term_localName']
curieAnchor = curie.replace(':','_')
text += '\t<thead>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<th colspan="2"><a id="' + curieAnchor + '"></a>Term Name ' + curie + '</th>\n'
text += '\t\t</tr>\n'
text += '\t</thead>\n'
text += '\t<tbody>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Term IRI</td>\n'
uri = row['pref_ns_uri'] + row['term_localName']
text += '\t\t\t<td><a href="' + uri + '">' + uri + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Modified</td>\n'
text += '\t\t\t<td>' + row['term_modified'] + '</td>\n'
text += '\t\t</tr>\n'
if row['version_iri'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td>Term version IRI</td>\n'
text += '\t\t\t<td><a href="' + row['version_iri'] + '">' + row['version_iri'] + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Label</td>\n'
text += '\t\t\t<td>' + row['label'] + '</td>\n'
text += '\t\t</tr>\n'
if row['term_deprecated'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td></td>\n'
text += '\t\t\t<td><strong>This term is deprecated and should no longer be used.</strong></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Definition</td>\n'
text += '\t\t\t<td>' + row['definition'] + '</td>\n'
text += '\t\t</tr>\n'
if row['usage'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td>Usage</td>\n'
text += '\t\t\t<td>' + convert_link(convert_code(row['usage'])) + '</td>\n'
text += '\t\t</tr>\n'
if row['notes'] != '':
text += '\t\t<tr>\n'
text += '\t\t\t<td>Notes</td>\n'
text += '\t\t\t<td>' + convert_link(convert_code(row['notes'])) + '</td>\n'
text += '\t\t</tr>\n'
if (vocab_type == 2 or vocab_type == 3) and row['controlled_value_string'] != '': # controlled vocabulary
text += '\t\t<tr>\n'
text += '\t\t\t<td>Controlled value</td>\n'
text += '\t\t\t<td>' + row['controlled_value_string'] + '</td>\n'
text += '\t\t</tr>\n'
if vocab_type == 3 and row['skos_broader'] != '': # controlled vocabulary with skos:broader relationships
text += '\t\t<tr>\n'
text += '\t\t\t<td>Has broader concept</td>\n'
curieAnchor = row['skos_broader'].replace(':','_')
text += '\t\t\t<td><a href="#' + curieAnchor + '">' + row['skos_broader'] + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t\t<tr>\n'
text += '\t\t\t<td>Type</td>\n'
if row['type'] == 'http://www.w3.org/1999/02/22-rdf-syntax-ns#Property':
text += '\t\t\t<td>Property</td>\n'
elif row['type'] == 'http://www.w3.org/2000/01/rdf-schema#Class':
text += '\t\t\t<td>Class</td>\n'
elif row['type'] == 'http://www.w3.org/2004/02/skos/core#Concept':
text += '\t\t\t<td>Concept</td>\n'
else:
text += '\t\t\t<td>' + row['type'] + '</td>\n' # this should rarely happen
text += '\t\t</tr>\n'
# Look up decisions related to this term
for drow_index,drow in decisions_df.iterrows():
if drow['linked_affected_resource'] == uri:
text += '\t\t<tr>\n'
text += '\t\t\t<td>Executive Committee decision</td>\n'
text += '\t\t\t<td><a href="http://rs.tdwg.org/decisions/' + drow['decision_localName'] + '">http://rs.tdwg.org/decisions/' + drow['decision_localName'] + '</a></td>\n'
text += '\t\t</tr>\n'
text += '\t</tbody>\n'
text += '</table>\n'
text += '\n'
text += '\n'
term_table = text
text = index_by_label + term_table
# read in header and footer, merge with terms table, and output
headerObject = open(headerFileName, 'rt', encoding='utf-8')
header = headerObject.read()
headerObject.close()
footerObject = open(footerFileName, 'rt', encoding='utf-8')
footer = footerObject.read()
footerObject.close()
output = header + text + footer
outputObject = open(outFileName, 'wt', encoding='utf-8')
outputObject.write(output)
outputObject.close()
print('done')

9
build/pw-cv-build/termlist-header.md
View File

@ -10,7 +10,7 @@ Preferred namespace abbreviation
: dwcpw:
Date version issued
: 2020-10-13
: 2021-09-01
Date created
: 2020-10-13
@ -19,11 +19,14 @@ Part of TDWG Standard
: <http://www.tdwg.org/standards/450>
This document version
: <http://rs.tdwg.org/dwc/doc/pw/2020-10-13>
: <http://rs.tdwg.org/dwc/doc/pw/2021-09-01>
Latest version of document
: <http://rs.tdwg.org/dwc/doc/pw/>
Previous version
: <http://rs.tdwg.org/dwc/doc/pw/2020-10-13>
Abstract
: The Darwin Core term `pathway` provides information about the process by which an Organism came to be in a given place at a given time. The Pathway Controlled Vocabulary provides terms that should be used as values for `dwc:pathway` and `dwciri:pathway`.
@ -34,7 +37,7 @@ Creator
: TDWG Darwin Core Maintenance Group
Bibliographic citation
: Darwin Core Maintenance Group. 2020. Pathway Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/pw//2020-10-13>
: Darwin Core Maintenance Group. 2021. Pathway Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/pw/2021-09-01>
## 1 Introduction

627
docs/doe/2020-10-13.md Normal file
View File

@ -0,0 +1,627 @@
# Degree of Establishment Controlled Vocabulary List of Terms
Title
: Degree of Establishment Controlled Vocabulary List of Terms
Namespace URI
: <http://rs.tdwg.org/dwcdoe/values/>
Preferred namespace abbreviation
: dwcdoe:
Date version issued
: 2020-10-13
Date created
: 2020-10-13
Part of TDWG Standard
: <http://www.tdwg.org/standards/450>
This document version
: <http://rs.tdwg.org/dwc/doc/doe/2020-10-13>
Latest version of document
: <http://rs.tdwg.org/dwc/doc/doe/>
Replaced by
: <http://rs.tdwg.org/dwc/doc/doe/2021-09-01>
Abstract
: The Darwin Core term `degreeOfEstablishment` provides information about degree to which an Organism survives, reproduces, and expands its range at the given place and time.. The Degree of Establishment Controlled Vocabulary provides terms that should be used as values for `dwc:degreeOfEstablishment` and `dwciri:degreeOfEstablishment`.
Contributors
: Quentin Groom, Peter Desmet, Lien Reyserhove, Tim Adriaens, Damiano Oldoni, Sonia Vanderhoeven, Steven J Baskauf, Arthur Chapman, Melodie McGeoch, Ramona Walls, John Wieczorek, John R.U. Wilson, Paula F F Zermoglio, Annie Simpson
Creator
: TDWG Darwin Core Maintenance Group
Bibliographic citation
: Darwin Core Maintenance Group. 2020. Degree of Establishment Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/doe/2020-10-13>
## 1 Introduction
This document includes terms intended to be used as a controlled value for Darwin Core terms with local name `degreeOfEstablishment`. For details and rationale, see Groom et al. 2019. Improving Darwin Core for research and management of alien species. <https://doi.org/10.3897/biss.3.38084>
### 1.1 Status of the content of this document
In Section 4, the values of the `Term IRI`, `Definition`, and `Controlled value` are normative. The value of `Usage` (if it exists for a given term) is normative. The values of `Term Name` are non-normative, although one can expect that the namespace abbreviation prefix is one commonly used for the term namespace. `Label` and the values of all other properties (such as `Notes`) are non-normative.
### 1.2 RFC 2119 key words
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC 2119](https://tools.ietf.org/html/rfc2119).
## 2 Use of Terms
Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://rs.tdwg.org/dwc/terms/guides/rdf/#143-use-of-darwin-core-terms-in-rdf-normative), term IRIs MUST be used as values of `dwciri:degreeOfEstablishment`. Controlled value strings MUST be used as values of `dwc:degreeOfEstablishment`.
## 3 Term index
[captive (category B1)](#dwcdoe_d002) |
[casual (category C1)](#dwcdoe_d006) |
[colonising (category D1)](#dwcdoe_d009) |
[cultivated (category B2)](#dwcdoe_d003) |
[degreeOfEstablishment concept scheme](#dwcdoe_d) |
[established (category C3)](#dwcdoe_d008) |
[failing (category C0)](#dwcdoe_d005) |
[invasive (category D2)](#dwcdoe_d010) |
[native (category A)](#dwcdoe_d001) |
[released (category B3)](#dwcdoe_d004) |
[reproducing (category C2)](#dwcdoe_d007) |
[widespread invasive (category E)](#dwcdoe_d011)
## 4 Vocabulary
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d"></a>Term Name dwcdoe:d</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d">http://rs.tdwg.org/dwcdoe/values/d</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>degreeOfEstablishment concept scheme</td>
</tr>
<tr>
<td>Definition</td>
<td>A SKOS Concept Scheme to be used as a controlled vocabulary for the Darwin Core terms dwc:degreeOfEstablishment and dwciri:degreeOfEstablishment</td>
</tr>
<tr>
<td>Type</td>
<td>http://www.w3.org/2004/02/skos/core#ConceptScheme</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d001"></a>Term Name dwcdoe:d001</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d001">http://rs.tdwg.org/dwcdoe/values/d001</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d001-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d001-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>native (category A)</td>
</tr>
<tr>
<td>Definition</td>
<td>Not transported beyond limits of native range</td>
</tr>
<tr>
<td>Notes</td>
<td>Considered native and naturally occuring. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category A</td>
</tr>
<tr>
<td>Controlled value</td>
<td>native</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d002"></a>Term Name dwcdoe:d002</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d002">http://rs.tdwg.org/dwcdoe/values/d002</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d002-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d002-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>captive (category B1)</td>
</tr>
<tr>
<td>Definition</td>
<td>Individuals in captivity or quarantine (i.e. individuals provided with conditions suitable for them, but explicit measures of containment are in place)</td>
</tr>
<tr>
<td>Usage</td>
<td>Only for cases where specific actions have been taken place to prevent escape of individuals or propagules</td>
</tr>
<tr>
<td>Notes</td>
<td>See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category B1</td>
</tr>
<tr>
<td>Controlled value</td>
<td>captive</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d003"></a>Term Name dwcdoe:d003</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d003">http://rs.tdwg.org/dwcdoe/values/d003</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d003-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d003-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>cultivated (category B2)</td>
</tr>
<tr>
<td>Definition</td>
<td>Individuals in cultivation (i.e. individuals provided with conditions suitable for them, but explicit measures to prevent dispersal are limited at best)</td>
</tr>
<tr>
<td>Notes</td>
<td>Examples include gardens, parks and farms. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category B2</td>
</tr>
<tr>
<td>Controlled value</td>
<td>cultivated</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d004"></a>Term Name dwcdoe:d004</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d004">http://rs.tdwg.org/dwcdoe/values/d004</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d004-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d004-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>released (category B3)</td>
</tr>
<tr>
<td>Definition</td>
<td>Individuals directly released into novel environment</td>
</tr>
<tr>
<td>Notes</td>
<td>For example, fish stocked for angling, birds for hunting. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category B3</td>
</tr>
<tr>
<td>Controlled value</td>
<td>released</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d005"></a>Term Name dwcdoe:d005</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d005">http://rs.tdwg.org/dwcdoe/values/d005</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d005-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d005-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>failing (category C0)</td>
</tr>
<tr>
<td>Definition</td>
<td>Individuals released outside of captivity or cultivation in a location, but incapable of surviving for a significant period</td>
</tr>
<tr>
<td>Notes</td>
<td>Such as frost tender plants sown or planted in a cold climate. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category C0</td>
</tr>
<tr>
<td>Controlled value</td>
<td>failing</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d006"></a>Term Name dwcdoe:d006</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d006">http://rs.tdwg.org/dwcdoe/values/d006</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d006-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d006-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>casual (category C1)</td>
</tr>
<tr>
<td>Definition</td>
<td>Individuals surviving outside of captivity or cultivation in a location, no reproduction</td>
</tr>
<tr>
<td>Notes</td>
<td>Trees planted in the wild for forestry or ornament may come under this category. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category C1</td>
</tr>
<tr>
<td>Controlled value</td>
<td>casual</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d007"></a>Term Name dwcdoe:d007</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d007">http://rs.tdwg.org/dwcdoe/values/d007</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d007-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d007-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>reproducing (category C2)</td>
</tr>
<tr>
<td>Definition</td>
<td>Individuals surviving outside of captivity or cultivation in a location, reproduction is occurring, but population not self-sustaining</td>
</tr>
<tr>
<td>Notes</td>
<td>Offspring are produced, but these either do not survive or are fertile enough to maintain the population. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category C2</td>
</tr>
<tr>
<td>Controlled value</td>
<td>reproducing</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d008"></a>Term Name dwcdoe:d008</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d008">http://rs.tdwg.org/dwcdoe/values/d008</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d008-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d008-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>established (category C3)</td>
</tr>
<tr>
<td>Definition</td>
<td>Individuals surviving outside of captivity or cultivation in a location, reproduction occurring, and population self-sustaining</td>
</tr>
<tr>
<td>Notes</td>
<td>The population is maintained by reproduction, but is not spreading. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category C3</td>
</tr>
<tr>
<td>Controlled value</td>
<td>established</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d009"></a>Term Name dwcdoe:d009</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d009">http://rs.tdwg.org/dwcdoe/values/d009</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d009-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d009-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>colonising (category D1)</td>
</tr>
<tr>
<td>Definition</td>
<td>Self-sustaining population outside of captivity or cultivation, with individuals surviving a significant distance from the original point of introduction</td>
</tr>
<tr>
<td>Notes</td>
<td>The population is maintained by reproduction and is spreading. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category D1</td>
</tr>
<tr>
<td>Controlled value</td>
<td>colonising</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d010"></a>Term Name dwcdoe:d010</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d010">http://rs.tdwg.org/dwcdoe/values/d010</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d010-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d010-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>invasive (category D2)</td>
</tr>
<tr>
<td>Definition</td>
<td>Self-sustaining population outside of captivity or cultivation, with individuals surviving and reproducing a significant distance from the original point of introduction</td>
</tr>
<tr>
<td>Notes</td>
<td>The population is maintained by reproduction, is spreading, and their progeny is also reproducing and spreading. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category D2</td>
</tr>
<tr>
<td>Controlled value</td>
<td>invasive</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcdoe_d011"></a>Term Name dwcdoe:d011</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/d011">http://rs.tdwg.org/dwcdoe/values/d011</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d011-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d011-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>widespread invasive (category E)</td>
</tr>
<tr>
<td>Definition</td>
<td>Fully invasive species, with individuals dispersing, surviving and reproducing at multiple sites across a greater or lesser spectrum of habitats and extent of occurrence</td>
</tr>
<tr>
<td>Usage</td>
<td>This term is only used for those invasives with the highest degree of encroachment</td>
</tr>
<tr>
<td>Notes</td>
<td>See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category E</td>
</tr>
<tr>
<td>Controlled value</td>
<td>widespreadInvasive</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_26">http://rs.tdwg.org/decisions/decision-2020-10-13_26</a></td>
</tr>
</tbody>
</table>

101
docs/doe/index.md
View File

@ -10,7 +10,7 @@ Preferred namespace abbreviation
: dwcdoe:
Date version issued
: 2020-10-13
: 2021-09-01
Date created
: 2020-10-13
@ -19,11 +19,14 @@ Part of TDWG Standard
: <http://www.tdwg.org/standards/450>
This document version
: <http://rs.tdwg.org/dwc/doc/doe/2020-10-13>
: <http://rs.tdwg.org/dwc/doc/doe/2021-09-01>
Latest version of document
: <http://rs.tdwg.org/dwc/doc/doe/>
Previous version
: <http://rs.tdwg.org/dwc/doc/doe/2020-10-13>
Abstract
: The Darwin Core term `degreeOfEstablishment` provides information about degree to which an Organism survives, reproduces, and expands its range at the given place and time.. The Degree of Establishment Controlled Vocabulary provides terms that should be used as values for `dwc:degreeOfEstablishment` and `dwciri:degreeOfEstablishment`.
@ -34,7 +37,7 @@ Creator
: TDWG Darwin Core Maintenance Group
Bibliographic citation
: Darwin Core Maintenance Group. 2020. Degree of Establishment Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/doe/2020-10-13>
: Darwin Core Maintenance Group. 2021. Degree of Establishment Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/doe/2021-09-01>
## 1 Introduction
@ -120,11 +123,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d001-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d001-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d001-2021-09-01">http://rs.tdwg.org/dwcdoe/values/version/d001-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -132,11 +135,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Definition</td>
<td>Not transported beyond limits of native range</td>
<td>Not transported beyond limits of native range.</td>
</tr>
<tr>
<td>Notes</td>
<td>Considered native and naturally occuring. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category A</td>
<td>Considered native and naturally occurring. See also "category A" in Blackburn et al. 2011. <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a></td>
</tr>
<tr>
<td>Controlled value</td>
@ -166,11 +169,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d002-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d002-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d002-2021-09-01">http://rs.tdwg.org/dwcdoe/values/version/d002-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -178,15 +181,15 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Definition</td>
<td>Individuals in captivity or quarantine (i.e. individuals provided with conditions suitable for them, but explicit measures of containment are in place)</td>
<td>Individuals in captivity or quarantine (i.e., individuals provided with conditions suitable for them, but explicit measures of containment are in place).</td>
</tr>
<tr>
<td>Usage</td>
<td>Only for cases where specific actions have been taken place to prevent escape of individuals or propagules</td>
<td>Only for cases where specific actions have been taken place to prevent escape of individuals or propagules.</td>
</tr>
<tr>
<td>Notes</td>
<td>See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category B1</td>
<td>See also "category B1" in Blackburn et al. 2011. <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a></td>
</tr>
<tr>
<td>Controlled value</td>
@ -216,11 +219,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d003-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d003-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d003-2021-09-01">http://rs.tdwg.org/dwcdoe/values/version/d003-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -228,11 +231,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Definition</td>
<td>Individuals in cultivation (i.e. individuals provided with conditions suitable for them, but explicit measures to prevent dispersal are limited at best)</td>
<td>Individuals in cultivation (i.e., individuals provided with conditions suitable for them, but explicit measures to prevent dispersal are limited at best).</td>
</tr>
<tr>
<td>Notes</td>
<td>Examples include gardens, parks and farms. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category B2</td>
<td>Examples include gardens, parks and farms. See also "category B2" in Blackburn et al. 2011. <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a></td>
</tr>
<tr>
<td>Controlled value</td>
@ -262,11 +265,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d004-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d004-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d004-2021-09-01">http://rs.tdwg.org/dwcdoe/values/version/d004-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -274,11 +277,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Definition</td>
<td>Individuals directly released into novel environment</td>
<td>Individuals directly released into novel environment.</td>
</tr>
<tr>
<td>Notes</td>
<td>For example, fish stocked for angling, birds for hunting. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category B3</td>
<td>For example, fish stocked for angling, birds for hunting. See also "category B3" in Blackburn et al. 2011. <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a></td>
</tr>
<tr>
<td>Controlled value</td>
@ -308,11 +311,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d005-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d005-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d005-2021-09-01">http://rs.tdwg.org/dwcdoe/values/version/d005-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -320,11 +323,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Definition</td>
<td>Individuals released outside of captivity or cultivation in a location, but incapable of surviving for a significant period</td>
<td>Individuals released outside of captivity or cultivation in a location, but incapable of surviving for a significant period.</td>
</tr>
<tr>
<td>Notes</td>
<td>Such as frost tender plants sown or planted in a cold climate. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category C0</td>
<td>For example, frost-tender plants sown or planted in a cold climate. See also "category C0" in Blackburn et al. 2011. <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a></td>
</tr>
<tr>
<td>Controlled value</td>
@ -354,11 +357,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d006-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d006-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d006-2021-09-01">http://rs.tdwg.org/dwcdoe/values/version/d006-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -366,11 +369,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Definition</td>
<td>Individuals surviving outside of captivity or cultivation in a location, no reproduction</td>
<td>Individuals surviving outside of captivity or cultivation in a location with no reproduction.</td>
</tr>
<tr>
<td>Notes</td>
<td>Trees planted in the wild for forestry or ornament may come under this category. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category C1</td>
<td>Trees planted in the wild for forestry or ornament may come under this category. See also "category C1" in Blackburn et al. 2011. <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a></td>
</tr>
<tr>
<td>Controlled value</td>
@ -400,11 +403,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d007-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d007-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d007-2021-09-01">http://rs.tdwg.org/dwcdoe/values/version/d007-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -412,11 +415,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Definition</td>
<td>Individuals surviving outside of captivity or cultivation in a location, reproduction is occurring, but population not self-sustaining</td>
<td>Individuals surviving outside of captivity or cultivation in a location. Reproduction is occurring, but population not self-sustaining.</td>
</tr>
<tr>
<td>Notes</td>
<td>Offspring are produced, but these either do not survive or are fertile enough to maintain the population. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category C2</td>
<td>Offspring are produced, but these either do not survive or are not fertile enough to maintain the population. See also "category C2" in Blackburn et al. 2011. <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a></td>
</tr>
<tr>
<td>Controlled value</td>
@ -446,11 +449,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d008-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d008-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d008-2021-09-01">http://rs.tdwg.org/dwcdoe/values/version/d008-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -458,11 +461,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Definition</td>
<td>Individuals surviving outside of captivity or cultivation in a location, reproduction occurring, and population self-sustaining</td>
<td>Individuals surviving outside of captivity or cultivation in a location. Reproduction occurring, and population self-sustaining.</td>
</tr>
<tr>
<td>Notes</td>
<td>The population is maintained by reproduction, but is not spreading. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category C3</td>
<td>The population is maintained by reproduction, but is not spreading. See also "category C3" in Blackburn et al. 2011. <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a></td>
</tr>
<tr>
<td>Controlled value</td>
@ -492,11 +495,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d009-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d009-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d009-2021-09-01">http://rs.tdwg.org/dwcdoe/values/version/d009-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -504,11 +507,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Definition</td>
<td>Self-sustaining population outside of captivity or cultivation, with individuals surviving a significant distance from the original point of introduction</td>
<td>Self-sustaining population outside of captivity or cultivation, with individuals surviving a significant distance from the original point of introduction.</td>
</tr>
<tr>
<td>Notes</td>
<td>The population is maintained by reproduction and is spreading. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category D1</td>
<td>The population is maintained by reproduction and is spreading. See also "category D1" in Blackburn et al. 2011. <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a></td>
</tr>
<tr>
<td>Controlled value</td>
@ -538,11 +541,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d010-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d010-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d010-2021-09-01">http://rs.tdwg.org/dwcdoe/values/version/d010-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -550,11 +553,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Definition</td>
<td>Self-sustaining population outside of captivity or cultivation, with individuals surviving and reproducing a significant distance from the original point of introduction</td>
<td>Self-sustaining population outside of captivity or cultivation, with individuals surviving and reproducing a significant distance from the original point of introduction.</td>
</tr>
<tr>
<td>Notes</td>
<td>The population is maintained by reproduction, is spreading, and their progeny is also reproducing and spreading. See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category D2</td>
<td>The population is maintained by reproduction, is spreading, and its progeny are also reproducing and spreading. See also "category D2" in Blackburn et al. 2011. <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a></td>
</tr>
<tr>
<td>Controlled value</td>
@ -584,11 +587,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d011-2020-10-13">http://rs.tdwg.org/dwcdoe/values/version/d011-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcdoe/values/version/d011-2021-09-01">http://rs.tdwg.org/dwcdoe/values/version/d011-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -596,15 +599,15 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](http://r
</tr>
<tr>
<td>Definition</td>
<td>Fully invasive species, with individuals dispersing, surviving and reproducing at multiple sites across a greater or lesser spectrum of habitats and extent of occurrence</td>
<td>Fully invasive species, with individuals dispersing, surviving and reproducing at multiple sites across a spectrum of habitats and geographic range.</td>
</tr>
<tr>
<td>Usage</td>
<td>This term is only used for those invasives with the highest degree of encroachment</td>
<td>This term is only used for those invasives with the highest degree of encroachment.</td>
</tr>
<tr>
<td>Notes</td>
<td>See also Blackburn et al. 2011 <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a> category E</td>
<td>See also "category E" in Blackburn et al. 2011. <a href="https://doi.org/10.1016/j.tree.2011.03.023">https://doi.org/10.1016/j.tree.2011.03.023</a></td>
</tr>
<tr>
<td>Controlled value</td>

384
docs/em/2020-10-13.md Normal file
View File

@ -0,0 +1,384 @@
# Establishment Means Controlled Vocabulary List of Terms
Title
: Establishment Means Controlled Vocabulary List of Terms
Namespace URI
: <http://rs.tdwg.org/dwcem/values/>
Preferred namespace abbreviation
: dwcem:
Date version issued
: 2020-10-13
Date created
: 2020-10-13
Part of TDWG Standard
: <http://www.tdwg.org/standards/450>
This document version
: <http://rs.tdwg.org/dwc/doc/em/2020-10-13>
Latest version of document
: <http://rs.tdwg.org/dwc/doc/em/>
Replaced by
: <http://rs.tdwg.org/dwc/doc/pw/2021-09-01>
Abstract
: The Darwin Core term `establishmentMeans` provides information about whether an organism or organisms have been introduced to a given place and time through the direct or indirect activity of modern humans. The Establishment Means Controlled Vocabulary provides terms that should be used as values for `dwc:establishmentMeans` and `dwciri:establishmentMeans`.
Contributors
: Quentin Groom, Peter Desmet, Lien Reyserhove, Tim Adriaens, Damiano Oldoni, Sonia Vanderhoeven, Steven J Baskauf, Arthur Chapman, Melodie McGeoch, Ramona Walls, John Wieczorek, John R.U. Wilson, Paula F F Zermoglio, Annie Simpson
Creator
: TDWG Darwin Core Maintenance Group
Bibliographic citation
: Darwin Core Maintenance Group. 2020. Establishment Means Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/em/2020-10-13>
## 1 Introduction
This document includes terms intended to be used as a controlled value for Darwin Core terms with local name `establishmentMeans`. For details and rationale, see Groom et al. 2019. Improving Darwin Core for research and management of alien species. <https://doi.org/10.3897/biss.3.38084>
### 1.1 Status of the content of this document
In Section 4, the values of the `Term IRI`, `Definition`, and `Controlled value` are normative. The value of `Usage` (if it exists for a given term) is normative. The values of `Term Name` are non-normative, although one can expect that the namespace abbreviation prefix is one commonly used for the term namespace. `Label` and the values of all other properties (such as `Notes`) are non-normative.
### 1.2 RFC 2119 key words
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC 2119](https://tools.ietf.org/html/rfc2119).
## 2 Use of Terms
Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](https://dwc.tdwg.org/rdf/#143-use-of-darwin-core-terms-in-rdf-normative), term IRIs MUST be used as values of `dwciri:establishmentMeans`. Controlled value strings MUST be used as values of `dwc:establishmentMeans`.
## 3 Term index
[establishmentMeans controlled concept scheme](#dwcem_e) |
[introduced (alien, exotic, non-native, nonindigenous)](#dwcem_e003) |
[introduced: assisted colonisation](#dwcem_e004) |
[native (indigenous)](#dwcem_e001) |
[native: reintroduced](#dwcem_e002) |
[uncertain (unknown, cryptogenic)](#dwcem_e006) |
[vagrant (casual)](#dwcem_e005)
## 4 Vocabulary
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcem_e"></a>Term Name dwcem:e</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/e">http://rs.tdwg.org/dwcem/values/e</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>establishmentMeans controlled concept scheme</td>
</tr>
<tr>
<td>Definition</td>
<td>A SKOS Concept Scheme to be used as a controlled vocabulary for the Darwin Core terms dwc:establishmentMeans and dwciri:establishmentMeans</td>
</tr>
<tr>
<td>Type</td>
<td>http://www.w3.org/2004/02/skos/core#ConceptScheme</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_24">http://rs.tdwg.org/decisions/decision-2020-10-13_24</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcem_e001"></a>Term Name dwcem:e001</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/e001">http://rs.tdwg.org/dwcem/values/e001</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e001-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e001-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>native (indigenous)</td>
</tr>
<tr>
<td>Definition</td>
<td>A taxon occurring within its natural range</td>
</tr>
<tr>
<td>Notes</td>
<td>What is considered native to an area varies with the biogeographic history of an area and the local interpretation of what is a "natural range". </td>
</tr>
<tr>
<td>Controlled value</td>
<td>native</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_24">http://rs.tdwg.org/decisions/decision-2020-10-13_24</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcem_e002"></a>Term Name dwcem:e002</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/e002">http://rs.tdwg.org/dwcem/values/e002</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e002-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e002-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>native: reintroduced</td>
</tr>
<tr>
<td>Definition</td>
<td>A taxon re-established by direct introduction by humans into an area which was once part of its natural range, but from where it had become extinct.</td>
</tr>
<tr>
<td>Notes</td>
<td>Where a taxon has become extirpated from an area where it had naturally occurred it may be returned to that area deliberately with the intension of re-establishing it. </td>
</tr>
<tr>
<td>Controlled value</td>
<td>nativeReintroduced</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_24">http://rs.tdwg.org/decisions/decision-2020-10-13_24</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcem_e003"></a>Term Name dwcem:e003</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/e003">http://rs.tdwg.org/dwcem/values/e003</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e003-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e003-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>introduced (alien, exotic, non-native, nonindigenous)</td>
</tr>
<tr>
<td>Definition</td>
<td>Establishment of a taxon by human agency into an area that is not part of its natural range</td>
</tr>
<tr>
<td>Notes</td>
<td>Organisms can be introduced to novel areas and habitats by human activity, either on purpose or by accident. Humans can also inadvertently create corridors that breakdown natural barriers to dispersal and allow organisms to spread beyond their natural range.</td>
</tr>
<tr>
<td>Controlled value</td>
<td>introduced</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_24">http://rs.tdwg.org/decisions/decision-2020-10-13_24</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcem_e004"></a>Term Name dwcem:e004</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/e004">http://rs.tdwg.org/dwcem/values/e004</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e004-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e004-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>introduced: assisted colonisation</td>
</tr>
<tr>
<td>Definition</td>
<td>Establishment of a taxon specifically with the intention of creating a self-sustaining wild population in an area that is not part of the taxon's natural range</td>
</tr>
<tr>
<td>Notes</td>
<td>In the event of environmental change and habitat destruction a conservation option is to introduce a taxon into an area it did not naturally occur</td>
</tr>
<tr>
<td>Controlled value</td>
<td>introducedAssistedColonisation</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_24">http://rs.tdwg.org/decisions/decision-2020-10-13_24</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcem_e005"></a>Term Name dwcem:e005</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/e005">http://rs.tdwg.org/dwcem/values/e005</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e005-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e005-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>vagrant (casual)</td>
</tr>
<tr>
<td>Definition</td>
<td>The temporary occurrence of a taxon far outside its natural or migratory range.</td>
</tr>
<tr>
<td>Notes</td>
<td>Natural events and human activity can disperse organisms unpredictably into places where they may stay or survive for a period.</td>
</tr>
<tr>
<td>Controlled value</td>
<td>vagrant</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_24">http://rs.tdwg.org/decisions/decision-2020-10-13_24</a></td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th colspan="2"><a id="dwcem_e006"></a>Term Name dwcem:e006</th>
</tr>
</thead>
<tbody>
<tr>
<td>Term IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/e006">http://rs.tdwg.org/dwcem/values/e006</a></td>
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e006-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e006-2020-10-13</a></td>
</tr>
<tr>
<td>Label</td>
<td>uncertain (unknown, cryptogenic)</td>
</tr>
<tr>
<td>Definition</td>
<td>The origin of the occurrence of the taxon in an area is obscure</td>
</tr>
<tr>
<td>Notes</td>
<td>When there is a lack of fossil or historical evidence for the occurrence of a taxon in an area it can be impossible to know if the taxon is new to the area or native.</td>
</tr>
<tr>
<td>Controlled value</td>
<td>uncertain</td>
</tr>
<tr>
<td>Type</td>
<td>Concept</td>
</tr>
<tr>
<td>Executive Committee decision</td>
<td><a href="http://rs.tdwg.org/decisions/decision-2020-10-13_24">http://rs.tdwg.org/decisions/decision-2020-10-13_24</a></td>
</tr>
</tbody>
</table>

47
docs/em/index.md
View File

@ -10,7 +10,7 @@ Preferred namespace abbreviation
: dwcem:
Date version issued
: 2020-10-13
: 2021-09-01
Date created
: 2020-10-13
@ -19,11 +19,14 @@ Part of TDWG Standard
: <http://www.tdwg.org/standards/450>
This document version
: <http://rs.tdwg.org/dwc/doc/em/2020-10-13>
: <http://rs.tdwg.org/dwc/doc/em/2021-09-01>
Latest version of document
: <http://rs.tdwg.org/dwc/doc/em/>
Previous version
: <http://rs.tdwg.org/dwc/doc/em/2020-10-13>
Abstract
: The Darwin Core term `establishmentMeans` provides information about whether an organism or organisms have been introduced to a given place and time through the direct or indirect activity of modern humans. The Establishment Means Controlled Vocabulary provides terms that should be used as values for `dwc:establishmentMeans` and `dwciri:establishmentMeans`.
@ -34,7 +37,7 @@ Creator
: TDWG Darwin Core Maintenance Group
Bibliographic citation
: Darwin Core Maintenance Group. 2020. Establishment Means Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/em/2020-10-13>
: Darwin Core Maintenance Group. 2021. Establishment Means Controlled Vocabulary List of Terms. Biodiversity Information Standards (TDWG). <http://rs.tdwg.org/dwc/doc/em/2021-09-01>
## 1 Introduction
@ -115,11 +118,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](https://
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e001-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e001-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e001-2021-09-01">http://rs.tdwg.org/dwcem/values/version/e001-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -127,11 +130,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](https://
</tr>
<tr>
<td>Definition</td>
<td>A taxon occurring within its natural range</td>
<td>A taxon occurring within its natural range.</td>
</tr>
<tr>
<td>Notes</td>
<td>What is considered native to an area varies with the biogeographic history of an area and the local interpretation of what is a "natural range". </td>
<td>What is considered native to an area varies with the biogeographic history of an area and the local interpretation of what is a "natural range".</td>
</tr>
<tr>
<td>Controlled value</td>
@ -161,11 +164,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](https://
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e002-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e002-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e002-2021-09-01">http://rs.tdwg.org/dwcem/values/version/e002-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -173,11 +176,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](https://
</tr>
<tr>
<td>Definition</td>
<td>A taxon re-established by direct introduction by humans into an area which was once part of its natural range, but from where it had become extinct.</td>
<td>A taxon re-established by direct introduction by humans into an area that was once part of its natural range, but from where it had become extinct.</td>
</tr>
<tr>
<td>Notes</td>
<td>Where a taxon has become extirpated from an area where it had naturally occurred it may be returned to that area deliberately with the intension of re-establishing it. </td>
<td>Where a taxon has become extirpated from an area where it had naturally occurred it may be returned to that area deliberately with the intension of re-establishing it.</td>
</tr>
<tr>
<td>Controlled value</td>
@ -207,11 +210,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](https://
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e003-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e003-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e003-2021-09-01">http://rs.tdwg.org/dwcem/values/version/e003-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -219,11 +222,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](https://
</tr>
<tr>
<td>Definition</td>
<td>Establishment of a taxon by human agency into an area that is not part of its natural range</td>
<td>Establishment of a taxon by human agency into an area that is not part of its natural range.</td>
</tr>
<tr>
<td>Notes</td>
<td>Organisms can be introduced to novel areas and habitats by human activity, either on purpose or by accident. Humans can also inadvertently create corridors that breakdown natural barriers to dispersal and allow organisms to spread beyond their natural range.</td>
<td>Organisms can be introduced to novel areas and habitats by human activity, either on purpose or by accident. Humans can also inadvertently create corridors that break down natural barriers to dispersal and allow organisms to spread beyond their natural range.</td>
</tr>
<tr>
<td>Controlled value</td>
@ -253,11 +256,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](https://
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e004-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e004-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e004-2021-09-01">http://rs.tdwg.org/dwcem/values/version/e004-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -265,11 +268,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](https://
</tr>
<tr>
<td>Definition</td>
<td>Establishment of a taxon specifically with the intention of creating a self-sustaining wild population in an area that is not part of the taxon's natural range</td>
<td>Establishment of a taxon specifically with the intention of creating a self-sustaining wild population in an area that is not part of the taxon's natural range.</td>
</tr>
<tr>
<td>Notes</td>
<td>In the event of environmental change and habitat destruction a conservation option is to introduce a taxon into an area it did not naturally occur</td>
<td>In the event of environmental change and habitat destruction a conservation option is to introduce a taxon into an area it did not naturally occur.</td>
</tr>
<tr>
<td>Controlled value</td>
@ -345,11 +348,11 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](https://
</tr>
<tr>
<td>Modified</td>
<td>2020-10-13</td>
<td>2021-09-01</td>
</tr>
<tr>
<td>Term version IRI</td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e006-2020-10-13">http://rs.tdwg.org/dwcem/values/version/e006-2020-10-13</a></td>
<td><a href="http://rs.tdwg.org/dwcem/values/version/e006-2021-09-01">http://rs.tdwg.org/dwcem/values/version/e006-2021-09-01</a></td>
</tr>
<tr>
<td>Label</td>
@ -357,7 +360,7 @@ Due to the requirements of [Section 1.4.3 of the Darwin Core RDF Guide](https://
</tr>
<tr>
<td>Definition</td>
<td>The origin of the occurrence of the taxon in an area is obscure</td>
<td>The origin of the occurrence of the taxon in an area is obscure.</td>
</tr>
<tr>
<td>Notes</td>

2821
docs/pw/2020-10-13.md Normal file
View File

File diff suppressed because it is too large Load Diff

371
docs/pw/index.md
View File

File diff suppressed because it is too large Load Diff