<h2>org.das2.qds.util.AsciiHeadersParser</h2><p>This additional support for parsing ascii data looks at the comment block in
 an ASCII file for a structured set of Dataset tags further describing the
 data.  This is loosely formatted JSON that describes each column of the
 data file more abstractly than the AsciiParser.

 This is based on QDataSet metadata tags, as much as possible.</p>
<h2>AsciiHeadersParser( )</h2>
<p></p>

<hr>
<a name="PROP_DIMENSION"></a>
<h2>PROP_DIMENSION</h2>
<p>property for dimension of the data defining rank and qube dims. For example,
   "[]" (default}
   "[1]" scalar--alternate form, and [] is preferred.
   "[3]" (three element vector)
   "[20,30]" (qube of 60 elements).</p>

<hr>
<a name="PROP_ELEMENT_NAMES"></a>
<h2>PROP_ELEMENT_NAMES</h2>
<p>NAME identifier to assign to each column of the parameter.  These should follow QDataSet NAME rules.
 This is always a 1-D array.</p>

<hr>
<a name="PROP_ELEMENT_LABELS"></a>
<h2>PROP_ELEMENT_LABELS</h2>
<p>Human-readable label for each column of the parameter.</p>

<hr>
<a name="getInlineDataSet"></a>
<h2>getInlineDataSet</h2>
getInlineDataSet( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/QDataSet.html'>QDataSet</a> bds, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> name ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/QDataSet.html'>QDataSet</a>

<p>allow inline dataset to be retrieved.</p>

<h3>Parameters</h3>
bds - a BundleDescriptor, from BUNDLE_1.  This must have been created by this code.
<br>
name - the name of the inline dataset

<h3>Returns:</h3>
the dataset, or null if the dataset is not found.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=getInlineDataSet&unscoped_q=getInlineDataSet">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiHeadersParser.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiHeadersParser.html#getInlineDataSet">[view on old javadoc]</a>
 <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiHeadersParser.java#l1198">[view source]</a>
<br>
<br>
<hr>
<a name="getInlineDataSetNames"></a>
<h2>getInlineDataSetNames</h2>
getInlineDataSetNames( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/QDataSet.html'>QDataSet</a> bds ) &rarr; <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a>

<p>return the list of inline dataset names.  This was probably used during
 development.</p>

<h3>Parameters</h3>
bds - bundle dataset descriptor, though only BundleDescriptor is supported.

<h3>Returns:</h3>
the inline dataset names.
<br><br>
<a href="https://github.com/autoplot/dev/search?q=getInlineDataSetNames&unscoped_q=getInlineDataSetNames">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiHeadersParser.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiHeadersParser.html#getInlineDataSetNames">[view on old javadoc]</a>
 <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiHeadersParser.java#l1214">[view source]</a>
<br>
<br>
<hr>
<a name="parseMetadata"></a>
<h2>parseMetadata</h2>
parseMetadata( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> header, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a> columns, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a> columnLabels ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiHeadersParser/BundleDescriptor.html'>org.das2.qds.util.AsciiHeadersParser.BundleDescriptor</a>

<p>attempt to parse the JSON metadata stored in the header.  The header lines must
 be prefixed with hash (#).  Loosely formatted text is converted into
 nicely-formatted JSON and then parsed with a JSON parser.  Note the Java
 JSON parser itself is pretty loose, for example allowing 1-word strings to
 go without quote delimiters.  The scheme for this header is either:<ul>
 <li>"rich ascii" or http://autoplot.org/richAscii
 <li>"hapi" https://github.com/hapi-server/data-specification/blob/master/hapi-dev/HAPI-data-access-spec-dev.md#info
 </ul></p>

<h3>Parameters</h3>
header - the JSON header
<br>
columns - identifiers for each column
<br>
columnLabels - labels for each column

<h3>Returns:</h3>
the BundleDescriptor
<h3>See Also:</h3>
<a href='http://autoplot.org/richAscii'>http://autoplot.org/richAscii</a> <br>
<a href='https://github.com/hapi-server/data-specification/blob/master/hapi-dev/HAPI-data-access-spec-dev.md#info'>https://github.com/hapi-server/data-specification/blob/master/hapi-dev/HAPI-data-access-spec-dev.md#info</a> <br>
<br><br>
<a href="https://github.com/autoplot/dev/search?q=parseMetadata&unscoped_q=parseMetadata">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiHeadersParser.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiHeadersParser.html#parseMetadata">[view on old javadoc]</a>
 <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiHeadersParser.java#l686">[view source]</a>
<br>
<br>
<hr>
<a name="parseMetadataHapi"></a>
<h2>parseMetadataHapi</h2>
parseMetadataHapi( JSONObject doc ) &rarr; <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiHeadersParser/BundleDescriptor.html'>org.das2.qds.util.AsciiHeadersParser.BundleDescriptor</a>

<p></p>

<h3>Parameters</h3>
doc - a JSONObject

<h3>Returns:</h3>
org.das2.qds.util.AsciiHeadersParser.BundleDescriptor

<br><br>
<a href="https://github.com/autoplot/dev/search?q=parseMetadataHapi&unscoped_q=parseMetadataHapi">[search for examples]</a>
 <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiHeadersParser.md">[view on GitHub]</a>
 <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiHeadersParser.html#parseMetadataHapi">[view on old javadoc]</a>
 <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiHeadersParser.java#l610">[view source]</a>
<br>
<br>