function taxonomy_xml_relationship_synonyms in Taxonomy import/export via XML 6.2

Same name and namespace in other branches

1. 5.2 taxonomy_xml.module \taxonomy_xml_relationship_synonyms()
2. 5 taxonomy_xml.module \taxonomy_xml_relationship_synonyms()
3. 6 taxonomy_xml.module \taxonomy_xml_relationship_synonyms()
4. 7 taxonomy_xml.module \taxonomy_xml_relationship_synonyms()

Return an array of alternative wordings that may be used in the input files.

ADD TO THIS AS NEEDED, to support more XML dialects, referring to the globals defined at the top of the module.

Different input files use different words to express the same concept. This array tries to translate the meanings down into the core concepts used internally. The reason that this list is so big and messy is because all the different academic sources I've researched just use different terminology to say the same thing.

See ISO 2788 for notes on expressing thesauri. or SKOS http://www.w3.org/2004/02/skos/vocabs

or an alternative glossary: "http://www.boxesandarrows.com/view/controlled_vocabularies_a_glosso_thes...

Each of these terms are predicates that would make up a 'triple' statement. For a geographical taxonomy, a sample could be:

Subject, Predicate, Object

"United States of America", "Narrower", "Iowa" "United States of America", "Broader", "North America" "United States of America", "AKA", "USA" "The States", "See", "United States of America"

The list below is non-namespaced. SOME of these predicates could and should be namespaced, and if we were working purely with RDF, they would be. In reality we work with all sorts of data sources, most of which are NOT namespaced. Therefore, when resolving them, we reduce complex, namespaced values to the last word at the end, the shortname, before flattening all these synonyms.

This leads to some collisions, but in this case it's intentional, as the concept of 'label' is braodly the same no matter what namespace it was found in.

See also

taxonomy_xml_canonicize_predicates()

3 calls to taxonomy_xml_relationship_synonyms()

taxonomy_xml_canonicize_predicates in ./taxonomy_xml.module

Convert aliased predicates into common ones.

taxonomy_xml_csv_parse in ./csv_format.inc

Scan the input CSV file and create a taxonomy structure out of it.

taxonomy_xml_merge_predicates_into_attributes in ./taxonomy_xml.module

Merge all predicate data into a simpler array

File

./taxonomy_xml.module, line 2447

This module makes it possible to import and export taxonomies as XML documents.

Code

function taxonomy_xml_relationship_synonyms() {
  static $synonyms;
  if (!isset($synonyms)) {
    $synonyms = array(
      'Related Terms' => TAXONOMY_XML_RELATED,
      'Related' => TAXONOMY_XML_RELATED,
      'related' => TAXONOMY_XML_RELATED,
      // SKOS
      'RT' => TAXONOMY_XML_RELATED,
      // ISO2788
      'seeAlso' => TAXONOMY_XML_RELATED,
      // RDFS
      'Broader Terms' => TAXONOMY_XML_PARENT,
      // Library of Congress
      'Broader' => TAXONOMY_XML_PARENT,
      'broader' => TAXONOMY_XML_PARENT,
      // SKOS
      'Broad Term' => TAXONOMY_XML_PARENT,
      'BT' => TAXONOMY_XML_PARENT,
      // ISO2788
      'subClassOf' => TAXONOMY_XML_PARENT,
      // rdfs
      'SubClassOf' => TAXONOMY_XML_PARENT,
      // contentlabel
      'ChildOf' => TAXONOMY_XML_PARENT,
      // FOAF?
      'hypernym' => TAXONOMY_XML_PARENT,
      'hyponymOf' => TAXONOMY_XML_PARENT,
      // Wordnet
      'parent' => TAXONOMY_XML_PARENT,
      // lsid.zoology.gla.ac.uk
      'is child taxon of' => TAXONOMY_XML_PARENT,
      // TCS
      'biology.organism_classification.higher_classification' => TAXONOMY_XML_PARENT,
      // Freenet
      'music.genre.parent_genre' => TAXONOMY_XML_PARENT,
      // Freenet
      'media_common.media_genre.parent_genre' => TAXONOMY_XML_PARENT,
      // Freebase
      'broaderTransitive' => TAXONOMY_XML_PARENT,
      // Seen in SKOS from IPTC
      'Narrower Terms' => TAXONOMY_XML_CHILD,
      // Library of Congress
      'Narrower' => TAXONOMY_XML_CHILD,
      'Narrow Term' => TAXONOMY_XML_CHILD,
      // FONZ
      'narrower' => TAXONOMY_XML_CHILD,
      // SKOS
      'NT' => TAXONOMY_XML_CHILD,
      // ISO2788 ' Narrower Term'
      'superClassOf' => TAXONOMY_XML_CHILD,
      // should be complimentary to the rdfs subClassOf
      'ParentOf' => TAXONOMY_XML_CHILD,
      'hasChild' => TAXONOMY_XML_CHILD,
      // uBio
      'hasCAVConcept' => TAXONOMY_XML_CHILD,
      // uBio
      'hyponym' => TAXONOMY_XML_CHILD,
      'hyponymOf' => TAXONOMY_XML_CHILD,
      // Wordnet
      'is parent taxon of' => TAXONOMY_XML_CHILD,
      // TCS
      'biology.organism_classification.lower_classifications' => TAXONOMY_XML_CHILD,
      //Freenet
      'music.genre.subgenre' => TAXONOMY_XML_CHILD,
      //Freenet
      'Description' => TAXONOMY_XML_DESCRIPTION,
      'description' => TAXONOMY_XML_DESCRIPTION,
      // DC
      'definition' => TAXONOMY_XML_DESCRIPTION,
      // SKOS
      'Definition' => TAXONOMY_XML_DESCRIPTION,
      'comment' => TAXONOMY_XML_DESCRIPTION,
      'gloss' => TAXONOMY_XML_DESCRIPTION,
      'Scope Note' => TAXONOMY_XML_DESCRIPTION,
      // Library of Congress
      'scopeNote' => TAXONOMY_XML_DESCRIPTION,
      // also Library of Congress
      'note' => TAXONOMY_XML_DESCRIPTION,
      // SKOS
      'SN' => TAXONOMY_XML_DESCRIPTION,
      // ISO2788 'Scope note'
      'Used for' => TAXONOMY_XML_HAS_SYNONYM,
      'UF' => TAXONOMY_XML_HAS_SYNONYM,
      // "used for", Alexandria Digital Library
      // 'UFT'             => TAXONOMY_XML_HAS_SYNONYM, // "used for term", Alexandria Digital Library
      'AKA' => TAXONOMY_XML_HAS_SYNONYM,
      'synonym' => TAXONOMY_XML_HAS_SYNONYM,
      'altLabel' => TAXONOMY_XML_HAS_SYNONYM,
      // SKOS

      //'notation'        => TAXONOMY_XML_HAS_SYNONYM, // SKOS
      'equivalentClass' => TAXONOMY_XML_HAS_SYNONYM,
      // OWL
      'has synonym' => TAXONOMY_XML_HAS_SYNONYM,
      // TCS
      'has vernacular' => TAXONOMY_XML_HAS_SYNONYM,
      // TCS
      'common.topic.alias' => TAXONOMY_XML_HAS_SYNONYM,
      // Freenet
      'biology.organism_classification.scientific_name',
      TAXONOMY_XML_HAS_SYNONYM,
      // Freenet
      'See' => TAXONOMY_XML_SYNONYM_OF,
      // Library of Congress
      'USE' => TAXONOMY_XML_SYNONYM_OF,
      // ISO2788
      'Use' => TAXONOMY_XML_SYNONYM_OF,
      'Preferred Term' => TAXONOMY_XML_SYNONYM_OF,
      'PT' => TAXONOMY_XML_SYNONYM_OF,
      // 'Preferred Term'
      // Do not use 'sameas', it's not.
      'related' => TAXONOMY_XML_RELATED,
      'seeAlso' => TAXONOMY_XML_RELATED,
      'See Also' => TAXONOMY_XML_RELATED,
      // Library of Congress
      'memberMeronymOf' => TAXONOMY_XML_RELATED,
      // Wordnet
      'similarTo' => TAXONOMY_XML_RELATED,
      // Wordnet (1999 rdfs)
      'RT' => TAXONOMY_XML_RELATED,
      // 'Related Term'
      'Related Term' => TAXONOMY_XML_RELATED,
      // FONZ
      'Part of' => TAXONOMY_XML_IN_VOCABULARY,
      'belongs-to-facet' => TAXONOMY_XML_IN_VOCABULARY,
      // XFML
      'isDefinedBy' => TAXONOMY_XML_IN_VOCABULARY,
      // rdfs
      'inScheme' => TAXONOMY_XML_IN_VOCABULARY,
      // SKOS
      'name' => TAXONOMY_XML_NAME,
      'title' => TAXONOMY_XML_NAME,
      // DC
      'lexicalForm' => TAXONOMY_XML_NAME,
      'label' => TAXONOMY_XML_NAME,
      'scientific name' => TAXONOMY_XML_NAME,
      'Scientific Name' => TAXONOMY_XML_NAME,
      // ubio
      'prefLabel' => TAXONOMY_XML_NAME,
      //SKOS
      'type.object.name' => TAXONOMY_XML_NAME,
      // Freebase
      'subPropertyOf' => TAXONOMY_XML_UNUSED,
      // ignore this
      'hasDescriptor' => TAXONOMY_XML_UNUSED,
      'subjectIndicator' => TAXONOMY_XML_UNUSED,
      // from SKOS/Topic Maps. Seen in the GCL. I have no idea what it's used for
      'type.object.key' => TAXONOMY_XML_UNUSED,
      //unused things from freebase
      'license' => TAXONOMY_XML_UNUSED,
      'attributionName' => TAXONOMY_XML_UNUSED,
      'attributionURL' => TAXONOMY_XML_UNUSED,
      'example' => TAXONOMY_XML_UNUSED,
      // unused from LoC
      'created' => TAXONOMY_XML_UNUSED,
      // unused from LoC
      'modified' => TAXONOMY_XML_UNUSED,
      // unused from LoC
      'source' => TAXONOMY_XML_UNUSED,
      // unused from LoC
      'editorialNote' => TAXONOMY_XML_UNUSED,
      // From Library of Congress. Ignore
      'closeMatch' => TAXONOMY_XML_UNUSED,
      // From Library of Congress. Ignore
      // closeMatch COULD become TAXONOMY_XML_RELATED, though it appears in LOC to refer to off-site resources, and that would be problematic to follow.
      'music.genre.albums' => TAXONOMY_XML_UNUSED,
      // Freenet - ignore for better debugging
      'music.genre.artists' => TAXONOMY_XML_UNUSED,
      // Freenet - ignore for better debugging
      'common.topic.webpage' => TAXONOMY_XML_UNUSED,
      // Freenet - ignore for better debugging
      'common.topic.article' => TAXONOMY_XML_UNUSED,
      // Freenet - ignore for better debugging
      'location.location.geolocation' => TAXONOMY_XML_UNUSED,
      // Freenet - ignore for better debugging
      'type.type.expected_by' => TAXONOMY_XML_UNUSED,
      // Freenet - ignore for better debugging
      'common.topic.image' => TAXONOMY_XML_UNUSED,
      // Freenet - ignore for better debugging
      'status' => TAXONOMY_XML_UNUSED,
      // Seen in SKOS from "http://metadataregistry.org/"
      // Some arbitrary known values may come in handy. Store them as pure RDF if we can!
      'sameAs' => TAXONOMY_XML_OTHER_PREDICATE,
      'notation' => TAXONOMY_XML_OTHER_PREDICATE,
      // SKOS
      'identifier' => TAXONOMY_XML_OTHER_PREDICATE,
      // uBio
      'type.type.instance' => TAXONOMY_XML_OTHER_PREDICATE,
    );
  }

  // By listing the deliberately unused attributes the parser finds,
  // we can still be alerted to other unrecognised tags found in the input.
  // Perhaps they could be used. Otherwise the unused ones cause too much noise.
  // Experimental mapping
  // Freenet geographic areas.
  $synonyms['location.location.contains'] = TAXONOMY_XML_CHILD;
  $synonyms['location.location.containedby'] = TAXONOMY_XML_PARENT;
  return $synonyms;
}