<?php

#############################################################################

# Builds the xml body to be sent to Tapir service.  Only put in a 

# seperate file because there is a lot of code-invarient text that would

# just make other parts of the script difficult to read.

#############################################################################

require_once('configurableParams.php');

function buildStructure($supportedConcepts) {

  $structureStr = '';

  foreach(array_keys($supportedConcepts) as $key){

    $structureStr .= 

      "              <xs:element name=\"$key\" type=\"xs:string\" minOccurs=\"0\"/>\n";

  }

  return $structureStr;

}

function buildMap($supportedConcepts) {

  $mapStr = '';

  foreach(array_keys($supportedConcepts) as $key){

    $mapStr .=

      "        <node path=\"/records/record/$key\">\n".

      "          <concept id=\"$supportedConcepts[$key]\"/>\n".

      "        </node>\n";

  }

  return $mapStr;

}

function buildRequest($start,$limit,$supportedConcepts) {

  $xmlRequest = "<?xml version=\"1.0\" encoding=\"UTF-8\" ?>\n".

  "<request \n".

  "    xmlns=\"http://rs.tdwg.org/tapir/1.0\"\n".

  "    xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n".

  "    xsi:schemaLocation=\"http://rs.tdwg.org/tapir/1.0 \n".

  "                        http://rs.tdwg.org/tapir/1.0/schema/tapir.xsd\">\n".

  "  <header>\n".

  "  </header>\n".

  "  <search count=\"true\" start=\"$start\" limit=\"$limit\" envelope=\"true\">\n".

  "    <outputModel>\n".

  "      <structure>\n".

  "        <xs:schema targetNamespace=\"http://example.net/simple_specimen\" xmlns:xs=\"http://www.w3.org/2001/XMLSchema\" xsi:schemaLocation=\"http://www.w3.org/2001/XMLSchema http://www.w3.org/2001/XMLSchema.xsd\">\n".

  "          <xs:element name=\"records\">\n".

  "            <xs:complexType>\n".

  "              <xs:sequence>\n".

  "                <xs:element name=\"record\" minOccurs=\"0\" maxOccurs=\"unbounded\" type=\"unitType\">\n".

  "                </xs:element>\n".

  "              </xs:sequence>\n".

  "            </xs:complexType>\n".

  "          </xs:element>\n".

  "          <xs:complexType name=\"unitType\">\n".

  "            <xs:sequence>\n".

               buildStructure($supportedConcepts).

  "            </xs:sequence>\n".

  "          </xs:complexType>\n".

  "        </xs:schema>\n".

  "      </structure>\n".

  "      <indexingElement path=\"/records/record\"/>\n".

  "      <mapping>\n".

         buildMap($supportedConcepts).

  "      </mapping>\n".

  "    </outputModel>\n".

  "    <filter>\n".

         buildFilter().

  "    </filter>\n".

  "  </search>\n".

  "</request>\n";

  return $xmlRequest;

}

function buildCapabilitiesRequest() {

  $xmlRequest = "<?xml version=\"1.0\" encoding=\"UTF-8\" ?>\n".

  "<request \n".

  "    xmlns=\"http://rs.tdwg.org/tapir/1.0\"\n".

  "    xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n".

  "    xsi:schemaLocation=\"http://rs.tdwg.org/tapir/1.0 \n".

  "                        http://rs.tdwg.org/tapir/1.0/schema/tapir.xsd\">\n".

  "  <header>\n".

  "  </header>\n".

  "  <capabilities />\n".

  "</request>\n";

  return $xmlRequest;

}

?>

<?php

#############################################################################

# File containing all the paramaters that could potentially need to be

# configured for the job.

#

#  $url:  The url for the desired Taiper service

#  $seperator:  The delimiter for the flat file.

#  buildFilter():  Function to specify the search paramaters.

#  desiredConcepts:  Desired data to be returned by the service.

#

#############################################################################

# The url of the desired Taiper service

$url = 'http://tapir.cria.org.br/tapirlink/tapir.php/specieslink';

# The seperator to be used in the flat file to seperate the 

# data fields of each record.

$seperator = '`';

# Tapir services have an extremely flexable syntax to search for

# records with the desired properties.  However, this flexibility

# makes it rather difficult to generalize the search possibilities

# and quickly come up with appropriate xml.  As such, the current

# solution is to build the filter node here.  See the associated

# documentation on how to build the filter:

#   http://www.tdwg.org/dav/subgroups/tapir/1.0/docs/tdwg_tapir_specification_2010-05-05.htm#toc47

function buildFilter() {

  $filter = 

        '<equals>' .

          '<concept id="http://rs.tdwg.org/dwc/dwcore/Kingdom"/>' .

          '<literal value="Plantae"/>' .

        '</equals>';

  return $filter;

}

?>

<?php

#############################################################################

# This file holds the utility function getAllConcepts which calls the 

# tapir service to find out all the concepts (data units) that are 

# supported.  This list is necessary so that we know what to ask for

# when making the rquest.

#############################################################################

require_once('HTTP/Request.php'); // pear package

require_once('tapirRequestTemplate.php'); 

function getAllConcepts() {

    global $url;

    $error_log_filename = "error.log";

    $http_request = new HTTP_Request();

    $body = buildCapabilitiesRequest();

    $http_request->setMethod( 'POST' );

    $http_request->addHeader('Content-Type', 'text/xml');

    $http_request->addRawPostData( $body );

    $http_request->setURL( $url );

    $http_request->_timeout = 300;

    $http_request->_readTimeout = 300;

    // This can be used to see the entire request

    #$raw_request = $http_request->_buildRequest();

    #echo "\n\n" . $raw_request;

    $http_request->sendRequest();

    $response = $http_request->getResponseBody();

    $code = $http_request->getResponseCode();

    if ( $code != 200 ) // 200 = OK

    {

        $label = 'Unknown Error';

        switch ( $code )

        {

            case 201: $label = 'Created'; break;

            case 202: $label = 'Accepted'; break;

            case 203: $label = 'Non-Authoritative Information'; break;

            case 204: $label = 'No Content'; break;

            case 205: $label = 'Reset Content'; break;

            case 206: $label = 'Partial Content'; break;

            case 300: $label = 'Multiple Choices'; break;

            case 301: $label = 'Moved Permanently'; break;

            case 302: $label = 'Found'; break;

            case 303: $label = 'See Other'; break;

            case 304: $label = 'Not Modified'; break;

            case 305: $label = 'Use Proxy'; break;

            case 307: $label = 'Temporary Redirect'; break;

            case 400: $label = 'Bad Request'; break;

            case 401: $label = 'Unauthorized'; break;

            case 402: $label = 'Payment Required'; break;

            case 403: $label = 'Forbidden'; break;

            case 404: $label = 'Not Found'; break;

            case 405: $label = 'Method Not Allowed'; break;

            case 406: $label = 'Not Acceptable'; break;

            case 407: $label = 'Proxy Authentication Required'; break;

            case 408: $label = 'Request Timeout'; break;

            case 409: $label = 'Conflict'; break;

            case 410: $label = 'Gone'; break;

            case 411: $label = 'Length Required'; break;

            case 412: $label = 'Precondition Failed'; break;

            case 413: $label = 'Request Entity Too Large'; break;

            case 414: $label = 'Request-URI Too Long'; break;

            case 415: $label = 'Unsupported Media Type'; break;

            case 416: $label = 'Requested Range Not Satisfiable'; break;

            case 417: $label = 'Expectation Failed'; break;

            case 500: $label = 'Internal Server Error'; break;

            case 501: $label = 'Not Implemented'; break;

            case 502: $label = 'Bad Gateway'; break;

            case 503: $label = 'Service Unavailable'; break;

            case 504: $label = 'Gateway Timeout'; break;

            case 505: $label = 'HTTP Version Not Supported'; break;

	}

       $error_log = fopen($error_log_filename,"a");

       fwrite($error_log, "Service responded with HTTP ".$code." code: ".$label."\n".

              "while attempting to request supported concepts\n");

       fclose($error_log);

       echo( "Service responded with HTTP ".$code." code: ".$label."\n".

              "while attempting to request supported concepts\n");

       return 0;

    }

    #Weird encoding bug - need to remove the ^F and ^L characters so

    #that the xml parser won't choke.

    $xmlDoc = new DOMDocument();

    $response = preg_replace("//","6",$response);

    $response = preg_replace("//","12",$response);

    $xmlDoc->loadXML($response);

    $errors = $xmlDoc->getElementsByTagName("error");

    if($errors->length > 0) {

       $error_log = fopen($error_log_filename,"a");

       foreach($errors as $error) {

         fwrite($error_log, $error->nodeValue . "\n");

       }

       fclose($error_log);

       return 0;

    }

    $concepts = $xmlDoc->getElementsByTagName("mappedConcept");

    $concepts_array = array();

    if($concepts->length == 0) {

       $error_log = fopen($error_log_filename,"a");

       fwrite($error_log, "No mappedConcept node, assuming there's a missed error.\n");

       fclose($error_log);

       return 0;

    } else {

      foreach($concepts as $concept) {

        $concept_id = $concept->getAttribute("id");

        $concept_key = preg_replace("/\//","_",$concept_id);

        $concept_key = preg_replace("/\./","_",$concept_key);

        $concept_key = preg_replace("/:/","",$concept_key);

        $concepts_array[$concept_key] = $concept_id;

      }

    }

    return $concepts_array;

}

?>

tapir2flat.php:  a simple script to 

consume taiper web services and save the results in a delimited file,

one record per line.  The current delimiter is backtick '`' but

that can be changed by changing the $seperator variable located

in configurableParams.php.

Command line useage:

  php taiper2flat.php

dependencies:

  php 5+

  pear

  HTTP_Request

I had to install pear and HTTP_Request before it would work (on Ubuntu):

  sudo apt-get install php-http-request

This should install all dependencies, but just in case, the full dependency list is:

  php-net-socket 

  php-net-url

  php-pear

  php-http-request

Necessary files:

  tapir2flat.php: Driver file

  configurableParams.php: File containing paramaters that can be configured

  tapirRequestTemplate.php: Holds the template required to send a tapir request.

  getAllConcepts.php: holds utility function to get all possible return values from tapir service.

Possible output files:

  specieslink.txt:  Where the retrieved records will be stored.  Each line represents one record, delimited by whatever is configured as the delimitation paramater.

  recordnum.dat:  Holds the starting record number for the most recently sent request.

  error.log:  Where any errors will be recorded.

Possible configurations: see configurableParams.php as well.

  The url of desired tapir service

  Delimiter to be used to sperate data fields within each record

  The filter sent to tapir service that specifies search parameters, in xml format.  See http://www.tdwg.org/dav/subgroups/tapir/1.0/docs/tdwg_tapir_specification_2010-05-05.htm#toc47 for documentation on how to do this.

<?php

#############################################################################

# Driver file for taiper2flatClient, a simple script to 

# consume taiper web services and save the results in a delimited file,

# one record per line.  The current delimiter is backtick '`' but

# that can be changed by changing the $seperator variable located

# in configurableParams.php.

#

# Command line useage:

#   php taiper2flat.php

#

# dependencies:

# php 5+

# pear

# HTTP_Request

# I had to install pear and HTTP_Request before it would work (on Ubuntu):

#   sudo apt-get install php-http-request

# This should install all dependencies, but just in case, the full

# dependency list is:

#   php-net-socket 

#   php-net-url

#   php-pear

#   php-http-request

#############################################################################

require_once('HTTP/Request.php'); // pear package

require_once('tapirRequestTemplate.php'); 

require_once('getAllConcepts.php'); 

global $url;

global $seperator;

$flat_filename = "specieslink.txt";

$record_num_filename = "recordnum.dat";

$error_log_filename = "error.log";

$supportedConcepts = getAllConcepts();

if(!is_array($supportedConcepts)){

  $error_log = fopen($error_log_filename,"a");

  fwrite($error_log, "Unable to retrieve supported concepts from service, failing.\n");

  fclose($error_log);

  exit;

}

$successive_failures = 0;

$start_record = 0;	// Record to begin first request (ordinal position, not ID)

if(file_exists($record_num_filename)) {

  $start_record = file_get_contents($record_num_filename);

}

$request_limit = 1000;		// Number of records per request; cannot exceed 1000

//According to TAPIR docs, the estimate from the service 

//is an upper bound on the number of records.  Start out high.

$estimated_max_from_service = 4000000;  

if(!file_exists($flat_filename)) {

  $flat_file = fopen($flat_filename,"a");

  $file_header = '';

  foreach(array_keys($supportedConcepts) as $key){

    $file_header .= $key . $seperator;

  }

  $file_header = substr_replace($file_header ,"",-1);

  $file_header .= "\n";

  fwrite($flat_file,$file_header);

  fclose($flat_file);

}

$finished = false;

$itrNum = 0;

$http_request = new HTTP_Request();

while(!$finished && $start_record < $estimated_max_from_service) {

    $itrNum++;

    $body = buildRequest($start_record,$request_limit,$supportedConcepts);

    $http_request->setMethod( 'POST' );

    $http_request->addHeader('Content-Type', 'text/xml');

    $http_request->addRawPostData( $body );

    $http_request->setURL( $url );

    $http_request->_timeout = 300;

    $http_request->_readTimeout = 300;

    // This can be used to see the entire request

    #$raw_request = $http_request->_buildRequest();

    #echo "\n\n" . $raw_request;

    $http_request->sendRequest();

    $response = $http_request->getResponseBody();

    $code = $http_request->getResponseCode();

    if ( $code != 200 ) // 200 = OK

    {

        $label = 'Unknown Error';

        switch ( $code )

        {

            case 201: $label = 'Created'; break;

            case 202: $label = 'Accepted'; break;

            case 203: $label = 'Non-Authoritative Information'; break;

            case 204: $label = 'No Content'; break;

            case 205: $label = 'Reset Content'; break;

            case 206: $label = 'Partial Content'; break;

            case 300: $label = 'Multiple Choices'; break;

            case 301: $label = 'Moved Permanently'; break;

            case 302: $label = 'Found'; break;

            case 303: $label = 'See Other'; break;

            case 304: $label = 'Not Modified'; break;

            case 305: $label = 'Use Proxy'; break;

            case 307: $label = 'Temporary Redirect'; break;

            case 400: $label = 'Bad Request'; break;

            case 401: $label = 'Unauthorized'; break;

            case 402: $label = 'Payment Required'; break;

            case 403: $label = 'Forbidden'; break;

            case 404: $label = 'Not Found'; break;

            case 405: $label = 'Method Not Allowed'; break;

            case 406: $label = 'Not Acceptable'; break;

            case 407: $label = 'Proxy Authentication Required'; break;

            case 408: $label = 'Request Timeout'; break;

            case 409: $label = 'Conflict'; break;

            case 410: $label = 'Gone'; break;

            case 411: $label = 'Length Required'; break;

            case 412: $label = 'Precondition Failed'; break;

            case 413: $label = 'Request Entity Too Large'; break;

            case 414: $label = 'Request-URI Too Long'; break;

            case 415: $label = 'Unsupported Media Type'; break;

            case 416: $label = 'Requested Range Not Satisfiable'; break;

            case 417: $label = 'Expectation Failed'; break;

            case 500: $label = 'Internal Server Error'; break;

            case 501: $label = 'Not Implemented'; break;

            case 502: $label = 'Bad Gateway'; break;

            case 503: $label = 'Service Unavailable'; break;

            case 504: $label = 'Gateway Timeout'; break;

            case 505: $label = 'HTTP Version Not Supported'; break;

	}

       $error_log = fopen($error_log_filename,"a");

       fwrite($error_log, "Service responded with HTTP ".$code." code: ".$label."\n");

       $successive_failures += 1;

       if($successive_failures >= 3) {

         fwrite($error_log, "3 successive failures, quitting\n");

         fclose($error_log);

         exit;

       }

       fclose($error_log);

       //Should repeat the same request

       continue;

    }

    #Weird encoding bug - need to remove the ^F and ^L characters so

    #that the xml parser won't choke.

    $xmlDoc = new DOMDocument();

    $response = preg_replace("//","6",$response);

    $response = preg_replace("//","12",$response);

    $xmlDoc->loadXML($response);

    $errors = $xmlDoc->getElementsByTagName("error");

    if($errors->length > 0) {

       $error_log = fopen($error_log_filename,"a");

       foreach($errors as $error) {

         fwrite($error_log, $error->nodeValue . "\n");

       }

       $successive_failures += 1;

       if($successive_failures >= 3) {

         fwrite($error_log, "3 successive failures, quitting\n");

         fclose($error_log);

         exit;

       }

       fclose($error_log);

       //Should repeat the same request

       continue;

    }

    $summary = $xmlDoc->getElementsByTagName("summary");

    if($summary->length == 0) {

       $error_log = fopen($error_log_filename,"a");

       fwrite($error_log, "No summary node, assuming there's a missed error.\n");

       $successive_failures += 1;

       if($successive_failures >= 3) {

         fwrite($error_log, "3 successive failures, quitting\n");

         fclose($error_log);

         exit;

       }

       fclose($error_log);

       continue;

    } else {

      $start_record_temp = $summary->item(0)->getAttribute("next");

      $estimated_max_from_service = $summary->item(0)->getAttribute("totalMatched");

    }

    $records = $xmlDoc->getElementsByTagName("record");

    $recordsStr = '';

    foreach($records as $record) {

      foreach(array_keys($supportedConcepts) as $key){

        $element = $record->getElementsByTagName($key);

        if($element->length > 0) {

          $val = $element->item(0)->nodeValue;

          $val = preg_replace("/$seperator/"," ",$val);

          $val = preg_replace("/,/"," ",$val);

          $val = preg_replace("/\"/"," ",$val);

          $recordsStr .= $val;

        }

        $recordsStr .= $seperator;

      }

      $recordsStr = substr_replace($recordsStr ,"",-1);

      $recordsStr .= "\n";

    }

    $flat_file = fopen($flat_filename,"a");

    fwrite($flat_file,$recordsStr);

    fclose($flat_file);

    $successive_failures = 0;

    $record_file = fopen($record_num_filename,"w");

    fwrite($record_file,$start_record_temp);

    fclose($record_file);

    $start_record = $start_record_temp;    

    //If number of records is less than request_limit, it means

    //the service is out of records.

    $finished = ($request_limit > $records->length);

    if($itrNum == 1) {

      print "Extimated number of records:  $estimated_max_from_service\n";

    } elseif($itrNum % 10 == 0) {

      print "Pulled $start_record records out of $estimated_max_from_service ".

            "estimated total records.\n";

    }

}

?>

<?php

$ignoreTypes = array(

                     "doc:description"         => true,

                     "doc:example"             => true,

                     "doc:moduleDescription"   => true,

                     "doc:moduleDocs"          => true,

                     "doc:moduleName"          => true,

                     "doc:recommendedUsage"    => true,

                     "doc:standAlone"          => true,

                     "doc:summary"             => true,

                     "doc:tooltip"             => true,

                     "xsd:annotation"          => true,

                     "xsd:appinfo"             => true,

                     "xsd:documentation"       => true,

                     "xsd:import"              => true,

                     "xsd:include"             => true,

                     "xsd:schema"              => true,

                     "AdditionalAbbreviations" => true,

                     "BacteriaStatus"          => true,

                     "BioCodeStatus"           => true,

                     "BotanyStatus"            => true,

                     "li"                      => true,

                     "p"                       => true,

                     "para"                    => true,

                     "PreferredAbbreviation"   => true,

                     "section"                 => true,

                     "Specification"           => true,

                     "SuffixAlgae"             => true,

                     "SuffixAnimalia"          => true,

                     "SuffixBacteriae"         => true,

                     "SuffixFungi"             => true,

                     "SuffixFungi"             => true,

                     "SuffixPlantae"           => true,

                     "title"                   => true,

                     "ul"                      => true,

                     "ZoologyStatus"           => true);

function isIgnoreType($nodeName) {

  global $ignoreTypes;

  return $ignoreTypes[$nodeName];

}

$files = array(

               'eml-access.xsd',

               'eml-coverage.xsd',

               'eml-documentation.xsd',

               'eml-literature.xsd',

               'eml-party.xsd',

               'eml-project.xsd',

               'eml-resource.xsd',

               'eml-text.xsd',

               'tcsv101.xsd',

               'tdwg_basetypes.xsd',

               'tdwg_dw_element.xsd',

               'tdwg_dw_geospatial.xsd',

               'veg-misc.xsd',

               'veg-organismobservation.xsd',

               'veg-plotobservation.xsd',

               'veg.xsd',

               'veg-plot.xsd');

function hasImportantNodes($node) {

  $nodes = $node->getElementsbyTagName("*");

  foreach($nodes as $node) {

    $nodeName = preg_replace("/xs:/","xsd:",$node->nodeName);

    if(!isIgnoreType($nodeName)) {

      return true;

    }

  }

  return false;

}

$primitiveTypes = array(

  'DEFCATEGORIE' => 'enumerated string',

  'decimalLatitudeDataType' => 'xs:double [-90,90]',

  'decimalLongitudeDataType' => 'xs:double [-180,180]',

  'spatialFitDataType' => 'xs:double (0 or >1 or undefined)',

  'PERCENT' => 'xsd:decimal [0,100]',

  'RoleType' => 'xs:string (union of enumerated string & unenumerated string)',

  'TaxonomicRankEnum' => 'xs:Name (union of several enumerated string types for one big list of enum values)',

  'TINYINT' => 'xsd:decimal [-128,128]',

  'yearDate' => 'xs:gYear xs:date (union of)',

  'anyType' => 'xsd:anyType',

  'InlineType' => 'xs:anyType',

  'date' => 'xsd:date',

  'anyURI' => 'xs:anyURI',

  'decimal' => 'xsd:decimal',

  'gYear' => 'xsd:gYear',

  'string' => 'xs:string',

  'positiveInteger' => 'xs:positiveInteger',

  'time' => 'xs:time',

  'double' => 'xs:double',

  'integer' => 'xs:integer',

  'Name' => 'xs:Name',

  'NMTOKEN' => 'xs:NMTOKEN',

  'DateTimeISO' => 'xs:string',

  'dayOfYearDataType' => 'xs:integer',

  'DescriptorType' => 'xs:string',

  'FunctionType' => 'xs:string',

  'GRingType' => 'xs:anyType',

  'IDType' => 'xs:string',

  'KeyTypeCode' => 'xs:string',

  'MEDIUMINT' => 'xs:decimal',

  'NomenclaturalCodesEnum' => 'xsd:Name',

  'NomenclaturalTypeStatusOfUnitsEnum' => 'xsd:Name',

  'positiveDouble' => 'xs:double',

  'probabilityType' => 'xs:double',

  'ScopeType' => 'xs:string',

  'SMALLINT' => 'xs:decimal',

  'STRATUMINDEX' => 'xs:string',

  'SystemType' => 'xs:string',

  'TaxonomicRankAboveSuperfamilyEnum' => 'xsd:Name',

  'TaxonomicRankBelowSubspeciesEnum' => 'xsd:Name',

  'TaxonomicRankCultivatedPlants' => 'xsd:Name',

  'TaxonomicRankFamilyGroupEnum' => 'xsd:Name',

  'TaxonomicRankFamilySubdivisionEnum' => 'xsd:Name',

  'TaxonomicRankGenusGroupEnum' => 'xsd:Name',

  'TaxonomicRankGenusSubdivisionEnum' => 'xsd:Name',

  'TaxonomicRankSpeciesGroupEnum' => 'xsd:Name',

);     

$primitiveGroupings = array();

$primitiveGroupingsVariableLength = array();

#Find all primitive groupings and primitive groupings of variable length.

foreach($files as $file) {

  global $primitiveTypes;

  global $primitiveGroupings;

  global $primitiveGroupingsVariableLength;

  $xmlDoc = new DOMDocument();

  $xmlDoc->load($file);

  $nodes = $xmlDoc->getElementsByTagName("*");

  foreach($nodes as $node) {

    $variable = false;

    $isPrimitiveGroup = true;

    $nodeName = preg_replace("/xs:/","xsd:",$node->nodeName);

    if(!isIgnoreType($nodeName)) {

      if($nodeName == 'xsd:complexType' || $nodeName == 'xsd:simpleType') {

        $actualName = $node->getAttribute('name');

        $actualName = preg_replace("/.*:/","",$actualName);

        #Empty string is not a type

        if($actualName == '') {

          $isPrimitiveGroup = false; 

        }

        #Don't need to evaluate if we know it to be primitive

        if(array_key_exists($actualName,$primitiveTypes)) { 

          $isPrimitiveGroup = false; 

        }

        #maxOccurs can show up in several child node types, so just look for it in all of them

        $elements = $node->getElementsByTagName("*");

        foreach($elements as $element) {

          $maxOccurs = $element->getAttribute('maxOccurs');

          if($maxOccurs == 'unbounded' || $maxOccurs > 1) { $variable = true; }

        }

        $elements = $node->getElementsByTagName("element");

        foreach($elements as $element) {

          $elementType = $element->getAttribute('type');

          $elementType = preg_replace("/.*:/","",$elementType);

          if($elementType != '' && $elementType != $actualName &&

             !array_key_exists($elementType,$primitiveTypes)) {

            $isPrimitiveGroup = false;

            break;

          }

        }

        if($isPrimitiveGroup) {

          if($variable) {

            $primitiveGroupingsVariableLength[$actualName] = 1;

          } else {

            $primitiveGroupings[$actualName] = 1;

          }

        }

      }

    }

  }

}

print "primitive groupings:\n";

foreach(array_keys($primitiveGroupings) as $key) {

  print $key . "\n";

}

print "\n\n";

print "primitive groupings variable length:\n";

foreach(array_keys($primitiveGroupingsVariableLength) as $key) {

  print $key . "\n";

}

function alreadyFound($name,$tiers) {

  foreach($tiers as $tierArray) {

    if(array_key_exists($name,$tierArray)) {

      return true;

    }

  }

  return false;

}

function findTierEntities($previousTiers) {

  global $files;

  $returnArray = array();

  foreach($files as $file) {

    $xmlDoc = new DOMDocument();

    $xmlDoc->load($file);

    $nodes = $xmlDoc->getElementsByTagName("*");

    foreach($nodes as $node) {

      $isInTier = true;

      $nodeName = preg_replace("/xs:/","xsd:",$node->nodeName);

      if(!isIgnoreType($nodeName)) {

        if($nodeName == 'xsd:complexType' || $nodeName == 'xsd:simpleType') {

          $actualName = $node->getAttribute('name');

          $actualName = preg_replace("/.*:/","",$actualName);

          #Empty string is not a type

          if($actualName == '') {

            $isInTier = false; 

          }

          #Don't need to evaluate if we know it to be in lower tiers

          if(alreadyFound($actualName,$previousTiers)) { 

            $isInTier = false; 

          }

          $elements = $node->getElementsByTagName("element");

          foreach($elements as $element) {

            $elementType = $element->getAttribute('type');

            $elementType = preg_replace("/.*:/","",$elementType);

            if($elementType != '' && $elementType != $actualName &&

               !alreadyFound($elementType,$previousTiers)) {

              $isInTier = false;

              break;

            }

          }

          if($isInTier) {

            $returnArray[$actualName] = 1;

          }

        }

      }

    }

  }

  return $returnArray;

}

$prevTiers = array($primitiveTypes,$primitiveGroupings,$primitiveGroupingsVariableLength);

print "\n\n";

$tier1 = findTierEntities($prevTiers);

print "tier 1 entities:\n";

foreach(array_keys($tier1) as $key) {

  print $key . "\n";

}

$prevTiers = array($primitiveTypes,$primitiveGroupings,$primitiveGroupingsVariableLength,$tier1);

print "\n\n";

$tier2 = findTierEntities($prevTiers);

print "tier 2 entities:\n";

foreach(array_keys($tier2) as $key) {

  print $key . "\n";

}

$prevTiers = array($primitiveTypes,$primitiveGroupings,$primitiveGroupingsVariableLength,$tier1,$tier2);

print "\n\n";

$tier3 = findTierEntities($prevTiers);

print "tier 3 entities:\n";

foreach(array_keys($tier3) as $key) {

  print $key . "\n";

}

$prevTiers = array($primitiveTypes,$primitiveGroupings,$primitiveGroupingsVariableLength,$tier1,$tier2,$tier3);

print "\n\n";

$tier4 = findTierEntities($prevTiers);

print "tier 4 entities:\n";

foreach(array_keys($tier4) as $key) {

  print $key . "\n";

}

$prevTiers = array($primitiveTypes,$primitiveGroupings,$primitiveGroupingsVariableLength,$tier1,$tier2,$tier3,$tier4);

print "\n\n";

$tier5 = findTierEntities($prevTiers);

print "tier 5 entities:\n";

foreach(array_keys($tier5) as $key) {

  print $key . "\n";

}

#5 is as deep as we get

$tot = array_merge($primitiveTypes,$primitiveGroupings,$primitiveGroupingsVariableLength,$tier1,$tier2,$tier3,$tier4);

print count($tot) . "\n";

?>

<?php

require_once('objects/types.php');

function isIgnoreType($nodeName) {

  global $ignoreTypes;

  return $ignoreTypes[$nodeName];

}

function isPrimitiveType($nodeName) {

  global $primitiveTypes;

  return $primitiveTypes[$nodeName];

}

function isKnownAttribute($attrName) {

  global $knownAttributes;

  return $knownAttributes[$attrName];

}

function needsIndex($colName) {

  global $indexableCols;

  return $indexableCols[$colName];

}

function isNativePointer($colName) {

  global $nativeVegXPointers;

  return $nativeVegXPointers[$colName];

}

function hasImportantNodes($node) {

  $nodes = $node->getElementsbyTagName("*");

  foreach($nodes as $node) {

    $nodeName = preg_replace("/.*:/","",$node->nodeName);

    if(!isIgnoreType($nodeName)) {

      return true;

    }

  }

  return false;

}

function stringXMLNode($node) {

  return $node->ownerDocument->saveXML($node);

}

function findFirstAncestorName($node) {

  $xpath = new DOMXPath($node->ownerDocument);

  $parentNodes = $xpath->query("parent::*",$node);

  $parentNode = $parentNodes->item(0);

  $name = $parentNode->getAttribute('name');

  if($name != '') {

    return $name;

  } else {

    return findFirstAncestorName($parentNode);

  }

}

?>

<?php

$ignoreTypes = array(

  "description"         => true,

  "example"             => true,

  "moduleDescription"   => true,

  "moduleDocs"          => true,

  "moduleName"          => true,

  "recommendedUsage"    => true,

  "standAlone"          => true,

  "summary"             => true,

  "tooltip"             => true,

  "annotation"          => true,

  "appinfo"             => true,

  "documentation"       => true,

  "import"              => true,

  "include"             => true,

  "schema"              => true,

  "AdditionalAbbreviations" => true,

  "BacteriaStatus"          => true,

  "BioCodeStatus"           => true,

  "BotanyStatus"            => true,

  "li"                      => true,

  "p"                       => true,

  "para"                    => true,

  "PreferredAbbreviation"   => true,

  "section"                 => true,

  "Specification"           => true,

  "SuffixAlgae"             => true,

  "SuffixAnimalia"          => true,

  "SuffixBacteriae"         => true,

  "SuffixFungi"             => true,

  "SuffixFungi"             => true,

  "SuffixPlantae"           => true,

  "title"                   => true,

  "ul"                      => true,

  "#text"                   => true,

  "#comment"                => true,

  "ZoologyStatus"           => true

);

function isIgnoreType($nodeName) {

  global $ignoreTypes;

  return $ignoreTypes[$nodeName];

}

$files = array(

               'eml-access.xsd',

               'eml-coverage.xsd',

               'eml-documentation.xsd',

               'eml-literature.xsd',

               'eml-party.xsd',

               'eml-project.xsd',

               'eml-resource.xsd',

               'eml-text.xsd',

               'tcsv101.xsd',

               'tdwg_basetypes.xsd',

               'tdwg_dw_element.xsd',

               'tdwg_dw_geospatial.xsd',

               'veg-misc.xsd',

               'veg-organismobservation.xsd',

               'veg-plotobservation.xsd',

               'veg.xsd',

               'veg-plot.xsd');

function hasImportantNodes($node) {

  $nodes = $node->getElementsbyTagName("*");

  foreach($nodes as $node) {

    $nodeName = preg_replace("/.*:/","",$node->nodeName);

    if(!isIgnoreType($nodeName)) {

      return true;

    }

  }

  return false;

}

foreach($files as $file) {

  $xmlDoc = new DOMDocument();

  $xmlDoc->load($file);

  $nodes = $xmlDoc->getElementsByTagName("*");

  foreach($nodes as $node) {

    $nodeName = preg_replace("/.*:/","",$node->nodeName);

    if(!isIgnoreType($nodeName)) {

      #if($nodeName == 'element' || $nodeName == 'restriction' || $nodeName == 'extension') {

      if($nodeName == 'attribute') {

        $baseName = $node->getAttribute('base');

        $baseName = preg_replace("/.*:/","",$baseName);

        $typeName = $node->getAttribute('type');

        $typeName = preg_replace("/.*:/","",$typeName);

        if($baseName != '') {

          print $baseName . "\n";

        } else if($typeName != '') {

          print $typeName . "\n";

        }

      }

    }

  }

}

?>

<?php

$primitiveTypes = array(

'DEFCATEGORIE' => 'enumerated string',

'decimalLatitudeDataType' => 'xs:double [-90,90]',

'decimalLongitudeDataType' => 'xs:double [-180,180]',

'spatialFitDataType' => 'xs:double (0 or >1 or undefined)',

'PERCENT' => 'xsd:decimal [0,100]',

'RoleType' => 'xs:string (union of enumerated string & unenumerated string)',

'TaxonomicRankEnum' => 'xs:string (union of several enumerated string types for one big list of enum values)',

'TINYINT' => 'xsd:decimal [-128,128]',

'yearDate' => 'xs:gYear xs:date (union of)',

'anyType' => 'xsd:anyType',

'date' => 'xsd:date',

'anyURI' => 'xs:anyURI',

'decimal' => 'xsd:decimal',

'gYear' => 'xsd:gYear',

'string' => 'xs:string',

'positiveInteger' => 'xs:positiveInteger',

'time' => 'xs:time',

'Name' => 'xsd:Name',

'double' => 'xs:double',

'integer' => 'xs:integer',

'NMTOKEN' => 'xs:NMTOKEN',

);

$primitiveGroupings = array(

'GRingPointType' => array('gRingLatitude' => 'xs:string', 'gRingLongitude' => 'xs:string'),

'simpleUserdefinedType' => array('name' => 'xs:string', 'value' => 'xs:string', 'methodID' => 'xs:string'),

'partyWithRoleType' => array('partyID' => 'xs:anyType', 'role' => 'xs:anyType'),

'ReferenceType' => array('attribute_ref (op)' => 'xsd:token', 'attribute_linkType (op)' => 'enumerated string'),

'relativeSpatialCoordinateType' => array('relativeX' => 'xsd:decimal', 'relativeY' => 'xsd:decimal', 'relativeZ (op)' => 'xsd:decimal'),

'TaxonomicRank' => array('text' => 'xs:string', 'attribute_code' => 'TaxonomicRankEnum (op)'),

'RelationshipType' => array('text' => 'xs:text (maybe)', 'attribute_type' => 'enumerated string (required)'),

);

$primitiveGroupingsVariableLength = array(

'AccessRule' => array('principal' => 'xs:string', 'permission' => 'xs:string'),

'Person' => array('salutation' => 'xs:string (unbounded)', 'givenName' => 'xs:string (unbounded)', 'surName' => 'xs:string'),

'PlaceholderType' => array('any' => 'xs:any (unbounded)', 'anyAttribute' => 'xs:string (likely unbounded)'),

'SubSuperScriptType' => array('text' => 'xs:string', 'subscript' => 'SubSuperScriptType (ch) (unbounded)', 'superscript' => 'SubSuperScriptType (ch) (unbounded)'),

'TaxonomicClassificationType' => array('taxonRankName' => 'xs:string (op)', 'taxonRankValue' => 'xs:string (op)', 'commonName' => 'xs:string (op) (unbounded)', 'taxonomicClassification' => 'TaxonomicClassificationType (op) (unbounded)'),

);

$complexTypes = array(

'AccessType' => 1,

);

?>

<?php

$allUsedTypes = array(

'AccessRule' => 1,

'AccessType' => 1,

'AccordingToType' => 1,

'Address' => 1,

'AgentNames' => 1,

'anyType' => 1,

'anyURI' => 1,

'Article' => 1,

'AudioVisual' => 1,

'Book' => 1,

'CanonicalAuthorship' => 1,

'CanonicalName' => 1,

'Chapter' => 1,

'CitationType' => 1,

'complexUserDefinedType' => 1,

'ConferenceProceedings' => 1,

'ConnectionDefinitionType' => 1,

'Coverage' => 1,

'date' => 1,

'decimal' => 1,

'decimalLatitudeDataType' => 1,

'decimalLongitudeDataType' => 1,

'DEFCATEGORIE' => 1,

'DistributionType' => 1,

'double' => 1,

'Generic' => 1,

'GeographicCoverage' => 1,

'geospatialType' => 1,

'GRingPointType' => 1,

'gYear' => 1,

'InlineType' => 1,

'integer' => 1,

'ListType' => 1,

'Manuscript' => 1,

'Map' => 1,

'MeasurementType' => 1,

'Name' => 1,

'NameCitation' => 1,

'NMTOKEN' => 1,

'NomenclaturalNoteType' => 1,

'noteType' => 1,

'ParagraphType' => 1,

'partyWithRoleType' => 1,

'PERCENT' => 1,

'percentCoverType' => 1,

'Person' => 1,

'PersonalCommunication' => 1,

'PlaceholderType' => 1,

'positiveInteger' => 1,

'Presentation' => 1,

'ReferenceType' => 1,

'relatedItemType' => 1,

'relatedPlotType' => 1,

'RelationshipType' => 1,

'relativeSpatialCoordinateType' => 1,

'Report' => 1,

'ResearchProjectType' => 1,

'ResponsibleParty' => 1,

'RoleType' => 1,

'ScientificName' => 1,

'SectionType' => 1,

'simpleUserdefinedType' => 1,

'SingleDateTimeType' => 1,

'spatialFitDataType' => 1,

'string' => 1,

'SubSuperScriptType' => 1,

'TaxonConceptType' => 1,

'TaxonomicClassificationType' => 1,

'TaxonomicCoverage' => 1,

'TaxonomicRank' => 1,

'TemporalCoverage' => 1,

'TextType' => 1,

'Thesis' => 1,

'time' => 1,

'TINYINT' => 1,

'vegetationStructureType' => 1,

'yearDate' => 1

);

?>

<?php

$ignoreTypes = array(

                     "doc:description"         => true,

                     "doc:example"             => true,

                     "doc:moduleDescription"   => true,

                     "doc:moduleDocs"          => true,

                     "doc:moduleName"          => true,

                     "doc:recommendedUsage"    => true,

                     "doc:standAlone"          => true,

                     "doc:summary"             => true,

                     "doc:tooltip"             => true,

                     "xsd:annotation"          => true,

                     "xsd:appinfo"             => true,

                     "xsd:documentation"       => true,

                     "xsd:import"              => true,

                     "xsd:include"             => true,

                     "xsd:schema"              => true,

                     "AdditionalAbbreviations" => true,

                     "BacteriaStatus"          => true,

                     "BioCodeStatus"           => true,

                     "BotanyStatus"            => true,

                     "li"                      => true,

                     "p"                       => true,

                     "para"                    => true,

                     "PreferredAbbreviation"   => true,

                     "section"                 => true,

                     "Specification"           => true,

                     "SuffixAlgae"             => true,

                     "SuffixAnimalia"          => true,

                     "SuffixBacteriae"         => true,

                     "SuffixFungi"             => true,

                     "SuffixFungi"             => true,

                     "SuffixPlantae"           => true,

                     "title"                   => true,

                     "ul"                      => true,

                     "ZoologyStatus"           => true);

function isIgnoreType($nodeName) {

  global $ignoreTypes;

  return $ignoreTypes[$nodeName];

}

$files = array(

               'eml-access.xsd',

               'eml-coverage.xsd',

               'eml-documentation.xsd',

               'eml-literature.xsd',

               'eml-party.xsd',

               'eml-project.xsd',

               'eml-resource.xsd',

               'eml-text.xsd',

               'tcsv101.xsd',

               'tdwg_basetypes.xsd',

               'tdwg_dw_element.xsd',

               'tdwg_dw_geospatial.xsd',

               'veg-misc.xsd',

               'veg-organismobservation.xsd',

               'veg-plotobservation.xsd',

               'veg-plot.xsd');

foreach($files as $file) {

  $xmlDoc = new DOMDocument();

  $xmlDoc->load($file);

  $nodes = $xmlDoc->getElementsByTagName("*");

  foreach($nodes as $node) {

    $nodeName = preg_replace("/xs:/","xsd:",$node->nodeName);

    if(!isIgnoreType($nodeName)) {

      print $nodeName . "\n";

    }

  } 

}

?>

<?php

$ignoreTypes = array(

                     "doc:description"         => true,

                     "doc:example"             => true,

                     "doc:moduleDescription"   => true,

                     "doc:moduleDocs"          => true,

                     "doc:moduleName"          => true,

                     "doc:recommendedUsage"    => true,

                     "doc:standAlone"          => true,

                     "doc:summary"             => true,

                     "doc:tooltip"             => true,

                     "xsd:annotation"          => true,

                     "xsd:appinfo"             => true,

                     "xsd:documentation"       => true,

                     "xsd:import"              => true,

                     "xsd:include"             => true,

                     "xsd:schema"              => true,

                     "AdditionalAbbreviations" => true,

                     "BacteriaStatus"          => true,

                     "BioCodeStatus"           => true,

                     "BotanyStatus"            => true,

                     "li"                      => true,

                     "p"                       => true,

                     "para"                    => true,

                     "PreferredAbbreviation"   => true,

                     "section"                 => true,

                     "Specification"           => true,

                     "SuffixAlgae"             => true,

                     "SuffixAnimalia"          => true,

                     "SuffixBacteriae"         => true,

                     "SuffixFungi"             => true,

                     "SuffixFungi"             => true,

                     "SuffixPlantae"           => true,

                     "title"                   => true,

                     "ul"                      => true,

                     "ZoologyStatus"           => true);

function isIgnoreType($nodeName) {

  global $ignoreTypes;

  return $ignoreTypes[$nodeName];

}

$files = array(

               'eml-access.xsd',

               'eml-coverage.xsd',

               'eml-documentation.xsd',

               'eml-literature.xsd',

               'eml-party.xsd',

               'eml-project.xsd',

               'eml-resource.xsd',

               'eml-text.xsd',

               'tcsv101.xsd',

               'tdwg_basetypes.xsd',

               'tdwg_dw_element.xsd',

               'tdwg_dw_geospatial.xsd',

               'veg-misc.xsd',

               'veg-organismobservation.xsd',

               'veg-plotobservation.xsd',

               'veg-plot.xsd');

function hasImportantNodes($node) {

  $nodes = $node->getElementsbyTagName("*");

  foreach($nodes as $node) {

    $nodeName = preg_replace("/xs:/","xsd:",$node->nodeName);

    if(!isIgnoreType($nodeName)) {

      return true;

    }

  }

  return false;

}

foreach($files as $file) {

  $xmlDoc = new DOMDocument();

  $xmlDoc->load($file);

  $nodes = $xmlDoc->getElementsByTagName("*");

  foreach($nodes as $node) {

    $nodeName = preg_replace("/xs:/","xsd:",$node->nodeName);

    if(!isIgnoreType($nodeName)) {

      if($nodeName == 'xsd:element') { # || $nodeName == 'xsd:complexType') {

        $attrName = $node->getAttribute('name');

        if($attrName != '' && $node->getAttribute('type') == '') {

          if(hasImportantNodes($node)) {

            $poNodes = $node->getElementsByTagName("*");

            print "$file:  <$nodeName $attrName:\n ";

            foreach($poNodes as $poNode) { print "    " . $poNode->nodeName . "\n"; }

          }

        }

      }

    }

  }

}

?>

<?xml version="1.0" encoding="UTF-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:doc="eml://ecoinformatics.org/documentation-2.0.1" xmlns:txt="eml://ecoinformatics.org/text-2.0.1" xmlns:prot="eml://ecoinformatics.org/protocol-2.0.1" xmlns:rp="eml://ecoinformatics.org/party-2.0.1" xmlns:cov="eml://ecoinformatics.org/coverage-2.0.1" xmlns:cit="eml://ecoinformatics.org/literature-2.0.1" xmlns:res="eml://ecoinformatics.org/resource-2.0.1" xmlns="eml://ecoinformatics.org/project-2.0.1" targetNamespace="eml://ecoinformatics.org/project-2.0.1">

	<xs:import namespace="eml://ecoinformatics.org/documentation-2.0.1" schemaLocation="eml-documentation.xsd"/>

	<xs:import namespace="eml://ecoinformatics.org/resource-2.0.1" schemaLocation="eml-resource.xsd"/>

	<xs:import namespace="eml://ecoinformatics.org/party-2.0.1" schemaLocation="eml-party.xsd"/>

	<xs:import namespace="eml://ecoinformatics.org/coverage-2.0.1" schemaLocation="eml-coverage.xsd"/>

	<xs:import namespace="eml://ecoinformatics.org/literature-2.0.1" schemaLocation="eml-literature.xsd"/>

	<xs:import namespace="eml://ecoinformatics.org/text-2.0.1" schemaLocation="eml-text.xsd"/>

	<xs:annotation>

		<xs:documentation>'$RCSfile: eml-project.xsd,v $'

       Copyright: 1997-2002 Regents of the University of California,

                            University of New Mexico, and

                            Arizona State University

        Sponsors: National Center for Ecological Analysis and Synthesis and

                  Partnership for Interdisciplinary Studies of Coastal Oceans,

                     University of California Santa Barbara

                  Long-Term Ecological Research Network Office,

                     University of New Mexico

                  Center for Environmental Studies, Arizona State University

   Other funding: National Science Foundation (see README for details)

                  The David and Lucile Packard Foundation

     For Details: http://knb.ecoinformatics.org/

        '$Author: jones $'

          '$Date: 2003/11/06 20:15:21 $'

      '$Revision: 1.77 $'

    </xs:documentation>

		<xs:appinfo>

		</xs:appinfo>

	</xs:annotation>

	<xs:element name="researchProject" type="ResearchProjectType">

		<xs:annotation>

			<xs:appinfo>

				<doc:tooltip>research project</doc:tooltip>

				<doc:summary>The root element of this module.</doc:summary>

			</xs:appinfo>

		</xs:annotation>

	</xs:element>

	<xs:complexType name="ResearchProjectType">

		<xs:annotation>

			<xs:appinfo>

				<doc:tooltip>Research project descriptor</doc:tooltip>

				<doc:summary>Descriptor of a research context for a dataset or another

        project.</doc:summary>

			</xs:appinfo>

		</xs:annotation>

		<xs:choice>

			<xs:sequence>

				<xs:element name="title" type="xs:string" maxOccurs="unbounded">

					<xs:annotation>

						<xs:appinfo>

							<doc:tooltip>Project Title</doc:tooltip>

							<doc:summary>Title of the project.</doc:summary>

						</xs:appinfo>

					</xs:annotation>

				</xs:element>

				<xs:element name="personnel" maxOccurs="unbounded">

					<xs:annotation>

						<xs:appinfo>

							<doc:tooltip>Personnel</doc:tooltip>

							<doc:summary>Contact and role information for people involved in

              the research project.</doc:summary>

						</xs:appinfo>

					</xs:annotation>

					<xs:complexType>

						<xs:complexContent>

							<xs:extension base="rp:ResponsibleParty">

								<xs:sequence maxOccurs="unbounded">

									<xs:element name="role" type="rp:RoleType">

										<xs:annotation>

											<xs:appinfo>

												<doc:tooltip>Role</doc:tooltip>

												<doc:summary>Role information for people involved in

                        the research project.</doc:summary>

											</xs:appinfo>

										</xs:annotation>

									</xs:element>

								</xs:sequence>

							</xs:extension>

						</xs:complexContent>

					</xs:complexType>

				</xs:element>

				<xs:element name="abstract" type="txt:TextType" minOccurs="0">

					<xs:annotation>

						<xs:appinfo>

							<doc:tooltip>Abstract</doc:tooltip>

							<doc:summary>Project Abstract.</doc:summary>

						</xs:appinfo>

					</xs:annotation>

				</xs:element>

				<xs:element name="funding" type="txt:TextType" minOccurs="0">

					<xs:annotation>

						<xs:appinfo>

							<doc:tooltip>Funding</doc:tooltip>

							<doc:summary>Funding information.</doc:summary>

						</xs:appinfo>

					</xs:annotation>

				</xs:element>

				<xs:element name="studyAreaDescription" minOccurs="0">

					<xs:annotation>

						<xs:appinfo>

							<doc:tooltip>Description of the study area.</doc:tooltip>

							<doc:summary>Description of the physical area associated with the

              research project, potentially including coverage, climate,

              geology, distrubances, etc.</doc:summary>

						</xs:appinfo>

					</xs:annotation>

					<xs:complexType>

						<xs:choice maxOccurs="unbounded">

							<xs:element name="descriptor">

								<xs:annotation>

									<xs:appinfo>

										<doc:tooltip>Non-coverage characteristics of the study

                    area</doc:tooltip>

										<doc:summary>Description of non-coverage characteristics of

                    the study area such as climate, geology,

                    disturbances</doc:summary>

									</xs:appinfo>

								</xs:annotation>

								<xs:complexType>

									<xs:sequence maxOccurs="unbounded">

										<xs:element name="descriptorValue" maxOccurs="unbounded">

											<xs:annotation>

												<xs:appinfo>

													<doc:tooltip>Description of some aspect of the study

                          area.</doc:tooltip>

													<doc:summary>Description of some aspect of the study

                          area.</doc:summary>

												</xs:appinfo>

											</xs:annotation>

											<xs:complexType>

												<xs:simpleContent>

													<xs:extension base="xs:string">

														<xs:attribute name="name_or_id" type="xs:string" use="optional">

															<xs:annotation>

																<xs:appinfo>

																	<doc:tooltip>The name or ID of a descriptor

                                  value.</doc:tooltip>

																	<doc:summary>The name part of a name/value

                                  pair of a descriptor; or ID portion of a

                                  classification, if applicable.</doc:summary>

																</xs:appinfo>

															</xs:annotation>

														</xs:attribute>

													</xs:extension>

												</xs:simpleContent>

											</xs:complexType>

										</xs:element>