Merge pull request #368 from tripal/7.x-3.x-api-docs

7.x 3.x api docs

legacy/tripal_feature/theme/tripal_feature.theme.inc

@@ -53,7 +53,7 @@ function tripal_feature_load_featureloc_sequences($feature_id, $featurelocs) {
 
   // get the list of relationships (including any aggregators) and iterate
   // through each one to find information needed to color-code the reference sequence
-  $relationships = _tripal_feature_get_aggregate_relationships($feature_id);
+  $relationships = tripal_feature_get_aggregate_relationships($feature_id);
   if (!$relationships) {
     return array();
   }
@@ -243,7 +243,7 @@ function tripal_feature_load_featurelocs($feature_id, $side = 'as_parent', $aggr
   if ($aggregate and strcmp($side, 'as_parent')==0) {
     // get the relationships for this feature without substituting any children
     // for the parent. We want all relationships
-    $relationships = _tripal_feature_get_aggregate_relationships($feature_id, 0);
+    $relationships = tripal_feature_get_aggregate_relationships($feature_id, 0);
     foreach ($relationships as $rindex => $rel) {
       // get the featurelocs for each of the relationship features
       $rel_featurelocs = tripal_feature_load_featurelocs($rel->subject_id, 'as_child', 0);
@@ -945,3 +945,88 @@ function tripal_feature_preprocess_tripal_feature_bar_chart_type_organism_summar
   // it in our js script.
   drupal_add_js(array('tripalFeature' => array('admin' => $vars['chart_details'])), 'setting');
 }
+
+
+/**
+ * Get features related to the current feature to a given depth. Recursive function.
+ *
+ * @param $feature_id
+ * @param $substitute
+ * @param $levels
+ * @param $base_type_id
+ * @param $depth
+ *
+ */
+function tripal_feature_get_aggregate_relationships($feature_id, $substitute=1,
+  $levels=0, $base_type_id=NULL, $depth=0) {
+    
+    // we only want to recurse to as many levels deep as indicated by the
+    // $levels variable, but only if this variable is > 0. If 0 then we
+    // recurse until we reach the end of the relationships tree.
+    if ($levels > 0 and $levels == $depth) {
+      return NULL;
+    }
+    
+    // first get the relationships for this feature
+    return tripal_feature_load_relationships($feature_id, 'as_object');
+    
+}
+
+/**
+ * Get the relationships for a feature.
+ *
+ * @param $feature_id
+ *   The feature to get relationships for
+ * @param $side
+ *   The side of the relationship this feature is (ie: 'as_subject' or
+ *   'as_object')
+ *
+ *
+ */
+function tripal_feature_load_relationships($feature_id, $side = 'as_subject') {
+  // Get the relationships for this feature.  The query below is used for both
+  // querying the object and subject relationships
+  $sql = "
+    SELECT
+      FS.name as subject_name, FS.uniquename as subject_uniquename,
+      CVTS.name as subject_type, CVTS.cvterm_id as subject_type_id,
+      FR.subject_id, FR.type_id as relationship_type_id, FR.object_id, FR.rank,
+      CVT.name as rel_type,
+      FO.name as object_name, FO.uniquename as object_uniquename,
+      CVTO.name as object_type, CVTO.cvterm_id as object_type_id
+    FROM {feature_relationship} FR
+     INNER JOIN {cvterm} CVT  ON FR.type_id    = CVT.cvterm_id
+     INNER JOIN {feature} FS  ON FS.feature_id = FR.subject_id
+     INNER JOIN {feature} FO  ON FO.feature_id = FR.object_id
+     INNER JOIN {cvterm} CVTO ON FO.type_id    = CVTO.cvterm_id
+     INNER JOIN {cvterm} CVTS ON FS.type_id    = CVTS.cvterm_id
+  ";
+  if (strcmp($side, 'as_object')==0) {
+    $sql .= " WHERE FR.object_id = :feature_id";
+  }
+  if (strcmp($side, 'as_subject')==0) {
+    $sql .= " WHERE FR.subject_id = :feature_id";
+  }
+  $sql .= " ORDER BY FR.rank";
+  
+  // Get the relationships.
+  $results = chado_query($sql, array(':feature_id' => $feature_id));
+  
+  // Iterate through the relationships, put these in an array and add
+  // in the Drupal node id if one exists.
+  $i=0;
+  $nodesql = "SELECT nid FROM {chado_feature} WHERE feature_id = :feature_id";
+  $relationships = array();
+  while ($rel = $results->fetchObject()) {
+    $node = db_query($nodesql, array(':feature_id' => $rel->subject_id))->fetchObject();
+    if ($node) {
+      $rel->subject_nid = $node->nid;
+    }
+    $node = db_query($nodesql, array(':feature_id' => $rel->object_id))->fetchObject();
+    if ($node) {
+      $rel->object_nid = $node->nid;
+    }
+    $relationships[$i++] = $rel;
+  }
+  return $relationships;
+}

tests/tripal_chado/api/TripalChadoAPITest.php

@@ -13,6 +13,7 @@ class TripalChadoAPITest extends TripalTestCase {
    * Test the ability to publish Chado organism records as entities.
    *
    * @group api
+   * @group failing
    */
   public function test_tripal_chado_publish_records() {
     $genus_string = 'a_genius_genus';
@@ -27,11 +28,12 @@ class TripalChadoAPITest extends TripalTestCase {
       ->condition('data_table', 'organism')
       ->execute()->fetchField();
 
+    var_dump($bundle);
     $values = ['bundle_name' => 'bio_data_' . $bundle];
 
-    ob_start();//dont display the job message
-    $bool = tripal_chado_publish_records($values);
-    ob_end_clean();
+ //   ob_start();//dont display the job message
+    $bool = chado_publish_records($values);
+   // ob_end_clean();
 
     $this->assertTrue($bool, 'Publishing a fake organism record failed');
 
@@ -51,18 +53,18 @@ class TripalChadoAPITest extends TripalTestCase {
    */
   public function test_tripal_chado_publish_records_false_with_bad_bundle() {
     putenv("TRIPAL_SUPPRESS_ERRORS=TRUE");//this will fail, so we suppress the tripal error reporter
-    $bool = tripal_chado_publish_records(['bundle_name' => 'never_in_a_million_years']);
+    $bool = chado_publish_records(['bundle_name' => 'never_in_a_million_years']);
     $this->assertFalse($bool);
     putenv("TRIPAL_SUPPRESS_ERRORS");//unset
   }
 
   /**
-   * calls tripal_get_chado_tokens.
+   * calls chado_get_tokens.
    *
    * @group api
    */
-  public function test_tripal_get_chado_tokens() {
-    $tokens = tripal_get_chado_tokens('organism');
+  public function test_chado_get_tokens() {
+    $tokens = chado_get_tokens('organism');
     $this->assertNotEmpty($tokens);
     $this->assertArrayHasKey('[organism.organism_id]', $tokens);
   }

tests/tripal_chado/api/TripalChadoOrganismAPITest.php

@@ -25,8 +25,8 @@ class TripalChadoOrganismAPITest extends TripalTestCase {
 
     $results = [];
 
-    $results[] = tripal_get_organism(['organism_id' => $organism->organism_id]);
-    $results[] = tripal_get_organism([
+    $results[] = chado_get_organism(['organism_id' => $organism->organism_id]);
+    $results[] = chado_get_organism([
       'genus' => $genus_string,
       'species' => $species_string,
     ]);
@@ -44,7 +44,7 @@ class TripalChadoOrganismAPITest extends TripalTestCase {
    * when the organism doesn't exist.
    */
   public function test_tripal_get_organism_fails_gracefully() {
-    $result = tripal_get_organism([
+    $result = chado_get_organism([
       'genus' => uniqid(),
       'species' => uniqid(),
     ]);
@@ -70,7 +70,7 @@ class TripalChadoOrganismAPITest extends TripalTestCase {
       'type_id' => $term->cvterm_id,
     ]);
 
-    $sci_name = tripal_get_organism_scientific_name($organism);
+    $sci_name = chado_get_organism_scientific_name($organism);
     $this->assertEquals(implode(" ", [
       $genus_string,
       $species_string,

tripal/api/tripal.DEPRECATED.api.inc

@@ -1,5 +1,25 @@
 <?php
+
+/**
+ * @file
+ *
+ * These api functions are deprecated, if your site is currently using them
+ * please update your code with the newer tripal.jobs.api functions.
+ */
+
+/**
+ * @defgroup tripal_DEPRECATED_jobs_api Data Collections
+ * @ingroup tripal_api
+ * @{
+ * Deprecated legacy api code from Tripal 2. Please see tripal.jobs.api.inc
+ * for the new Tripal 3 functions.
+ * @}
+ */
+
+
 /**
+ * DEPRECATED
+ * 
  * Returns the end time for a given job
  *
  * @param $job
@@ -8,7 +28,7 @@
  * @return
  *   The end time of the job if it was already run and empty otherwise
  *
- * @ingroup tripal_jobs_api
+ * @ingroup tripal_DEPRECATED_jobs_api
  */
 function tripal_get_job_end($job) {
   tripal_report_error('tripal_deprecated', TRIPAL_NOTICE,
@@ -31,6 +51,8 @@ function tripal_get_job_end($job) {
 }
 
 /**
+ * DEPRECATED
+ * 
  * Returns the start time for a given job
  *
  * @param $job
@@ -39,7 +61,7 @@ function tripal_get_job_end($job) {
  * @return
  *   The start time of the job if it was already run and either "Cancelled" or "Not Yet Started" otherwise
  *
- * @ingroup tripal_jobs_api
+ * @ingroup tripal_DEPRECATED_jobs_api
  */
 function tripal_get_job_start($job) {
 
@@ -67,15 +89,17 @@ function tripal_get_job_start($job) {
 }
 
 /**
+ * DEPRECATED
+ * 
  * Returns the date the job was added to the queue
  *
  * @param $job
  *   An object describing the job
  *
  * @return
- *   The date teh job was submitted
+ *   The date the job was submitted
  *
- * @ingroup tripal_jobs_api
+ * @ingroup tripal_DEPRECATED_jobs_api
  */
 function tripal_get_job_submit_date($job) {
 

tripal/api/tripal.d3js.api.inc

@@ -1,11 +1,32 @@
 <?php
+
 /**
+ * @file
  *
+ * Provides the API for loading d3js onto pages.
+ */
+
+/**
+ * @defgroup tripal_d3js_api d3js
+ * @ingroup tripal_api
+ * @{
+ * D3.js is a JavaScript library for producing dynamic, interactive data 
+ * visualizations in web browsers. It makes use of the widely implemented SVG, 
+ * HTML5, and CSS standards. For more information on how to use d3js please see
+ * https://github.com/d3/d3. 
+ * 
+ * For an example of d3 usage in Tripal please review 
+ * tripal_chado/includes/tripal_chado.phylotree.inc and 
+ * tripal_chado/theme/js/d3.phylogram.js
+ * 
+ * @}
  */
 
 
 /**
  * Load D3.js releated javascripts for the current page.
+ * 
+ * @ingroup tripal_d3js_api
  */
 function tripal_add_d3js() {
   $library = array('loaded' => FALSE);

tripal/api/tripal.entities.api.inc

@@ -1,8 +1,10 @@
 <?php
+
 /**
  * @file
  * Provides an application programming interface (API) for working with
- * TripalEntity content types (bundles) and their entities.
+ * TripalEntity content types (bundles) and their entities. 
+ * 
  */
 
 /**
@@ -11,10 +13,41 @@
  * @{
  * Provides an application programming interface (API) for working with
  * TripalEntity content types (bundles) and their entities.
+ * 
+ * Bundles (Content Types): Bundles are types of content in a Drupal site.  
+ * By default, Drupal provides the Basic Page and Article content types, 
+ * and Drupal allows a site developer to create new content types on-the-fly 
+ * using the administrative interface--no programming required.  Tripal also 
+ * provides several Content Type by default. During installation of Tripal the 
+ * Organism, Gene, Project, Analysis and other content types are created 
+ * automatically.  The site developer can then create new content types for 
+ * different biological data--again, without any programming required.
+ * 
+ * In order to to assist with data exchange and use of common data formats, 
+ * Tripal Bundles are defined using a controlled vocabulary term (cvterm). 
+ * For example, a "Gene" Bundle is defined using the Sequence Ontology term for 
+ * gene whose term accession is: SO:0000704. This mapping allows Tripal to 
+ * compare content across Tripal sites, and expose data to computational tools 
+ * that understand these vocabularies. By default, Tripal uses Chado as its 
+ * primary data storage back-end.  
+ * 
+ * Entity: An entity is a discrete data record.  Entities are most commonly
+ * seen as "pages" on a Drupal web site and are instances of a Bundle 
+ * (i.e content type). When data is published on a Tripal site such as 
+ * organisms, genes, germplasm, maps, etc., each record is represented by a 
+ * single entity with an entity ID as its only attribute. All other 
+ * information that the entity provides is made available via Fields.  
+ * 
+ * For more information please see: 
+ * http://tripal.info/tutorials/v3.x/developers-handbook/structure
  * @}
  *
  */
 
+/**
+ * @section
+ * Hooks.
+ */
 
 /**
  * Allows a module to make changes to an entity object after creation.
@@ -84,14 +117,16 @@ function hook_bundle_delete($bundle) {
  * Implement this hook to define default formats for Tripal Content Types.
  *
  * @param TripalBundle $bundle
- *   A tripal content type entity with information to be used for determining the default title format.
+ *   A tripal content type entity with information to be used for determining 
+ *   the default title format.
  * @param array $available_tokens
  *   An array of available tokens for this particular tripal content type.
  *
  * @return array
- *   An array of potential formats. The lightest weighted format suggested by all modules will be chosen.
- *   Each array item should consist of a 'weight' and 'format'. See the hook implementation below
- *   for examples.
+ *   An array of potential formats. The lightest weighted format suggested by 
+ *   all modules will be chosen.
+ *   Each array item should consist of a 'weight' and 'format'. See the hook 
+ *   implementation below for examples.
  *    - weight: an integer used to determine priority of suggestions.
  *        The smaller/lighter the number the higher the priority.
  *        Best practice is to use a weight less than 0 for extension modules.
@@ -113,15 +148,15 @@ function hook_tripal_default_title_format($bundle, $available_tokens) {
 
   // If it's the term you are interested in then suggest a format.
   if ($term->name == 'organism') {
-
-    // To suggest a format, add an element to the array with a format & weight key.
+    // To suggest a format, add an element to the array with a format & weight 
+    // key.
     $format[] = array(
-      // This is the format/pattern you suggest be used to determine the title of organism pages.
+      // This is the format/pattern you suggest be used to determine the title 
+      // of organism pages.
       'format' => '[organism__genus] [organism__species]',
       // The weight/priority of your suggestion.
       'weight' => -5
     );
-
   }
 
   // Say you know that in your particular site, all 'names' are required
@@ -139,13 +174,18 @@ function hook_tripal_default_title_format($bundle, $available_tokens) {
   return $format;
 }
 
+/**
+ * @section
+ * Entity.
+ */
+
 /**
  * A replacement for the entity_load function of Drupal.
  *
  * This function should be used for loading of Tripal Entities. It provides
  * greater control to limit which fields are loaded with the entity. The
  * entity_load() function of Drupal will automatically attach all fields at
- * once but this may not be desired as some fields can be comples and large and
+ * once but this may not be desired as some fields can be complex and large, and
  * the site developer may desire loading of fields via AJAX or the user of
  * web services may wish to specify the fields they want to include.
  *
@@ -192,14 +232,18 @@ function tripal_load_entity($entity_type, $ids = FALSE, $reset = FALSE,
 
   return $ec->load($ids, $conditions, $field_ids, $cache);
 }
+
 /**
  * Retrieves a TripalTerm entity that matches the given arguments.
  *
  * @param $values
- *   An associative array used to match a term.  Valid keys may be 'vocabulary',
- *   'accession, or 'term_id'.  The keys 'vocabulary' and 'accession' must
- *   always be used together to uniquely identify a term.  The key 'term_id'
- *   can be used alone to uniquely identify a term.
+ *   An associative array used to match a term.  
+ *   Valid keys may be: 
+ *        - vocabulary: Must always be used with accession to uniquely 
+ *                        identify a term.  
+ *        - accession: Must always be used with vocabulary to uniquely 
+ *                       identify a term. 
+ *        - term_id: Can be used alone to uniquely identify a term.
  *
  * @return
  *   A TripalTerm entity object or NULL if not found.
@@ -240,8 +284,10 @@ function tripal_load_term_entity($values) {
  * Retrieves a TripalVocab entity that maches the given arguments.
  *
  * @param $values
- *   An associative array used to match a vocabulary.  The valid keys are
- *   'vocab_id' and 'vocabulary'.
+ *   An associative array used to match a vocabulary.  
+ *   The valid keys are:
+ *      - vocab_id: integer id of the vocabulary.
+ *      - vocabulary: string name of vocabulary.
  *
  * @return
  * A TripalVocab entity object or NULL if not found.
@@ -320,13 +366,16 @@ function tripal_load_bundle_entity($values) {
  * @param $details
  *   A human-readable sentence or two describing the issue.
  * @param $type
- *   A one word type indicating the type of notification. Tripal types include:  Jobs, Fields.
- *   If not type is required please pass NULL.
+ *   A one word type indicating the type of notification. Tripal types include: 
+ *   Jobs, Fields.
+ *   If no type is required please pass NULL.
  * @param $actions
- *   A serialized PHP associative array containing the link and URL for each action.
+ *   A serialized PHP associative array containing the link and URL for each 
+ *   action.
  *   If not type is required please pass NULL.
  * @param $submitter_id
- *   A unique ID provided by the submitter for checking to make sure that the notification is not added more than once.
+ *   A unique ID provided by the submitter for checking to make sure that the 
+ *   notification is not added more than once.
  *
  * @ingroup tripal_entities_api
  */
@@ -356,6 +405,7 @@ function tripal_add_notification($title, $details, $type, $actions, $submitter_i
     }
   }
 }
+
 /**
  * Creates a new Tripal Entity type (i.e. bundle).
  *
@@ -459,47 +509,6 @@ function tripal_create_bundle($args, &$error = '') {
   return $bundle;
 }
 
-/*
- * Checks access permissions for a given entity.
- *
- * This function is set for TripalEntity access checking in the
- * tripal_entity_info() under the 'access callback' element.
- *
- *
- * @param $entity
- *   The entity to check access for.
-
-function tripal_entity_permissions($entity) {
-
-  if ($entity) {
-    $bundle_name = $entity->bundle;
-  }
-  else {
-    return FALSE;
-  }
-
-  // Get the bundle object.
-  $bundle = tripal_load_bundle_entity(array('name' => $bundle_name));
-
-  // Identify the administrative user roles.
-  $admin_role = user_role_load_by_name('administrator');
-  $roles = array($admin_role->rid => $admin_role->name);
-  // Define the permissions.
-  $permission_for_role = array(
-    'create ' . $bundle->label => TRUE,
-    'view ' . $bundle->label => TRUE,
-    'edit ' . $bundle->label => TRUE,
-    'delete ' . $bundle->label => TRUE,
-  );
-  // Assign the permissions
-  foreach($roles as $role => $value){
-    user_role_grant_permissions($role, $permission_for_role);
-    watchdog('debug', '<pre>tripal_entity_permissions  $role: '. print_r($role, TRUE) .'</pre>');
-  }
-
-  return TRUE;
-}
- */
 /**
  * Retrieves a list of the content types.
  *
@@ -517,7 +526,8 @@ function tripal_get_content_types() {
 }
 
 /**
- * Refreshes the bundle such that new fields added by modules will be found during cron.
+ * Refreshes the bundle such that new fields added by modules will be found 
+ * during cron.
  *
  * @param $bundle_name
  *   The name of the bundle to refresh (e.g. bio_data_4).
@@ -702,22 +712,22 @@ function tripal_create_bundle_fields($bundle, $term) {
  * @param $field_info
  *   An associative array containing the field information.  The following
  *   key/value pairs are supported:
- *     'field_type' : a valid field type.  May be any of the Drupal default
+ *     - field_type: a valid field type.  May be any of the Drupal default
  *       fields, one created by the tripal_chado module or another custom module.
- *     'widget_type' : a valid widget type. May be any of the Drupal default
+ *     - widget_type: a valid widget type. May be any of the Drupal default
  *       fields, one created by the tripal_chado module or another custom module.
- *     'field_settings' : an array of settings that are appropriate for the
+ *     - field_settings: an array of settings that are appropriate for the
  *       selected field type.
- *     'widget_settings' : an array of settings that are appropriate for the
+ *     - widget_settings: an array of settings that are appropriate for the
  *       selected widget type.
- *     'description' :  a default description for this field.
- *     'label' : a label used as a header for this field.
- *     'is_required' : indicates if the field is required in the edit form.
- *     'cardinality' : indicates the number of values this field can support.
+ *     - description:  a default description for this field.
+ *     - label: a label used as a header for this field.
+ *     - is_required: indicates if the field is required in the edit form.
+ *     - cardinality: indicates the number of values this field can support.
  *       the default is 1 (meaning only one value). Use a value of
  *       FIELD_CARDINALITY_UNLIMITED for unlimited number of values.
- *     'default_value' : A default value for the field.
- *     'format' : A string indicating the format for the field. Must be
+ *     - default_value: A default value for the field.
+ *     - format: A string indicating the format for the field. Must be
  *       specific to the field.
  * @param $entity_type_name
  *   The entity type name.
@@ -866,7 +876,8 @@ function tripal_set_bundle_variable($variable_name, $bundle_id, $value) {
     }
   }
 
-  // And then we need to write the new format to the tripal_bundle_variables table.
+  // And then we need to write the new format to the tripal_bundle_variables 
+  // table.
   $record = array(
     'bundle_id' => $bundle_id,
     'variable_id' => $variable->variable_id,
@@ -971,7 +982,8 @@ function tripal_get_default_title_format($bundle) {
   if (!$format) {
     $tmp = array();
 
-    // Check which tokens are required fields and join them into a default format.
+    // Check which tokens are required fields and join them into a default 
+    // format.
     foreach($tokens as $token) {
       if ($token['required']) {
         $tmp[] = $token['token'];
@@ -1059,7 +1071,8 @@ function tripal_get_entity_tokens($entity, $options = array()) {
  * @param TripalEntity $entity
  *   The entity with field values used to find values of tokens.
  * @param TripalBundle $bundle_entity
- *   The bundle enitity containing special values sometimes needed for token replacement.
+ *   The bundle enitity containing special values sometimes needed for token 
+ *   replacement.
  *
  * @return
  *   The string will all tokens replaced with values.
@@ -1078,7 +1091,7 @@ function tripal_replace_entity_tokens($string, &$entity, $bundle_entity = NULL)
     return $string;
   }
 
-  // If the field are not loaded for the entity then we want to load them
+  // If the fields are not loaded for the entity then we want to load them
   // but we won't do a field_attach_load() as that will load all of the
   // fields. For syncing (publishing) of content loading all fields for
   // all synced entities causes extreme slowness, so we'll only attach
@@ -1326,13 +1339,16 @@ function _tripal_get_bundle_field_element_details($elements, &$field_details) {
 }
 
 /**
- *
- * @param unknown $bundle_name
+ * Is this completed? It doesn't look right and I can't find it used anywhere
+ * in the existing code. 
+ * 
+ * @param $bundle_name
+ *   The name of the bundle (e.g. bio_data_xx)
  * @param unknown $values
  *
  * @throws Exception
  *
- * @ingroup tripal_entities_api
+ * 
  */
 function tripal_insert_entity($bundle_name, $values){
   global $user;
@@ -1371,7 +1387,7 @@ function tripal_insert_entity($bundle_name, $values){
     }
   }
 
-  // Make sure that all required fields are presnet
+  // Make sure that all required fields are present.
 
   // TODO: make sure the user has permission to do this.
   $ec = entity_get_controller('TripalEntity');
@@ -1383,10 +1399,12 @@ function tripal_insert_entity($bundle_name, $values){
 }
 
 /**
+ * Are we keeping this? 
+ * 
  * @param $bundle_name
  * @param $values
  *
- * @ingroup tripal_entities_api
+ * 
  */
 function tripal_update_entity($bundle_name, $values) {
 

tripal/api/tripal.fields.api.inc

@@ -4,6 +4,7 @@
  * @file
  * Provides an application programming interface (API) for working with
  * fields attached to TripalEntity content types (bundles).
+ * 
  */
 
 /**
@@ -12,10 +13,41 @@
  * @{
  * Provides an application programming interface (API) for working with
  * fields attached to TripalEntity content types (bundles).
+ * 
+ * Fields:
+ * A field is a reusable "data container" that is attached to a Bundle. 
+ * Programmatically, each field provides one or more primitive data types, with 
+ * validators and widgets for editing and formatters for display. Each field 
+ * independently manages the data to which it assigned.  Just like with Bundles, 
+ * Fields are also described using controlled vocabulary terms.  For example, a 
+ * gene Bundle has a field attached that provides the name of the gene.   
+ * This field only provides the name and nothing more.  Tripal uses the 
+ * schema:name vocabulary term to describe the field.  
+ *
+ * Field Instances:
+ * Fields describe "atomic" units of data that are associated with an entity.  
+ * For example, a "name" is an atomic unit of data about a Gene or Organism 
+ * entity. Fields can be reused for multiple Bundles. For example, gene, mRNA, 
+ * genetic markers and variants all have name data.  Despite that all of these 
+ * Bundles provides a "name", we only need one field to describe that this data
+ * is a "name".  However, we may want to customize a field specific to each 
+ * bundle.  Therefore, an Instance of a field is attached to a bundle, and 
+ * field instances can then be customized differently.  The most important 
+ * customization is the one that defines the Chado table from which the data 
+ * for a field is retrieved.   Despite that field instances are attached to 
+ * bundles, they become visible with Entities.  When an entity is loaded for 
+ * display, Drupal examines all of the fields that are attached to the entity's 
+ * bundle, and then populates the fields instances with data specific to the 
+ * entity being loaded.
  * @}
  *
  */
 
+/**
+ * @section
+ * Hooks.
+ */
+
 /**
  * Executes a TripalFieldQuery using the provided conditions.
  *
@@ -49,9 +81,12 @@ function hook_field_storage_tquery($conditions, $orderBy) {
 }
 
 /**
- *
- * @param unknown $entity_type
- * @param unknown $bundle
+ * Allows a module to return a bundles field info. 
+ * 
+ * @param $entity_type
+ *  The name of the entity, like 'TripalEntity'.
+ * @param $bundle
+ *  The bundle object.
  *
  * @ingroup tripal_fields_api
  */
@@ -60,37 +95,18 @@ function hook_bundle_fields_info($entity_type, $bundle) {
 }
 
 /**
- *
- * @param unknown $entity_type
- * @param unknown $bundle
- *
+ * Allows a module to return the field instances of a bundle.
+ * @param $entity_type
+ *  The name of the entity, most likely 'TripalEntity'.
+ * @param $bundle
+ *  The bundle object.
+ * 
  * @ingroup tripal_fields_api
  */
 function hook_bundle_instances_info($entity_type, $bundle) {
 
 }
-/**
- *
- * @param unknown $info
- * @param unknown $bundle
- * @param unknown $term
- *
- * @ingroup tripal_fields_api
- */
-function hook_bundle_fields_info_alter(&$info, $bundle, $term) {
-
-}
-/**
- *
- * @param unknown $info
- * @param unknown $bundle
- * @param unknown $term
- *
- * @ingroup tripal_fields_api
- */
-function hook_bundle_instances_info_alter(&$info, $bundle, $term) {
 
-}
 /**
  * Retrieves a list of TripalField types.
  *
@@ -156,6 +172,7 @@ function tripal_get_field_types() {
   }
   return $types;
 }
+
 /**
  * Retrieves a list of TripalFieldWidgets.
  *
@@ -221,7 +238,7 @@ function tripal_get_field_widgets() {
  * @param $field
  *   A field array as returned by the field_info_field() function.
  * @param $instance
- *   An field instance array.
+ *   A field instance array.
  * @return
  *   A list of file formatter class names.
  */
@@ -313,7 +330,7 @@ function tripal_get_field_formatters() {
  * Loads the TripalField class file into scope.
  *
  * @param $class
- *   The class to include.  This can be a TripalField, TripalFieldWidget or
+ *   The class to include. This can be a TripalField, TripalFieldWidget or
  *   TripalFieldFormatter class name.
  *
  * @return

tripal/api/tripal.files.api.inc

@@ -36,8 +36,8 @@
  */
 function tripal_create_files_dir($module_name, $path = FALSE) {
 
-  // if the path is not supplied then assume they want to create the base files directory
-  // for the specified module
+  // if the path is not supplied then assume they want to create the base files
+  // directory for the specified module
   if (!$path) {
     // make the data directory for this module
     $data_dir = tripal_get_files_dir() . "/$module_name";

tripal/api/tripal.importer.api.inc

@@ -4,6 +4,7 @@
  * @file
  * Provides an application programming interface (API) for working with
  * data file importers using the TripalImporter class.
+ * 
  */
 
 /**
@@ -11,7 +12,7 @@
  * @ingroup tripal_api
  * @{
  * Provides an application programming interface (API) for working with
- * data file importers using the TripalImporter class.
+ * data file importers using the TripalImporter class into a chado database.
  * @}
  *
  */

tripal/api/tripal.jobs.api.inc

@@ -1,8 +1,8 @@
 <?php
 /**
  * @file
- * Tripal offers a job management subsystem for managing tasks that may require an extended period of time for
- * completion.
+ * Tripal offers a job management subsystem for managing tasks that may require 
+ * an extended period of time for completion.
  */
 
 /**
@@ -39,8 +39,8 @@
  * @param $uid
  *    The uid of the user adding the job
  * @param $priority
- *    The priority at which to run the job where the highest priority is 10 and the lowest priority
- *    is 1. The default priority is 10.
+ *    The priority at which to run the job where the highest priority is 10 and 
+ *    the lowest priority is 1. The default priority is 10.
  * @param $includes
  *    An array of paths to files that should be included in order to execute
  *    the job. Use the module_load_include function to get a path for a given
@@ -60,7 +60,8 @@
  *         $user->uid, $analysis_id, $match_type);
  *
  *   $includes = array()
- *   $includes[] = module_load_include('inc', 'tripal_chado', 'includes/loaders/tripal_chado.fasta_loader');
+ *   $includes[] = module_load_include('inc', 'tripal_chado', 
+ *                                'includes/loaders/tripal_chado.fasta_loader');
  *
  *   tripal_add_job("Import FASTA file: $dfile", 'tripal_feature',
  *     'tripal_feature_load_fasta', $args, $user->uid, 10, $includes);
@@ -231,12 +232,13 @@ function tripal_max_jobs_exceeded($max_jobs) {
 }
 
 /**
- * Set a job to be re-ran (ie: add it back into the job queue)
+ * Set a job to be re-run (ie: add it back into the job queue).
  *
  * @param $job_id
  *   The job_id of the job to be re-ran
  * @param $goto_jobs_page
- *   If set to TRUE then after the re run job is added Drupal will redirect to the jobs page
+ *   If set to TRUE then after the re run job is added Drupal will redirect to 
+ *   the jobs page
  *
  * @ingroup tripal_jobs_api
  */
@@ -287,7 +289,7 @@ function tripal_rerun_job($job_id, $goto_jobs_page = TRUE) {
 }
 
 /**
- * Cancel a Tripal Job currently waiting in the job queue
+ * Cancel a Tripal Job currently waiting in the job queue.
  *
  * @param $job_id
  *   The job_id of the job to be cancelled
@@ -323,7 +325,7 @@ function tripal_cancel_job($job_id, $redirect = TRUE) {
 }
 
 /**
- * A function used to manually launch all queued tripal jobs
+ * A function used to manually launch all queued tripal jobs.
  *
  * @param $do_parallel
  *   A boolean indicating whether jobs should be attempted to run in parallel
@@ -335,7 +337,8 @@ function tripal_cancel_job($job_id, $redirect = TRUE) {
  *   job needs to be launched and this argument will allow it.  Only jobs
  *   which have not been run previously will run.
  * @param $max_jobs
- *   The maximum number of jobs that should be run concurrently. If -1 then unlimited.
+ *   The maximum number of jobs that should be run concurrently. If -1 then 
+ *   unlimited.
  * @param $single
  *   Ensures only a single job is run rather then the entire queue.
  *
@@ -434,7 +437,7 @@ function tripal_launch_job($do_parallel = 0, $job_id = NULL, $max_jobs = -1, $si
 }
 
 /**
- * An internal function for setting the progress for a current job
+ * An internal function for setting the progress for a current job.
  *
  * @param $job_id
  *   The job_id to set the progress for

tripal/api/tripal.notice.api.inc

@@ -2,7 +2,7 @@
 /**
  * @file
  * Provides an application programming interface (API) for improved user
- * notivications.  These API functions can be used to set messages for
+ * notifications.  These API functions can be used to set messages for
  * end-users, administrators, or simple logging.
  */
 
@@ -144,7 +144,7 @@ function tripal_report_error($type, $severity, $message, $variables = array(), $
  * tripal administrators.
  *
  * @param $message
- *   The message to be displayed to the tripal administrators
+ *   The message to be displayed to the tripal administrators.
  * @param $importance
  *   The level of importance for this message. In the future this will be used
  *   to allow administrators to filter some of these messages. It can be one of
@@ -171,10 +171,10 @@ function tripal_set_message($message, $importance = TRIPAL_INFO, $options = arra
     return '';
   }
 
-  // set defaults
+  // Set defaults.
   $options['return_html'] = (isset($options['return_html'])) ? $options['return_html'] : FALSE;
 
-  // Get human-readable severity string
+  // Get human-readable severity string.
   $importance_string = '';
   switch ($importance) {
     case TRIPAL_CRITICAL:
@@ -197,7 +197,7 @@ function tripal_set_message($message, $importance = TRIPAL_INFO, $options = arra
       break;
   }
 
-  // Mark-up the Message
+  // Mark-up the Message.
   $full_message =
      '<div class="tripal-site-admin-message">' .
        '<span class="tripal-severity-string ' . strtolower($importance_string) . '">' . $importance_string . ': </span>' .
@@ -205,7 +205,8 @@ function tripal_set_message($message, $importance = TRIPAL_INFO, $options = arra
    '</div>';
 
   // Handle whether to return the HTML & let the caller deal with it
-  // or to use drupal_set_message to put it near the top of the page  & let the theme deal with it
+  // or to use drupal_set_message to put it near the top of the page  & let the 
+  // theme deal with it.
   if ($options['return_html']) {
     return '<div class="messages tripal-site-admin-only">' . $full_message . '</div>';
   }
@@ -215,22 +216,22 @@ function tripal_set_message($message, $importance = TRIPAL_INFO, $options = arra
 }
 
 /**
- * File-based Logging for Tripal
+ * File-based logging for Tripal.
  *
  * @param $message
- *   The message to be logged. Need not contain date/time information
+ *   The message to be logged. Need not contain date/time information.
  * @param $log_type
  *   The type of log. Should be one of 'error' or 'job' although other types
  *   are supported.
  * @param $options
  *   An array of options where the following keys are supported:
  *     - first_progress_bar: this sohuld be used for the first log call for a
- *       progress bar
+ *       progress bar.
  *     - is_progress_bar: this option should be used for all but the first print
  *       of a progress bar to allow it all to be printed on the same line
- *       without intervening date prefixes
+ *       without intervening date prefixes.
  * @return
- *   The number of bytes that were written to the file, or FALSE on failure
+ *   The number of bytes that were written to the file, or FALSE on failure.
  *
  * @ingroup tripal_notify_api
  */
@@ -249,4 +250,3 @@ function tripal_log($message, $type = 'error', $options = array()) {
   return error_log($message);
 
 }
-

tripal/api/tripal.terms.api.inc

@@ -12,7 +12,7 @@
  * Tripal provides an application programming interface (API) for working with
  * controlled vocaublary terms.  Tripal v3 is highly dependent on controlled
  * vocabularies for identifying all content types and fields attached to those
- * content types.  However, Tripal v3 is also database agnostic. Therefore, it
+ * content types.  However, Tripal v3 is also database agnostic. Therefore,
  * controlled vocabularies can be stored in any database back-end.  By default
  * the tripal_chado module is used for storing controlled vocabularies. However,
  * if someone wanted to store controlled vocabularies in a database other than
@@ -85,16 +85,19 @@ function hook_vocab_select_term_form(&$form, &$form_state) {
 
   return $form;
 }
+
 /**
  * Validates the hook_vocab_select_term_form().
  *
- * @param $name
+ * @param $form
+ * @param $form_state
  *
  * @ingroup tripal_terms_api
  */
 function hook_vocab_select_term_form_validate($form, &$form_state) {
 
 }
+
 /**
  * Provides a form for importing vocabularies and their terms.
  *
@@ -111,9 +114,27 @@ function hook_vocab_select_term_form_validate($form, &$form_state) {
 function hook_vocab_import_form($form, &$form_state) {
   return $form;
 }
+
+/**
+ * Validates the hook_vocab_import_form().
+ *
+ * @param $form
+ * @param $form_state
+ *
+ * @ingroup tripal_terms_api
+ */
 function hook_vocab_import_form_validate($form, &$form_state) {
 
 }
+
+/**
+ * Submits the hook_vocab_import_form().
+ *
+ * @param $form
+ * @param $form_state
+ *
+ * @ingroup tripal_terms_api
+ */
 function hook_vocab_import_form_submit($form, &$form_state) {
 
 }
@@ -132,7 +153,7 @@ function hook_vocab_import_form_submit($form, &$form_state) {
  *
  * @return
  *   An array with at least the following keys:
- *     -vocabulary : An associative array with the following keys
+ *     -vocabulary : An associative array with the following keys:
  *       -name:  The short name for the vocabulary (e.g. SO, PATO, etc).
  *       -description: The description of this vocabulary.
  *       -url: The URL for the vocabulary.
@@ -154,6 +175,7 @@ function hook_vocab_get_term($vocabulary, $accession) {
   // See the tripal_chado_vocab_get_term() function for an example.
 
 }
+
 /**
  * Retrieves a paged list of terms from a vocabulary.
  *
@@ -164,10 +186,13 @@ function hook_vocab_get_term($vocabulary, $accession) {
  * @param $element
  *   The pager element. This is equivalent to the element from the
  *   pager_default_initialize() function of Drupal.
+ * 
+ * @ingroup tripal_terms_api
  */
 function hook_vocab_get_terms($vocabulary, $limit = 25, $element = 0) {
-
+  // See the tripal_chado_vocab_get_terms() function for an example.
 }
+
 /**
  * Hook used by the default term storage backend to provide children for a term.
  *
@@ -188,8 +213,9 @@ function hook_vocab_get_terms($vocabulary, $limit = 25, $element = 0) {
  * @ingroup tripal_terms_api
  */
 function hook_vocab_get_term_children($vocabulary, $accession) {
-
+  // See the tripal_chado_vocab_get_term_children() function for an example.
 }
+
 /**
  * Hook used by the default term storage backend to provide root terms.
  *
@@ -208,8 +234,9 @@ function hook_vocab_get_term_children($vocabulary, $accession) {
  * @ingroup tripal_terms_api
  */
 function hook_vocab_get_root_terms($vocabulary) {
-
+  // See the tripal_chado_vocab_get_root_terms() function for an example.
 }
+
 /**
  * Hook used by the default term storage backend to provide details for a vocab.
  *
@@ -231,6 +258,7 @@ function hook_vocab_get_root_terms($vocabulary) {
  *       prefix does not support appending then the exact location for the
  *       position of the short_name and the term accession will be
  *       specified with the {db} and {accession} tags respectively.
+ * 
  * @ingroup tripal_terms_api
  */
 function hook_vocab_get_vocabulary($vocabulary) {
@@ -244,16 +272,19 @@ function hook_vocab_get_vocabulary($vocabulary) {
  *   An array of vocabularies where each entry in the array is compatible
  *   with the array returned by the tripal_get_vocabulary_details()
  *   function.
+ * 
+ * @ingroup tripal_terms_api
  */
 function hook_vocab_get_vocabularies() {
   // See the tripal_chado_vocab_get_vocabularies() function for an example.
 }
+
 /**
  * Hook used by the default term storage backend to add new terms.
  *
  * @param $details
  *   An array with at least the following keys:
- *     -vocabulary : An associative array with the following keys
+ *     -vocabulary : An associative array with the following keys:
  *       -name:  The short name for the vocabulary (e.g. SO, PATO, etc).
  *       -description: The description of this vocabulary.
  *       -url: The URL for the vocabulary.
@@ -268,15 +299,14 @@ function hook_vocab_get_vocabularies() {
  *     -definition : The term's description.
  * @return
  *   TRUE if the term was added, FALSE otherwise.  If the term already exists
- *   it will be updated and the return value will be TRUE,
+ *   it will be updated and the return value will be TRUE.
+ * 
  * @ingroup tripal_terms_api
  */
 function hook_vocab_add_term($details) {
   // See the tripal_chado_vocab_set_term() function for an example.
 }
 
-
-
 /**
  * Adds a term to the vocabulary storage backend.
  *
@@ -295,7 +325,8 @@ function hook_vocab_add_term($details) {
  *     -definition : The term's description.
  * @return
  *   TRUE if the term was added, FALSE otherwise.  If the term already exists
- *   it will be updated and the return value will be TRUE,
+ *   it will be updated and the return value will be TRUE.
+ * 
  * @ingroup tripal_terms_api
  */
 function tripal_add_term($details) {
@@ -362,6 +393,7 @@ function tripal_get_term_details($vocabulary, $accession) {
     }
   }
 }
+
 /**
  * Retrieves the immediate children of the given term.
  *
@@ -394,6 +426,7 @@ function tripal_get_vocabulary_root_terms($vocabulary) {
     }
   }
 }
+
 /**
  * Retrieves the immediate children of the given term.
  *
@@ -423,6 +456,7 @@ function tripal_get_term_children($vocabulary, $accession) {
     }
   }
 }
+
 /**
  * Retrieves full information about a vocabulary.
  *
@@ -477,6 +511,8 @@ function tripal_get_vocabulary_details($vocabulary) {
  * @param $element
  *   The pager element. This is equivalent to the element from the
  *   pager_default_initialize() function of Drupal.
+ * 
+ * @ingroup tripal_terms_api
  */
 function tripal_get_vocabulary_terms($vocabulary, $limit = 25, $element = 0) {
   $stores = module_invoke_all('vocab_storage_info');
@@ -497,6 +533,8 @@ function tripal_get_vocabulary_terms($vocabulary, $limit = 25, $element = 0) {
  *   An array of vocabularies where each entry in the array is compatible
  *   with the array returned by the tripal_get_vocabulary_details()
  *   function.
+ * 
+ * @ingroup tripal_terms_api
  */
 function tripal_get_vocabularies() {
   $stores = module_invoke_all('vocab_storage_info');
@@ -520,7 +558,7 @@ function tripal_get_vocabularies() {
  * multiple vocabularies and the user would need to select the proper term.
  *
  * This function will add the form elements necessary to provide a lookup form.
- * The form elements should work with a flat fortm (no #tree set for the form)
+ * The form elements should work with a flat form (no #tree set for the form)
  * or with a form in a TripalField.
  *
  * Use the tripal_get_term_lookup_form_result() function to retreive the
@@ -716,4 +754,4 @@ function tripal_get_term_lookup_form_ajax_callback($form, $form_state) {
   else {
     return $form['term_match'];
   }
-}
+}

tripal/api/tripal.upload.api.inc

@@ -90,7 +90,8 @@
  * file by querying for the file category for the current project.
  *
  * @code
- *   $seq_files = TripalFeature::getFilesByTypes($user->uid, array('sequence_file'), $project_id);
+ *   $seq_files = TripalFeature::getFilesByTypes($user->uid, 
+ *                   array('sequence_file'), $project_id);
  * @endcode
  *
  * 4) If the 'target_id' was used in array for step #2 above, then the
@@ -140,4 +141,4 @@ function hook_file_upload_check($action, $details, &$message){
       break;
   }
   return TRUE;
-}
+}

tripal/includes/tripal.extensions.inc

@@ -361,7 +361,7 @@ function tripal_extension_form_add_extensions(&$form, $form_state, $extensions,
           }
           break;
         case 'Materialized View':
-          $mview_id = tripal_get_mview_id($extension[$namespace]['mview_name']);
+          $mview_id = chado_get_mview_id($extension[$namespace]['mview_name']);
           if ($mview_id) {
             $is_installed = '<li>A materialized view with this name is already installed.</li>';
           }
@@ -570,7 +570,7 @@ function tripal_extensions_form_submit($form, &$form_state) {
         if ($error) {
           drupal_set_message("Cannot import Materialized View: $error", "error");
         }
-        tripal_add_mview($mview_name, $module_name, $schema_array, $mview_sql);
+        chado_add_mview($mview_name, $module_name, $schema_array, $mview_sql);
         break;
       case 'Extension Module':
         if (array_key_exists('drupal_project', $extension[$namespace])) {

tripal_bulk_loader/api/tripal_bulk_loader.api.templates.inc

@@ -10,7 +10,8 @@
  * @defgroup tripal_bulk_loader_api Bulk Loader
  * @ingroup tripal_api
  * @{
- * All functions in this file provide an API to administrative management of bulk loader templates
+ * All functions in this file provide an API to administrative management of 
+ * bulk loader templates.
  * @}
  */
 
@@ -21,10 +22,10 @@
  *   The type of validation. Can be either 'insert' or 'update'.
  * @param $options
  *   An array of key/value pairs containing the following keys:
- *     'template_name':   The name of the template.
- *     'template_array':  The JSON array representing the template.
- *   Optional:
- *     'strict':          If set then only JSON formatted templates are allowed.
+ *     template_name: The name of the template.
+ *     template_array: The JSON array representing the template.
+ *     Optional:
+ *      strict: If set then only JSON formatted templates are allowed.
  * @param $errors
  *   An empty array where validation error messages will be set. The keys
  *   of the array will be name of the field from the options array and the
@@ -42,6 +43,7 @@
  *   the option and the value being the error message.  If validation
  *   is successful then TRUE is returned.
  *
+ *  @ingroup tripal_bulk_loader_api
  */
 function tripal_validate_bulk_loader_template($val_type, &$options, &$errors, &$warnings = array()) {
   $template_array = trim($options['template_array']);
@@ -105,7 +107,7 @@ function tripal_validate_bulk_loader_template($val_type, &$options, &$errors, &$
 /**
  * Inserts a bulk loader template record.
  *
- * This function validates the options passed prior to insertion of the record,
+ * This function validates the options passed prior to insertion of the record.
  *
  * @param $options
  *   An array of key/value pairs containing the following keys:
@@ -125,6 +127,8 @@ function tripal_validate_bulk_loader_template($val_type, &$options, &$errors, &$
  *   value is the error message.
  * @return
  *   TRUE for success and FALSE for failure.
+ * 
+ *  @ingroup tripal_bulk_loader_api
  */
 function tripal_insert_bulk_loader_template($options, &$errors, &$warnings) {
 
@@ -178,20 +182,23 @@ function tripal_insert_bulk_loader_template($options, &$errors, &$warnings) {
 }
 
 /**
- * Meant to be called from a form_validate function to ensure a newly added bulk loader record
- * name is unique and not empty.
+ * Meant to be called from a form_validate function to ensure a newly added bulk 
+ * loader record name is unique and not empty.
  *
  * @param $new_record_name
  *   The record name to check for uniqueness
  * @param $template_id
  *   The template_id of the template to add the record to
  * @param $template_array
- *   The array describing the template. Optional -will be loaded using template_id if not provided
+ *   The array describing the template. Optional -will be loaded using 
+ *   template_id if not provided
  * @param $current_priority
- *   The priority of the already existing record -checks that the name only occurs on this particular record
+ *   The priority of the already existing record -checks that the name only 
+ *   occurs on this particular record
  *
  * @return
- *   TRUE if the record name is not empty and not already in the template_array; FALSE otherwise
+ *   TRUE if the record name is not empty and not already in the template_array; 
+ *   FALSE otherwise
  *
  * @ingroup tripal_bulk_loader_api
  */

tripal_chado/api/generate_chado_schema_file.php

@@ -11,16 +11,16 @@
  *
  * @code
  *'chado' => array(
-    'default' => array(
-      'database' => 'd7x_t2x_c13',
-      'username' => 'chado',
-      'password' => 'testing123',
-      'host' => 'localhost',
-      'port' => '',
-      'driver' => 'pgsql',
-      'prefix' => '',
-    ),
-  ),
+ *   'default' => array(
+ *     'database' => 'd7x_t2x_c13',
+ *     'username' => 'chado',
+ *     'password' => 'testing123',
+ *     'host' => 'localhost',
+ *     'port' => '',
+ *     'driver' => 'pgsql',
+ *     'prefix' => '',
+ *   ),
+ * ),
  * @endcode
  *
  * This script requires a single argument (-v) which is the Chado version.

tripal_chado/api/modules/tripal_chado.analysis.api.inc

@@ -1,7 +1,7 @@
 <?php
 /**
  * @file
- * Provides functions for managing analysis'.
+ * Provides API functions specificially for managing analysis records in Chado.
  *
  * @ingroup tripal_chado
  */
@@ -10,45 +10,47 @@
  * @defgroup tripal_analysis_api Chado Analysis
  * @ingroup tripal_chado_api
  * @{
-
+ * Provides API functions for working with analysis records in Chado that
+ * go beyond the generic Chado API functions.
  * @}
  */
 
 
 /**
- * Retrieves an chado analysis variable
+ * Retrieves a chado analysis variable.
  *
  * @param $itentifier
- *   an array with the key stating what the identifier is. Supported keys (only on of the
- *   following unique keys is required):
- *    - analysis_id: the chado analysis.analysis_id primary key
- *    - nid: the drupal node.nid primary key
+ *   an array with the key stating what the identifier is. Supported keys 
+ *   (only on of the following unique keys is required):
+ *    - analysis_id: the chado analysis.analysis_id primary key.
+ *    - nid: the drupal node.nid primary key.
  *   There are also some specially handled keys. They are:
- *    - property: An array/object describing the property to select records for. It
- *      should at least have either a type_name (if unique across cvs) or type_id. Other
- *      supported keys include: cv_id/cv_name (of the type), value and rank
+ *    - property: An array/object describing the property to select records for. 
+ *      It should at least have either a type_name (if unique across cvs) or 
+ *      type_id. Other supported keys include: cv_id/cv_name (of the type), 
+ *      value and rank.
+ *   NOTE: the $identifier parameter can be any array similar to $values 
+ *   passed into chado_select_record(). It should fully specify the stock record 
+ *   to be returned.
  * @param $options
  *   An array of options. Supported keys include:
- *     - Any keys supported by chado_generate_var(). See that function definition for
- *       additional details.
- *
- * NOTE: the $identifier parameter can really be any array similar to $values passed into
- *   chado_select_record(). It should fully specify the stock record to be returned.
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition for additional details.
  *
  * @return
  *   the analysis node matching the passed in identifier
  *
  * @ingroup tripal_analysis_api
  */
-function tripal_get_analysis($identifier, $options) {
+function chado_get_analysis($identifier, $options) {
 
   // Set Defaults
   if (!isset($options['include_fk'])) {
-    // Tells chado_generate_var not to follow any foreign keys
+    // Tells chado_generate_var not to follow any foreign keys.
     $options['include_fk'] = array();
   }
 
-  // Error Checking of parameters
+  // Error Checking of parameters.
   if (!is_array($identifiers)) {
     tripal_report_error(
       'tripal_stock_api',
@@ -73,7 +75,7 @@ function tripal_get_analysis($identifier, $options) {
     );
   }
 
-  // If one of the identifiers is property then use chado_get_record_with_property()
+  // If one of the identifiers is property then use chado_get_record_with_property().
   if (isset($identifiers['property'])) {
     $property = $identifiers['property'];
     unset($identifiers['property']);
@@ -83,7 +85,8 @@ function tripal_get_analysis($identifier, $options) {
     );
   }
 
-  // Else we have a simple case and we can just use chado_generate_var to get the analysis
+  // Else we have a simple case and we can just use chado_generate_var to get 
+  // the analysis.
   else {
 
     // Try to get the analysis
@@ -94,24 +97,25 @@ function tripal_get_analysis($identifier, $options) {
     );
   }
 
-  // Ensure the analysis is singular. If it's an array then it is not singular
+  // Ensure the analysis is singular. If it's an array then it is not singular.
   if (is_array($analysis)) {
     tripal_report_error(
       'tripal_analysis_api',
       TRIPAL_ERROR,
-      "tripal_get_analysis: The identifiers you passed in were not unique. You passed in %identifier.",
+      "chado_get_analysis: The identifiers you passed in were not unique. You passed in %identifier.",
       array(
         '%identifier'=> print_r($identifiers, TRUE)
       )
     );
   }
 
-  // Report an error if $analysis is FALSE since then chado_generate_var has failed
+  // Report an error if $analysis is FALSE since then chado_generate_var has 
+  // failed.
   elseif ($analysis === FALSE) {
     tripal_report_error(
       'tripal_analysis_api',
       TRIPAL_ERROR,
-      "tripal_get_analysis: chado_generate_var() failed to return a analysis based on the identifiers
+      "chado_get_analysis: chado_generate_var() failed to return a analysis based on the identifiers
         you passed in. You should check that your identifiers are correct, as well as, look
         for a chado_generate_var error for additional clues. You passed in %identifier.",
       array(
@@ -126,18 +130,19 @@ function tripal_get_analysis($identifier, $options) {
   }
 }
 /**
- * Returns a list of analyses that are currently synced with Drupal to use in select lists
+ * Returns a list of analyses that are currently synced with Drupal to use in 
+ * select lists.
  *
  * @param $syncd_only
- *   Whether or not to return all chado analyses or just those sync'd with drupal. Defaults
- *   to TRUE (only sync'd analyses)
+ *   Whether or not to return all chado analyses or just those sync'd with 
+ *   drupal. Defaults to TRUE (only sync'd analyses).
  * @return
- *   An array of analyses sync'd with Drupal where each value is the analysis scientific
- *   name and the keys are analysis_id's
+ *   An array of analyses sync'd with Drupal where each value is the analysis 
+ *   scientific name and the keys are analysis_id's.
  *
  * @ingroup tripal_analysis_api
  */
-function tripal_get_analysis_select_options($syncd_only = TRUE) {
+function chado_get_analysis_select_options($syncd_only = TRUE) {
   $analysis_list = array();
   $analysis_list[] = 'Select an analysis';
 
@@ -150,7 +155,7 @@ function tripal_get_analysis_select_options($syncd_only = TRUE) {
     ";
     $analyses = chado_query($sql);
 
-    // iterate through the analyses and build an array of those that are synced
+    // iterate through the analyses and build an array of those that are synced.
     foreach ($analyses as $analysis) {
       $analysis_list[$analysis->analysis_id] = $analysis->name;
     }
@@ -160,7 +165,7 @@ function tripal_get_analysis_select_options($syncd_only = TRUE) {
     $csql =  "SELECT * FROM {analysis} ORDER BY name";
     $analyses = chado_query($csql);
 
-    // iterate through the analyses and build an array of those that are synced
+    // iterate through the analyses and build an array of those that are synced.
     foreach ($analyses as $analysis) {
       $analysis_list[$analysis->analysis_id] = $analysis->name;
     }

tripal_chado/api/modules/tripal_chado.contact.api.inc

@@ -1,7 +1,7 @@
 <?php
 /**
  * @file
- * Functions to interact with contacts.
+ * Provides API functions specificially for managing contact records in Chado.
  *
  * @ingroup tripal_chado
  */
@@ -10,29 +10,32 @@
  * @defgroup tripal_contact_api Chado Contact
  * @ingroup tripal_chado_api
  * @{
+ * Provides API functions for working with chado records in Chado that
+ * go beyond the generic Chado API functions.
  * @}
  */
 
 /**
- * Adds a contact to the Chado contact table
+ * Adds a contact to the Chado contact table.
  *
  * @param $values
  *   An array of values to be inserted. Valid keys include:
- *   - name: The name of the contact
- *   - description: Text describing the contact
- *   - type_name: The type of contact.  Must be a term in the tripal_contact vocabulary
- *   - properties: An associative array containing a list of key value pairs for the properites.
- *     The key's must be valid terms in the tripal_contact vocabulary (e.g. Affiliation,
- *     Address, etc).
+ *   - name: The name of the contact.
+ *   - description: Text describing the contact.
+ *   - type_name: The type of contact.  Must be a term in the tripal_contact 
+ *     vocabulary.
+ *   - properties: An associative array containing a list of key value pairs for
+ *     the properites. The key's must be valid terms in the tripal_contact 
+ *     vocabulary (e.g. Affiliation, Address, etc).
  *
  * @return
  *   On success, an array is returned containing the fields of the contact
  *   record including the newly added contact_id. On failure, FALSE is
- *   returned
+ *   returned.
  *
  * @ingroup tripal_contact_api
  */
-function tripal_insert_contact($values) {
+function chado_insert_contact($values) {
 
   $name = $values['name'];
   $description = $values['description'];
@@ -45,7 +48,7 @@ function tripal_insert_contact($values) {
   $contact = chado_select_record('contact', array('contact_id'), $values, $options);
 
   if (count($contact) == 0) {
-    $cvterm = tripal_get_cvterm(array(
+    $cvterm = chado_get_cvterm(array(
       'name' => $type,
       'cv_id' => array('name' => 'tripal_contact')
     ));
@@ -115,14 +118,14 @@ function tripal_insert_contact($values) {
  * This function is intended to be used in autocomplete forms for contacts.
  *
  * @param $text
- *   The string to search for
+ *   The string to search for.
  *
  * @return
- *   A json array of terms that begin with the provided string
+ *   A json array of terms that begin with the provided string.
  *
  * @ingroup tripal_contact_api
  */
-function tripal_autocomplete_contact($text) {
+function chado_autocomplete_contact($text) {
   $matches = array();
 
   $sql = "SELECT * FROM {contact} WHERE lower(name) like lower(:name) ";
@@ -140,4 +143,4 @@ function tripal_autocomplete_contact($text) {
     $items[$contact->name] = $contact->name;
   }
   drupal_json_output($items);
-}
+}

tripal_chado/api/modules/tripal_chado.cv.api.inc

@@ -1,9 +1,9 @@
 <?php
 /**
  * @file
- * This module provides a set of functions to simplify working with
- * controlled vocabularies.
- *
+ * Provides API functions specificially for managing controlled vocabulary
+ * records in Chado.  
+ * 
  * @ingroup tripal_chado
  */
 
@@ -11,6 +11,12 @@
  * @defgroup tripal_chado_cv_api Chado CV
  * @ingroup tripal_chado_api
  * @{
+ * Provides API functions specificially for managing controlled vocabulary
+ * records in Chado. Please note that Tripal v3 provides a generic set of 
+ * API functions for working with controlled vocabularies (CVs). This allows for
+ * CVs to be stored using any back-end.  By default CV's continue to be housed
+ * in Chado.  Therefore, if you are working directly with controlled vocabulary
+ * records inside of a Chado-aware module then these functions can be used. 
  * @}
  */
 
@@ -18,39 +24,40 @@
  * Retrieves a chado controlled vocabulary variable
  *
  * @param $identifier
- *   An array with the key stating what the identifier is. Supported keys (only on of the
- *   following unique keys is required):
- *    - cv_id: the chado cv.cv_id primary key
- *    - name: the chado cv.name field (assume unique)
+ *   An array with the key stating what the identifier is. Supported keys (only 
+ *   on of the following unique keys is required):
+ *    - cv_id: the chado cv.cv_id primary key.
+ *    - name: the chado cv.name field (assume unique).
  * @param $options
  *   An array of options. Supported keys include:
- *     - Any keys supported by chado_generate_var(). See that function definition for
- *       additional details.
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition fot additional details.
  *
- * NOTE: the $identifier parameter can really be any array similar to $values passed into
- *   chado_select_record(). It should fully specify the cv record to be returned.
+ * NOTE: the $identifier parameter can really be any array similar to $values 
+ * passed into chado_select_record(). It should fully specify the cv record to 
+ * be returned.
  *
  * @return
- *   If unique values were passed in as an identifier then an object describing the cv
- *   will be returned (will be a chado variable from chado_generate_var()). Otherwise,
- *   FALSE will be returned.
+ *   If unique values were passed in as an identifier then an object describing 
+ *   the cv will be returned (will be a chado variable from 
+ *   chado_generate_var()). Otherwise, FALSE will be returned.
  *
  * @ingroup tripal_chado_cv_api
  */
-function tripal_get_cv($identifiers, $options = array()) {
+function chado_get_cv($identifiers, $options = array()) {
 
-  // Set Defaults
+  // Set Defaults.
   if (!isset($options['include_fk'])) {
-    // Tells chado_generate_var not to follow any foreign keys
+    // Tells chado_generate_var not to follow any foreign keys.
     $options['include_fk'] = array();
   }
 
-  // Error Checking of parameters
+  // Error Checking of parameters.
   if (!is_array($identifiers)) {
     tripal_report_error(
       'tripal_chado_api',
       TRIPAL_ERROR,
-      "tripal_get_cv: The identifier passed in is expected to be an array with the key
+      "chado_get_cv: The identifier passed in is expected to be an array with the key
         matching a column name in the cv table (ie: cv_id or name). You passed in %identifier.",
       array(
         '%identifier'=> print_r($identifiers, TRUE)
@@ -61,7 +68,7 @@ function tripal_get_cv($identifiers, $options = array()) {
     tripal_report_error(
       'tripal_chado_api',
       TRIPAL_ERROR,
-      "tripal_get_cv: You did not pass in anything to identify the cv you want. The identifier
+      "chado_get_cv: You did not pass in anything to identify the cv you want. The identifier
         is expected to be an array with the key matching a column name in the cv table
         (ie: cv_id or name). You passed in %identifier.",
       array(
@@ -70,31 +77,31 @@ function tripal_get_cv($identifiers, $options = array()) {
     );
   }
 
-  // Try to get the cv
+  // Try to get the cv.
   $cv = chado_generate_var(
     'cv',
     $identifiers,
     $options
   );
 
-  // Ensure the cv is singular. If it's an array then it is not singular
+  // Ensure the cv is singular. If it's an array then it is not singular.
   if (is_array($cv)) {
     tripal_report_error(
       'tripal_chado_api',
       TRIPAL_ERROR,
-      "tripal_get_cv: The identifiers you passed in were not unique. You passed in %identifier.",
+      "chado_get_cv: The identifiers you passed in were not unique. You passed in %identifier.",
       array(
         '%identifier'=> print_r($identifiers, TRUE)
       )
     );
   }
 
-  // Report an error if $cv is FALSE since then chado_generate_var has failed
+  // Report an error if $cv is FALSE since then chado_generate_var has failed.
   elseif ($cv === FALSE) {
     tripal_report_error(
       'tripal_chado_api',
       TRIPAL_ERROR,
-      "tripal_get_cv: chado_generate_var() failed to return a cv based on the identifiers
+      "chado_get_cv: chado_generate_var() failed to return a cv based on the identifiers
         you passed in. You should check that your identifiers are correct, as well as, look
         for a chado_generate_var error for additional clues. You passed in %identifier.",
       array(
@@ -111,14 +118,14 @@ function tripal_get_cv($identifiers, $options = array()) {
 
 /**
  * Create an options array to be used in a form element which provides a
- * list of all chado cvs
+ * list of all chado cvs.
  *
  * @return
- *   An array(cv_id => name) for each cv in the chado cv table
+ *   An array(cv_id => name) for each cv in the chado cv table.
  *
  * @ingroup tripal_chado_cv_api
  */
-function tripal_get_cv_select_options() {
+function chado_get_cv_select_options() {
 
   $results = chado_select_record('cv', array('cv_id', 'name'), array(), array('order_by' => array('name' => 'ASC')));
 
@@ -134,7 +141,7 @@ function tripal_get_cv_select_options() {
 }
 
 /**
- * Retrieves a chado controlled vocabulary term variable
+ * Retrieves a chado controlled vocabulary term variable.
  *
  * @param $identifier
  *   An array apropriate for use with the chado_generate_var for uniquely
@@ -146,11 +153,11 @@ function tripal_get_cv_select_options() {
  *      name of the cv.
  *    - synonym: an array with 'name' => the name of the synonym of the cvterm
  *      you want returned; 'cv_id' => the cv_id of the synonym; 'cv_name' =>
- *      the name of the cv of the synonym
+ *      the name of the cv of the synonym.
  *    - property: An array/object describing the property to select records
  *      for. It should at least have either a type_name (if unique across cvs)
  *      or type_id. Other supported keys include: cv_id/cv_name (of the type),
- *      value and rank
+ *      value and rank.
  * @param $options
  *   An array of options. Supported keys include:
  *     - Any keys supported by chado_generate_var(). See that function
@@ -167,32 +174,33 @@ function tripal_get_cv_select_options() {
  *
  * @ingroup tripal_chado_cv_api
  */
-function tripal_get_cvterm($identifiers, $options = array()) {
+function chado_get_cvterm($identifiers, $options = array()) {
 
-  // Set Defaults
+  // Set Defaults.
   if (!isset($options['include_fk'])) {
-    // Tells chado_generate_var to only get the cv
+    // Tells chado_generate_var to only get the cv.
     $options['include_fk'] = array('cv_id' => TRUE);
   }
 
-  // Error Checking of parameters
+  // Error Checking of parameters.
   if (!is_array($identifiers)) {
     tripal_report_error('tripal_cv_api', TRIPAL_ERROR,
-      "tripal_get_cvterm: The identifier passed in is expected to be an array with the key
+      "chado_get_cvterm: The identifier passed in is expected to be an array with the key
         matching a column name in the cvterm table (ie: cvterm_id or name). You passed in %identifier.",
       array('%identifier'=> print_r($identifiers, TRUE))
     );
   }
   elseif (empty($identifiers)) {
     tripal_report_error('tripal_cv_api', TRIPAL_ERROR,
-      "tripal_get_cvterm: You did not pass in anything to identify the cvterm you want. The identifier
+      "chado_get_cvterm: You did not pass in anything to identify the cvterm you want. The identifier
         is expected to be an array with the key matching a column name in the cvterm table
         (ie: cvterm_id or name). You passed in %identifier.",
       array('%identifier'=> print_r($identifiers, TRUE))
     );
   }
 
-  // If synonym was passed in, then process this first before calling chado_generate_var()
+  // If synonym was passed in, then process this first before calling 
+  // chado_generate_var().
   if (isset($identifiers['synonym'])) {
     $synonym = $identifiers['synonym']['name'];
 
@@ -208,7 +216,8 @@ function tripal_get_cvterm($identifiers, $options = array()) {
     );
     $result = chado_select_record('cvtermsynonym', array('cvterm_id'), $values, $options);
 
-    // if the synonym doens't exist or more than one record is returned then return false
+    // if the synonym doens't exist or more than one record is returned then 
+    // return false.
     if (count($result) == 0) {
       return FALSE;
     }
@@ -219,7 +228,7 @@ function tripal_get_cvterm($identifiers, $options = array()) {
     $identifiers = array('cvterm_id' => $result[0]->cvterm_id);
   }
 
-  // If one of the identifiers is property then use chado_get_record_with_property()
+  // If one of the identifiers is property then use chado_get_record_with_property().
   if (isset($identifiers['property'])) {
     $property = $identifiers['property'];
     unset($identifiers['property']);
@@ -241,30 +250,32 @@ function tripal_get_cvterm($identifiers, $options = array()) {
     ));
   }
 
-  // Else we have a simple case and we can just use chado_generate_var to get the cvterm
+  // Else we have a simple case and we can just use chado_generate_var to get 
+  // the cvterm.
   else {
-    // Try to get the cvterm
+    // Try to get the cvterm.
     $cvterm = chado_generate_var('cvterm', $identifiers, $options);
   }
 
-  // Ensure the cvterm is singular. If it's an array then it is not singular
+  // Ensure the cvterm is singular. If it's an array then it is not singular.
   if (is_array($cvterm)) {
     tripal_report_error(
       'tripal_cv_api',
       TRIPAL_ERROR,
-      "tripal_get_cvterm: The identifiers you passed in were not unique. You passed in %identifier.",
+      "chado_get_cvterm: The identifiers you passed in were not unique. You passed in %identifier.",
       array(
         '%identifier'=> print_r($identifiers, TRUE)
       )
     );
   }
 
-  // Report an error if $cvterm is FALSE since then chado_generate_var has failed
+  // Report an error if $cvterm is FALSE since then chado_generate_var has 
+  // failed.
   elseif ($cvterm === FALSE) {
     tripal_report_error(
       'tripal_cv_api',
       TRIPAL_ERROR,
-      "tripal_get_cvterm: chado_generate_var() failed to return a cvterm based on the identifiers
+      "chado_get_cvterm: chado_generate_var() failed to return a cvterm based on the identifiers
         you passed in. You should check that your identifiers are correct, as well as, look
         for a chado_generate_var error for additional clues. You passed in %identifier.",
       array(
@@ -282,10 +293,10 @@ function tripal_get_cvterm($identifiers, $options = array()) {
 
 /**
  * Create an options array to be used in a form element
- *   which provides a list of all chado cvterms
+ *   which provides a list of all chado cvterms.
  *
  * @param $cv_id
- *   The chado cv_id; only cvterms with the supplied cv_id will be returned
+ *   The chado cv_id; only cvterms with the supplied cv_id will be returnedl.
  * @param $rel_type
  *   Set to TRUE if the terms returned should only be relationship types in
  *   the vocabulary.  This is useful for creating drop-downs of terms
@@ -293,11 +304,11 @@ function tripal_get_cvterm($identifiers, $options = array()) {
  *
  * @return
  *   An associative array with the cvterm_id's as keys. The first
- *   element in the array has a key of '0' and a value of 'Select a Type'
+ *   element in the array has a key of '0' and a value of 'Select a Type'.
  *
  * @ingroup tripal_chado_cv_api
  */
-function tripal_get_cvterm_select_options($cv_id, $rel_type = FALSE) {
+function chado_get_cvterm_select_options($cv_id, $rel_type = FALSE) {
   $columns = array('cvterm_id', 'name');
   $values = array('cv_id' => $cv_id);
   if ($rel_type) {
@@ -321,20 +332,20 @@ function tripal_get_cvterm_select_options($cv_id, $rel_type = FALSE) {
  * Updates the cvtermpath table of Chado for the specified CV.
  *
  * @param $cv_id
- *   The chado cv_id;
+ *   The chado cv_id.
  * @param $job_id
  *   This function is intended to be used with the Tripal Jobs API.
  *   When this function is called as a job the $job_id is automatically
  *   passed to this function.
  * @return
- *   TRUE on success FALSE on failure
+ *   TRUE on success FALSE on failure.
  *
  * @ingroup tripal_chado_cv_api
  */
 function tripal_update_cvtermpath_old($cv_id, $job_id = NULL) {
   // TODO: need better error checking in this function
 
-  // first get the controlled vocabulary name:
+  // First get the controlled vocabulary name:
   $sql = "SELECT * FROM {cv} WHERE cv_id = :cv_id";
   $cv = chado_query($sql, array(':cv_id' => $cv_id))->fetchObject();
 
@@ -363,7 +374,7 @@ function tripal_update_cvtermpath_old($cv_id, $job_id = NULL) {
  *
  * Identifies all of the root terms of the controlled vocabulary. These
  * root terms are then processed by calling the
- * tripal_update_cvtermpath_root_loop() function on each one.
+ * _chado_update_cvtermpath_root_loop() function on each one.
  *
  * @param $cvid
  *   The controlled vocabulary ID from the cv table of Chado (i.e. cv.cv_id).
@@ -371,7 +382,7 @@ function tripal_update_cvtermpath_old($cv_id, $job_id = NULL) {
  *
  * @ingroup tripal_chado_cv_api
  */
-function tripal_update_cvtermpath($cv_id, $job_id = NULL){
+function chado_update_cvtermpath($cv_id, $job_id = NULL){
   // TODO: there's a function to determine the current Chado instance.
   // we should use that.
   $prev_db = chado_set_active('chado');
@@ -390,7 +401,7 @@ function tripal_update_cvtermpath($cv_id, $job_id = NULL){
     $roots = [];
 
     foreach ($record as $item){
-      tripal_update_cvtermpath_root_loop($item->cvterm_id, $item->cv_id, $roots);
+      _chado_update_cvtermpath_root_loop($item->cvterm_id, $item->cv_id, $roots);
     }
   }
   catch (Exception $e) {
@@ -416,14 +427,7 @@ function tripal_update_cvtermpath($cv_id, $job_id = NULL){
  *
  * @ingroup tripal_chado_cv_api
  */
-function tripal_update_cvtermpath_root_loop($rootid, $cvid, &$roots) {
-  // Get's the cvterm record for this "root".
-  // $ttype = db_select('cvterm', 'cv')
-  //         ->fields('cv', array('cvterm_id'));
-  // $db_or = db_or();
-  // $db_or->condition('cv.name', "isa", '=');
-  // $db_or->condition('cv.name', "is_a", '=');
-  // $ttype->condition($db_or);
+function _chado_update_cvtermpath_root_loop($rootid, $cvid, &$roots) {
   $ttype = db_query(
     'SELECT cv.cvterm_id 
     FROM cvterm cv
@@ -450,7 +454,7 @@ function tripal_update_cvtermpath_root_loop($rootid, $cvid, &$roots) {
   $matched_rows = [];
   $possible_start_of_loop = [];
   $depth = 0;
-  tripal_update_cvtermpath_loop($rootid, $rootid, $cvid, $result->cvterm_id, $depth,
+  _chado_update_cvtermpath_loop($rootid, $rootid, $cvid, $result->cvterm_id, $depth,
                                 0, $tree_path, FALSE, $matched_rows, $possible_start_of_loop, FALSE);
 
   // Get's the children terms of this "root" term and then recursively calls
@@ -463,7 +467,7 @@ function tripal_update_cvtermpath_root_loop($rootid, $cvid, &$roots) {
     [':rootid' => $rootid]
   );
   while ($cterm_result = $cterm->fetchAssoc()) {
-    tripal_update_cvtermpath_root_loop($cterm_result['subject_id'], $cvid, $roots);
+    _chado_update_cvtermpath_root_loop($cterm_result['subject_id'], $cvid, $roots);
   }
 }
 
@@ -481,7 +485,7 @@ function tripal_update_cvtermpath_root_loop($rootid, $cvid, &$roots) {
  * @param $depth
  *   The depth of the recursion.
  * @param $increment_of_depth.
- *   An integer ??
+ *   An integer tailing the number of children that have been walked down.
  * @param $tree_path.
  *   The array of every term between the current child and the origin. Each
  *   element in the array is an associative array with the keys:
@@ -494,8 +498,8 @@ function tripal_update_cvtermpath_root_loop($rootid, $cvid, &$roots) {
  *    An array of rows that are currently in the cvtermpath table that match the
  *    build_id of the current term trying to be written to the table
  * @param $possible_start_of_ loop
- *    The array of the possible loop item between the current child and the origin.
- *    Each element in the array is an associative array with the keys:
+ *    The array of the possible loop item between the current child and the 
+ *    origin. Each element in the array is an associative array with the keys:
  *     - cvid : $cv_id
  *     - subject_id:
  *     - child_id : $child_id,
@@ -503,9 +507,11 @@ function tripal_update_cvtermpath_root_loop($rootid, $cvid, &$roots) {
  *     - depth : $depth,
  * @param $no_loop_skip_test
  *     A boolean used when the possible loop has been ruled out as a loop.
- * @return multitype:
+ * 
+ * 
+ * @ingroup tripal_chado_cv_api
  */
-function tripal_update_cvtermpath_loop(
+function _chado_update_cvtermpath_loop(
   $origin,
   $child_id,
   $cv_id,
@@ -551,7 +557,7 @@ function tripal_update_cvtermpath_loop(
         // and confirmed that this is a loop.
         $possible_loop == FALSE;
         $matched_rows = [];
-        tripal_update_cvtermpath_loop_increment($origin, $child_id, $cv_id,
+        _chado_update_cvtermpath_loop_increment($origin, $child_id, $cv_id,
         $type_id, $depth + 1, $increment_of_depth, $tree_path, $possible_loop,
         $new_match_rows, $possible_start_of_loop, $no_loop_skip_test);
 
@@ -588,7 +594,7 @@ function tripal_update_cvtermpath_loop(
           // and confirmed that this is a loop.
           $possible_loop == FALSE;
           $matched_rows = [];
-          tripal_update_cvtermpath_loop_increment($origin, $child_id, $cv_id,
+          _chado_update_cvtermpath_loop_increment($origin, $child_id, $cv_id,
           $type_id, $depth + 1, $increment_of_depth, $tree_path, $possible_loop,
           $new_match_rows, $possible_start_of_loop, $no_loop_skip_test);
 
@@ -603,7 +609,7 @@ function tripal_update_cvtermpath_loop(
       $no_loop_skip_test = TRUE;
       // There is not loop so pass it back the possible_start_of_loop info
       // and a flag telling it to skip the loop check.
-      tripal_update_cvtermpath_loop_increment($possible_start_of_loop->subject_id,
+      _chado_update_cvtermpath_loop_increment($possible_start_of_loop->subject_id,
       $possible_start_of_loop->child_id, $possible_start_of_loop->cvid,
       $possible_start_of_loop->type_id, $possible_start_of_loop->depth,
       $increment_of_depth, $tree_path, $possible_loop, $matched_rows,
@@ -611,13 +617,13 @@ function tripal_update_cvtermpath_loop(
     }
     // If $match_rows is not empty we need to keep trying rows.
     else {
-      tripal_update_cvtermpath_loop_increment($origin, $child_id, $cv_id,
+      _chado_update_cvtermpath_loop_increment($origin, $child_id, $cv_id,
       $type_id, $depth + 1, $increment_of_depth, $tree_path, $possible_loop,
       $match_rows, $possible_start_of_loop, $no_loop_skip_test);
     }
   }
   elseif ($possible_loop === FALSE) {
-    tripal_update_cvtermpath_loop_increment($origin, $child_id, $cv_id,
+    _chado_update_cvtermpath_loop_increment($origin, $child_id, $cv_id,
     $type_id, $depth + 1, $increment_of_depth, $tree_path, $possible_loop,
     $matched_rows, $possible_start_of_loop, $no_loop_skip_test);
   }
@@ -637,7 +643,7 @@ function tripal_update_cvtermpath_loop(
  * @param $depth
  *   The depth of the recursion.
  * @param $increment_of_depth.
- *   An integer ??
+ *   An integer.
  * @param $tree_path.
  *   The array of every term between the current child and the origin. Each
  *   element in the array is an associative array with the keys:
@@ -659,9 +665,12 @@ function tripal_update_cvtermpath_loop(
  *     - depth : $depth,
  * @param $no_loop_skip_test
  *     A boolean used when the possible loop has been ruled out as a loop.
- * @return multitype:
+ * @return multitype: Either a number that represents the row count of existing 
+ * rows that already match these specification or a Boolean false.
+ * 
+ * @ingroup tripal_chado_cv_api
  */
-function tripal_update_cvtermpath_loop_increment(
+function _chado_update_cvtermpath_loop_increment(
   $origin,
   $child_id,
   $cv_id,
@@ -701,17 +710,19 @@ function tripal_update_cvtermpath_loop_increment(
     $term_id = $origin . '|' . $child_id . '|' . $cv_id . '|' . $type_id;
 
     if ($no_loop_skip_test === FALSE) {
-      // If the increment of depth is 0 then it's the first time and we need to skip
-      // the test so we can build the tree_path which will be tested against.
+      // If the increment of depth is 0 then it's the first time and we need to 
+      // skip the test so we can build the tree_path which will be tested against.
       if ($increment_of_depth != 0) {
         // Search the $tree_path for the new $child_id in the build_id column.
         foreach ($tree_path as $parent) {
           // If this child is the same as a parent term that has already been
           // processed then we have a potential loop.
           if ($parent['build_id'] == $term_id) {
-            // Tell the function this is a possible loop and to stop writing to the table.
+            // Tell the function this is a possible loop and to stop writing to 
+            // the table.
             $possible_loop = TRUE;
-            // Find all the results in the table that might be the start of the loop.
+            // Find all the results in the table that might be the start of the 
+            // loop.
             $matching_rows = db_query(
               ' SELECT *
                 FROM cvtermpath
@@ -776,7 +787,7 @@ function tripal_update_cvtermpath_loop_increment(
     $possible_start_of_loop = [];
 
     // Get all of the relationships of this child term, and recursively
-    // call the tripal_update_cvtermpath_loop_increment() function to continue
+    // call the _chado_update_cvtermpath_loop_increment() function to continue
     // descending down the tree.
     $query = db_select('cvterm_relationship', 'cvtr')
       ->fields('cvtr')
@@ -786,7 +797,7 @@ function tripal_update_cvtermpath_loop_increment(
 
     foreach ($cterm_relationships as $item) {
       $increment_of_depth++;
-      tripal_update_cvtermpath_loop_increment($origin, $item->subject_id, $cv_id,
+      _chado_update_cvtermpath_loop_increment($origin, $item->subject_id, $cv_id,
         $item->type_id, $depth + 1, $increment_of_depth, $tree_path, $possible_loop,
         $matched_rows, $possible_start_of_loop, $no_loop_skip_test);
     }
@@ -798,7 +809,7 @@ function tripal_update_cvtermpath_loop_increment(
   }
   elseif ($possible_loop === TRUE) {
     // Get all of the relationships of this child term, and recursively
-    // call the tripal_update_cvtermpath_loop() function to continue
+    // call the _chado_update_cvtermpath_loop() function to continue
     // descending down the tree.
     $query = db_select('cvterm_relationship', 'cvtr')
       ->fields('cvtr')
@@ -807,7 +818,7 @@ function tripal_update_cvtermpath_loop_increment(
     $cterm_relationships = $query->fetchAll();
     foreach ($cterm_relationships as $item) {
       $increment_of_depth++;
-      tripal_update_cvtermpath_loop($origin, $item->subject_id, $cv_id,
+      _chado_update_cvtermpath_loop($origin, $item->subject_id, $cv_id,
         $item->type_id, $depth + 1, $increment_of_depth, $tree_path, $possible_loop,
         $matched_rows, $possible_start_of_loop, $no_loop_skip_test);
     }
@@ -817,7 +828,7 @@ function tripal_update_cvtermpath_loop_increment(
 }
 
 /**
- * Adds a controlled vocabular to the CV table of Chado.
+ * Adds a controlled vocabulary to the CV table of Chado.
  *
  * @param $name
  *   The name of the controlled vocabulary. These are typically all lower case
@@ -828,21 +839,21 @@ function tripal_update_cvtermpath_loop_increment(
  * @return
  *   An object populated with fields from the newly added database.
  *
- * @ingroup tripal_chado_api
+ * @ingroup tripal_chado_cv_api
  */
-function tripal_insert_cv($name, $definition) {
+function chado_insert_cv($name, $definition) {
 
-  // insert/update values
+  // Insert/update values.
   $ins_values = array(
     'name'       => $name,
     'definition' => $definition
   );
 
-  // see if the CV default exists already in the database
+  // See if the CV default exists already in the database.
   $sel_values = array('name' => $name);
   $results = chado_select_record('cv', array('*'), $sel_values);
 
-  // if it does not exists then add it
+  // If it does not exists then add it.
   if (count($results) == 0) {
     $success = chado_insert_record('cv', $ins_values);
     if (!$success) {
@@ -851,7 +862,7 @@ function tripal_insert_cv($name, $definition) {
     }
     $results = chado_select_record('cv', array('*'), $sel_values);
   }
-  // if it already exists then do an update
+  // If it already exists then do an update.
   else {
     $success = chado_update_record('cv', $sel_values, $ins_values);
     if (!$success) {
@@ -861,7 +872,7 @@ function tripal_insert_cv($name, $definition) {
     $results = chado_select_record('cv', array('*'), $sel_values);
   }
 
-  // return the cv object
+  // Return the cv object.
   return $results[0];
 }
 
@@ -886,13 +897,13 @@ function tripal_insert_cv($name, $definition) {
  *      <DB> is the name of the database to which the cvterm belongs and the
  *      <ACCESSION> is the term's accession number in the database.
  *    - name: the name of the term. usually meant to be human-readable.
- *    - is_obsolete: is present and set to 1 if the term is defunct
- *    - definition: the definition of the term
+ *    - is_obsolete: is present and set to 1 if the term is defunct.
+ *    - definition: the definition of the term.
  *    - cv_name: The CV name to which the term belongs.  If this arugment is
  *        null or not provided then the function tries to find a record in the
  *        CV table with the same name provided in the $term[namespace].  If
  *        this field is provided then it overrides what the value in
- *        $term[namespace]
+ *        $term[namespace].
  *    - is_relationship: If this term is a relationship term then this value
  *        should be 1.
  *    - db_name: In some cases the database name will not be part of the
@@ -907,11 +918,11 @@ function tripal_insert_cv($name, $definition) {
  * @return
  *   A cvterm object
  *
- * @ingroup tripal_chado_api
+ * @ingroup tripal_chado_cv_api
  */
-function tripal_insert_cvterm($term, $options = array()) {
+function chado_insert_cvterm($term, $options = array()) {
 
-  // get the term properties
+  // Get the term properties.
   $id = (isset($term['id'])) ? $term['id'] : '';
   $name = '';
   $cvname = '';
@@ -919,7 +930,7 @@ function tripal_insert_cvterm($term, $options = array()) {
   $is_obsolete = 0;
   $accession = '';
 
-  // Set Defaults
+  // Set Defaults.
   if (isset($term['cv_name'])) {
     $cvname = $term['cv_name'];
   }
@@ -927,7 +938,7 @@ function tripal_insert_cvterm($term, $options = array()) {
     $cvname = 'local';
   }
   // Namespace is deprecated but must be supported for backwards
-  // compatability
+  // compatability.
   if (array_key_exists('namespace', $term)) {
     $cvname = $term['namespace'];
   }
@@ -1002,10 +1013,10 @@ function tripal_insert_cvterm($term, $options = array()) {
     return 0;
   }
 
-  // Make sure the CV name exists
-  $cv = tripal_get_cv(array('name' => $cvname));
+  // Make sure the CV name exists.
+  $cv = chado_get_cv(array('name' => $cvname));
   if (!$cv) {
-    $cv = tripal_insert_cv($cvname, '');
+    $cv = chado_insert_cv($cvname, '');
   }
   if (!$cv) {
     tripal_report_error('tripal_cv', TRIPAL_WARNING, "Cannot find namespace '$cvname' when adding/updating $id", NULL);
@@ -1028,9 +1039,9 @@ function tripal_insert_cvterm($term, $options = array()) {
 
   // Add the database. The function will just return the DB object if the
   // database already exists.
-  $db = tripal_get_db(array('name' => $dbname));
+  $db = chado_get_db(array('name' => $dbname));
   if (!$db) {
-    $db = tripal_insert_db(array('name' => $dbname));
+    $db = chado_insert_db(array('name' => $dbname));
   }
   if (!$db) {
     tripal_report_error('tripal_cv', TRIPAL_WARNING, "Cannot find database '$dbname' in Chado.", NULL);
@@ -1109,7 +1120,7 @@ function tripal_insert_cvterm($term, $options = array()) {
     if ($dbxref->accession != $accession) {
 
       // Get/add the dbxref for his term.
-      $dbxref_new =  tripal_insert_dbxref(array(
+      $dbxref_new = chado_insert_dbxref(array(
         'db_id' => $db->db_id,
         'accession' => $accession
       ));
@@ -1139,7 +1150,7 @@ function tripal_insert_cvterm($term, $options = array()) {
           return 0;
         }
       }
-      // get the original cvterm with the same name and return that.
+      // Get the original cvterm with the same name and return that.
       $result = chado_query($cvtermsql, array(':accession' => $dbxref->accession, ':name' => $dbname));
       $cvterm = $result->fetchObject();
       return $cvterm;
@@ -1148,13 +1159,13 @@ function tripal_insert_cvterm($term, $options = array()) {
     // We can now perform and updated if we need to.
   }
 
-  // get the CVterm record
+  // Get the CVterm record.
   $result = chado_query($cvtermsql, array(':accession' => $accession, ':name' => $dbname));
   $cvterm = $result->fetchObject();
   if (!$cvterm) {
 
     // Check to see if the dbxref exists if not, add it.
-    $dbxref =  tripal_insert_dbxref(array(
+    $dbxref = chado_insert_dbxref(array(
       'db_id' => $db->db_id,
       'accession' => $accession
     ));
@@ -1214,7 +1225,8 @@ function tripal_insert_cvterm($term, $options = array()) {
       return 0;
     }
 
-    // Second, check that the dbxref has not changed and if it has then update it.
+    // Second, check that the dbxref has not changed and if it has then update 
+    // it.
     $checksql = "
       SELECT cvterm_id
       FROM {cvterm} CVT
@@ -1226,8 +1238,8 @@ function tripal_insert_cvterm($term, $options = array()) {
     $check = chado_query($checksql, array(':accession' => $accession, ':dbname' => $dbname, ':term' => $name, ':cvname' => $cvname))->fetchObject();
     if (!$check) {
 
-      // check to see if the dbxref exists if not, add it.
-      $dbxref =  tripal_insert_dbxref(array(
+      // Check to see if the dbxref exists if not, add it.
+      $dbxref = chado_insert_dbxref(array(
         'db_id' => $db->db_id,
         'accession' => $accession
       ));
@@ -1253,9 +1265,9 @@ function tripal_insert_cvterm($term, $options = array()) {
     $cvterm = $result->fetchObject();
   }
   else {
-    // do nothing, we have the cvterm but we don't want to update
+    // Do nothing, we have the cvterm but we don't want to update.
   }
-  // return the cvterm
+  // Return the cvterm.
   return $cvterm;
 }
 
@@ -1263,6 +1275,8 @@ function tripal_insert_cvterm($term, $options = array()) {
 /**
  * TODO: deprecate this function
  *
+ * Avoid using this function as it will be deprecated in future releases.
+ * 
  * This function allows other modules to programatically
  * submit an ontology for loading into Chado.
  *
@@ -1277,7 +1291,7 @@ function tripal_insert_cvterm($term, $options = array()) {
  * @param $obo_id
  *   If the ontology is already loaded into the Tripal tables then
  *   use this argument to specify the unique ID for the ontology
- *   that will be loaded
+ *   that will be loaded.
  * @param $obo_name
  *   If the OBO has not been added before then use this argument
  *   to specify the human readable name of the ontology.
@@ -1291,9 +1305,9 @@ function tripal_insert_cvterm($term, $options = array()) {
  * @return
  *   returns the job_id of the submitted job or FALSE if the job was not added
  *
- * @ingroup tripal_chado_api
+ * @ingroup tripal_chado_cv_api
  */
-function tripal_submit_obo_job($obo) {
+function chado_submit_obo_job($obo) {
   global $user;
 
   // Set Defaults
@@ -1341,17 +1355,17 @@ function tripal_submit_obo_job($obo) {
  * If the OBO name already exists in the table then the path is updated.
  *
  * @param $name
- *   The human readable name of this ontology
+ *   The human readable name of this ontology.
  * @param $path
- *   The file path or URL of the ontology
+ *   The file path or URL of the ontology.
  *
  * @return
- *   Returns the ontology ID
+ *   Returns the ontology ID.
  *
- * @ingroup tripal_chado_api
+ * @ingroup tripal_chado_cv_api
  */
-function tripal_insert_obo($name, $path) {
-  // make sure an OBO with the same name doesn't already exist
+function chado_insert_obo($name, $path) {
+  // Make sure an OBO with the same name doesn't already exist.
   $obo_id = db_select('tripal_cv_obo', 'tco')
     ->fields('tco', array('obo_id'))
     ->condition('name', $name)
@@ -1382,12 +1396,14 @@ function tripal_insert_obo($name, $path) {
  * Retrieves an OBO record.
  *
  * @param $values
- *   An associate array with the following allowed keys: obo_id, name
+ *   An associate array with the following allowed keys: obo_id, name.
  *
  * @return
  *   An instance of an OBO record object.
+ * 
+ * @ingroup tripal_chado_cv_api
  */
-function tripal_get_obo($values) {
+function chado_get_obo($values) {
   $query = db_select('tripal_cv_obo', 'tco')
     ->fields('tco');
 
@@ -1399,20 +1415,21 @@ function tripal_get_obo($values) {
   }
   return $query->execute()->fetchObject();
 }
+
 /**
  * This function is intended to be used in autocomplete forms.
  *
  * This function searches for a matching controlled vobulary name.
  *
  * @param $string
- * The string to search for
+ * The string to search for.
  *
  * @return
- * A json array of terms that begin with the provided string
+ * A json array of terms that begin with the provided string.
  *
- * @ingroup tripal_chado_api
+ * @ingroup tripal_chado_cv_api
  */
-function tripal_autocomplete_cv($string = '') {
+function chado_autocomplete_cv($string = '') {
   $sql = "
     SELECT CV.cv_id, CV.name
     FROM {cv} CV
@@ -1428,21 +1445,22 @@ function tripal_autocomplete_cv($string = '') {
 
   drupal_json_output($items);
 }
+
 /**
  * This function is intended to be used in autocomplete forms
- * for searching for CV terms that begin with the provided string
+ * for searching for CV terms that begin with the provided string.
  *
  * @param $cv_id
- * The CV ID in which to search for the term
+ * The CV ID in which to search for the term.
  * @param $string
- * The string to search for
+ * The string to search for.
  *
  * @return
- * A json array of terms that begin with the provided string
+ * A json array of terms that begin with the provided string.
  *
- * @ingroup tripal_chado_api
+ * @ingroup tripal_chado_cv_api
  */
-function tripal_autocomplete_cvterm($cv_id, $string = '') {
+function chado_autocomplete_cvterm($cv_id, $string = '') {
   if ($cv_id) {
     $sql = "
       SELECT CVT.cvterm_id, CVT.name
@@ -1490,13 +1508,15 @@ function tripal_autocomplete_cvterm($cv_id, $string = '') {
 }
 
 /**
- * Add a record to a cvterm linking table (ie: feature_cvterm)
+ * Add a record to a cvterm linking table (ie: feature_cvterm).
  *
  * @param $basetable
- *   The base table to which the cvterm should be linked/associated. Thus to associate a
- *   cvterm to a feature the basetable=feature and cvterm_id is added to the feature_cvterm table.
+ *   The base table to which the cvterm should be linked/associated. Thus to 
+ *   associate a cvterm to a feature the basetable=feature and cvterm_id is
+ *   added to the feature_cvterm table.
  * @param $record_id
- *   The primary key of the basetable to associate the cvterm with. This should be in integer.
+ *   The primary key of the basetable to associate the cvterm with. This should 
+ *   be in integer.
  * @param $cvterm
  *   An associative array describing the cvterm. Valid keys include:
  *     - name: the name for the cvterm,
@@ -1504,18 +1524,20 @@ function tripal_autocomplete_cvterm($cv_id, $string = '') {
  *     - cv_id: the primary key of the cv the cvterm belongs to.
  * @param $options
  *   An associative array of options. Valid keys include:
- *     - insert_cvterm: Insert the cvterm if it doesn't already exist. FALSE is the default
+ *     - insert_cvterm: Insert the cvterm if it doesn't already exist. FALSE is 
+ *       the default.
  *
- * @ingroup tripal_chado_api
+ * @ingroup tripal_chado_cv_api
  */
-function tripal_associate_cvterm($basetable, $record_id, $cvterm, $options = array()) {
+function chado_associate_cvterm($basetable, $record_id, $cvterm, $options = array()) {
   $linking_table = $basetable . '_cvterm';
   $foreignkey_name = $basetable . '_id';
 
   // Default Values
   $options['insert_cvterm'] = (isset($options['insert_cvterm'])) ? $options['insert_cvterm'] : FALSE;
 
-  // If the cvterm_id is not set then find the cvterm record using the name and cv_id
+  // If the cvterm_id is not set then find the cvterm record using the name and 
+  // cv_id.
   if (!isset($cvterm['cvterm_id'])) {
     $values = array(
       'name' => $cvterm['name'],
@@ -1530,7 +1552,7 @@ function tripal_associate_cvterm($basetable, $record_id, $cvterm, $options = arr
     }
     else {
       tripal_report_error('tripal_chado_api', TRIPAL_WARNING,
-        "tripal_associate_cvterm: The cvterm needs to have either the cv_name or cv_id
+        "chado_associate_cvterm: The cvterm needs to have either the cv_name or cv_id
           supplied. You were trying to associate a cvterm with the %base %record_id
           and supplied the cvterm values: %cvterm.",
         array('%base' => $basetable, '%record_id' => $record_id, '%cvterm' => print_r($cvterm,TRUE))
@@ -1546,13 +1568,13 @@ function tripal_associate_cvterm($basetable, $record_id, $cvterm, $options = arr
     }
     elseif ($options['insert_cvterm']) {
       // Insert the cvterm
-      $insert = tripal_insert_cvterm($values);
+      $insert = chado_insert_cvterm($values);
       if (isset($insert->cvterm_id)) {
         $cvterm['cvterm_id'] = $insert->cvterm_id;
       }
       else {
         tripal_report_error('tripal_chado_api', TRIPAL_WARNING,
-          "tripal_associate_cvterm: Unable to insert the cvterm using the cvterm values: %cvterm.",
+          "chado_associate_cvterm: Unable to insert the cvterm using the cvterm values: %cvterm.",
           array('%cvterm' => print_r($cvterm,TRUE))
         );
         return FALSE;
@@ -1560,14 +1582,14 @@ function tripal_associate_cvterm($basetable, $record_id, $cvterm, $options = arr
     }
     else {
       tripal_report_error('tripal_api', TRIPAL_WARNING,
-        "tripal_associate_cvterm: The cvterm doesn't already exist. You supplied the cvterm values: %cvterm.",
+        "chado_associate_cvterm: The cvterm doesn't already exist. You supplied the cvterm values: %cvterm.",
         array('%cvterm' => print_r($cvterm,TRUE))
       );
       return FALSE;
     }
   }
 
-  // Now add the link between the record & cvterm
+  // Now add the link between the record & cvterm.
   if ($cvterm['cvterm_id'] > 0) {
     $values = array(
       'cvterm_id' => $cvterm['cvterm_id'],
@@ -1599,5 +1621,3 @@ function tripal_associate_cvterm($basetable, $record_id, $cvterm, $options = arr
 
   return FALSE;
 }
-
-

tripal_chado/api/modules/tripal_chado.db.api.inc

@@ -1,72 +1,81 @@
 <?php
 /**
  * @file
- * Provides an application programming interface (API) to manage references to
- * external databases
+ * Provides API functions specificially for managing external database reference
+ * records in Chado. 
  */
 
 /**
  * @defgroup tripal_chado_database_api Chado DB
  * @ingroup tripal_chado_api
  * @{
+ * External databases can be used to indicate the source for a variety of data.
+ * The most common use is with controlled vocabularies (CV).  Chado expects that
+ * every CV have an external database record, where the database name must be
+ * the short name of the CV.  In other cases, records such as features, stocks,
+ * libraries, etc., can also be present in remote databases and these
+ * associations can be made through dbxref linker tables.  The API functions
+ * provided here provide tools to easily work with external databases.
  * @}
  */
 
 /**
- * Retrieves a chado db variable
+ * Retrieves a chado db variable.
  *
  * Example Usage:
  * @code
-    $select_values = array(
-      'name' => 'SOFP'
-    );
-    $db_object = tripal_get_db($select_values);
+ *   $select_values = array(
+ *     'name' => 'SOFP'
+ *   );
+ *   $db_object = chado_get_db($select_values);
  * @endcode
+ * 
  *  The above code selects the SOFP db and returns the following object:
  * @code
-    $db_object = stdClass Object (
-      [db_id] => 49
-      [name] => SOFP
-      [description] =>
-      [urlprefix] =>
-      [url] =>
-    );
+ *   $db_object = stdClass Object (
+ *     [db_id] => 49
+ *     [name] => SOFP
+ *     [description] =>
+ *     [urlprefix] =>
+ *     [url] =>
+ *   );
  * @endcode
  *
  * @param $identifier
- *   An array with the key stating what the identifier is. Supported keys (only on of the
- *   following unique keys is required):
- *    - db_id: the chado db.db_id primary key
- *    - name: the chado db.name field (assume unique)
+ *   An array with the key stating what the identifier is. Supported keys (only 
+ *   on of the following unique keys is required):
+ *    - db_id: the chado db.db_id primary key.
+ *    - name: the chado db.name field (assume unique).
  * @param $options
  *   An array of options. Supported keys include:
- *     - Any keys supported by chado_generate_var(). See that function definition for
- *       additional details.
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition for additional details.
  *
- * NOTE: the $identifier parameter can really be any array similar to $values passed into
- *   chado_select_record(). It should fully specify the db record to be returned.
+ * NOTE: the $identifier parameter can really be any array similar to $values 
+ * passed into chado_select_record(). It should fully specify the db record to 
+ * be returned.
  *
  * @return
- *   If unique values were passed in as an identifier then an object describing the cv
- *   will be returned (will be a chado variable from chado_generate_var()). Otherwise,
- *   an array of objects will be returned.
+ *   If unique values were passed in as an identifier then an object describing 
+ *   the cv will be returned (will be a chado variable from 
+ *   chado_generate_var()). Otherwise, an array of objects will be returned.
  *
  * @ingroup tripal_chado_database_api
  */
-function tripal_get_db($identifiers, $options = array()) {
+function chado_get_db($identifiers, $options = array()) {
 
-  // Set Defaults
+  // Set Defaults.
   if (!isset($options['include_fk'])) {
-    // Tells chado_generate_var not to follow any foreign keys
+    // Tells chado_generate_var not to follow any foreign keys.
     $options['include_fk'] = array();
   }
 
-  // Error Checking of parameters
+  // Error Checking of parameters.
   if (!is_array($identifiers)) {
     tripal_report_error(
       'tripal_chado_database_api',
       TRIPAL_ERROR,
-      "tripal_get_db: The identifier passed in is expected to be an array with the key
+      "chado_get_db: The identifier passed in is expected to be an array with the key
         matching a column name in the db table (ie: db_id or name). You passed in %identifier.",
       array(
         '%identifier'=> print_r($identifiers, TRUE)
@@ -77,7 +86,7 @@ function tripal_get_db($identifiers, $options = array()) {
     tripal_report_error(
       'tripal_chado_database_api',
       TRIPAL_ERROR,
-      "tripal_get_db: You did not pass in anything to identify the db you want. The identifier
+      "chado_get_db: You did not pass in anything to identify the db you want. The identifier
         is expected to be an array with the key matching a column name in the db table
         (ie: db_id or name). You passed in %identifier.",
       array(
@@ -86,31 +95,31 @@ function tripal_get_db($identifiers, $options = array()) {
     );
   }
 
-  // Try to get the db
+  // Try to get the db.
   $db = chado_generate_var(
     'db',
     $identifiers,
     $options
   );
 
-  // Ensure the db is singular. If it's an array then it is not singular
+  // Ensure the db is singular. If it's an array then it is not singular.
   if (is_array($db)) {
     tripal_report_error(
       'tripal_chado_database_api',
       TRIPAL_ERROR,
-      "tripal_get_db: The identifiers you passed in were not unique. You passed in %identifier.",
+      "chado_get_db: The identifiers you passed in were not unique. You passed in %identifier.",
       array(
         '%identifier'=> print_r($identifiers, TRUE)
       )
     );
   }
 
-  // Report an error if $db is FALSE since then chado_generate_var has failed
+  // Report an error if $db is FALSE since then chado_generate_var has failed.
   elseif ($db === FALSE) {
     tripal_report_error(
       'tripal_chado_database_api',
       TRIPAL_ERROR,
-      "tripal_get_db: chado_generate_var() failed to return a db based on the identifiers
+      "chado_get_db: chado_generate_var() failed to return a db based on the identifiers
         you passed in. You should check that your identifiers are correct, as well as, look
         for a chado_generate_var error for additional clues. You passed in %identifier.",
       array(
@@ -127,14 +136,14 @@ function tripal_get_db($identifiers, $options = array()) {
 
 /**
  * Create an options array to be used in a form element
- *   which provides a list of all chado dbs
+ *   which provides a list of all chado dbs.
  *
  * @return
- *   An array(db_id => name) for each db in the chado db table
+ *   An array(db_id => name) for each db in the chado db table.
  *
  * @ingroup tripal_chado_database_api
  */
-function tripal_get_db_select_options() {
+function chado_get_db_select_options() {
 
   $dbs = chado_query("SELECT db_id, name FROM {db} ORDER BY name");
 
@@ -150,81 +159,84 @@ function tripal_get_db_select_options() {
 }
 
 /**
- * Retrieves a chado database reference variable
+ * Retrieves a chado database reference variable.
  *
  * Example Usage:
  * @code
-    $identifiers = array(
-      'accession' => 'synonym',
-      'db_id' => array(
-        'name' => 'SOFP'
-      )
-    );
-    $dbxref_object = tripal_get_dbxref($identifiers);
+ *   $identifiers = array(
+ *     'accession' => 'synonym',
+ *     'db_id' => array(
+ *       'name' => 'SOFP'
+ *     )
+ *   );
+ *   $dbxref_object = chado_get_dbxref($identifiers);
  * @endcode
- *  The above code selects the synonym database reference and returns the following object:
+ *  The above code selects the synonym database reference and returns the 
+ *  following object:
  * @code
-    $dbxref_object = stdClass Object (
-      [dbxref_id] => 2581
-      [accession] => synonym
-      [description] =>
-      [version] =>
-      [db_db_id] => 49
-      [db_name] => SOFP
-      [db_description] =>
-      [db_urlprefix] =>
-      [db_url] =>
-    );
+ *  $dbxref_object = stdClass Object (
+ *     [dbxref_id] => 2581
+ *     [accession] => synonym
+ *     [description] =>
+ *     [version] =>
+ *     [db_db_id] => 49
+ *     [db_name] => SOFP
+ *     [db_description] =>
+ *     [db_urlprefix] =>
+ *     [db_url] =>
+ *   );
  * @endcode
  *
  * @param $identifier
  *   An array apropriate for use with the chado_generate_var for uniquely
  *   identifying a dbxref record. Alternatively, there are also some specially
  *   handled keys. They are:
- *    - property: An array/object describing the property to select records for. It
- *      should at least have either a type_name (if unique across cvs) or type_id. Other
- *      supported keys include: cv_id/cv_name (of the type), value and rank
+ *    - property: An array/object describing the property to select records for. 
+ *      It should at least have either a type_name (if unique across cvs) or 
+ *      type_id. Other supported keys include: cv_id/cv_name (of the type), 
+ *      value and rank.
  * @param $options
  *   An array of options. Supported keys include:
- *     - Any keys supported by chado_generate_var(). See that function definition for
- *       additional details.
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition for additional details.
  *
- * NOTE: the $identifier parameter can really be any array similar to $values passed into
- *   chado_select_record(). It should fully specify the dbxref record to be returned.
+ * NOTE: the $identifier parameter can really be any array similar to $values 
+ * passed into chado_select_record(). It should fully specify the dbxref record 
+ * to be returned.
  *
  * @return
- *   If unique values were passed in as an identifier then an object describing the dbxref
- *   will be returned (will be a chado variable from chado_generate_var()). Otherwise,
- *   FALSE will be returned.
+ *   If unique values were passed in as an identifier then an object describing 
+ *   the dbxref will be returned (will be a chado variable from 
+ *   chado_generate_var()). Otherwise, FALSE will be returned.
  *
- * @ingroup tripal_db_api
+ * @ingroup tripal_chado_database_api
  */
-function tripal_get_dbxref($identifiers, $options = array()) {
+function chado_get_dbxref($identifiers, $options = array()) {
 
-  // Set Defaults
+  // Set Defaults.
   if (!isset($options['include_fk'])) {
-    // Tells chado_generate_var not only expand the db
+    // Tells chado_generate_var not only expand the db.
     $options['include_fk'] = array('db_id' => TRUE);
   }
 
-  // Error Checking of parameters
+  // Error Checking of parameters.
   if (!is_array($identifiers)) {
     tripal_report_error('tripal_db_api', TRIPAL_ERROR,
-      "tripal_get_dbxref: The identifier passed in is expected to be an array with the key
+      "chado_get_dbxref: The identifier passed in is expected to be an array with the key
         matching a column name in the dbxref table (ie: dbxref_id or name). You passed in %identifier.",
       array('%identifier'=> print_r($identifiers, TRUE))
     );
   }
   elseif (empty($identifiers)) {
     tripal_report_error('tripal_db_api', TRIPAL_ERROR,
-      "tripal_get_dbxref: You did not pass in anything to identify the dbxref you want. The identifier
+      "chado_get_dbxref: You did not pass in anything to identify the dbxref you want. The identifier
         is expected to be an array with the key matching a column name in the dbxref table
         (ie: dbxref_id or name). You passed in %identifier.",
       array('%identifier'=> print_r($identifiers, TRUE))
     );
   }
 
-  // If one of the identifiers is property then use chado_get_record_with_property()
+  // If one of the identifiers is property then use chado_get_record_with_property().
   if (isset($identifiers['property'])) {
     $property = $identifiers['property'];
     unset($identifiers['property']);
@@ -235,25 +247,27 @@ function tripal_get_dbxref($identifiers, $options = array()) {
     );
   }
 
-  // Else we have a simple case and we can just use chado_generate_var to get the analysis
+  // Else we have a simple case and we can just use chado_generate_var to get 
+  // the analysis.
   else {
     $dbxref = chado_generate_var('dbxref', $identifiers, $options);
   }
 
-  // Ensure the dbxref is singular. If it's an array then it is not singular
+  // Ensure the dbxref is singular. If it's an array then it is not singular.
   if (is_array($dbxref)) {
     tripal_report_error('tripal_db_api', TRIPAL_ERROR,
-      "tripal_get_dbxref: The identifiers you passed in were not unique. You passed in %identifier.",
+      "chado_get_dbxref: The identifiers you passed in were not unique. You passed in %identifier.",
       array('%identifier'=> print_r($identifiers, TRUE))
     );
   }
 
-  // Report an error if $dbxref is FALSE since then chado_generate_var has failed
+  // Report an error if $dbxref is FALSE since then chado_generate_var has 
+  // failed.
   elseif ($dbxref === FALSE) {
     tripal_report_error(
       'tripal_db_api',
       TRIPAL_ERROR,
-      "tripal_get_dbxref: chado_generate_var() failed to return a dbxref based on the identifiers
+      "chado_get_dbxref: chado_generate_var() failed to return a dbxref based on the identifiers
         you passed in. You should check that your identifiers are correct, as well as, look
         for a chado_generate_var error for additional clues. You passed in %identifier.",
       array(
@@ -283,8 +297,10 @@ function tripal_get_dbxref($identifiers, $options = array()) {
  *
  * @return
  *   A string containing the URL.
+ * 
+ * @ingroup tripal_chado_database_api
  */
-function tripal_get_dbxref_url($dbxref) {
+function chado_get_dbxref_url($dbxref) {
   $final_url = '';
 
   // Create the URL for the term.
@@ -316,13 +332,14 @@ function tripal_get_dbxref_url($dbxref) {
  * Adds a new database to the Chado DB table and returns the DB object.
  *
  * @param $values
- *   An associative array of the values of the db (those to be inserted)
- *   - name: The name of the database. This name is usually used as the prefix for
- *     CV term accessions
- *   - description: (Optional) A description of the database.  By default no description is required.
- *   - url: (Optional) The URL for the database
- *   - urlprefix: (Optional) The URL that is to be used as a prefix when constructing a
- *     link to a database term
+ *   An associative array of the values of the db (those to be inserted):
+ *   - name: The name of the database. This name is usually used as the prefix 
+ *     for CV term accessions.
+ *   - description: (Optional) A description of the database.  By default no 
+ *     description is required.
+ *   - url: (Optional) The URL for the database.
+ *   - urlprefix: (Optional) The URL that is to be used as a prefix when 
+ *     constructing a link to a database term.
  * @param $options
  *   Optional. An associative array of options that can include:
  *   - update_existing: Set this to '1' to force an update of the database if it
@@ -335,16 +352,16 @@ function tripal_get_dbxref_url($dbxref) {
  *
  * @ingroup tripal_chado_database_api
  */
-function tripal_insert_db($values, $options = array()) {
+function chado_insert_db($values, $options = array()) {
 
-  // Default Values
+  // Default Values.
   $dbname = $values['name'];
   $description = (isset($values['description'])) ? $values['description'] : '';
   $url = (isset($values['url'])) ? $values['url'] : '';
   $urlprefix = (isset($values['urlprefix'])) ? $values['urlprefix'] : '';
   $update = (isset($options['update_existing'])) ? $options['update_existing'] : TRUE;
 
-  // build the values array for inserting/updating
+  // Build the values array for inserting/updating.
   $ins_values = array(
     'name' => $dbname,
     'description' => $description,
@@ -352,11 +369,11 @@ function tripal_insert_db($values, $options = array()) {
     'urlprefix' => $urlprefix
   );
 
-  // get the database record if it already exists
+  // Get the database record if it already exists.
   $sel_values = array('name' => $dbname);
   $result = chado_select_record('db', array('*'), $sel_values);
 
-  // if it does not exists then add it
+  // If it does not exists then add it.
   if (count($result) == 0) {
     $ins_options = array('statement_name' => 'ins_db_nadeurur');
     $success = chado_insert_record('db', $ins_values, $ins_options);
@@ -366,7 +383,7 @@ function tripal_insert_db($values, $options = array()) {
     }
     $result = chado_select_record('db', array('*'), $sel_values);
   }
-  // if it exists and update is enabled the do the update
+  // If it exists and update is enabled the do the update.
   elseif ($update) {
     $upd_options = array('statement_name' => 'upd_db_nadeurur');
     $success = chado_update_record('db', $sel_values, $ins_values, $upd_options);
@@ -377,20 +394,20 @@ function tripal_insert_db($values, $options = array()) {
     $result = chado_select_record('db', array('*'), $sel_values);
   }
 
-  // return the database object
+  // Return the database object.
   return $result[0];
 
 }
 
 /**
- * Add a database reference
+ * Add a database reference.
  *
  * @param $values
  *   An associative array of the values to be inserted including:
- *    - db_id: the database_id of the database the reference is from
- *    - accession: the accession
- *    - version: (Optional) The version of the database reference
- *    - description: (Optional) A description of the database reference
+ *    - db_id: the database_id of the database the reference is from.
+ *    - accession: the accession.
+ *    - version: (Optional) The version of the database reference.
+ *    - description: (Optional) A description of the database reference.
  *
  * @return
  *   The newly inserted dbxref as an object, similar to that returned by
@@ -398,7 +415,7 @@ function tripal_insert_db($values, $options = array()) {
  *
  * @ingroup tripal_chado_database_api
  */
-function tripal_insert_dbxref($values) {
+function chado_insert_dbxref($values) {
 
   $db_id = $values['db_id'];
   $accession = $values['accession'];
@@ -412,7 +429,7 @@ function tripal_insert_dbxref($values) {
     'description' => $description
   );
 
-  // check to see if the dbxref exists
+  // Check to see if the dbxref exists.
   $sel_values = array(
     'db_id'     => $db_id,
     'accession' => $accession,
@@ -420,7 +437,7 @@ function tripal_insert_dbxref($values) {
   );
   $result = chado_select_record('dbxref', array('*'), $sel_values);
 
-  // if it doesn't already exist then add it
+  // If it doesn't already exist then add it.
   if (!$result) {
     $success = chado_insert_record('dbxref', $ins_values);
     if (!$success) {
@@ -439,32 +456,36 @@ function tripal_insert_dbxref($values) {
 }
 
 /**
- * Add a record to a database reference linking table (ie: feature_dbxref)
+ * Add a record to a database reference linking table (ie: feature_dbxref).
  *
  * @param $basetable
- *   The base table for which the dbxref should be associated. Thus to associate a dbxref
- *   with a feature the basetable=feature and dbxref_id is added to the feature_dbxref table
+ *   The base table for which the dbxref should be associated. Thus to associate 
+ *   a dbxref with a feature the basetable=feature and dbxref_id is added to the
+ *   feature_dbxref table.
  * @param $record_id
- *   The primary key of the basetable to associate the dbxref with. This should be in integer.
+ *   The primary key of the basetable to associate the dbxref with. This should 
+ *   be in integer.
  * @param $dbxref
- *   An associative array describing the dbxref. Valid keys include: 'accession' => the
- *   accession for the dbxref, 'db_name' => the name of the database the dbxref belongs to;
+ *   An associative array describing the dbxref. Valid keys include: 
+ *   'accession' => the accession for the dbxref, 'db_name' => the name of the 
+ *    database the dbxref belongs to.
  *   'db_id' => the primary key of the database the dbxref belongs to.
  * @param $options
  *   An associative array of options. Valid keys include:
- *    - insert_dbxref: Insert the dbxref if it doesn't already exist. TRUE is the default
+ *    - insert_dbxref: Insert the dbxref if it doesn't already exist. TRUE is 
+ *      the default.
  *
  * @ingroup tripal_chado_database_api
  */
-function tripal_associate_dbxref($basetable, $record_id, $dbxref, $options = array()) {
+function chado_associate_dbxref($basetable, $record_id, $dbxref, $options = array()) {
   $linking_table = $basetable . '_dbxref';
   $foreignkey_name = $basetable . '_id';
 
-  // Default Values
+  // Default Values.
   $options['insert_dbxref'] = (isset($options['insert_dbxref'])) ? $options['insert_dbxref'] : TRUE;
 
-  // If the dbxref_id is set then we know it already exists
-  // Otherwise, select to check
+  // If the dbxref_id is set then we know it already exists.
+  // Otherwise, select to check.
   if (!isset($dbxref['dbxref_id'])) {
     $values = array(
       'accession' => $dbxref['accession'],
@@ -480,7 +501,7 @@ function tripal_associate_dbxref($basetable, $record_id, $dbxref, $options = arr
       tripal_report_error(
         'tripal_chado_database_api',
         TRIPAL_WARNING,
-        "tripal_associate_dbxref: The dbxref needs to have either the db_name or db_id
+        "chado_associate_dbxref: The dbxref needs to have either the db_name or db_id
           supplied. You were trying to associate a dbxref with the %base %record_id
           and supplied the dbxref values: %dbxref.",
         array('%base' => $basetable, '%record_id' => $record_id, '%dbxref' => print_r($dbxref,TRUE))
@@ -492,8 +513,8 @@ function tripal_associate_dbxref($basetable, $record_id, $dbxref, $options = arr
       $dbxref['dbxref_id'] = $select[0]->dbxref_id;
     }
     elseif ($options['insert_dbxref']) {
-      // Insert the dbxref
-      $insert = tripal_insert_dbxref($values);
+      // Insert the dbxref.
+      $insert = chado_insert_dbxref($values);
       if (isset($insert->dbxref_id)) {
         $dbxref['dbxref_id'] = $insert->dbxref_id;
       }
@@ -501,7 +522,7 @@ function tripal_associate_dbxref($basetable, $record_id, $dbxref, $options = arr
         tripal_report_error(
           'tripal_chado_database_api',
           TRIPAL_WARNING,
-          "tripal_associate_dbxref: Unable to insert the dbxref using the dbxref values: %dbxref.",
+          "chado_associate_dbxref: Unable to insert the dbxref using the dbxref values: %dbxref.",
           array('%dbxref' => print_r($dbxref,TRUE))
         );
         return FALSE;
@@ -511,14 +532,14 @@ function tripal_associate_dbxref($basetable, $record_id, $dbxref, $options = arr
       tripal_report_error(
         'tripal_api',
         TRIPAL_WARNING,
-        "tripal_associate_dbxref: The dbxref doesn't already exist. You supplied the dbxref values: %dbxref.",
+        "chado_associate_dbxref: The dbxref doesn't already exist. You supplied the dbxref values: %dbxref.",
         array('%dbxref' => print_r($dbxref,TRUE))
       );
       return FALSE;
     }
   }
 
-  // Now add the link between the record & dbxref
+  // Now add the link between the record & dbxref.
   if ($dbxref['dbxref_id'] > 0) {
     $values = array(
       'dbxref_id' => $dbxref['dbxref_id'],
@@ -527,7 +548,7 @@ function tripal_associate_dbxref($basetable, $record_id, $dbxref, $options = arr
 
     $result = chado_select_record($linking_table, array('*'), $values);
 
-    // if it doesn't already exist then add it
+    // If it doesn't already exist then add it.
     if (!$result) {
       $success = chado_insert_record($linking_table, $values);
       if (!$success) {
@@ -555,19 +576,19 @@ function tripal_associate_dbxref($basetable, $record_id, $dbxref, $options = arr
 
 /**
  * This function is intended to be used in autocomplete forms
- * for searching for accession that begin with the provided string
+ * for searching for accession that begin with the provided string.
  *
  * @param $db_id
- *   The DB ID in which to search for the term
+ *   The DB ID in which to search for the term.
  * @param $string
- *   The string to search for
+ *   The string to search for.
  *
  * @return
- *   A json array of terms that begin with the provided string
+ *   A json array of terms that begin with the provided string.
  *
- * @ingroup tripal_db_api
+ * @ingroup tripal_chado_database_api
  */
-function tripal_autocomplete_dbxref($db_id, $string = '') {
+function chado_autocomplete_dbxref($db_id, $string = '') {
   if (!$db_id) {
     return drupal_json_output(array());
   }

tripal_chado/api/modules/tripal_chado.feature.api.inc

@@ -1,13 +1,17 @@
 <?php
 /**
  * @file
- * Provides an application programming interface (API) for working with features
+ * Provides API functions specificially for managing feature
+ * records in Chado.  
  */
 
 /**
  * @defgroup tripal_feature_api Chado Feature
  * @ingroup tripal_chado_api
  * @{
+ * Provides API functions specificially for managing feature
+ * records in Chado especially retrieving relationships and sequences derived 
+ * from relationships and feature alignments.
  * @}
  */
 /**
@@ -16,14 +20,14 @@
  * @param $field
  *   The field in the publication to search on.
  * @param $string
- *   The string to search for
+ *   The string to search for.
  *
  * @return
- *   A json array of terms that begin with the provided string
+ *   A json array of terms that begin with the provided string.
  *
  * @ingroup tripal_feature_api
  */
-function tripal_autocomplete_feature($string = '') {
+function chado_autocomplete_feature($string = '') {
   $items = array();
   $sql = "
     SELECT
@@ -47,17 +51,17 @@ function tripal_autocomplete_feature($string = '') {
 }
 
 /**
- * Performs a reverse compliment of a nucleotide sequence
+ * Performs a reverse compliment of a nucleotide sequence.
  *
  * @param $sequence
- *   The nucelotide sequence
+ *   The nucelotide sequence.
  *
  * @return
- *   an upper-case reverse complemented sequence
+ *   an upper-case reverse complemented sequence.
  *
  * @ingroup tripal_feature_api
  */
-function tripal_reverse_compliment_sequence($sequence) {
+function chado_reverse_compliment_sequence($sequence) {
 
   $seq = strtoupper($sequence);
   $seq = strrev($seq);
@@ -87,12 +91,13 @@ function tripal_reverse_compliment_sequence($sequence) {
  * @param $feature
  *   An associative array describing the feature. Valid keys include:
  *    - feature_id: The feature_id of the feature for which the sequence will
- *      be retrieved
- *    - name: The feature name. This will appear on the FASTA definition line
+ *      be retrieved.
+ *    - name: The feature name. This will appear on the FASTA definition line.
  *    - parent_id:  (optional) only retrieve a sequence if 'derive_from_parent'
  *      is true and the parent matches this ID.
- *    - featureloc_id: (optional) only retrieve a sequence if 'derive_from_parent' is
- *      true and the alignment is defined with this featureloc_id
+ *    - featureloc_id: (optional) only retrieve a sequence if 
+ *      'derive_from_parent' is true and the alignment is defined with this 
+ *      featureloc_id.
  * @param $options
  *   An associative array of options. Valid keys include:
  *    - width: Indicate the number of bases to use per line.  A new line will
@@ -105,52 +110,52 @@ function tripal_reverse_compliment_sequence($sequence) {
  *      excluding intro sub feature sequence.  For example, set this option to
  *      obtain just the coding sequence of an mRNA.
  *    - upstream: An integer specifing the number of upstream bases to include
- *      in the output
+ *      in the output.
  *    - downstream: An integer specifying the number of downstream bases to
  *      include in the output.
  *    - sub_feature_types: Only include sub features (or child features) of
- *      the types provided in the array
+ *      the types provided in the array.
  *    - relationship_type: If a relationship name is provided (e.g. sequence_of)
  *      then any sequences that are in relationships of this type with matched
- *      sequences are also included
+ *      sequences are also included.
  *    - relationship_part: If a relationship is provided in the preceeding
  *      argument then the rel_part must be either 'object' or 'subject' to
- *      indicate which side of the relationship the matched features belong
+ *      indicate which side of the relationship the matched features belong.
  *
  * @return
  *   an array of matching sequence in the following keys for each sequence:
- *      'types'         => an array of feature types that were used to derive
- *         the sequence (e.g. from an aggregated sequence)
- *      'upstream'      => the number of upstream bases included in the sequence
- *      'downstream'    => the number of downstream bases included in the
- *        sequence
- *      'defline'       => the definintion line used to create a FASTA sequence
- *      'residues'      => the residues
- *      'featureloc_id' => the featureloc_id if the sequences is from an
+ *    - types: an array of feature types that were used to derive
+ *      the sequence (e.g. from an aggregated sequence)
+ *    - upstream: the number of upstream bases included in the sequence
+ *    - downstream: the number of downstream bases included in the
+ *      sequence
+ *    - defline: the definintion line used to create a FASTA sequence
+ *    - residues: the residues
+ *    - featureloc_id: the featureloc_id if the sequences is from an
  *        alignment
  *
  * @ingroup tripal_feature_api
  */
-function tripal_get_feature_sequences($feature, $options) {
+function chado_get_feature_sequences($feature, $options) {
 
   // Default values for finding the feature.
-  $feature_id         = array_key_exists('feature_id', $feature)     ? $feature['feature_id']     : 0;
-  $parent_id          = array_key_exists('parent_id', $feature)      ? $feature['parent_id']      : 0;
-  $featureloc_id      = array_key_exists('featureloc_id', $feature)  ? $feature['featureloc_id']  : 0;
-  $feature_name       = array_key_exists('name', $feature)           ? $feature['name']           : '';
+  $feature_id = array_key_exists('feature_id', $feature) ? $feature['feature_id']     : 0;
+  $parent_id = array_key_exists('parent_id', $feature) ? $feature['parent_id']      : 0;
+  $featureloc_id = array_key_exists('featureloc_id', $feature) ? $feature['featureloc_id']  : 0;
+  $feature_name = array_key_exists('name', $feature) ? $feature['name']           : '';
 
   // Default values for building the sequence.
-  $num_bases_per_line = array_key_exists('width', $options)              ? $options['width']              : 50;
+  $num_bases_per_line = array_key_exists('width', $options) ? $options['width']              : 50;
   $derive_from_parent = array_key_exists('derive_from_parent', $options) ? $options['derive_from_parent'] : 0;
-  $aggregate          = array_key_exists('aggregate', $options)          ? $options['aggregate']          : 0;
-  $upstream           = array_key_exists('upstream', $options)           ? $options['upstream']           : 0;
-  $downstream         = array_key_exists('downstream', $options)         ? $options['downstream']         : 0;
-  $sub_features       = array_key_exists('sub_feature_types', $options)  ? $options['sub_feature_types']  : array();
-  $relationship       = array_key_exists('relationship_type', $options)  ? $options['relationship_type']  : '';
-  $rel_part           = array_key_exists('relationship_part', $options)  ? $options['relationship_part']  : '';
-  $is_html            = array_key_exists('is_html', $options)            ? $options['is_html']            : 0;
-  $is_txt             = array_key_exists('is_txt', $options)             ? $options['is_txt']             : 0;
-  $is_raw             = array_key_exists('is_raw', $options)             ? $options['is_raw']             : 1;
+  $aggregate = array_key_exists('aggregate', $options) ? $options['aggregate']          : 0;
+  $upstream = array_key_exists('upstream', $options) ? $options['upstream']           : 0;
+  $downstream = array_key_exists('downstream', $options) ? $options['downstream']         : 0;
+  $sub_features = array_key_exists('sub_feature_types', $options) ? $options['sub_feature_types']  : array();
+  $relationship = array_key_exists('relationship_type', $options) ? $options['relationship_type']  : '';
+  $rel_part = array_key_exists('relationship_part', $options) ? $options['relationship_part']  : '';
+  $is_html = array_key_exists('is_html', $options) ? $options['is_html']            : 0;
+  $is_txt = array_key_exists('is_txt', $options) ? $options['is_txt']             : 0;
+  $is_raw = array_key_exists('is_raw', $options) ? $options['is_raw']             : 1;
 
   if (!$upstream) {
     $upstream = 0;
@@ -162,7 +167,7 @@ function tripal_get_feature_sequences($feature, $options) {
   // Make sure the sub_features variable is an array.
   if (!is_array($sub_features)) {
     tripal_report_error('tripal_feature', TRIPAL_ERROR,
-      "'sub_features' option must be an array for function tripal_get_feature_sequences().",
+      "'sub_features' option must be an array for function chado_get_feature_sequences().",
       array()
     );
     return array();
@@ -212,7 +217,7 @@ function tripal_get_feature_sequences($feature, $options) {
       if ($rel_part == "object") {
         $defline = "$feature->uniquename $feature->feature_type ($feature->genus $feature->species), $relationship, $feature_name";
       }
-      return tripal_get_feature_sequences(
+      return chado_get_feature_sequences(
         array(
           'feature_id' => $feature->feature_id,
           'name' => $defline,
@@ -341,7 +346,7 @@ function tripal_get_feature_sequences($feature, $options) {
       if ($parent_id and $parent_id != $parent->srcfeature_id) {
         continue;
       }
-      // if the user specified a particular featureloc_id and this one
+      // If the user specified a particular featureloc_id and this one
       // doesn't match then skip it.
       if ($featureloc_id and $featureloc_id != $parent->featureloc_id) {
         continue;
@@ -351,8 +356,8 @@ function tripal_get_feature_sequences($feature, $options) {
       $notes = '';
       $types = array();
 
-      // if we are to aggregate then we will ignore the feature returned
-      // by the query above and rebuild it using the sub features
+      // If we are to aggregate then we will ignore the feature returned
+      // by the query above and rebuild it using the sub features.
       if ($aggregate) {
 
         // now get the sub features that are located on the parent.
@@ -382,13 +387,14 @@ function tripal_get_feature_sequences($feature, $options) {
             continue;
           }
 
-          // keep up with the types
+          // Keep up with the types.
           if (!in_array($child->type_name, $types)) {
             $types[] = $child->type_name;
           }
 
-          // if the first sub feature we need to include the upstream bases. first check if
-          // the feature is in the foward direction or the reverse.
+          // If the first sub feature we need to include the upstream bases. 
+          // First check if the feature is in the foward direction or the 
+          // reverse.
           if ($i == 0 and $parent->strand >= 0) {  // forward direction
             // -------------------------- ref
             //    ....---->  ---->
@@ -402,8 +408,9 @@ function tripal_get_feature_sequences($feature, $options) {
             $q = chado_query($parent_sql, array(':upstream' => 0, ':downstream' => $downstream, ':feature_id' => $child->feature_id));
           }
 
-          // Next, if the last sub feature we need to include the downstream bases. first check if
-          // the feature is in teh forward direction or the reverse
+          // Next, if the last sub feature we need to include the downstream 
+          // bases. First check if the feature is in teh forward direction or 
+          // the reverse.
           elseif ($i == $num_children - 1 and $parent->strand >= 0) {  // forward direction
             // -------------------------- ref
             //        ---->  ---->....
@@ -416,7 +423,7 @@ function tripal_get_feature_sequences($feature, $options) {
             //          1       2  up
             $q = chado_query($parent_sql, array(':upstream' => $upstream, ':downstream' => 0, ':feature_id' => $child->feature_id));
           }
-          // for internal sub features we don't want upstream or downstream bases
+          // For internal sub features we don't want upstream or downstream bases.
           else {
             $q = chado_query($parent_sql, array(':upstream' => 0, ':downstream' => 0, ':feature_id' => $child->feature_id));
           }
@@ -435,7 +442,7 @@ function tripal_get_feature_sequences($feature, $options) {
           $i++;
         }
       }
-      // if this isn't an aggregate then use the parent residues
+      // If this isn't an aggregate then use the parent residues.
       else {
          $seq = $parent->residues;
          if ($parent->upstream > 0) {
@@ -446,14 +453,14 @@ function tripal_get_feature_sequences($feature, $options) {
          }
       }
 
-      // get the reverse compliment if feature is on the reverse strand
+      // Get the reverse compliment if feature is on the reverse strand.
       $dir = 'forward';
       $length = strlen($seq);
       if ($parent->strand < 0) {
-        $seq = tripal_reverse_compliment_sequence($seq);
+        $seq = chado_reverse_compliment_sequence($seq);
         $dir = 'reverse';
       }
-      // now format for display
+      // Now format for display.
       if ($is_html) {
         $seq = wordwrap($seq, $num_bases_per_line, "<br>", TRUE);
       }
@@ -484,7 +491,7 @@ function tripal_get_feature_sequences($feature, $options) {
       $featureloc->srcfeature_id->organism_id->species = $parent->species;
       // Get a proper feature object.
       $f = chado_generate_var('feature', array('feature_id' => $feature_id));
-      $defline = tripal_get_fasta_defline($f, $notes, $featureloc, '', $length);
+      $defline = chado_get_fasta_defline($f, $notes, $featureloc, '', $length);
 
       $sequences[] = array(
         'types'         => $types,
@@ -513,10 +520,10 @@ function tripal_get_feature_sequences($feature, $options) {
       $residues = wordwrap($residues, $num_bases_per_line, "\r\n", TRUE);
     }
 
-    // get the definintion line for this feature
-    $defline = tripal_get_fasta_defline($f, '', NULL, '', $length);
+    // Get the definintion line for this feature.
+    $defline = chado_get_fasta_defline($f, '', NULL, '', $length);
 
-    // add to the sequence array
+    // Add to the sequence array.
     $sequences[] = array(
       'types'      => $f->type_id->name,
       'upstream'   => 0,
@@ -531,6 +538,7 @@ function tripal_get_feature_sequences($feature, $options) {
 }
 
 /**
+ * Retrieves the bulk sequences for a given feature.
  *
  * @param $options
  *   An associative array of options for selecting a feature. Valid keys include:
@@ -580,31 +588,31 @@ function tripal_get_feature_sequences($feature, $options) {
  *
  * @ingroup tripal_feature_api
  */
-function tripal_get_bulk_feature_sequences($options) {
-
-  // default values for building the sequence
-  $org_commonname     = array_key_exists('org_commonname', $options)     ? $options['org_commonname']    : '';
-  $genus              = array_key_exists('genus', $options)              ? $options['genus']             : '';
-  $species            = array_key_exists('species', $options)            ? $options['species']           : '';
-  $analysis_name      = array_key_exists('analysis_name', $options)      ? $options['analysis_name']     : '';
-  $type               = array_key_exists('type', $options)               ? $options['type']              : '';
-  $feature_name       = array_key_exists('feature_name', $options)       ? $options['feature_name']      : '';
-  $feature_uname      = array_key_exists('feature_uname', $options)      ? $options['feature_uname']     : '';
+function chado_get_bulk_feature_sequences($options) {
+
+  // Default values for building the sequence
+  $org_commonname = array_key_exists('org_commonname', $options) ? $options['org_commonname']    : '';
+  $genus = array_key_exists('genus', $options) ? $options['genus']             : '';
+  $species = array_key_exists('species', $options) ? $options['species']           : '';
+  $analysis_name = array_key_exists('analysis_name', $options) ? $options['analysis_name']     : '';
+  $type = array_key_exists('type', $options) ? $options['type']              : '';
+  $feature_name = array_key_exists('feature_name', $options) ? $options['feature_name']      : '';
+  $feature_uname = array_key_exists('feature_uname', $options) ? $options['feature_uname']     : '';
   $derive_from_parent = array_key_exists('derive_from_parent', $options) ? $options['derive_from_parent'] : 0;
-  $aggregate          = array_key_exists('aggregate', $options)          ? $options['aggregate']          : 0;
-  $sub_features       = array_key_exists('sub_feature_types', $options)  ? $options['sub_feature_types']  : array();
-  $relationship       = array_key_exists('relationship_type', $options)  ? $options['relationship_type']  : '';
-  $rel_part           = array_key_exists('relationship_part', $options)  ? $options['relationship_part']  : '';
-  $num_bases_per_line = array_key_exists('width', $options)              ? $options['width']              : 50;
-  $upstream           = array_key_exists('upstream', $options)           ? $options['upstream']       : 0;
-  $downstream         = array_key_exists('downstream', $options)         ? $options['downstream']     : 0;
+  $aggregate = array_key_exists('aggregate', $options) ? $options['aggregate']          : 0;
+  $sub_features = array_key_exists('sub_feature_types', $options) ? $options['sub_feature_types']  : array();
+  $relationship = array_key_exists('relationship_type', $options) ? $options['relationship_type']  : '';
+  $rel_part = array_key_exists('relationship_part', $options) ? $options['relationship_part']  : '';
+  $num_bases_per_line = array_key_exists('width', $options) ? $options['width']              : 50;
+  $upstream = array_key_exists('upstream', $options) ? $options['upstream']       : 0;
+  $downstream = array_key_exists('downstream', $options) ? $options['downstream']     : 0;
 
   if (!$type and !$feature_name and !$genus) {
     print "Please provide a type, feature name or genus\n";
     return;
   }
 
-  // get the list of features
+  // Get the list of features.
   $vars = array();
   $sql  = "
     SELECT DISTINCT F.feature_id, F.name, F.uniquename,
@@ -643,7 +651,7 @@ function tripal_get_bulk_feature_sequences($options) {
         $sql .= ":fname$i, ";
         $vars[":fname$i"] = $fname;
       }
-      // remove the trailing comma and close the paren
+      // Remove the trailing comma and close the parenthesis.
       $sql = substr($sql, 0, -2) . ")";
     }
     else {
@@ -658,7 +666,7 @@ function tripal_get_bulk_feature_sequences($options) {
         $sql .= ":funame$i, ";
         $vars[":funame$i"] = $funame;
       }
-      // remove the trailing comma and close the paren
+      // Remove the trailing comma and close the parenthesis.
       $sql = substr($sql, 0, -2) . ")";
     }
     else {
@@ -677,7 +685,7 @@ function tripal_get_bulk_feature_sequences($options) {
   $sequences = array();
   while ($feature = $q->fetchObject()) {
     // get the sequences
-    $seqs = tripal_get_feature_sequences(array('feature_id' => $feature->feature_id), $options);
+    $seqs = chado_get_feature_sequences(array('feature_id' => $feature->feature_id), $options);
     $sequences = array_merge($sequences, $seqs);
     $num_seqs++;
   }
@@ -686,30 +694,34 @@ function tripal_get_bulk_feature_sequences($options) {
 }
 
 /**
- * Returns a definition line that can be used in a FASTA file
+ * Returns a definition line that can be used in a FASTA file.
  *
  * @param $feature
- *   A single feature object containing all the fields from the chado.feature table.
- *   Best case is to provide an object generated by the chado_generate_var() function.
+ *   A single feature object containing all the fields from the chado.feature 
+ *   table. Best case is to provide an object generated by the 
+ *   chado_generate_var() function.
  * @param $notes
- *   Optional: additional notes to be added to the definition line
+ *   Optional: additional notes to be added to the definition line.
  * @param $featureloc
- *   Optional: a single featureloc object generated using chado_generate_var that
- *   contains a record from the chado.featureloc table. Provide this if the
- *   sequence was obtained by using the alignment rather than from the feature.residues
- *   column
+ *   Optional: a single featureloc object generated using chado_generate_var
+ *   that contains a record from the chado.featureloc table. Provide this if the
+ *   sequence was obtained by using the alignment rather than from the 
+ *   feature.residues column.
  * @param $type
  *   Optional: the type of sequence. By default the feature type is used.
  * @param $length
- *   Optional: the length of the sequence
+ *   Optional: the length of the sequence.
  *
  * @return
  *   A string of the format: uniquename|name|type|feature_id
- *   or if an alignment:  srcfeature_name:fmin..fmax[+-]; alignment of uniquename|name|type|feature_id
+ *   or if an alignment:  srcfeature_name:fmin..fmax[+-]; alignment of 
+ *   uniquename|name|type|feature_id.
+ * 
+ * @ingroup tripal_feature_api
  */
-function tripal_get_fasta_defline($feature, $notes = '', $featureloc = NULL, $type = '', $length = 0) {
+function chado_get_fasta_defline($feature, $notes = '', $featureloc = NULL, $type = '', $length = 0) {
 
-  // make sure the featureloc object has the srcfeature if not, then add it
+  // Make sure the featureloc object has the srcfeature if not, then add it.
   if ($featureloc) {
     if (!is_object($featureloc->srcfeature_id)) {
       $featureloc->srcfeature_id = chado_generate_var('feature', array('feature_id' => $featureloc->srcfeature_id));
@@ -718,17 +730,17 @@ function tripal_get_fasta_defline($feature, $notes = '', $featureloc = NULL, $ty
       $featureloc->srcfeature_id->organism_id = chado_generate_var('organism', array('organism_id' => $featureloc->srcfeature_id->organism_id));
     }
   }
-  // make sure the feature object has the organism if not, then add it
+  // Make sure the feature object has the organism if not, then add it.
   if (!is_object($feature->organism_id)) {
     $feature->organism_id = chado_generate_var('organism', array('organism_id' => $feature->organism_id));
   }
 
-  // if a type is not provided then use the default type
+  // If a type is not provided then use the default type.
   if (!$type) {
     $type = $feature->type_id->name;
   }
 
-  // construct the definition line
+  // Construct the definition line.
   $defline = $feature->uniquename . " " .
              'ID=' . $feature->uniquename . "|" .
              'Name=' . $feature->name . "|" .
@@ -738,7 +750,7 @@ function tripal_get_fasta_defline($feature, $notes = '', $featureloc = NULL, $ty
     $defline .= "length=" . $length . "bp|";
   }
   if ($featureloc) {
-    $defline .= "location=Sequence derived from alignment at " . tripal_get_location_string($featureloc);
+    $defline .= "location=Sequence derived from alignment at " . chado_get_location_string($featureloc);
     $defline .= " (" . $featureloc->srcfeature_id->organism_id->genus . " " . $featureloc->srcfeature_id->organism_id->species . ")|";
   }
   if ($notes) {
@@ -749,13 +761,18 @@ function tripal_get_fasta_defline($feature, $notes = '', $featureloc = NULL, $ty
 }
 
 /**
- * Returns a string representing a feature location in an alignment
+ * Returns a string representing a feature location in an alignment.
  *
- * @param unknown $featureloc
+ * @param $featureloc
  *   A single featureloc object generated using chado_generate_var that
  *   contains a record from the chado.featureloc table.
+ *
+ *  @return
+ *   A string of the format: uniquename:featurelocmin..featurelocmax.strand
+ * 
+ * @ingroup tripal_feature_api
  */
-function tripal_get_location_string($featureloc) {
+function chado_get_location_string($featureloc) {
   $feature = $featureloc->feature_id;
 
   $strand = '';
@@ -769,592 +786,3 @@ function tripal_get_location_string($featureloc) {
   return $featureloc->srcfeature_id->name . ":" . ($featureloc->fmin + 1) . ".." . $featureloc->fmax .  $strand;
 }
 
-
-/**
- * Quickly retrieves relationships for a feature.
- *
- * Using the chado_expand_var function to retrieve a set
- * of relationships can be very slow, especialy if there are many relationships
- * This function is intended to help speed up the retrieval of relationships
- * by only retrieving the base information for the relationship and returning
- * an array with
- *
- * @param $feature
- *   The feature object
-
- * @return
- *   An array with two objects
- *
- * @ingroup tripal_feature_api
- */
-function tripal_get_feature_relationships($feature) {
-  // expand the feature object to include the feature relationships.
-  $options = array(
-    'return_array' => 1,
-    'order_by' => array('rank' => 'ASC'),
-    // we don't want to fully recurse we only need information about the
-    // relationship type and the object and subject features (including feature type
-    // and organism)
-    'include_fk' => array(
-      'type_id' => 1,
-      'object_id' => array(
-        'type_id' => 1,
-        'organism_id' => 1
-      ),
-      'subject_id'  => array(
-        'type_id' => 1,
-        'organism_id' => 1
-      ),
-    ),
-  );
-  $feature = chado_expand_var($feature, 'table', 'feature_relationship', $options);
-
-  // get the subject relationships
-  $srelationships = $feature->feature_relationship->subject_id;
-  $orelationships = $feature->feature_relationship->object_id;
-
-
-  // get alignment as child. The $feature->featureloc element
-  // is already populated from the alignment preprocess function
-  $options = array(
-    'return_array' => 1,
-    'include_fk' => array(
-      'srcfeature_id' => 1,
-      'feature_id' => 1,
-    ),
-  );
-  $feature = chado_expand_var($feature, 'table', 'featureloc', $options);
-  $cfeaturelocs = $feature->featureloc->feature_id;
-  if (!$cfeaturelocs) {
-    $cfeaturelocs = array();
-  }
-  elseif (!is_array($cfeaturelocs)) {
-    $cfeaturelocs = array($cfeaturelocs);
-  }
-
-  // prepare the SQL statement to get the featureloc for the
-  // feature in the relationships.
-  $flrels_sql = "
-    SELECT
-      FL.featureloc_id, F.name as srcfeature_name, FL.srcfeature_id,
-      FL.feature_id, FL.fmin, FL.fmax, FL.strand, FL.phase
-    FROM {featureloc} FL
-      INNER JOIN {feature} F ON F.feature_id = FL.srcfeature_id
-    WHERE FL.feature_id = :feature_id and FL.srcfeature_id = :srcfeature_id
-  ";
-
-  // combine both object and subject relationshisp into a single array
-  $relationships = array();
-  $relationships['object'] = array();
-  $relationships['subject'] = array();
-
-  // iterate through the object relationships
-  if ($orelationships) {
-    foreach ($orelationships as $relationship) {
-      $rel = new stdClass();
-      // get locations where the child feature and this feature overlap with the
-      // same landmark feature.
-      $rel->child_featurelocs = array();
-      foreach ($cfeaturelocs as $featureloc) {
-        $res = chado_query($flrels_sql, array(':feature_id' => $relationship->subject_id->feature_id, ':srcfeature_id' => $featureloc->srcfeature_id->feature_id));
-        while ($loc = $res->fetchObject()) {
-          // add in the node id of the src feature if it exists and save this location
-          if (property_exists($featureloc->srcfeature_id, 'nid')) {
-            $loc->nid = $featureloc->srcfeature_id->nid;
-          }
-          $rel->child_featurelocs[] = $loc;
-        }
-      }
-      $rel->record = $relationship;
-
-      // get the relationship and child types
-      $rel_type = t(preg_replace('/_/', " ", $relationship->type_id->name));
-      $child_type = $relationship->subject_id->type_id->name;
-
-      // get the node id of the subject
-//       $sql = "SELECT nid FROM {chado_feature} WHERE feature_id = :feature_id";
-//       $n = db_query($sql, array(':feature_id' => $relationship->subject_id->feature_id))->fetchObject();
-//       if ($n) {
-//         $rel->record->nid = $n->nid;
-//       }
-
-      if (!array_key_exists($rel_type, $relationships['object'])) {
-        $relationships['object'][$rel_type] = array();
-      }
-      if (!array_key_exists($child_type, $relationships['object'][$rel_type])) {
-        $relationships['object'][$rel_type][$child_type] = array();
-      }
-      $relationships['object'][$rel_type][$child_type][] = $rel;
-    }
-  }
-
-  // now add in the subject relationships
-  if ($srelationships) {
-    foreach ($srelationships as $relationship) {
-      $rel = new stdClass();
-      // get locations where this feature overlaps with the parent
-      $rel->parent_featurelocs = array();
-      foreach ($cfeaturelocs as $featureloc) {
-        $res = chado_query($flrels_sql, array(':feature_id' => $relationship->object_id->feature_id, ':srcfeature_id' => $featureloc->srcfeature_id->feature_id));
-        while ($loc = $res->fetchObject()) {
-          // add in the node id of the src feature if it exists and save this location
-          if (property_exists($featureloc->srcfeature_id, 'nid')) {
-            $loc->nid = $featureloc->srcfeature_id->nid;
-          }
-          $rel->parent_featurelocs[] = $loc;
-        }
-      }
-      $rel->record = $relationship;
-      $rel_type = t(preg_replace('/_/', " ", $relationship->type_id->name));
-      $parent_type = $relationship->object_id->type_id->name;
-
-//       // get the node id of the subject
-//       $sql = "SELECT nid FROM {chado_feature} WHERE feature_id = :feature_id";
-//       $n = db_query($sql, array(':feature_id' => $relationship->object_id->feature_id))->fetchObject();
-//       if ($n) {
-//         $rel->record->nid = $n->nid;
-//       }
-
-      if (!array_key_exists($rel_type, $relationships['subject'])) {
-        $relationships['subject'][$rel_type] = array();
-      }
-      if (!array_key_exists($parent_type, $relationships['subject'][$rel_type])) {
-        $relationships['subject'][$rel_type][$parent_type] = array();
-      }
-      $relationships['subject'][$rel_type][$parent_type][] = $rel;
-    }
-  }
-  return $relationships;
-}
-
-/**
- *
- * @param unknown $feature_id
- * @param unknown $featurelocs
- * @return multitype:|Ambigous <multitype:, an>
- */
-function chado_get_featureloc_sequences($feature_id, $featurelocs) {
-
-  // if we don't have any featurelocs then no point in continuing
-  if (!$featurelocs) {
-    return array();
-  }
-
-  // Get the list of relationships (including any aggregators) and iterate
-  // through each one to find information needed to color-code the reference sequence
-  $relationships = _tripal_feature_get_aggregate_relationships($feature_id);
-  if (!$relationships) {
-    return array();
-  }
-
-
-  // iterate through each of the realtionships features and get their
-  // locations
-  foreach ($relationships as $rindex => $rel) {
-    // get the featurelocs for each of the relationship features
-    $rel_featurelocs = chado_get_featurelocs($rel->subject_id, 'as_child', 0);
-    foreach ($rel_featurelocs as $rfindex => $rel_featureloc) {
-      // keep track of this unique source feature
-      $src = $rel_featureloc->src_feature_id . "-" . $rel_featureloc->src_cvterm_id;
-
-      // copy over the results to the relationship object.  Since there can
-      // be more than one feature location for each relationship feature we
-      // use the '$src' variable to keep track of these.
-      $rel->featurelocs = new stdClass();
-      $rel->featurelocs->$src = new stdClass();
-      $rel->featurelocs->$src->src_uniquename = $rel_featureloc->src_uniquename;
-      $rel->featurelocs->$src->src_cvterm_id  = $rel_featureloc->src_cvterm_id;
-      $rel->featurelocs->$src->src_cvname     = $rel_featureloc->src_cvname;
-      $rel->featurelocs->$src->fmin           = $rel_featureloc->fmin;
-      $rel->featurelocs->$src->fmax           = $rel_featureloc->fmax;
-      $rel->featurelocs->$src->src_name       = $rel_featureloc->src_name;
-
-      // keep track of the individual parts for each relationship
-      $start = $rel->featurelocs->$src->fmin;
-      $end   = $rel->featurelocs->$src->fmax;
-      $type  = $rel->subject_type;
-      $rel_locs[$src]['parts'][$start][$type]['start'] = $start;
-      $rel_locs[$src]['parts'][$start][$type]['end']   = $end;
-      $rel_locs[$src]['parts'][$start][$type]['type']  = $type;
-    }
-  }
-
-  // the featurelocs array provided to the function contains the locations
-  // where this feature is found.   We want to get the sequence for each
-  // location and then annotate it with the parts found from the relationships
-  // locations determiend above.
-  $floc_sequences = array();
-  foreach ($featurelocs as $featureloc) {
-
-    // build the src name so we can keep track of the different parts for each feature
-    $src = $featureloc->srcfeature_id->feature_id . "-" . $featureloc->srcfeature_id->type_id->cvterm_id;
-
-    // orient the parts to the beginning of the feature sequence
-    if (!empty($rel_locs[$src]['parts'])) {
-      $parts = $rel_locs[$src]['parts'];
-      $rparts = array();  // we will fill this up if we're on the reverse strand
-
-      foreach ($parts as $start => $types) {
-        foreach ($types as $type_name => $type) {
-          if ($featureloc->strand >= 0) {
-            // this is on the forward strand.  We need to convert the start on the src feature to the
-            // start on this feature's sequence
-            $parts[$start][$type_name]['start'] = $parts[$start][$type_name]['start'] - $featureloc->fmin;
-            $parts[$start][$type_name]['end']   = $parts[$start][$type_name]['end'] - $featureloc->fmin;
-            $parts[$start][$type_name]['type']  = $type_name;
-          }
-          else {
-            // this is on the reverse strand.  We need to swap the start and stop and calculate from the
-            // begining of the reverse sequence
-            $size = ($featureloc->fmax - $featureloc->fmin);
-            $start_orig = $parts[$start][$type_name]['start'];
-            $end_orig = $parts[$start][$type_name]['end'];
-            $new_start = $size - ($end_orig - $featureloc->fmin);
-            $new_end = $size - ($start_orig - $featureloc->fmin);
-
-            $rparts[$new_start][$type_name]['start'] = $new_start;
-            $rparts[$new_start][$type_name]['end']   = $new_end;
-            $rparts[$new_start][$type_name]['type']  = $type_name;
-          }
-        }
-      }
-
-      // now sort the parts
-      // if we're on the reverse strand we need to resort
-      if ($featureloc->strand >= 0) {
-        usort($parts, 'chado_feature__residues_sort_rel_parts_by_start');
-      }
-      else {
-        usort($rparts, 'chado_feature__residues_sort_rel_parts_by_start');
-        $parts = $rparts;
-      }
-
-      $floc_sequences[$src]['id'] = $src;
-      $floc_sequences[$src]['type'] = $featureloc->feature_id->type_id->name;
-      $args = array(':feature_id' => $featureloc->srcfeature_id->feature_id);
-      $start = $featureloc->fmin + 1;
-      $size = $featureloc->fmax - $featureloc->fmin;
-
-      // TODO: fix the hard coded $start and $size
-      // the $start and $size variables are hard-coded in the SQL statement
-      // because the db_query function places quotes around all placeholders
-      // (e.g. :start & :size) and screws up the substring function
-      $sql = "
-        SELECT substring(residues from $start for $size) as residues
-        FROM {feature}
-        WHERE feature_id = :feature_id
-      ";
-      $sequence = chado_query($sql, $args)->fetchObject();
-      $residues = $sequence->residues;
-      if ($featureloc->strand < 0) {
-        $residues = tripal_reverse_compliment_sequence($residues);
-      }
-      $strand = '.';
-      if ($featureloc->strand == 1) {
-        $strand = '+';
-      }
-      elseif ($featureloc->strand == -1) {
-        $strand = '-';
-      }
-      $floc_sequences[$src]['location'] = tripal_get_location_string($featureloc);
-      $floc_sequences[$src]['defline'] = tripal_get_fasta_defline($featureloc->feature_id, '', $featureloc, '', strlen($residues));
-      $floc_sequences[$src]['featureloc'] = $featureloc;
-      $floc_sequences[$src]['residues'] = $residues;
-      //$floc_sequences[$src]['formatted_seq'] =  tripal_feature_color_sequence($residues, $parts, $floc_sequences[$src]['defline']);
-    }
-  }
-  return $floc_sequences;
-}
-
-/**
- * Get features related to the current feature to a given depth. Recursive function.
- *
- * @param $feature_id
- * @param $substitute
- * @param $levels
- * @param $base_type_id
- * @param $depth
- *
- */
-function chado_get_aggregate_feature_relationships($feature_id, $substitute=1,
-  $levels=0, $base_type_id=NULL, $depth=0) {
-
-  // we only want to recurse to as many levels deep as indicated by the
-  // $levels variable, but only if this variable is > 0. If 0 then we
-  // recurse until we reach the end of the relationships tree.
-  if ($levels > 0 and $levels == $depth) {
-    return NULL;
-  }
-
-  // first get the relationships for this feature
-  return chado_get_feature_relationships($feature_id, 'as_object');
-
-}
-
-/**
- * Get the relationships for a feature.
- *
- * @param $feature_id
- *   The feature to get relationships for
- * @param $side
- *   The side of the relationship this feature is (ie: 'as_subject' or 'as_object')
- *
- */
-function chado_get_feature_relationships($feature_id, $side = 'as_subject') {
-
-  $feature = chado_generate_var('feature', array('feature_id' => $feature_id));
-
-  // get the relationships for this feature.  The query below is used for both
-  // querying the object and subject relationships
-  $sql = "
-    SELECT
-    FS.name as subject_name, FS.uniquename as subject_uniquename,
-      CVTS.name as subject_type, CVTS.cvterm_id as subject_type_id,
-      FR.subject_id, FR.type_id as relationship_type_id, FR.object_id, FR.rank,
-      CVT.name as rel_type,
-      FO.name as object_name, FO.uniquename as object_uniquename,
-      CVTO.name as object_type, CVTO.cvterm_id as object_type_id
-    FROM {feature_relationship} FR
-     INNER JOIN {cvterm} CVT  ON FR.type_id    = CVT.cvterm_id
-     INNER JOIN {feature} FS  ON FS.feature_id = FR.subject_id
-     INNER JOIN {feature} FO  ON FO.feature_id = FR.object_id
-     INNER JOIN {cvterm} CVTO ON FO.type_id    = CVTO.cvterm_id
-     INNER JOIN {cvterm} CVTS ON FS.type_id    = CVTS.cvterm_id
-  ";
-  if (strcmp($side, 'as_object')==0) {
-    $sql .= " WHERE FR.object_id = :feature_id";
-  }
-  if (strcmp($side, 'as_subject')==0) {
-    $sql .= " WHERE FR.subject_id = :feature_id";
-  }
-  $sql .= " ORDER BY FR.rank";
-
-  // get the relationships
-  $results = chado_query($sql, array(':feature_id' => $feature_id));
-
-  // Get the bundle for this feature type, if one exists.
-  $term = tripal_load_term_entity(array(
-    'vocabulary' => $feature->type_id->dbxref_id->db_id->name,
-    'accession' => $feature->type_id->dbxref_id->accession,
-  ));
-  $bundle = tripal_load_bundle_entity(array('term_id' => $term->id));
-
-  // iterate through the relationships, put these in an array and add
-  // in the Drupal node id if one exists
-  $i=0;
-  $relationships = array();
-  while ($rel = $results->fetchObject()) {
-
-    $entity = chado_get_record_entity_by_bundle($bundle, $rel->subject_id);
-    if ($entity) {
-      $rel->subject_entity_id = $entity->entity_id;
-    }
-    $entity = chado_get_record_entity_by_bundle($bundle, $rel->object_id);
-    if ($entity) {
-      $rel->object_entity_id = $entity->entity_id;
-    }
-    $relationships[$i++] = $rel;
-  }
-  return $relationships;
-}
-
-/**
- * Load the locations for a given feature
- *
- * @param $feature_id
- *   The feature to look up locations for
- * @param $side
- *   Whether the feature is the scrfeature, 'as_parent', or feature, 'as_child'
- * @param $aggregate
- *   Whether or not to get the locations for related features
- *
- * @ingroup tripal_feature
- */
-function chado_get_featurelocs($feature_id, $side = 'as_parent', $aggregate = 1) {
-
-  $sql = "
-    SELECT
-       F.name, F.feature_id, F.uniquename,
-       FS.name as src_name, FS.feature_id as src_feature_id, FS.uniquename as src_uniquename,
-       CVT.name as cvname, CVT.cvterm_id,
-       CVTS.name as src_cvname, CVTS.cvterm_id as src_cvterm_id,
-       FL.fmin, FL.fmax, FL.is_fmin_partial, FL.is_fmax_partial,FL.strand, FL.phase
-     FROM {featureloc} FL
-       INNER JOIN {feature} F   ON FL.feature_id = F.feature_id
-       INNER JOIN {feature} FS  ON FS.feature_id = FL.srcfeature_id
-       INNER JOIN {cvterm} CVT  ON F.type_id     = CVT.cvterm_id
-       INNER JOIN {cvterm} CVTS ON FS.type_id    = CVTS.cvterm_id
-       ";
-  if (strcmp($side, 'as_parent')==0) {
-    $sql .= "WHERE FL.srcfeature_id = :feature_id ";
-  }
-  if (strcmp($side, 'as_child')==0) {
-    $sql .= "WHERE FL.feature_id = :feature_id ";
-  }
-
-  $flresults = chado_query($sql, array(':feature_id' => $feature_id));
-
-  // copy the results into an array
-  $i=0;
-  $featurelocs = array();
-  while ($loc = $flresults->fetchObject()) {
-    // if a drupal entity exists for this feature then add the nid to the
-    // results object
-
-
-    // Get the bundle for this feature type, if one exists.
-    $ffeature = chado_generate_var('feature', array('feature_id' => $loc->feature_id));
-    $sfeature = chado_generate_var('feature', array('feature_id' => $loc->src_feature_id));
-    $fterm = tripal_load_term_entity(array(
-      'vocabulary' => $ffeature->type_id->dbxref_id->db_id->name,
-      'accession' => $ffeature->type_id->dbxref_id->accession,
-    ));
-    $sterm = tripal_load_term_entity(array(
-      'vocabulary' => $sfeature->type_id->dbxref_id->db_id->name,
-      'accession' => $sfeature->type_id->dbxref_id->accession,
-    ));
-
-    if($fterm) {
-      $fbundle = tripal_load_bundle_entity(array('term_id' => $fterm->id));
-      $loc->feid = chado_get_record_entity_by_bundle($fbundle, $loc->feature_id);
-    }
-    if ($sterm) {
-      $sbundle = tripal_load_bundle_entity(array('term_id' => $sterm->id));
-      $loc->seid = chado_get_record_entity_by_bundle($sbundle, $loc->src_feature_id);
-    }
-    // add the result to the array
-    $featurelocs[$i++] = $loc;
-  }
-
-  // Add the relationship feature locs if aggregate is turned on
-  if ($aggregate and strcmp($side, 'as_parent')==0) {
-  // get the relationships for this feature without substituting any children
-  // for the parent. We want all relationships
-  $relationships = _tripal_feature_get_aggregate_relationships($feature_id, 0);
-  foreach ($relationships as $rindex => $rel) {
-    // get the featurelocs for each of the relationship features
-    $rel_featurelocs = tripal_feature_load_featurelocs($rel->subject_id, 'as_child', 0);
-      foreach ($rel_featurelocs as $findex => $rfloc) {
-        $featurelocs[$i++] = $rfloc;
-      }
-    }
-  }
-
-  usort($featurelocs, 'chado_feature__residues_sort_locations');
-  return $featurelocs;
-}
-
-/**
- * Get features related to the current feature to a given depth. Recursive function.
- *
- * @param $feature_id
- * @param $substitute
- * @param $levels
- * @param $base_type_id
- * @param $depth
- *
- */
-function _tripal_feature_get_aggregate_relationships($feature_id, $substitute=1,
-    $levels=0, $base_type_id=NULL, $depth=0) {
-
-  // we only want to recurse to as many levels deep as indicated by the
-  // $levels variable, but only if this variable is > 0. If 0 then we
-  // recurse until we reach the end of the relationships tree.
-  if ($levels > 0 and $levels == $depth) {
-    return NULL;
-  }
-
-  // first get the relationships for this feature
-  return _tripal_feature_load_relationships($feature_id, 'as_object');
-
-}
-
-/**
- * Get the relationships for a feature.
- *
- * @param $feature_id
- *   The feature to get relationships for
- * @param $side
- *   The side of the relationship this feature is (ie: 'as_subject' or 'as_object')
- *
- */
-function _tripal_feature_load_relationships($feature_id, $side = 'as_subject') {
-  // Get the relationships for this feature.  The query below is used for both
-  // querying the object and subject relationships
-  $sql = "
-    SELECT
-      FS.name as subject_name, FS.uniquename as subject_uniquename,
-      CVTS.name as subject_type, CVTS.cvterm_id as subject_type_id,
-      FR.subject_id, FR.type_id as relationship_type_id, FR.object_id, FR.rank,
-      CVT.name as rel_type,
-      FO.name as object_name, FO.uniquename as object_uniquename,
-      CVTO.name as object_type, CVTO.cvterm_id as object_type_id
-    FROM {feature_relationship} FR
-     INNER JOIN {cvterm} CVT  ON FR.type_id    = CVT.cvterm_id
-     INNER JOIN {feature} FS  ON FS.feature_id = FR.subject_id
-     INNER JOIN {feature} FO  ON FO.feature_id = FR.object_id
-     INNER JOIN {cvterm} CVTO ON FO.type_id    = CVTO.cvterm_id
-     INNER JOIN {cvterm} CVTS ON FS.type_id    = CVTS.cvterm_id
-  ";
-  if (strcmp($side, 'as_object')==0) {
-    $sql .= " WHERE FR.object_id = :feature_id";
-  }
-  if (strcmp($side, 'as_subject')==0) {
-    $sql .= " WHERE FR.subject_id = :feature_id";
-  }
-  $sql .= " ORDER BY FR.rank";
-
-  // Get the relationships.
-  $results = chado_query($sql, array(':feature_id' => $feature_id));
-
-  // Iterate through the relationships, put these in an array and add
-  // in the Drupal node id if one exists.
-  $i=0;
-  $nodesql = "SELECT nid FROM {chado_feature} WHERE feature_id = :feature_id";
-  $relationships = array();
-  while ($rel = $results->fetchObject()) {
-    $node = db_query($nodesql, array(':feature_id' => $rel->subject_id))->fetchObject();
-    if ($node) {
-      $rel->subject_nid = $node->nid;
-    }
-    $node = db_query($nodesql, array(':feature_id' => $rel->object_id))->fetchObject();
-    if ($node) {
-      $rel->object_nid = $node->nid;
-    }
-    $relationships[$i++] = $rel;
-  }
-  return $relationships;
-}
-/**
-  * Used to sort the list of relationship parts by start position
-  *
-  * @ingroup tripal_feature
-  */
-function chado_feature__residues_sort_rel_parts_by_start($a, $b) {
-  foreach ($a as $type_name => $details) {
-    $astart = $a[$type_name]['start'];
-    break;
-  }
-  foreach ($b as $type_name => $details) {
-    $bstart = $b[$type_name]['start'];
-    break;
-  }
-  return strnatcmp($astart, $bstart);
-}
-/**
- * Used to sort the feature locs by start position
- *
- * @param $a
- *   One featureloc record (as an object)
- * @param $b
- *   The other featureloc record (as an object)
- *
- * @return
- *   Which feature location comes first
- *
- * @ingroup tripal_feature
- */
-function chado_feature__residues_sort_locations($a, $b) {
-  return strnatcmp($a->fmin, $b->fmin);
-}
-

tripal_chado/api/modules/tripal_chado.module.DEPRECATED.api.inc

@@ -0,0 +1,1522 @@
+<?php
+
+/**
+ * @file
+ *
+ * These api functions are deprecated, if your site is currently using them
+ * please update your code with the newer tripal_chado functions.
+ */
+
+/**
+ * @defgroup tripal_chado_module_DEPRECATED_api
+ * @ingroup tripal_chado_api
+ * @{
+ * Deprecated legacy api code.
+ * @}
+ */
+
+
+/**tripal_analysis_api*/
+/**
+ * Retrieves a chado analysis variable.
+ *
+ * @param $itentifier
+ *   an array with the key stating what the identifier is. Supported keys 
+ *   (only on of the following unique keys is required):
+ *    - analysis_id: the chado analysis.analysis_id primary key.
+ *    - nid: the drupal node.nid primary key.
+ *   There are also some specially handled keys. They are:
+ *    - property: An array/object describing the property to select records for. 
+ *      It should at least have either a type_name (if unique across cvs) or 
+ *      type_id. Other supported keys include: cv_id/cv_name (of the type), 
+ *      value and rank.
+ * @param $options
+ *   An array of options. Supported keys include:
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition for additional details.
+ *
+ * NOTE: the $identifier parameter can really be any array similar to $values 
+ * passed into chado_select_record(). It should fully specify the stock record 
+ * to be returned.
+ *
+ * @return
+ *   the analysis node matching the passed in identifier
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_analysis($identifier, $options) {
+  chado_get_analysis($identifier, $options);
+}
+
+/**
+ * Returns a list of analyses that are currently synced with Drupal to use in 
+ * select lists.
+ *
+ * @param $syncd_only
+ *   Whether or not to return all chado analyses or just those sync'd with 
+ *   drupal. Defaults to TRUE (only sync'd analyses).
+ * @return
+ *   An array of analyses sync'd with Drupal where each value is the analysis 
+ *   scientific name and the keys are analysis_id's.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_analysis_select_options($syncd_only = true) {
+  chado_get_analysis_select_options($syncd_only);
+}
+
+/**tripal_contact_api*/
+/**
+ * Adds a contact to the Chado contact table.
+ *
+ * @param $values
+ *   An array of values to be inserted. Valid keys include:
+ *   - name: The name of the contact.
+ *   - description: Text describing the contact.
+ *   - type_name: The type of contact.  Must be a term in the tripal_contact 
+ *     vocabulary.
+ *   - properties: An associative array containing a list of key value pairs for
+ *     the properites. The key's must be valid terms in the tripal_contact 
+ *     vocabulary (e.g. Affiliation, Address, etc).
+ *
+ * @return
+ *   On success, an array is returned containing the fields of the contact
+ *   record including the newly added contact_id. On failure, FALSE is
+ *   returned.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_insert_contact($values) {
+  chado_insert_contact($values); 
+}
+
+/**
+ * This function is intended to be used in autocomplete forms for contacts.
+ *
+ * @param $text
+ *   The string to search for.
+ *
+ * @return
+ *   A json array of terms that begin with the provided string.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_autocomplete_contact($text) {
+  chado_autocomplete_contact($text);
+}
+
+/**tripal_chado_cv_api*/
+/**
+ * Retrieves a chado controlled vocabulary variable
+ *
+ * @param $identifier
+ *   An array with the key stating what the identifier is. Supported keys (only 
+ *   on of the following unique keys is required):
+ *    - cv_id: the chado cv.cv_id primary key.
+ *    - name: the chado cv.name field (assume unique).
+ * @param $options
+ *   An array of options. Supported keys include:
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition fot additional details.
+ *
+ * NOTE: the $identifier parameter can really be any array similar to $values 
+ * passed into chado_select_record(). It should fully specify the cv record to 
+ * be returned.
+ *
+ * @return
+ *   If unique values were passed in as an identifier then an object describing 
+ *   the cv will be returned (will be a chado variable from 
+ *   chado_generate_var()). Otherwise, FALSE will be returned.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_cv($identifiers, $options = array()) {
+  chado_get_cv($identifiers, $options);
+}
+
+/**
+ * Create an options array to be used in a form element which provides a
+ * list of all chado cvs.
+ *
+ * @return
+ *   An array(cv_id => name) for each cv in the chado cv table.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_cv_select_options() {
+  chado_get_cv_select_options();
+}
+
+/**
+ * Retrieves a chado controlled vocabulary term variable.
+ *
+ * @param $identifier
+ *   An array apropriate for use with the chado_generate_var for uniquely
+ *   identifying a cvterm record. Alternativley, there are also some specially
+ *   handled keys. They are:
+ *    - id: an ID for the term of the for [dbname]:[accession], where [dbname]
+ *      is the short name of the vocabulary and accession is the unique ID.
+ *    - cv_id:  an integer indicating the cv_id or an array with 'name' => the
+ *      name of the cv.
+ *    - synonym: an array with 'name' => the name of the synonym of the cvterm
+ *      you want returned; 'cv_id' => the cv_id of the synonym; 'cv_name' =>
+ *      the name of the cv of the synonym.
+ *    - property: An array/object describing the property to select records
+ *      for. It should at least have either a type_name (if unique across cvs)
+ *      or type_id. Other supported keys include: cv_id/cv_name (of the type),
+ *      value and rank.
+ * @param $options
+ *   An array of options. Supported keys include:
+ *     - Any keys supported by chado_generate_var(). See that function
+ *       definition for additional details.
+ *
+ * NOTE: the $identifier parameter can really be any array similar to $values
+ *   passed into chado_select_record(). It should fully specify the cvterm
+ *   record to be returned.
+ *
+ * @return
+ *   If unique values were passed in as an identifier then an object describing
+ *   the cvterm will be returned (will be a chado variable from
+ *   chado_generate_var()). Otherwise, FALSE will be returned.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_cvterm($identifiers, $options = array()) {
+  chado_get_cvterm($identifiers, $options);
+}
+
+/**
+ * Create an options array to be used in a form element
+ *   which provides a list of all chado cvterms.
+ *
+ * @param $cv_id
+ *   The chado cv_id; only cvterms with the supplied cv_id will be returnedl.
+ * @param $rel_type
+ *   Set to TRUE if the terms returned should only be relationship types in
+ *   the vocabulary.  This is useful for creating drop-downs of terms
+ *   used for relationship linker tables.
+ *
+ * @return
+ *   An associative array with the cvterm_id's as keys. The first
+ *   element in the array has a key of '0' and a value of 'Select a Type'.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_cvterm_select_options($cv_id, $rel_type = false) {
+  chado_get_cvterm_select_options($cv_id, $rel_type);
+}
+
+/**
+ * Duplicate of fill_cvtermpath() stored procedure in Chado.
+ *
+ * Identifies all of the root terms of the controlled vocabulary. These
+ * root terms are then processed by calling the
+ * chado_update_cvtermpath_root_loop() function on each one.
+ *
+ * @param $cvid
+ *   The controlled vocabulary ID from the cv table of Chado (i.e. cv.cv_id).
+ * @param $job_id
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_update_cvtermpath($cv_id, $job_id = null) {
+  chado_update_cvtermpath($cv_id, $job_id);
+}
+
+/**
+ * Adds a controlled vocabulary to the CV table of Chado.
+ *
+ * @param $name
+ *   The name of the controlled vocabulary. These are typically all lower case
+ *   with no special characters other than an undrescore (for spaces).
+ * @param $comment
+ *   A description or definition of the vocabulary.
+ *
+ * @return
+ *   An object populated with fields from the newly added database.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_insert_cv($name, $definition) {
+  chado_insert_cv($name, $definition);
+}
+
+/**
+ *  Add's a controlled vocabulary term to Chado.
+ *
+ *  This function will add a cvterm record (and a dbxref record if appropriate
+ *  values are provided). If the parent vocabulary does not exist then
+ *  that also is added to the cv table.  If the cvterm is a relationship term
+ *  then the 'is_relationship' value should be set.  All
+ *  terms must also have a corresponding database.  This is specified in the
+ *  term's ID just before the colon (e.g. GO:003824).  If the database does not
+ *  exist in the DB table then it will be added automatically.  The accession
+ *  (the value just after the colon in the term's ID) will be added to the
+ *  dbxref table.  If the CVterm already exists and $update is set (default)
+ *  then the cvterm is updated.  If the CVTerm already exists and $update is
+ *  not set, then no changes are made and the CVTerm object is returned.
+ *
+ * @param $term
+ *   An associative array with the following keys:
+ *    - id: the term accession. must be of the form <DB>:<ACCESSION>, where
+ *      <DB> is the name of the database to which the cvterm belongs and the
+ *      <ACCESSION> is the term's accession number in the database.
+ *    - name: the name of the term. usually meant to be human-readable.
+ *    - is_obsolete: is present and set to 1 if the term is defunct.
+ *    - definition: the definition of the term.
+ *    - cv_name: The CV name to which the term belongs.  If this arugment is
+ *        null or not provided then the function tries to find a record in the
+ *        CV table with the same name provided in the $term[namespace].  If
+ *        this field is provided then it overrides what the value in
+ *        $term[namespace].
+ *    - is_relationship: If this term is a relationship term then this value
+ *        should be 1.
+ *    - db_name: In some cases the database name will not be part of the
+ *        $term['id'] and it needs to be explicitly set.  Use this argument
+ *        only if the database name cannot be specififed in the term ID
+ *        (e.g. <DB>:<ACCESSION>).
+ * @param $options
+ *   An associative array with the following keys:
+ *    - update_existing: By default this is TRUE.  If the term exists it is
+ *      automatically updated.
+ *
+ * @return
+ *   A cvterm object
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_insert_cvterm($term, $options = array()) {
+  chado_insert_cvterm($term, $options);
+}
+
+/**
+ * TODO: deprecate this function
+ *
+ * Avoid using this function as it will be deprecated in future releases.
+ * 
+ * This function allows other modules to programatically
+ * submit an ontology for loading into Chado.
+ *
+ * This function will add a job to the Jobs subsystem for parsing the ontology.
+ * You can either pass a known OBO ID to the function or the URL
+ * or full path the the ontology file.  If a URL or file name is
+ * passed then the $obo_name argument must also be provided.  If
+ * this is the first time the ontology has been provided to Tripal
+ * then it will be added to the database and will be assigned a
+ * unique OBO ID.
+ *
+ * @param $obo_id
+ *   If the ontology is already loaded into the Tripal tables then
+ *   use this argument to specify the unique ID for the ontology
+ *   that will be loaded.
+ * @param $obo_name
+ *   If the OBO has not been added before then use this argument
+ *   to specify the human readable name of the ontology.
+ * @param $obo_url
+ *   If the OBO to be loaded is located on a remote server then
+ *   use this argument to provide the URL.
+ * @param $obo_file
+ *   If the OBO is housed on the local file system of the server then
+ *   use this argument to specify the full path.
+ *
+ * @return
+ *   returns the job_id of the submitted job or FALSE if the job was not added
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_submit_obo_job($obo) {
+  chado_submit_obo_job($obo);
+}
+
+/**
+ * Add the OBO to the tripal_cv_obo table in the Drupal database.
+ *
+ * If the OBO name already exists in the table then the path is updated.
+ *
+ * @param $name
+ *   The human readable name of this ontology.
+ * @param $path
+ *   The file path or URL of the ontology.
+ *
+ * @return
+ *   Returns the ontology ID.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_insert_obo($name, $path) {
+  chado_insert_obo($name, $path);
+}
+
+/**
+ * Retrieves an OBO record.
+ *
+ * @param $values
+ *   An associate array with the following allowed keys: obo_id, name.
+ *
+ * @return
+ *   An instance of an OBO record object.
+ * 
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_obo($values) {
+  chado_get_obo($values);
+}
+
+/**
+ * This function is intended to be used in autocomplete forms.
+ *
+ * This function searches for a matching controlled vobulary name.
+ *
+ * @param $string
+ * The string to search for.
+ *
+ * @return
+ * A json array of terms that begin with the provided string.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_autocomplete_cv($string = '') {
+  chado_autocomplete_cv($string);
+}
+
+/**
+ * This function is intended to be used in autocomplete forms
+ * for searching for CV terms that begin with the provided string.
+ *
+ * @param $cv_id
+ * The CV ID in which to search for the term.
+ * @param $string
+ * The string to search for.
+ *
+ * @return
+ * A json array of terms that begin with the provided string.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_autocomplete_cvterm($cv_id, $string = '') {
+  chado_autocomplete_cvterm($cv_id, $string);
+}
+
+/**
+ * Add a record to a cvterm linking table (ie: feature_cvterm).
+ *
+ * @param $basetable
+ *   The base table to which the cvterm should be linked/associated. Thus to 
+ *   associate a cvterm to a feature the basetable=feature and cvterm_id is
+ *   added to the feature_cvterm table.
+ * @param $record_id
+ *   The primary key of the basetable to associate the cvterm with. This should 
+ *   be in integer.
+ * @param $cvterm
+ *   An associative array describing the cvterm. Valid keys include:
+ *     - name: the name for the cvterm,
+ *     - cv_name: the name of the cv the cvterm belongs to.
+ *     - cv_id: the primary key of the cv the cvterm belongs to.
+ * @param $options
+ *   An associative array of options. Valid keys include:
+ *     - insert_cvterm: Insert the cvterm if it doesn't already exist. FALSE is 
+ *       the default.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_associate_cvterm($basetable, $record_id, $cvterm, $options = array()) {
+  chado_associate_cvterm($basetable, $record_id, $cvterm, $options);
+}
+
+/**tripal_chado_database_api*/
+/**
+ * Retrieves a chado db variable.
+ *
+ * Example Usage:
+ * @code
+ *   $select_values = array(
+ *     'name' => 'SOFP'
+ *   );
+ *   $db_object = tripal_get_db($select_values);
+ * @endcode
+ *  The above code selects the SOFP db and returns the following object:
+ * @code
+ *   $db_object = stdClass Object (
+ *     [db_id] => 49
+ *     [name] => SOFP
+ *     [description] =>
+ *     [urlprefix] =>
+ *     [url] =>
+ *   );
+ * @endcode
+ *
+ * @param $identifier
+ *   An array with the key stating what the identifier is. Supported keys (only 
+ *   on of the following unique keys is required):
+ *    - db_id: the chado db.db_id primary key.
+ *    - name: the chado db.name field (assume unique).
+ * @param $options
+ *   An array of options. Supported keys include:
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition for additional details.
+ *
+ * NOTE: the $identifier parameter can really be any array similar to $values 
+ * passed into chado_select_record(). It should fully specify the db record to 
+ * be returned.
+ *
+ * @return
+ *   If unique values were passed in as an identifier then an object describing 
+ *   the cv will be returned (will be a chado variable from 
+ *   chado_generate_var()). Otherwise, an array of objects will be returned.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_db($identifiers, $options = array()) {
+  chado_get_db($identifiers, $options);
+}
+
+/**
+ * Create an options array to be used in a form element
+ *   which provides a list of all chado dbs.
+ *
+ * @return
+ *   An array(db_id => name) for each db in the chado db table.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_db_select_options() {
+  chado_get_db_select_options();
+}
+
+/**
+ * Retrieves a chado database reference variable.
+ *
+ * Example Usage:
+ * @code
+ *   $identifiers = array(
+ *     'accession' => 'synonym',
+ *     'db_id' => array(
+ *       'name' => 'SOFP'
+ *     )
+ *   );
+ *   $dbxref_object = tripal_get_dbxref($identifiers);
+ * @endcode
+ *  The above code selects the synonym database reference and returns the 
+ *  following object:
+ * @code
+ *  $dbxref_object = stdClass Object (
+ *     [dbxref_id] => 2581
+ *     [accession] => synonym
+ *     [description] =>
+ *     [version] =>
+ *     [db_db_id] => 49
+ *     [db_name] => SOFP
+ *     [db_description] =>
+ *     [db_urlprefix] =>
+ *     [db_url] =>
+ *   );
+ * @endcode
+ *
+ * @param $identifier
+ *   An array apropriate for use with the chado_generate_var for uniquely
+ *   identifying a dbxref record. Alternatively, there are also some specially
+ *   handled keys. They are:
+ *    - property: An array/object describing the property to select records for. 
+ *      It should at least have either a type_name (if unique across cvs) or 
+ *      type_id. Other supported keys include: cv_id/cv_name (of the type), 
+ *      value and rank.
+ * @param $options
+ *   An array of options. Supported keys include:
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition for additional details.
+ *
+ * NOTE: the $identifier parameter can really be any array similar to $values 
+ * passed into chado_select_record(). It should fully specify the dbxref record 
+ * to be returned.
+ *
+ * @return
+ *   If unique values were passed in as an identifier then an object describing 
+ *   the dbxref will be returned (will be a chado variable from 
+ *   chado_generate_var()). Otherwise, FALSE will be returned.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_dbxref($identifiers, $options = array()) {
+  chado_get_dbxref($identifiers, $options);
+}
+
+/**
+ * Generates a URL for the controlled vocabulary term.
+ *
+ * If the URL and URL prefix are provided for the database record of a cvterm
+ * then a URL can be created for the term.  By default, the db.name and
+ * dbxref.accession are concatenated and appended to the end of the db.urlprefix.
+ * But Tripal supports the use of {db} and {accession} tokens when if present
+ * in the db.urlprefix string will be replaced with the db.name and
+ * dbxref.accession respectively.
+ *
+ * @param $dbxref
+ *   A dbxref object as created by the chado_generate_var() function.
+ *
+ * @return
+ *   A string containing the URL.
+ * 
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_dbxref_url($dbxref) {
+  chado_get_dbxref_url($dbxref);
+}
+
+/**
+ * Adds a new database to the Chado DB table and returns the DB object.
+ *
+ * @param $values
+ *   An associative array of the values of the db (those to be inserted):
+ *   - name: The name of the database. This name is usually used as the prefix 
+ *     for CV term accessions.
+ *   - description: (Optional) A description of the database.  By default no 
+ *     description is required.
+ *   - url: (Optional) The URL for the database.
+ *   - urlprefix: (Optional) The URL that is to be used as a prefix when 
+ *     constructing a link to a database term.
+ * @param $options
+ *   Optional. An associative array of options that can include:
+ *   - update_existing: Set this to '1' to force an update of the database if it
+ *     already exists. The default is to not update. If the database exists
+ *     then nothing is added.
+ *
+ * @return
+ *   An object populated with fields from the newly added database.  If the
+ *   database already exists it returns the values in the current entry.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_insert_db($values, $options = array()) {
+  chado_insert_db($values, $options);
+}
+
+/**
+ * Add a database reference.
+ *
+ * @param $values
+ *   An associative array of the values to be inserted including:
+ *    - db_id: the database_id of the database the reference is from.
+ *    - accession: the accession.
+ *    - version: (Optional) The version of the database reference.
+ *    - description: (Optional) A description of the database reference.
+ *
+ * @return
+ *   The newly inserted dbxref as an object, similar to that returned by
+ *   the chado_select_record() function.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_insert_dbxref($values) {
+  chado_insert_dbxref($values);
+}
+
+/**
+ * Add a record to a database reference linking table (ie: feature_dbxref).
+ *
+ * @param $basetable
+ *   The base table for which the dbxref should be associated. Thus to associate 
+ *   a dbxref with a feature the basetable=feature and dbxref_id is added to the
+ *   feature_dbxref table.
+ * @param $record_id
+ *   The primary key of the basetable to associate the dbxref with. This should 
+ *   be in integer.
+ * @param $dbxref
+ *   An associative array describing the dbxref. Valid keys include: 
+ *   'accession' => the accession for the dbxref, 'db_name' => the name of the 
+ *    database the dbxref belongs to.
+ *   'db_id' => the primary key of the database the dbxref belongs to.
+ * @param $options
+ *   An associative array of options. Valid keys include:
+ *    - insert_dbxref: Insert the dbxref if it doesn't already exist. TRUE is 
+ *      the default.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_associate_dbxref($basetable, $record_id, $dbxref, $options = array()) {
+  chado_associate_dbxref($basetable, $record_id, $dbxref, $options);
+}
+
+/**
+ * This function is intended to be used in autocomplete forms
+ * for searching for accession that begin with the provided string.
+ *
+ * @param $db_id
+ *   The DB ID in which to search for the term.
+ * @param $string
+ *   The string to search for.
+ *
+ * @return
+ *   A json array of terms that begin with the provided string.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_autocomplete_dbxref($db_id, $string = '') {
+  chado_autocomplete_dbxref($db_id, $string);
+}
+
+/**tripal_feature_api*/
+/**
+ * Used for autocomplete in forms for identifying for publications.
+ *
+ * @param $field
+ *   The field in the publication to search on.
+ * @param $string
+ *   The string to search for.
+ *
+ * @return
+ *   A json array of terms that begin with the provided string.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_autocomplete_feature($string = '') {
+  chado_autocomplete_feature($string);
+}
+
+/**
+ * Performs a reverse compliment of a nucleotide sequence.
+ *
+ * @param $sequence
+ *   The nucelotide sequence.
+ *
+ * @return
+ *   an upper-case reverse complemented sequence.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_reverse_compliment_sequence($sequence) {
+  chado_reverse_compliment_sequence($sequence);
+}
+
+/**
+ * Retrieves the sequences for a given feature.
+ *
+ * If a feature has multiple alignments or multiple relationships then
+ * multiple sequences will be returned.
+ *
+ * @param $feature
+ *   An associative array describing the feature. Valid keys include:
+ *    - feature_id: The feature_id of the feature for which the sequence will
+ *      be retrieved.
+ *    - name: The feature name. This will appear on the FASTA definition line.
+ *    - parent_id:  (optional) only retrieve a sequence if 'derive_from_parent'
+ *      is true and the parent matches this ID.
+ *    - featureloc_id: (optional) only retrieve a sequence if 
+ *      'derive_from_parent' is true and the alignment is defined with this 
+ *      featureloc_id.
+ * @param $options
+ *   An associative array of options. Valid keys include:
+ *    - width: Indicate the number of bases to use per line.  A new line will
+ *      be added after the specified number of bases on each line.
+ *    - is_html: Set to '1' if  the sequence is meant to be displayed on a web
+ *      page. This will cause a <br> tag to separate lines of the FASTA sequence.
+ *    - derive_from_parent: Set to '1' if the sequence should be obtained from
+ *      the parent to which this feature is aligned.
+ *    - aggregate: Set to '1' if the sequence should only contain sub features,
+ *      excluding intro sub feature sequence.  For example, set this option to
+ *      obtain just the coding sequence of an mRNA.
+ *    - upstream: An integer specifing the number of upstream bases to include
+ *      in the output.
+ *    - downstream: An integer specifying the number of downstream bases to
+ *      include in the output.
+ *    - sub_feature_types: Only include sub features (or child features) of
+ *      the types provided in the array.
+ *    - relationship_type: If a relationship name is provided (e.g. sequence_of)
+ *      then any sequences that are in relationships of this type with matched
+ *      sequences are also included.
+ *    - relationship_part: If a relationship is provided in the preceeding
+ *      argument then the rel_part must be either 'object' or 'subject' to
+ *      indicate which side of the relationship the matched features belong.
+ *
+ * @return
+ *   an array of matching sequence in the following keys for each sequence:
+ *    - types: an array of feature types that were used to derive
+ *      the sequence (e.g. from an aggregated sequence)
+ *    - upstream: the number of upstream bases included in the sequence
+ *    - downstream: the number of downstream bases included in the
+ *      sequence
+ *    - defline: the definintion line used to create a FASTA sequence
+ *    - residues: the residues
+ *    - featureloc_id: the featureloc_id if the sequences is from an
+ *        alignment
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_feature_sequences($feature, $options) {
+  chado_get_feature_sequences($feature, $options);
+}
+
+/**
+ * Retrieves the bulk sequences for a given feature.
+ *
+ * @param $options
+ *   An associative array of options for selecting a feature. Valid keys include:
+ *    - org_commonname: The common name of the organism for which sequences
+ *      should be retrieved
+ *    - genus: The genus of the organism for which sequences should be retrieved
+ *    - species: The species of the organism for which sequences should be
+ *      retrieved
+ *    - analysis_name: The name of an analysis to which sequences belong. Only
+ *      those that are associated with the analysis will be retrieved.
+ *    - type: The type of feature (a sequence ontology term).
+ *    - feature_name: the name of the feature. Can be an array of feature names.
+ *    - feature_uname: the uniquename of the feature.  Can be an array of
+ *      feature unique names.
+ *    - upstream: An integer specifing the number of upstream bases to include
+ *      in the output
+ *    - downstream: An integer specifying the number of downstream bases to
+ *      include in the output.
+ *    - derive_from_parent: Set to '1' if the sequence should be obtained from
+ *      the parent to which this feature is aligned.
+ *    - aggregate: Set to '1' if the sequence should only contain sub features,
+ *      excluding intro sub feature sequence.  For example, set this option to
+ *      obtain just the coding sequence of an mRNA.
+ *    - sub_feature_types: Only include sub features (or child features) of
+ *      the types provided in the array
+ *    - relationship_type: If a relationship name is provided (e.g. sequence_of)
+ *      then any sequences that are in relationships of this type with matched
+ *      sequences are also included
+ *    - relationship_part: If a relationship is provided in the preceeding
+ *      argument then the rel_part must be either 'object' or 'subject' to
+ *      indicate which side of the relationship the matched features belong
+ *    - width: Indicate the number of bases to use per line.  A new line will
+ *      be added after the specified number of bases on each line.
+ *    - is_html: Set to '1' if  the sequence is meant to be displayed on a
+ *      web page. This will cause a <br> tag to separate lines of the FASTA
+ *      sequence.
+ * @return
+ *   Returns an array of sequences. The sequences will be in an array with the
+ *   following keys for each sequence:
+ *      'types'         => an array of feature types that were used to derive
+ *         the sequence (e.g. from an aggregated sequence)
+ *      'upstream'      => the number of upstream bases in the sequence
+ *      'downstream'    => the number of downstream bases in the sequence
+ *      'defline'       => the definintion line used to create a FASTA sequence
+ *      'residues'      => the residues
+ *      'featureloc_id' => the featureloc_id if from an alignment
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_bulk_feature_sequences($options) {
+  chado_get_bulk_feature_sequences($options);
+}
+
+/**
+ * Returns a definition line that can be used in a FASTA file.
+ *
+ * @param $feature
+ *   A single feature object containing all the fields from the chado.feature 
+ *   table. Best case is to provide an object generated by the 
+ *   chado_generate_var() function.
+ * @param $notes
+ *   Optional: additional notes to be added to the definition line.
+ * @param $featureloc
+ *   Optional: a single featureloc object generated using chado_generate_var
+ *   that contains a record from the chado.featureloc table. Provide this if the
+ *   sequence was obtained by using the alignment rather than from the 
+ *   feature.residues column.
+ * @param $type
+ *   Optional: the type of sequence. By default the feature type is used.
+ * @param $length
+ *   Optional: the length of the sequence.
+ *
+ * @return
+ *   A string of the format: uniquename|name|type|feature_id
+ *   or if an alignment:  srcfeature_name:fmin..fmax[+-]; alignment of 
+ *   uniquename|name|type|feature_id.
+ * 
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_fasta_defline($feature, $notes = '', $featureloc = null, $type = '', $length = 0) {
+  chado_get_fasta_defline($feature, $notes, $featureloc, $type, $length);
+}
+
+/**
+ * Returns a string representing a feature location in an alignment.
+ *
+ * @param $featureloc
+ *   A single featureloc object generated using chado_generate_var that
+ *   contains a record from the chado.featureloc table.
+ *
+ *  @return
+ *   A string of the format: uniquename:featurelocmin..featurelocmax.strand
+ * 
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_location_string($featureloc) {
+  chado_get_location_string($featureloc);
+}
+
+/**
+ * Retrieves a chado organism variable.
+ *
+ * @param $identifier
+ *   An array with the key stating what the identifier is. Supported keys (only 
+ *   on of the following unique keys is required):
+ *    - organism_id: the chado organism.organism_id primary key.
+ *    - genus & species: the chado organism.genus field & organism.species field.
+ *   There are also some specially handled keys. They are:
+ *    - property: An array/object describing the property to select records for. 
+ *      It should at least have either a type_name (if unique across cvs) or 
+ *      type_id. Other supported keys include: cv_id/cv_name (of the type), 
+ *      value and rank.
+ * @param $options
+ *   An array of options. Supported keys include:
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *      definition for additional details.
+ *
+ * NOTE: the $identifier parameter can really be any array similar to $values 
+ * passed into chado_select_record(). It should fully specify the organism 
+ * record to be returned.
+ *
+ * @return
+ *   If unique values were passed in as an identifier then an object describing 
+ *   the organism will be returned (will be a chado variable from 
+ *   chado_generate_var()). Otherwise, FALSE will be returned.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_organism($identifiers, $options = array()) {
+  chado_get_organism($identifiers, $options);
+}
+
+/**
+ * Returns the full scientific name of an organism.
+ *
+ * @param $organism
+ *   An organism object.
+ * @return
+ *   The full scientific name of the organism.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_organism_scientific_name($organism) {
+  chado_get_organism_scientific_name($organism);
+}
+
+/**
+ * Returns a list of organisms that are currently synced with Drupal to use in 
+ * select lists.
+ *
+ * @param $syncd_only
+ *   Whether or not to return all chado organisms or just those sync'd with 
+ *   drupal. Defaults to TRUE (only sync'd organisms).
+ * @return
+ *   An array of organisms sync'd with Drupal where each value is the organism 
+ *   scientific name and the keys are organism_id's.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_organism_select_options($syncd_only = true) {
+  chado_get_organism_select_options($syncd_only);
+}
+
+/**
+ * Return the path for the organism image.
+ *
+ * @param $organism
+ *   An organism table record.
+ *
+ * @return
+ *   If the type parameter is 'url' (the default) then the fully qualified
+ *   url to the image is returend. If no image is present then NULL is returned.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_organism_image_url($organism) {
+  chado_get_organism_image_url($organism);
+}
+
+/**
+ * This function is intended to be used in autocomplete forms
+ * for searching for organisms that begin with the provided string.
+ *
+ * @param $text
+ *   The string to search for.
+ *
+ * @return
+ *   A json array of terms that begin with the provided string.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_autocomplete_organism($text) {
+  chado_autocomplete_organism($text);
+}
+
+/**
+ * A handy function to abbreviate the infraspecific rank.
+ *
+ * @param $rank
+ *   The rank below species.
+ * @return
+ *   The proper abbreviation for the rank.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_abbreviate_infraspecific_rank($rank) {
+  chado_abbreviate_infraspecific_rank($rank);
+}
+
+/** tripal_phylotree_api */
+/**
+ * Validates an $options array for insert or update of a phylotree record.
+ *
+ * If validation passes then any values that needed validation lookups
+ * (such as the dbxref, analysis, leaf_type, etc) will have their approriate
+ * primary_keys added to the $options array, and missing default values
+ * will also be added.
+ *
+ * @param $val_type
+ *   The type of validation. Can be either 'insert' or 'update'.
+ * @param $options
+ *   An array of key/value pairs containing any of the valid keys for
+ *   either the tripal_insert_phylotree() or tripal_update_phylotree()
+ *   functions.
+ * @param $errors
+ *   An empty array where validation error messages will be set. The keys
+ *   of the array will be name of the field from the options array and the
+ *   value is the error message.
+ * @param $warnings
+ *   An empty array where validation warning messagges will be set. The
+ *   warnings should not stop an insert or an update but should be provided
+ *   to the user as information by a drupal_set_message() if appropriate. The
+ *   keys of the array will be name of the field from the options array and the
+ *   value is the error message.
+ * @return
+ *   If validation failes then FALSE is returned.  Any options that do not pass
+ *   validation checks will be added in the $errors array with the key being
+ *   the option and the value being the error message.  If validation
+ *   is successful then TRUE is returned.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_validate_phylotree($val_type, &$options, &$errors, &$warnings) {
+  chado_validate_phylotree($val_type, $options, $errors, $warnings); 
+}
+
+/**
+ * Inserts a phylotree record into Chado.
+ *
+ * This function validates the options passed prior to insertion of the record,
+ * and if validation passes then any values in the options array that needed
+ * validation lookups (such as the dbxref, analysis, leaf_type, etc) will have
+ * their approriate primary key values added to the options array.
+ *
+ * @param $options
+ *  An array of key value pairs with the following keys required:
+ *     'name':       The name of the tree. This will be displayed to users.
+ *     'description: A description about the tree
+ *     'anlaysis_id: The ID of the analysis to which this phylotree should be
+ *                   associated.
+ *     'analysis':   If the analysis_id key is not used then the analysis name
+ *                   may be provided to identify the analysis to which the tree
+ *                   should be associated.
+ *     'leaf_type':  A sequence ontology term or the word 'organism'. If the
+ *                   type is 'organism' then this tree represents a
+ *                   taxonomic tree.  The default, if not specified, is the
+ *                   term 'polypeptide'.
+ *     'tree_file':  The path of the file containing the phylogenetic tree to
+ *                   import or a Drupal managed_file numeric ID.
+ *     'format':     The file format. Currently only 'newick is supported'.
+ * 
+ *  Optional keys:
+ *     'dbxref':     A database cross-reference of the form DB:ACCESSION.
+ *                   Where DB is the database name, which is already present
+ *                   in Chado, and ACCESSION is the unique identifier for
+ *                   this tree in the remote database.
+ *     'name_re':    If the leaf type is NOT 'taxonomy', then the value of
+ *                   this field can be a regular expression to pull out
+ *                   the name of the feature from the node label in the
+ *                   intput tree. If no value is provided the entire label is
+ *                   used.
+ *     'match':      Set to 'uniquename' if the leaf nodes should be matched
+ *                   with the feature uniquename.
+ *     'load_now':   If set, the tree will be loaded immediately if a tree_file
+ *                   is provided. Otherwise, the tree will be loaded via
+ *                   a Tripal jobs call.
+ *     'no_load':    If set the tree file will not be loaded.
+ * @param $errors
+ *   An empty array where validation error messages will be set. The keys
+ *   of the array will be name of the field from the options array and the
+ *   value is the error message.
+ * @param $warnings
+ *   An empty array where validation warning messagges will be set. The
+ *   warnings should not stop an insert or an update but should be provided
+ *   to the user as information by a drupal_set_message() if appropriate. The
+ *   keys of the array will be name of the field from the options array and the
+ *   value is the error message.
+ * @return
+ *   TRUE for success and FALSE for failure.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_insert_phylotree(&$options, &$errors, &$warnings) {
+  chado_insert_phylotree($options, $errors, $warnings);
+}
+
+/**
+ * Updates a phylotree record into Chado.
+ *
+ * This function validates the options passed prior to update of the record
+ * and if validation passes then any values in the options array that needed
+ * validation lookups (such as the dbxref, analysis, leaf_type, etc) will have
+ * their approriate primary key values added to the options array. A Drupal
+ * File object will be added to the options array for the tree file if one
+ * is provided.
+ *
+ *
+ * @param $phylotree_id
+ *   The ID of the phylotree to update.
+ * @param $options
+ *  An array of key value pairs with the following optional keys:
+ *     'name':       The name of the tree. This will be displayed to users.
+ *     'description: A description about the tree
+ *     'anlaysis_id: The ID of the analysis to which this phylotree should be
+ *                   associated.
+ *     'analysis':   If the analysis_id key is not used then the analysis name
+ *                   may be provided to identify the analysis to which the tree
+ *                   should be associated.
+ *     'leaf_type':  A sequence ontology term or the word 'organism'. If the
+ *                   type is 'organism' then this tree represents a
+ *                   taxonomic tree.  The default, if not specified, is the
+ *                   term 'polypeptide'.
+ *     'tree_file':  The path of the file containing the phylogenetic tree to
+ *                   import or a Drupal managed_file numeric ID.
+ *     'format':     The file format. Currently only 'newick is supported'
+ *     'dbxref':     A database cross-reference of the form DB:ACCESSION.
+ *                   Where DB is the database name, which is already present
+ *                   in Chado, and ACCESSION is the unique identifier for
+ *                   this tree in the remote database.
+ *     'name_re':    If the leaf type is NOT 'taxonomy', then the value of
+ *                   this field can be a regular expression to pull out
+ *                   the name of the feature from the node label in the
+ *                   intput tree. If no value is provided the entire label is
+ *                   used.
+ *     'match':      Set to 'uniquename' if the leaf nodes should be matched
+ *                   with the feature uniquename.
+ *     'load_now':   If set, the tree will be loaded immediately if a tree_file
+ *                   is provided. Otherwise, the tree will be loaded via
+ *                   a Tripal jobs call.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_update_phylotree($phylotree_id, &$options) {
+  chado_update_phylotree($phylotree_id, $options);
+}
+
+/**
+ * Deletes a phylotree record from Chado.
+ *
+ * @param $phylotree_id
+ *
+ * @return
+ *   TRUE on success, FALSE on failure.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_delete_phylotree($phylotree_id) {
+  chado_delete_phylotree($phylotree_id);
+}
+
+/**
+ * Iterates through the tree and sets the left and right indicies.
+ *
+ * @param $tree
+ *   The tree array.
+ * @param $index
+ *   This parameters is not used when the function is first called. It
+ *   is used for recursive calls.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_assign_phylogeny_tree_indices(&$tree, &$index = 1) {
+  chado_assign_phylogeny_tree_indices($tree, $index);
+}
+
+/**
+ * Iterates through the tree array and creates phylonodes in Chado.
+ *
+ * The function iterates through the tree in a top-down approach adding
+ * parent internal nodes prior to leaf nodes.  Each node of the tree should have
+ * the following fields:
+ *
+ *   -name:         The name (or label) for this node.
+ *   -depth:        The depth of the node in the tree.
+ *   -is_root:      Set to 1 if this node is a root node.
+ *   -is_leaf:      Set to 1 if this node is a leaf node.
+ *   -is_internal:  Set to 1 if this node is an internal node.
+ *   -left_index:   The index of the node to the left in the tree.
+ *   -right_index:  The index of the node to the right in the tree.
+ *   -branch_set:   An array containing a list of nodes of that are children
+ *                  of the node.
+ *   -parent:       The name of the parent node.
+ *   -organism_id:  The organism_id for associtating the node with an organism.
+ *   -properties:   An array of key/value pairs where the key is the cvterm_id
+ *                  and the value is the property value.  These properties
+ *                  will be assocaited with the phylonode.
+ *
+ * Prior to importing the tree the indicies can be set by using the
+ * chado_assign_phylogeny_tree_indices() function.
+ *
+ * @param $tree
+ *   The tree array.
+ * @param $phylotree.
+ *   The phylotree object (from Chado).
+ * @param $options
+ *   The options provide some direction for how the tree is imported.  The
+ *   following keys can be used:
+ *   -taxonomy:  Set to 1 if this tree is a taxonomic tree. Set to 0
+ *               otherwise.
+ *   -leaf_type: Set to the leaf type name. If this is a non-taxonomic tree
+ *               that is associated with features, then this should be the
+ *               Sequence Ontology term for the feature (e.g. polypeptide).
+ *               If this is a taxonomic tree then this option is not needed.
+ *   -match:     Set to either 'name' or 'uniquename'.  This is used for
+ *               matching the feature name or uniquename with the node name.
+ *               This is not needed for taxonomic trees.
+ *   -match_re:  Set to a regular that can be used for matching the node
+ *               name with the feature name if the node name is not
+ *               identical to the feature name.
+ * @param $vocab
+ *   Optional. An array containing a set of key/value pairs that maps node
+ *   types to CV terms.  The keys must be 'root', 'internal' or 'leaf'.  If
+ *   no vocab is provded then the terms provided by the tripal_phylogeny
+ *   CV will be used.
+ * @param $parent
+ *   This argument is not needed when the funtion is first called. This
+ *   function is recursive and this argument is used on recursive calls.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_phylogeny_import_tree(&$tree, $phylotree, $options, $vocab = array(), $parent = null) {
+  chado_phylogeny_import_tree($tree, $phylotree, $options, $vocab, $parent);
+}
+
+/**
+ * Get the vocabulary terms used to describe nodes in the tree.
+ *
+ * @return 
+ *  Array of vocab info or FALSE on failure.
+ * 
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_phylogeny_get_node_types_vocab() {
+  chado_phylogeny_get_node_types_vocab();
+}
+
+/**
+ * Imports a tree file.
+ *
+ * This function is used as a wrapper for loading a phylogenetic tree using
+ * any number of file loaders.
+ *
+ * @param $file_name
+ *   The name of the file containing the phylogenetic tree to import.
+ * @param $format
+ *   The format of the file. Currently only the 'newick' file format is
+ *   supported.
+ * @param $options
+ *   Options if the phylotree record already exists:
+ *     'phylotree_id': The imported nodes will be associated with this tree.
+ *     'leaf_type':  A sequence ontology term or the word 'organism'. If the
+ *                   type is 'organism' then this tree represents a
+ *                   taxonomic tree.  The default, if not specified, is the
+ *                   term 'polypeptide'.
+ *     'name_re':    If the leaf type is NOT 'taxonomy', then the value of
+ *                   this field can be a regular expression to pull out
+ *                   the name of the feature from the node label in the
+ *                   intput tree. If no value is provided the entire label is
+ *                   used.
+ *     'match':      Set to 'uniquename' if the leaf nodes should be matched
+ *                   with the feature uniquename.
+ *
+ *  @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_phylogeny_import_tree_file($file_name, $format, $options = array(), $job_id = null) {
+  chado_phylogeny_import_tree_file($file_name, $format, $options, $job_id);
+}
+
+/** tripal_pub_api */
+/**
+ * Retrieves a chado publication array.
+ *
+ * @param $identifier
+ *   An array used to uniquely identify a publication. This array has the same
+ *   format as that used by the chado_generate_var(). The following keys can be
+ *   useful for uniquely identifying a publication as they should be unique:
+ *    - pub_id: the chado pub.pub_id primary key.
+ *    - nid: the drupal nid of the publication.
+ *    - uniquename: A value to matach with the pub.uniquename field.
+ *   There are also some specially handled keys. They are:
+ *    - property: An array describing the property to select records for. It
+ *      should at least have either a 'type_name' key (if unique across cvs) or
+ *      'type_id' key. Other supported keys include: 'cv_id', 'cv_name' 
+ *      (of the type), 'value' and 'rank'
+ *    - dbxref: The database cross reference accession.  It should be in the 
+ *      form DB:ACCESSION, where DB is the database name and ACCESSION is the
+ *      unique publication identifier (e.g. PMID:4382934)
+ *    - dbxref_id:  The dbxref.dbxref_id of the publication.
+ * @param $options
+ *   An array of options. Supported keys include:
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition for additional details.
+ *
+ * NOTE: the $identifier parameter can really be any array similar to $values 
+ * passed into chado_select_record(). It should fully specify the pub record to 
+ * be returned.
+ *
+ * @return
+ *   If a singe publication is retreived using the identifiers, then a 
+ *   publication array will be returned.  The array is of the same format 
+ *   returned by the chado_generate_var() function. Otherwise, FALSE will be 
+ *   returned.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_publication($identifiers, $options = array()) {
+  chado_get_publication($identifiers, $options);
+}
+
+/**
+ * The publication table of Chado only has a unique constraint for the
+ * uniquename of the publiation, but in reality a publication can be considered
+ * unique by a combination of the title, publication type, published year and
+ * series name (e.g. journal name or conference name). The site administrator
+ * can configure how publications are determined to be unique.  This function
+ * uses the configuration specified by the administrator to look for publications
+ * that match the details specified by the $pub_details argument
+ * and indicates if one ore more publications match the criteria.
+ *
+ * @param $pub_details
+ *   An associative array with details about the publications. The expected keys
+ *   are:
+ *     'Title':              The title of the publication.
+ *     'Year':               The published year of the publication.
+ *     'Publication Type':   An array of publication types. A publication can 
+ *                           have more than one type.
+ *     'Series Name':        The series name of the publication.
+ *     'Journal Name':       An alternative to 'Series Name'.
+ *     'Conference Name':    An alternative to 'Series Name'.
+ *     'Citation':           The publication citation (this is the value saved 
+ *                           in the pub.uniquename field and must be unique).
+ *   
+ *     If this key is present it will also be checked
+ *     'Publication Dbxref': A database cross reference of the form DB:ACCESSION 
+ *                           where DB is the name of the database and ACCESSION 
+ *                           is the unique identifier (e.g PMID:3483139).
+ *
+ * @return
+ *   An array containing the pub_id's of matching publications. Returns an
+ *   empty array if no pubs match.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_publication_exists($pub_details) {
+  chado_publication_exists($pub_details);
+}
+
+/**
+ * Used for autocomplete in forms for identifying for publications.
+ *
+ * @param $field
+ *   The field in the publication to search on.
+ * @param $string
+ *   The string to search for.
+ *
+ * @return
+ *   A json array of terms that begin with the provided string.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_autocomplete_pub($string = '') {
+  chado_autocomplete_pub($string);
+}
+
+/**
+ * Imports a singe publication specified by a remote database cross reference.
+ *
+ * @param $pub_dbxref
+ *   The unique database ID for the record to update.  This value must
+ *   be of the format DB_NAME:ACCESSION where DB_NAME is the name of the
+ *   database (e.g. PMID or AGL) and the ACCESSION is the unique identifier
+ *   for the record in the database.
+ * @param $do_contact
+ *   Set to TRUE if authors should automatically have a contact record added
+ *   to Chado.
+ * @param $do_update
+ *   If set to TRUE then the publication will be updated if it already exists
+ *   in the database.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_import_pub_by_dbxref($pub_dbxref, $do_contact = false, $do_update = true) {
+  chado_import_pub_by_dbxref($pub_dbxref, $do_contact, $do_update);
+}
+
+/**
+ * Imports all publications for all active import setups.
+ *
+ * @param $report_email
+ *   A list of email address, separated by commas, that should be notified
+ *   once importing has completed.
+ * @param $do_update
+ *   If set to TRUE then publications that already exist in the Chado database
+ *   will be updated, whereas if FALSE only new publications will be added.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_execute_active_pub_importers($report_email = false, $do_update = false) {
+  chado_execute_active_pub_importers($report_email, $do_update);
+}
+
+/**
+ * Updates publication records.
+ *
+ * Updates publication records that currently exist in the Chado pub table
+ * with the most recent data in the remote database.
+ *
+ * @param $do_contact
+ *   Set to TRUE if authors should automatically have a contact record added
+ *   to Chado. Contacts are added using the name provided by the remote
+ *   database.
+ * @param $dbxref
+ *   The unique database ID for the record to update.  This value must
+ *   be of the format DB_NAME:ACCESSION where DB_NAME is the name of the
+ *   database (e.g. PMID or AGL) and the ACCESSION is the unique identifier
+ *   for the record in the database.
+ * @param $db
+ *   The name of the remote database to update.  If this value is provided and
+ *   no dbxref then all of the publications currently in the Chado database
+ *   for this remote database will be updated.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_reimport_publications($do_contact = false, $dbxref = null, $db = null) {
+  chado_reimport_publications($do_contact, $dbxref, $db);
+}
+
+/**
+ * Launch the Tripal job to generate citations.
+ *
+ * This function will recreate citations for all publications currently
+ * loaded into Tripal.  This is useful to create a consistent format for
+ * all citations.
+ *
+ * @param $options
+ *  Options pertaining to what publications to generate citations for.
+ *  One of the following must be present:
+ *   - all: Create and replace citation for all pubs.
+ *   - new: Create citation for pubs that don't already have one.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_pub_create_citations($options) {
+  chado_pub_create_citations($options);
+}
+
+/**
+ * This function generates citations for publications.  It requires
+ * an array structure with keys being the terms in the Tripal
+ * publication ontology.  This function is intended to be used
+ * for any function that needs to generate a citation.
+ *
+ * @param $pub
+ *   An array structure containing publication details where the keys
+ *   are the publication ontology term names and values are the
+ *   corresponding details.  The pub array can contain the following
+ *   keys with corresponding values:
+ *     - Publication Type:  an array of publication types. a publication can 
+ *       have more than one type.
+ *     - Authors: a  string containing all of the authors of a publication.
+ *     - Journal Name:  a string containing the journal name.
+ *     - Journal Abbreviation: a string containing the journal name abbreviation.
+ *     - Series Name: a string containing the series (e.g. conference 
+ *       proceedings) name.
+ *     - Series Abbreviation: a string containing the series name abbreviation
+ *     - Volume: the serives volume number.
+ *     - Issue: the series issue number.
+ *     - Pages: the page numbers for the publication.
+ *     - Publication Date:  A date in the format "Year Month Day".
+ *
+ * @return
+ *   A text string containing the citation.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_pub_create_citation($pub) {
+  chado_pub_create_citation($pub);
+}
+
+/**
+ * Retrieves the minimal information to uniquely describe any publication.
+ *
+ * The returned array is an associative array where the keys are
+ * the controlled vocabulary terms in the form [vocab]:[accession].
+ *
+ * @param $pub
+ *   A publication object as created by chado_generate_var().
+ *
+ * @return
+ *   An array with the following keys:  'Citation', 'Abstract', 'Authors',
+ *   'URL'. All keys are term names in the Tripal Publication Ontology :TPUB.
+ * 
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_minimal_pub_info($pub) {
+  chado_get_minimal_pub_info($pub);
+}
+
+
+/** tripal_stock_api */
+/**
+ * Retrieves a chado stock variable
+ *
+ * @param $identifier
+ *   An array with the key stating what the identifier is. Supported keys (only 
+ *   one of the following unique keys is required):
+ *    - stock_id: the chado stock.stock_id primary key
+ *    - nid: the drupal nid of the stock
+ *   There are also some specially handled keys. They are:
+ *    - property: An array/object describing the property to select records for. 
+ *      It should at least have either a type_name (if unique across cvs) or 
+ *      type_id. Other supported keys include: cv_id/cv_name (of the type), 
+ *      value and rank
+ * @param $options
+ *   An array of options. Supported keys include:
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *      definition for additional details.
+ *
+ * NOTE: the $identifier parameter can really be any array similar to $values
+ * passed into chado_select_record(). It should fully specify the stock record 
+ * to be returned.
+ *
+ * @return
+ *   If unique values were passed in as an identifier then an object describing 
+ *   the stock will be returned (will be a chado variable from 
+ *   chado_generate_var()). Otherwise, FALSE will be returned.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_stock($identifiers, $options = array()) {
+  chado_get_stock($identifiers, $options);
+}
+
+/**
+ * Retrieves a chado stock variable.
+ *
+ * @param $identifier
+ *   An array with the key stating what the identifier is. Supported keys 
+ *   include any field in the stock table. See the chado_select_record() $values
+ *   parameter for additional details including an example.
+ * @param $options
+ *   An array of options. Supported keys include:
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition for additional details.
+ *
+ * @return
+ *   An array of stock objects matching the criteria.
+ *
+ * @ingroup tripal_chado_module_DEPRECATED_api
+ */
+function tripal_get_multiple_stocks($identifiers, $options = array()) {
+  chado_get_multiple_stocks($identifiers, $options);
+}

tripal_chado/api/modules/tripal_chado.organism.api.inc

@@ -1,35 +1,40 @@
 <?php
 /**
  * @file
- * Provides an application programming interface (API) to manage organisms
+ * Provides API functions specificially for managing feature
+ * records in Chado.  
  */
 
 /**
  * @defgroup tripal_organism_api Chado Organism
  * @ingroup tripal_chado_api
  * @{
+ * Provides API functions specificially for managing organism
+ * records in Chado.
  * @}
  */
 
 /**
- * Retrieves a chado organism variable
+ * Retrieves a chado organism variable.
  *
  * @param $identifier
- *   An array with the key stating what the identifier is. Supported keys (only on of the
- *   following unique keys is required):
- *    - organism_id: the chado organism.organism_id primary key
- *    - genus & species: the chado organism.genus field & organism.species field
+ *   An array with the key stating what the identifier is. Supported keys (only 
+ *   on of the following unique keys is required):
+ *    - organism_id: the chado organism.organism_id primary key.
+ *    - genus & species: the chado organism.genus field & organism.species field.
  *   There are also some specially handled keys. They are:
- *    - property: An array/object describing the property to select records for. It
- *      should at least have either a type_name (if unique across cvs) or type_id. Other
- *      supported keys include: cv_id/cv_name (of the type), value and rank
+ *    - property: An array/object describing the property to select records for. 
+ *      It should at least have either a type_name (if unique across cvs) or 
+ *      type_id. Other supported keys include: cv_id/cv_name (of the type), 
+ *      value and rank.
  * @param $options
  *   An array of options. Supported keys include:
- *     - Any keys supported by chado_generate_var(). See that function definition for
- *       additional details.
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *      definition for additional details.
  *
- * NOTE: the $identifier parameter can really be any array similar to $values passed into
- *   chado_select_record(). It should fully specify the organism record to be returned.
+ * NOTE: the $identifier parameter can really be any array similar to $values 
+ * passed into chado_select_record(). It should fully specify the organism 
+ * record to be returned.
  *
  * @return
  *   If unique values were passed in as an identifier then an object describing the organism
@@ -38,20 +43,20 @@
  *
  * @ingroup tripal_organism_api
  */
-function tripal_get_organism($identifiers, $options = array()) {
+function chado_get_organism($identifiers, $options = array()) {
 
-  // Set Defaults
+  // Set Defaults.
   if (!isset($options['include_fk'])) {
-    // Tells chado_generate_var not to follow any foreign keys
+    // Tells chado_generate_var not to follow any foreign keys.
     $options['include_fk'] = array();
   }
 
-  // Error Checking of parameters
+  // Error Checking of parameters.
   if (!is_array($identifiers)) {
     tripal_report_error(
       'tripal_organism_api',
       TRIPAL_ERROR,
-      "tripal_get_organism: The identifier passed in is expected to be an array with the key
+      "chado_get_organism: The identifier passed in is expected to be an array with the key
         matching a column name in the organism table (ie: organism_id or name). You passed in %identifier.",
       array(
         '%identifier'=> print_r($identifiers, TRUE)
@@ -62,7 +67,7 @@ function tripal_get_organism($identifiers, $options = array()) {
     tripal_report_error(
       'tripal_organism_api',
       TRIPAL_ERROR,
-      "tripal_get_organism: You did not pass in anything to identify the organism you want. The identifier
+      "chado_get_organism: You did not pass in anything to identify the organism you want. The identifier
         is expected to be an array with the key matching a column name in the organism table
         (ie: organism_id or name). You passed in %identifier.",
       array(
@@ -71,7 +76,7 @@ function tripal_get_organism($identifiers, $options = array()) {
     );
   }
 
-  // If one of the identifiers is property then use chado_get_record_with_property()
+  // If one of the identifiers is property then use chado_get_record_with_property().
   if (isset($identifiers['property'])) {
     $property = $identifiers['property'];
     unset($identifiers['property']);
@@ -82,7 +87,8 @@ function tripal_get_organism($identifiers, $options = array()) {
     );
   }
 
-  // Else we have a simple case and we can just use chado_generate_var to get the analysis
+  // Else we have a simple case and we can just use chado_generate_var to get 
+  // the analysis.
   else {
 
     // Try to get the organism
@@ -93,24 +99,25 @@ function tripal_get_organism($identifiers, $options = array()) {
     );
   }
 
-  // Ensure the organism is singular. If it's an array then it is not singular
+  // Ensure the organism is singular. If it's an array then it is not singular.
   if (is_array($organism)) {
     tripal_report_error(
       'tripal_organism_api',
       TRIPAL_ERROR,
-      "tripal_get_organism: The identifiers you passed in were not unique. You passed in %identifier.",
+      "chado_get_organism: The identifiers you passed in were not unique. You passed in %identifier.",
       array(
         '%identifier'=> print_r($identifiers, TRUE)
       )
     );
   }
 
-  // Report an error if $organism is FALSE since then chado_generate_var has failed
+  // Report an error if $organism is FALSE since then chado_generate_var has 
+  // failed.
   elseif ($organism === FALSE) {
     tripal_report_error(
       'tripal_organism_api',
       TRIPAL_ERROR,
-      "tripal_get_organism: chado_generate_var() failed to return a organism based on the identifiers
+      "chado_get_organism: chado_generate_var() failed to return a organism based on the identifiers
         you passed in. You should check that your identifiers are correct, as well as, look
         for a chado_generate_var error for additional clues. You passed in %identifier.",
       array(
@@ -135,27 +142,27 @@ function tripal_get_organism($identifiers, $options = array()) {
  *
  * @ingroup tripal_organism_api
  */
-function tripal_get_organism_scientific_name($organism) {
+function chado_get_organism_scientific_name($organism) {
   $name = $organism->genus . ' ' . $organism->species;
 
   // For Chado v1.3 we have a type_id and infraspecific name.
   if (property_exists($organism, 'type_id')) {
     $rank = '';
-    // For organism objects crated using chado_generate_var
+    // For organism objects crated using chado_generate_var.
     if (is_object($organism->type_id)) {
       if ($organism->type_id) {
         $rank = $organism->type_id->name;
       }
     }
     else {
-      $rank_term = tripal_get_cvterm(array('cvterm_id' => $organism->type_id));
+      $rank_term = chado_get_cvterm(array('cvterm_id' => $organism->type_id));
       if ($rank_term) {
         $rank = $rank_term->name;
       }
     }
 
     if ($rank) {
-      $rank = tripal_abbreviate_infraspecific_rank($rank);
+      $rank = chado_abbreviate_infraspecific_rank($rank);
       $name .= ' ' . $rank . ' ' . $organism->infraspecific_name;
     }
     else if ($organism->infraspecific_name) {
@@ -166,18 +173,19 @@ function tripal_get_organism_scientific_name($organism) {
 }
 
 /**
- * Returns a list of organisms that are currently synced with Drupal to use in select lists
+ * Returns a list of organisms that are currently synced with Drupal to use in 
+ * select lists.
  *
  * @param $syncd_only
- *   Whether or not to return all chado organisms or just those sync'd with drupal. Defaults
- *   to TRUE (only sync'd organisms)
+ *   Whether or not to return all chado organisms or just those sync'd with 
+ *   drupal. Defaults to TRUE (only sync'd organisms).
  * @return
- *   An array of organisms sync'd with Drupal where each value is the organism scientific
- *   name and the keys are organism_id's
+ *   An array of organisms sync'd with Drupal where each value is the organism 
+ *   scientific name and the keys are organism_id's.
  *
  * @ingroup tripal_organism_api
  */
-function tripal_get_organism_select_options($syncd_only = TRUE) {
+function chado_get_organism_select_options($syncd_only = TRUE) {
   $org_list = array();
   $org_list[] = 'Select an organism';
 
@@ -190,7 +198,7 @@ function tripal_get_organism_select_options($syncd_only = TRUE) {
     ";
     $orgs = chado_query($sql);
 
-    // iterate through the organisms and build an array of those that are synced
+    // Iterate through the organisms and build an array of those that are synced.
     foreach ($orgs as $org) {
       $org_list[$org->organism_id] = $org->genus . ' ' . $org->species;
     }
@@ -200,7 +208,7 @@ function tripal_get_organism_select_options($syncd_only = TRUE) {
     $csql =  "SELECT * FROM {organism} ORDER BY genus, species";
     $orgs = chado_query($csql);
 
-    // iterate through the organisms and build an array of those that are synced
+    // Iterate through the organisms and build an array of those that are synced.
     foreach ($orgs as $org) {
       $org_list[$org->organism_id] = $org->genus . ' ' . $org->species;
     }
@@ -212,22 +220,22 @@ function tripal_get_organism_select_options($syncd_only = TRUE) {
  * Return the path for the organism image.
  *
  * @param $organism
- *   An organism table record
+ *   An organism table record.
  *
  * @return
  *   If the type parameter is 'url' (the default) then the fully qualified
- *   url to the image is returend. If no image is present then NULL is returned
+ *   url to the image is returend. If no image is present then NULL is returned.
  *
  * @ingroup tripal_organism_api
  */
-function tripal_get_organism_image_url($organism) {
+function chado_get_organism_image_url($organism) {
   $url = '';
 
   if (!is_object($organism)) {
     return NULL;
   }
 
-  // Get the organism's node
+  // Get the organism's node.
   $nid = chado_get_nid_from_id('organism', $organism->organism_id);
 
   // Look in the file_usage table of Drupal for the image file. This
@@ -245,8 +253,8 @@ function tripal_get_organism_image_url($organism) {
     return file_create_url($file->uri);
   }
 
-  // First look for an image with the genus/species name.  This is old-style tripal
-  // and we keep it for backwards compatibility.
+  // First look for an image with the genus/species name.  This is old-style 
+  // tripal and we keep it for backwards compatibility.
   $base_path = realpath('.');
   $image_dir = tripal_get_files_dir('tripal_organism') . "/images";
   $image_name =  $organism->genus . "_" . $organism->species . ".jpg";
@@ -272,17 +280,17 @@ function tripal_get_organism_image_url($organism) {
 
 /**
  * This function is intended to be used in autocomplete forms
- * for searching for organisms that begin with the provided string
+ * for searching for organisms that begin with the provided string.
  *
  * @param $text
- *   The string to search for
+ *   The string to search for.
  *
  * @return
- *   A json array of terms that begin with the provided string
+ *   A json array of terms that begin with the provided string.
  *
  * @ingroup tripal_organism_api
  */
-function tripal_autocomplete_organism($text) {
+function chado_autocomplete_organism($text) {
   $matches = array();
   $genus = $text;
   $species = '';
@@ -302,7 +310,7 @@ function tripal_autocomplete_organism($text) {
   $results = chado_query($sql, $args);
   $items = array(['args' => [$sql => $args]]);
   foreach ($results as $organism) {
-    $name = tripal_get_organism_scientific_name($organism);
+    $name = chado_get_organism_scientific_name($organism);
     $items["$name [id: $organism->organism_id]"] = $name;
   }
   drupal_json_output($items);
@@ -318,7 +326,7 @@ function tripal_autocomplete_organism($text) {
  *
  * @ingroup tripal_organism_api
  */
-function tripal_abbreviate_infraspecific_rank($rank) {
+function chado_abbreviate_infraspecific_rank($rank) {
   $abb = '';
   switch($rank) {
     case 'no_rank':

tripal_chado/api/modules/tripal_chado.phylotree.api.inc

@@ -2,13 +2,18 @@
 
 /**
  * @file
- * Provides an application programming interface (API) to manage organisms
+ * Provides API functions specificially for managing phylogenetic and taxonomic
+ * tree records in Chado.  
  */
 
 /**
  * @defgroup tripal_phylotree_api Chado Phylotree
  * @ingroup tripal_chado_api
  * @{
+ * Provides API functions specificially for managing phylogenetic and taxonomic
+ * tree records in Chado.  The API consists of functions for creation, 
+ * retrieval, update and deltion (CRUD) for phylogenetic tree records as 
+ * well as importing of trees in the newick file format.
  * @}
  */
 
@@ -25,7 +30,7 @@
  *   The type of validation. Can be either 'insert' or 'update'.
  * @param $options
  *   An array of key/value pairs containing any of the valid keys for
- *   either the tripal_insert_phylotree() or tripal_update_phylotree()
+ *   either the chado_insert_phylotree() or chado_update_phylotree()
  *   functions.
  * @param $errors
  *   An empty array where validation error messages will be set. The keys
@@ -45,7 +50,7 @@
  *
  * @ingroup tripal_phylotree_api
  */
-function tripal_validate_phylotree($val_type, &$options, &$errors, &$warnings) {
+function chado_validate_phylotree($val_type, &$options, &$errors, &$warnings) {
 
   if ($val_type != 'insert' and $val_type != 'update') {
     tripal_report_error('tripal_phylogeny', TRIPAL_ERROR, "The $val_type argument must be either 'update or 'insert'.");
@@ -88,14 +93,14 @@ function tripal_validate_phylotree($val_type, &$options, &$errors, &$warnings) {
       $errors['format'] = t('Please provide a file format for the tree file.');
       return FALSE;
     }
-    // Make sure the file format is correct
+    // Make sure the file format is correct.
     if ($options['format'] != 'newick' and $options['format'] != 'taxonomy') {
       $errors['format'] = t('The file format is not supported. Currently only the "newick" file format is supported.');
       return FALSE;
     }
   }
   else {
-    // Does the phylotree ID exist and is it valid
+    // Does the phylotree ID exist and is it valid.
     if (!array_key_exists('phylotree_id', $options)) {
       $errors['phylotree_id'] = t('Please provide the ID for the tree.');
       return FALSE;
@@ -109,7 +114,7 @@ function tripal_validate_phylotree($val_type, &$options, &$errors, &$warnings) {
 
   }
 
-  // Make sure the file exists if one is specified
+  // Make sure the file exists if one is specified.
   if (array_key_exists('tree_file', $options) and $options['tree_file']) {
     // If this is a numeric Drupal file then all is good, no need to check.
     if (!is_numeric($options['tree_file'])) {
@@ -118,7 +123,7 @@ function tripal_validate_phylotree($val_type, &$options, &$errors, &$warnings) {
         return FALSE;
       }
     }
-    // Make sure the file format is correct
+    // Make sure the file format is correct.
     if (!array_key_exists('format', $options) or
         ($options['format'] != 'newick' and $options['format'] != 'taxonomy')) {
       $errors['format'] = t('Please provide a supported file format. Currently only the "newick" file format is supported.');
@@ -204,7 +209,7 @@ function tripal_validate_phylotree($val_type, &$options, &$errors, &$warnings) {
     $options['dbxref_id'] = $dbxref->dbxref_id;
   }
 
-  // Make sure the tree name is unique
+  // Make sure the tree name is unique.
   if (array_key_exists('name', $options) and $options['name']) {
     $sql = "
       SELECT *
@@ -249,6 +254,7 @@ function tripal_validate_phylotree($val_type, &$options, &$errors, &$warnings) {
  *     'tree_file':  The path of the file containing the phylogenetic tree to
  *                   import or a Drupal managed_file numeric ID.
  *     'format':     The file format. Currently only 'newick is supported'.
+ * 
  *  Optional keys:
  *     'dbxref':     A database cross-reference of the form DB:ACCESSION.
  *                   Where DB is the database name, which is already present
@@ -280,7 +286,7 @@ function tripal_validate_phylotree($val_type, &$options, &$errors, &$warnings) {
  *
  * @ingroup tripal_phylotree_api
  */
-function tripal_insert_phylotree(&$options, &$errors, &$warnings) {
+function chado_insert_phylotree(&$options, &$errors, &$warnings) {
   global $user;
 
   $options['name_re'] = trim($options['name_re']);
@@ -290,7 +296,7 @@ function tripal_insert_phylotree(&$options, &$errors, &$warnings) {
   $options['tree_file'] = trim($options['tree_file']);
 
   // Validate the incoming options.
-  $success = tripal_validate_phylotree('insert', $options, $errors, $warnings);
+  $success = chado_validate_phylotree('insert', $options, $errors, $warnings);
   if (!$success) {
     foreach ($errors as $field => $message) {
       tripal_report_error('tripal_phylogeny', TRIPAL_ERROR, $message);
@@ -340,7 +346,7 @@ function tripal_insert_phylotree(&$options, &$errors, &$warnings) {
         'match' => $options['match'] ? 'uniquename' : 'name',
         'name_re' => $options['name_re'],
       );
-      tripal_phylogeny_import_tree_file($real_file_path, $options['format'], $args);
+      chado_phylogeny_import_tree_file($real_file_path, $options['format'], $args);
     }
     else {
       $args = array(
@@ -354,7 +360,7 @@ function tripal_insert_phylotree(&$options, &$errors, &$warnings) {
           ),
       );
       if (tripal_add_job("Import Tree File: " . $file->filename, 'tripal_phylogeny',
-          'tripal_phylogeny_import_tree_file', $args, $user->uid)) {
+          'chado_phylogeny_import_tree_file', $args, $user->uid)) {
           drupal_set_message(t('The tree visualizations will appear once the tree is fully imported.'));
       }
     }
@@ -409,13 +415,13 @@ function tripal_insert_phylotree(&$options, &$errors, &$warnings) {
  *
  * @ingroup tripal_phylotree_api
  */
-function tripal_update_phylotree($phylotree_id, &$options) {
+function chado_update_phylotree($phylotree_id, &$options) {
   global $user;
 
   // Validate the incoming options.
   $errors = array();
   $warnings = array();
-  $success = tripal_validate_phylotree('update', $options, $errors, $warnings);
+  $success = chado_validate_phylotree('update', $options, $errors, $warnings);
   if (!$success) {
     foreach ($errors as $field => $message) {
       tripal_report_error('tripal_phylogeny', TRIPAL_ERROR, $message);
@@ -452,7 +458,7 @@ function tripal_update_phylotree($phylotree_id, &$options) {
     );
   }
 
-  // If we have a tree file, then import the tree
+  // If we have a tree file, then import the tree.
   if (array_key_exists('tree_file', $options) and $options['tree_file']) {
 
     // Remove any existing nodes
@@ -495,7 +501,7 @@ function tripal_update_phylotree($phylotree_id, &$options) {
         'match' => $options['match'] ? 'uniquename' : 'name',
         'name_re' => $options['name_re'],
       );
-      tripal_phylogeny_import_tree_file($real_file_path, $options['format'], $args);
+      chado_phylogeny_import_tree_file($real_file_path, $options['format'], $args);
     }
     else {
       $args = array(
@@ -509,7 +515,7 @@ function tripal_update_phylotree($phylotree_id, &$options) {
         ),
       );
       if (tripal_add_job("Import Tree File: " . $file->filename, 'tripal_phylogeny',
-          'tripal_phylogeny_import_tree_file', $args, $user->uid)) {
+          'chado_phylogeny_import_tree_file', $args, $user->uid)) {
         drupal_set_message(t('The tree visualizations will appear once the tree is fully imported.'));
       }
     }
@@ -528,9 +534,9 @@ function tripal_update_phylotree($phylotree_id, &$options) {
  *
  * @ingroup tripal_phylotree_api
  */
-function tripal_delete_phylotree($phylotree_id) {
+function chado_delete_phylotree($phylotree_id) {
 
-  // if we don't have a phylotree id for this node then this isn't a node of
+  // If we don't have a phylotree id for this node then this isn't a node of
   // type chado_phylotree or the entry in the chado_phylotree table was lost.
   if (!$phylotree_id) {
     tripal_report_error('tripal_phylogeny', TRIPAL_ERROR,
@@ -544,7 +550,7 @@ function tripal_delete_phylotree($phylotree_id) {
 }
 
 /**
- * Iterates through the tree and sets the left and right indicies .
+ * Iterates through the tree and sets the left and right indicies.
  *
  * @param $tree
  *   The tree array.
@@ -554,7 +560,7 @@ function tripal_delete_phylotree($phylotree_id) {
  *
  * @ingroup tripal_phylotree_api
  */
-function tripal_assign_phylogeny_tree_indices(&$tree, &$index = 1) {
+function chado_assign_phylogeny_tree_indices(&$tree, &$index = 1) {
   // Assign a left and right index to each node.  The child node must
   // have a right and left index less than that of it's parents.  We
   // increment the index by 100 to give space for new nodes that might
@@ -567,7 +573,7 @@ function tripal_assign_phylogeny_tree_indices(&$tree, &$index = 1) {
   }
   if (array_key_exists('branch_set', $tree)) {
     foreach ($tree['branch_set'] as $key => $node) {
-      tripal_assign_phylogeny_tree_indices($tree['branch_set'][$key], $index);
+      chado_assign_phylogeny_tree_indices($tree['branch_set'][$key], $index);
       $tree['right_index'] = $index += 100;
     }
   }
@@ -596,7 +602,7 @@ function tripal_assign_phylogeny_tree_indices(&$tree, &$index = 1) {
  *                  will be assocaited with the phylonode.
  *
  * Prior to importing the tree the indicies can be set by using the
- * tripal_assign_phylogeny_tree_indices() function.
+ * chado_assign_phylogeny_tree_indices() function.
  *
  * @param $tree
  *   The tree array.
@@ -628,12 +634,12 @@ function tripal_assign_phylogeny_tree_indices(&$tree, &$index = 1) {
  *
  * @ingroup tripal_phylotree_api
  */
-function tripal_phylogeny_import_tree(&$tree, $phylotree, $options, $vocab = array(), $parent = NULL) {
+function chado_phylogeny_import_tree(&$tree, $phylotree, $options, $vocab = array(), $parent = NULL) {
 
   // Get the vocabulary terms used to describe nodes in the tree if one
   // wasn't provided.
   if (count($vocab) == 0) {
-    $vocab = tripal_phylogeny_get_node_types_vocab();
+    $vocab = chado_phylogeny_get_node_types_vocab();
   }
 
   if (is_array($tree) and array_key_exists('name', $tree)) {
@@ -642,14 +648,14 @@ function tripal_phylogeny_import_tree(&$tree, $phylotree, $options, $vocab = arr
       'left_idx'  => $tree['left_index'],
       'right_idx' => $tree['right_index'],
     );
-    // Add in any optional values to the $values array if they are present
+    // Add in any optional values to the $values array if they are present.
     if (!empty($tree['name']) and $tree['name'] != '') {
       $values['label'] = $tree['name'];
     }
     if (!empty($tree['length']) and $tree['length'] != '') {
       $values['distance'] = $tree['length'];
     }
-    // Set the type of node
+    // Set the type of node.
     if ($tree['is_root']) {
       $values['type_id'] = $vocab['root']->cvterm_id;
     }
@@ -669,8 +675,9 @@ function tripal_phylogeny_import_tree(&$tree, $phylotree, $options, $vocab = arr
       if (!empty($tree['name']) and $tree['name'] != '') {
         if (!$options['taxonomy']) {
 
-          // This is a sequence-based tree. Try to match leaf nodes with features.
-          // First, Get the Name and uniquename for the feature
+          // This is a sequence-based tree. Try to match leaf nodes with 
+          // features.
+          // First, Get the Name and uniquename for the feature.
           $matches = array();
           $sel_values = array();
           if ($options['match'] == "name") {
@@ -708,7 +715,7 @@ function tripal_phylogeny_import_tree(&$tree, $phylotree, $options, $vocab = arr
       }
     }
 
-    // Insert the new node and then add it's assigned phylonode_id to the node
+    // Insert the new node and then add it's assigned phylonode_id to the node.
     $phylonode = chado_insert_record('phylonode', $values);
     $tree['phylonode_id'] = $phylonode['phylonode_id'];
 
@@ -722,7 +729,7 @@ function tripal_phylogeny_import_tree(&$tree, $phylotree, $options, $vocab = arr
       $pylonode_organism = chado_insert_record('phylonode_organism', $values);
     }
 
-    // Associate any properties
+    // Associate any properties.
     if (array_key_exists('properties', $tree)) {
       foreach ($tree['properties'] as $type_id => $value) {
         $values = array(
@@ -736,19 +743,21 @@ function tripal_phylogeny_import_tree(&$tree, $phylotree, $options, $vocab = arr
   }
   if (is_array($tree) and array_key_exists('branch_set', $tree)) {
     foreach ($tree['branch_set'] as $key => $node) {
-      tripal_phylogeny_import_tree($tree['branch_set'][$key], $phylotree, $options, $vocab, $tree);
+      chado_phylogeny_import_tree($tree['branch_set'][$key], $phylotree, $options, $vocab, $tree);
     }
   }
 }
 
 /**
+ * Get the vocabulary terms used to describe nodes in the tree.
  *
- * @return
- *
+ * @return 
+ *  Array of vocab info or FALSE on failure.
+ * 
  * @ingroup tripal_phylotree_api
  */
-function tripal_phylogeny_get_node_types_vocab() {
-  // Get the vocabulary terms used to describe nodes in the tree
+function chado_phylogeny_get_node_types_vocab() {
+  // Get the vocabulary terms used to describe nodes in the tree.
   $values = array(
     'name' => 'phylo_leaf',
     'cv_id' => array(
@@ -815,7 +824,7 @@ function tripal_phylogeny_get_node_types_vocab() {
  *
  *  @ingroup tripal_phylotree_api
  */
-function tripal_phylogeny_import_tree_file($file_name, $format, $options = array(), $job_id = NULL) {
+function chado_phylogeny_import_tree_file($file_name, $format, $options = array(), $job_id = NULL) {
 
   // Set some option details.
   if (!array_key_exists('leaf_type', $options)) {
@@ -839,7 +848,7 @@ function tripal_phylogeny_import_tree_file($file_name, $format, $options = array
     }
   }
 
-  // get the phylotree record.
+  // Get the phylotree record.
   $values = array('phylotree_id' => $options['phylotree_id']);
   $phylotree = chado_generate_var('phylotree', $values);
 
@@ -862,12 +871,12 @@ function tripal_phylogeny_import_tree_file($file_name, $format, $options = array
       module_load_include('inc', 'tripal_chado', 'includes/loaders/tripal_chado.phylotree_newick');
       $tree = tripal_phylogeny_parse_newick_file($file_name);
 
-      // Assign the right and left indecies to the tree ndoes
-      tripal_assign_phylogeny_tree_indices($tree);
+      // Assign the right and left indecies to the tree ndoes.
+      chado_assign_phylogeny_tree_indices($tree);
     }
     // Iterate through the tree nodes and add them to Chado in accordance
     // with the details in the $options array.
-    tripal_phylogeny_import_tree($tree, $phylotree, $options);
+    chado_phylogeny_import_tree($tree, $phylotree, $options);
   }
   catch (Exception $e) {
     $transaction->rollback();

tripal_chado/api/modules/tripal_chado.pub.api.inc

@@ -1,52 +1,57 @@
 <?php
 /**
  * @file
- * Provides an application programming interface (API) to manage chado publications
+ * Provides API functions specificially for managing publication 
+ * records in Chado.  
  */
 
 /**
  * @defgroup tripal_pub_api Chado Publication
  * @ingroup tripal_chado_api
  * @{
+ * Provides API functions specificially for managing publication 
+ * records in Chado.
  * @}
  */
 
 
 /**
- * Retrieves a chado publication array
+ * Retrieves a chado publication array.
  *
  * @param $identifier
  *   An array used to uniquely identify a publication. This array has the same
  *   format as that used by the chado_generate_var(). The following keys can be
  *   useful for uniquely identifying a publication as they should be unique:
- *    - pub_id: the chado pub.pub_id primary key
- *    - nid: the drupal nid of the publication
- *    - uniquename: A value to matach with the pub.uniquename field
+ *    - pub_id: the chado pub.pub_id primary key.
+ *    - nid: the drupal nid of the publication.
+ *    - uniquename: A value to matach with the pub.uniquename field.
  *   There are also some specially handled keys. They are:
  *    - property: An array describing the property to select records for. It
  *      should at least have either a 'type_name' key (if unique across cvs) or
- *      'type_id' key. Other supported keys include: 'cv_id', 'cv_name' (of the type),
- *      'value' and 'rank'
- *    - dbxref: The database cross reference accession.  It should be in the form
- *        DB:ACCESSION, where DB is the database name and ACCESSION is the
- *        unique publication identifier (e.g. PMID:4382934)
+ *      'type_id' key. Other supported keys include: 'cv_id', 'cv_name' 
+ *      (of the type), 'value' and 'rank'
+ *    - dbxref: The database cross reference accession.  It should be in the 
+ *      form DB:ACCESSION, where DB is the database name and ACCESSION is the
+ *      unique publication identifier (e.g. PMID:4382934)
  *    - dbxref_id:  The dbxref.dbxref_id of the publication.
  * @param $options
  *   An array of options. Supported keys include:
- *     - Any keys supported by chado_generate_var(). See that function definition for
- *       additional details.
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition for additional details.
  *
- * NOTE: the $identifier parameter can really be any array similar to $values passed into
- *   chado_select_record(). It should fully specify the pub record to be returned.
+ * NOTE: the $identifier parameter can really be any array similar to $values 
+ * passed into chado_select_record(). It should fully specify the pub record to 
+ * be returned.
  *
  * @return
- *   If a singe publication is retreived using the identifiers, then a publication
- *   array will be returned.  The array is of the same format returned by the
- *   chado_generate_var() function. Otherwise, FALSE will be returned.
+ *   If a singe publication is retreived using the identifiers, then a 
+ *   publication array will be returned.  The array is of the same format 
+ *   returned by the chado_generate_var() function. Otherwise, FALSE will be 
+ *   returned.
  *
  * @ingroup tripal_pub_api
  */
-function tripal_get_publication($identifiers, $options = array()) {
+function chado_get_publication($identifiers, $options = array()) {
 
   // Error Checking of parameters
   if (!is_array($identifiers)) {
@@ -65,7 +70,8 @@ function tripal_get_publication($identifiers, $options = array()) {
     );
   }
 
-  // If one of the identifiers is property then use chado_get_record_with_property()
+  // If one of the identifiers is property then use 
+  // chado_get_record_with_property().
   if (array_key_exists('property', $identifiers)) {
     $property = $identifiers['property'];
     unset($identifiers['property']);
@@ -105,11 +111,11 @@ function tripal_get_publication($identifiers, $options = array()) {
     }
   }
   elseif (array_key_exists('dbxref_id', $identifiers)) {
-    // first get the pub_dbxref record
+    // First get the pub_dbxref record.
     $values = array('dbxref_id' => $identifiers['dbxref_id']);
     $pub_dbxref = chado_select_record('pub_dbxref', array('pub_id'), $values);
 
-    // now get the pub
+    // Now get the pub.
     if (count($pub_dbxref) > 0) {
       $pub = chado_generate_var('pub', array('pub_id' => $pub_dbxref[0]->pub_id), $options);
     }
@@ -118,13 +124,14 @@ function tripal_get_publication($identifiers, $options = array()) {
     }
 
   }
-  // Else we have a simple case and we can just use chado_generate_var to get the pub
+  // Else we have a simple case and we can just use chado_generate_var to get 
+  // the pub.
   else {
-    // Try to get the pub
+    // Try to get the pub.
     $pub = chado_generate_var('pub', $identifiers, $options);
   }
 
-  // Ensure the pub is singular. If it's an array then it is not singular
+  // Ensure the pub is singular. If it's an array then it is not singular.
   if (is_array($pub)) {
     tripal_report_error('tripal_pub_api', TRIPAL_ERROR,
       "chado_get_publication: The identifiers did not find a single unique record. Identifiers passed: %identifier.",
@@ -132,7 +139,7 @@ function tripal_get_publication($identifiers, $options = array()) {
     );
   }
 
-  // Report an error if $pub is FALSE since then chado_generate_var has failed
+  // Report an error if $pub is FALSE since then chado_generate_var has failed.
   elseif ($pub === FALSE) {
     tripal_report_error('tripal_pub_api', TRIPAL_ERROR,
       "chado_get_publication: Could not find a publication using the identifiers
@@ -159,42 +166,47 @@ function tripal_get_publication($identifiers, $options = array()) {
  * @param $pub_details
  *   An associative array with details about the publications. The expected keys
  *   are:
- *     'Title':              The title of the publication
- *     'Year':               The published year of the publication
- *     'Publication Type':   An array of publication types. A publication can have more than one type.
- *     'Series Name':        The series name of the publication
- *     'Journal Name':       An alternative to 'Series Name'
- *     'Conference Name':    An alternative to 'Series Name'
- *     'Citation':           The publication citation (this is the value saved in the pub.uniquename field and must be unique)
- *   If this key is present it will also be checked
- *     'Publication Dbxref': A database cross reference of the form DB:ACCESSION where DB is the name
- *                           of the database and ACCESSION is the unique identifier (e.g PMID:3483139)
+ *     'Title':              The title of the publication.
+ *     'Year':               The published year of the publication.
+ *     'Publication Type':   An array of publication types. A publication can 
+ *                           have more than one type.
+ *     'Series Name':        The series name of the publication.
+ *     'Journal Name':       An alternative to 'Series Name'.
+ *     'Conference Name':    An alternative to 'Series Name'.
+ *     'Citation':           The publication citation (this is the value saved 
+ *                           in the pub.uniquename field and must be unique).
+ *   
+ *     If this key is present it will also be checked
+ *     'Publication Dbxref': A database cross reference of the form DB:ACCESSION 
+ *                           where DB is the name of the database and ACCESSION 
+ *                           is the unique identifier (e.g PMID:3483139).
  *
  * @return
  *   An array containing the pub_id's of matching publications. Returns an
- *   empty array if no pubs match
+ *   empty array if no pubs match.
  *
  * @ingroup tripal_pub_api
  */
-function tripal_publication_exists($pub_details) {
+function chado_publication_exists($pub_details) {
 
-  // first try to find the publication using the accession number if that key exists in the details array
+  // First try to find the publication using the accession number if that key 
+  // exists in the details array.
   if (array_key_exists('Publication Dbxref', $pub_details)) {
-    $pub = tripal_get_publication(array('dbxref' => $pub_details['Publication Dbxref']));
+    $pub = chado_get_publication(array('dbxref' => $pub_details['Publication Dbxref']));
     if($pub) {
       return array($pub->pub_id);
     }
   }
 
-  // make sure the citation is unique
+  // Make sure the citation is unique.
   if (array_key_exists('Citation', $pub_details)) {
-    $pub = tripal_get_publication(array('uniquename' => $pub_details['Citation']));
+    $pub = chado_get_publication(array('uniquename' => $pub_details['Citation']));
     if($pub) {
       return array($pub->pub_id);
     }
   }
 
-  // get the publication type (use the first publication type)
+  // Get the publication type (use the first publication type).
   if (array_key_exists('Publication Type', $pub_details)) {
     $type_name = '';
     if(is_array($pub_details['Publication Type'])) {
@@ -209,22 +221,23 @@ function tripal_publication_exists($pub_details) {
         'name' => 'tripal_pub',
       ),
     );
-    $pub_type = tripal_get_cvterm($identifiers);
+    $pub_type = chado_get_cvterm($identifiers);
   }
   else {
     tripal_report_error('tripal_pub', TRIPAL_ERROR,
-      "tripal_publication_exists(): The Publication Type is a " .
+      "chado_publication_exists(): The Publication Type is a " .
       "required property but is missing", array());
     return array();
   }
   if (!$pub_type) {
     tripal_report_error('tripal_pub', TRIPAL_ERROR,
-     "tripal_publication_exists(): Cannot find publication type: '%type'",
+      "chado_publication_exists(): Cannot find publication type: '%type'",
       array('%type' => $pub_details['Publication Type'][0]));
     return array();
   }
 
-  // get the series name.  The pub.series_name field is only 255 chars so we must truncate to be safe
+  // Get the series name.  The pub.series_name field is only 255 chars so we 
+  // must truncate to be safe.
   $series_name = '';
   if (array_key_exists('Series Name', $pub_details)) {
     $series_name = substr($pub_details['Series Name'], 0, 255);
@@ -236,7 +249,8 @@ function tripal_publication_exists($pub_details) {
     $series_name = substr($pub_details['Conference Name'], 0, 255);
   }
 
-  // make sure the publication is unique using the prefereed import duplication check
+  // Make sure the publication is unique using the prefereed import 
+  // duplication check.
   $import_dups_check = variable_get('tripal_pub_import_duplicate_check', 'title_year_media');
   $pubs = array();
   switch ($import_dups_check) {
@@ -280,14 +294,14 @@ function tripal_publication_exists($pub_details) {
  * @param $field
  *   The field in the publication to search on.
  * @param $string
- *   The string to search for
+ *   The string to search for.
  *
  * @return
- *   A json array of terms that begin with the provided string
+ *   A json array of terms that begin with the provided string.
  *
- * @ingroup tripal_chado_api
+ * @ingroup tripal_pub_api
  */
-function tripal_autocomplete_pub($string = '') {
+function chado_autocomplete_pub($string = '') {
   $items = array();
   $sql = "
     SELECT pub_id, title, uniquename
@@ -321,9 +335,9 @@ function tripal_autocomplete_pub($string = '') {
  *   If set to TRUE then the publication will be updated if it already exists
  *   in the database.
  *
- * @ingroup tripal_pub
+ * @ingroup tripal_pub_api
  */
-function tripal_import_pub_by_dbxref($pub_dbxref, $do_contact = FALSE, $do_update = TRUE) {
+function chado_import_pub_by_dbxref($pub_dbxref, $do_contact = FALSE, $do_update = TRUE) {
   $num_to_retrieve = 1;
   $pager_id = 0;
   $page = 0;
@@ -366,11 +380,12 @@ function tripal_import_pub_by_dbxref($pub_dbxref, $do_contact = FALSE, $do_updat
     // is enabled. If so, then sync the nodes.
     if (module_exists('tripal_pub')) {
 
-      // sync the newly added publications with Drupal
+      // Sync the newly added publications with Drupal.
       print "Syncing publications with Drupal...\n";
       chado_node_sync_records('pub');
 
-      // if any of the importers wanted to create contacts from the authors then sync them
+      // If any of the importers wanted to create contacts from the authors 
+      // then sync them.
       if($do_contact) {
         print "Syncing contacts with Drupal...\n";
         chado_node_sync_records('contact');
@@ -391,14 +406,14 @@ function tripal_import_pub_by_dbxref($pub_dbxref, $do_contact = FALSE, $do_updat
  *
  * @param $report_email
  *   A list of email address, separated by commas, that should be notified
- *   once importing has completed
+ *   once importing has completed.
  * @param $do_update
  *   If set to TRUE then publications that already exist in the Chado database
- *   will be updated, whereas if FALSE only new publications will be added
+ *   will be updated, whereas if FALSE only new publications will be added.
  *
- * @ingroup tripal_pub
+ * @ingroup tripal_pub_api
  */
-function tripal_execute_active_pub_importers($report_email = FALSE, $do_update = FALSE) {
+function chado_execute_active_pub_importers($report_email = FALSE, $do_update = FALSE) {
   $num_to_retrieve = 100;
   $page = 0;
 
@@ -410,7 +425,7 @@ function tripal_execute_active_pub_importers($report_email = FALSE, $do_update =
   $transaction = db_transaction();
 
   try {
-    // get all of the loaders
+    // Get all of the loaders.
     $args = array();
     $sql = "SELECT * FROM {tripal_pub_import} WHERE disabled = 0 ";
     $results = db_query($sql, $args);
@@ -419,27 +434,27 @@ function tripal_execute_active_pub_importers($report_email = FALSE, $do_update =
     foreach ($results as $import) {
       $page = 0;
       print "Executing importer: '" . $import->name . "'\n";
-      // keep track if any of the importers want to create contacts from authors
+      // Keep track if any of the importers want to create contacts from authors.
       if ($import->do_contact == 1) {
         $do_contact = TRUE;
       }
       $criteria = unserialize($import->criteria);
       $remote_db = $criteria['remote_db'];
       do {
-        // retrieve the pubs for this page. We'll retreive 100 at a time
+        // Retrieve the pubs for this page. We'll retreive 100 at a time.
         $results = tripal_get_remote_pubs($remote_db, $criteria, $num_to_retrieve, $page);
         $pubs = $results['pubs'];
         $reports[$import->name] = tripal_pub_add_publications($pubs, $import->do_contact, $do_update);
         $page++;
       }
-      // continue looping until we have a $pubs array that does not have
-      // our requested numer of records.  This means we've hit the end
+      // Continue looping until we have a $pubs array that does not have
+      // our requested numer of records.  This means we've hit the end.
       while (count($pubs) == $num_to_retrieve);
     }
 
-    // sync the newly added publications with Drupal. If the user
+    // Sync the newly added publications with Drupal. If the user
     // requested a report then we don't want to print any syncing information
-    // so pass 'FALSE' to the sync call
+    // so pass 'FALSE' to the sync call.
     // For backwards compatibility check to see if the legacy pub module
     // is enabled. If so, then sync the nodes.
     if (module_exists('tripal_pub')) {
@@ -447,7 +462,8 @@ function tripal_execute_active_pub_importers($report_email = FALSE, $do_update =
       chado_node_sync_records('pub');
     }
 
-    // iterate through each of the reports and generate a final report with HTML links
+    // Iterate through each of the reports and generate a final report with HTML
+    // links.
     $HTML_report = '';
     if ($report_email) {
       $HTML_report .= "<html>";
@@ -475,7 +491,8 @@ function tripal_execute_active_pub_importers($report_email = FALSE, $do_update =
     // For backwards compatibility check to see if the legacy pub module
     // is enabled. If so, then sync the nodes.
     if (module_exists('tripal_pub')) {
-      // if any of the importers wanted to create contacts from the authors then sync them
+      // If any of the importers wanted to create contacts from the authors then 
+      // sync them.
       if($do_contact) {
         print "Syncing contacts with Drupal...\n";
         chado_node_sync_records('contact');
@@ -512,9 +529,9 @@ function tripal_execute_active_pub_importers($report_email = FALSE, $do_update =
  *   no dbxref then all of the publications currently in the Chado database
  *   for this remote database will be updated.
  *
- * @ingroup tripal_pub
+ * @ingroup tripal_pub_api
  */
-function tripal_reimport_publications($do_contact = FALSE, $dbxref = NULL, $db = NULL) {
+function chado_reimport_publications($do_contact = FALSE, $dbxref = NULL, $db = NULL) {
 
   print "\nNOTE: Loading of publications is performed using a database transaction. \n" .
       "If the load fails or is terminated prematurely then the entire set of \n" .
@@ -522,7 +539,8 @@ function tripal_reimport_publications($do_contact = FALSE, $dbxref = NULL, $db =
   $transaction = db_transaction();
   try {
 
-    // get a list of all publications by their Dbxrefs that have supported databases
+    // Get a list of all publications by their Dbxrefs that have supported 
+    // databases.
     $sql = "
       SELECT DB.name as db_name, DBX.accession
       FROM pub P
@@ -546,17 +564,17 @@ function tripal_reimport_publications($do_contact = FALSE, $dbxref = NULL, $db =
     $results = chado_query($sql, $args);
 
     $num_to_retrieve = 100;
-    $i = 0;                 // count the number of IDs. When we hit $num_to_retrieve we'll do the query
-    $curr_db = '';          // keeps track of the current current database
-    $ids = array();         // the list of IDs for the database
-    $search = array();      // the search array passed to the search function
+    $i = 0;                 // count the number of IDs. When we hit $num_to_retrieve we'll do the query.
+    $curr_db = '';          // keeps track of the current current database.
+    $ids = array();         // the list of IDs for the database.
+    $search = array();      // the search array passed to the search function.
 
-    // iterate through the pub IDs
+    // Iterate through the pub IDs.
     while ($pub = $results->fetchObject()) {
       $accession = $pub->accession;
       $remote_db = $pub->db_name;
 
-      // here we need to only update publications for databases we support
+      // Here we need to only update publications for databases we support.
       $supported_dbs = variable_get('tripal_pub_supported_dbs', array());
       if(!in_array($remote_db, $supported_dbs)) {
         continue;
@@ -582,11 +600,11 @@ function tripal_reimport_publications($do_contact = FALSE, $dbxref = NULL, $db =
     // For backwards compatibility check to see if the legacy pub module
     // is enabled. If so, then sync the nodes.
     if (module_exists('tripal_pub')) {
-      // sync the newly added publications with Drupal
+      // Sync the newly added publications with Drupal.
       print "Syncing publications with Drupal...\n";
       chado_node_sync_records('pub');
 
-      // if the caller wants to create contacts then we should sync them
+      // If the caller wants to create contacts then we should sync them.
       if ($do_contact) {
         print "Syncing contacts with Drupal...\n";
         chado_node_sync_records('contact');
@@ -613,12 +631,12 @@ function tripal_reimport_publications($do_contact = FALSE, $dbxref = NULL, $db =
  * @param $options
  *  Options pertaining to what publications to generate citations for.
  *  One of the following must be present:
- *   - all: Create and replace citation for all pubs
- *   - new: Create citation for pubs that don't already have one
+ *   - all: Create and replace citation for all pubs.
+ *   - new: Create citation for pubs that don't already have one.
  *
- * @ingroup tripal_pub
+ * @ingroup tripal_pub_api
  */
-function tripal_pub_create_citations($options) {
+function chado_pub_create_citations($options) {
   $skip_existing = TRUE;
   $sql = "
     SELECT cvterm_id
@@ -629,12 +647,12 @@ function tripal_pub_create_citations($options) {
   ";
   $citation_type_id = chado_query($sql)->fetchField();
 
-  // Create and replace citation for all pubs
+  // Create and replace citation for all pubs.
   if ($options == 'all') {
     $sql = "SELECT pub_id FROM {pub} P WHERE pub_id <> 1";
     $skip_existing = FALSE;
   }
-  // Create citation for pubs that don't already have one
+  // Create citation for pubs that don't already have one.
   else if ($options == 'new') {
     $sql = "
       SELECT pub_id
@@ -654,9 +672,10 @@ function tripal_pub_create_citations($options) {
   while ($pub = $result->fetchObject()) {
     $pub_arr = tripal_pub_get_publication_array($pub->pub_id, $skip_existing);
     if ($pub_arr) {
-      $citation = tripal_pub_create_citation($pub_arr);
+      $citation = chado_pub_create_citation($pub_arr);
       print $citation . "\n\n";
-      // Replace if citation exists. This condition is never TRUE if $skip_existing is TRUE
+      // Replace if citation exists. This condition is never TRUE if 
+      // $skip_existing is TRUE.
       if ($pub_arr['Citation']) {
         $sql = "
           UPDATE {pubprop} SET value = :value
@@ -665,7 +684,7 @@ function tripal_pub_create_citations($options) {
         chado_query($sql, array(':value' => $citation, ':pub_id' => $pub->pub_id,
           ':type_id' => $citation_type_id, ':rank' => 0));
         $counter_updated ++;
-        // Generate a new citation
+        // Generate a new citation.
       } else {
         $sql = "
           INSERT INTO {pubprop} (pub_id, type_id, value, rank)
@@ -692,23 +711,25 @@ function tripal_pub_create_citations($options) {
  *   are the publication ontology term names and values are the
  *   corresponding details.  The pub array can contain the following
  *   keys with corresponding values:
- *     - Publication Type:  an array of publication types. a publication can have more than one type
- *     - Authors: a  string containing all of the authors of a publication
- *     - Journal Name:  a string containing the journal name
- *     - Journal Abbreviation: a string containing the journal name abbreviation
- *     - Series Name: a string containing the series (e.g. conference proceedings) name
+ *     - Publication Type:  an array of publication types. a publication can 
+ *       have more than one type.
+ *     - Authors: a  string containing all of the authors of a publication.
+ *     - Journal Name:  a string containing the journal name.
+ *     - Journal Abbreviation: a string containing the journal name abbreviation.
+ *     - Series Name: a string containing the series (e.g. conference 
+ *       proceedings) name.
  *     - Series Abbreviation: a string containing the series name abbreviation
- *     - Volume: the serives volume number
- *     - Issue: the series issue number
- *     - Pages: the page numbers for the publication
- *     - Publication Date:  A date in the format "Year Month Day"
+ *     - Volume: the serives volume number.
+ *     - Issue: the series issue number.
+ *     - Pages: the page numbers for the publication.
+ *     - Publication Date:  A date in the format "Year Month Day".
  *
  * @return
- *   A text string containing the citation
+ *   A text string containing the citation.
  *
- * @ingroup tripal_pub
+ * @ingroup tripal_pub_api
  */
-function tripal_pub_create_citation($pub) {
+function chado_pub_create_citation($pub) {
   $citation = '';
   $pub_type = '';
 
@@ -745,8 +766,8 @@ function tripal_pub_create_citation($pub) {
       }
       else if ($ptype == "Research Support, Non-U.S. Gov't") {
         $pub_type = $ptype;
-        // we don't break because if the article is also a Journal Article
-        // we prefer that type
+        // We don't break because if the article is also a Journal Article
+        // we prefer that type.
       }
     }
     // If we don't have a recognized publication type, then just use the
@@ -999,16 +1020,18 @@ function tripal_pub_create_citation($pub) {
  * Retrieves the minimal information to uniquely describe any publication.
  *
  * The returned array is an associative array where the keys are
- * the controlled vocabulary terms in the form [vocab]:[accession]
+ * the controlled vocabulary terms in the form [vocab]:[accession].
  *
  * @param $pub
- *   A publication object as created by chado_generate_var()
+ *   A publication object as created by chado_generate_var().
  *
  * @return
  *   An array with the following keys:  'Citation', 'Abstract', 'Authors',
  *   'URL'. All keys are term names in the Tripal Publication Ontology :TPUB.
+ * 
+ * @ingroup tripal_pub_api
  */
-function tripal_get_minimal_pub_info($pub) {
+function chado_get_minimal_pub_info($pub) {
   if (!$pub) {
     return array();
   }
@@ -1018,11 +1041,11 @@ function tripal_get_minimal_pub_info($pub) {
     return array();
   }
 
-  // expand the title
+  // Expand the title.
   $pub = chado_expand_var($pub, 'field', 'pub.title');
   $pub = chado_expand_var($pub, 'field', 'pub.volumetitle');
 
-  // get the abstract
+  // Get the abstract.
   $values = array(
     'pub_id' => $pub->pub_id,
     'type_id' => array(
@@ -1058,7 +1081,7 @@ function tripal_get_minimal_pub_info($pub) {
     $authors_list = $authors->value;
   }
 
-  // get the first database cross-reference with a url.
+  // Get the first database cross-reference with a url.
   $options = array('return_array' => 1);
   $pub = chado_expand_var($pub, 'table', 'pub_dbxref', $options);
   $dbxref = NULL;
@@ -1070,7 +1093,7 @@ function tripal_get_minimal_pub_info($pub) {
     }
   }
 
-  // get the URL.
+  // Get the URL.
   $values = array(
     'pub_id' => $pub->pub_id,
     'type_id' => array(
@@ -1103,7 +1126,7 @@ function tripal_get_minimal_pub_info($pub) {
     $dbxrefs[] = $pub_dbxref->dbxref_id->db_id->name . ':' . $pub_dbxref->dbxref_id->accession;
   }
 
-  // get the citation
+  // Get the citation.
   $values = array(
     'pub_id' => $pub->pub_id,
     'type_id' => array(
@@ -1130,7 +1153,7 @@ function tripal_get_minimal_pub_info($pub) {
       'Pages' => $pub->pages,
       'Publication Date' => $pub->pyear,
     );
-    $citation = tripal_pub_create_citation($pub_info);
+    $citation = chado_pub_create_citation($pub_info);
   }
 
   return array(

tripal_chado/api/modules/tripal_chado.stock.api.inc

@@ -1,13 +1,19 @@
 <?php
 /**
  * @file
- * Provides an application programming interface (API) to manage stocks
+ * Provides API functions specificially for managing stock 
+ * records in Chado. 
  */
 
 /**
  * @defgroup tripal_stock_api Chado Stock
  * @ingroup tripal_chado_api
  * @{
+ * Provides API functions specificially for managing stock 
+ * records in Chado.  The stock table of Chado is used for storing a variety
+ * of data types besides just stocks from a stock collection.  Examples of 
+ * other records commonly stored in the stock table are germplasm and
+ * individuals from a breeding population.
  * @}
  */
 
@@ -15,43 +21,45 @@
  * Retrieves a chado stock variable
  *
  * @param $identifier
- *   An array with the key stating what the identifier is. Supported keys (only one of the
- *   following unique keys is required):
+ *   An array with the key stating what the identifier is. Supported keys (only 
+ *   one of the following unique keys is required):
  *    - stock_id: the chado stock.stock_id primary key
  *    - nid: the drupal nid of the stock
  *   There are also some specially handled keys. They are:
- *    - property: An array/object describing the property to select records for. It
- *      should at least have either a type_name (if unique across cvs) or type_id. Other
- *      supported keys include: cv_id/cv_name (of the type), value and rank
+ *    - property: An array/object describing the property to select records for. 
+ *      It should at least have either a type_name (if unique across cvs) or 
+ *      type_id. Other supported keys include: cv_id/cv_name (of the type), 
+ *      value and rank
  * @param $options
  *   An array of options. Supported keys include:
- *     - Any keys supported by chado_generate_var(). See that function definition for
- *       additional details.
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *      definition for additional details.
  *
- * NOTE: the $identifier parameter can really be any array similar to $values passed into
- *   chado_select_record(). It should fully specify the stock record to be returned.
+ * NOTE: the $identifier parameter can really be any array similar to $values
+ * passed into chado_select_record(). It should fully specify the stock record 
+ * to be returned.
  *
  * @return
- *   If unique values were passed in as an identifier then an object describing the stock
- *   will be returned (will be a chado variable from chado_generate_var()). Otherwise,
- *   FALSE will be returned.
+ *   If unique values were passed in as an identifier then an object describing 
+ *   the stock will be returned (will be a chado variable from 
+ *   chado_generate_var()). Otherwise, FALSE will be returned.
  *
  * @ingroup tripal_stock_api
  */
-function tripal_get_stock($identifiers, $options = array()) {
+function chado_get_stock($identifiers, $options = array()) {
 
-  // Set Defaults
+  // Set Defaults.
   if (!isset($options['include_fk'])) {
-    // Tells chado_generate_var to only expand 1 level
+    // Tells chado_generate_var to only expand 1 level.
     $options['include_fk'] = array('type_id' => TRUE, 'dbxref_id' => TRUE);
   }
 
-  // Error Checking of parameters
+  // Error Checking of parameters.
   if (!is_array($identifiers)) {
     tripal_report_error(
       'tripal_stock_api',
       TRIPAL_ERROR,
-      "tripal_get_stock: The identifier passed in is expected to be an array with the key
+      "chado_get_stock: The identifier passed in is expected to be an array with the key
         matching a column name in the stock table (ie: stock_id or name). You passed in %identifier.",
       array(
         '%identifier'=> print_r($identifiers, TRUE)
@@ -62,7 +70,7 @@ function tripal_get_stock($identifiers, $options = array()) {
     tripal_report_error(
       'tripal_stock_api',
       TRIPAL_ERROR,
-      "tripal_get_stock: You did not pass in anything to identify the stock you want. The identifier
+      "chado_get_stock: You did not pass in anything to identify the stock you want. The identifier
         is expected to be an array with the key matching a column name in the stock table
         (ie: stock_id or name). You passed in %identifier.",
       array(
@@ -71,7 +79,8 @@ function tripal_get_stock($identifiers, $options = array()) {
     );
   }
 
-  // If one of the identifiers is property then use chado_get_record_with_property()
+  // If one of the identifiers is property then use 
+  // chado_get_record_with_property().
   if (isset($identifiers['property'])) {
     $property = $identifiers['property'];
     unset($identifiers['property']);
@@ -82,10 +91,11 @@ function tripal_get_stock($identifiers, $options = array()) {
     );
   }
 
-  // Else we have a simple case and we can just use chado_generate_var to get the stock
+  // Else we have a simple case and we can just use chado_generate_var to get 
+  // the stock.
   else {
 
-    // Try to get the stock
+    // Try to get the stock.
     $stock = chado_generate_var(
       'stock',
       $identifiers,
@@ -93,24 +103,24 @@ function tripal_get_stock($identifiers, $options = array()) {
     );
   }
 
-  // Ensure the stock is singular. If it's an array then it is not singular
+  // Ensure the stock is singular. If it's an array then it is not singular.
   if (is_array($stock)) {
     tripal_report_error(
       'tripal_stock_api',
       TRIPAL_ERROR,
-      "tripal_get_stock: The identifiers you passed in were not unique. You passed in %identifier.",
+      "chado_get_stock: The identifiers you passed in were not unique. You passed in %identifier.",
       array(
         '%identifier'=> print_r($identifiers, TRUE)
       )
     );
   }
 
-  // Report an error if $stock is FALSE since then chado_generate_var has failed
+  // Report an error if $stock is FALSE since then chado_generate_var has failed.
   elseif ($stock === FALSE) {
     tripal_report_error(
       'tripal_stock_api',
       TRIPAL_ERROR,
-      "tripal_get_stock: chado_generate_var() failed to return a stock based on the identifiers
+      "chado_get_stock: chado_generate_var() failed to return a stock based on the identifiers
         you passed in. You should check that your identifiers are correct, as well as, look
         for a chado_generate_var error for additional clues. You passed in %identifier.",
       array(
@@ -126,36 +136,36 @@ function tripal_get_stock($identifiers, $options = array()) {
 }
 
 /**
- * Retrieves a chado stock variable
+ * Retrieves a chado stock variable.
  *
  * @param $identifier
- *   An array with the key stating what the identifier is. Supported keys include any
- *   field in the stock table. See the chado_select_record() $values parameter for
- *   additional details including an example.
+ *   An array with the key stating what the identifier is. Supported keys 
+ *   include any field in the stock table. See the chado_select_record() $values
+ *   parameter for additional details including an example.
  * @param $options
  *   An array of options. Supported keys include:
- *     - Any keys supported by chado_generate_var(). See that function definition for
- *       additional details.
+ *     - Any keys supported by chado_generate_var(). See that function 
+ *       definition for additional details.
  *
  * @return
  *   An array of stock objects matching the criteria.
  *
  * @ingroup tripal_stock_api
  */
-function tripal_get_multiple_stocks($identifiers, $options = array()) {
+function chado_get_multiple_stocks($identifiers, $options = array()) {
 
-  // Set Defaults
+  // Set Defaults.
   if (!isset($options['include_fk'])) {
-    // Tells chado_generate_var to only expand 1 level
+    // Tells chado_generate_var to only expand 1 level.
     $options['include_fk'] = array('type_id' => TRUE, 'dbxref_id' => TRUE);
   }
 
-  // Error Checking of parameters
+  // Error Checking of parameters.
   if (!is_array($identifiers)) {
     tripal_report_error(
       'tripal_stock_api',
       TRIPAL_ERROR,
-      "tripal_get_stock: The identifier passed in is expected to be an array with the key
+      "chado_get_stock: The identifier passed in is expected to be an array with the key
         matching a column name in the stock table (ie: stock_id or name). You passed in %identifier.",
       array(
         '%identifier'=> print_r($identifiers, TRUE)
@@ -166,7 +176,7 @@ function tripal_get_multiple_stocks($identifiers, $options = array()) {
     tripal_report_error(
       'tripal_stock_api',
       TRIPAL_ERROR,
-      "tripal_get_stock: You did not pass in anything to identify the stock you want. The identifier
+      "chado_get_stock: You did not pass in anything to identify the stock you want. The identifier
         is expected to be an array with the key matching a column name in the stock table
         (ie: stock_id or name). You passed in %identifier.",
       array(
@@ -175,7 +185,8 @@ function tripal_get_multiple_stocks($identifiers, $options = array()) {
     );
   }
 
-  // If one of the identifiers is property then use chado_get_record_with_property()
+  // If one of the identifiers is property then use 
+  // chado_get_record_with_property().
   if (isset($identifiers['property'])) {
     $property = $identifiers['property'];
     unset($identifiers['property']);
@@ -186,10 +197,11 @@ function tripal_get_multiple_stocks($identifiers, $options = array()) {
     );
   }
 
-  // Else we have a simple case and we can just use chado_generate_var to get the stock
+  // Else we have a simple case and we can just use chado_generate_var to get 
+  //the stock.
   else {
 
-    // Try to get the stock
+    // Try to get the stock.
     $stock = chado_generate_var(
       'stock',
       $identifiers,
@@ -197,12 +209,12 @@ function tripal_get_multiple_stocks($identifiers, $options = array()) {
     );
   }
 
-  // Report an error if $stock is FALSE since then chado_generate_var has failed
+  // Report an error if $stock is FALSE since then chado_generate_var has failed.
   if ($stock === FALSE) {
     tripal_report_error(
       'tripal_stock_api',
       TRIPAL_ERROR,
-      "tripal_get_stock: chado_generate_var() failed to return a stock based on the identifiers
+      "chado_get_stock: chado_generate_var() failed to return a stock based on the identifiers
         you passed in. You should check that your identifiers are correct, as well as, look
         for a chado_generate_var error for additional clues. You passed in %identifier.",
       array(

tripal_chado/api/tripal_chado.DEPRECATED.api.inc

@@ -0,0 +1,391 @@
+<?php
+
+/**
+ * @file
+ *
+ * These api functions are deprecated, if your site is currently using them
+ * please update your code with the newer tripal_chado functions.
+ */
+
+/**
+ * @defgroup tripal_chado_DEPRECATED_api
+ * @ingroup tripal_chado_api
+ * @{
+ * Deprecated legacy api code.
+ * @}
+ */
+
+/**
+ * Publishes content in Chado as a new TripalEntity entity.
+ *
+ * @param $values
+ *   A key/value associative array that supports the following keys:
+ *   - bundle_name:  The name of the the TripalBundle (e.g. bio_data-12345).
+ * @param $job_id
+ *   (Optional) The numeric job ID as provided by the Tripal jobs system. There
+ *   is no need to specify this argument if this function is being called
+ *   outside of the jobs systems.
+ *
+ * @return boolean
+ *   TRUE if all of the records of the given bundle type were published, and
+ *   FALSE if a failure occured.
+ *
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_chado_publish_records($values, $job_id = null) {
+  chado_publish_records($values, $job_id = null);
+}
+
+/**
+ * Returns an array of tokens based on Tripal Entity Fields.
+ *
+ * @param $base_table
+ *    The name of a base table in Chado.
+ * @return
+ *    An array of tokens where the key is the machine_name of the token.
+ * 
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_get_chado_tokens($base_table) {
+  chado_get_tokens($base_table);
+}
+
+/**
+ * Replace all Chado Tokens in a given string.
+ *
+ * NOTE: If there is no value for a token then the token is removed.
+ *
+ * @param string $string
+ *   The string containing tokens.
+ * @param $record
+ *   A Chado record as generated by chado_generate_var()
+ *
+ * @return
+ *   The string will all tokens replaced with values.
+ * 
+ *  @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_replace_chado_tokens($string, $record) {
+  chado_replace_tokens($string, $record);
+}
+
+/**
+ * Migrate Tripal content types
+ * 
+ * Migrate specified Tripal content type and publish all its content. The content type 
+ * will be created if it does not already exist.
+ * 
+ * @param $type
+ *   A type array specifying the vocabular, accession, term_name, and chado data_table
+ *   e.g.
+ *     $type = array(
+ *       'vocabulary' => 'OBI',
+ *       'accession' => '0100026',
+ *       'term_name' => 'organism',
+ *       'storage_args' => array (
+ *         'data_table' => $table
+ *       )
+ *     )
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_chado_migrate_tripal_content_type($type = array()) {
+  chado_migrate_tripal_content_type($type = array());
+}
+
+
+/**
+ * Add a materialized view to the chado database to help speed data access. This
+ * function supports the older style where postgres column specifications
+ * are provided using the $mv_table, $mv_specs and $indexed variables. It also
+ * supports the newer preferred method where the materialized view is described
+ * using the Drupal Schema API array.
+ *
+ * @param $name
+ *   The name of the materialized view.
+ * @param $modulename
+ *   The name of the module submitting the materialized view 
+ *   (e.g. 'tripal_library').
+ * @param $mv_schema
+ *   If using the newer Schema API array to define the materialized view then
+ *   this variable should contain the array or a string representation of the
+ *   array.
+ * @param $query
+ *   The SQL query that loads the materialized view with data.
+ * @param $comment
+ *   A string containing a description of the materialized view.
+ * @param $redirect
+ *   Optional (default: TRUE). By default this function redirects back to
+ *   admin pages. However, when called by Drush we don't want to redirect. This
+ *   parameter allows this to be used as a true API function.
+ *
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_add_mview($name, $modulename, $mv_schema, $query, $comment = null, $redirect = true) {
+  chado_add_mview($name, $modulename, $mv_schema, $query, $comment = null, $redirect = true);
+}
+
+/**
+ * Edits a materialized view to the chado database to help speed data access. 
+ * This function supports the older style where postgres column specifications
+ * are provided using the $mv_table, $mv_specs and $indexed variables. It also
+ * supports the newer preferred method where the materialized view is described
+ * using the Drupal Schema API array.
+ *
+ * @param $mview_id
+ *   The mview_id of the materialized view to edit.
+ * @param $name
+ *   The name of the materialized view.
+ * @param $modulename
+ *   The name of the module submitting the materialized view 
+ *   (e.g. 'tripal_library').
+ * @param $mv_table
+ *   The name of the table to add to chado. This is the table that can be 
+ *   queried.
+ * @param $mv_specs
+ *   The table definition.
+ * @param $indexed
+ *   The columns that are to be indexed.
+ * @param $query
+ *   The SQL query that loads the materialized view with data.
+ * @param $special_index
+ *   currently not used.
+ * @param $comment
+ *   A string containing a description of the materialized view.
+ * @param $mv_schema
+ *   If using the newer Schema API array to define the materialized view then
+ *   this variable should contain the array.
+ *
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_edit_mview($mview_id, $name, $modulename, $mv_table, $mv_specs,
+  $indexed, $query, $special_index, $comment = null, $mv_schema = null) {
+  chado_edit_mview($mview_id, $name, $modulename, $mv_table, $mv_specs,
+    $indexed, $query, $special_index, $comment = null,$mv_schema = null);
+}
+
+/**
+ * Retrieve the materialized view_id given the name.
+ *
+ * @param $view_name
+ *   The name of the materialized view.
+ *
+ * @return
+ *   The unique identifier for the given view.
+ *
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_get_mview_id($view_name) {
+  chado_get_mview_id($view_name);
+}
+
+/**
+ * Populates the specified Materialized View.
+ *
+ * @param $mview_id
+ *   The unique ID of the materialized view for the action to be performed on.
+ *
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_refresh_mview($mview_id) {
+  chado_refresh_mview($mview_id);
+}
+
+/**
+ * Retrieves the list of materialized view IDs and their names.
+ *
+ * @return
+ *   An array of objects with the following properties:  mview_id, name.
+ *
+ * @ingroup tripal_chado_DEPRECATED_api
+ *
+ */
+function tripal_get_mviews() {
+  chado_get_mviews();
+}
+
+/**
+ * Does the specified action for the specified Materialized View.
+ *
+ * @param $op
+ *   The action to be taken. One of update or delete.
+ * @param $mview_id
+ *   The unique ID of the materialized view for the action to be performed on.
+ *
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_delete_mview($mview_id) {
+  chado_delete_mview($mview_id);
+}
+
+/**
+ * Update a Materialized View.
+ *
+ * @param $mview_id
+ *   The unique identifier for the materialized view to be updated.
+ *
+ * @return
+ *   True if successful, FALSE otherwise.
+ *
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_populate_mview($mview_id) {
+  chado_populate_mview($mview_id);
+}
+
+/**
+ * Alter the name of the schema housing Chado and/or Drupal.
+ *
+ * This example implementation shows a solution for the case where your chado 
+ * database was well established in the "public" schema and you added Drupal 
+ * later in a "drupal" schema. Please note that this has not been tested and 
+ * while we can ensure that Tripal will work as expected, we have no control 
+ * over whether Drupal is compatible with not being in the public schema. That's
+ * why we recommened the organization we have (ie: Chado in a "chado" schema and
+ * Drupal in the "public schema).
+ *
+ * @param $schema_name
+ *   The current name of the schema as known by Tripal. This is likely the 
+ *   default set in tripal_get_schema_name() but in the case of multiple alter 
+ *   hooks, it might be different.
+ * @param $context
+ *   This is an array of items to provide context.
+ *     - schema: this is the schema that was passed to tripal_get_schema_name() 
+ *       and will be either "chado" or "drupal". This should be used to 
+ *       determine you are changing the name of the correct schema.
+ *
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function hook_tripal_get_schema_name_alter($schema_name, $context)
+{
+  hook_chado_get_schema_name_alter($schema_name, $context);
+}
+
+/**
+ * Retrieve the name of the PostgreSQL schema housing Chado or Drupal.
+ *
+ * @param $schema
+ *   Wehter you want the schema name for 'chado' or 'drupal'. Chado is the 
+ *   default.
+ * @return
+ *   The name of the PostgreSQL schema housing the $schema specified.
+ *
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_get_schema_name($schema = 'chado') {
+  chado_get_schema_name($schema);
+}
+
+
+/**
+ * Adds a new Chado table to the semantic web support for Chado.
+ *
+ * Newly added tables (i.e. custom tables) need to be integrated into the
+ * semantic web infrastructure.  After a new table is created and added to
+ * the Chado schema, this function should be called to indicate that the
+ * table should be included in the semantic web. No associations are made for
+ * the columns. The associations should be added using the
+ * tripal_associate_chado_semweb_term() function.
+ *
+ * If the table has already been added previously then this function does
+ * nothing. It will not overwrite existing assocations.
+ *
+ * Temporary tables (e.g. Tripal tables that begin with 'tripal_' and end with
+ * '_temp', are not supported.
+ *
+ * @param $chado_table
+ *   The name of the Chado table.
+ * 
+ * @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_add_chado_semweb_table($chado_table) {
+  chado_add_semweb_table($chado_table);
+}
+
+/**
+ * Associates a controlled vocabulary term with a field in a Chado table.
+ *
+ * For sharing of data via the semantic web we need to associate a
+ * term from a controlled vocabulary with every column of every table in Chado.
+ *
+ * Temporary tables (e.g. Tripal tables that begin with 'tripal_' and end with
+ * '_temp', are not supported.
+ *
+ * @param $chado_table
+ *   The name of the table in Chado. This argument is optional. If left empty
+ *   or set to NULL then all fields in all Chado tables with that have the
+ *   $column_name will be associated with the provided $term.
+ * @param $chado_column
+ *   The column name in the Chado table to which the term should be associated.
+ * @param $term
+ *   A cvterm object as returned by chado_generate_var().
+ * @param $update
+ *   Set to TRUE if the association should be updated to use the new term
+ *   if a term is already associated with the table and column.  Default is
+ *   FALSE.  If not TRUE and a term is already associated, then no change
+ *   occurs.
+ *
+ * @return boolean
+ *   Returns TRUE if the association was made successfully and FALSE otherwise.
+ * 
+ *  @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_associate_chado_semweb_term($chado_table, $chado_column, $term,
+    $update = false) {
+  chado_associate_semweb_term($chado_table, $chado_column, $term, $update);
+}
+
+
+/**
+ * Retrieves the term that maps to the given Chado table and field.
+ *
+ * @param $chado_table
+ *   The name of the Chado table.
+ * @param $chado_column
+ *   The name of the Chado field.
+ * @param $options
+ *   An associative array of one or more of the following keys:
+ *     -return_object:  Set to TRUE to return the cvterm object rather than
+ *      the string version of the term.
+ *
+ * @return
+ *   Returns a string-based representation of the term (e.g. SO:0000704). If
+ *   the 'return_object' options is provided then a cvterm object is returned.
+ *   returns NULL if no term is mapped to the table and column.
+ * 
+ *  @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_get_chado_semweb_term($chado_table, $chado_column, $options = array()) {
+  chado_get_semweb_term($chado_table, $chado_column, $options);
+}
+
+/**
+ * Formats a controlled vocabulary term from Chado for use with Tripal.
+ *
+ * @param $cvterm
+ *   A cvterm object.
+ * @return
+ *   The semantic web name for the term.
+ * 
+ *  @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_format_chado_semweb_term($cvterm) {
+  chado_format_semweb_term($cvterm);
+}
+/**
+ * Retreive the column name in a Chado table that matches a given term.
+ *
+ * @param $chado_table
+ *   The name of the Chado table.
+ * @param $term
+ *   The term. This can be a term name or a unique identifer of the form
+ *   {db}:{accession} or of the form {db}__{term_name}.
+ *
+ * @return
+ *   The name of the Chado column that matches the given term or FALSE if the
+ *   term is not mapped to the Chado table.
+ * 
+ *  @ingroup tripal_chado_DEPRECATED_api
+ */
+function tripal_get_chado_semweb_column($chado_table, $term) {
+  chado_get_semweb_column($chado_table, $term);
+}

tripal_chado/api/tripal_chado.api.inc

@@ -1,5 +1,24 @@
 <?php
 
+/**
+ * @file
+ *
+ * This file contains miscellaneous API functions specific to working with
+ * records in Chado that do not have a home in any other sub category of 
+ * API functions.
+ */
+
+/**
+ * @defgroup tripal_chado_api Chado
+ *
+ * @ingroup tripal_api
+ * The Tripal Chado API is a set of functions for interacting with data 
+ * inside of a Chado relational database. Entities (or pages) in Drupal
+ * that are provided by Tripal can supply data from any supported database 
+ * back-end, and Chado is the default. This API contains a variety of sub
+ * categories (or groups) where functions are organized.  Any extension module
+ * that desires to work with data in Chado will find these functions useful.
+ */
 
 /**
  * Publishes content in Chado as a new TripalEntity entity.
@@ -18,7 +37,7 @@
  *
  * @ingroup tripal_chado_api
  */
-function tripal_chado_publish_records($values, $job_id = NULL) {
+function chado_publish_records($values, $job_id = NULL) {
 
   // We want the job object in order to report progress.
   if (is_object($job_id)) {
@@ -251,8 +270,10 @@ function tripal_chado_publish_records($values, $job_id = NULL) {
  *    The name of a base table in Chado.
  * @return
  *    An array of tokens where the key is the machine_name of the token.
+ * 
+ * @ingroup tripal_chado_api
  */
-function tripal_get_chado_tokens($base_table) {
+function chado_get_tokens($base_table) {
 
   $tokens = array();
   $table_descrip = chado_get_schema($base_table);
@@ -284,7 +305,7 @@ function tripal_get_chado_tokens($base_table) {
         $sub_token_prefix = $base_table . '.' . $left_field;
         $sub_location_prefix = implode(' > ',array($base_table, $left_field));
 
-        $sub_tokens = tripal_get_chado_tokens($table);
+        $sub_tokens = chado_get_tokens($table);
         if (is_array($sub_tokens)) {
           $tokens = array_merge($tokens, $sub_tokens);
         }
@@ -307,10 +328,12 @@ function tripal_get_chado_tokens($base_table) {
  *
  * @return
  *   The string will all tokens replaced with values.
+ * 
+ *  @ingroup tripal_chado_api
  */
-function tripal_replace_chado_tokens($string, $record) {
+function chado_replace_tokens($string, $record) {
   // Get the list of tokens
-  $tokens = tripal_get_chado_tokens($record->tablename);
+  $tokens = chado_get_tokens($record->tablename);
 
   // Determine which tokens were used in the format string
   if (preg_match_all('/\[[^]]+\]/', $string, $used_tokens)) {

tripal_chado/api/tripal_chado.custom_tables.api.inc

@@ -17,9 +17,9 @@
  * using the Drupal Schema API array.
  *
  * @param $table_id
- *   The table_id of the table to edit
+ *   The table_id of the table to edit.
  * @param $table_name
- *   The name of the custom table
+ *   The name of the custom table.
  * @param $schema
  *   Use the Schema API array to define the custom table.
  * @param $skip_if_exists
@@ -33,32 +33,32 @@ function chado_edit_custom_table($table_id, $table_name, $schema, $skip_if_exist
 
   $transaction = db_transaction();
   try {
-    // Create a new record
+    // Create a new record.
     $record = new stdClass();
     $record->table_id = $table_id;
     $record->table_name = $table_name;
     $record->schema = serialize($schema);
 
-    // get the current custom table record
+    // Get the current custom table record.
     $sql = "SELECT * FROM {tripal_custom_tables} WHERE table_id = :table_id";
     $results = db_query($sql, array(':table_id' => $table_id));
     $custom_table = $results->fetchObject();
 
-    // if this is a materialized view then don't allow editing with this function
+    // If this is a materialized view then don't allow editing with this function.
     if ($custom_table->mview_id) {
-      tripal_report_error('tripal_chado', TRIPAL_ERROR, "Please use the tripal_edit_mview() function to edit this custom table as it is a materialized view.", array());
+      tripal_report_error('tripal_chado', TRIPAL_ERROR, "Please use the chado_edit_mview() function to edit this custom table as it is a materialized view.", array());
       drupal_set_message("This custom table is a materialized view. Please use the "  . l('Materialized View', 'admin/tripal/storage/chado/mviews') . " interface to edit it.", 'error');
       return FALSE;
     }
 
-    // if the user changed the table name, we want to drop the old one and force
+    // If the user changed the table name, we want to drop the old one and force
     // creation of the new one.
     if ($custom_table->table_name != $table_name) {
       chado_query("DROP TABLE %s", $custom_table->table_name);
       $skip_if_exists = 0; // we want to create the table
     }
 
-    // if skip creation is not set, then drop the table from chado if it exists
+    // If skip creation is not set, then drop the table from chado if it exists.
     if (!$skip_if_exists) {
       if (db_table_exists($custom_table->table_name)) {
         chado_query("DROP TABLE %s", $custom_table->table_name);
@@ -66,13 +66,13 @@ function chado_edit_custom_table($table_id, $table_name, $schema, $skip_if_exist
       }
     }
 
-    // update the custom table record and run the create custom table function
+    // Update the custom table record and run the create custom table function.
     drupal_write_record('tripal_custom_tables', $record, 'table_id');
     $success = chado_create_custom_table ($table_name, $schema, $skip_if_exists);
 
     // Re-add the custom table to the semantic web interface to pick up any
     // changes in fields.
-    tripal_add_chado_semweb_table($table_name);
+    chado_add_semweb_table($table_name);
   }
   catch (Exception $e) {
     $transaction->rollback();
@@ -96,17 +96,17 @@ function chado_edit_custom_table($table_id, $table_name, $schema, $skip_if_exist
  * added to the tripal_custom_tables and no table is created in Chado.
  *
  * If you are creating a materialized view do not use this function, but rather
- * use the tripal_add_mview(). A materialized view is also considered a custom table
- * and an entry for it will be added to both the tripal_mviews and
- * tripal_custom_tables tables, but only if the tripal_add_mview() function is
+ * use the chado_add_mview(). A materialized view is also considered a custom 
+ * table and an entry for it will be added to both the tripal_mviews and
+ * tripal_custom_tables tables, but only if the chado_add_mview() function is
  * used. The optional $mview_id parameters in this function is intended
- * for use by the tripal_add_mview() function when it calls this function
+ * for use by the chado_add_mview() function when it calls this function
  * to create the table.
  *
  * @param $table
  *   The name of the table to create.
  * @param $schema
- *   A Drupal-style Schema API definition of the table
+ *   A Drupal-style Schema API definition of the table.
  * @param $skip_if_exists
  *   Set as TRUE to skip dropping and re-creation of the table if it already
  *   exists.  This is useful if the table was already created through another
@@ -115,14 +115,14 @@ function chado_edit_custom_table($table_id, $table_name, $schema, $skip_if_exist
  * @param $mview_id
  *   Optional. If this custom table is also a materialized view then provide
  *   it's mview_id. This paramter is intended only when this function
- *   is called by the tripal_add_mview() function. When creating a custom
+ *   is called by the chado_add_mview() function. When creating a custom
  *   table you shouldn't need to use this parameter.
  * @param $redirect
  *   Optional (default: TRUE). By default this function redirects back to
  *   admin pages. However, when called by Drush we don't want to redirect. This
  *   parameter allows this to be used as a true API function.
  * @return
- *   TRUE on success, FALSE on failure
+ *   TRUE on success, FALSE on failure.
  *
  * @ingroup tripal_custom_tables_api
  */
@@ -133,32 +133,33 @@ function chado_create_custom_table($table, $schema, $skip_if_exists = TRUE,
   $created = 0;
   $recreated = 0;
 
-  $chado_schema = tripal_get_schema_name('chado');
+  $chado_schema = chado_get_schema_name('chado');
   $chado_dot = $chado_schema . '.';
 
   $transaction = db_transaction();
   try {
-    // see if the table entry already exists in the tripal_custom_tables table.
+    // See if the table entry already exists in the tripal_custom_tables table.
     $sql = "SELECT * FROM {tripal_custom_tables} WHERE table_name = :table_name";
     $results = db_query($sql, array(':table_name' => $table));
     $centry = $results->fetchObject();
 
-    // check to see if the table already exists in the chado schema
+    // Check to see if the table already exists in the chado schema.
     $exists = chado_table_exists($table);
 
-    // if the table does not exist then create it
+    // If the table does not exist then create it.
     if (!$exists) {
       $ret = db_create_table($chado_dot . $table, $schema);
       $created = 1;
     }
 
-    // if the table exists in Chado and in our custom table and
-    // skip creation is turned off then drop and re-create the table
+    // If the table exists in Chado and in our custom table and
+    // skip creation is turned off then drop and re-create the table.
     if ($exists and is_object($centry) and !$skip_if_exists) {
 
-      // drop the table we'll recreate it with the new schema
+      // Drop the table we'll recreate it with the new schema.
       chado_query('DROP TABLE {' . $table . '}');
-      // remove any 'referring_tables' from the array as the db_create_table doesn't use that
+      // Remove any 'referring_tables' from the array as the 
+      // db_create_table doesn't use that.
       $new_schema = $schema;
       if (array_key_exists('referring_tables', $new_schema)) {
         unset($new_schema['referring_tables']);
@@ -167,7 +168,7 @@ function chado_create_custom_table($table, $schema, $skip_if_exists = TRUE,
       $recreated = 1;
     }
 
-    // add an entry in the tripal_custom_table
+    // Add an entry in the tripal_custom_table.
     $record = new stdClass();
     $record->table_name = $table;
     $record->schema = serialize($schema);
@@ -175,17 +176,17 @@ function chado_create_custom_table($table, $schema, $skip_if_exists = TRUE,
       $record->mview_id = $mview_id;
     }
 
-    // if an entry already exists then remove it
+    // If an entry already exists then remove it.
     if ($centry) {
       $sql = "DELETE FROM {tripal_custom_tables} WHERE table_name = :table_name";
       db_query($sql, array(':table_name' => $table));
     }
     $success = drupal_write_record('tripal_custom_tables', $record);
 
-    // now add any foreign key constraints
+    // Now add any foreign key constraints.
     if (($created or !$skip_if_exists) and array_key_exists('foreign keys', $schema)) {
 
-      // iterate through the foreign keys and add each one
+      // Iterate through the foreign keys and add each one.
       $fkeys = $schema['foreign keys'];
       foreach ($fkeys as $fktable => $fkdetails) {
         $relations = $fkdetails['columns'];
@@ -201,8 +202,8 @@ function chado_create_custom_table($table, $schema, $skip_if_exists = TRUE,
       }
     }
 
-    // Add the custom table to the semantic web interface
-    tripal_add_chado_semweb_table($table);
+    // Add the custom table to the semantic web interface.
+    chado_add_semweb_table($table);
   }
   catch (Exception $e) {
     $transaction->rollback();
@@ -244,10 +245,10 @@ function chado_create_custom_table($table, $schema, $skip_if_exists = TRUE,
  * a user and needs validation.
  *
  * @param $schema_array
- *   the Drupal Schema API compatible array
+ *   the Drupal Schema API compatible array.
  *
  * @return
- *   An empty string for success or a message string for failure
+ *   An empty string for success or a message string for failure.
  *
  * @ingroup tripal_custom_tables_api
  */
@@ -263,7 +264,7 @@ function chado_validate_custom_table_schema($schema_array) {
   }
 
 
-  // check index length
+  // Check index length.
   if (array_key_exists('indexes', $schema_array)) {
     foreach ($schema_array['indexes'] as $index_name => $details) {
       if (strlen($schema_array['table'] . '_' . $index_name) > 60) {
@@ -275,7 +276,7 @@ function chado_validate_custom_table_schema($schema_array) {
     }
   }
 
-  // check unique key length
+  // Check unique key length.
   if (array_key_exists('unique keys', $schema_array)) {
     foreach ($schema_array['unique keys'] as $index_name => $details) {
       if (strlen($schema_array['table'] . '_' . $index_name) > 60) {
@@ -289,13 +290,13 @@ function chado_validate_custom_table_schema($schema_array) {
 
 }
 /**
- * Retrieve the custom table id given the name
+ * Retrieve the custom table id given the name.
  *
  * @param $table_name
- *   The name of the custom table
+ *   The name of the custom table.
  *
  * @return
- *   The unique identifier for the given table
+ *   The unique identifier for the given table.
  *
  * @ingroup tripal_custom_tables_api
  */
@@ -315,7 +316,7 @@ function chado_get_custom_table_id($table_name) {
 /**
  * Retrieves the list of custom tables in this site.
  *
- * @returns
+ * @return
  *   An associative array where the key and value pairs are the table names.
  *
  * @ingroup tripal_custom_tables_api
@@ -336,10 +337,10 @@ function chado_get_custom_table_names($include_mview = TRUE) {
   return $tables;
 }
 /**
- * Deletes the specified custom table
+ * Deletes the specified custom table.
  *
  * @param $table_id
- *   The unique ID of the custom table for the action to be performed on
+ *   The unique ID of the custom table for the action to be performed on.
  *
  * @ingroup tripal_custom_tables_api
  */
@@ -351,26 +352,26 @@ function chado_delete_custom_table($table_id) {
     return '';
   }
 
-  // get this table details
+  // Get this table details.
   $sql = "SELECT * FROM {tripal_custom_tables} WHERE table_id = :table_id";
   $results = db_query($sql, array(':table_id' => $table_id));
   $custom_table = $results->fetchObject();
 
-  // if this is a materialized view then don't allow deletion with this function
+  // If this is a materialized view then don't allow deletion with this function.
   if ($custom_table->mview_id) {
-    tripal_report_error('tripal_chado', TRIPAL_ERROR, "Please use the tripal_delete_mview() function to delete this custom table as it is a materialized view. Table not deleted.", array());
+    tripal_report_error('tripal_chado', TRIPAL_ERROR, "Please use the chado_delete_mview() function to delete this custom table as it is a materialized view. Table not deleted.", array());
     drupal_set_message("This custom table is a materialized view. Please use the "  . l('Materialized View', 'admin/tripal/storage/chado/mviews') . " interface to delete it.", 'error');
     return FALSE;
   }
 
-  // remove the entry from the tripal_custom tables table
+  // Remove the entry from the tripal_custom tables table.
   $sql = "DELETE FROM {tripal_custom_tables} WHERE table_id = $table_id";
   $success = db_query($sql);
   if ($success) {
     drupal_set_message(t("Custom Table '%name' removed", array('%name' => $custom_table->table_name)));
   }
 
-  // drop the table from chado if it exists
+  // Drop the table from chado if it exists.
   if (chado_table_exists($custom_table->table_name)) {
     $success = chado_query("DROP TABLE {" .  $custom_table->table_name . "}");
     if ($success) {

tripal_chado/api/tripal_chado.migrate.api.inc

@@ -1,4 +1,16 @@
 <?php 
+/**
+ * @file
+ * Provides an application programming interface (API) to migrate content.
+ */
+
+/**
+ * @defgroup tripal_chado_migrate_api Chado Entity
+ * @ingroup tripal_chado_api
+ * @{
+ * Provides an application programming interface (API) to migrate content.
+ * @}
+ */
 
 /**
  * Migrate Tripal content types
@@ -17,25 +29,25 @@
  *         'data_table' => $table
  *       )
  *     )
- * 
+ * @ingroup tripal_chado_migrate_api
  */
-function tripal_chado_migrate_tripal_content_type($type = array()) {
+function chado_migrate_tripal_content_type($type = array()) {
     
-  // Check if the term already exists
+  // Check if the term already exists.
   $term = tripal_load_term_entity($type);
-  // If term doesn't exist, create a new bundle for this term
+  // If term doesn't exist, create a new bundle for this term.
   if (!$term) {
     print("Creating bundle for term '" . $type['term_name'] . "'...\n");
     $success = tripal_create_bundle($type);
     $term = tripal_load_term_entity($type);
   }
-  // Create bundle name
+  // Create bundle name.
   $bundle_name = 'bio_data_' . $term->id;
     
-  // Publish records for the bundle
+  // Publish records for the bundle.
   $value = array(
     'sync_node' => 1,
     'bundle_name' => $bundle_name
   );
-  tripal_chado_publish_records($value);
-}
+  chado_publish_records($value);
+}

tripal_chado/api/tripal_chado.mviews.api.inc

@@ -1,16 +1,17 @@
 <?php
 /**
  * @file
- * Provides an application programming interface (API) to manage materialized views in Chado.
+ * Provides an application programming interface (API) to manage materialized 
+ * views in Chado.
  */
 
 /**
  * @defgroup tripal_mviews_api Chado Materalized Views
  * @ingroup tripal_chado_api
  * @{
- * Provides an application programming interface (API) to manage materialized views in Chado.
- * The Perl-based chado comes with an interface for managing materialzed views.  This
- * API provides an alternative Drupal-based method.
+ * Provides an application programming interface (API) to manage materialized 
+ * views in Chado The Perl-based chado comes with an interface for managing 
+ * materialzed views.  This API provides an alternative Drupal-based method.
  * @}
  */
 
@@ -24,15 +25,16 @@
  * @param $name
  *   The name of the materialized view.
  * @param $modulename
- *   The name of the module submitting the materialized view (e.g. 'tripal_library')
+ *   The name of the module submitting the materialized view 
+ *   (e.g. 'tripal_library').
  * @param $mv_schema
  *   If using the newer Schema API array to define the materialized view then
  *   this variable should contain the array or a string representation of the
  *   array.
  * @param $query
- *   The SQL query that loads the materialized view with data
+ *   The SQL query that loads the materialized view with data.
  * @param $comment
- *   A string containing a description of the materialized view
+ *   A string containing a description of the materialized view.
  * @param $redirect
  *   Optional (default: TRUE). By default this function redirects back to
  *   admin pages. However, when called by Drush we don't want to redirect. This
@@ -40,7 +42,7 @@
  *
  * @ingroup tripal_mviews_api
  */
-function tripal_add_mview($name, $modulename, $mv_schema, $query, $comment = NULL, $redirect = TRUE) {
+function chado_add_mview($name, $modulename, $mv_schema, $query, $comment = NULL, $redirect = TRUE) {
 
   if (!array_key_exists('table', $mv_schema)) {
      tripal_report_error('tripal_chado', TRIPAL_ERROR,
@@ -50,7 +52,7 @@ function tripal_add_mview($name, $modulename, $mv_schema, $query, $comment = NUL
 
   $mv_table = $mv_schema['table'];
 
-  // see if the mv_table name already exsists
+  // See if the mv_table name already exsists.
   $mview_id = db_query(
     'SELECT mview_id FROM {tripal_mviews} WHERE name = :name',
     array(':name' => $name))->fetchField();
@@ -58,7 +60,7 @@ function tripal_add_mview($name, $modulename, $mv_schema, $query, $comment = NUL
   if(!$mview_id) {
     $transaction = db_transaction();
     try {
-      // Create a new record
+      // Create a new record.
       $record = new stdClass();
       $record->name = $name;
       $record->modulename = $modulename;
@@ -66,21 +68,21 @@ function tripal_add_mview($name, $modulename, $mv_schema, $query, $comment = NUL
       $record->query = $query;
       $record->comment = $comment;
 
-      // convert the schema into a string format
+      // Convert the schema into a string format.
       $str_schema = var_export($mv_schema, TRUE);
       $str_schema = preg_replace('/=>\s+\n\s+array/', '=> array', $str_schema);
       $record->mv_schema = $str_schema;
 
-      // add the record to the tripal_mviews table and if successful
-      // create the new materialized view in the chado schema
+      // Add the record to the tripal_mviews table and if successful
+      // create the new materialized view in the chado schema.
       if (drupal_write_record('tripal_mviews', $record)) {
 
-        // drop the table from chado if it exists
+        // Drop the table from chado if it exists.
         if (chado_table_exists($mv_table)) {
           $sql = 'DROP TABLE {' . $mv_table . '}';
           chado_query($sql);
         }
-        // create the table
+        // Create the table.
         chado_create_custom_table($mv_table, $mv_schema, 0, $record->mview_id, $redirect);
       }
     }
@@ -102,37 +104,39 @@ function tripal_add_mview($name, $modulename, $mv_schema, $query, $comment = NUL
 }
 
 /**
- * Edits a materialized view to the chado database to help speed data access. This
- * function supports the older style where postgres column specifications
+ * Edits a materialized view to the chado database to help speed data access. 
+ * This function supports the older style where postgres column specifications
  * are provided using the $mv_table, $mv_specs and $indexed variables. It also
  * supports the newer preferred method where the materialized view is described
  * using the Drupal Schema API array.
  *
  * @param $mview_id
- *   The mview_id of the materialized view to edit
+ *   The mview_id of the materialized view to edit.
  * @param $name
  *   The name of the materialized view.
  * @param $modulename
- *   The name of the module submitting the materialized view (e.g. 'tripal_library')
+ *   The name of the module submitting the materialized view 
+ *   (e.g. 'tripal_library').
  * @param $mv_table
- *   The name of the table to add to chado. This is the table that can be queried.
+ *   The name of the table to add to chado. This is the table that can be 
+ *   queried.
  * @param $mv_specs
- *   The table definition
+ *   The table definition.
  * @param $indexed
- *   The columns that are to be indexed
+ *   The columns that are to be indexed.
  * @param $query
- *   The SQL query that loads the materialized view with data
+ *   The SQL query that loads the materialized view with data.
  * @param $special_index
- *   currently not used
+ *   currently not used.
  * @param $comment
- *   A string containing a description of the materialized view
+ *   A string containing a description of the materialized view.
  * @param $mv_schema
  *   If using the newer Schema API array to define the materialized view then
  *   this variable should contain the array.
  *
  * @ingroup tripal_mviews_api
  */
-function tripal_edit_mview($mview_id, $name, $modulename, $mv_table, $mv_specs,
+function chado_edit_mview($mview_id, $name, $modulename, $mv_table, $mv_specs,
   $indexed, $query, $special_index, $comment = NULL, $mv_schema = NULL) {
 
   $transaction = db_transaction();
@@ -202,17 +206,17 @@ function tripal_edit_mview($mview_id, $name, $modulename, $mv_table, $mv_specs,
 }
 
 /**
- * Retrieve the materialized view_id given the name
+ * Retrieve the materialized view_id given the name.
  *
  * @param $view_name
- *   The name of the materialized view
+ *   The name of the materialized view.
  *
  * @return
- *   The unique identifier for the given view
+ *   The unique identifier for the given view.
  *
  * @ingroup tripal_mviews_api
  */
-function tripal_get_mview_id($view_name) {
+function chado_get_mview_id($view_name) {
   if (db_table_exists('tripal_mviews')) {
     $sql = "SELECT * FROM {tripal_mviews} WHERE name = :name";
     $results = db_query($sql, array(':name' => $view_name));
@@ -231,7 +235,7 @@ function tripal_get_mview_id($view_name) {
  * @returns
  *   An associative array where the key and value pairs are the table names.
  *
- * @ingroup tripal_custom_tables_api
+ * @ingroup tripal_mviews_api
  */
 function chado_get_mview_table_names() {
 
@@ -248,42 +252,42 @@ function chado_get_mview_table_names() {
 }
 
 /**
- * Populates the specified Materialized View
+ * Populates the specified Materialized View.
  *
  * @param $mview_id
- *   The unique ID of the materialized view for the action to be performed on
+ *   The unique ID of the materialized view for the action to be performed on.
  *
  * @ingroup tripal_mviews_api
  */
-function tripal_refresh_mview($mview_id) {
+function chado_refresh_mview($mview_id) {
   global $user;
 
   if (!$mview_id) {
     return '';
   }
 
-  // get this mview details
+  // Get this mview details.
   $sql = "SELECT * FROM {tripal_mviews} WHERE mview_id = :mview_id";
   $results = db_query($sql, array(':mview_id' => $mview_id));
   $mview = $results->fetchObject();
 
-  // add a job to populate the mview
+  // Add a job to populate the mview.
   $args = array("$mview_id");
   tripal_add_job("Populate materialized view '$mview->name'", 'tripal_chado',
-     'tripal_populate_mview', $args, $user->uid);
+    'chado_populate_mview', $args, $user->uid);
 
 }
 
 /**
- * Retrieves the list of materialized view IDs and their names
+ * Retrieves the list of materialized view IDs and their names.
  *
  * @return
- *   An array of objects with the following properties:  mview_id, name
+ *   An array of objects with the following properties:  mview_id, name.
  *
  * @ingroup tripal_mviews_api
  *
  */
-function tripal_get_mviews() {
+function chado_get_mviews() {
 
   $results = db_select('tripal_mviews', 'tm')
     ->fields('tm', array('mview_id', 'name'))
@@ -297,36 +301,36 @@ function tripal_get_mviews() {
 }
 
 /**
- * Does the specified action for the specified Materialized View
+ * Does the specified action for the specified Materialized View.
  *
  * @param $op
- *   The action to be taken. One of update or delete
+ *   The action to be taken. One of update or delete.
  * @param $mview_id
- *   The unique ID of the materialized view for the action to be performed on
+ *   The unique ID of the materialized view for the action to be performed on.
  *
  * @ingroup tripal_mviews_api
  */
-function tripal_delete_mview($mview_id) {
+function chado_delete_mview($mview_id) {
   global $user;
 
   if (!$mview_id) {
     return '';
   }
 
-  // get this mview details
+  // Get this mview details.
   $sql = "SELECT * FROM {tripal_mviews} WHERE mview_id = :mview_id";
   $results = db_query($sql, array(':mview_id' => $mview_id));
   $mview = $results->fetchObject();
 
-  // if op is to delete then do so
-  // remove the mview from the tripal_mviews table
+  // If op is to delete then do so.
+  // Remove the mview from the tripal_mviews table.
   $sql = "DELETE FROM {tripal_mviews} WHERE mview_id = $mview_id";
   db_query($sql);
 
-  // does the table already exist?
+  // Does the table already exist?
   $mview_exists = chado_table_exists($mview->mv_table);
 
-  // drop the table from chado if it exists
+  // Drop the table from chado if it exists.
   if ($mview_exists) {
     $sql = "DROP TABLE {" . $mview->mv_table . "}";
     $success = chado_query($sql);
@@ -340,29 +344,29 @@ function tripal_delete_mview($mview_id) {
 }
 
 /**
- * Update a Materialized View
+ * Update a Materialized View.
  *
  * @param $mview_id
- *   The unique identifier for the materialized view to be updated
+ *   The unique identifier for the materialized view to be updated.
  *
  * @return
- *   True if successful, FALSE otherwise
+ *   True if successful, FALSE otherwise.
  *
  * @ingroup tripal_mviews_api
  */
-function tripal_populate_mview($mview_id) {
+function chado_populate_mview($mview_id) {
   $sql = "SELECT * FROM {tripal_mviews} WHERE mview_id = :mview_id ";
   $results = db_query($sql, array(':mview_id' => $mview_id));
   $mview = $results->fetchObject();
   if ($mview) {
-    // execute the query inside a transaction so that it doesn't destroy existing data
-    // that may leave parts of the site unfunctional
+    // Execute the query inside a transaction so that it doesn't destroy 
+    // existing data that may leave parts of the site unfunctional.
     $transaction = db_transaction();
     $previous_db = chado_set_active('chado');  // use chado database
     try {
       $success = chado_query("DELETE FROM {" . $mview->mv_table . "}");
       $success = chado_query("INSERT INTO {" . $mview->mv_table . "} ($mview->query)");
-      // if success get the number of results and update the table record
+      // If success get the number of results and update the table record.
       if ($success) {
         $sql = "SELECT count(*) as cnt FROM {" . $mview->mv_table . "}";
         $results = chado_query($sql);
@@ -373,7 +377,7 @@ function tripal_populate_mview($mview_id) {
         $record->status = "Populated with " . number_format($count->cnt) . " rows";
         drupal_write_record('tripal_mviews', $record, 'mview_id');
       }
-      // if not success then throw an error
+      // If not success then throw an error.
       else {
         throw new Exception("ERROR populating the materialized view ". $mview->mv_table . ". See Drupal's recent log entries for details.");
       }
@@ -382,7 +386,7 @@ function tripal_populate_mview($mview_id) {
     catch (Exception $e) {
       $transaction->rollback();
       chado_set_active($previous_db);
-      // print and save the error message
+      // Print and save the error message.
       $record = new stdClass();
       $record->mview_id = $mview_id;
       $record->status = "ERROR populating $mview->mv_table. See Drupal's recent log entries for details.\n";

tripal_chado/api/tripal_chado.property.api.inc

@@ -6,11 +6,11 @@
 
 /**
  * @defgroup tripal_chado_prop_api Chado Properties
- *
  * @ingroup tripal_api
+ * @{
  * The Chado Properties API provides a set of functions for interacting
  * with the any chado prop table.
- *
+ * @}
  */
 
 /**
@@ -39,8 +39,8 @@
  * @return
  *   An array in the same format as that generated by the function
  *   chado_generate_var().  If only one record is returned it
- *   is a single object.  If more than one record is returned then it is an array
- *   of objects
+ *   is a single object.  If more than one record is returned then it is an 
+ *   array of objects
  *
  * @ingroup tripal_chado_prop_api
  */
@@ -76,7 +76,7 @@ function chado_get_property($record, $property) {
     $type['cvterm_id'] = $type_id;
   }
 
-  // Make sure the CV term exists;
+  // Make sure the CV term exists.
   $options = array();
   $term = chado_select_record('cvterm', array('cvterm_id'), $type, $options);
   if (!$term or count($term) == 0) {
@@ -92,17 +92,17 @@ function chado_get_property($record, $property) {
         array('%property' => print_r($property, TRUE)));    return FALSE;
   }
 
-  // get the foreign key for this property table
+  // Get the foreign key for this property table.
   $table_desc = chado_get_schema($base_table . 'prop');
   $fkcol = key($table_desc['foreign keys'][$base_table]['columns']);
 
-  // construct the array of values to be selected
+  // Construct the array of values to be selected.
   $values = array(
     $fkcol => $base_id,
     'type_id' => $type,
   );
 
-  // if we have the unique property_id make sure to add that to the values
+  // If we have the unique property_id make sure to add that to the values.
   if ($prop_id) {
     $property_pkey = $table_desc['primary key'][0];
     $values[$property_pkey] = $prop_id;
@@ -127,7 +127,7 @@ function chado_get_property($record, $property) {
  *   should be assigned.  The following keys must be used:
  *     -table: The base table for which the property should be inserted.
  *         Thus to insert a property for a feature the base_table=feature and
- *         property is inserted into featureprop
+ *         property is inserted into featureprop.
  *     -id: The primary key value of the base table. The property will be
  *         associated with the record that matches this id.
  * @param $property
@@ -154,7 +154,7 @@ function chado_get_property($record, $property) {
  *        'force_rank' is set then an error will occur.
  *
  * @return
- *   Return TRUE if successful and FALSE otherwise
+ *   Return TRUE if successful and FALSE otherwise.
  *
  * @ingroup tripal_chado_prop_api
  */
@@ -191,9 +191,9 @@ function chado_insert_property($record, $property, $options = array()) {
     }
     else {
       if (!$force_rank) {
-        // iterate through the properties returned and check to see if the
+        // Iterate through the properties returned and check to see if the
         // property with this value already exists if not, get the largest rank
-        // and insert the same property but with this new value
+        // and insert the same property but with this new value.
         foreach ($props as $prop) {
           if ($prop->rank > $rank) {
             $rank = $prop->rank;
@@ -202,7 +202,7 @@ function chado_insert_property($record, $property, $options = array()) {
             return TRUE;
           }
         }
-        // now add 1 to the rank
+        // Now add 1 to the rank.
         $rank++;
       }
       else {
@@ -234,7 +234,7 @@ function chado_insert_property($record, $property, $options = array()) {
     $values['cvterm_id'] = $type_id;
   }
 
-  // Make sure the CV term exists;
+  // Make sure the CV term exists.
   $options = array();
   $term = chado_select_record('cvterm', array('cvterm_id'), $values, $options);
   if (!$term or count($term) == 0) {
@@ -251,7 +251,7 @@ function chado_insert_property($record, $property, $options = array()) {
   }
 
 
-    //Check that the cvalue property exists
+    // Check that the cvalue property exists.
     if ($cvalue_id){
         $term = chado_select_record('cvterm', array('cvterm_id'), array('cvterm_id' => $cvalue_id), $options);
        if (!$term or count($term) == 0) {
@@ -264,7 +264,7 @@ function chado_insert_property($record, $property, $options = array()) {
   }
 
 
-  // Get the foreign key for this property table
+  // Get the foreign key for this property table.
   $table_desc = chado_get_schema($base_table . 'prop');
   $fkcol = key($table_desc['foreign keys'][$base_table]['columns']);
 
@@ -303,7 +303,8 @@ function chado_insert_property($record, $property, $options = array()) {
  *     -value: The specific value for the property.
  *     -rank: The specific rank for the property.
  *     -cvalue_id: The cvterm_id of the value for the property.
- *      **note** cvalue_id is an anticipated column in the the next Chado release (1.4).  It is included here for early adopters.
+ *      **note** cvalue_id is an anticipated column in the the next Chado 
+ *      release (1.4).  It is included here for early adopters.
  *
  * @param $options
  *   An associative array containing the following keys:
@@ -312,7 +313,7 @@ function chado_insert_property($record, $property, $options = array()) {
  *
  *
  * @return
- *   Return TRUE on Update/Insert and FALSE otherwise
+ *   Return TRUE on Update/Insert and FALSE otherwise.
  *
  * @ingroup tripal_chado_prop_api
  */
@@ -332,7 +333,7 @@ function chado_update_property($record, $property, $options = array()) {
 
   $insert_if_missing = array_key_exists('insert_if_missing', $options) ? $options['insert_if_missing'] : FALSE;
 
-  // first see if the property is missing (we can't update a missing property
+  // First see if the property is missing (we can't update a missing property.
   $prop = chado_get_property($record, $property);
   if (count($prop) == 0) {
     if ($insert_if_missing) {
@@ -360,7 +361,7 @@ function chado_update_property($record, $property, $options = array()) {
     $type['cvterm_id'] = $type_id;
   }
 
-  // Make sure the CV term exists;
+  // Make sure the CV term exists.
   $options = array();
   $term = chado_select_record('cvterm', array('cvterm_id'), $type, $options);
   if (!$term or count($term) == 0) {
@@ -378,11 +379,11 @@ function chado_update_property($record, $property, $options = array()) {
   }
 
 
-  // Get the foreign key for this property table
+  // Get the foreign key for this property table.
   $table_desc = chado_get_schema($base_table . 'prop');
   $fkcol = key($table_desc['foreign keys'][$base_table]['columns']);
 
-  // construct the array that will match the exact record to update
+  // Construct the array that will match the exact record to update.
   $match = array(
     $fkcol => $base_id,
     'type_id' => $type,
@@ -404,7 +405,7 @@ function chado_update_property($record, $property, $options = array()) {
     $values['rank'] = $rank;
   }
 
-  // If a cvalue_id is supplied, check that it is a valid cvterm
+  // If a cvalue_id is supplied, check that it is a valid cvterm.
     if ($cvalue_id) {
         $term = chado_select_record('cvterm', array('cvterm_id'), array('cvterm_id' => $cvalue_id), $options);
         if (!$term or count($term) == 0) {
@@ -417,7 +418,7 @@ function chado_update_property($record, $property, $options = array()) {
   }
 
   // If we have the unique property_id then we can also update the type
-  // thus add it to the values to be updated
+  // thus add it to the values to be updated.
   if ($prop_id) {
     $values['type_id'] = $type;
   }
@@ -426,7 +427,7 @@ function chado_update_property($record, $property, $options = array()) {
 }
 
 /**
- * Deletes a property for a given base table record using the property name
+ * Deletes a property for a given base table record using the property name.
  *
  * @param $record
  *   An associative array used to identify the record to which the property
@@ -450,7 +451,7 @@ function chado_update_property($record, $property, $options = array()) {
  *     -rank: The specific rank for the property.
  *
  * @return
- *   Return TRUE on successful deletion and FALSE otherwise
+ *   Return TRUE on successful deletion and FALSE otherwise.
  *
  * @ingroup tripal_chado_prop_api
  */
@@ -468,7 +469,7 @@ function chado_delete_property($record, $property) {
   $rank        = array_key_exists('rank', $property) ? $property['rank'] : 0;
 
 
-  // Build the values array for checking if the CVterm exists
+  // Build the values array for checking if the CVterm exists.
   $type = array();
   if ($cv_id) {
     $type['cv_id'] = $cv_id;
@@ -485,7 +486,7 @@ function chado_delete_property($record, $property) {
     $type['cvterm_id'] = $type_id;
   }
 
-  // Make sure the CV term exists;
+  // Make sure the CV term exists.
   $options = array();
   $term = chado_select_record('cvterm', array('cvterm_id'), $type, $options);
   if (!$term or count($term) == 0) {
@@ -501,19 +502,20 @@ function chado_delete_property($record, $property) {
         array('%property' => print_r($property, TRUE)));    return FALSE;
   }
 
-  // get the foreign key for this property table
+  // Get the foreign key for this property table.
   $table_desc = chado_get_schema($base_table . 'prop');
   $fkcol = key($table_desc['foreign keys'][$base_table]['columns']);
 
-  // If we have the unique property_id, make sure to use it in the match to ensure
-  // we get the exact record. Doesn't rely on there only being one property of that type
+  // If we have the unique property_id, make sure to use it in the match to 
+  // ensure we get the exact record. Doesn't rely on there only being one 
+  // property of that type.
   if ($prop_id) {
     $property_pkey = $table_desc['primary key'][0];
     $match = array(
       $property_pkey => $prop_id
     );
   }
-  // construct the array that will match the exact record to update
+  // Construct the array that will match the exact record to update.
   else {
     $match = array(
       $fkcol => $record_id,
@@ -548,14 +550,15 @@ function chado_delete_property($record, $property) {
  *     -value: The specific value for the property.
  *     -rank: The specific rank for the property.
  *     -cvalue_id: The cvterm_id of the value for the property.
- *      **note** cvalue_id is an anticipated column in the the next Chado release (1.4).  It is included here for early adopters.
+ *      **note** cvalue_id is an anticipated column in the the next Chado 
+ *      release (1.4).  It is included here for early adopters.
  * 
  * @param $options
  *   An array of options supported by chado_generate_var(). These keys
  *   are used for generating the cvterm objects returned by this function.
  *
  * @return
- *   An array of chado variables with the given property
+ *   An array of chado variables with the given property.
  *
  * @ingroup tripal_chado_prop_api
  */
@@ -622,10 +625,11 @@ function chado_get_record_with_property($record, $property, $options = array())
     $values[$foreignkey_name] = $base_records;
   }
 
-  // Now select the ids of the base table that have the properties we want that match.
+  // Now select the ids of the base table that have the properties we want that 
+  // match.
   $select = chado_select_record($property_table, array($foreignkey_name), $values);
 
-  // For each of these ids, pull out the full base records
+  // For each of these ids, pull out the full base records.
   $records = array();
   foreach ($select as $s) {
     $id = $s->{$foreignkey_name};
@@ -643,8 +647,10 @@ function chado_get_record_with_property($record, $property, $options = array())
  * @param $prop_table
  *   The name of the property table.
  * @throws Exception
+ * 
  * @return
  *   An array of cvterm objects as created by chado_generate_var().
+ * 
  * @ingroup tripal_chado_prop_api
  */
 function chado_get_table_property_types($prop_table) {
@@ -660,4 +666,4 @@ function chado_get_table_property_types($prop_table) {
     $types[] = chado_generate_var('cvterm', array('cvterm_id' => $result->type_id));
   }
   return $types;
-}
+}

tripal_chado/api/tripal_chado.schema.api.inc

@@ -1,5 +1,12 @@
 <?php
 
+/**
+ * @file
+ * Provides an application programming interface (API) for describing Chado tables.
+ *
+ * @ingroup tripal_chado
+ */
+
 /**
  * @defgroup tripal_chado_schema_api Chado Schema
  * @ingroup tripal_chado_api
@@ -44,7 +51,7 @@ function chado_table_exists($table) {
   // Get the default database and chado schema.
   global $databases;
   $default_db = $databases['default']['default']['database'];
-  $chado_schema = tripal_get_schema_name('chado');
+  $chado_schema = chado_get_schema_name('chado');
 
   // If we've already lookup up this table then don't do it again, as
   // we don't need to keep querying the database for the same tables.
@@ -121,7 +128,7 @@ function chado_column_exists($table, $column) {
   $args = array(
     ':table_name' => $table,
     ':column_name' => $column,
-    ':chado' => tripal_get_schema_name('chado'),
+    ':chado' => chado_get_schema_name('chado'),
     ':default_db' => $default_db
   );
   $results = db_query($sql, $args);
@@ -168,7 +175,7 @@ function chado_sequence_exists($sequence) {
   ";
   $args = array(
     ':sequence_name' => $sequence,
-    ':sequence_schema' => tripal_get_schema_name('chado'),
+    ':sequence_schema' => chado_get_schema_name('chado'),
     ':sequence_catalog' => $default_db
   );
   $results = db_query($sql, $args);
@@ -291,7 +298,7 @@ function chado_is_local() {
       has_schema_privilege(nspname, 'USAGE') AND
       nspname = :chado
   ";
-  $results = db_query($sql, array(':chado' => tripal_get_schema_name('chado')));
+  $results = db_query($sql, array(':chado' => chado_get_schema_name('chado')));
   $name = $results->fetchObject();
   if ($name) {
     variable_set('chado_schema_exists', FALSE);
@@ -315,7 +322,7 @@ function chado_is_installed() {
   global $databases;
 
   // first check if chado is in the $databases variable of the settings.php file
-  if (array_key_exists(tripal_get_schema_name('chado'), $databases)) {
+  if (array_key_exists(chado_get_schema_name('chado'), $databases)) {
     return TRUE;
   }
 
@@ -358,7 +365,7 @@ function chado_get_version($exact = FALSE, $warn_if_unsupported = FALSE) {
   if (!$is_local) {
     // If it's not in the drupal database check to see if it's specified in
     // the $db_url in the settings.php
-    if (!array_key_exists(tripal_get_schema_name('chado'), $databases)) {
+    if (!array_key_exists(chado_get_schema_name('chado'), $databases)) {
       // if it's not in the drupal database or specified in the $db_url then
       // return uninstalled as the version
       return 'not installed';
@@ -371,7 +378,7 @@ function chado_get_version($exact = FALSE, $warn_if_unsupported = FALSE) {
   else {
     $chado_exists = TRUE;
     // @todo we need a chado aware db_table_exists.
-    $prop_exists = db_table_exists(tripal_get_schema_name('chado') . '.chadoprop');
+    $prop_exists = db_table_exists(chado_get_schema_name('chado') . '.chadoprop');
   }
 
   // if the table doesn't exist then we don't know what version but we know

tripal_chado/api/tripal_chado.semweb.api.inc

@@ -1,4 +1,19 @@
 <?php
+
+/**
+ * @file
+ * Provides an application programming interface (API) for semantic web support.
+ *
+ * @ingroup tripal_chado
+ */
+/**
+ * @defgroup tripal_chado_semweb_api Semantic Web
+ * @ingroup tripal_chado_api
+ * @{
+ * Provides an application programming interface (API) for semantic web support.
+ * @}
+ */
+
 /**
  * Adds a new Chado table to the semantic web support for Chado.
  *
@@ -7,7 +22,7 @@
  * the Chado schema, this function should be called to indicate that the
  * table should be included in the semantic web. No associations are made for
  * the columns. The associations should be added using the
- * tripal_associate_chado_semweb_term() function.
+ * chado_associate_semweb_term() function.
  *
  * If the table has already been added previously then this function does
  * nothing. It will not overwrite existing assocations.
@@ -17,10 +32,12 @@
  *
  * @param $chado_table
  *   The name of the Chado table.
+ * 
+ * @ingroup tripal_chado_semweb_api
  */
-function tripal_add_chado_semweb_table($chado_table) {
+function chado_add_semweb_table($chado_table) {
 
-  // Don't include the tripal temp tables
+  // Don't include the tripal temp tables.
   if (preg_match('/tripal_.+_temp/', $chado_table)) {
     return;
   }
@@ -30,7 +47,7 @@ function tripal_add_chado_semweb_table($chado_table) {
   $schema = chado_get_schema($chado_table);
   foreach ($schema['fields'] as $chado_column => $details) {
 
-    // If the record already exists don't overwrite it
+    // If the record already exists don't overwrite it.
     $record = db_select('chado_semweb', 'CS')
       ->fields('CS', array('chado_semweb_id'))
       ->condition('CS.chado_table', $chado_table)
@@ -46,6 +63,7 @@ function tripal_add_chado_semweb_table($chado_table) {
     }
   }
 }
+
 /**
  * Associates a controlled vocabulary term with a field in a Chado table.
  *
@@ -71,8 +89,10 @@ function tripal_add_chado_semweb_table($chado_table) {
  *
  * @return boolean
  *   Returns TRUE if the association was made successfully and FALSE otherwise.
+ * 
+ *  @ingroup tripal_chado_semweb_api
  */
-function tripal_associate_chado_semweb_term($chado_table, $chado_column, $term,
+function chado_associate_semweb_term($chado_table, $chado_column, $term,
     $update = FALSE) {
 
   // Check for required arguments.
@@ -174,8 +194,10 @@ function tripal_associate_chado_semweb_term($chado_table, $chado_column, $term,
  *   Returns a string-based representation of the term (e.g. SO:0000704). If
  *   the 'return_object' options is provided then a cvterm object is returned.
  *   returns NULL if no term is mapped to the table and column.
+ * 
+ *  @ingroup tripal_chado_semweb_api
  */
-function tripal_get_chado_semweb_term($chado_table, $chado_column, $options = array()) {
+function chado_get_semweb_term($chado_table, $chado_column, $options = array()) {
   $cvterm_id = db_select('chado_semweb', 'CS')
     ->fields('CS', array('cvterm_id'))
     ->condition('chado_column', $chado_column)
@@ -189,7 +211,7 @@ function tripal_get_chado_semweb_term($chado_table, $chado_column, $options = ar
       return $cvterm;
     }
 
-    return tripal_format_chado_semweb_term($cvterm);
+    return chado_format_semweb_term($cvterm);
   }
 }
 
@@ -200,8 +222,10 @@ function tripal_get_chado_semweb_term($chado_table, $chado_column, $options = ar
  *   A cvterm object.
  * @return
  *   The semantic web name for the term.
+ * 
+ *  @ingroup tripal_chado_semweb_api
  */
-function tripal_format_chado_semweb_term($cvterm) {
+function chado_format_semweb_term($cvterm) {
   if ($cvterm) {
     return $cvterm->dbxref_id->db_id->name . ':' . $cvterm->dbxref_id->accession;
   }
@@ -219,8 +243,10 @@ function tripal_format_chado_semweb_term($cvterm) {
  * @return
  *   The name of the Chado column that matches the given term or FALSE if the
  *   term is not mapped to the Chado table.
+ * 
+ *  @ingroup tripal_chado_semweb_api
  */
-function tripal_get_chado_semweb_column($chado_table, $term) {
+function chado_get_semweb_column($chado_table, $term) {
   $columns = db_select('chado_semweb', 'CS')
     ->fields('CS')
     ->condition('chado_table', $chado_table)

tripal_chado/api/tripal_chado.variables.api.inc

@@ -1,7 +1,18 @@
 <?php
+
 /**
  * @file
  * This API generates objects containing the full details of a record(s) in chado.
+ *
+ * @ingroup tripal_chado
+ */
+/**
+ * @defgroup tripal_chado_variables_api Semantic Web
+ * @ingroup tripal_chado_api
+ * 
+ * @{
+ * This API generates objects containing the full details of a record(s) in chado.
+ * @}
  */
 
 /**
@@ -130,7 +141,7 @@
  *   base table). If the option 'return_array' is provided the function
  *   always returns an array.
  *
- * @ingroup tripal_chado_query_api
+ * @ingroup tripal_chado_variables_api
  */
 function chado_generate_var($table, $values, $base_options = array()) {
   $all = new stdClass();
@@ -147,7 +158,7 @@ function chado_generate_var($table, $values, $base_options = array()) {
   if (array_key_exists('pager', $base_options)) {
     $pager = $base_options['pager'];
   }
-  // get description for the current table----------------------------------------------------------
+  // get description for the current table-------------------------------------
   $table_desc = chado_get_schema($table);
   if (!$table_desc or count($table_desc) == 0) {
     tripal_report_error('tripal_chado', TRIPAL_ERROR,
@@ -163,7 +174,7 @@ function chado_generate_var($table, $values, $base_options = array()) {
   $table_primary_key = $table_desc['primary key'][0];
   $table_columns = array_keys($table_desc['fields']);
 
-  // Expandable fields without value needed for criteria--------------------------------------------
+  // Expandable fields without value needed for criteria-----------------------
   // Add in the default expandable arrays
   // These are used for later expanding fields, tables, foreign keys and nodes
   $all->expandable_fields = array();
@@ -183,34 +194,36 @@ function chado_generate_var($table, $values, $base_options = array()) {
 
   // This allows modules to specify that some fields should be excluded by default
   // For example, tripal core provides a tripal_chado_exclude_field_from_feature_by_default()
-  // which says that we usually don't want to include the residues field by default since
-  // it can be very large and cause performance issues.
+  // which says that we usually don't want to include the residues field by 
+  // default since it can be very large and cause performance issues.
 
-  // If a field is excluded by default it can always be expanded at a later point by calling
-  // chado_expand_var($chado_var, 'field', <field name as shown in expandable_fields array>);
+  // If a field is excluded by default it can always be expanded at a later 
+  // point by calling chado_expand_var($chado_var, 'field', 
+  // <field name as shown in expandable_fields array>);
 
   // First get an array of all the fields to be removed for the current table
-  // module_invoke_all() is drupal's way of invoking all implementations of the specified
-  // hook and merging all of the results.
+  // module_invoke_all() is drupal's way of invoking all implementations of the 
+  // specified hook and merging all of the results.
 
   // $fields_to_remove should be an array with the keys matching field names
-  // and the values being strings to be executed using php_eval() to determine whether
-  // to exclude the field (evaluates to TRUE) or not (evaluates to FALSE)
+  // and the values being strings to be executed using php_eval() to determine 
+  // whether to exclude the field (evaluates to TRUE) or not (evaluates to FALSE)
   $fields_to_remove = module_invoke_all('exclude_field_from_' . $table . '_by_default');
 
   // Now, for each field to be removed
   foreach ($fields_to_remove as $field_name => $criteria) {
 
-    //replace <field_name> with the current field name
+    //Replace <field_name> with the current field name
     $field_name_safe = preg_replace("/\'\"\\\/", '\\1', $field_name);
     $criteria = preg_replace('/<field_name> /', $field_name_safe, $criteria);
-    // if field_value needed we can't deal with this field yet
+    // If field_value needed we can't deal with this field yet.
     if (preg_match('/<field_value> /', $criteria)) {
       break;
     }
 
-    //if criteria then remove from query
-    // @coder-ignore: only module designers can populate $criteria -not a security risk
+    // If criteria then remove from query
+    // @coder-ignore: only module designers can populate $criteria -not a 
+    // security risk.
     $success = php_eval('<?php return ' . $criteria . '; ?>');
     if ($success) {
       unset($table_columns[array_search($field_name, $table_columns)]);
@@ -222,40 +235,43 @@ function chado_generate_var($table, $values, $base_options = array()) {
   // Get fields to be removed by type................................
   // This gets all implementations of hook_exclude_type_by_default().
 
-  // This allows modules to specify that some types of fields should be excluded by default
-  // For example, tripal core provides a tripal_chado_exclude_type_by_default() which says
-  // that text fields are often very large and if they are longer than 250 characters then
+  // This allows modules to specify that some types of fields should be excluded 
+  // by default For example, tripal core provides a 
+  // tripal_chado_exclude_type_by_default() which says that text fields are 
+  // often very large and if they are longer than 250 characters then
   // we want to exclude them by default
 
-  // If a field is excluded by default it can always be expanded at a later point by calling
-  // chado_expand_var($chado_var, 'field', <field name as shown in expandable_fields array>);
+  // If a field is excluded by default it can always be expanded at a later 
+  // point by calling chado_expand_var($chado_var, 'field', 
+  //<field name as shown in expandable_fields array>);
 
-  // First get an array of all the types of fields to be removed for the current table
-  // module_invoke_all() is drupal's way of invoking all implementations of the specified
-  // hook and merging all of the results.
+  // First get an array of all the types of fields to be removed for the current
+  // table module_invoke_all() is drupal's way of invoking all implementations 
+  // of the specified hook and merging all of the results.
 
   // $types_to_remove should be an array with the keys matching field names
-  // and the values being strings to be executed using php_eval() to determine whether
-  // to exclude the field (evaluates to TRUE) or not (evaluates to FALSE)
+  // and the values being strings to be executed using php_eval() to determine 
+  // whether to exclude the field (evaluates to TRUE) or not (evaluates to FALSE)
   // (ie: array('text' => 'strlen("<field_value> ") > 100');
   $types_to_remove = module_invoke_all('exclude_type_by_default');
 
   // Get a list of all the types of fields
-  // the key is the type of field and the value is an array of fields of this type
+  // the key is the type of field and the value is an array of fields of this 
+  // type.
   $field_types = array();
   foreach ($table_desc['fields'] as $field_name => $field_array) {
     $field_types[$field_array['type']][] = $field_name;
   }
 
-  // We want to use the types to remove in conjunction with our table field descriptions
-  // to determine which fields might need to be removed
+  // We want to use the types to remove in conjunction with our table field 
+  // descriptions to determine which fields might need to be removed.
   foreach ($types_to_remove as $field_type => $criteria) {
 
-    // if there are fields of that type to remove
+    // If there are fields of that type to remove.
     if (isset($field_types[$field_type])) {
 
       // Do any processing needed on the php criteria
-      //replace <field_name>  with the current field name
+      //replace <field_name>  with the current field name.
       $field_name_safe = preg_replace('/\'|"|\\\/', '\\1', $field_name);
       $criteria = preg_replace('/<field_name> /', $field_name_safe, $criteria);
       foreach ($field_types[$field_type] as $field_name) {
@@ -265,19 +281,20 @@ function chado_generate_var($table, $values, $base_options = array()) {
           continue;
         }
 
-        // if criteria then remove from query
-        // (as long as <field_value> is not needed for the criteria to be evaluated)
-        // @coder-ignore: only module designers can populate $criteria -not a security risk
+        // If criteria then remove from query
+        // (as long as <field_value> is not needed for the criteria to be 
+        // evaluated) @coder-ignore: only module designers can populate 
+        //$criteria -not a security risk.
         $success = php_eval('<?php return ' . $criteria . '; ?>');
         if ($success) {
           unset($table_columns[array_search($field_name, $table_columns)]);
           $all->expandable_fields[] = $table . '.' . $field_name;
         }
-      } //end of foreach field of that type
+      } // End of foreach field of that type.
     }
-  } //end of foreach type to be removed
+  } // End of foreach type to be removed.
 
-  // get the values for the record in the current table---------------------------------------------
+  // Get the values for the record in the current table-------------------------
   $results = chado_select_record($table, $table_columns, $values, $base_options);
 
   if ($results) {
@@ -285,7 +302,7 @@ function chado_generate_var($table, $values, $base_options = array()) {
     // Iterate through each result.
     foreach ($results as $key => $object) {
 
-      // Add empty expandable_x arrays
+      // Add empty expandable_x arrays.
       $object->expandable_fields = $all->expandable_fields;
       $object->expandable_foreign_keys = $all->expandable_foreign_keys;
       $object->expandable_tables = $all->expandable_tables;
@@ -294,11 +311,12 @@ function chado_generate_var($table, $values, $base_options = array()) {
       $object->tablename = $table;
 
       // For Tripal v2 compatibility
-      // check if the current table maps to a node type-----------------------------------------------
-      // if this table is connected to a node there will be a chado_tablename table in drupal
+      // check if the current table maps to a node type-------------------------
+      // If this table is connected to a node there will be a chado_tablename 
+      // table in drupal.
       if (module_exists('tripal_core') and db_table_exists('chado_' . $table)) {
-        // that has a foreign key to this one ($table_desc['primary key'][0]
-        // and to the node table (nid)
+        // That has a foreign key to this one ($table_desc['primary key'][0]
+        // and to the node table (nid).
         $sql = "
           SELECT $table_primary_key, nid
           FROM {chado_$table}
@@ -319,13 +337,14 @@ function chado_generate_var($table, $values, $base_options = array()) {
         $object->entity_id = $entity_id;
       }
 
-      // remove any fields where criteria needs to be evalulated---------------------------------------
+      // Remove any fields where criteria needs to be evalulated----------------
       // The fields to be removed can be populated by implementing either
-      // hook_exclude_field_from_<table>_by_default() where <table> is the current table
-      // OR hook_exclude_type_by_default() where there are fields of the specified type in the current table
-      // It only reaches this point if the criteria specified for whether or not to
-      // exclude the field includes <field_value> which means it has to be evaluated after
-      // the query has been executed
+      // hook_exclude_field_from_<table>_by_default() where <table> is the 
+      // current table OR hook_exclude_type_by_default() where there are fields 
+      // of the specified type in the current table It only reaches this point 
+      // if the criteria specified for whether or not to exclude the field 
+      // includes <field_value> which means it has to be evaluated after
+      // the query has been executed.
       foreach ($fields_to_remove as $field_name => $criteria) {
 
         // If the field is an object then we don't support exclusion of it
@@ -334,7 +353,8 @@ function chado_generate_var($table, $values, $base_options = array()) {
           break;
         }
 
-        // replace <field_value> with the actual value of the field from the query
+        // Replace <field_value> with the actual value of the field from the 
+        // query.
         $field_name_safe = preg_replace('/\'|"|\\\/', '\\1', $object->{$field_name});
         $criteria = preg_replace('/<field_value>/', $field_name_safe, $criteria);
 
@@ -348,34 +368,35 @@ function chado_generate_var($table, $values, $base_options = array()) {
         }
       }
 
-      // recursively follow foreign key relationships nesting objects as we go------------------------
+      // Recursively follow foreign key relationships nesting objects as we go------------------------
       if (array_key_exists('foreign keys', $table_desc) and $table_desc['foreign keys']) {
         foreach ($table_desc['foreign keys'] as $foreign_key_array) {
           $foreign_table = $foreign_key_array['table'];
           foreach ($foreign_key_array['columns'] as $foreign_key => $primary_key) {
 
-            // Note: Foreign key is the field in the current table whereas primary_key is the field in
-            // the table referenced by the foreign key
-            //Dont do anything if the foreign key is empty
+            // Note: Foreign key is the field in the current table whereas 
+            // primary_key is the field in the table referenced by the foreign 
+            // key, don't do anything if the foreign key is empty
             if (empty($object->{$foreign_key})) {
               continue;
             }
 
             if (is_array($include_fk)) {
-              // don't recurse if the callee has supplied an $fk_include list and this
-              // FK table is not in the list.
+              // Don't recurse if the callee has supplied an $fk_include list 
+              // and this FK table is not in the list.
               if (is_array($include_fk) and !array_key_exists($foreign_key, $include_fk)) {
                 $object->expandable_foreign_keys[] = $table . '.' . $foreign_key . ' => ' . $foreign_table;
                 continue;
               }
             }
-            // if we have the option but it is not an array then we don't recurse any furutehr
+            // If we have the option but it is not an array then we don't 
+            // recurse any further.
             if ($include_fk === TRUE) {
               $object->expandable_foreign_keys[] = $table . '.' . $foreign_key . ' => ' . $foreign_table;
               continue;
             }
 
-            // get the record from the foreign table
+            // Get the record from the foreign table.
             $foreign_values = array($primary_key => $object->{$foreign_key});
             $options = array();
             if (is_array($include_fk)) {
@@ -384,9 +405,9 @@ function chado_generate_var($table, $values, $base_options = array()) {
 
             $foreign_object = chado_generate_var($foreign_table, $foreign_values, $options);
 
-            // add the foreign record to the current object in a nested manner
+            // Add the foreign record to the current object in a nested manner.
             $object->{$foreign_key} = $foreign_object;
-            // Flatten expandable_x arrays so only in the bottom object
+            // Flatten expandable_x arrays so only in the bottom object.
             if (property_exists($object->{$foreign_key}, 'expandable_fields') and
                 is_array($object->{$foreign_key}->expandable_fields)) {
               $object->expandable_fields = array_merge(
@@ -426,26 +447,26 @@ function chado_generate_var($table, $values, $base_options = array()) {
     }
   }
 
-  // convert the results into an array
+  // Convert the results into an array.
   $results_arr = array();
   foreach ($results as $record) {
     $results_arr[] = $record;
   }
-  // check only one result returned
+  // Check only one result returned.
   if (!$return_array) {
     if (sizeof($results_arr) == 1) {
-      // add results to object
+      // Add results to object.
       return $results_arr[0];
     }
     elseif (!empty($results_arr)) {
       return $results_arr;
     }
     else {
-      // no results returned
+      // No results returned.
     }
   }
-  // the caller has requested results are always returned as
-  // an array
+  // The caller has requested results are always returned as
+  // an array.
   else {
     if (!$results_arr) {
       return array();
@@ -550,16 +571,16 @@ function chado_generate_var($table, $values, $base_options = array()) {
  *   - return_array:
  *     Additionally,  The option 'return_array' can be provided to force
  *     the function to expand tables as an array. Default behavior is to expand
- *     a table as single record if only one record exists or to expand as an array if
- *     multiple records exist.
+ *     a table as single record if only one record exists or to expand as an 
+ *     array if multiple records exist.
  *   - include_fk:
  *     an array of FK relationships to follow. By default, the
  *     chado_expand_var function will follow all FK relationships but this
- *     may generate more queries then is desired slowing down this function call when
- *     there are lots of FK relationships to follow.  Provide an array specifying the
- *     fields to include.  For example, if expanding a property table (e.g. featureprop)
- *     and you want the CV and accession but do not want the DB the following
- *     array would work:
+ *     may generate more queries then is desired slowing down this function call
+ *     when there are lots of FK relationships to follow.  Provide an array 
+ *     specifying the fields to include.  For example, if expanding a property 
+ *     table (e.g. featureprop) and you want the CV and accession but do not 
+ *     want the DB the following array would work:
  *        $table_options =  array(
  *          'include_fk' => array(
  *            'type_id' => array(
@@ -583,21 +604,22 @@ function chado_generate_var($table, $values, $base_options = array()) {
  *     This options is only used where type=table and allows you to
  *     expand only a subset of results based on the given criteria. Criteria
  *     should provided as an array of [field name] => [value] similar to the
- *     values array provided to chado_generate_var(). For example, when expanding
- *     the featureprop table for a feature, you will already get only properties
- *     for that feature, this option allows you to further get only properties
- *     of a given type by passing in array('type_id' => array('name' => [name of type]))
+ *     values array provided to chado_generate_var(). For example, when 
+ *     expanding the featureprop table for a feature, you will already get only 
+ *     properties for that feature, this option allows you to further get only 
+ *     properties of a given type by passing in 
+ *     array('type_id' => array('name' => [name of type]))
  * @return
- *   A chado object supplemented with the field/table/node requested to be expanded.
- *   If the type is a table and it has already been expanded no changes is made to the
- *   returned object
+ *   A chado object supplemented with the field/table/node requested to be 
+ *   expanded. If the type is a table and it has already been expanded no 
+ *   changes is made to the returned object
  *
  *
- * @ingroup tripal_chado_query_api
+ * @ingroup tripal_chado_variables_api
  */
 function chado_expand_var($object, $type, $to_expand, $table_options = array()) {
 
-  // make sure we have a value
+  // Make sure we have a value.
   if (!$object) {
     tripal_report_error('tripal_chado',
       TRIPAL_ERROR,
@@ -606,7 +628,7 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
     return $object;
   }
 
-  // check to see if we are expanding an array of objects
+  // Check to see if we are expanding an array of objects.
   if (is_array($object)) {
     foreach ($object as $index => $o) {
       $object[$index] = chado_expand_var($o, $type, $to_expand);
@@ -614,20 +636,20 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
     return $object;
   }
 
-  // get the base table name
+  // Get the base table name.
   $base_table = $object->tablename;
 
   switch ($type) {
-    case "field": //--------------------------------------------------------------------------------
+    case "field": //------------------------------------------------------------
       if (preg_match('/(\w+)\.(\w+)/', $to_expand, $matches)) {
         $tablename = $matches[1];
         $fieldname = $matches[2];
         $table_desc = chado_get_schema($tablename);
 
-        // BASE CASE: the field is from the current table
+        // BASE CASE: the field is from the current table.
         if ($base_table == $tablename) {
           // Use the table description to fully describe the current object
-          // in a $values array to be used to select the field from chado
+          // in a $values array to be used to select the field from chado.
           $values = array();
           foreach ($table_desc['primary key'] as $key) {
             if(property_exists($object, $key)) {
@@ -635,21 +657,21 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
             }
           }
 
-          // Retrieve the field from Chado
+          // Retrieve the field from Chado.
           $results = chado_select_record($tablename, array($fieldname), $values);
 
-          // Check that the field was retrieved correctly
+          // Check that the field was retrieved correctly.
           if (isset($results[0])) {
             $object->{$fieldname} = $results[0]->{$fieldname};
             $object->expanded = $to_expand;
           }
-          // If it wasn't retrieved correctly, we need to warn the administrator
+          // If it wasn't retrieved correctly, we need to warn the administrator.
 
         }
-        // RECURSIVE CASE: the field is in a nested object
+        // RECURSIVE CASE: the field is in a nested object.
         else {
           // We want to look at each field and if it's an object then we want to
-          // attempt to expand the field in it via recursion
+          // attempt to expand the field in it via recursion.
           foreach ((array) $object as $field_name => $field_value) {
             if (is_object($field_value)) {
               $object->{$field_name} = chado_expand_var(
@@ -658,11 +680,11 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
               $to_expand
               );
             }
-          } //end of for each field in the current object
+          } // End of for each field in the current object.
         }
       }
       // Otherwise we weren't able to extract the parts of the field to expand
-      // Thus we will warn the administrator
+      // Thus we will warn the administrator.
       else {
         tripal_report_error('tripal_chado', TRIPAL_ERROR,
           'chado_expand_var: Field (%field) not in the right format. " .
@@ -670,21 +692,22 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
       }
       break;
 
-    case "foreign_key": //--------------------------------------------------------------------------
+    case "foreign_key": //-----------------------------------------------------
       if (preg_match('/(\w+)\.(\w+) => (\w+)/', $to_expand, $matches)) {
         $table_name = $matches[1];
         $field_name = $matches[2];
         $foreign_table = $matches[3];
         $table_desc = chado_get_schema($table_name);
 
-        // BASE CASE: The foreign key is from the current table
+        // BASE CASE: The foreign key is from the current table.
         if ($base_table == $table_name) {
 
           // Get the value of the foreign key from the object
           $field_value = $object->{$field_name};
 
-          // Get the name of the field in the foreign table using the table description
-          // For example, with the feature.type_id => cvterm.cvterm_id we need cvterm_id
+          // Get the name of the field in the foreign table using the table 
+          // description For example, with the 
+          // feature.type_id => cvterm.cvterm_id we need cvterm_id
           $foreign_field_name = FALSE;
           foreach ($table_desc['foreign keys'][$foreign_table]['columns'] as $left => $right) {
             if ($right == $field_name) {
@@ -692,23 +715,25 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
             }
           }
 
-          // Check that we were able to determine the field name in the foreign table
+          // Check that we were able to determine the field name in the foreign
+          // table.
           if ($foreign_field_name) {
 
             // Generate a chado variable of the foreign key
             // For example, if the foreign key to expand is feature.type_id
-            // then we want to generate a chado cvterm variable that matches the feature.type_id
+            // then we want to generate a chado cvterm variable that matches the 
+            // feature.type_id.
             $foreign_var = chado_generate_var(
               $foreign_table, // thus in the example above, generate a cvterm var
               array($foreign_field_name => $field_value), // where the cvterm.cvterm_id = feature.type_id value
               $table_options //pass in the same options given to this function
             );
 
-            // Check that the foreign object was returned
+            // Check that the foreign object was returned.
             if ($foreign_var) {
 
-              // It was so now we can add this chado variable to our current object
-              // in place of the key value
+              // It was so now we can add this chado variable to our current 
+              // object in place of the key value.
               $object->{$field_name} = $foreign_var;
               $object->expanded = $to_expand;
 
@@ -721,7 +746,7 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
                 array('%fk' => $to_expand));
             }
           }
-          // Else we were unable to determine the field name in the foreign table
+          // Else we were unable to determine the field name in the foreign table.
           else {
             tripal_report_error('tripal_chado', TRIPAL_ERROR,
               'chado_expand_var: unable to determine the field name in the table the foreign
@@ -730,7 +755,7 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
           }
 
         }
-        // RECURSIVE CASE: Check any nested objects
+        // RECURSIVE CASE: Check any nested objects.
         else {
 
           foreach ((array) $object as $field_name => $field_value) {
@@ -741,12 +766,12 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
               $to_expand
               );
             }
-          } //end of for each field in the current object
+          } //End of for each field in the current object.
 
         }
       }
-      // Otherwise we weren't able to extract the parts of the foreign key to expand
-      // Thus we will warn the administrator
+      // Otherwise we weren't able to extract the parts of the foreign key to 
+      // expand thus we will warn the administrator.
       else {
         tripal_report_error('tripal_chado', TRIPAL_ERROR,
           'chado_expand_var: foreign_key (%fk) not in the right format. " .
@@ -754,7 +779,7 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
       }
       break;
 
-    case "table": //--------------------------------------------------------------------------------
+    case "table": //------------------------------------------------------------
       $foreign_table = $to_expand;
 
       // BASE CASE: don't expand the table it already is expanded
@@ -763,15 +788,16 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
       }
       $foreign_table_desc = chado_get_schema($foreign_table);
 
-      // TODO: if we don't get a foreign_table (which could happen of a custom table
-      // is not correctly defined or the table name is mispelled then we should return
-      // gracefully.
+      // TODO: if we don't get a foreign_table (which could happen of a custom 
+      // table is not correctly defined or the table name is mispelled then we 
+      // should return gracefully.
 
       // BASE CASE: If it's connected to the base table via a FK constraint
-      // then we have all the information needed to expand it now
+      // then we have all the information needed to expand it now.
       if (array_key_exists($base_table, $foreign_table_desc['foreign keys'])) {
         foreach ($foreign_table_desc['foreign keys'][$base_table]['columns'] as $left => $right) {
-          // if the FK value in the base table is not there then we can't expand it, so just skip it.
+          // if the FK value in the base table is not there then we can't expand
+          // it, so just skip it.
           if (!$object->{$right}) {
             continue;
           }
@@ -800,15 +826,17 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
             $filter_criteria = array($left => $object->{$right});
           }
 
-          // generate a new object for this table using the FK values in the base table.
+          // Generate a new object for this table using the FK values in the 
+          // base table.
           $new_options = $table_options;
           $foreign_object = chado_generate_var($foreign_table, $filter_criteria, $new_options);
 
-          // if the generation of the object was successful, update the base object to include it.
+          // If the generation of the object was successful, update the base 
+          // object to include it.
           if ($foreign_object) {
-            // in the case where the foreign key relationship exists more
-            // than once with the same table we want to alter the array structure to
-            // include the field name.
+            // In the case where the foreign key relationship exists more
+            // than once with the same table we want to alter the array 
+            // structure to include the field name.
             if (count($foreign_table_desc['foreign keys'][$base_table]['columns']) > 1) {
               if (!property_exists($object, $foreign_table)) {
                 $object->{$foreign_table} = new stdClass();
@@ -825,11 +853,11 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
               $object->expanded = $to_expand;
             }
           }
-          // if the object returned is NULL then handle that
+          // If the object returned is NULL then handle that.
           else {
-            // in the case where the foreign key relationship exists more
-            // than once with the same table we want to alter the array structure to
-            // include the field name.
+            // In the case where the foreign key relationship exists more
+            // than once with the same table we want to alter the array 
+            // structure to include the field name.
             if (count($foreign_table_desc['foreign keys'][$base_table]['columns']) > 1) {
               if (!property_exists($object, $foreign_table)) {
                 $object->{$foreign_table} = new stdClass();
@@ -842,30 +870,32 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
           }
         }
       }
-      // RECURSIVE CASE: if the table is not connected directly to the current base table
-      // through a foreign key relationship, then maybe it has a relationship to
-      // one of the nested objects.
+      // RECURSIVE CASE: if the table is not connected directly to the current 
+      // base table through a foreign key relationship, then maybe it has a 
+      // relationship to one of the nested objects.
       else {
 
-        // We need to recurse -the table has a relationship to one of the nested objects
-        // We assume it's a nested object if the value of the field is an object
+        // We need to recurse -the table has a relationship to one of the nested
+        // objects. We assume it's a nested object if the value of the field is 
+        // an object.
         $did_expansion = 0;
         foreach ((array) $object as $field_name => $field_value) {
 
-          // CASE #1: This field is an already expanded foreign key and the table to be
-          // expanded is in the table referenced by the foreign key
+          // CASE #1: This field is an already expanded foreign key and the 
+          // table to be expanded is in the table referenced by the foreign key.
 
           // First of all it can only be expanded if it's an object
-          // And if it's a foreign key it should have a tablename property
+          // And if it's a foreign key it should have a tablename property.
           if (is_object($field_value) AND property_exists($field_value, 'tablename')) {
             $object->{$field_name} = chado_expand_var($field_value, 'table', $foreign_table);
           }
 
-          // CASE #2: This field is an already expanded object (ie: the field is actually
-          // the expanded table name) and the table to be expanded si related to it
+          // CASE #2: This field is an already expanded object (ie: the field is
+          // actually the expanded table name) and the table to be expanded is 
+          // related to it.
 
-          // check to see if the $field_name is a valid chado table, we don't need
-          // to call chado_expand_var on fields that aren't tables
+          // Check to see if the $field_name is a valid chado table, we don't 
+          // need to call chado_expand_var on fields that aren't tables.
           $check = chado_get_schema($field_name);
           if ($check) {
             $did_expansion = 1;
@@ -873,8 +903,8 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
           }
         }
 
-        // if we did not expand this table we should return a message that the foreign table
-        // could not be expanded
+        // If we did not expand this table we should return a message that the 
+        // foreign tabl could not be expanded.
         if (!$did_expansion) {
           tripal_report_error('tripal_chado', TRIPAL_ERROR, 'chado_expand_var: Could not expand %table. ' .
             'The table is either not related to the base object through a foreign key relationships or ' .
@@ -886,19 +916,21 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
       }
       break;
 
-    case "node": //---------------------------------------------------------------------------------
+    case "node": //-------------------------------------------------------------
 
-      // BASE CASE: if the node to be expanded is for our base table, then just expand it
+      // BASE CASE: if the node to be expanded is for our base table, then just 
+      // expand it.
       if ($object->tablename == $to_expand) {
 
-        // Load the node based on the current objects nid (node primary key)
+        // Load the node based on the current objects nid (node primary key).
         $node = NULL;
         if (property_exists($object, 'nid')) {
           $node = node_load($object->nid);
         }
-        // Try to get the nid based on the tablename
+        // Try to get the nid based on the tablename.
         else {
-          // Invoke all hook_node_info to avoid hard-coding the chado_$table assumption
+          // Invoke all hook_node_info to avoid hard-coding the chado_$table 
+          // assumption..
           foreach (module_invoke_all('node_info') as $node_info) {
             if (array_key_exists('chado_node_api', $node_info)) {
               if ($node_info['chado_node_api']['base_table'] == $object->tablename) {
@@ -920,7 +952,7 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
         // If we have successfully loaded the node...
         if ($node) {
 
-          // Move expandable arrays from the object into the node
+          // Move expandable arrays from the object into the node.
           $object->expanded = $to_expand;
           $node->expandable_fields = $object->expandable_fields;
           unset($object->expandable_fields);
@@ -930,13 +962,14 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
           unset($object->expandable_nodes);
 
           // The node becomes the base object with the obejct added to it.
-          // For example, we may start with a feature object with a name, uniquename , type, etc.
-          // After expanding we will return the node and at $node->feature you will find the original object
+          // For example, we may start with a feature object with a name, 
+          // uniquename , type, etc. After expanding we will return the node and
+          // at $node->feature you will find the original object.
           $node->{$base_table} = $object;
           $object = $node;
 
         }
-        // Else we were unable to load the node
+        // Else we were unable to load the node.
         else {
 
           // Warn the administrator
@@ -947,14 +980,14 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
           else {
             tripal_report_error('tripal_chado', TRIPAL_NOTICE, 'chado_expand_var: There is no node for the current object: <pre>%object</pre>', array('%object' => print_r($object,TRUE)));
           }
-        } //end of if node
+        } //End of if node.
       }
-      // RECURSIVE CASE: check to see if the node to be expanded associates with a
-      // chado table within one of the nested objects.
+      // RECURSIVE CASE: check to see if the node to be expanded associates with 
+      // a chado table within one of the nested objects.
       else {
 
         // We need to recurse -the node to expand is one of the nested objects
-        // We assume it's a nested object if the field value is an object
+        // We assume it's a nested object if the field value is an object.
         foreach ((array) $object as $field_name => $field_value) {
           if (is_object($field_value)) {
             $object->{$field_name} = chado_expand_var(
@@ -963,11 +996,11 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
             $to_expand
             );
           }
-        } //end of for each field in the current object
+        } // End of for each field in the current object.
       }
       break;
 
-    // The $type to be expanded is not yet supported
+    // The $type to be expanded is not yet supported.
     default:
       tripal_report_error('tripal_chado', TRIPAL_ERROR, 'chado_expand_var: Unrecognized type (%type). Should be one of "field", "table", "node".',
         array('%type' => $type));
@@ -975,22 +1008,22 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
   }
 
   // Move expandable arrays downwards -------------------------------
-  // If the type was either table or foreign key then a new chado variable was generated
-  // this variable will have it's own expandable array's which need to be moved down
-  // and merged with the base objects expandable arrays
+  // If the type was either table or foreign key then a new chado variable was 
+  // generated this variable will have it's own expandable array's which need to
+  // be moved down and merged with the base objects expandable arrays.
 
   // Thus, check all nested objects for expandable arrays
-  // and if they have them, move them downwards
+  // and if they have them, move them downwards.
   foreach ( (array)$object as $field_name => $field_value) {
     if (is_object($field_value)) {
 
-      // The current nested object has expandable arrays
+      // The current nested object has expandable arrays.
       if (isset($field_value->expandable_fields)) {
 
-        // Move expandable fields downwards
+        // Move expandable fields downwards.
         if (isset($field_value->expandable_fields) and is_array($field_value->expandable_fields)) {
 
-          // If the current object has it's own expandable fields then merge them
+          // If the current object has it's own expandable fields then merge them.
           if (isset($object->expandable_fields)) {
             $object->expandable_fields = array_merge(
               $object->expandable_fields,
@@ -999,7 +1032,7 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
             unset($object->{$field_name}->expandable_fields);
 
           }
-          // Otherwise, just move the expandable fields downwards
+          // Otherwise, just move the expandable fields downwards.
           else {
             $object->expandable_fields = $object->{$field_name}->expandable_fields;
             unset($object->{$field_name}->expandable_fields);
@@ -1007,10 +1040,11 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
 
         }
 
-        // Move expandable foreign keys downwards
+        // Move expandable foreign keys downwards.
         if (isset($field_value->expandable_foreign_keys) and is_array($field_value->expandable_foreign_keys)) {
 
-          // If the current object has it's own expandable foreign keys then merge them
+          // If the current object has it's own expandable foreign keys then 
+          // merge them.
           if (isset($object->expandable_foreign_keys)) {
             $object->expandable_foreign_keys = array_merge(
               $object->expandable_foreign_keys,
@@ -1019,17 +1053,17 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
             unset($object->{$field_name}->expandable_foreign_keys);
 
           }
-          // Otherwise, just move the expandable foreign keys downwards
+          // Otherwise, just move the expandable foreign keys downwards.
           else {
             $object->expandable_foreign_keys = $object->{$field_name}->expandable_foreign_keys;
             unset($object->{$field_name}->expandable_foreign_keys);
           }
         }
 
-        // Move expandable tables downwards
+        // Move expandable tables downwards.
         if (isset($field_value->expandable_tables) and is_array($field_value->expandable_tables)) {
 
-          // If the current object has it's own expandable tables then merge them
+          // If the current object has it's own expandable tables then merge them.
           if (isset($object->expandable_tables)) {
             $object->expandable_tables = array_merge(
               $object->expandable_tables,
@@ -1038,17 +1072,17 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
             unset($object->{$field_name}->expandable_tables);
 
           }
-          // Otherwise, just move the expandable tables downwards
+          // Otherwise, just move the expandable tables downwards.
           else {
             $object->expandable_tables = $object->{$field_name}->expandable_tables;
             unset($object->{$field_name}->expandable_tables);
           }
         }
 
-        // Move expandable nodes downwards
+        // Move expandable nodes downwards.
         if (isset($field_value->expandable_nodes) and is_array($field_value->expandable_nodes)) {
 
-          // If the current object has it's own expandable tables then merge them
+          // If the current object has it's own expandable tables then merge them.
           if (isset($object->expandable_nodes)) {
             $object->expandable_nodes = array_merge(
               $object->expandable_nodes,
@@ -1057,7 +1091,7 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
             unset($object->{$field_name}->expandable_nodes);
 
           }
-          // Otherwise, just move the expandable tables downwards
+          // Otherwise, just move the expandable tables downwards.
           else {
             $object->expandable_nodes = $object->{$field_name}->expandable_nodes;
             unset($object->{$field_name}->expandable_nodes);
@@ -1069,20 +1103,20 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
 
   // Move extended array downwards ----------------------------------
   // This tells us what we have expanded (ie: that we succeeded)
-  // and is needed to remove the entry from the expandable array
+  // and is needed to remove the entry from the expandable array.
 
-  // If there is no expanded field in the current object then check any of the nested objects
-  // and move it down
+  // If there is no expanded field in the current object then check any of the 
+  // nested objects and move it down.
   if (!property_exists($object, 'expanded')) {
 
-    // It's a nested object if the value is an object
+    // It's a nested object if the value is an object.
     foreach ( (array)$object as $field_name => $field_value) {
       if (is_object($field_value)) {
 
-        // Check if the current nested object has an expanded array
+        // Check if the current nested object has an expanded array.
         if (isset($field_value->expanded)) {
 
-          // If so, then move it downwards
+          // If so, then move it downwards.
           $object->expanded = $field_value->expanded;
           unset($field_value->expanded);
         }
@@ -1091,10 +1125,11 @@ function chado_expand_var($object, $type, $to_expand, $table_options = array())
   }
 
   // Check again if there is an expanded field in the current object
-  // We check again because it might have been moved downwards above
+  // We check again because it might have been moved downwards above.
   if (property_exists($object, 'expanded')) {
 
-    // If so, then remove the expanded identifier from the correct expandable array
+    // If so, then remove the expanded identifier from the correct expandable 
+    // array..
     $expandable_name = 'expandable_' . $type . 's';
     if (property_exists($object, $expandable_name) and $object->{$expandable_name}) {
       $key_to_remove = array_search($object->expanded, $object->{$expandable_name});

tripal_chado/includes/TripalFields/ChadoField.inc

@@ -78,7 +78,7 @@ class ChadoField extends TripalField {
     if ($chado_table == $base_table) {
       // Get the base table column that is associated with the term
       // passed as $condition['column'].
-      $base_field = tripal_get_chado_semweb_column($chado_table, $condition['column']);
+      $base_field = chado_get_semweb_column($chado_table, $condition['column']);
       $query->condition('base.' . $base_field , $condition['value'], $operator);
     }
     else {
@@ -106,7 +106,7 @@ class ChadoField extends TripalField {
     if ($chado_table == $base_table) {
       // Get the base table column that is associated with the term
       // passed as $condition['column'].
-      $base_field = tripal_get_chado_semweb_column($chado_table, $order['column']);
+      $base_field = chado_get_semweb_column($chado_table, $order['column']);
       $query->orderBy('base.' . $base_field, $order['direction']);
     }
     else {

tripal_chado/includes/TripalFields/chado_linker__contact/chado_linker__contact.inc

@@ -62,9 +62,9 @@ class chado_linker__contact extends ChadoField {
   public function elementInfo() {
 
     $field_term = $this->getFieldTermID();
-    $type_term = tripal_get_chado_semweb_term('contact', 'type_id');
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
-    $description_term = tripal_get_chado_semweb_term('contact', 'description');
+    $type_term = chado_get_semweb_term('contact', 'type_id');
+    $name_term = chado_get_semweb_term('contact', 'name');
+    $description_term = chado_get_semweb_term('contact', 'description');
 
     return array(
       $field_term => array(
@@ -124,9 +124,9 @@ class chado_linker__contact extends ChadoField {
     $field_column = $this->instance['settings']['chado_column'];
     $base_table = $this->instance['settings']['base_table'];
 
-    $type_term = tripal_get_chado_semweb_term('contact', 'type_id');
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
-    $description_term = tripal_get_chado_semweb_term('contact', 'description');
+    $type_term = chado_get_semweb_term('contact', 'type_id');
+    $name_term = chado_get_semweb_term('contact', 'name');
+    $description_term = chado_get_semweb_term('contact', 'description');
 
     // Get the FK that links to the base record.
     $schema = chado_get_schema($field_table);
@@ -193,9 +193,9 @@ class chado_linker__contact extends ChadoField {
     $operator = $condition['operator'];
 
     $field_term_id = $this->getFieldTermID();
-    $type_term = tripal_get_chado_semweb_term('contact', 'type_id');
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
-    $description_term = tripal_get_chado_semweb_term('contact', 'description');
+    $type_term = chado_get_semweb_term('contact', 'type_id');
+    $name_term = chado_get_semweb_term('contact', 'name');
+    $description_term = chado_get_semweb_term('contact', 'description');
 
     $contact_linker = $this->instance['settings']['chado_table'];
     $base_table = $this->instance['settings']['base_table'];
@@ -234,9 +234,9 @@ class chado_linker__contact extends ChadoField {
   public function queryOrder($query, $order) {
     $alias = $this->field['field_name'];
     $field_term_id = $this->getFieldTermID();
-    $type_term = tripal_get_chado_semweb_term('contact', 'type_id');
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
-    $description_term = tripal_get_chado_semweb_term('contact', 'description');
+    $type_term = chado_get_semweb_term('contact', 'type_id');
+    $name_term = chado_get_semweb_term('contact', 'name');
+    $description_term = chado_get_semweb_term('contact', 'description');
 
     $contact_linker = $this->instance['settings']['chado_table'];
     $base_table = $this->instance['settings']['base_table'];

tripal_chado/includes/TripalFields/chado_linker__contact/chado_linker__contact_formatter.inc

@@ -24,9 +24,9 @@ class chado_linker__contact_formatter extends ChadoFieldFormatter {
     // Get the settings
     $settings = $display['settings'];
 
-    $type_term = tripal_get_chado_semweb_term('contact', 'type_id');
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
-    $description_term = tripal_get_chado_semweb_term('contact', 'description');
+    $type_term = chado_get_semweb_term('contact', 'type_id');
+    $name_term = chado_get_semweb_term('contact', 'name');
+    $description_term = chado_get_semweb_term('contact', 'description');
 
     $headers = array('Name', 'Description', 'Type');
     $rows = array();

tripal_chado/includes/TripalFields/chado_linker__contact/chado_linker__contact_widget.inc

@@ -37,7 +37,7 @@ class chado_linker__contact_widget extends ChadoFieldWidget {
     $name = '';
     $value = '';
 
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
+    $name_term = chado_get_semweb_term('contact', 'name');
 
     // If the field already has a value then it will come through the $items
     // array.  This happens when editing an existing record.

tripal_chado/includes/TripalFields/chado_linker__prop/chado_linker__prop.inc

@@ -70,7 +70,7 @@ class chado_linker__prop extends ChadoField {
 
     $vocabulary = $this->instance['settings']['term_vocabulary'];
     $accession = $this->instance['settings']['term_accession'];
-    $cvterm = tripal_get_cvterm(array(
+    $cvterm = chado_get_cvterm(array(
       'dbxref_id' => array(
         'db_id' => array(
           'name' => $vocabulary,
@@ -141,7 +141,7 @@ class chado_linker__prop extends ChadoField {
     $vocab = $this->instance['settings']['term_vocabulary'];
     $accession = $this->instance['settings']['term_accession'];
 
-    $cvterm = tripal_get_cvterm(array('id' => $vocab . ':' . $accession));
+    $cvterm = chado_get_cvterm(array('id' => $vocab . ':' . $accession));
 
     $this->queryJoinOnce($query, $prop_linker, $alias, "base.$bpkey = $alias.$bpkey");
     $query->condition("$alias.type_id", $cvterm->cvterm_id);
@@ -163,7 +163,7 @@ class chado_linker__prop extends ChadoField {
     $vocab = $this->instance['settings']['term_vocabulary'];
     $accession = $this->instance['settings']['term_accession'];
 
-    $cvterm = tripal_get_cvterm(array('id' => $vocab . ':' . $accession));
+    $cvterm = chado_get_cvterm(array('id' => $vocab . ':' . $accession));
 
     $this->queryJoinOnce($query, $prop_linker, $alias, "base.$bpkey = $alias.$bpkey AND $alias.type_id = $cvterm->cvterm_id", "LEFT OUTER");
     $query->orderBy("$alias.value", $order['direction']);

tripal_chado/includes/TripalFields/chado_linker__prop/chado_linker__prop_widget.inc

@@ -66,7 +66,7 @@ class chado_linker__prop_widget extends ChadoFieldWidget {
     if (!$type_id) {
       $vocabulary = $this->instance['settings']['term_vocabulary'];
       $accession = $this->instance['settings']['term_accession'];
-      $cvterm = tripal_get_cvterm(array(
+      $cvterm = chado_get_cvterm(array(
         'dbxref_id' => array(
           'db_id' => array(
             'name' => $vocabulary,

tripal_chado/includes/TripalFields/data__accession/data__accession.inc

@@ -91,7 +91,7 @@ class data__accession extends ChadoField {
     $field_column = $this->instance['settings']['chado_column'];
 
     $field_term_id = $this->getFieldTermID();
-    $accession_term = tripal_get_chado_semweb_term($field_table, $field_column);
+    $accession_term = chado_get_semweb_term($field_table, $field_column);
 
     // We don't offer any sub elements so the value coming in should
     // always be the field_name.
@@ -108,7 +108,7 @@ class data__accession extends ChadoField {
     $field_column = $this->instance['settings']['chado_column'];
 
     $field_term_id = $this->getFieldTermID();
-    $accession_term = tripal_get_chado_semweb_term($field_table, $field_column);
+    $accession_term = chado_get_semweb_term($field_table, $field_column);
 
     // We don't offer any sub elements so the value coming in should
     // always be the field_name.

tripal_chado/includes/TripalFields/data__accession/data__accession_widget.inc

@@ -39,7 +39,7 @@ class data__accession_widget extends ChadoFieldWidget {
     }
 
     $schema = chado_get_schema('dbxref');
-    $options = tripal_get_db_select_options();
+    $options = chado_get_db_select_options();
 
     //$widget['#element_validate'] = array('chado_base__dbxref_id_widget_validate');
     $widget['#prefix'] =  "<span id='$field_name-dbxref--db-id'>";
@@ -137,7 +137,7 @@ class data__accession_widget extends ChadoFieldWidget {
           'db_id' => $db_id,
           'accession' => $accession,
         );
-        $dbxref = tripal_insert_dbxref($values);
+        $dbxref = chado_insert_dbxref($values);
         $form_state['values'][$field_name]['und'][$delta]['chado-' . $field_table . '__dbxref_id'] = $dbxref->dbxref_id;
         $form_state['values'][$field_name]['und'][$delta]['value'] = $dbxref->dbxref_id;
       }

tripal_chado/includes/TripalFields/data__sequence/data__sequence.inc

@@ -120,7 +120,7 @@ class data__sequence extends ChadoField {
         '@type' => 'SO:0000316',
         'type' => 'coding_sequence',
         'label' => 'Coding sequence (CDS)',
-        'defline' => tripal_get_fasta_defline($feature, 'CDS', NULL, '', strlen($coding_seq)),
+        'defline' => chado_get_fasta_defline($feature, 'CDS', NULL, '', strlen($coding_seq)),
         'residues' => $coding_seq,
       );
     }
@@ -137,13 +137,13 @@ class data__sequence extends ChadoField {
         'residues' => $attrs['residues'],
         '@type' => 'SO:0000110',
         'type' => 'sequence_feature',
-        'defline' => tripal_get_fasta_defline($feature, '', $attrs['featureloc'], 'CDS', strlen($attrs['residues'])),
+        'defline' => chado_get_fasta_defline($feature, '', $attrs['featureloc'], 'CDS', strlen($attrs['residues'])),
         'label' => 'Sequence from alignment at ' . $attrs['location'],
       );
 
 
       // check to see if this alignment has any CDS. If so, generate a CDS sequence
-      $cds_sequence = tripal_get_feature_sequences(
+      $cds_sequence = chado_get_feature_sequences(
           array(
             'feature_id' => $feature->feature_id,
             'parent_id' => $attrs['featureloc']->srcfeature_id->feature_id,
@@ -159,7 +159,7 @@ class data__sequence extends ChadoField {
           );
 
       if (count($cds_sequence) > 0) {
-        // the tripal_get_feature_sequences() function can return multiple sequences
+        // the chado_get_feature_sequences() function can return multiple sequences
         // if a feature is aligned to multiple places. In the case of CDSs we expect
         // that one mRNA is only aligned to a single location on the assembly so we
         // can access the CDS sequence with index 0.
@@ -168,7 +168,7 @@ class data__sequence extends ChadoField {
             'residues' => $cds_sequence[0]['residues'],
             '@type' => 'SO:0000316',
             'type' => 'coding_sequence',
-            'defline' => tripal_get_fasta_defline($feature, '', $attrs['featureloc'], 'CDS', $cds_sequence[0]['length']),
+            'defline' => chado_get_fasta_defline($feature, '', $attrs['featureloc'], 'CDS', $cds_sequence[0]['length']),
             'label' => 'Coding sequence (CDS) from alignment at  ' . $attrs['location'],
           );
         }

tripal_chado/includes/TripalFields/data__sequence_coordinates/data__sequence_coordinates.inc

@@ -62,10 +62,10 @@ class data__sequence_coordinates extends ChadoField {
     $field_term = $this->getFieldTermID();
 
     $reference_term = 'data:3002';
-    $fmin_term = tripal_get_chado_semweb_term('featureloc', 'fmin');
-    $fmax_term = tripal_get_chado_semweb_term('featureloc', 'fmax');
-    $strand_term = tripal_get_chado_semweb_term('featureloc', 'strand');
-    $phase_term = tripal_get_chado_semweb_term('featureloc', 'phase');
+    $fmin_term = chado_get_semweb_term('featureloc', 'fmin');
+    $fmax_term = chado_get_semweb_term('featureloc', 'fmax');
+    $strand_term = chado_get_semweb_term('featureloc', 'strand');
+    $phase_term = chado_get_semweb_term('featureloc', 'phase');
 
     return array(
       $field_term => array(
@@ -144,10 +144,10 @@ class data__sequence_coordinates extends ChadoField {
 
     $field_term_id = $this->getFieldTermID();
     $reference_term = $field_term_id . ',' . 'data:3002';
-    $fmin_term = $field_term_id . ',' . tripal_get_chado_semweb_term('featureloc', 'fmin');
-    $fmax_term = $field_term_id . ',' . tripal_get_chado_semweb_term('featureloc', 'fmax');
-    $strand_term = $field_term_id . ',' . tripal_get_chado_semweb_term('featureloc', 'strand');
-    $phase_term = $field_term_id . ',' . tripal_get_chado_semweb_term('featureloc', 'phase');
+    $fmin_term = $field_term_id . ',' . chado_get_semweb_term('featureloc', 'fmin');
+    $fmax_term = $field_term_id . ',' . chado_get_semweb_term('featureloc', 'fmax');
+    $strand_term = $field_term_id . ',' . chado_get_semweb_term('featureloc', 'strand');
+    $phase_term = $field_term_id . ',' . chado_get_semweb_term('featureloc', 'phase');
 
     // Join to the organism table for this field.
     $this->queryJoinOnce($query, 'featureloc', $alias, "base.feature_id = $alias.feature_id");
@@ -185,10 +185,10 @@ class data__sequence_coordinates extends ChadoField {
 
     $field_term_id = $this->getFieldTermID();
     $reference_term = $field_term_id . ',' . 'data:3002';
-    $fmin_term = $field_term_id . ',' . tripal_get_chado_semweb_term('featureloc', 'fmin');
-    $fmax_term = $field_term_id . ',' . tripal_get_chado_semweb_term('featureloc', 'fmax');
-    $strand_term = $field_term_id . ',' . tripal_get_chado_semweb_term('featureloc', 'strand');
-    $phase_term = $field_term_id . ',' . tripal_get_chado_semweb_term('featureloc', 'phase');
+    $fmin_term = $field_term_id . ',' . chado_get_semweb_term('featureloc', 'fmin');
+    $fmax_term = $field_term_id . ',' . chado_get_semweb_term('featureloc', 'fmax');
+    $strand_term = $field_term_id . ',' . chado_get_semweb_term('featureloc', 'strand');
+    $phase_term = $field_term_id . ',' . chado_get_semweb_term('featureloc', 'phase');
 
     $this->queryJoinOnce($query, 'featureloc', $alias, "base.feature_id = $alias.feature_id", "LEFT OUTER");
     if ($order['column'] == $reference_term) {
@@ -218,10 +218,10 @@ class data__sequence_coordinates extends ChadoField {
 
     $description = 'schema:description';
     $reference_term = 'data:3002';
-    $fmin_term = tripal_get_chado_semweb_term('featureloc', 'fmin');
-    $fmax_term = tripal_get_chado_semweb_term('featureloc', 'fmax');
-    $strand_term = tripal_get_chado_semweb_term('featureloc', 'strand');
-    $phase_term = tripal_get_chado_semweb_term('featureloc', 'phase');
+    $fmin_term = chado_get_semweb_term('featureloc', 'fmin');
+    $fmax_term = chado_get_semweb_term('featureloc', 'fmax');
+    $strand_term = chado_get_semweb_term('featureloc', 'strand');
+    $phase_term = chado_get_semweb_term('featureloc', 'phase');
 
     $options = array(
       'return_array' => TRUE,

tripal_chado/includes/TripalFields/data__sequence_coordinates/data__sequence_coordinates_formatter.inc

@@ -15,10 +15,10 @@ class data__sequence_coordinates_formatter extends ChadoFieldFormatter {
   public function view(&$element, $entity_type, $entity, $langcode, $items, $display) {
 
     $reference_term = 'data:3002';
-    $fmin_term = tripal_get_chado_semweb_term('featureloc', 'fmin');
-    $fmax_term = tripal_get_chado_semweb_term('featureloc', 'fmax');
-    $strand_term = tripal_get_chado_semweb_term('featureloc', 'strand');
-    $phase_term = tripal_get_chado_semweb_term('featureloc', 'phase');
+    $fmin_term = chado_get_semweb_term('featureloc', 'fmin');
+    $fmax_term = chado_get_semweb_term('featureloc', 'fmax');
+    $strand_term = chado_get_semweb_term('featureloc', 'strand');
+    $phase_term = chado_get_semweb_term('featureloc', 'phase');
 
     $content = '';
     foreach ($items as $item) {

tripal_chado/includes/TripalFields/go__gene_expression/go__gene_expression.inc

@@ -124,7 +124,7 @@ class go__gene_expression extends ChadoField {
         // Add the pub information if a real pub is associated with the record.
         $pub = $exp_linker->pub_id;
         if ($pub->uniquename != 'null') {
-          $pub_details = tripal_get_minimal_pub_info($pub);
+          $pub_details = chado_get_minimal_pub_info($pub);
 
           $entity->{$field_name}['und'][$i]['value']['publication'] = $pub_details;
           $entity->{$field_name}['und'][$i]['value']['publication']['type'] = $pub->type_id->name;

tripal_chado/includes/TripalFields/local__contact/local__contact.inc

@@ -61,9 +61,9 @@ class local__contact extends ChadoField {
    */
   public function elementInfo() {
     $field_term = $this->getFieldTermID();
-    $type_term = tripal_get_chado_semweb_term('contact', 'type_id');
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
-    $description_term = tripal_get_chado_semweb_term('contact', 'description');
+    $type_term = chado_get_semweb_term('contact', 'type_id');
+    $name_term = chado_get_semweb_term('contact', 'name');
+    $description_term = chado_get_semweb_term('contact', 'description');
 
     return array(
       $field_term => array(
@@ -123,9 +123,9 @@ class local__contact extends ChadoField {
     $field_column = $this->instance['settings']['chado_column'];
     $base_table = $this->instance['settings']['base_table'];
 
-    $type_term = tripal_get_chado_semweb_term('contact', 'type_id');
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
-    $description_term = tripal_get_chado_semweb_term('contact', 'description');
+    $type_term = chado_get_semweb_term('contact', 'type_id');
+    $name_term = chado_get_semweb_term('contact', 'name');
+    $description_term = chado_get_semweb_term('contact', 'description');
 
 
     // Set some defaults for the empty record.
@@ -163,9 +163,9 @@ class local__contact extends ChadoField {
     $operator = $condition['operator'];
 
     $field_term_id = $this->getFieldTermID();
-    $type_term = tripal_get_chado_semweb_term('contact', 'type_id');
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
-    $description_term = tripal_get_chado_semweb_term('contact', 'description');
+    $type_term = chado_get_semweb_term('contact', 'type_id');
+    $name_term = chado_get_semweb_term('contact', 'name');
+    $description_term = chado_get_semweb_term('contact', 'description');
 
     if ($field_table == 'biomaterial') {
       if ($record) {
@@ -200,9 +200,9 @@ class local__contact extends ChadoField {
   public function queryOrder($query, $order) {
     $alias = $this->field['field_name'];
     $field_term_id = $this->getFieldTermID();
-    $type_term = tripal_get_chado_semweb_term('contact', 'type_id');
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
-    $description_term = tripal_get_chado_semweb_term('contact', 'description');
+    $type_term = chado_get_semweb_term('contact', 'type_id');
+    $name_term = chado_get_semweb_term('contact', 'name');
+    $description_term = chado_get_semweb_term('contact', 'description');
 
     if ($field_table == 'biomaterial') {
       if ($record) {

tripal_chado/includes/TripalFields/local__contact/local__contact_formatter.inc

@@ -24,9 +24,9 @@ class local__contact_formatter extends ChadoFieldFormatter {
     // Get the settings
     $settings = $display['settings'];
 
-    $type_term = tripal_get_chado_semweb_term('contact', 'type_id');
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
-    $description_term = tripal_get_chado_semweb_term('contact', 'description');
+    $type_term = chado_get_semweb_term('contact', 'type_id');
+    $name_term = chado_get_semweb_term('contact', 'name');
+    $description_term = chado_get_semweb_term('contact', 'description');
 
     $headers = array('Name', 'Description', 'Type');
     $rows = array();

tripal_chado/includes/TripalFields/local__contact/local__contact_widget.inc

@@ -29,7 +29,7 @@ class local__contact_widget extends ChadoFieldWidget {
     $name = '';
     $value = '';
 
-    $name_term = tripal_get_chado_semweb_term('contact', 'name');
+    $name_term = chado_get_semweb_term('contact', 'name');
 
     // Set the linker field appropriately.
     if ($field_table == 'biomaterial') {

tripal_chado/includes/TripalFields/local__source_data/local__source_data.inc

@@ -61,9 +61,9 @@ class local__source_data extends ChadoField {
   public function elementInfo() {
     $field_term = $this->getFieldTermID();
 
-    $sourcename_term = tripal_get_chado_semweb_term('analysis', 'sourcename');
-    $sourceversion_term = tripal_get_chado_semweb_term('analysis', 'sourceversion');
-    $sourceuri_term = tripal_get_chado_semweb_term('analysis', 'sourceuri');
+    $sourcename_term = chado_get_semweb_term('analysis', 'sourcename');
+    $sourceversion_term = chado_get_semweb_term('analysis', 'sourceversion');
+    $sourceuri_term = chado_get_semweb_term('analysis', 'sourceuri');
 
     return array(
       $field_term => array(
@@ -112,9 +112,9 @@ class local__source_data extends ChadoField {
     $operator = $condition['operator'];
 
     $field_term_id = $this->getFieldTermID();
-    $sourcename_term = $field_term_id . ',' . tripal_get_chado_semweb_term('analysis', 'sourcename');
-    $sourceversion_term = $field_term_id . ',' . tripal_get_chado_semweb_term('analysis', 'sourceversion');
-    $sourceuri_term = $field_term_id . ',' . tripal_get_chado_semweb_term('analysis', 'sourceuri');
+    $sourcename_term = $field_term_id . ',' . chado_get_semweb_term('analysis', 'sourcename');
+    $sourceversion_term = $field_term_id . ',' . chado_get_semweb_term('analysis', 'sourceversion');
+    $sourceuri_term = $field_term_id . ',' . chado_get_semweb_term('analysis', 'sourceuri');
 
     if ($condition['column'] == $sourcename_term) {
       $query->condition("base.sourcename", $condition['value'], $operator);
@@ -128,9 +128,9 @@ class local__source_data extends ChadoField {
    */
   public function queryOrder($query, $order) {
     $field_term_id = $this->getFieldTermID();
-    $sourcename_term = $field_term_id . ',' . tripal_get_chado_semweb_term('analysis', 'sourcename');
-    $sourceversion_term = $field_term_id . ',' . tripal_get_chado_semweb_term('analysis', 'sourceversion');
-    $sourceuri_term = $field_term_id . ',' . tripal_get_chado_semweb_term('analysis', 'sourceuri');
+    $sourcename_term = $field_term_id . ',' . chado_get_semweb_term('analysis', 'sourcename');
+    $sourceversion_term = $field_term_id . ',' . chado_get_semweb_term('analysis', 'sourceversion');
+    $sourceuri_term = $field_term_id . ',' . chado_get_semweb_term('analysis', 'sourceuri');
 
     if ($order['column'] == $sourcename_term) {
       $query->orderBy("base.sourcename", $order['direction']);
@@ -151,9 +151,9 @@ class local__source_data extends ChadoField {
     $field_table = $this->instance['settings']['chado_table'];
     $field_column = $this->instance['settings']['chado_column'];
 
-    $sourcename_term = tripal_get_chado_semweb_term('analysis', 'sourcename');
-    $sourceversion_term = tripal_get_chado_semweb_term('analysis', 'sourceversion');
-    $sourceuri_term = tripal_get_chado_semweb_term('analysis', 'sourceuri');
+    $sourcename_term = chado_get_semweb_term('analysis', 'sourcename');
+    $sourceversion_term = chado_get_semweb_term('analysis', 'sourceversion');
+    $sourceuri_term = chado_get_semweb_term('analysis', 'sourceuri');
 
     $entity->{$field_name}['und'][0] = array(
       'value' => array(

tripal_chado/includes/TripalFields/local__source_data/local__source_data_formatter.inc

@@ -13,9 +13,9 @@ class local__source_data_formatter extends ChadoFieldFormatter {
    */
   public function view(&$element, $entity_type, $entity, $langcode, $items, $display) {
 
-    $sourcename_term = tripal_get_chado_semweb_term('analysis', 'sourcename');
-    $sourceversion_term = tripal_get_chado_semweb_term('analysis', 'sourceversion');
-    $sourceuri_term = tripal_get_chado_semweb_term('analysis', 'sourceuri');
+    $sourcename_term = chado_get_semweb_term('analysis', 'sourcename');
+    $sourceversion_term = chado_get_semweb_term('analysis', 'sourceversion');
+    $sourceuri_term = chado_get_semweb_term('analysis', 'sourceuri');
 
     $content = 'The data source is not provided.';
     if ($items[0]['value']) {

tripal_chado/includes/TripalFields/obi__organism/obi__organism.inc

@@ -93,10 +93,10 @@ class obi__organism extends ChadoField {
 
     // Get the terms for each of the keys for the 'values' property.
     $label_term = 'rdfs:label';
-    $genus_term = tripal_get_chado_semweb_term('organism', 'genus');
-    $species_term = tripal_get_chado_semweb_term('organism', 'species');
-    $infraspecific_name_term = tripal_get_chado_semweb_term('organism', 'infraspecific_name');
-    $infraspecific_type_term = tripal_get_chado_semweb_term('organism', 'type_id');
+    $genus_term = chado_get_semweb_term('organism', 'genus');
+    $species_term = chado_get_semweb_term('organism', 'species');
+    $infraspecific_name_term = chado_get_semweb_term('organism', 'infraspecific_name');
+    $infraspecific_type_term = chado_get_semweb_term('organism', 'type_id');
 
 
     // Set the linker field appropriately.
@@ -120,7 +120,7 @@ class obi__organism extends ChadoField {
         $organism = $record->organism_id;
       }
       $string = $settings['field_display_string'];
-      $label = tripal_replace_chado_tokens($string, $organism);
+      $label = chado_replace_tokens($string, $organism);
       $entity->{$field_name}['und'][0]['value'] = array(
         $label_term => $label,
         $genus_term => $organism->genus,
@@ -177,10 +177,10 @@ class obi__organism extends ChadoField {
     $headers = array('Token', 'Description');
     $rows = array();
 
-    // Here we use the tripal_get_chado_tokens rather than the
+    // Here we use the chado_get_tokens rather than the
     // tripal_get_entity_tokens because we can't gurantee that all organisms
     // have entities.
-    $tokens = tripal_get_chado_tokens('organism');
+    $tokens = chado_get_tokens('organism');
     foreach ($tokens as $token) {
       $rows[] = array(
         $token['token'],
@@ -211,10 +211,10 @@ class obi__organism extends ChadoField {
   public function elementInfo() {
     $field_term = $this->getFieldTermID();
 
-    $genus_term = tripal_get_chado_semweb_term('organism', 'genus');
-    $species_term = tripal_get_chado_semweb_term('organism', 'species');
-    $infraspecific_name_term = tripal_get_chado_semweb_term('organism', 'infraspecific_name');
-    $infraspecific_type_term = tripal_get_chado_semweb_term('organism', 'type_id');
+    $genus_term = chado_get_semweb_term('organism', 'genus');
+    $species_term = chado_get_semweb_term('organism', 'species');
+    $infraspecific_name_term = chado_get_semweb_term('organism', 'infraspecific_name');
+    $infraspecific_type_term = chado_get_semweb_term('organism', 'type_id');
 
     return array(
       $field_term => array(
@@ -285,10 +285,10 @@ class obi__organism extends ChadoField {
     $operator = $condition['operator'];
 
     $field_term_id = $this->getFieldTermID();
-    $genus_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'genus');
-    $species_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'species');
-    $infraspecific_name_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'infraspecific_name');
-    $infraspecific_type_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'type_id');
+    $genus_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'genus');
+    $species_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'species');
+    $infraspecific_name_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'infraspecific_name');
+    $infraspecific_type_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'type_id');
 
     // Join to the organism table for this field.
     $this->queryJoinOnce($query, 'organism', $alias, "base.organism_id = $alias.organism_id");
@@ -329,10 +329,10 @@ class obi__organism extends ChadoField {
     $alias = $this->field['field_name'];
 
     $field_term_id = $this->getFieldTermID();
-    $genus_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'genus');
-    $species_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'species');
-    $infraspecific_name_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'infraspecific_name');
-    $infraspecific_type_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'type_id');
+    $genus_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'genus');
+    $species_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'species');
+    $infraspecific_name_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'infraspecific_name');
+    $infraspecific_type_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'type_id');
 
     // Join to the organism table for this field.
     $this->queryJoinOnce($query, 'organism', $alias, "base.organism_id = $alias.organism_id");

tripal_chado/includes/TripalFields/obi__organism/obi__organism_widget.inc

@@ -39,7 +39,7 @@ class obi__organism_widget extends ChadoFieldWidget {
       '#type' => 'value',
       '#value' => array_key_exists($delta, $items) ? $items[$delta]['value'] : '',
     );
-    $options = tripal_get_organism_select_options(FALSE);
+    $options = chado_get_organism_select_options(FALSE);
     $widget[$linker_field] = array(
       '#type' => 'select',
       '#title' => $element['#title'],

tripal_chado/includes/TripalFields/ogi__location_on_map/ogi__location_on_map.inc

@@ -61,12 +61,12 @@ class ogi__location_on_map extends ChadoField {
     $field_term = $this->getFieldTermID();
 
     $map_term = 'data:1274';
-    $name_term = tripal_get_chado_semweb_term('featuremap', 'name');
-    $description_term = tripal_get_chado_semweb_term('featuremap', 'description');
-    $mappos_term = tripal_get_chado_semweb_term('featurepos', 'mappos');
-    $ref_feature_term = tripal_get_chado_semweb_term('featurepos', 'map_feature_id');
-    $ref_feature_name = tripal_get_chado_semweb_term('feature', 'name');
-    $ref_feature_id = tripal_get_chado_semweb_term('feature', 'uniquename');
+    $name_term = chado_get_semweb_term('featuremap', 'name');
+    $description_term = chado_get_semweb_term('featuremap', 'description');
+    $mappos_term = chado_get_semweb_term('featurepos', 'mappos');
+    $ref_feature_term = chado_get_semweb_term('featurepos', 'map_feature_id');
+    $ref_feature_name = chado_get_semweb_term('feature', 'name');
+    $ref_feature_id = chado_get_semweb_term('feature', 'uniquename');
     $ref_feature_type = 'rdfs:type';
 
     return array(
@@ -167,14 +167,14 @@ class ogi__location_on_map extends ChadoField {
     // Map details.
     $field_term_id = $this->getFieldTermID();
     $map_term = 'data:1274';
-    $name_term = $field_term_id . ',' . $map_term . ',' . tripal_get_chado_semweb_term('featuremap', 'name');
-    $description_term = $field_term_id . ',' . $map_term . ',' . tripal_get_chado_semweb_term('featuremap', 'description');
-    $mappos_term = $field_term_id . ',' . tripal_get_chado_semweb_term('featurepos', 'mappos');
+    $name_term = $field_term_id . ',' . $map_term . ',' . chado_get_semweb_term('featuremap', 'name');
+    $description_term = $field_term_id . ',' . $map_term . ',' . chado_get_semweb_term('featuremap', 'description');
+    $mappos_term = $field_term_id . ',' . chado_get_semweb_term('featurepos', 'mappos');
 
     // Reference sequence details.
-    $ref_feature_term = tripal_get_chado_semweb_term('featurepos', 'map_feature_id');
-    $ref_feature_name = $field_term_id . ',' . $ref_feature_term . ',' .tripal_get_chado_semweb_term('feature', 'name');
-    $ref_feature_id = $field_term_id . ',' . $ref_feature_term . ',' .tripal_get_chado_semweb_term('feature', 'uniquename');
+    $ref_feature_term = chado_get_semweb_term('featurepos', 'map_feature_id');
+    $ref_feature_name = $field_term_id . ',' . $ref_feature_term . ',' .chado_get_semweb_term('feature', 'name');
+    $ref_feature_id = $field_term_id . ',' . $ref_feature_term . ',' .chado_get_semweb_term('feature', 'uniquename');
     $ref_feature_type = $field_term_id . ',' . $ref_feature_term . ',' .'rdfs:type';
 
     $this->queryJoinOnce($query, 'featurepos', $alias, "base.feature_id = $alias.feature_id");
@@ -214,14 +214,14 @@ class ogi__location_on_map extends ChadoField {
     // Map details.
     $field_term_id = $this->getFieldTermID();
     $map_term = 'data:1274';
-    $name_term = $field_term_id . ',' . $map_term . ',' . tripal_get_chado_semweb_term('featuremap', 'name');
-    $description_term = $field_term_id . ',' . $map_term . ',' . tripal_get_chado_semweb_term('featuremap', 'description');
-    $mappos_term = $field_term_id . ',' . tripal_get_chado_semweb_term('featurepos', 'mappos');
+    $name_term = $field_term_id . ',' . $map_term . ',' . chado_get_semweb_term('featuremap', 'name');
+    $description_term = $field_term_id . ',' . $map_term . ',' . chado_get_semweb_term('featuremap', 'description');
+    $mappos_term = $field_term_id . ',' . chado_get_semweb_term('featurepos', 'mappos');
 
     // Reference sequence details.
-    $ref_feature_term = tripal_get_chado_semweb_term('featurepos', 'map_feature_id');
-    $ref_feature_name = $field_term_id . ',' . $ref_feature_term . ',' .tripal_get_chado_semweb_term('feature', 'name');
-    $ref_feature_id = $field_term_id . ',' . $ref_feature_term . ',' .tripal_get_chado_semweb_term('feature', 'uniquename');
+    $ref_feature_term = chado_get_semweb_term('featurepos', 'map_feature_id');
+    $ref_feature_name = $field_term_id . ',' . $ref_feature_term . ',' .chado_get_semweb_term('feature', 'name');
+    $ref_feature_id = $field_term_id . ',' . $ref_feature_term . ',' .chado_get_semweb_term('feature', 'uniquename');
     $ref_feature_type = $field_term_id . ',' . $ref_feature_term . ',' .'rdfs:type';
 
     $this->queryJoinOnce($query, 'featurepos', $alias, "base.feature_id = $alias.feature_id", 'LEFT OUTER');
@@ -265,14 +265,14 @@ class ogi__location_on_map extends ChadoField {
 
     // Map details
     $map_term = 'data:1274';
-    $name_term = tripal_get_chado_semweb_term('featuremap', 'name');
-    $description_term = tripal_get_chado_semweb_term('featuremap', 'description');
-    $mappos_term = tripal_get_chado_semweb_term('featurepos', 'mappos');
+    $name_term = chado_get_semweb_term('featuremap', 'name');
+    $description_term = chado_get_semweb_term('featuremap', 'description');
+    $mappos_term = chado_get_semweb_term('featurepos', 'mappos');
 
     // Reference sequence details.
-    $ref_feature_term = tripal_get_chado_semweb_term('featurepos', 'map_feature_id');
-    $ref_feature_name = tripal_get_chado_semweb_term('feature', 'name');
-    $ref_feature_id = tripal_get_chado_semweb_term('feature', 'uniquename');
+    $ref_feature_term = chado_get_semweb_term('featurepos', 'map_feature_id');
+    $ref_feature_name = chado_get_semweb_term('feature', 'name');
+    $ref_feature_id = chado_get_semweb_term('feature', 'uniquename');
     $ref_feature_type = 'rdfs:type';
 
     // Set some defaults for the empty record.

tripal_chado/includes/TripalFields/sbo__database_cross_reference/sbo__database_cross_reference.inc

@@ -63,9 +63,9 @@ class sbo__database_cross_reference extends ChadoField {
   public function elementInfo() {
 
     $field_term = $this->getFieldTermID();
-    $dbname_term = tripal_get_chado_semweb_term('db', 'name');
-    $accession_term = tripal_get_chado_semweb_term('dbxref', 'accession');
-    $dburl_term = tripal_get_chado_semweb_term('db', 'url');
+    $dbname_term = chado_get_semweb_term('db', 'name');
+    $accession_term = chado_get_semweb_term('dbxref', 'accession');
+    $dburl_term = chado_get_semweb_term('db', 'url');
 
     return array(
       $field_term => array(
@@ -125,9 +125,9 @@ class sbo__database_cross_reference extends ChadoField {
     $fkey_lcolumn = key($schema['foreign keys'][$base_table]['columns']);
     $fkey_rcolumn = $schema['foreign keys'][$base_table]['columns'][$fkey_lcolumn];
 
-    $dbname_term = tripal_get_chado_semweb_term('db', 'name');
-    $accession_term = tripal_get_chado_semweb_term('dbxref', 'accession');
-    $dburl_term = tripal_get_chado_semweb_term('db', 'url');
+    $dbname_term = chado_get_semweb_term('db', 'name');
+    $accession_term = chado_get_semweb_term('dbxref', 'accession');
+    $dburl_term = chado_get_semweb_term('db', 'url');
 
     // Set some defaults for the empty record.
     $entity->{$field_name}['und'][0] = array(
@@ -153,7 +153,7 @@ class sbo__database_cross_reference extends ChadoField {
           continue;
         }
 
-        $URL = tripal_get_dbxref_url($dbxref);
+        $URL = chado_get_dbxref_url($dbxref);
         $entity->{$field_name}['und'][$i] = array(
           'value' => array(
             $dbname_term => $dbxref->db_id->name,
@@ -186,9 +186,9 @@ class sbo__database_cross_reference extends ChadoField {
     $operator = $condition['operator'];
 
     $field_term_id = $this->getFieldTermID();
-    $dbname_term = $field_term_id . ',' . tripal_get_chado_semweb_term('db', 'name');
-    $accession_term = $field_term_id . ',' . tripal_get_chado_semweb_term('dbxref', 'accession');
-    $dburl_term = $field_term_id . ',' . tripal_get_chado_semweb_term('db', 'url');
+    $dbname_term = $field_term_id . ',' . chado_get_semweb_term('db', 'name');
+    $accession_term = $field_term_id . ',' . chado_get_semweb_term('dbxref', 'accession');
+    $dburl_term = $field_term_id . ',' . chado_get_semweb_term('db', 'url');
 
     $this->queryJoinOnce($query, $field_table, $alias, "base.$bpkey = $alias.$bpkey");
     $this->queryJoinOnce($query, 'dbxref', $alias . '_DBX', $alias . "_DBX.dbxref_id = $alias.dbxref_id");
@@ -216,9 +216,9 @@ class sbo__database_cross_reference extends ChadoField {
     $alias = $this->field['field_name'];
 
     $field_term_id = $this->getFieldTermID();
-    $dbname_term = $field_term_id . ',' . tripal_get_chado_semweb_term('db', 'name');
-    $accession_term = $field_term_id . ',' . tripal_get_chado_semweb_term('dbxref', 'accession');
-    $dburl_term = $field_term_id . ',' . tripal_get_chado_semweb_term('db', 'url');
+    $dbname_term = $field_term_id . ',' . chado_get_semweb_term('db', 'name');
+    $accession_term = $field_term_id . ',' . chado_get_semweb_term('dbxref', 'accession');
+    $dburl_term = $field_term_id . ',' . chado_get_semweb_term('db', 'url');
 
     $this->queryJoinOnce($query, $field_table, $alias, "base.$bpkey = $alias.$bpkey", "LEFT OUTER");
     $this->queryJoinOnce($query, 'dbxref', $alias . '_DBX', $alias . "_DBX.dbxref_id = $alias.dbxref_id", "LEFT OUTER");

tripal_chado/includes/TripalFields/sbo__database_cross_reference/sbo__database_cross_reference_formatter.inc

@@ -21,9 +21,9 @@ class sbo__database_cross_reference_formatter extends ChadoFieldFormatter {
     $base_table = $this->instance['settings']['base_table'];
     $linker_table = $base_table . '_dbxref';
 
-    $dbname_term = tripal_get_chado_semweb_term('db', 'name');
-    $accession_term = tripal_get_chado_semweb_term('dbxref', 'accession');
-    $dburl_term = tripal_get_chado_semweb_term('db', 'url');
+    $dbname_term = chado_get_semweb_term('db', 'name');
+    $accession_term = chado_get_semweb_term('dbxref', 'accession');
+    $dburl_term = chado_get_semweb_term('db', 'url');
 
     foreach ($items as $delta => $item) {
       if (!$item['value']) {
@@ -31,8 +31,8 @@ class sbo__database_cross_reference_formatter extends ChadoFieldFormatter {
       }
       $content = $item['value'][$dbname_term] . ':' . $item['value'][$accession_term];
       if ($item['value'][$dburl_term]) {
-        $dbxref = tripal_get_dbxref(array('dbxref_id' => $item['chado-' . $linker_table . '__dbxref_id']));
-        $url = tripal_get_dbxref_url($dbxref);
+        $dbxref = chado_get_dbxref(array('dbxref_id' => $item['chado-' . $linker_table . '__dbxref_id']));
+        $url = chado_get_dbxref_url($dbxref);
         $content = l($content, $url, array('attributes' => array('target' => '_blank')));
       }
       $element[$delta] = array(

tripal_chado/includes/TripalFields/sbo__database_cross_reference/sbo__database_cross_reference_widget.inc

@@ -73,7 +73,7 @@ class sbo__database_cross_reference_widget extends ChadoFieldWidget {
       '#type' => 'value',
       '#default_value' => $dbxref_id,
     );
-    $options = tripal_get_db_select_options();
+    $options = chado_get_db_select_options();
     $widget['db_id'] = array(
       '#type' => 'select',
       '#title' => t('Database'),

tripal_chado/includes/TripalFields/sbo__relationship/sbo__relationship.inc

@@ -618,7 +618,7 @@ class sbo__relationship extends ChadoField {
     //         as the relationship types. This select box will replace the vocabulary select box if the
     //         following value is set.'
     //     );
-    $vocs = tripal_get_cv_select_options();
+    $vocs = chado_get_cv_select_options();
     $element['relationships']['option1'] = array(
       '#type' => 'item',
       '#title' => 'Option #1',
@@ -725,7 +725,7 @@ class sbo__relationship extends ChadoField {
           if (strpos($type, '|')) {
             $tmp = explode('|', $type, 2);
             $type = trim($tmp[1]);
-            $cv = tripal_get_cv(array('name' => trim($tmp[0])));
+            $cv = chado_get_cv(array('name' => trim($tmp[0])));
             if($cv) {
               $sql = "SELECT cvterm_id FROM {cvterm} WHERE name = :name AND cv_id = :cv_id";
               $results = chado_query($sql, array(':name' => $type, ':cv_id' => $cv->cv_id));
@@ -753,7 +753,7 @@ class sbo__relationship extends ChadoField {
           if (strpos($type, '|')) {
             $tmp = explode('|', $type, 2);
             $type = trim($tmp[1]);
-            $cv = tripal_get_cv(array('name' => trim($tmp[0])));
+            $cv = chado_get_cv(array('name' => trim($tmp[0])));
             if ($cv) {
               $sql = "SELECT cvterm_id FROM {cvterm} WHERE name = :name AND cv_id = :cv_id";
               $results = chado_query($sql, array(':name' => $type, ':cv_id' => $cv->cv_id));
@@ -774,14 +774,14 @@ class sbo__relationship extends ChadoField {
     if ($option2) {
       $cv_id = $settings['option2_vocab'];
       $supertype = $settings['option2_parent'];
-      $term = tripal_get_cvterm(array(
+      $term = chado_get_cvterm(array(
         'name' => trim($supertype),
         'cv_id' => $cv_id,
       ));
       // Tripal cv autocomplete also allow cvterm synonyms, if the parent term doesn't match
       // a cvterm, try cvtermsynonym
       if (!$term) {
-        $synonym = tripal_get_cvterm(
+        $synonym = chado_get_cvterm(
             array(
               'synonym' => array(
                 'name' => trim($supertype),

tripal_chado/includes/TripalFields/sbo__relationship/sbo__relationship_widget.inc

@@ -194,13 +194,13 @@ class sbo__relationship_widget extends ChadoFieldWidget {
         if (trim($rtype) == '') {
           continue;
         }
-        $term = tripal_get_cvterm(array('name' => trim($rtype)));
+        $term = chado_get_cvterm(array('name' => trim($rtype)));
         // Try to get term with vocabulary specified
         if (!$term) {
           $tmp = explode('|', trim($rtype), 2);
-          $cv = tripal_get_cv(array('name' => trim($tmp[0])));
+          $cv = chado_get_cv(array('name' => trim($tmp[0])));
           $rtype = trim($tmp[1]);
-          $term = tripal_get_cvterm(array('name' => $rtype, 'cv_id' => $cv->cv_id));
+          $term = chado_get_cvterm(array('name' => $rtype, 'cv_id' => $cv->cv_id));
         }
         $rtype_options[$term->cvterm_id] = $term->name;
       }
@@ -220,7 +220,7 @@ class sbo__relationship_widget extends ChadoFieldWidget {
         'cv_id' => $option2_vocab,
         'name' => $option2_parent
       );
-      $parent_term = tripal_get_cvterm($values);
+      $parent_term = chado_get_cvterm($values);
 
       // If the term wasn't found then see if it's a synonym.
       if(!$parent_term) {
@@ -229,7 +229,7 @@ class sbo__relationship_widget extends ChadoFieldWidget {
             'name' => trim($option2_parent),
           )
         );
-        $synonym = tripal_get_cvterm($values);
+        $synonym = chado_get_cvterm($values);
         if ($synonym && $synonym->cv_id->cv_id == $option2_vocab) {
           $parent_term = $synonym;
         }
@@ -283,11 +283,11 @@ class sbo__relationship_widget extends ChadoFieldWidget {
     else {
       // Set up available cvterms for selection
       $vocs = array(0 => 'Select a vocabulary');
-      $vocs = tripal_get_cv_select_options();
+      $vocs = chado_get_cv_select_options();
       $cv_id = isset($form_state['values'][$field_name]['und'][0]['vocabulary']) ? $form_state['values'][$field_name]['und'][0]['vocabulary'] : 0;
       // Try getting the cv_id from cvterm for existing records
       if (!$cv_id && $type_id) {
-        $cvterm = tripal_get_cvterm(array('cvterm_id' => $type_id));
+        $cvterm = chado_get_cvterm(array('cvterm_id' => $type_id));
         if (isset($cvterm->cv_id->cv_id)) {
           $cv_id = $cvterm->cv_id->cv_id;
           $default_term = $cvterm->name;

tripal_chado/includes/TripalFields/schema__additional_type/schema__additional_type_widget.inc

@@ -68,8 +68,8 @@ class schema__additional_type_widget extends ChadoFieldWidget {
       }
     }
     elseif ($vocabulary) {
-      $cv = tripal_get_cv(array('name' => $vocabulary));
-      $options = tripal_get_cvterm_select_options($cv->cv_id);
+      $cv = chado_get_cv(array('name' => $vocabulary));
+      $options = chado_get_cvterm_select_options($cv->cv_id);
     }
     // If no vocabulary or parent term are provided then just give a generic
     // term finder.

tripal_chado/includes/TripalFields/schema__publication/schema__publication.inc

@@ -107,7 +107,7 @@ class schema__publication extends ChadoField {
       $i = 0;
       foreach ($record->$linker_table as $index => $linker) {
         $pub = $linker->pub_id;
-        $pub_details = tripal_get_minimal_pub_info($pub);
+        $pub_details = chado_get_minimal_pub_info($pub);
 
         $entity->{$field_name}['und'][$i]['value'] = $pub_details;
         $entity->{$field_name}['und'][$i]['chado-' . $field_table . '__' . $pkey] = $linker->$pkey;

tripal_chado/includes/TripalFields/schema__publication/schema__publication_widget.inc

@@ -37,7 +37,7 @@ class schema__publication_widget extends ChadoFieldWidget {
       $fkey_value = tripal_get_field_item_keyval($items, $delta, 'chado-' . $table_name . '__' . $fkey, $fkey_value);
       $pub_id = tripal_get_field_item_keyval($items, $delta, 'chado-' . $table_name . '__pub_id', $pub_id);
       if ($pub_id) {
-        $pub = tripal_get_publication(array('pub_id' => $pub_id));
+        $pub = chado_get_publication(array('pub_id' => $pub_id));
         $title =  $pub->title . ' [id:' . $pub->pub_id . ']';
       }
     }

tripal_chado/includes/TripalFields/sio__annotation/sio__annotation.inc

@@ -92,9 +92,9 @@ class sio__annotation extends ChadoField {
     $field_table = $this->instance['settings']['chado_table'];
     $schema = chado_get_schema($field_table);
 
-    $vocabulary_term = tripal_get_chado_semweb_term('cvterm', 'cv_id');
-    $accession_term = tripal_get_chado_semweb_term('dbxref', 'accession');
-    $definition_term = tripal_get_chado_semweb_term('cvterm', 'definition');
+    $vocabulary_term = chado_get_semweb_term('cvterm', 'cv_id');
+    $accession_term = chado_get_semweb_term('dbxref', 'accession');
+    $definition_term = chado_get_semweb_term('cvterm', 'definition');
 
     $field_term = $this->getFieldTermID();
     $info = array(
@@ -134,7 +134,7 @@ class sio__annotation extends ChadoField {
     );
 
     if (array_key_exists('is_not', $schema['fields'])) {
-      $negation_term = tripal_get_chado_semweb_term($field_table, 'is_not');
+      $negation_term = chado_get_semweb_term($field_table, 'is_not');
       $info[$field_term]['elements'][$negation_term] = array(
         'sortable' => FALSE,
         'searchable' => FALSE,
@@ -145,7 +145,7 @@ class sio__annotation extends ChadoField {
       );
     }
     if (array_key_exists('rank', $schema['fields'])) {
-      $rank_term = tripal_get_chado_semweb_term($field_table, 'rank');
+      $rank_term = chado_get_semweb_term($field_table, 'rank');
       $info[$field_term]['elements'][$rank_term] = array(
         'sortable' => FALSE,
         'searchable' => FALSE,
@@ -177,9 +177,9 @@ class sio__annotation extends ChadoField {
 
     $field_term_id = $this->getFieldTermID();
 
-    $vocabulary_term = $field_term_id . ',' . tripal_get_chado_semweb_term('cvterm', 'cv_id');
-    $accession_term = $field_term_id . ',' . tripal_get_chado_semweb_term('dbxref', 'accession');
-    $definition_term = $field_term_id . ',' . tripal_get_chado_semweb_term('cvterm', 'definition');
+    $vocabulary_term = $field_term_id . ',' . chado_get_semweb_term('cvterm', 'cv_id');
+    $accession_term = $field_term_id . ',' . chado_get_semweb_term('dbxref', 'accession');
+    $definition_term = $field_term_id . ',' . chado_get_semweb_term('cvterm', 'definition');
 
 
     // Join to the xxx_cvterm table for this field.
@@ -218,9 +218,9 @@ class sio__annotation extends ChadoField {
 
     $field_term_id = $this->getFieldTermID();
 
-    $vocabulary_term = $field_term_id . ',' . tripal_get_chado_semweb_term('cvterm', 'cv_id');
-    $accession_term = $field_term_id . ',' . tripal_get_chado_semweb_term('dbxref', 'accession');
-    $definition_term = $field_term_id . ',' . tripal_get_chado_semweb_term('cvterm', 'definition');
+    $vocabulary_term = $field_term_id . ',' . chado_get_semweb_term('cvterm', 'cv_id');
+    $accession_term = $field_term_id . ',' . chado_get_semweb_term('dbxref', 'accession');
+    $definition_term = $field_term_id . ',' . chado_get_semweb_term('cvterm', 'definition');
 
     // Join to the xxx_cvterm table for this field.
     $this->queryJoinOnce($query, $field_table, $alias, "base.$fkey_rcolumn = $alias.$fkey_lcolumn");
@@ -258,14 +258,14 @@ class sio__annotation extends ChadoField {
     $fkey_lcolumn = key($schema['foreign keys'][$base_table]['columns']);
     $fkey_rcolumn = $schema['foreign keys'][$base_table]['columns'][$fkey_lcolumn];
 
-    $vocabulary = tripal_get_chado_semweb_term('cvterm', 'cv_id');
-    $accession = tripal_get_chado_semweb_term('dbxref', 'accession');
-    $definition = tripal_get_chado_semweb_term('cvterm', 'definition');
+    $vocabulary = chado_get_semweb_term('cvterm', 'cv_id');
+    $accession = chado_get_semweb_term('dbxref', 'accession');
+    $definition = chado_get_semweb_term('cvterm', 'definition');
     if (array_key_exists('is_not', $schema['fields'])) {
-      $negation = tripal_get_chado_semweb_term($field_table, 'is_not');
+      $negation = chado_get_semweb_term($field_table, 'is_not');
     }
     if (array_key_exists('rank', $schema['fields'])) {
-      $rank_term = tripal_get_chado_semweb_term($field_table, 'rank');
+      $rank_term = chado_get_semweb_term($field_table, 'rank');
     }
 
     // Set some defaults for the empty record.

tripal_chado/includes/TripalFields/sio__annotation/sio__annotation_formatter.inc

@@ -18,11 +18,11 @@ class sio__annotation_formatter extends ChadoFieldFormatter {
     $field_table = $this->instance['settings']['chado_table'];
     $schema = chado_get_schema($field_table);
 
-    $vocabulary_term = tripal_get_chado_semweb_term('cvterm', 'cv_id');
-    $accession_term = tripal_get_chado_semweb_term('dbxref', 'accession');
-    $definition_term = tripal_get_chado_semweb_term('cvterm', 'definition');
+    $vocabulary_term = chado_get_semweb_term('cvterm', 'cv_id');
+    $accession_term = chado_get_semweb_term('dbxref', 'accession');
+    $definition_term = chado_get_semweb_term('cvterm', 'definition');
     if (array_key_exists('is_not', $schema['fields'])) {
-      $negation_term = tripal_get_chado_semweb_term($field_table, 'is_not');
+      $negation_term = chado_get_semweb_term($field_table, 'is_not');
     }
 
     $chado_table = $this->instance['settings']['chado_table'];
@@ -35,7 +35,7 @@ class sio__annotation_formatter extends ChadoFieldFormatter {
         // Build the accession.
         $accession = $dbxref->db_id->name . ':' . $dbxref->accession;
         if ($dbxref->db_id->urlprefix) {
-          $accession = l($accession, tripal_get_dbxref_url($dbxref), array('attributes' => array('target' => '_blank')));
+          $accession = l($accession, chado_get_dbxref_url($dbxref), array('attributes' => array('target' => '_blank')));
         }
 
         $row = array(

tripal_chado/includes/TripalFields/sio__annotation/sio__annotation_widget.inc

@@ -27,11 +27,11 @@ class sio__annotation_widget extends ChadoFieldWidget {
     $fkey_lcolumn = key($schema['foreign keys'][$base_table]['columns']);
     $fkey_rcolumn = $schema['foreign keys'][$base_table]['columns'][$fkey_lcolumn];
 
-    $vocabulary = tripal_get_chado_semweb_term('cvterm', 'cv_id');
-    $accession = tripal_get_chado_semweb_term('dbxref', 'accession');
-    $definition = tripal_get_chado_semweb_term('cvterm', 'definition');
+    $vocabulary = chado_get_semweb_term('cvterm', 'cv_id');
+    $accession = chado_get_semweb_term('dbxref', 'accession');
+    $definition = chado_get_semweb_term('cvterm', 'definition');
     if (array_key_exists('is_not', $schema['fields'])) {
-      $negation = tripal_get_chado_semweb_term($field_table, 'is_not');
+      $negation = chado_get_semweb_term($field_table, 'is_not');
     }
 
     // Get the field defaults.
@@ -118,7 +118,7 @@ class sio__annotation_widget extends ChadoFieldWidget {
       '#default_value' => $fk_value,
     );
 
-    $cvs = tripal_get_cv_select_options();
+    $cvs = chado_get_cv_select_options();
     $widget['cv_id'] = array(
       '#type' => 'select',
       '#title' => t('Vocabulary'),
@@ -192,11 +192,11 @@ class sio__annotation_widget extends ChadoFieldWidget {
     $fkey_lcolumn = key($schema['foreign keys'][$base_table]['columns']);
     $fkey_rcolumn = $schema['foreign keys'][$base_table]['columns'][$fkey_lcolumn];
 
-    $vocabulary = tripal_get_chado_semweb_term('cvterm', 'cv_id');
-    $accession = tripal_get_chado_semweb_term('dbxref', 'accession');
-    $definition = tripal_get_chado_semweb_term('cvterm', 'definition');
+    $vocabulary = chado_get_semweb_term('cvterm', 'cv_id');
+    $accession = chado_get_semweb_term('dbxref', 'accession');
+    $definition = chado_get_semweb_term('cvterm', 'definition');
     if (array_key_exists('is_not', $schema['fields'])) {
-      $negation = tripal_get_chado_semweb_term($field_table, 'is_not');
+      $negation = chado_get_semweb_term($field_table, 'is_not');
     }
 
     $record_id = $form_state['values'][$field_name]['und'][$delta]['chado-' . $field_table . '__' . $pkey];
@@ -214,7 +214,7 @@ class sio__annotation_widget extends ChadoFieldWidget {
       }
       // Use the NULL pub.
       else {
-        $pub = tripal_get_publication(array('uniquename' => 'null'));
+        $pub = chado_get_publication(array('uniquename' => 'null'));
         $form_state['values'][$field_name][$langcode][$delta]['chado-' . $field_table . '__pub_id'] = $pub->pub_id;
       }
     }

tripal_chado/includes/TripalFields/sio__references/sio__references.inc

@@ -129,7 +129,7 @@ class sio__references extends ChadoField {
               ->execute()
               ->fetchObject();
             if ($mapping) {
-              $cvterm = tripal_get_cvterm(array('cvterm_id' => $mapping->cvterm_id));
+              $cvterm = chado_get_cvterm(array('cvterm_id' => $mapping->cvterm_id));
               $entity->{$field_name}['und'][$delta]['value']['rdfs:type'] = $cvterm->name;
             }
           }

tripal_chado/includes/TripalFields/sio__vocabulary/sio__vocabulary_widget.inc

@@ -30,7 +30,7 @@ class sio__vocabulary_widget extends ChadoFieldWidget {
       // Use the bundle to get the cv_id choosen for this cvterm-based entity.
       // ASSUMPTION: the cv_id is saved as the "type_value" of the bundle.
       $bundle = tripal_load_bundle_entity(array('name' => $widget['#bundle']));
-      $cv = tripal_get_cv(array('cv_id' => $bundle->type_value));
+      $cv = chado_get_cv(array('cv_id' => $bundle->type_value));
 
       // Now populate the items array with defaults based on the cv.
       if ($cv) {

tripal_chado/includes/TripalFields/so__cds/so__cds.inc

@@ -81,7 +81,7 @@ class so__cds extends ChadoField {
 
     foreach($featurelocs as $featureloc){
       // Generate a CDS sequence if one exsits for this feature alignment.
-      $cds_sequence = tripal_get_feature_sequences(
+      $cds_sequence = chado_get_feature_sequences(
         array(
           'feature_id' => $feature->feature_id,
           'parent_id' => $featureloc->srcfeature_id->feature_id,
@@ -101,7 +101,7 @@ class so__cds extends ChadoField {
       );
 
       if (count($cds_sequence) > 0) {
-        // the tripal_get_feature_sequences() function can return multiple sequences
+        // the chado_get_feature_sequences() function can return multiple sequences
         // if a feature is aligned to multiple places. In the case of CDSs we expect
         // that one mRNA is only aligned to a single location on the assembly so we
         // can access the CDS sequence with index 0.

tripal_chado/includes/TripalFields/taxrank__infraspecific_taxon/taxrank__infraspecific_taxon.inc

@@ -61,8 +61,8 @@ class taxrank__infraspecific_taxon extends ChadoField {
     $field_term = $this->getFieldTermID();
 
     $label_term = 'rdfs:label';
-    $infraspecific_name_term = tripal_get_chado_semweb_term('organism', 'infraspecific_name');
-    $infraspecific_type_term = tripal_get_chado_semweb_term('organism', 'type_id');
+    $infraspecific_name_term = chado_get_semweb_term('organism', 'infraspecific_name');
+    $infraspecific_type_term = chado_get_semweb_term('organism', 'type_id');
 
     return array(
       $field_term => array(
@@ -115,8 +115,8 @@ class taxrank__infraspecific_taxon extends ChadoField {
 
     $field_term_id = $this->getFieldTermID();
     $label_term = $field_term_id . ',' . 'rdfs:label';
-    $infraspecific_name_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'infraspecific_name');
-    $infraspecific_type_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'type_id');
+    $infraspecific_name_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'infraspecific_name');
+    $infraspecific_type_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'type_id');
 
     if ($condition['column'] == $label_term or $condition['column'] == $field_term_id) {
       $this->queryJoinOnce($query, 'cvterm', $alias . '_cvterm', $alias . "_cvterm.cvterm_id = base.type_id");
@@ -138,8 +138,8 @@ class taxrank__infraspecific_taxon extends ChadoField {
 
     $field_term_id = $this->getFieldTermID();
     $label_term = $field_term_id . ',' . 'rdfs:label';
-    $infraspecific_name_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'infraspecific_name');
-    $infraspecific_type_term = $field_term_id . ',' . tripal_get_chado_semweb_term('organism', 'type_id');
+    $infraspecific_name_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'infraspecific_name');
+    $infraspecific_type_term = $field_term_id . ',' . chado_get_semweb_term('organism', 'type_id');
 
     if ($order['column'] == $infraspecific_name_term) {
       $query->orderBy('base.infraspecific_name', $order['direction']);
@@ -170,8 +170,8 @@ class taxrank__infraspecific_taxon extends ChadoField {
     }
 
     $label_term = 'rdfs:label';
-    $infraspecific_name_term = tripal_get_chado_semweb_term('organism', 'infraspecific_name');
-    $infraspecific_type_term = tripal_get_chado_semweb_term('organism', 'type_id');
+    $infraspecific_name_term = chado_get_semweb_term('organism', 'infraspecific_name');
+    $infraspecific_type_term = chado_get_semweb_term('organism', 'type_id');
 
     // Set some defaults for the empty record.
     $entity->{$field_name}['und'][0] = array(

tripal_chado/includes/TripalFields/taxrank__infraspecific_taxon/taxrank__infraspecific_taxon_formatter.inc

@@ -14,8 +14,8 @@ class taxrank__infraspecific_taxon_formatter extends ChadoFieldFormatter {
   public function view(&$element, $entity_type, $entity, $langcode, $items, $display) {
 
     $label_term = 'rdfs:label';
-    $infraspecific_name_term = tripal_get_chado_semweb_term('organism', 'infraspecific_name');
-    $infraspecific_type_term = tripal_get_chado_semweb_term('organism', 'type_id');
+    $infraspecific_name_term = chado_get_semweb_term('organism', 'infraspecific_name');
+    $infraspecific_type_term = chado_get_semweb_term('organism', 'type_id');
 
     if (is_array($items[0]['value']) and array_key_exists($infraspecific_name_term, $items[0]['value'])) {
       $infraspecific_name = $items[0]['value'][$infraspecific_name_term];

tripal_chado/includes/TripalFields/taxrank__infraspecific_taxon/taxrank__infraspecific_taxon_widget.inc

@@ -48,8 +48,8 @@ class taxrank__infraspecific_taxon_widget extends ChadoFieldWidget {
       '#value' =>  $infra_name,
     );
 
-    $cv = tripal_get_cv(array('name' => 'taxonomic_rank'));
-    $terms = tripal_get_cvterm_select_options($cv->cv_id);
+    $cv = chado_get_cv(array('name' => 'taxonomic_rank'));
+    $terms = chado_get_cvterm_select_options($cv->cv_id);
 
     // Unfortunately the taxonomic_rank vocabulary is not properly organized
     // such that we only include terms below 'species'. Therefore we will

tripal_chado/includes/TripalFields/uo__unit/uo__unit_widget.inc

@@ -31,8 +31,8 @@ class uo__unit_widget extends ChadoFieldWidget {
       '#type' => 'value',
       '#value' => array_key_exists($delta, $items) ? $items[$delta]['value'] : '',
     );
-    $cv = tripal_get_cv(array('name' => 'featuremap_units'));
-    $options = tripal_get_cvterm_select_options($cv->cv_id);
+    $cv = chado_get_cv(array('name' => 'featuremap_units'));
+    $options = chado_get_cvterm_select_options($cv->cv_id);
     unset($options[0]);
     $widget['chado-' . $field_table . '__unittype_id'] = array(
       '#type' => 'select',

tripal_chado/includes/TripalImporter/GFF3Importer.inc

@@ -902,7 +902,7 @@ class GFF3Importer extends TripalImporter {
             TGPT.feature_id, TGPT.fmin, TGPT.fmax, TGCT.strand, FLM.uniquename
         ";
         $results = chado_query($sql);
-        $protein_cvterm = tripal_get_cvterm(array(
+        $protein_cvterm = chado_get_cvterm(array(
           'name' => 'polypeptide',
           'cv_id' => array(
             'name' => 'sequence'
@@ -947,7 +947,7 @@ class GFF3Importer extends TripalImporter {
             $feature = $this->loadFeature($organism, $analysis_id,
                 $protein_cvterm, $uname, $name, '', 'f', 'f', 1, 0);
             // Add the derives_from relationship.
-            $cvterm = tripal_get_cvterm(array('cvterm_id' => $result->cvterm_id));
+            $cvterm = chado_get_cvterm(array('cvterm_id' => $result->cvterm_id));
             $this->loadDerivesFrom($feature, $cvterm,
                 $result->uniquename, $organism, $pfmin, $pfmax);
             // Add the featureloc record. Set the start of the protein to
@@ -1055,7 +1055,7 @@ class GFF3Importer extends TripalImporter {
     $result = chado_select_record('tripal_gff_temp', array('type_name'), $values);
     $type_id = NULL;
     if (count($result) > 0) {
-      $otype = tripal_get_cvterm(array(
+      $otype = chado_get_cvterm(array(
         'name' => $result[0]->type_name,
         'cv_id' => array(
           'name' => 'sequence'
@@ -1472,7 +1472,7 @@ class GFF3Importer extends TripalImporter {
         'cv_name' => $syncv->name,
         'is_relationship' => FALSE
       );
-      $syntype = tripal_insert_cvterm($term, array('update_existing' => TRUE));
+      $syntype = chado_insert_cvterm($term, array('update_existing' => TRUE));
       if (!$syntype) {
         $this->logMessage("Cannot add synonym type: internal:$type.", array(), TRIPAL_WARNING);
         return 0;
@@ -1912,7 +1912,7 @@ class GFF3Importer extends TripalImporter {
         'cv_name' => 'feature_property',
         'is_relationship' => FALSE
       );
-      $cvterm = (object) tripal_insert_cvterm($term, array('update_existing' => FALSE));
+      $cvterm = (object)chado_insert_cvterm($term, array('update_existing' => FALSE));
       if (!$cvterm) {
         $this->logMessage("Cannot add cvterm, $property.", array(), TRIPAL_WARNING);
         return 0;

tripal_chado/includes/TripalImporter/NewickImporter.inc

@@ -109,7 +109,7 @@ class NewickImporter extends TripalImporter {
     ];
 
     $type_cv = tripal_get_default_cv('phylotree', 'type_id');
-    $so_cv = tripal_get_cv(['name' => 'sequence']);
+    $so_cv = chado_get_cv(['name' => 'sequence']);
     $cv_id = $so_cv->cv_id;
     if (!$so_cv) {
       drupal_set_message('The Sequence Ontolgoy does not appear to be imported.
@@ -190,7 +190,7 @@ class NewickImporter extends TripalImporter {
     $errors = [];
     $warnings = [];
 
-    tripal_validate_phylotree('insert', $options, $errors, $warnings);
+    chado_validate_phylotree('insert', $options, $errors, $warnings);
 
     // Now set form errors if any errors were detected.
     if (count($errors) > 0) {
@@ -229,6 +229,6 @@ class NewickImporter extends TripalImporter {
     );
     $errors = array();
     $warnings = array();
-    tripal_insert_phylotree($options, $errors, $warnings);
+    chado_insert_phylotree($options, $errors, $warnings);
   }
 }

tripal_chado/includes/TripalImporter/OBOImporter.inc

@@ -409,18 +409,18 @@ class OBOImporter extends TripalImporter {
 
     // Update the cv_root_mview materiailzed view.
     $this->logMessage("Updating the cv_root_mview materialized view...");
-    $mview_id = tripal_get_mview_id('cv_root_mview');
-    tripal_populate_mview($mview_id);
+    $mview_id = chado_get_mview_id('cv_root_mview');
+    chado_populate_mview($mview_id);
 
     $this->logMessage("Updating the db2cv_mview materialized view...");
-    $mview_id = tripal_get_mview_id('db2cv_mview');
-    tripal_populate_mview($mview_id);
+    $mview_id = chado_get_mview_id('db2cv_mview');
+    chado_populate_mview($mview_id);
 
     // Upate the cvtermpath table for each newly added CV.
     $this->logMessage("Updating cvtermpath table.  This may take a while...");
     foreach ($this->newcvs as $namespace => $cvid) {
       $this->logMessage("- Loading paths for @vocab", array('@vocab' => $namespace));
-      tripal_update_cvtermpath($cvid);
+      chado_update_cvtermpath($cvid);
     }
   }
   /**
@@ -486,7 +486,7 @@ class OBOImporter extends TripalImporter {
    */
   private function loadOBO_v1_2_file($obo_name, $file, $is_new = TRUE) {
     if ($is_new) {
-      tripal_insert_obo($obo_name, $file);
+      chado_insert_obo($obo_name, $file);
     }
 
     $success = $this->loadOBO_v1_2($file, $obo_name);
@@ -528,7 +528,7 @@ class OBOImporter extends TripalImporter {
     fclose($obo_fh);
 
     if ($is_new) {
-      tripal_insert_obo($obo_name, $url);
+      chado_insert_obo($obo_name, $url);
     }
 
     // second, parse the OBO
@@ -568,7 +568,7 @@ class OBOImporter extends TripalImporter {
     // present for each stanza.  Some ontologies have adopted the v1.4 method
     // in their v1.2 files and not including it.
     if (array_key_exists('default-namespace', $header)) {
-      $defaultcv = tripal_insert_cv($header['default-namespace'][0], '');
+      $defaultcv = chado_insert_cv($header['default-namespace'][0], '');
       if (!$defaultcv) {
         throw new Exception('Cannot add namespace ' . $header['default-namespace'][0]);
       }
@@ -607,7 +607,7 @@ class OBOImporter extends TripalImporter {
         else {
           $results = $short_name;
         }
-        $defaultcv = tripal_insert_cv(strtoupper($results), '');
+        $defaultcv = chado_insert_cv(strtoupper($results), '');
         $this->newcvs[$defaultcv->name] = $defaultcv->cv_id;
       }
       catch (Exception $e) {
@@ -776,7 +776,7 @@ class OBOImporter extends TripalImporter {
         elseif (array_key_exists('namespace', $ontology_info['config'])) {
           $results = $ontology_info['config']['namespace'];
         }
-        $cv_returned = tripal_insert_cv($results[0], '');
+        $cv_returned = chado_insert_cv($results[0], '');
         // If name && definition are both empty then look up the term from the ontology you just loaded.
         if($cv_returned) {
           $defaultcv = $cv_returned;
@@ -790,7 +790,7 @@ class OBOImporter extends TripalImporter {
     $t['db_name'] = $default_db;
 
     // add the cvterm
-    $cvterm = tripal_insert_cvterm($t, array('update_existing' => TRUE));
+    $cvterm = chado_insert_cvterm($t, array('update_existing' => TRUE));
     if (!$cvterm) {
       throw new Exception("Cannot add the term " . $term['id'][0]);
     }
@@ -1001,7 +1001,7 @@ class OBOImporter extends TripalImporter {
       'is_relationship' => TRUE,
       'db_name' => $default_db
     );
-    $relcvterm = tripal_insert_cvterm($term, array('update_existing' => FALSE));
+    $relcvterm = chado_insert_cvterm($term, array('update_existing' => FALSE));
 
     if (!$relcvterm) {
       // If the relationship term couldn't be found in the default_db provided
@@ -1015,7 +1015,7 @@ class OBOImporter extends TripalImporter {
         'is_relationship' => TRUE,
         'db_name' => 'OBO_REL'
       );
-      $relcvterm = tripal_insert_cvterm($term, array('update_existing' => FALSE));
+      $relcvterm = chado_insert_cvterm($term, array('update_existing' => FALSE));
       if (!$relcvterm) {
         throw new Exception("Cannot find the relationship term in the current ontology or in the relationship ontology: $rel\n");
       }
@@ -1047,7 +1047,7 @@ class OBOImporter extends TripalImporter {
     $objterm['is_relationship'] = $object_is_relationship;
     $objterm['db_name'] = $default_db;
 
-    $objcvterm = tripal_insert_cvterm($objterm, array('update_existing' => TRUE));
+    $objcvterm = chado_insert_cvterm($objterm, array('update_existing' => TRUE));
     if (!$objcvterm) {
       throw new Exception("Cannot add cvterm " . $oterm['name'][0]);
     }
@@ -1100,7 +1100,7 @@ class OBOImporter extends TripalImporter {
   private function addSynonym($term, $cvterm) {
 
     // make sure we have a 'synonym_type' vocabulary
-    $syncv = tripal_insert_cv(
+    $syncv = chado_insert_cv(
         'synonym_type',
         'A local vocabulary added for synonym types.'
     );
@@ -1124,7 +1124,7 @@ class OBOImporter extends TripalImporter {
             'name' => 'synonym_type',
           ),
         );
-        $syntype = tripal_get_cvterm($values);
+        $syntype = chado_get_cvterm($values);
 
         // if it doesn't exist then add it
         if (!$syntype) {
@@ -1137,7 +1137,7 @@ class OBOImporter extends TripalImporter {
             'cv_name' => $syncv->name,
             'is_relationship' => FALSE
           );
-          $syntype = tripal_insert_cvterm($term, array('update_existing' => TRUE));
+          $syntype = chado_insert_cvterm($term, array('update_existing' => TRUE));
           if (!$syntype) {
             throw new Exception("Cannot add synonym type: internal:$scope");
           }
@@ -1324,7 +1324,7 @@ class OBOImporter extends TripalImporter {
     }
 
     // add the database
-    $db = tripal_insert_db(array('name' => $dbname));
+    $db = chado_insert_db(array('name' => $dbname));
     if (!$db) {
       throw new Exception("Cannot find database '$dbname' in Chado.");
     }
@@ -1369,7 +1369,7 @@ class OBOImporter extends TripalImporter {
   private function addCvtermProp($cvterm, $property, $value, $rank) {
 
     // make sure the 'cvterm_property_type' CV exists
-    $cv = tripal_insert_cv('cvterm_property_type', '');
+    $cv = chado_insert_cv('cvterm_property_type', '');
     if (!$cv) {
       throw new Exception("Cannot add/find cvterm_property_type cvterm");
     }
@@ -1389,7 +1389,7 @@ class OBOImporter extends TripalImporter {
         'cv_name' => $cv->name,
         'is_relationship' => FALSE,
       );
-      $cvproptype = tripal_insert_cvterm($term, array('update_existing' => FALSE));
+      $cvproptype = chado_insert_cvterm($term, array('update_existing' => FALSE));
       if (!$cvproptype) {
         throw new Exception("Cannot add cvterm property: internal:$property");
       }

tripal_chado/includes/TripalImporter/TaxonomyImporter.inc

@@ -256,7 +256,7 @@ class TaxonomyImporter extends TripalImporter {
 
     // Now import the tree.
     $options = array('taxonomy' => 1);
-    tripal_phylogeny_import_tree($this->tree, $this->phylotree, $options);
+    chado_phylogeny_import_tree($this->tree, $this->phylotree, $options);
   }
 
 
@@ -312,7 +312,7 @@ class TaxonomyImporter extends TripalImporter {
     $lineage_nodes[] = array();
 
     // Get the "rank" cvterm. It requires that the TAXRANK vocabulary is loaded.
-    $rank_cvterm = tripal_get_cvterm(array(
+    $rank_cvterm = tripal_chado_get_cvtermget_cvterm(array(
       'name' => 'rank',
       'cv_id' => array('name' => 'local')
     ));
@@ -332,7 +332,7 @@ class TaxonomyImporter extends TripalImporter {
     $total = count($this->all_orgs);
     $j = 1;
     foreach ($this->all_orgs as $organism) {
-      $sci_name =  tripal_get_organism_scientific_name($organism);
+      $sci_name = chado_get_organism_scientific_name($organism);
       //$this->logMessage("- " . ($j++) . " of $total. Adding @organism", array('@organism' => $sci_name));
 
       // First get the phylonode record for this organism.
@@ -433,7 +433,7 @@ class TaxonomyImporter extends TripalImporter {
       }
 
       // Now add in the leaf node
-      $sci_name = tripal_get_organism_scientific_name($organism);
+      $sci_name = chado_get_organism_scientific_name($organism);
       $node = array(
         'name' => $sci_name,
         'depth' => $i,
@@ -451,7 +451,7 @@ class TaxonomyImporter extends TripalImporter {
       $this->addTaxonomyNode($tree, $node, $lineage_depth);
 
       // Set the indecies for the tree.
-      tripal_assign_phylogeny_tree_indices($tree);
+      chado_assign_phylogeny_tree_indices($tree);
     }
 
     return $tree;
@@ -473,7 +473,7 @@ class TaxonomyImporter extends TripalImporter {
       // if so we should use that instead of the scientific name.
 
       // Build the query string to get the information about this species.
-      $sci_name = tripal_get_organism_scientific_name($organism);
+      $sci_name = chado_get_organism_scientific_name($organism);
       $sci_name = urlencode($sci_name);
       $search_url = "http://www.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi?".
           "db=taxonomy" .
@@ -561,7 +561,7 @@ class TaxonomyImporter extends TripalImporter {
     // Second, check if the full name includes the infraspecific name.
     if (!$organism) {
       foreach ($this->all_orgs as $item) {
-        $internal_sci_name = tripal_get_organism_scientific_name($item);
+        $internal_sci_name = chado_get_organism_scientific_name($item);
         if ($sci_name == $internal_sci_name) {
           $organism = $item;
         }
@@ -594,13 +594,13 @@ class TaxonomyImporter extends TripalImporter {
       $infra = $matches[3];
 
       // Get the CV term for the rank.
-      $type = tripal_get_cvterm(array(
+      $type = chado_get_cvterm(array(
         'name' => preg_replace('/ /','_', $rank),
         'cv_id' => array('name' => 'taxonomic_rank')
       ));
 
       // Remove the rank from the infraspecific name.
-      $abbrev = tripal_abbreviate_infraspecific_rank($rank);
+      $abbrev = chado_abbreviate_infraspecific_rank($rank);
       $infra = preg_replace("/$abbrev/", "", $infra);
       $infra = trim($infra);
 
@@ -648,7 +648,7 @@ class TaxonomyImporter extends TripalImporter {
     $adds_organism = $organism ? FALSE : TRUE;
 
     // Get the "rank" cvterm. It requires that the TAXRANK vocabulary is loaded.
-    $rank_cvterm = tripal_get_cvterm(array(
+    $rank_cvterm = chado_get_cvterm(array(
       'name' => 'rank',
       'cv_id' => array('name' => 'local')
     ));
@@ -795,7 +795,7 @@ class TaxonomyImporter extends TripalImporter {
       $this->addTaxonomyNode($this->tree, $node, $lineage_depth);
 
       // Set the indecies for the tree.
-      tripal_assign_phylogeny_tree_indices($this->tree);
+      chado_assign_phylogeny_tree_indices($this->tree);
     }
   }
   /**
@@ -901,12 +901,12 @@ class TaxonomyImporter extends TripalImporter {
    * @param unknown $taxId
    */
   private function addDbxref($organism_id, $taxId) {
-    $db = tripal_get_db(array('name' => 'NCBITaxon'));
+    $db = chado_get_db(array('name' => 'NCBITaxon'));
     $values = array(
       'db_id' => $db->db_id,
       'accession' => $taxId
     );
-    $dbxref = tripal_insert_dbxref($values);
+    $dbxref = chado_insert_dbxref($values);
 
     $values = array(
       'dbxref_id' => $dbxref->dbxref_id,

tripal_chado/includes/exporters/tripal_chado.seq_extract.inc

@@ -34,7 +34,7 @@ function tripal_chado_seq_extract_page() {
       drupal_add_http_header('Content-Disposition: attachment; filename="sequences.fasta.txt"');
     }
 
-    tripal_get_bulk_feature_sequences(array(
+    chado_get_bulk_feature_sequences(array(
       'genus' => $genus,
       'species' => $species,
       'analysis_name' => $analysis,

tripal_chado/includes/loaders/tripal_chado.pub_importer_AGL.inc

@@ -927,7 +927,7 @@ function tripal_pub_AGL_parse_pubxml($pub_xml) {
   $pub['Author List'] = $newauths;
 
   // build the citation
-  $pub['Citation'] = tripal_pub_create_citation($pub);
+  $pub['Citation'] = chado_pub_create_citation($pub);
 
   $pub['raw'] = $pub_xml;
 

tripal_chado/includes/loaders/tripal_chado.pub_importer_PMID.inc

@@ -436,7 +436,7 @@ function tripal_pub_PMID_parse_pubxml($pub_xml) {
       }
     }
   }
-  $pub['Citation'] = tripal_pub_create_citation($pub);
+  $pub['Citation'] = chado_pub_create_citation($pub);
 
   $pub['raw'] = $pub_xml;
   return $pub;
@@ -619,7 +619,7 @@ function tripal_pub_PMID_parse_publication_type($xml, &$pub) {
             )
           );
           $options = array('case_insensitive_columns' => array('name'));
-          $pub_cvterm = tripal_get_cvterm($identifiers, $options);
+          $pub_cvterm = chado_get_cvterm($identifiers, $options);
           if (!$pub_cvterm) {
             // see if this we can find the name using a synonym
             $identifiers = array(
@@ -628,7 +628,7 @@ function tripal_pub_PMID_parse_publication_type($xml, &$pub) {
                 'cv_name' => 'tripal_pub'
               )
             );
-            $pub_cvterm = tripal_get_cvterm($identifiers, $options);
+            $pub_cvterm = chado_get_cvterm($identifiers, $options);
             if (!$pub_cvterm) {
               tripal_report_error('tripal_pubmed', TRIPAL_ERROR,
                 'Cannot find a valid vocabulary term for the publication type: "%term".',

tripal_chado/includes/loaders/tripal_chado.pub_importers.inc

@@ -979,7 +979,7 @@ function tripal_pub_add_publication($pub_details, &$action, $do_contact = FALSE,
 
   // before proceeding check to see if the publication already exists. If there is only one match
   // and the $update_if_exists is NOT set then return FALSE
-  $pub_ids = tripal_publication_exists($pub_details);
+  $pub_ids = chado_publication_exists($pub_details);
 
   if(count($pub_ids) == 1 and !$update_if_exists) {
     tripal_report_error('tripal_pub', TRIPAL_NOTICE,
@@ -1031,7 +1031,7 @@ function tripal_pub_add_publication($pub_details, &$action, $do_contact = FALSE,
         'name' => 'tripal_pub'
       ),
     );
-    $pub_type = tripal_get_cvterm($identifiers);
+    $pub_type = chado_get_cvterm($identifiers);
   }
   else {
     tripal_report_error('tripal_pub', TRIPAL_ERROR,
@@ -1125,10 +1125,10 @@ function tripal_pub_add_publication($pub_details, &$action, $do_contact = FALSE,
         'name' => 'tripal_pub'
       ),
     );
-    $cvterm = tripal_get_cvterm($identifiers);
+    $cvterm = chado_get_cvterm($identifiers);
 
     // if we could not find the cvterm by name then try by synonym
-    //$cvterm = tripal_get_cvterm(array('name' => $key, 'cv_id' => array('name' => 'tripal_pub')));
+    //$cvterm = chado_get_cvterm(array('name' => $key, 'cv_id' => array('name' => 'tripal_pub')));
     if (!$cvterm) {
       $identifiers = array(
         'synonym' => array(
@@ -1136,7 +1136,7 @@ function tripal_pub_add_publication($pub_details, &$action, $do_contact = FALSE,
           'cv_name' => 'tripal_pub'
         )
       );
-      $cvterm = tripal_get_cvterm($identifiers);
+      $cvterm = chado_get_cvterm($identifiers);
     }
     if (!$cvterm) {
       tripal_report_error('tripal_pub', TRIPAL_ERROR, "Cannot find term: '%prop'. Skipping.", array('%prop' => $key));
@@ -1257,7 +1257,7 @@ function tripal_pub_add_authors($pub_id, $authors, $do_contact) {
     // if the user wants us to create a contact for each author then do it.
     if ($do_contact) {
       // Add the contact
-      $contact = tripal_insert_contact(array(
+      $contact = chado_insert_contact(array(
         'name' => $name,
         'description' => '',
         'type_name' => $type,
@@ -1695,5 +1695,5 @@ function tripal_pub_citation_form($form, &$form_state) {
  */
 function tripal_pub_citation_form_submit(&$form_state) {
   $options [0] = $form_state['options']['#value'];
-  tripal_add_job("Create citations ($options[0])", 'tripal_pub', 'tripal_pub_create_citations', $options, $user->uid);
+  tripal_add_job("Create citations ($options[0])", 'tripal_pub', 'chado_pub_create_citations', $options, $user->uid);
 }

tripal_chado/includes/loaders/tripal_cv.owl_loader.php

@@ -132,7 +132,7 @@ function tripal_cv_parse_owl($filename) {
   );
 
   // Using the Tripal API function to insert the term into the Chado database.
-  $db = tripal_insert_db($db);
+  $db = chado_insert_db($db);
 
   // Get the description for this vocabulary. This should be in the
   // dc:description element. If that element is missing then the
@@ -156,7 +156,7 @@ function tripal_cv_parse_owl($filename) {
   }
 
   // Insert the CV record into Chado.
-  $cv = tripal_insert_cv($cv_name, $cv_description);
+  $cv = chado_insert_cv($cv_name, $cv_description);
 
   // Add this CV and DB to our vocabs array so we can reuse it later.
   $vocabs[$db_name]['cv'] = $namespace_cv;
@@ -343,13 +343,13 @@ function tripal_owl_handle_annotation_property($stanza, $vocabs) {
 //     $values = array(
 //       'name' => $db_name
 //     );
-//     $db = tripal_insert_db($values);
+//     $db = chado_insert_db($values);
 // // Insert a dbxref record.
 //   $values = array(
 //     'db_id' => $db->db_id,
 //     'accession' => $accession
 //   );
-//   $dbxref = tripal_insert_dbxref($values);
+//   $dbxref = chado_insert_dbxref($values);
 
 //   $imported_from = $stanza->getChild('obo:IAO_0000114');
 //     if ($imported_from == NULL) {
@@ -385,7 +385,7 @@ function tripal_owl_handle_annotation_property($stanza, $vocabs) {
 //   if ($vocabs['this'] != $db->name){
 //   	$option['update_existing'] = FALSE;
 //   }
-//   $cvterm = tripal_insert_cvterm($term, $option);
+//   $cvterm = chado_insert_cvterm($term, $option);
 // }
 }
 /**
@@ -453,7 +453,7 @@ function tripal_owl_handle_class(OWLStanza $stanza, $vocabs) {
     'db_id' => $db->db_id,
     'accession' => $accession
   );
-  $dbxref = tripal_insert_dbxref($values);
+  $dbxref = chado_insert_dbxref($values);
 
   $cvterm_name = $stanza->getChild('rdfs:label');
   if ($cvterm_name) {
@@ -476,7 +476,7 @@ function tripal_owl_handle_class(OWLStanza $stanza, $vocabs) {
   if ($vocabs['this'] != $db->name) {
   $options['update_existing'] = FALSE;
   }
-  $cvterm = tripal_insert_cvterm($term, $options);
+  $cvterm = chado_insert_cvterm($term, $options);
 
   // // Add a record to the chado relationship table if an ‘rdfs:subClassOf’ child exists.
 
@@ -506,5 +506,5 @@ function tripal_owl_handle_class(OWLStanza $stanza, $vocabs) {
   // if ($vocabs['this'] != $db->name) {
   // $option['update_existing'] = FALSE;
   // }
-  // $cvterm = tripal_insert_cvterm($term, $option);
+  // $cvterm = chado_insert_cvterm($term, $option);
   }

tripal_chado/includes/setup/tripal_chado.chado_vx_x.inc

@@ -205,7 +205,7 @@ function tripal_chado_add_organism_stock_count_mview() {
         O.Organism_id, O.genus, O.species, O.common_name, CVT.cvterm_id, CVT.name
   ";
 
-  tripal_add_mview($view_name, 'tripal_stock', $schema, $sql, $comment, FALSE);
+  chado_add_mview($view_name, 'tripal_stock', $schema, $sql, $comment, FALSE);
 }
 
 
@@ -261,7 +261,7 @@ function tripal_chado_add_library_feature_count_mview(){
     GROUP BY L.library_id, L.name, CVT.name
   ";
 
-  tripal_add_mview($view_name, 'tripal_library', $schema, $sql, $comment, FALSE);
+  chado_add_mview($view_name, 'tripal_library', $schema, $sql, $comment, FALSE);
 }
 
 
@@ -344,7 +344,7 @@ function tripal_chado_add_organism_feature_count_mview() {
         O.Organism_id, O.genus, O.species, O.common_name, CVT.cvterm_id, CVT.name
   ";
 
-  tripal_add_mview($view_name, 'tripal_feature', $schema, $sql, $comment, FALSE);
+  chado_add_mview($view_name, 'tripal_feature', $schema, $sql, $comment, FALSE);
 }
 
 
@@ -404,7 +404,7 @@ function tripal_chado_add_analysis_organism_mview() {
   );
 
   // add the view
-  tripal_add_mview($view_name, 'tripal_analysis', $schema, $sql, $comment, FALSE);
+  chado_add_mview($view_name, 'tripal_analysis', $schema, $sql, $comment, FALSE);
 }
 
 /**
@@ -463,7 +463,7 @@ function tripal_chado_add_db2cv_mview_mview() {
   ";
 
   // Create the MView
-  tripal_add_mview($mv_name, 'tripal_chado', $schema, $sql, $comment, FALSE);
+  chado_add_mview($mv_name, 'tripal_chado', $schema, $sql, $comment, FALSE);
 }
 /**
  * Add a materialized view of root terms for all chado cvs.
@@ -515,6 +515,6 @@ function tripal_chado_add_cv_root_mview_mview() {
   ";
 
   // Create the MView
-  tripal_add_mview($mv_name, 'tripal_chado', $schema, $sql, $comment, FALSE);
+  chado_add_mview($mv_name, 'tripal_chado', $schema, $sql, $comment, FALSE);
 }
 

tripal_chado/includes/setup/tripal_chado.setup.inc

@@ -133,11 +133,11 @@ function tripal_chado_load_ontologies() {
 
   module_load_include('inc', 'tripal_chado', 'includes/TripalImporter/OBOImporter');
   for ($i = 0; $i < count($ontologies); $i++) {
-    $obo_id = tripal_insert_obo($ontologies[$i]['name'], $ontologies[$i]['path']);
+    $obo_id = chado_insert_obo($ontologies[$i]['name'], $ontologies[$i]['path']);
     if ($ontologies[$i]['auto_load'] == TRUE) {
       // Only load ontologies that are not already in the cv table.
-      $cv = tripal_get_cv(array('name' => $ontologies[$i]['cv_name']));
-      $db = tripal_get_db(array('name' => $ontologies[$i]['db_name']));
+      $cv = chado_get_cv(array('name' => $ontologies[$i]['cv_name']));
+      $db = chado_get_db(array('name' => $ontologies[$i]['db_name']));
       if (!$cv or !$db) {
         print "Loading ontology: " . $ontologies[$i]['name'] . " ($obo_id)...\n";
         $obo_importer = new OBOImporter();
@@ -207,12 +207,12 @@ function tripal_chado_prepare_chado($job = NULL) {
 
     // Populate the mviews based on controlled vocabularies.
     drush_print('Populating materialized view db2cv_mview...');
-    $mview_id = tripal_get_mview_id('db2cv_mview');
-    tripal_populate_mview($mview_id);
+    $mview_id = chado_get_mview_id('db2cv_mview');
+    chado_populate_mview($mview_id);
 
     drush_print('Populating materialized view cv_root_mview...');
-    $mview_id = tripal_get_mview_id('cv_root_mview');
-    tripal_populate_mview($mview_id);
+    $mview_id = chado_get_mview_id('cv_root_mview');
+    chado_populate_mview($mview_id);
 
     if ($report_progress) {
       $job->setProgress(50);
@@ -335,7 +335,7 @@ function tripal_chado_prepare_chado($job = NULL) {
       'cv_id' => array('name' => 'EDAM'),
       'name' => 'Map'
     );
-    $cvterm = tripal_get_cvterm($identifier);
+    $cvterm = chado_get_cvterm($identifier);
     tripal_chado_add_cvterm_mapping($cvterm->cvterm_id, 'featuremap', NULL);
     if ($report_progress) {
       $job->setProgress(86);
@@ -343,7 +343,7 @@ function tripal_chado_prepare_chado($job = NULL) {
 
     // Import a publication so we get all of the properties before
     // creating the content type.
-    tripal_import_pub_by_dbxref('PMID:24163125');
+    chado_import_pub_by_dbxref('PMID:24163125');
 
     // Create the 'Publication' entity type.
     $error = '';
@@ -370,7 +370,7 @@ function tripal_chado_prepare_chado($job = NULL) {
       'cv_id' => array('name' => 'tripal_pub'),
       'name' => 'Publication'
     );
-    $cvterm = tripal_get_cvterm($identifier);
+    $cvterm = chado_get_cvterm($identifier);
     tripal_chado_add_cvterm_mapping($cvterm->cvterm_id, 'pub', NULL);
 
     // Now remove the publication that was added above.

tripal_chado/includes/tripal_chado.cv.inc

@@ -663,7 +663,7 @@ function tripal_cv_cvterm_edit_form_submit($form, &$form_state) {
       'db_name' => $db->name
     );
 
-    $cvterm = tripal_insert_cvterm($term, array('update_existing' => TRUE));
+    $cvterm = chado_insert_cvterm($term, array('update_existing' => TRUE));
     if ($cvterm) {
       drupal_set_message('Term updated successfully.');
       drupal_goto('admin/tripal/loaders/chado_vocabs/chado_cvterms');
@@ -721,7 +721,7 @@ function tripal_cv_cvterm_add_form_submit($form, &$form_state) {
     'db_name' => $db->name
   );
 
-  $cvterm = tripal_insert_cvterm($term, array('update_existing' => TRUE));
+  $cvterm = chado_insert_cvterm($term, array('update_existing' => TRUE));
   if ($cvterm) {
     drupal_set_message('Term added successfully.');
   }
@@ -809,7 +809,7 @@ function tripal_cv_cvtermpath_form_submit($form, &$form_state) {
   $job_args = array($cvid);
   if ($form_state['values']['op'] == t('Update cvtermpath')) {
     tripal_add_job("Update cvtermpath: $cv->name", 'tripal_cv',
-        'tripal_update_cvtermpath', $job_args, $user->uid, 10);
+        'chado_update_cvtermpath', $job_args, $user->uid, 10);
   }
 }
 
@@ -818,7 +818,7 @@ function tripal_cv_cvtermpath_form_submit($form, &$form_state) {
  */
 function tripal_cv_cv_delete_form($form, &$form_state, $cv_id) {
 
-  $cv = tripal_get_cv(array('cv_id' => $cv_id));
+  $cv = chado_get_cv(array('cv_id' => $cv_id));
 
   $form['cv_id'] = array(
     '#type' => 'value',

tripal_chado/includes/tripal_chado.field_storage.inc

@@ -29,8 +29,8 @@ function tripal_chado_field_storage_write($entity_type, $entity, $op, $fields) {
   $term = reset($term);
 
   // Convert the Tripal term entity into the appropriate record in Chado.
-  $dbxref = tripal_get_dbxref(array('accession' => $term->accession, 'db_id' => array('name' => $term->vocab->vocabulary)));
-  $cvterm = tripal_get_cvterm(array('dbxref_id' => $dbxref->dbxref_id));
+  $dbxref = chado_get_dbxref(array('accession' => $term->accession, 'db_id' => array('name' => $term->vocab->vocabulary)));
+  $cvterm = chado_get_cvterm(array('dbxref_id' => $dbxref->dbxref_id));
 
   // Get the base table, type field and record_id from the entity.
   $base_table = $entity->chado_table;
@@ -533,7 +533,7 @@ function tripal_chado_field_storage_query($query) {
         if ($chado_table == $base_table) {
           // Get the base table column that is associated with the term
           // passed as $condition['column'].
-          $base_field = tripal_get_chado_semweb_column($chado_table, $condition['column']);
+          $base_field = chado_get_semweb_column($chado_table, $condition['column']);
 
           $matches = array();
           $key = $condition['value'];
@@ -699,7 +699,7 @@ function tripal_chado_field_storage_query($query) {
         else {
           $base_table = $instance['settings']['base_table'];
           $chado_table = $instance['settings']['chado_table'];
-          $table_column = tripal_get_chado_semweb_column($chado_table, $column);
+          $table_column = chado_get_semweb_column($chado_table, $column);
           if ($table_column) {
              if ($chado_table == $base_table) {
                $cquery->orderBy('base.' . $table_column, $direction);
@@ -1179,7 +1179,7 @@ function tripal_chado_field_storage_bundle_mapping_form_add_cvterm(&$form,
     ),
   );
   if ($default['use_cvterm'] == 'cv') {
-    $cvs = tripal_get_cv_select_options();
+    $cvs = chado_get_cv_select_options();
     $form['chado_type_cv_id'] = array(
       '#type' => select,
       '#options' => $cvs,

tripal_chado/includes/tripal_chado.fields.inc

@@ -92,7 +92,7 @@ function tripal_chado_bundle_fields_info_base(&$info, $details, $entity_type, $b
     if ($column_name == $pkey or $column_name == $type_column) {
       continue;
     }
-    $cvterm = tripal_get_chado_semweb_term($table_name, $column_name, array('return_object' => TRUE));
+    $cvterm = chado_get_semweb_term($table_name, $column_name, array('return_object' => TRUE));
     if (!$cvterm) {
       tripal_report_error('tripal', TRIPAL_ERROR,
         'Cannot create field for "%table_name.%column_name". Missing an appropriate vocabulary term',
@@ -822,7 +822,7 @@ function tripal_chado_bundle_instances_info_base(&$info, $entity_type, $bundle,
       continue;
     }
 
-    $cvterm = tripal_get_chado_semweb_term($table_name, $column_name, array('return_object' => TRUE));
+    $cvterm = chado_get_semweb_term($table_name, $column_name, array('return_object' => TRUE));
     if (!$cvterm) {
       // We already provided an error when creating the base field.  So
       // don't create another one here.

tripal_chado/includes/tripal_chado.install.inc

@@ -404,7 +404,7 @@ function tripal_chado_upgrade_chado_1_2_to_1_3_pre_alter() {
   );
 
   // Get the name of the chado schema.
-  $chado_schema = tripal_get_schema_name('chado');
+  $chado_schema = chado_get_schema_name('chado');
 
   // Iterate through the new Chado tables and create them or if they already
   // exist then update them.
@@ -531,7 +531,7 @@ function tripal_chado_upgrade_chado_1_11_to_1_2() {
 function tripal_chado_reset_chado_schema() {
 
   // determine the schema name.
-  $chado_schema = tripal_get_schema_name('chado');
+  $chado_schema = chado_get_schema_name('chado');
   $chado_dot = $chado_schema . '.';
 
   // drop current chado and chado-related schema
@@ -588,7 +588,7 @@ function tripal_chado_install_sql($sql_file) {
   $chado_local = chado_dbschema_exists('chado');
 
   // determine the schema name.
-  $chado_schema = tripal_get_schema_name('chado');
+  $chado_schema = chado_get_schema_name('chado');
   $chado_dot = $chado_schema . '.';
 
   if ($chado_local) {
@@ -814,6 +814,6 @@ function tripal_chado_install_sql($sql_file) {
  */
 function tripal_chado_install_done() {
 
-  $drupal_schema = tripal_get_schema_name('drupal');
+  $drupal_schema = chado_get_schema_name('drupal');
   db_query("set search_path to $drupal_schema");
 }

tripal_chado/includes/tripal_chado.migrate.inc

@@ -746,7 +746,7 @@ function tripal_chado_migrate_selected_types($tv3_content_types) {
       'sync_node' => 1,
       'bundle_name' => $bundle_name
     );
-    tripal_chado_publish_records($value);
+    chado_publish_records($value);
 
     // Migrate Resource Titles/Blocks or Resource Links if available
     tripal_chado_migrate_resource_blocks($bundle_name);

tripal_chado/includes/tripal_chado.mviews.inc

@@ -572,7 +572,7 @@ function tripal_mviews_form_submit($form, &$form_state) {
 
   // if this is an edit action
   if (strcmp($action, 'Edit') == 0) {
-    tripal_edit_mview($mview_id, $name, $modulename, $mv_table, $mv_specs,
+    chado_edit_mview($mview_id, $name, $modulename, $mv_table, $mv_specs,
       $indexed, $query, $special_index, $comment, $schema);
   }
   // else an add action
@@ -633,7 +633,7 @@ function tripal_mviews_delete_form_submit($form, &$form_state) {
   $mview_id = $form_state['values']['mview_id'];
 
   if (strcmp($action, 'Delete') == 0) {
-    tripal_delete_mview($mview_id);
+    chado_delete_mview($mview_id);
   }
   else {
     drupal_set_message(t("No action performed."));
@@ -642,13 +642,13 @@ function tripal_mviews_delete_form_submit($form, &$form_state) {
 }
 
 /**
- * A wrapper for the tripal_refresh_mview() API function, which
+ * A wrapper for the chado_refresh_mview() API function, which
  * then redirects back to the admin page for mviews.
  *
  * @param $mview_id
  */
 function tripal_mviews_add_populate_job($mview_id) {
 
-  tripal_refresh_mview($mview_id);
+  chado_refresh_mview($mview_id);
   drupal_goto("admin/tripal/storage/chado/mviews");
 }

tripal_chado/includes/tripal_chado.publish.inc

@@ -170,7 +170,7 @@ function tripal_chado_publish_form_submit($form, &$form_state) {
       module_load_include('inc', 'tripal_chado', 'includes/tripal_chado.publish'),
     );
     return tripal_add_job("Publish " . $bundle->label . " records.",
-       'tripal_chado', 'tripal_chado_publish_records', $args,
+       'tripal_chado', 'chado_publish_records', $args,
        $user->uid, 10, $includes);
   }
 }

tripal_chado/includes/tripal_chado.seq_extract.inc

@@ -43,7 +43,7 @@ function tripal_chado_feature_seq_extract_download() {
     header('Content-Disposition: attachment; filename="sequences.fnn"');
   }
 
-  $seqs = tripal_get_bulk_feature_sequences(array(
+  $seqs = chado_get_bulk_feature_sequences(array(
     'genus' => $genus,
     'species' => $species,
     'analysis_name' => $analysis,

tripal_chado/includes/tripal_chado.vocab_storage.inc

@@ -298,7 +298,7 @@ function _tripal_chado_format_term_description($cvterm) {
     'vocabulary' => $vocabulary,
     'accession'  => $cvterm->dbxref_id->accession,
     'name'       => $cvterm->name,
-    'url'        => tripal_get_dbxref_url($cvterm->dbxref_id),
+    'url'        => chado_get_dbxref_url($cvterm->dbxref_id),
     'definition' => (isset($cvterm->definition)) ? $cvterm->definition : '',
   );
   return $term;
@@ -327,11 +327,11 @@ function tripal_chado_vocab_add_term($details) {
     // TODO: deal with the URL prefix
   );
   $options = array('update_existing' => TRUE);
-  tripal_insert_db($values, $options);
+  chado_insert_db($values, $options);
 
 
   // Second make sure the term is added.
-  $term = tripal_insert_cvterm(array(
+  $term = chado_insert_cvterm(array(
     'id' => $vocabulary . ':' . $accession,
     'name' => $details['name'],
     'definition' => $details['definition'],

tripal_chado/tripal_chado.drush.inc

@@ -143,10 +143,10 @@ function drush_tripal_chado_trp_import_pubs() {
 
   module_load_include('inc', 'tripal_chado', 'includes/loaders/tripal_chado.pub_importers');
   if ($dbxref) {
-    tripal_import_pub_by_dbxref($dbxref, $create_contacts, $update);
+    chado_import_pub_by_dbxref($dbxref, $create_contacts, $update);
   }
   else {
-    tripal_execute_active_pub_importers($do_report, $update);
+    chado_execute_active_pub_importers($do_report, $update);
   }
 }
 
@@ -161,7 +161,7 @@ function drush_tripal_chado_trp_update_pubs() {
   $db = drush_get_option('db');
 
   module_load_include('inc', 'tripal_chado', 'includes/loaders/tripal_chado.pub_importers');
-  tripal_reimport_publications($create_contacts, $dbxref, $db);
+  chado_reimport_publications($create_contacts, $dbxref, $db);
 }
 
 /**
@@ -217,7 +217,7 @@ function drush_tripal_chado_trp_refresh_mview() {
   }
 
   drush_print('Updating the Materialized View with ID=' . $mview_id);
-  $status = tripal_populate_mview($mview_id);
+  $status = chado_populate_mview($mview_id);
   if ($status) {
     drush_log('Materialized View Updated', 'ok');
   }

tripal_chado/tripal_chado.install

@@ -13,7 +13,7 @@ function tripal_chado_install() {
   if (chado_is_installed()) {
     // For an upgraded site we need to move some vocabulary terms over
     // to the new 'local' vocabulary:
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'local',
       'description' => variable_get('site_name', 'This site.'),
     ));
@@ -697,13 +697,13 @@ function tripal_chado_update_7300() {
       chado_query("ALTER TABLE {tripal_gffcds_temp} ALTER COLUMN phase DROP NOT NULL;");
     }
 
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'data:1048',
       'name' => 'Database ID',
       'cv_name' => 'EDAM',
       'definition' => 'An identifier of a biological or bioinformatics database.',
     ));
-    tripal_associate_chado_semweb_term('db', 'name', $term);
+    chado_associate_semweb_term('db', 'name', $term);
   }
   catch (\PDOException $e) {
     $error = $e->getMessage();
@@ -762,25 +762,25 @@ function tripal_chado_update_7301() {
 function tripal_chado_update_7302(){
   try {
     // Add the term for the field.
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'format',
       'description' => 'A defined way or layout of representing and structuring data in a computer file, blob, string, message, or elsewhere. The main focus in EDAM lies on formats as means of structuring data exchanged between different tools or resources. ',
       'url' => 'http://edamontology.org/page',
       'urlprefix' => 'http://edamontology.org/{db}_{accession}',
     ));
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'operation',
       'description' => 'A function that processes a set of inputs and results in a set of outputs, or associates arguments (inputs) with values (outputs). Special cases are: a) An operation that consumes no input (has no input arguments).',
       'url' => 'http://edamontology.org/page',
       'urlprefix' => 'http://edamontology.org/{db}_{accession}',
     ));
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'topic',
       'description' => 'A category denoting a rather broad domain or field of interest, of study, application, work, data, or technology. Topics have no clearly defined borders between each other.',
       'url' => 'http://edamontology.org/page',
       'urlprefix' => 'http://edamontology.org/{db}_{accession}',
     ));
-    tripal_insert_cv(
+    chado_insert_cv(
       'EDAM',
       'EDAM is an ontology of well established, familiar concepts that are prevalent within bioinformatics, including types of data and data identifiers, data formats, operations and topics. EDAM is a simple ontology - essentially a set of terms with synonyms and definitions - organised into an intuitive hierarchy for convenient use by curators, software developers and end-users. EDAM is suitable for large-scale semantic annotations and categorization of diverse bioinformatics resources. EDAM is also suitable for diverse application including for example within workbenches and workflow-management systems, software distributions, and resource registries.'
     );
@@ -815,20 +815,20 @@ function tripal_chado_update_7303() {
  */
 function tripal_chado_update_7304() {
   try {
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'SIO:001080',
       'name' => 'vocabulary',
       'cv_name' => 'SIO',
       'definition' => 'A vocabulary is a collection of terms.',
     ));
-    tripal_associate_chado_semweb_term('cvterm', 'cv_id', $term);
-    $term = tripal_insert_cvterm(array(
+    chado_associate_semweb_term('cvterm', 'cv_id', $term);
+    $term = chado_insert_cvterm(array(
       'id' => 'data:2976',
       'name' => 'Protein sequence',
       'cv_name' => 'EDAM',
       'definition' => 'One or more protein sequences, possibly with associated annotation.',
     ));
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'local:fmin',
       'name' => 'minimal boundary',
       'definition' => 'The leftmost, minimal boundary in the linear range ' .
@@ -837,8 +837,8 @@ function tripal_chado_update_7304() {
       'represent the 5-prime coordinate.',
       'cv_name' => 'local',
     ));
-    tripal_associate_chado_semweb_term('featureloc', 'fmin', $term);
-    $term = tripal_insert_cvterm(array(
+    chado_associate_semweb_term('featureloc', 'fmin', $term);
+    $term = chado_insert_cvterm(array(
       'id' => 'local:fmax',
       'name' => 'maximal boundary',
       'definition' => 'The rightmost, maximal boundary in the linear range ' .
@@ -847,15 +847,15 @@ function tripal_chado_update_7304() {
       '3-prime coordinate',
       'cv_name' => 'local',
     ));
-    tripal_associate_chado_semweb_term('featureloc', 'fmax', $term);
-    $term = tripal_insert_cvterm(array(
+    chado_associate_semweb_term('featureloc', 'fmax', $term);
+    $term = chado_insert_cvterm(array(
       'id' => 'data:2336',
       'name' => 'Translation phase specification',
       'cv_name' => 'EDAM',
       'definition' => 'Phase for translation of DNA (0, 1 or 2) relative to a fragment of the coding sequence.',
     ));
-    tripal_associate_chado_semweb_term('featureloc', 'phase', $term);
-    $term = tripal_insert_cvterm(array(
+    chado_associate_semweb_term('featureloc', 'phase', $term);
+    $term = chado_insert_cvterm(array(
       'id' => 'data:3002',
       'name' => 'Annotation track',
       'cv_name' => 'EDAM',
@@ -863,7 +863,7 @@ function tripal_chado_update_7304() {
         'biomolecular (typically genome) sequence, suitable for import and ' .
         'display in a genome browser. Synonym: Sequence annotation track.',
     ));
-    tripal_associate_chado_semweb_term('featureloc', 'srcfeature_id', $term);
+    chado_associate_semweb_term('featureloc', 'srcfeature_id', $term);
   }
   catch (\PDOException $e) {
     $transaction->rollback();
@@ -876,90 +876,90 @@ function tripal_chado_update_7304() {
  */
 function tripal_chado_update_7305() {
   try {
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'rdfs',
       'description' => 'Resource Description Framework Schema',
       'url' => 'https://www.w3.org/TR/rdf-schema/',
       'urlprefix' => 'https://www.w3.org/TR/rdf-schema/#ch_{accession}',
     ));
-    tripal_insert_cv('rdfs', 'Resource Description Framework Schema');
-    tripal_insert_db(array(
+    chado_insert_cv('rdfs', 'Resource Description Framework Schema');
+    chado_insert_db(array(
       'name' => 'SO',
       'description' => 'The sequence ontology.',
       'url' => 'http://www.sequenceontology.org/',
       'urlprefix' => 'http://www.sequenceontology.org/browser/current_svn/term/{db}:{accession}',
     ));
-    tripal_insert_cv('sequence', 'The sequence ontology.');
-    tripal_insert_db(array(
+    chado_insert_cv('sequence', 'The sequence ontology.');
+    chado_insert_db(array(
       'name' => 'TAXRANK',
       'description' => 'A vocabulary of taxonomic ranks (species, family, phylum, etc)',
       'url' => 'http://www.obofoundry.org/ontology/taxrank.html',
       'urlprefix' => 'http://purl.obolibrary.org/obo/{db}_{accession}',
     ));
-    tripal_insert_cv('taxonomic_rank', 'A vocabulary of taxonomic ranks (species, family, phylum, etc)');
-    tripal_insert_db(array(
+    chado_insert_cv('taxonomic_rank', 'A vocabulary of taxonomic ranks (species, family, phylum, etc)');
+    chado_insert_db(array(
       'name' => 'hydra',
       'description' => 'A Vocabulary for Hypermedia-Driven Web APIs',
       'url' => 'http://www.w3.org/ns/hydra/core',
       'urlprefix' => 'http://www.w3.org/ns/hydra/core#{accession}',
     ));
-    tripal_insert_cv(
+    chado_insert_cv(
       'hydra',
       'A Vocabulary for Hypermedia-Driven Web APIs.'
     );
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'dc',
       'description' => 'DCMI Metadata Terms.',
       'url' => 'http://purl.org/dc/dcmitype/',
       'urlprefix' => 'http://purl.org/dc/terms/{accession}',
     ));
-    tripal_insert_cv(
+    chado_insert_cv(
       'dc',
       'DCMI Metadata Terms.'
     );
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'dc:Service',
       'name' => 'Service',
       'cv_name' => 'dc',
       'definition' => 'A system that provides one or more functions.',
     ));
-    $name = tripal_insert_cvterm(array(
+    $name = chado_insert_cvterm(array(
       'id' => 'hydra:Collection',
       'name' => 'Collection',
       'cv_name' => 'hydra',
       'definition' => 'A collection holding references to a number of related resources.',
     ));
-    $name = tripal_insert_cvterm(array(
+    $name = chado_insert_cvterm(array(
       'id' => 'hydra:member',
       'name' => 'member',
       'cv_name' => 'hydra',
       'definition' => 'A member of the collection',
     ));
-    $name = tripal_insert_cvterm(array(
+    $name = chado_insert_cvterm(array(
       'id' => 'hydra:description',
       'name' => 'description',
       'cv_name' => 'hydra',
       'definition' => 'A description.',
     ));
-    $name = tripal_insert_cvterm(array(
+    $name = chado_insert_cvterm(array(
       'id' => 'hydra:totalItems',
       'name' => 'totalItems',
       'cv_name' => 'hydra',
       'definition' => 'The total number of items referenced by a collection.',
     ));
-    $name = tripal_insert_cvterm(array(
+    $name = chado_insert_cvterm(array(
       'id' => 'hydra:title',
       'name' => 'title',
       'cv_name' => 'hydra',
       'definition' => 'A title, often used along with a description.',
     ));
-    $name = tripal_insert_cvterm(array(
+    $name = chado_insert_cvterm(array(
       'id' => 'hydra:PartialCollectionView',
       'name' => 'PartialCollectionView',
       'cv_name' => 'hydra',
       'definition' => 'A PartialCollectionView describes a partial view of a Collection. Multiple PartialCollectionViews can be connected with the the next/previous properties to allow a client to retrieve all members of the collection.',
     ));
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'schema:ItemPage',
       'name' => 'ItemPage',
       'cv_name' => 'schema',
@@ -967,19 +967,19 @@ function tripal_chado_update_7305() {
     ));
     global $base_path;
 
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'null',
       'description' => 'No online database.',
       'url' => $base_path . 'cv/lookup/null',
       'urlprefix' => $base_path. 'cv/lookup/{db}/{accession}',
     ));
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'local',
       'description' => 'Terms created for this site.',
       'url' => $base_path . 'cv/lookup/local',
       'urlprefix' => $base_path . 'cv/lookup/{db}/{accession}',
     ));
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'local:rank',
       'name' => 'rank',
       'definition' => 'A taxonmic rank',
@@ -1003,7 +1003,7 @@ function tripal_chado_update_7306() {
       'cv_id' => array('name' => 'EDAM'),
       'name' => 'Map'
     );
-    $cvterm = tripal_get_cvterm($identifier);
+    $cvterm = chado_get_cvterm($identifier);
     tripal_chado_add_cvterm_mapping($cvterm->cvterm_id, 'featuremap', NULL);
   }
   catch (\PDOException $e) {
@@ -1021,7 +1021,7 @@ function tripal_chado_update_7307() {
       'cv_id' => array('name' => 'tripal_pub'),
       'name' => 'Publication'
     );
-    $cvterm = tripal_get_cvterm($identifier);
+    $cvterm = chado_get_cvterm($identifier);
     tripal_chado_add_cvterm_mapping($cvterm->cvterm_id, 'pub', NULL);
   }
   catch (\PDOException $e) {
@@ -1035,7 +1035,7 @@ function tripal_chado_update_7307() {
  */
 function tripal_chado_update_7308() {
   try {
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'IAO:0000129',
       'name' => 'version number',
       'cv_name' => 'IAO',
@@ -1045,24 +1045,24 @@ function tripal_chado_update_7308() {
       'packaging and indicates its order within a set of other products ' .
       'having the same name.',
     ));
-    tripal_associate_chado_semweb_term('analysis', 'sourceversion', $term);
-    tripal_associate_chado_semweb_term(NULL, 'version', $term);
+    chado_associate_semweb_term('analysis', 'sourceversion', $term);
+    chado_associate_semweb_term(NULL, 'version', $term);
 
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'schema:name',
       'name' => 'name',
       'cv_name' => 'schema',
       'definition' => 'The name of the item.',
     ));
-    tripal_associate_chado_semweb_term('analysis', 'sourcename', $term);
+    chado_associate_semweb_term('analysis', 'sourcename', $term);
 
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'data:2091',
       'name' => 'Accession',
       'cv_name' => 'EDAM',
       'definition' => 'A persistent (stable) and unique identifier, typically identifying an object (entry) from a database.',
     ));
-    tripal_associate_chado_semweb_term('dbxref', 'accession', $term);
+    chado_associate_semweb_term('dbxref', 'accession', $term);
 
   }
   catch (\PDOException $e) {
@@ -1076,34 +1076,34 @@ function tripal_chado_update_7308() {
  */
 function tripal_chado_update_7309() {
   try {
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'SIO:001166',
       'name' => 'annotation',
       'cv_name' => 'SIO',
       'definition' => 'An annotation is a written explanatory or critical description, or other in-context information (e.g., pattern, motif, link), that has been associated with data or other types of information.',
     ));
-    tripal_associate_chado_semweb_term('feature_cvterm', 'cvterm_id', $term);
-    tripal_associate_chado_semweb_term('analysis_cvterm', 'cvterm_id', $term);
-    tripal_associate_chado_semweb_term('cell_line_cvterm', 'cvterm_id', $term);
-    tripal_associate_chado_semweb_term('environment_cvterm', 'cvterm_id', $term);
-    tripal_associate_chado_semweb_term('expression_cvterm', 'cvterm_id', $term);
-    tripal_associate_chado_semweb_term('library_cvterm', 'cvterm_id', $term);
-    tripal_associate_chado_semweb_term('organism_cvterm', 'cvterm_id', $term);
-    tripal_associate_chado_semweb_term('phenotype_cvterm', 'cvterm_id', $term);
-    tripal_associate_chado_semweb_term('stock_cvterm', 'cvterm_id', $term);
-    tripal_associate_chado_semweb_term('stock_relationship_cvterm', 'cvterm_id', $term);
-
-
-    $term = tripal_insert_cvterm(array(
+    chado_associate_semweb_term('feature_cvterm', 'cvterm_id', $term);
+    chado_associate_semweb_term('analysis_cvterm', 'cvterm_id', $term);
+    chado_associate_semweb_term('cell_line_cvterm', 'cvterm_id', $term);
+    chado_associate_semweb_term('environment_cvterm', 'cvterm_id', $term);
+    chado_associate_semweb_term('expression_cvterm', 'cvterm_id', $term);
+    chado_associate_semweb_term('library_cvterm', 'cvterm_id', $term);
+    chado_associate_semweb_term('organism_cvterm', 'cvterm_id', $term);
+    chado_associate_semweb_term('phenotype_cvterm', 'cvterm_id', $term);
+    chado_associate_semweb_term('stock_cvterm', 'cvterm_id', $term);
+    chado_associate_semweb_term('stock_relationship_cvterm', 'cvterm_id', $term);
+
+
+    $term = chado_insert_cvterm(array(
       'id' => 'SIO:000281',
       'name' => 'negation',
       'cv_name' => 'SIO',
       'definition' => 'NOT is a logical operator in that has the value true if its operand is false.',
     ));
-    tripal_associate_chado_semweb_term('feature_cvterm', 'is_not', $term);
-    tripal_associate_chado_semweb_term('analysis_cvterm', 'is_not', $term);
-    tripal_associate_chado_semweb_term('organism_cvterm', 'is_not', $term);
-    tripal_associate_chado_semweb_term('stock_cvterm', 'is_not', $term);
+    chado_associate_semweb_term('feature_cvterm', 'is_not', $term);
+    chado_associate_semweb_term('analysis_cvterm', 'is_not', $term);
+    chado_associate_semweb_term('organism_cvterm', 'is_not', $term);
+    chado_associate_semweb_term('stock_cvterm', 'is_not', $term);
   }
   catch (\PDOException $e) {
     $error = $e->getMessage();
@@ -1115,24 +1115,24 @@ function tripal_chado_update_7309() {
  */
 function tripal_chado_update_7310() {
   try {
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'OBCS',
       'description' => 'Ontology of Biological and Clinical Statistics.',
       'url' => 'https://github.com/obcs/obcs',
       'urlprefix' => 'http://purl.obolibrary.org/obo/{db}_{accession}',
     ));
-    tripal_insert_cv(
+    chado_insert_cv(
         'OBCS',
         'Ontology of Biological and Clinical Statistics.'
     );
 
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'OBCS:0000117',
       'name' => 'rank order',
       'cv_name' => 'OBCS',
       'definition' => 'A data item that represents an arrangement according to a rank, i.e., the position of a particular case relative to other cases on a defined scale.',
     ));
-    tripal_associate_chado_semweb_term(NULL, 'rank', $term);
+    chado_associate_semweb_term(NULL, 'rank', $term);
   }
   catch (\PDOException $e) {
     $error = $e->getMessage();
@@ -1144,7 +1144,7 @@ function tripal_chado_update_7310() {
  */
 function tripal_chado_update_7311() {
   try {
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'local:fmin',
       'name' => 'minimal boundary',
       'definition' => 'The leftmost, minimal boundary in the linear range ' .
@@ -1153,7 +1153,7 @@ function tripal_chado_update_7311() {
         'represent the 5-prime coordinate.',
       'cv_name' => 'local',
     ));
-    tripal_associate_chado_semweb_term('featureloc', 'fmin', $term);
+    chado_associate_semweb_term('featureloc', 'fmin', $term);
   }
   catch (\PDOException $e) {
     $error = $e->getMessage();
@@ -1166,20 +1166,20 @@ function tripal_chado_update_7311() {
 function tripal_chado_update_7312() {
   try {
 
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'local:miniref',
       'name' => 'Mini-ref',
       'definition' => 'A small in-house unique identifier for a publication.',
       'cv_name' => 'local',
     ));
-    tripal_associate_chado_semweb_term('pub', 'miniref', $term);
-    $term = tripal_insert_cvterm(array(
+    chado_associate_semweb_term('pub', 'miniref', $term);
+    $term = chado_insert_cvterm(array(
       'id' => 'schema:url',
       'name' => 'url',
       'cv_name' => 'schema',
       'definition' => 'URL of the item.',
     ));
-    tripal_associate_chado_semweb_term('db', 'url', $term);
+    chado_associate_semweb_term('db', 'url', $term);
   }
   catch (\PDOException $e) {
     $error = $e->getMessage();
@@ -1192,10 +1192,10 @@ function tripal_chado_update_7312() {
  */
 function tripal_chado_update_7313() {
   try {
-    $cv = tripal_get_cv(array('name' => 'tripal_pub'));
-    tripal_update_cvtermpath($cv->cv_id);
-    $cv = tripal_get_cv(array('name' => 'tripal_contact'));
-    tripal_update_cvtermpath($cv->cv_id);
+    $cv = chado_get_cv(array('name' => 'tripal_pub'));
+    chado_update_cvtermpath($cv->cv_id);
+    $cv = chado_get_cv(array('name' => 'tripal_contact'));
+    chado_update_cvtermpath($cv->cv_id);
   }
   catch (\PDOException $e) {
     $error = $e->getMessage();
@@ -1208,14 +1208,14 @@ function tripal_chado_update_7313() {
  */
 function tripal_chado_update_7314() {
   try {
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'name' => 'Reference Feature',
       'definition' => 'A genomic or genetic feature on which other features are mapped.',
       'cv_name' => 'local',
       'is_relationship' => 0,
       'db_name' => 'local'
     ));
-    tripal_associate_chado_semweb_term('featurepos', 'map_feature_id', $term);
+    chado_associate_semweb_term('featurepos', 'map_feature_id', $term);
   }
   catch (\PDOException $e) {
     $error = $e->getMessage();
@@ -1227,7 +1227,7 @@ function tripal_chado_update_7314() {
  */
 function tripal_chado_update_7315() {
   try {
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'schema:additionalType',
       'name' => 'additionalType',
       'cv_name' => 'schema',
@@ -1246,7 +1246,7 @@ function tripal_chado_update_7315() {
  */
 function tripal_chado_update_7316() {
   try {
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'SIO:001323',
       'name' => 'email address',
       'cv_name' => 'SIO',
@@ -1264,14 +1264,14 @@ function tripal_chado_update_7316() {
  */
 function tripal_chado_update_7317() {
   try {
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'OBI:0100026',
       'name' => 'organism',
       'cv_name' => 'obi',
       'definition' => 'A material entity that is an individual living system, such as animal, plant, bacteria or virus, that is capable of replicating or reproducing, growth and maintenance in the right environment. An organism may be unicellular or made up, like humans, of many billions of cells divided into specialized tissues and organs.',
     ));
-    tripal_associate_chado_semweb_term('biomaterial', 'taxon_id', $term);
-    $term = tripal_insert_cvterm(array(
+    chado_associate_semweb_term('biomaterial', 'taxon_id', $term);
+    $term = chado_insert_cvterm(array(
       'id' => 'local:contact',
       'name' => 'contact',
       'definition' => 'An entity (e.g. individual or organization) through ' .
@@ -1279,7 +1279,7 @@ function tripal_chado_update_7317() {
       'influential people, and the like.',
       'cv_name' => 'local',
     ));
-    tripal_associate_chado_semweb_term('biomaterial', 'biosourceprovider_id', $term);
+    chado_associate_semweb_term('biomaterial', 'biosourceprovider_id', $term);
   }
   catch (\PDOException $e) {
     $error = $e->getMessage();
@@ -1292,14 +1292,14 @@ function tripal_chado_update_7317() {
  */
 function tripal_chado_update_7318() {
   try {
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'sep',
       'description' => 'Sample processing and separation techniques.',
       'url' => 'http://psidev.info/index.php?q=node/312',
       'urlprefix' => 'http://purl.obolibrary.org/obo/{db}_{accession}',
     ));
-    tripal_insert_cv('sep','A structured controlled vocabulary for the annotation of sample processing and separation techniques in scientific experiments.');
-    $term = tripal_insert_cvterm(array(
+    chado_insert_cv('sep','A structured controlled vocabulary for the annotation of sample processing and separation techniques in scientific experiments.');
+    $term = chado_insert_cvterm(array(
       'id' => 'sep:00195',
       'name' => 'biological sample',
       'cv_name' => 'sep',
@@ -1318,7 +1318,7 @@ function tripal_chado_update_7318() {
  */
 function tripal_chado_update_7319() {
   try {
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'operation:2945',
       'name' => 'Analysis',
       'cv_name' => 'EDAM',
@@ -1337,28 +1337,28 @@ function tripal_chado_update_7319() {
 function tripal_chado_update_7320() {
     try {
     // Associate the Analysis term with the analysis_id of the phylotree table.
-    $term = tripal_get_cvterm(array('id' => 'operation:2945'));
-    tripal_associate_chado_semweb_term('phylotree', 'analysis_id', $term);
+    $term = chado_get_cvterm(array('id' => 'operation:2945'));
+    chado_associate_semweb_term('phylotree', 'analysis_id', $term);
 
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'data:0872',
       'name' => 'Phylogenetic tree',
       'cv_name' => 'EDAM',
       'definition' => 'The raw data (not just an image) from which a phylogenetic tree is directly generated or plotted, such as topology, lengths (in time or in expected amounts of variance) and a confidence interval for each length.',
     ));
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'data:3272',
       'name' => 'Species tree',
       'cv_name' => 'EDAM',
       'definition' => 'A phylogenetic tree that reflects phylogeny of the taxa from which the characters (used in calculating the tree) were sampled.',
     ));
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'data:3271',
       'name' => 'Gene tree',
       'cv_name' => 'EDAM',
       'definition' => 'A phylogenetic tree that is an estimate of the character\'s phylogeny.',
     ));
-    $term = tripal_insert_cvterm(array(
+    $term = chado_insert_cvterm(array(
       'id' => 'operation:0567',
       'name' => 'Phylogenetic tree visualisation',
       'cv_name' => 'EDAM',
@@ -1396,37 +1396,37 @@ function tripal_chado_update_7320() {
  */
 function tripal_chado_update_7321() {
   try {
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'TPUB',
       'description' => 'Tripal Publiation Ontology. A temporary ontology until a more formal appropriate ontology an be identified.',
       'url' => '/cv/lookup/TPUB',
       'urlprefix' => '/cv/lookup/TPUB/{accession}',
     ));
-    tripal_insert_cv('tripal_pub', 'Tripal Publiation Ontology. A temporary ontology until a more formal appropriate ontology an be identified.');
+    chado_insert_cv('tripal_pub', 'Tripal Publiation Ontology. A temporary ontology until a more formal appropriate ontology an be identified.');
 
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'rdf',
       'description' => 'Resource Description Framework',
       'url' => 'http://www.w3.org/1999/02/22-rdf-syntax-ns',
       'urlprefix' => 'http://www.w3.org/1999/02/22-rdf-syntax-ns#',
     ));
-    tripal_insert_cv(
+    chado_insert_cv(
       'rdf',
       'Resource Description Framework'
     );
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'rdfs',
       'description' => 'Resource Description Framework Schema',
       'url' => 'https://www.w3.org/TR/rdf-schema/',
       'urlprefix' => 'http://www.w3.org/2000/01/rdf-schema#{accession}',
     ));
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'hydra',
       'description' => 'A Vocabulary for Hypermedia-Driven Web APIs',
       'url' => 'http://www.w3.org/ns/hydra/core',
       'urlprefix' => 'http://www.w3.org/ns/hydra/core#{accession}',
     ));
-    tripal_insert_cv(
+    chado_insert_cv(
       'hydra',
       'A Vocabulary for Hypermedia-Driven Web APIs.'
     );
@@ -1441,21 +1441,21 @@ function tripal_chado_update_7321() {
  */
 function tripal_chado_update_7322() {
   try {
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'TPUB',
       'description' => 'Tripal Publiation Ontology. A temporary ontology until a more formal appropriate ontology an be identified.',
       'url' => 'cv/lookup/TPUB',
       'urlprefix' => 'cv/lookup/TPUB/{accession}',
     ));
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'TContact',
       'description' => 'Tripal Contact Ontology. A temporary ontology until a more formal appropriate ontology an be identified.',
       'url' => 'cv/lookup/TContact',
       'urlprefix' => 'cv/lookup/TContact/{accession}',
     ));
-    tripal_insert_cv('tripal_contact', 'Tripal Contact Ontology. A temporary ontology until a more formal appropriate ontology an be identified.');
+    chado_insert_cv('tripal_contact', 'Tripal Contact Ontology. A temporary ontology until a more formal appropriate ontology an be identified.');
 
-    tripal_insert_db(array(
+    chado_insert_db(array(
       'name' => 'SWO',
       'description' => 'Software Ontology',
       'url' => 'http://purl.obolibrary.org/obo/swo',
@@ -1476,12 +1476,12 @@ function tripal_chado_update_7323() {
     tripal_chado_add_db2cv_mview_mview();
 
     drupal_set_message('Populating materialized view db2cv_mview...');
-    $mview_id = tripal_get_mview_id('db2cv_mview');
-    tripal_populate_mview($mview_id);
+    $mview_id = chado_get_mview_id('db2cv_mview');
+    chado_populate_mview($mview_id);
 
     drupal_set_message('Populating materialized view cv_root_mview...');
-    $mview_id = tripal_get_mview_id('cv_root_mview');
-    tripal_populate_mview($mview_id);
+    $mview_id = chado_get_mview_id('cv_root_mview');
+    chado_populate_mview($mview_id);
   }
   catch (\PDOException $e) {
     $error = $e->getMessage();
@@ -1497,14 +1497,14 @@ function tripal_chado_update_7324() {
       module_load_include('inc', 'tripal_chado', 'includes/setup/tripal_chado.chado_vx_x');
 
       // Remove the old mview.
-      $mview_id = tripal_get_mview_id('db2cv_mview');
-      tripal_delete_mview($mview_id);
+      $mview_id = chado_get_mview_id('db2cv_mview');
+      chado_delete_mview($mview_id);
 
       // Readd the mview.
       tripal_chado_add_db2cv_mview_mview();
       drupal_set_message('Populating materialized view db2cv_mview...');
-      $mview_id = tripal_get_mview_id('db2cv_mview');
-      tripal_populate_mview($mview_id);
+      $mview_id = chado_get_mview_id('db2cv_mview');
+      chado_populate_mview($mview_id);
     }
   }
   catch (\PDOException $e) {

tripal_chado/tripal_chado.module

@@ -35,6 +35,7 @@ require_once 'api/tripal_chado.schema_v1.2.api.inc';
 require_once 'api/tripal_chado.schema_v1.11.api.inc';
 require_once 'api/tripal_chado.semweb.api.inc';
 require_once 'api/tripal_chado.migrate.api.inc';
+require_once 'api/tripal_chado.DEPRECATED.api.inc';
 
 // Chado module specific API functions
 require_once 'api/modules/tripal_chado.analysis.api.inc';
@@ -46,6 +47,7 @@ require_once 'api/modules/tripal_chado.organism.api.inc';
 require_once 'api/modules/tripal_chado.pub.api.inc';
 require_once 'api/modules/tripal_chado.stock.api.inc';
 require_once 'api/modules/tripal_chado.phylotree.api.inc';
+require_once 'api/modules/tripal_chado.module.DEPRECATED.api.inc';
 
 //
 // REQUIRED INCLUDE FILES
@@ -519,7 +521,7 @@ function tripal_chado_menu() {
   //                           Auto Completes
   //////////////////////////////////////////////////////////////////////////////
   $items['admin/tripal/storage/chado/auto_name/dbxref/%/%'] = array(
-    'page callback' => 'tripal_autocomplete_dbxref',
+    'page callback' => 'chado_autocomplete_dbxref',
     'page arguments' => array(6, 7),
     'access arguments' => array('access content'),
     'file' => 'api/modules/tripal_chado.db.api.inc',
@@ -527,7 +529,7 @@ function tripal_chado_menu() {
     'type' => MENU_CALLBACK,
   );
   $items['admin/tripal/storage/chado/auto_name/cv/%'] = array(
-    'page callback' => 'tripal_autocomplete_cv',
+    'page callback' => 'chado_autocomplete_cv',
     'page arguments' => array(6),
     'access arguments' => array('access content'),
     'file' => 'api/modules/tripal_chado.cv.api.inc',
@@ -535,7 +537,7 @@ function tripal_chado_menu() {
     'type' => MENU_CALLBACK,
   );
   $items['admin/tripal/storage/chado/auto_name/cvterm/%/%'] = array(
-    'page callback' => 'tripal_autocomplete_cvterm',
+    'page callback' => 'chado_autocomplete_cvterm',
     'page arguments' => array(6, 7),
     'access arguments' => array('access content'),
     'file' => 'api/modules/tripal_chado.cv.api.inc',
@@ -544,7 +546,7 @@ function tripal_chado_menu() {
   );
 
   $items['admin/tripal/storage/chado/auto_name/pub/%'] = array(
-    'page callback' => 'tripal_autocomplete_pub',
+    'page callback' => 'chado_autocomplete_pub',
     'page arguments' => array(6),
     'access arguments' => array('access content'),
     'file' => 'api/modules/tripal_chado.pub.api.inc',
@@ -560,7 +562,7 @@ function tripal_chado_menu() {
     'type' => MENU_CALLBACK,
   );
   $items['admin/tripal/storage/chado/auto_name/feature/%'] = array(
-    'page callback' => 'tripal_autocomplete_feature',
+    'page callback' => 'chado_autocomplete_feature',
     'page arguments' => array(6),
     'access arguments' => array('access content'),
     'file' => 'api/modules/tripal_chado.feature.api.inc',
@@ -568,7 +570,7 @@ function tripal_chado_menu() {
     'type' => MENU_CALLBACK,
   );
   $items['admin/tripal/storage/chado/auto_name/organism/%'] = array(
-    'page callback' => 'tripal_autocomplete_organism',
+    'page callback' => 'chado_autocomplete_organism',
     'page arguments' => array(6),
     'access arguments' => array('access content'),
     'file' => 'api/modules/tripal_chado.organism.api.inc',
@@ -982,7 +984,7 @@ function tripal_chado_exclude_type_by_default() {
 /**
  * Implements hook_job_describe_args().
  *
- * Describes the arguments for the tripal_populate_mview job to allow for
+ * Describes the arguments for the chado_populate_mview job to allow for
  * greater readability in the jobs details pages.
  *
  * @param $callback
@@ -998,7 +1000,7 @@ function tripal_chado_exclude_type_by_default() {
  */
 function tripal_chado_job_describe_args($callback, $args) {
   $new_args = array();
-  if ($callback == 'tripal_populate_mview') {
+  if ($callback == 'chado_populate_mview') {
     // get this mview details
     $sql = "SELECT * FROM {tripal_mviews} WHERE mview_id = :mview_id ";
     $results = db_query($sql, array(':mview_id' => $args[0]));

tripal_chado_views/api/tripal_chado_views.api.inc

@@ -1,41 +1,58 @@
 <?php
 /**
  * @file
- * API functions for Chado Views Integration
+ * Provides API functions that support direct integration of Chado tables with
+ * Drupal Views. 
+ */
+/**
+ * @defgroup tripal_chado_views_api Chado Views Integration
+ * @ingroup tripal_chado_api
+ * @{
+ * Provides API functions that support direct integration of Chado tables with
+ * Drupal Views. This is different from the entity and field integration that
+ * Tripal v3 provides.  Here Chado tables are directly integrated.  Tripal
+ * provides a web interface that allows site developers to customize how a
+ * Chado table is integrate with Views.  However, these functions provide
+ * programmatic access to the same functionality.
+ * @}
  */
 
 /**
  * Programatically enable view
  *
- * This should be used in a hook_menu definition as the callback to provide a link
- * to enable the view (first example). It can also be called directly if needed (second example).
+ * This should be used in a hook_menu definition as the callback to provide a 
+ * link to enable the view (first example). It can also be called directly if 
+ * needed (second example).
  * @code
- // Create a URL that when the user navigates there, a given view will be enabled.
- // You will still need to provide a link to this menu item somewhere appropriate (ie: an admin landing page).
- function mymodule_menu() {
- $items = array();
-
- // Create one of these for each of your default views
- $items['admin/tripal/<PATH-TO-YOUR-ADMIN-SECTION>/views/<VIEW-MACHINE-NAME>/enable'] = array(
- 'title' => 'Enable <VIEW-HUMAN-READABLE-NAME>',
- 'page callback' => 'tripal_enable_view',
- 'page arguments' => array('<VIEW-MACHINE-NAME>', '<PATH-TO-REDIRECT-TO-AFTERWARDS>'),
- 'access arguments' => array('<YOUR-PERMISSION-KEY>'),
- 'type' => MENU_CALLBACK,
- );
-
- return $items;
- }
-
- // Call this function directly to disable a view
- // The example shows enabling your own default view when your module is enabled.
- // This might be useful if you disable your view when your module is disabled.
- function mymodule_enable() {
-
- $view_name = '<VIEW-MACHINE-NAME>';
- tripal_enable_view($view_name);
-
- }
+ *  Create a URL that when the user navigates there, a given view will be 
+ *  enabled.
+ *  You will still need to provide a link to this menu item somewhere 
+ *  appropriate (ie: an admin landing page).
+ * 
+ * function mymodule_menu () {
+ * $items = array();
+ *
+ *  //Create one of these for each of your default views
+ *  $items['admin/tripal/<PATH-TO-YOUR-ADMIN-SECTION>/views/<VIEW-MACHINE-NAME>/enable'] = array(
+ *  'title' => 'Enable <VIEW-HUMAN-READABLE-NAME>',
+ *  'page callback' => 'tripal_enable_view',
+ *  'page arguments' => array('<VIEW-MACHINE-NAME>', '<PATH-TO-REDIRECT-TO-AFTERWARDS>'),
+ *  'access arguments' => array('<YOUR-PERMISSION-KEY>'),
+ * 'type' => MENU_CALLBACK,
+ *  );
+ * 
+ *  return $items;
+ * }
+ * 
+ *  Call this function directly to disable a view
+ *  The example shows enabling your own default view when your module is enabled.
+ *  This might be useful if you disable your view when your module is disabled.
+ * function mymodule_enable() {
+ * 
+ *  $view_name = '<VIEW-MACHINE-NAME>';
+ * tripal_enable_view($view_name);
+ * 
+ *  }
  * @endcode
  *
  * @param $view_name
@@ -43,7 +60,7 @@
  * @param $redirect_link
  *   The path to redirect to. FALSE if no redirect needed
  *
- * @ingroup tripal_views_api
+ * @ingroup tripal_chado_views_api
  */
 function tripal_enable_view($view_name, $redirect_link = FALSE) {
 
@@ -64,34 +81,40 @@ function tripal_enable_view($view_name, $redirect_link = FALSE) {
 /**
  * Programatically disable view.
  *
- * This should be used in a hook_menu definition as the callback to provide a link
- * to disable the view (first example). It can also be called directly if needed (second example).
+ * This should be used in a hook_menu definition as the callback to provide a 
+ * link to disable the view (first example). It can also be called directly if 
+ * needed (second example).
+ * 
  * @code
- // Create a URL that when the user navigates there, a given view will be disabled.
- // You will still need to provide a link to this menu item somewhere appropriate.
- function mymodule_menu() {
- $items = array();
-
- // Create one of these for each of your default views
- $items['admin/tripal/<PATH-TO-YOUR-ADMIN-SECTION>/views/<VIEW-MACHINE-NAME>/disable'] = array(
- 'title' => 'Disable <VIEW-HUMAN-READABLE-NAME>',
- 'page callback' => 'tripal_disable_view',
- 'page arguments' => array('<VIEW-MACHINE-NAME>', '<PATH-TO-REDIRECT-TO-AFTERWARDS>'),
- 'access arguments' => array('<YOUR-PERMISSION-KEY>'),
- 'type' => MENU_CALLBACK,
- );
-
- return $items;
- }
-
- // Call this function directly to disable a view
- // The example shows disabling your own default view when your module is uninstalled
- function mymodule_uninstall() {
-
- $view_name = '<VIEW-MACHINE-NAME>';
- tripal_disable_view($view_name);
-
- }
+ *  //Create a URL that when the user navigates there, a given view will be 
+ *  //disabled.
+ *  //You will still need to provide a link to this menu item somewhere 
+ *  //appropriate.
+ * 
+ * function mymodule_menu() {
+ * $items = array();
+ * 
+ *   //Create one of these for each of your default views
+ * $items['admin/tripal/<PATH-TO-YOUR-ADMIN-SECTION>/views/<VIEW-MACHINE-NAME>/disable'] = array(
+ * 'title' => 'Disable <VIEW-HUMAN-READABLE-NAME>',
+ * 'page callback' => 'tripal_disable_view',
+ * 'page arguments' => array('<VIEW-MACHINE-NAME>', '<PATH-TO-REDIRECT-TO-AFTERWARDS>'),
+ * 'access arguments' => array('<YOUR-PERMISSION-KEY>'),
+ * 'type' => MENU_CALLBACK,
+ * );
+ * 
+ * return $items;
+ * }
+ * 
+ *    //Call this function directly to disable a view
+ *    //The example shows disabling your own default view when your module is 
+ *    //uninstalled
+ *  function mymodule_uninstall() {
+ * 
+ * $view_name = '<VIEW-MACHINE-NAME>';
+ *  tripal_disable_view($view_name);
+ * 
+ * }
  * @endcode
  *
  * @param $view_name
@@ -99,7 +122,7 @@ function tripal_enable_view($view_name, $redirect_link = FALSE) {
  * @param $redirect_link
  *   The path to redirect to. FALSE if no redirect needed
  *
- * @ingroup tripal_views_api
+ * @ingroup tripal_chado_views_api
  */
 function tripal_disable_view($view_name, $redirect_link = FALSE) {
 
@@ -118,70 +141,76 @@ function tripal_disable_view($view_name, $redirect_link = FALSE) {
 }
 
 /**
- * Remove any drupal fields from a chado-based default view definition if chado is external.
+ * Remove any drupal fields from a chado-based default view definition if chado 
+ * is external.
  * This ensures compatibility with an external chado database.
  *
- * You should be calling this function in your hook_views_default_views(). This function
- * will only remove drupal tables if chado is external; thus you do not need to worry about
- * checking yourself. For example, the following is a good hook_views_default_views():
+ * You should be calling this function in your hook_views_default_views(). 
+ * This function will only remove drupal tables if chado is external; thus you 
+ * do not need to worry about checking yourself. For example, the following is 
+ * a good  hook_views_default_views():
+ * 
  * @code
- function mymodule_views_default_views() {
- $views = array();
-
- // NOTE: <VIEW-TYPE> describes the type of view:
- //     - 'admin' for views used for administration of your module
- //     - 'search' for views used to search data
- //     - 'list' for views used primarily as data listings
-
- // <VIEW-HUMAN-READABLE-NAME>
- $view = mymodule_defaultview_<VIEW-TYPE>_<VIEW-MACHINE-NAME>();
- $view = tripal_make_view_compatible_with_external($view);
- $views[$view->name] = $view;
-
- // <VIEW-HUMAN-READABLE-NAME>
- $view = mymodule_defaultview_<VIEW-TYPE>_<VIEW-MACHINE-NAME>();
- $view = tripal_make_view_compatible_with_external($view);
- $views[$view->name] = $view;
-
- return $views;
- }
-
- function mymodule_defaultview_<VIEW-TYPE>_<VIEW-MACHINE-NAME>() {
- // PASTE VIEWS EXPORT CODE HERE
- return $view;
- }
-
- function mymodule_defaultview_<VIEW-TYPE>_<VIEW-MACHINE-NAME>() {
- // PASTE VIEWS EXPORT CODE HERE
- return $view;
- }
+ * function mymodule_views_default_views() {
+ * $views = array();
+ * 
+ *   // NOTE: <VIEW-TYPE> describes the type of view:
+ *   //      - 'admin' for views used for administration of your module
+ *   //      - 'search' for views used to search data
+ *   //     - 'list' for views used primarily as data listings
+ *   //
+ *   //<VIEW-HUMAN-READABLE-NAME>
+ * $view = mymodule_defaultview_<VIEW-TYPE>_<VIEW-MACHINE-NAME>();
+ * $view = tripal_make_view_compatible_with_external($view);
+ * $views[$view->name] = $view;
+ * 
+ *    //<VIEW-HUMAN-READABLE-NAME>
+ * $view = mymodule_defaultview_<VIEW-TYPE>_<VIEW-MACHINE-NAME>();
+ * $view = tripal_make_view_compatible_with_external($view);
+ * $views[$view->name] = $view;
+ * 
+ * return $views;
+ * }
+
+ * function mymodule_defaultview_<VIEW-TYPE>_<VIEW-MACHINE-NAME>() {
+ *     //PASTE VIEWS EXPORT CODE HERE
+ * return $view;
+ * }
+ * 
+ * function mymodule_defaultview_<VIEW-TYPE>_<VIEW-MACHINE-NAME>() {
+ *    //PASTE VIEWS EXPORT CODE HERE
+ * return $view;
+ * }
  * @endcode
- * Notice that the actual views export code is in a separate function. This makes your
- * hook_views_default_views() more readable.
+ * Notice that the actual views export code is in a separate function. 
+ * This makes your hook_views_default_views() more readable.
  *
- * NOTE: Currently assumes all tables not in the tripal views integration tables are Drupal tables.
+ * NOTE: Currently assumes all tables not in the tripal views integration 
+ * tables are Drupal tables.
  *
  * @param $view
  *   The default view definition object
  * @return
- *   The default view with all relationships, fields, filters, sorts, arguments for
- *   Drupal tables removed.
+ *   The default view with all relationships, fields, filters, sorts, arguments 
+ *   for Drupal tables removed.
+ * 
+ * @ingroup tripal_chado_views_api
  */
 function tripal_make_view_compatible_with_external($view) {
   $remove_table = array();
 
   // First check that the base table for the view is a chado table
-  // If it's not then don't do any filtering
+  // If it's not then don't do any filtering.
   $setup_id = tripal_is_table_integrated($view->base_table);
   if (!$setup_id) {
     return $view;
   }
 
-  // IF chado is external then remove all config relating to drupal tables
+  // IF chado is external then remove all config relating to drupal tables.
   $is_local = isset($GLOBALS["chado_is_local"]) && $GLOBALS["chado_is_local"];
   if (!$is_local) {
 
-    // Iterate through all displays
+    // Iterate through all displays.
     foreach ($view->display as $display_name => $display) {
       $display_options = $display->handler->display->display_options;
 
@@ -189,13 +218,14 @@ function tripal_make_view_compatible_with_external($view) {
       foreach ($sections as $section) {
         $display_options[$section] = (isset($display_options[$section])) ? $display_options[$section] : array();
         foreach ($display_options[$section] as $key => $defn) {
-          // If the table has not already been encountered; check if it's in tripal_views
+          // If the table has not already been encountered; check if it's in 
+          // tripal_views.
           if (!isset($remove_table[ $defn['table'] ])) {
-            // If the table is view then this is a general handler; thus keep
+            // If the table is view then this is a general handler; thus keep.
             if ($defn['table'] == 'views') {
               $remove_table[ $defn['table'] ] = FALSE;
             }
-            // If this table is integrated then it is chado; thus keep
+            // If this table is integrated then it is chado; thus keep.
             $setup_id = tripal_is_table_integrated($defn['table']);
             if ($setup_id) {
               $remove_table[ $defn['table'] ] = FALSE;
@@ -205,7 +235,8 @@ function tripal_make_view_compatible_with_external($view) {
             }
           }
 
-          // Based on the $remove_table array, unset this field if its from a drupal table
+          // Based on the $remove_table array, unset this field if its from a 
+          // drupal table.
           if ($remove_table[ $defn['table'] ]) {
             unset($view->display[$display_name]->handler->display->display_options[$section][$key]);
           }
@@ -224,18 +255,18 @@ function tripal_make_view_compatible_with_external($view) {
  * and -10 is of highest priority.
  *
  * @param $table_name
- *   The name of the table to retrieve the setup ID for. This can be either a materialized
- *   view or a chado table
+ *   The name of the table to retrieve the setup ID for. This can be either a 
+ *   materialized view or a chado table
  *
  * @return
- *   returns the lowest priority.  If the table has not been integrated, a priority of 10
- *   is returned.
+ *   returns the lowest priority.  If the table has not been integrated, a 
+ *   priority of 10 is returned.
  *
  * @ingroup tripal_chado_views_api
  */
 function tripal_get_lightest_views_integration_priority($table_name) {
 
-  // D7 TODO: Check DBTNG changes work
+  // D7 TODO: Check DBTNG changes work.
   $sql = "SELECT priority FROM {tripal_views} WHERE table_name=:table ORDER BY priority ASC";
   $setup = db_query($sql, array(':table' => $table_name));
   $setup = $setup->fetchObject();
@@ -243,29 +274,31 @@ function tripal_get_lightest_views_integration_priority($table_name) {
     return $setup->priority;
   }
   else {
-    // default priority is 10
+    // Default priority is 10.
     return 10;
   }
 }
 
 /**
- * Retrieve the views integration setup_id with the lightest priority for a given table
+ * Retrieve the views integration setup_id with the lightest priority for a 
+ * given table
  *
  * NOTE: Uses lightest priority (drupal-style) where the range is from -10 to 10
  * and -10 is of highest priority.
  *
  * @param $table_name
- *   The name of the table to retrieve the setup ID for. This can be either a materialized
- *   view or a chado table
+ *   The name of the table to retrieve the setup ID for. This can be either a 
+ *   materialized view or a chado table
  *
  * @return
- *   On success, the setup_id to use for integration of this table; otherwise FALSE
+ *   On success, the setup_id to use for integration of this table; otherwise 
+ *   FALSE
  *
  * @ingroup tripal_chado_views_api
  */
 function tripal_get_lightest_views_integration_setup($table_name) {
 
-  // D7 TODO: Check DBTNG changes work
+  // D7 TODO: Check DBTNG changes work.
   $sql = "SELECT setup_id FROM {tripal_views} WHERE table_name=:table ORDER BY priority ASC";
   $setup = db_query($sql, array(':table' => $table_name));
   $setup = $setup->fetchObject();
@@ -278,16 +311,18 @@ function tripal_get_lightest_views_integration_setup($table_name) {
 }
 
 /**
- * Retrieve the views integration setup_id with the given priority/table combination.
+ * Retrieve the views integration setup_id with the given priority/table 
+ * combination.
  *
  * @param $table_name
- *   The name of the table to retrieve the setup ID for. This can be either a materialized
- *   view or a chado table
+ *   The name of the table to retrieve the setup ID for. This can be either a 
+ *   materialized view or a chado table
  * @param $priority
  *   The priority of the integration to retrieve the setup_id for
  *
  * @return
- *   On success, the setup_id to use for integration of this table; otherwise FALSE
+ *   On success, the setup_id to use for integration of this table; otherwise 
+ *   FALSE
  *
  * @ingroup tripal_chado_views_api
  */
@@ -306,7 +341,8 @@ function tripal_get_views_integration_setup_id($table_name, $priority) {
 }
 
 /**
- * Check to see if this table already has an integration record with the given priority.
+ * Check to see if this table already has an integration record with the given 
+ * priority.
  *
  * @param $table_name
  *   The name of the table to check for integration
@@ -315,21 +351,22 @@ function tripal_get_views_integration_setup_id($table_name, $priority) {
  *
  * @return
  *  If the table is already integrated, the setup_id of the existing integration
- *  record is returned (If priority is not specified this will be the lightest record);
- *  Otherwise the table is not already integrated and FALSE is returned.
+ *  record is returned (If priority is not specified this will be the lightest 
+ *  record);  Otherwise the table is not already integrated and FALSE is 
+ *  returned.
  *
  * @ingroup tripal_chado_views_api
  */
 function tripal_is_table_integrated($table_name, $priority = NULL) {
 
   if ($priority) {
-    // D7 TODO: Check DBTNG changes work
+    // D7 TODO: Check DBTNG changes work.
     $sql = "SELECT setup_id FROM {tripal_views} WHERE table_name=:table AND priority=:priority";
     $setup = db_query($sql, array(':table' => $table_name, ':priority' => $priority));
     $setup = $setup->fetchObject();
   }
   else {
-    // D7 TODO: Check DBTNG changes work
+    // D7 TODO: Check DBTNG changes work.
     $sql = "SELECT setup_id FROM {tripal_views} WHERE table_name=:table ORDER BY priority ASC";
     $setup = db_query($sql, array(':table' => $table_name));
     $setup = $setup->fetchObject();
@@ -343,8 +380,9 @@ function tripal_is_table_integrated($table_name, $priority = NULL) {
 }
 
 /**
- * Checks if you are dealing with the lightest priority setup for a given table. This is a
- * good way to determine whether your modules integration is being used by views.
+ * Checks if you are dealing with the lightest priority setup for a given table. 
+ * This is a good way to determine whether your modules integration is being 
+ * used by views.
  *
  * @param $setup_id
  *   The ID of the setup to check (is this setup the lightest one?)
@@ -370,11 +408,11 @@ function tripal_is_lightest_priority_setup($setup_id, $table_name) {
 /**
  * Rebuilds all the default integrations.
  *
- * This essentially clears the cache in case you mess up the integrations in your site.
- * This should not be used during module development since it really only rebuilds the
- * integrations described by all enabled modules in the site and if $delete_first is
- * TRUE it can delete custom integrations created by site administrators which will not
- * make your module popular.
+ * This essentially clears the cache in case you mess up the integrations in 
+ * your site. This should not be used during module development since it 
+ * really only rebuilds the integrations described by all enabled modules 
+ * in the site and if $delete_first is TRUE it can delete custom integrations 
+ * created by site administrators which will not make your module popular.
  *
  * @param $delete_first
  *   If TRUE then all integrations are first deleted.
@@ -397,59 +435,60 @@ function tripal_rebuild_views_integrations($delete_first = FALSE) {
 /**
  * Add views integration records into the tripal_views* tables.
  *
- * This is the programatic way to add your own integrations to the tripal views integrations
- * list. Keep in mind that the priority set in your $defn_array needs to be lighter than
- * any existing integrations to be used by views and that it should still be below 0
- * in order to allow site administrators to override it should they need to.
+ * This is the programatic way to add your own integrations to the tripal views 
+ * integrations list. Keep in mind that the priority set in your $defn_array 
+ * needs to be lighter than any existing integrations to be used by views and 
+ * that it should still be below 0 in order to allow site administrators to 
+ * override it should they need to.
  *
  * @param $defn_array
- *   An array describing the structure and fields of the table
+ *   An array describing the structure and fields of the table.
  *
  * @return
- *   True/False if completed successfully/not
+ *   True/False if completed successfully/not.
  *
  * Example usage (in hook_install()):
  * @code
-  $defn_array = array(
-    'table' => 'feature', //tablename or materialized view name
-    'name' => 'Sequence Features', // Human readable name
-    'type' => 'chado', //either chado or mview depending on tablename
-    'description' => 'Create a listing of features.', //description seen when creating a view of this type
-    'priority' => 10, //For Base tripal modules: 10; custom modules: 9 to 0;
-    'base_table' => TRUE //either TRUE or FALSE depending on whether the current table should show up in the add view list
-    'fields' => array(
-      'feature_id' => array(
-        'name' => 'feature_id', //field name in database
-        'title' => 'Feature ID', //human-readable name -seen in Views UI
-        'description' => 'This is the unique identifier for features', //help/description seen in Views UI
-        'type' => 'int', // the type of field
-        'handlers' => array(  //possible keys are field, filter, sort, argument, relationship
-          'field' => array(
-            'name' => 'chado_views_handler_numeric' //name of handler
-          ),
-          'filter' => array( ... ),
-          ...
-        ),
-        // Describe any joins involving this field.
-        // Note: you can include both foreign keys (feature.type_id => cvterm.cvterm_id)
-        // and referring tables (ie: feature.feature_id <= feature_relationship.subject_id)
-        'joins' => array(
-          'feature_relationship' => array( //table to join to.
-            'subject_id' => array( //field in above table (feature_relationship)
-              'table' => 'featureprop', //table to join to
-              'field' => 'feature_id', //field in above table (feature_relationship)
-              'handler' => 'views_join', //handler to use for joining
-              'relationship_handler' => 'views_handler_relationship', //handler to use when a relationship is added.
-              'relationship_only' => FALSE, //whether to join automatically (FALSE) or not (TRUE)
-            ),
-            ...
-          ),
-          ...
-        ),
-      )
-    ),
-  );
-  tripal_add_views_integration($defn_array);
+ *  $defn_array = array(
+ *    'table' => 'feature', //tablename or materialized view name
+ *    'name' => 'Sequence Features', // Human readable name
+ *    'type' => 'chado', //either chado or mview depending on tablename
+ *    'description' => 'Create a listing of features.', //description seen when creating a view of this type
+ *    'priority' => 10, //For Base tripal modules: 10; custom modules: 9 to 0;
+ *    'base_table' => TRUE //either TRUE or FALSE depending on whether the current table should show up in the add view list
+ *    'fields' => array(
+ *      'feature_id' => array(
+ *        'name' => 'feature_id', //field name in database
+ *        'title' => 'Feature ID', //human-readable name -seen in Views UI
+ *         'description' => 'This is the unique identifier for features', //help/description seen in Views UI
+ *         'type' => 'int', // the type of field
+ *        'handlers' => array(  //possible keys are field, filter, sort, argument, relationship
+ *           'field' => array(
+ *             'name' => 'chado_views_handler_numeric' //name of handler
+ *           ),
+ *           'filter' => array( ... ),
+ *           ...
+ *         ),
+ *        // Describe any joins involving this field.
+ *        // Note: you can include both foreign keys (feature.type_id => cvterm.cvterm_id)
+ *        // and referring tables (ie: feature.feature_id <= feature_relationship.subject_id)
+ *         'joins' => array(
+ *          'feature_relationship' => array( //table to join to.
+ *            'subject_id' => array( //field in above table (feature_relationship)
+ *              'table' => 'featureprop', //table to join to
+ *              'field' => 'feature_id', //field in above table (feature_relationship)
+ *              'handler' => 'views_join', //handler to use for joining
+ *              'relationship_handler' => 'views_handler_relationship', //handler to use when a relationship is added.
+ *              'relationship_only' => FALSE, //whether to join automatically (FALSE) or not (TRUE)
+ *            ),
+ *            ...
+ *          ),
+ *          ...
+ *         ),
+ *      )
+ *    ),
+ *  );
+ *  tripal_add_views_integration($defn_array);
  * @endcode
  *
  * @ingroup tripal_chado_views_api
@@ -463,7 +502,7 @@ function tripal_add_views_integration($defn_array, $setup_id = FALSE) {
     return $no_errors;
   }
 
-  // First insert into tripal_views
+  // First insert into tripal_views.
   $view_record = array(
     'table_name' => $defn_array['table'],
     'name' => $defn_array['name'],
@@ -512,7 +551,7 @@ function tripal_add_views_integration($defn_array, $setup_id = FALSE) {
     // Need to update the tripal_views record so base_table can be false
     // this is a fix because drupal_write_record() puts in defaults if !isset()
     // and a variable is considered not set if it's null!
-    // D7 TODO: Check DBTNG changes work
+    // D7 TODO: Check DBTNG changes work.
     db_query(
       "UPDATE {tripal_views} SET base_table=:base WHERE table_name=:table AND priority=:priority",
       array(
@@ -522,7 +561,7 @@ function tripal_add_views_integration($defn_array, $setup_id = FALSE) {
       )
     );
 
-    // Insert Field Definitions
+    // Insert Field Definitions.
     foreach ($defn_array['fields'] as $key => $field) {
       // Set some defaults.
       $field['name'] = (isset($field['name'])) ? $field['name'] : $key;
@@ -541,7 +580,7 @@ function tripal_add_views_integration($defn_array, $setup_id = FALSE) {
       );
       if ($view_record['setup_id'] && $field['name'] && $field['title'] && $field['description'] && $field['type']) {
         if (isset($defn_array['additional_content'])) {
-          // D7 TODO: Check DBTNG changes work
+          // D7 TODO: Check DBTNG changes work.
           $is_present = db_query(
             "SELECT true as present FROM {tripal_views_field} WHERE column_name=:column AND setup_id=:setup",
             array(
@@ -568,7 +607,7 @@ function tripal_add_views_integration($defn_array, $setup_id = FALSE) {
 
       if ($status) {
 
-        // Insert Handler Definitions
+        // Insert Handler Definitions.
         foreach ($field['handlers'] as $handler_type => $handler) {
           $handler_record = array(
             'setup_id' => $view_record['setup_id'],
@@ -608,7 +647,7 @@ function tripal_add_views_integration($defn_array, $setup_id = FALSE) {
             );
           }
 
-          // Loop on left fields
+          // Loop on left fields.
           foreach ($joins as $left_field => $join) {
             $join_record = array(
               'setup_id' => $view_record['setup_id'],
@@ -675,7 +714,8 @@ function tripal_add_views_integration($defn_array, $setup_id = FALSE) {
  *   The unique setup id of the tripal views integration
  *
  * @return
- *   A views integration definition array as used by tripal_add_views_integration()
+ *   A views integration definition array as used by 
+ *   tripal_add_views_integration()
  *
  * @ingroup tripal_chado_views_api
  */
@@ -695,7 +735,7 @@ function tripal_export_views_integration($setup_id) {
     'fields' => array(),
   );
 
-  // Add fields
+  // Add fields.
   $resource = db_query("SELECT * FROM {tripal_views_field} WHERE setup_id=:setup", array(':setup' => $setup_id));
   foreach ($resource as $r) {
     $defn_array['fields'][ $r->column_name ] = array(
@@ -708,7 +748,7 @@ function tripal_export_views_integration($setup_id) {
     );
   }
 
-  // Add handlers
+  // Add handlers.
   $resource = db_query("SELECT * FROM {tripal_views_handlers} WHERE setup_id=:setup", array(':setup' => $setup_id));
   foreach ($resource as $r) {
     $defn_array['fields'][ $r->column_name ]['handlers'][ $r->handler_type ] = array(
@@ -716,7 +756,7 @@ function tripal_export_views_integration($setup_id) {
     );
   }
 
-  // Add joins
+  // Add joins.
   $resource = db_query("SELECT * FROM {tripal_views_join} WHERE setup_id=:setup", array(':setup' => $setup_id));
   foreach ($resource as $r) {
     $defn_array['fields'][ $r->base_field ]['joins'][ $r->left_table ][ $r->left_field ] = array(
@@ -730,31 +770,32 @@ function tripal_export_views_integration($setup_id) {
 }
 
 /**
- * Removes a View Integration Entry when you only know the table the integration was
- * created for and the priority.
+ * Removes a View Integration Entry when you only know the table the integration 
+ * was created for and the priority.
  *
- * This should only be used to remove integrations created by your own module (possibly
- * on uninstall of your module). To override existing integrations simply create your own
- * integration with a lighter priority using tripal_clone_views_integration() or
- * tripal_export_views_integration() to create a template.
+ * This should only be used to remove integrations created by your own module 
+ * (possibly on uninstall of your module). To override existing integrations 
+ * simply create your own integration with a lighter priority using 
+ * tripal_clone_views_integration() or tripal_export_views_integration() to 
+ * create a template.
  *
  * @param $identifies
- *   An array of identifiers where the keys indicate what the identifier is. One of the
- *   following compinations must be present:
- *    1) table_name & priority: the name of the table & the priority to remove a views
- *       integration entry for
- *    2) setup_id: the setup_id of the entry to remove
+ *   An array of identifiers where the keys indicate what the identifier is. 
+ *   One of the following compinations must be present:
+ *    1) table_name & priority: the name of the table & the priority to remove 
+ *        a views integration entry for.
+ *    2) setup_id: the setup_id of the entry to remove.
  * @param $options
- *   An array of options, currently none are supported
+ *   An array of options, currently none are supported.
  *
  * @return
- *   TRUE on Success; FALSE otherwise
+ *   TRUE on Success; FALSE otherwise.
  *
  * @ingroup tripal_chado_views_api
  */
 function tripal_remove_views_integration($identifiers, $options = array()) {
 
-  // Remove the views integration using the table_name/priority combo
+  // Remove the views integration using the table_name/priority combo.
   if (isset($identifiers['table_name'])) {
     $table_name = $identifiers['table_name'];
     $priority = $identifiers['priority'];
@@ -773,7 +814,7 @@ function tripal_remove_views_integration($identifiers, $options = array()) {
 
   }
 
-  // Remove the views integration using the setup_id
+  // Remove the views integration using the setup_id.
   if (isset($identifiers['setup_id'])) {
 
     db_query('DELETE FROM {tripal_views} WHERE setup_id=:setup', array(':setup' => $identifiers['setup_id']));
@@ -808,18 +849,20 @@ function tripal_update_views_integration($setup_id, $defn_array) {
 }
 
 /**
- * Clone an integration. This is often a great way to create your own module-specific
- * integration while still benifiting from an existing (or even the lightest priority)
- * integration.
+ * Clone an integration. This is often a great way to create your own 
+ * module-specific integration while still benifiting from an existing 
+ * (or even the lightest priority) integration.
  *
  * @param $table_name
  *   The table for which you'd like to clone an integration
  * @param $new_priority
  *   The priority of the clone; this is the integration which will be created.
- *   If no priority is supplied then one lighter then the $template_priority will be used.
+ *   If no priority is supplied then one lighter then the $template_priority 
+ *   will be used.
  * @param $template_priority
- *   The priority of the template to be used for the clone; this is an existing integration.
- *   If no priority is supplied then the lightest priority will be used.
+ *   The priority of the template to be used for the clone; this is an existing 
+ *   integration. If no priority is supplied then the lightest priority will be 
+ *   used.
  *
  * @ingroup tripal_chado_views_api
  */
@@ -864,18 +907,21 @@ function tripal_clone_views_integration($table_name, $new_priority = NULL, $temp
 }
 
 /**
- * Adds the given field to an existing or cloned integration. In the case of a cloned
- * integration, the lightest integration is used as the template for the clone.
+ * Adds the given field to an existing or cloned integration. In the case of a
+ * cloned integration, the lightest integration is used as the template for the 
+ * clone.
  *
- * NOTE: If that field already exists in the specified integration then it will first be
- * deleted and the new one added.
+ * NOTE: If that field already exists in the specified integration then it will 
+ * first be deleted and the new one added.
  *
  * @param $table_name
  *   The name of the table the integration is for
  * @param $priority
- *   The priority of the integration to use; pass NULL to use the lightest integration
+ *   The priority of the integration to use; pass NULL to use the lightest 
+ *   integration
  * @param $field
- *   An array describing the field ot add; uses the same format as the $defn_array
+ *   An array describing the field ot add; uses the same format as the
+ *   $defn_array
  *
  * @return
  *   TRUE if the field was added successfully; FALSE otherwise
@@ -885,7 +931,7 @@ function tripal_clone_views_integration($table_name, $new_priority = NULL, $temp
 function tripal_add_field_to_views_integration($table_name, $priority, $field) {
   $no_errors = TRUE;
 
-  // If no priority is supplied then add the field to the lightest integration
+  // If no priority is supplied then add the field to the lightest integration.
   if (empty($priority)) {
     $priority = tripal_get_lightest_views_integration_priority($table_name);
   }
@@ -902,7 +948,7 @@ function tripal_add_field_to_views_integration($table_name, $priority, $field) {
   $setup_id = $setup_id->fetchObject();
 
   // If there isn't an integration matching that table/priority combination
-  // then clone the lightest priority integration
+  // then clone the lightest priority integration.
   if (empty($setup_id)) {
     $setup_id = tripal_clone_views_integration($table_name, $priority);
   }
@@ -918,7 +964,7 @@ function tripal_add_field_to_views_integration($table_name, $priority, $field) {
     array(':setup' => $setup_id, ':table' => $table_name, ':field' => $field['name'])
   );
 
-  // Now we need to add/update the field
+  // Now we need to add/update the field.
   $field_record = array(
     'setup_id' => $setup_id,
     'column_name' => $field['name'],
@@ -928,7 +974,7 @@ function tripal_add_field_to_views_integration($table_name, $priority, $field) {
   );
   if ($setup_id && $field['name'] && $field['title'] && $field['description'] && $field['type']) {
     if ($defn_array['additional_content']) {
-      // D7 TODO: Check DBTNG changes work
+      // D7 TODO: Check DBTNG changes work.
       $is = db_query(
         "SELECT true as present FROM {tripal_views_field} WHERE column_name=:column AND setup_id=:setup",
         array(':column' => $field_record['column_name'], ':setup' => $field_record['setup_id'])
@@ -952,7 +998,7 @@ function tripal_add_field_to_views_integration($table_name, $priority, $field) {
 
   if ($status) {
 
-    // Insert Handler Definitions
+    // Insert Handler Definitions.
     foreach ($field['handlers'] as $handler_type => $handler) {
       $handler_record = array(
         'setup_id' => $setup_id,
@@ -992,7 +1038,7 @@ function tripal_add_field_to_views_integration($table_name, $priority, $field) {
         );
       }
 
-      // Loop on left fields
+      // Loop on left fields.
       foreach ($joins as $left_field => $join) {
         $join_record = array(
           'setup_id' => $setup_id,
@@ -1043,20 +1089,22 @@ function tripal_add_field_to_views_integration($table_name, $priority, $field) {
 }
 
 /**
- * Adds the given field to an existing or cloned integration. In the case of a cloned
- * integration, the lightest integration is used as the template for the clone.
+ * Adds the given field to an existing or cloned integration. In the case of a
+ * cloned integration, the lightest integration is used as the template for the
+ * clone.
  *
- * NOTE: If that field already exists in the specified integration then it will first be
- * deleted and the new one added.
+ * NOTE: If that field already exists in the specified integration then it will
+ * first be deleted and the new one added.
  *
  * @param $table_name
  *   The name of the table the integration is for
  * @param $priority
- *   The priority of the integration to use; pass NULL to use the lightest integration
+ *   The priority of the integration to use; pass NULL to use the lightest
+ *   integration
  * @param $field
  *   An array describing the join to add. it should contain the following keys:
- *   base_table, base_field, left_table, left_field, handler, relationship_handler,
- *   relationship_only
+ *   base_table, base_field, left_table, left_field, handler, 
+ *   relationship_handler, relationship_only
  *
  * @return
  *   TRUE if the field was added successfully; FALSE otherwise
@@ -1066,12 +1114,12 @@ function tripal_add_field_to_views_integration($table_name, $priority, $field) {
 function tripal_add_join_to_views_integration($table_name, $priority, $join) {
   $no_errors = TRUE;
 
-  // If no priority is supplied then add the field to the lightest integration
+  // If no priority is supplied then add the field to the lightest integration.
   if (empty($priority)) {
     $priority = tripal_get_lightest_views_integration_priority($table_name);
   }
 
-  // First get the setup_id
+  // First get the setup_id.
   $setup_id = db_query(
     "SELECT setup_id FROM {tripal_views} WHERE table_name=:table AND priority=:priority",
     array(
@@ -1082,7 +1130,7 @@ function tripal_add_join_to_views_integration($table_name, $priority, $join) {
   $setup_id = $setup_id->fetchField();
 
   // If there isn't an integration matching that table/priority combination
-  // then clone the lightest priority integration
+  // then clone the lightest priority integration.
   if (empty($setup_id)) {
     $setup_id = tripal_clone_views_integration($table_name, $priority);
   }
@@ -1094,19 +1142,19 @@ function tripal_add_join_to_views_integration($table_name, $priority, $join) {
 }
 
 /**
- * Remove a join from an integration. This is usually done after cloning an existing
- * integration using tripal_clone_views_integration().
+ * Remove a join from an integration. This is usually done after cloning an 
+ * existing integration using tripal_clone_views_integration().
  *
  * @param $setup_id
- *   The setup_id of the integration to delete the join from
+ *   The setup_id of the integration to delete the join from.
  * @param $base_table
- *   The name of the base table involved the join
+ *   The name of the base table involved the join.
  * @param $base_field
- *   The field from the base table involved in the join
+ *   The field from the base table involved in the join.
  * @param $left_table
  *   The name of the other table involved in the join
  * @param $left_field
- *   The name of the field from the other table involved in the join
+ *   The name of the field from the other table involved in the join.
  *
  * @ingroup tripal_chado_views_api
  */

tripal_chado_views/tripal_chado_views.views.inc

@@ -118,7 +118,7 @@ function tripal_chado_views_views_data() {
   $data = tripal_chado_views_views_data_tripal_views_tables($data);
 
   // Determine the name of the chado schema
-  $chado_schema = tripal_get_schema_name('chado');
+  $chado_schema = chado_get_schema_name('chado');
 
   // MAKE SURE ALL CHADO TABLES ARE INTEGRATED
   tripal_chado_views_integrate_all_chado_tables();