https://doi.org/10.5531/sd.sp.55     README-sd.sp.55.TXT

This repository contains digital supplementary data files for the
publication:

HERHOLD, HOLLISTER W., STEVEN R. DAVIS, SAMUEL P. DEGREY, AND DAVID
A. GRIMALDI, "Comparative Anatomy of the Insect Tracheal System, Part
1.  Introduction, Apterygotes, Paleoptera, Polyneoptera", Bulletin of
the American Museum of Natural History, 2023.

The authors may be contacted at hherhold@amnh.org. Problems with data
access can be addressed by the Library (libref@amnh.org).

OBTAINING THE DATA
------------------

This material is available via Globus at:

https://app.globus.org/file-manager?origin_id=c585304a-b9f0-11ed-98a0-cf2723108f0c&origin_path=%2F

Globus Connect Personal client can be obtained at:

https://www.globus.org/globus-connect-personal

CONTENTS OF THE REPOSITORY
--------------------------

The Plates directory contains high resolution PDF format files for all
unbound plates included with the publication. Low resolution plates are 
also available with the electronic versions on the AMNH Digital Library
Website.

Supplemental Table 1 includes trachea labels from past studies and
their conversions to the unified tracheal nomenclature.

The zip files contain labeled 3D models of tracheae for every specimen
in the publication, each specimen with its own zip file, named by Order
followed by family or genus/species.

The file formats within each zip file are as follows:
 - MRML file: This is a 3D Slicer compatible project file. Loading
   this file in Slicer will load in all model files and the markup
   file containing tracheal labels.
 - PLY files: These are standard PLY (or Stanford Triangle Format)
   files which may be opened in any 3D application (including
   Slicer). All PLY files in a given folder are in the same coordinate
   system, and PLY files have computed surface normals included for
   smooth shading.
 - JSON file: This is a standard JSON format file containing the
   trachea labels. This file is formatted to be read into Slicer but
   may also be read using standard utilities such as Python JSON
   libraries.

Each zip file contains:
 - A single MRML file
 - A single JSON file
 - Multiple PLY files:
   - A body model, containing everything *but* tracheae and air spaces
   - A trachea model, contaning labeled tracheae
   - Additional PLY files for other air spaces, such as air-filled gut

Readers are directed to http://www.slicer.org for 3D Slicer and
associated Slicer documentation and tutorials.

NB: as of the publication date (2023), many of these files (such
as the models for the aeshnid dragonfly) have very high polygon counts,
in excess of 50 million for a single model. Readers are advised to use
sufficiently capable hardware for viewing these models.

-Hollister Herhold, hherhold@amnh.org
25 Jan 2023