new OTT notes

Author: mtholder

doc/ott3.7.3.md

@@ -0,0 +1,152 @@
+# Open Tree of Life reference taxonomy version 3.7
+
+Version 3.7 draft 3 was generated on 20 June, 2025.
+
+## Download
+
+[Download](https://files.opentreeoflife.org/ott/ott3.7.3/ott3.7.3.tgz)
+
+## Major changes since OTT 3.6
+
+* Restored genus *Erica* from a previous version of OTT (v 3.1) using manual text edits followed by correction of repurposed IDs
+* Many changes addressing issues reported by users in [our feedback](https://github.com/OpenTreeOfLife/feedback/issues?q=is%3Aissue+is%3Aopen+sort%3Acreated-asc) repository
+* additional taxa via taxonomic amendments
+
+## Statistics
+
+* OTT identifiers ('taxa'): 4,529,466
+* Visible: 3,677,886
+* Synonyms: 2,226,376
+       
+  
+## Contents of download
+
+All files use UTF-8 character encoding.  For documentation about file formats, see [the documentation in the reference taxonomy
+wiki](https://github.com/OpenTreeOfLife/reference-taxonomy/wiki/Interim-taxonomy-file-format),
+on github.
+
+**taxonomy.tsv**: The file that contains the taxonomy.
+
+**synonyms.tsv**: The list of synonyms.
+
+**forwards.tsv**: Aliases ('forwarding pointers') - a list of OTT ids that are
+  retired and should be replaced by new ones (usually due to
+  'lumping')
+
+**version.txt**: The version of OTT.
+
+
+## Build script
+
+    otc-taxonomy-patcher \
+      --demand-all-applied \
+      --edits "${OTROOT}/edOTTs/edott-000015.json" \
+      --edits "${OTROOT}/edOTTs/edott-000016.json" \
+      "${OTROOT}/ott/ott3.7.2" \
+      --write-taxonomy \
+      "${OTROOT}/ott/ott3.7.3" 2>&1 | tee patch3.7.3.log
+
+## Sources
+
+Any errors in OTT
+should be assumed to have been introduced by the Open Tree of Life 
+project until confirmed as originating in the source taxonomy.
+
+Download locations are for the particular versions used to construct
+OTT 3.0.  For new work, current versions of these sources should be
+retrieved.
+
+1.  Curated additions from the Open Tree amendments-1 repository as processed into https://github.com/OpenTreeOfLife/edOTTs 
+  up to commit [a39246273ba3bfeea4984e3f4905b15a08b83897](https://github.com/OpenTreeOfLife/edOTTs/commit/a39246273ba3bfeea4984e3f4905b15a08b83897) These taxa are added during OTU mapping using the curator application.
+
+1.  Taxonomy from: 
+    DS Hibbett, M Binder, JF Bischoff, M Blackwell, et al. 
+    A higher-level phylogenetic classification of the <i>Fungi</i>.
+    [Mycological Research</i> <b>111</b>(5):509-547, 2007](https://dx.doi.org/10.1016/j.mycres.2007.03.004).
+    Newick string with revisions
+    archived at [https://figshare.com/articles/Fungal\_Classification\_2015/1465038](https://figshare.com/articles/Fungal_Classification_2015/1465038).
+    <br />
+    Download location: [https://github.com/OpenTreeOfLife/reference-taxonomy/tree/ott2.10draft11/feed/h2007](https://github.com/OpenTreeOfLife/reference-taxonomy/tree/ott2.10draft11/feed/h2007)
+
+1.  Taxonomy from: SILVA 16S ribosomal RNA database, version 115.
+    See: Quast C, Pruesse E, Yilmaz P, Gerken J, Schweer T, Yarza P, Peplies J,
+    Gl&ouml;ckner FO (2013) The SILVA ribosomal RNA gene database project:
+    improved data processing and web-based tools. 
+    [Nucleic Acids Research</i> 41 (D1): D590-D596](https://dx.doi.org/10.1093/nar/gks1219).
+    Web site: [https://www.arb-silva.de/](https://www.arb-silva.de/).
+    <br />
+    Download location: [ftp://ftp.arb-silva.de/release\_115/Exports/tax\_ranks\_ssu\_115.csv](ftp://ftp.arb-silva.de/release_115/Exports/tax_ranks_ssu_115.csv).
+
+1.  Index Fungorum.
+    Download location: derived from database query result files provided by Paul
+    Kirk, 7 April 2014 (personal communication).
+    Web site: [https://www.indexfungorum.org/](https://www.indexfungorum.org/).
+    <br />
+    Download location (converted to OTT format): [https://files.opentreeoflife.org/fung/fung-9/fung-9-ot.tgz](https://files.opentreeoflife.org/fung/fung-9/fung-9-ot.tgz).
+
+1.  Taxonomy from:
+    Sch&auml;ferhoff, B., Fleischmann, A., Fischer, E., Albach, D. C., Borsch,
+    T., Heubl, G., and M&uuml;ller, K. F. (2010). Towards resolving Lamiales
+    relationships: insights from rapidly evolving chloroplast
+    sequences. 
+    [<i>BMC evolutionary biology</i> 10(1), 352.](https://dx.doi.org/10.1186/1471-2148-10-352).
+    Manually transcribed from the paper and converted to OTT format.
+    <br />
+    Download location: [https://purl.org/opentree/ott/ott2.8/inputs/lamiales-20140118.tsv](https://purl.org/opentree/ott/ott2.8/inputs/lamiales-20140118.tsv)
+
+1.  [World Register of Marine Species (WoRMS)](https://www.marinespecies.org/aphia.php) - harvested from web site using web API over several days ending around 1 October 2015.
+    Download location: [https://files.opentreeoflife.org/worms/worms-1/worms-1-ot.tgz](https://files.opentreeoflife.org/worms/worms-1/worms-1-ot.tgz)
+
+1.  NCBI Taxonomy, from the 
+    [US National Center on Biotechnology Information](https://www.ncbi.nlm.nih.gov/).
+    Web site: [https://www.ncbi.nlm.nih.gov/Taxonomy/](https://www.ncbi.nlm.nih.gov/Taxonomy/).
+    <br />
+    We used a version dated 16 September, 2019.
+    Archived location: [https://files.opentreeoflife.org/ncbi/ncbi-20190916/ncbi-20190916.tgz](https://files.opentreeoflife.org/ncbi/ncbi-20190916/ncbi-20190916.tgz).
+    <br />
+    Current version download location:
+    [ftp://ftp.ncbi.nlm.nih.gov/pub/taxonomy/taxdump.tar.gz](ftp://ftp.ncbi.nlm.nih.gov/pub/taxonomy/taxdump.tar.gz)
+
+1.  GBIF Backbone Taxonomy, from the 
+    [Global Biodiversity Information facility](https://www.gbif.org/).
+    <br />
+    We used a version dated 2019-09-16.
+    Download location: [https://files.opentreeoflife.org/gbif/gbif-20190916/gbif-20190916.zip](https://files.opentreeoflife.org/gbif/gbif-20190916/gbif-20190916.zip).
+    <br />
+    Current version download location (unverified):
+    [https://rs.gbif.org/datasets/backbone/backbone-current.zip](https://rs.gbif.org/datasets/backbone/backbone-current.zip).
+
+1.  [Interim Register of Marine and Nonmarine Genera (IRMNG)](https://irmng.org/).
+    <br />
+    We used a version dated 2014-01-31.  Download location:
+    [https://purl.org/opentree/ott/ott2.8/inputs/IRMNG\_DWC-2014-01-30.zip](https://purl.org/opentree/ott/ott2.8/inputs/IRMNG_DWC-2014-01-30.zip).
+ 
+1.  Taxon identifiers are carried over from [OTT 3.4](https://files.opentreeoflife.org/ott/ott3.4/) when possible
+ 
+It has been requested that we relay the following statement:
+
+> REUSE OF IRMNG CONTENT:
+> IRMNG (the Interim Register of Marine and Nonmarine Genera) is assembled, with permission, from a range of third party data sources, certain of which permit data reuse only under specific conditions. In particular, for data originating from the Catalogue of Life (CoL), please refer to the relevant terms and conditions for reuse of CoL data as available at [https://www.catalogueoflife.org/content/terms-use](https://www.catalogueoflife.org/content/terms-use), and for data originating from the World Register of Marine Species (WoRMS) refer the paragraph "Terms of Use and Citation" at [https://www.marinespecies.org/about.php](https://www.marinespecies.org/about.php). The compilers of IRMNG accept no liability for any reuse of IRMNG content by downstream users which may be construed by the original data providers to violate their publicly available conditions of use.
+
+The Open Tree Taxonomy does not reproduce its sources in their
+entirety or in their original form of expression, but only uses
+limited information expressed in them. See "[Scientific names of
+organisms: attribution, rights, and licensing](https://dx.doi.org/10.1186/1756-0500-7-79)" ([https://dx.doi.org/10.1186/1756-0500-7-79](https://dx.doi.org/10.1186/1756-0500-7-79))
+regarding use of taxonomic information and attribution.
+
+## Priority
+
+Where taxonomies conflict regarding taxon relationships, they are
+resolved in favor of the higher priority taxonomy.  The priority
+ordering is as given above, with the following exceptions:
+
+The non-Fungi content of Index Fungorum is separated from the Fungi
+content and given a priority lower than NCBI and GBIF.
+
+The non-Malacostraca, non-Ctenophora content of WoRMS is separated from the
+Malacostraca and Ctenophora content and given a priority lower than NCBI but higher
+than GBIF.
+
+## Previous versions
+
+See <a href="https://files.opentreeoflife.org/ott/">https://files.opentreeoflife.org/ott/</a>