diff -u -r1.1.1.1 -r1.2
--- MCTruthVS.java	10 Dec 2008 22:03:06 -0000	1.1.1.1
+++ MCTruthVS.java	24 Jan 2009 05:11:49 -0000	1.2
@@ -20,14 +20,12 @@

 import org.lcsim.contrib.onoprien.vsegment.hit.VSTrackerHit;
 
 /**

- * An object of this class provides convenient access to Monte Carlo truth information.

+ * An object of this class provides convenient access to tracker-related Monte Carlo truth information.

  * In order for this object to be created, an instance of {@link MCTruthDriverVS} should
  * be added to the processing chain (usually as the first driver).
  * 

- * 
- * 

  * @author D. Onoprienko

- * @version $Id: MCTruthVS.java,v 1.1.1.1 2008/12/10 22:03:06 jeremy Exp $

+ * @version $Id: MCTruthVS.java,v 1.2 2009/01/24 05:11:49 onoprien Exp $

  */
 public class MCTruthVS {
   

@@ -107,10 +105,13 @@

 
 
 // -- Looking up tracking objects by MCParticle :  -----------------------------

-  

+
+  /**
+   * Returns a list of tracker clusters to which the specified <tt>MCParticle</tt> has contributed.
+   */

   public List<VSTrackerHit> getTrackerClusters(MCParticle mcParticle) {

-    if (_mc2th == null) {
-      _mc2th = new BaseRelationalTable<MCParticle, VSTrackerHit>(RelationalTable.Mode.MANY_TO_MANY, RelationalTable.Weighting.UNWEIGHTED);

+    if (_mc2tc == null) {
+      _mc2tc = new BaseRelationalTable<MCParticle, VSTrackerHit>(RelationalTable.Mode.MANY_TO_MANY, RelationalTable.Weighting.UNWEIGHTED);

       Object o;
       for (String mapName : _mcDriver._trackerClusterNames) {
         try {

@@ -122,12 +123,12 @@

         for (VSTrackerHit cluster : map) {
           List<MCParticle> mcList = getMCParticles(cluster);
           for (MCParticle mc : mcList) {

-            _mc2th.add(mc, cluster);

+            _mc2tc.add(mc, cluster);

           }
         }
       }
     }

-    return new ArrayList(_mc2th.allFrom(mcParticle));

+    return new ArrayList(_mc2tc.allFrom(mcParticle));

   }
 
   

@@ -140,5 +141,5 @@

   private RelationalTable<ITrackerPulse, SimTrackerHit> _tp2sth;
   private RelationalTable<ITrackerHit, SimTrackerHit> _th2sth;
   

-  private RelationalTable<MCParticle, VSTrackerHit> _mc2th;

+  private RelationalTable<MCParticle, VSTrackerHit> _mc2tc;

 }