Changes between Version 1 and Version 2 of DataFormat

Timestamp:

Jul 17, 2008, 6:31:07 PM (16 years ago)

Author:

buckley

Comment:

--

DataFormat

@@ -11 +11 @@
  * The hash sign ({{{#}}}) is to be interpreted as a comment character in the manner of Python. '''Need some way to declare that a comment is actually a header?'''
  * An arbitrary number of headers may be present on each object. We recommend that these headers are escaped by a prefix {{{#}}} character, for compatibility with gnuplot
- * For compatibility with gnuplot, the first 6 '''???''' data columns of records must be compatible with the gnuplot "plot with xyerrors" format, namely: x, y, xlow, xhigh, ylow, yhigh
+ * For compatibility with gnuplot, the first 6 '''???''' data columns of records must be compatible with the gnuplot "plot with xyerrors" format, namely: 
+{{{
+x, y, xlow, xhigh, ylow, yhigh
+}}}
 
 === HISTOGRAM ===
@@ -20 +23 @@
 === COUNTER ===
 
+A Counter class is not yet confirmed for inclusion in YODA, but seems useful (and is usually overlooked)
+
+{{{
+sumw, sumw2
+}}}
+
+(only one line)
+
 === DBN1D ===
+
+An extension of Counter which is used for internally managing the x data of Histo1D bins and the content of Profile1D bins. Not yet confirmed for public use.
+
+{{{
+xmean, xerr, sumw, sumw2, sumwx
+}}}
+
+(only one line)
 
 === BAR1D ===
 
+Bar plots are like histograms, but the x axis is discrete. Hence, there is no meaning to the x-spread data, and y-heights should be displayed without a width scaling. Not yet confirmed for use in YODA, but the confusion over histogram height scaling (and the mess of HepData records) suggests that we could do with an explicit type for this. '''How to deal with integral distributions? Convert from Histo1D -> ???'''
+
+{{{
+barname, <Counter>
+}}}
+
+(multiple lines - one per bar)
+
 === HISTO1D ===
 
+The main data type.
+
+{{{
+xcenter, ycenter, xlow, xhigh, ylow, yhigh, sumw, sumw2, sumwx
+}}}
+
+(multiple lines - one per bin)
+
 === PROFILE1D ===
+
+{{{
+xcenter, ycenter, xlow, xhigh, ylow, yhigh, sumw, sumw2, sumwx, sumwy
+}}}
+
+(multiple lines - one per bin)
+
+=== SCATTER1D ===
+
+{{{
+
+}}}
+
+(multiple lines - one per point)
+
+=== SCATTER2D ===
+
+
+{{{
+
+}}}
+
+(multiple lines - one per point)