Index: trunk/ippToPsps/config/tables.DO.vot
===================================================================
--- trunk/ippToPsps/config/tables.DO.vot	(revision 38723)
+++ trunk/ippToPsps/config/tables.DO.vot	(revision 38751)
@@ -4,113 +4,113 @@
   <RESOURCE>
     <TABLE name="DiffDetObject">
-      <DESCRIPTION>VOTable description of PSPS table DifDetObject</DESCRIPTION>
+      <DESCRIPTION>Contains the positional information for difference detection objects in a number of coordinate systems.  The number of detections in each filter from is listed, along with maximum coverage fractions.  References: Szalay, A. S., Gray, J., Fekete, G., et al. 2007, arXiv:cs/0701164.</DESCRIPTION>
       <PARAM arraysize="1" datatype="char" ucd="meta.bib.author" name="Author" value="PSPS"></PARAM>
-      <FIELD name="diffObjName" arraysize="100" datatype="char" unit="alphanumeric" default="NA">
-        <DESCRIPTION>IAU Name constructed from objID position PSO JHHMMSS.SS+/-</DESCRIPTION>
+      <FIELD name="diffObjName" arraysize="100" datatype="char" unit="dimensionless" default="NA">
+        <DESCRIPTION>IAU name for this object.</DESCRIPTION>
       </FIELD>
       <FIELD name="diffObjID" arraysize="1" datatype="long" unit="dimensionless" default="NA">
-        <DESCRIPTION>ODM object identifier index</DESCRIPTION>
+        <DESCRIPTION>Unique difference object identifier.</DESCRIPTION>
       </FIELD>
       <FIELD name="uniquePspsDOid" arraysize="1" datatype="long" unit="dimensionless" default="NA">
-	<DESCRIPTION>unique psps diff object id based on batch id and row number</DESCRIPTION>
+	<DESCRIPTION>Unique internal PSPS difference object identifier.</DESCRIPTION>
       </FIELD>
       <FIELD name="ippObjID" arraysize="1" datatype="long" unit="dimensionless" default="NA">
-        <DESCRIPTION>IPP object number</DESCRIPTION>
+        <DESCRIPTION>IPP internal object identifier.</DESCRIPTION>
       </FIELD>
-      <FIELD name="surveyID" arraysize="1" datatype="unsignedByte" unit="dimensionless" default="255">
-	<DESCRIPTION>Survey ID</DESCRIPTION>
+      <FIELD name="surveyID" arraysize="1" datatype="unsignedByte" unit="dimensionless" default="NA">
+	<DESCRIPTION>Survey identifier.  Details in the Survey table.</DESCRIPTION>
       </FIELD>
       <FIELD name="htmID" arraysize="1" datatype="long" unit="dimensionless" default="NA">
-        <DESCRIPTION>HTM index</DESCRIPTION>
+        <DESCRIPTION>Hierarchical triangular mesh (Szalay 2007) index.</DESCRIPTION>
       </FIELD>
       <FIELD name="zoneID" arraysize="1" datatype="int" unit="dimensionless" default="NA">
-        <DESCRIPTION>Zone index</DESCRIPTION>
+        <DESCRIPTION>Local zone index, found by dividing the sky into bands of declination 1/2 arcminute in height: zoneID = floor((90 + declination)/0.0083333).</DESCRIPTION>
       </FIELD>
-      <FIELD name="randomDiffObjID" arraysize="1" datatype="double" unit="dimensionless" default="0">
-	<DESCRIPTION>Random integer between 0 and 2^32 = 4,394,967,296</DESCRIPTION>
+      <FIELD name="randomDiffObjID" arraysize="1" datatype="double" unit="dimensionless" default="NA">
+	<DESCRIPTION>Random value drawn from the interval between zero and one.</DESCRIPTION>
       </FIELD>
-      <FIELD name="batchID" arraysize="1" datatype="long" unit="dimensionless" default="-999">
-	<DESCRIPTION>batchID</DESCRIPTION>
+      <FIELD name="batchID" arraysize="1" datatype="long" unit="dimensionless" default="NA">
+	<DESCRIPTION>Internal database batch identifier.</DESCRIPTION>
       </FIELD>
       <FIELD name="dvoRegionID" arraysize="1" datatype="float" unit="dimensionless" default="-999">
-	<DESCRIPTION>identifier to dvo spatial region</DESCRIPTION>
+	<DESCRIPTION>Internal DVO region identifier.</DESCRIPTION>
       </FIELD>
       <FIELD name="objInfoFlag" arraysize="1" datatype="long" unit="dimensionless" default="-999">
-        <DESCRIPTION>flag indicating odd properties</DESCRIPTION>
+        <DESCRIPTION>Information flag bitmask indicating details of the photometry.  Values listed in ObjectInfoFlags.</DESCRIPTION>
       </FIELD>
       <FIELD name="qualityFlag" arraysize="1" datatype="unsignedByte" unit="dimensionless" default="0">
-        <DESCRIPTION>subset of objInfoFlag - flags related to goodness of object</DESCRIPTION>
+        <DESCRIPTION>Subset of objInfoFlag denoting whether this object is real or a likely false positive.  Values listed in ObjectQualityFlags.</DESCRIPTION>
       </FIELD>
       <FIELD name="consistencyFlag" arraysize="1" datatype="short" unit="dimensionless" default="0">
-        <DESCRIPTION>Value computed from associated detections, it is originally given by IPP and should agree with the ODM validation</DESCRIPTION>
+        <DESCRIPTION></DESCRIPTION>
       </FIELD>
       <FIELD name="ra" arraysize="1" datatype="double" unit="degrees" default="NA">
-        <DESCRIPTION> Right Ascension</DESCRIPTION>
+        <DESCRIPTION>Right ascension mean.</DESCRIPTION>
       </FIELD>
       <FIELD name="dec" arraysize="1" datatype="double" unit="degrees" default="NA">
-        <DESCRIPTION> Declination</DESCRIPTION>
+        <DESCRIPTION>Declination mean.</DESCRIPTION>
       </FIELD>
       <FIELD name="raErr" arraysize="1" datatype="float" unit="arcsec" default="0.0">
-        <DESCRIPTION> Right Ascension error</DESCRIPTION>
+        <DESCRIPTION>Right ascension standard deviation.</DESCRIPTION>
       </FIELD>
       <FIELD name="decErr" arraysize="1" datatype="float" unit="arcsec" default="0.0">
-        <DESCRIPTION> Declination error</DESCRIPTION>
+        <DESCRIPTION>Declination standard deviation.</DESCRIPTION>
       </FIELD>
       <FIELD name="cx" arraysize="1" datatype="double" unit="dimensionless" default="NA"> 
-	<DESCRIPTION>Cartesian x</DESCRIPTION> 
+	<DESCRIPTION>Cartesian x on a unit sphere.</DESCRIPTION> 
       </FIELD> 
       <FIELD name="cy" arraysize="1" datatype="double" unit="dimensionless" default="NA"> 
-        <DESCRIPTION>Cartesian y</DESCRIPTION> 
+        <DESCRIPTION>Cartesian y on a unit sphere.</DESCRIPTION> 
       </FIELD> 
       <FIELD name="cz" arraysize="1" datatype="double" unit="dimensionless" default="NA"> 
-        <DESCRIPTION>Cartesian z</DESCRIPTION> 
+        <DESCRIPTION>Cartesian z on a unit sphere.</DESCRIPTION> 
       </FIELD> 
       <FIELD name="lambda" arraysize="1" datatype="double" unit="degrees" default="-999">
-        <DESCRIPTION> ecliptic longitude</DESCRIPTION>
+        <DESCRIPTION>Ecliptic longitude.</DESCRIPTION>
       </FIELD>
       <FIELD name="beta" arraysize="1" datatype="double" unit="degrees" default="-999">
-        <DESCRIPTION> ecliptic latitude</DESCRIPTION>
+        <DESCRIPTION>Ecliptic latitude.</DESCRIPTION>
       </FIELD>
       <FIELD name="l" arraysize="1" datatype="double" unit="degrees" default="-999">
-        <DESCRIPTION> galactic longitude</DESCRIPTION>
+        <DESCRIPTION>Galactic longitude.</DESCRIPTION>
       </FIELD>
       <FIELD name="b" arraysize="1" datatype="double" unit="degrees" default="-999">
-        <DESCRIPTION> galactic latitude</DESCRIPTION>
+        <DESCRIPTION>Galactic latitude.</DESCRIPTION>
       </FIELD>
       <FIELD name="gQfPerfect" arraysize="1" datatype="float" unit="dimensionless" default="-999">
-        <DESCRIPTION>qf perfect for g filter</DESCRIPTION>
+        <DESCRIPTION>Maximum PSF weighted fraction of pixels totally unmasked from g filter detections.</DESCRIPTION>
       </FIELD>
       <FIELD name="rQfPerfect" arraysize="1" datatype="float" unit="dimensionless" default="-999">
-        <DESCRIPTION>qf perfect for r filter</DESCRIPTION>
+        <DESCRIPTION>Maximum PSF weighted fraction of pixels totally unmasked from r filter detections.</DESCRIPTION>
       </FIELD>
       <FIELD name="iQfPerfect" arraysize="1" datatype="float" unit="dimensionless" default="-999">
-        <DESCRIPTION>qf perfect for i filter</DESCRIPTION>
+        <DESCRIPTION>Maximum PSF weighted fraction of pixels totally unmasked from i filter detections.</DESCRIPTION>
       </FIELD>
       <FIELD name="zQfPerfect" arraysize="1" datatype="float" unit="dimensionless" default="-999">
-        <DESCRIPTION>qf perfect for z filter</DESCRIPTION>
+        <DESCRIPTION>Maximum PSF weighted fraction of pixels totally unmasked from z filter detections.</DESCRIPTION>
       </FIELD>
       <FIELD name="yQfPerfect" arraysize="1" datatype="float" unit="dimensionless" default="-999">
-        <DESCRIPTION>qf perfect for y filter</DESCRIPTION>
+        <DESCRIPTION>Maximum PSF weighted fraction of pixels totally unmasked from y filter detections.</DESCRIPTION>
       </FIELD>
       <FIELD name="dataRelease" arraysize="1" datatype="unsignedByte" unit="dimensionless" default="NA">
-        <DESCRIPTION>Data release</DESCRIPTION>
+        <DESCRIPTION>Data release version.</DESCRIPTION>
       </FIELD>
       <FIELD name="nDetections" arraysize="1" datatype="short" unit="dimensionless" default="-999">
-        <DESCRIPTION>total number of detection measurements in all filters</DESCRIPTION>
+        <DESCRIPTION>Number of difference detections in all filter.</DESCRIPTION>
       </FIELD>
       <FIELD name="ng" arraysize="1" datatype="short" unit="dimensionless" default="-999">
-        <DESCRIPTION>number of measures in g filter</DESCRIPTION>
+        <DESCRIPTION>Number of difference detections in g filter.</DESCRIPTION>
       </FIELD>
       <FIELD name="nr" arraysize="1" datatype="short" unit="dimensionless" default="-999">
-        <DESCRIPTION>number of measures in r filter</DESCRIPTION>
+        <DESCRIPTION>Number of difference detections in r filter.</DESCRIPTION>
       </FIELD>
       <FIELD name="ni" arraysize="1" datatype="short" unit="dimensionless" default="-999">
-        <DESCRIPTION>number of measures in i filter</DESCRIPTION>
+        <DESCRIPTION>Number of difference detections in i filter.</DESCRIPTION>
       </FIELD>
       <FIELD name="nz" arraysize="1" datatype="short" unit="dimensionless" default="-999">
-        <DESCRIPTION>number of measures in z filter</DESCRIPTION>
+        <DESCRIPTION>Number of difference detections in z filter.</DESCRIPTION>
       </FIELD>
       <FIELD name="ny" arraysize="1" datatype="short" unit="dimensionless" default="-999">
-        <DESCRIPTION>number of measures in y filter</DESCRIPTION>
+        <DESCRIPTION>Number of difference detections in y filter.</DESCRIPTION>
       </FIELD>
       <DATA>
