<h2>org.das2.qds.util.AsciiParser</h2><p>Class for reading ASCII tables into a QDataSet. This parses a file by breaking it up into records, and passing the record off to a delegate record parser. The record parser then breaks up the record into fields, and each field is parsed by a delegate field parser. Each column of the table has a Unit, field name, and field label associated with it. Examples of record parsers include DelimParser, which splits the record by a delimiter such as a tab or comma, RegexParser, which processes each record with a regular expression to get the fields, and FixedColumnsParser, which splits the record by character positions. Example of field parsers include DOUBLE_PARSER which parses the value as a double, and UNITS_PARSER, which uses the Unit attached to the column to interpret the value. When the first record with the correct number of fields is found but is not parseable, we look for field labels and units. The skipLines property tells the parser to skip a given number of header lines before attempting to parse the record. Also, commentPrefix identifies lines to be ignored. In either the header or in comments, we look for propertyPattern, and if a property is matched, then the builder property is set. Two Patterns are provided NAME_COLON_VALUE_PATTERN and NAME_EQUAL_VALUE_PATTERN for convenience. Adapted to QDataSet model, Jeremy, May 2007.</p> <h2>AsciiParser( )</h2> <p>Creates a new instance. This is created and then configured before any files can be parsed.</p> <hr> <a name="NAME_COLON_VALUE_PATTERN"></a> <h2>NAME_COLON_VALUE_PATTERN</h2> <p>pattern for name:value.</p> <hr> <a name="NAME_EQUAL_VALUE_PATTERN"></a> <h2>NAME_EQUAL_VALUE_PATTERN</h2> <p>pattern for name=value.</p> <hr> <a name="PROPERTY_FIELD_NAMES"></a> <h2>PROPERTY_FIELD_NAMES</h2> <p></p> <hr> <a name="PROPERTY_FILE_HEADER"></a> <h2>PROPERTY_FILE_HEADER</h2> <p></p> <hr> <a name="PROPERTY_FIRST_RECORD"></a> <h2>PROPERTY_FIRST_RECORD</h2> <p></p> <hr> <a name="PROPERTY_FIELD_PARSER"></a> <h2>PROPERTY_FIELD_PARSER</h2> <p></p> <hr> <a name="DELIM_COMMA"></a> <h2>DELIM_COMMA</h2> <p></p> <hr> <a name="DELIM_TAB"></a> <h2>DELIM_TAB</h2> <p></p> <hr> <a name="DELIM_WHITESPACE"></a> <h2>DELIM_WHITESPACE</h2> <p></p> <hr> <a name="UNIT_UTC"></a> <h2>UNIT_UTC</h2> <p>Convenient unit for parsing UTC times.</p> <hr> <a name="PROP_HEADERDELIMITER"></a> <h2>PROP_HEADERDELIMITER</h2> <p></p> <hr> <a name="DOUBLE_PARSER"></a> <h2>DOUBLE_PARSER</h2> <p>parses the field using Double.parseDouble, Java's double parser.</p> <hr> <a name="UNITS_PARSER"></a> <h2>UNITS_PARSER</h2> <p>delegates to the unit object set for this field to parse the data.</p> <hr> <a name="ENUMERATION_PARSER"></a> <h2>ENUMERATION_PARSER</h2> <p>uses the EnumerationUnits for the field to create a Datum.</p> <hr> <a name="PROP_VALIDMIN"></a> <h2>PROP_VALIDMIN</h2> <p></p> <hr> <a name="PROP_VALIDMAX"></a> <h2>PROP_VALIDMAX</h2> <p></p> <hr> <a name="addPropertyChangeListener"></a> <h2>addPropertyChangeListener</h2> addPropertyChangeListener( <a href='https://docs.oracle.com/javase/8/docs/api/java/beans/PropertyChangeListener.html'>java.beans.PropertyChangeListener</a> l ) → void <p>Adds a PropertyChangeListener to the listener list.</p> <h3>Parameters</h3> l - The listener to add. <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=addPropertyChangeListener&unscoped_q=addPropertyChangeListener">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#addPropertyChangeListener">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2729">[view source]</a> <br> <br> <hr> <a name="getDelimParser"></a> <h2>getDelimParser</h2> getDelimParser( int fieldCount, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> delim ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/DelimParser.html'>org.das2.qds.util.AsciiParser.DelimParser</a> <p>provide more control to external codes by providing a way to assert that an N-column delim parser should be used.</p> <h3>Parameters</h3> fieldCount - an int <br> delim - the delimiter pattern, such as "," or "\s+" <h3>Returns:</h3> the DelimParser. <br><br> <a href="https://github.com/autoplot/dev/search?q=getDelimParser&unscoped_q=getDelimParser">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getDelimParser">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l1731">[view source]</a> <br> <br> <hr> <a name="getFieldCount"></a> <h2>getFieldCount</h2> getFieldCount( ) → int <p>return the number of fields in each record. Note the RecordParsers also have a fieldCount, which should be equal to this. This allows them to be independent of the parser.</p> <h3>Returns:</h3> an int <br><br> <a href="https://github.com/autoplot/dev/search?q=getFieldCount&unscoped_q=getFieldCount">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getFieldCount">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2579">[view source]</a> <br> <br> <hr> <a name="getFieldIndex"></a> <h2>getFieldIndex</h2> getFieldIndex( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> string ) → int <p>returns the index of the field. Supports the name, or field0, or 0, etc. returns -1 when the column is not identified.</p> <h3>Parameters</h3> string - the label for the field, such as "field2" or "time" <h3>Returns:</h3> -1 or the index of the field. <br><br> <a href="https://github.com/autoplot/dev/search?q=getFieldIndex&unscoped_q=getFieldIndex">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getFieldIndex">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2833">[view source]</a> <br> <br> <hr> <a name="getFieldLabels"></a> <h2>getFieldLabels</h2> getFieldLabels( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a> <p>return the labels found for each field. If a label wasn't found, then the name is returned.</p> <h3>Returns:</h3> a String[] <br><br> <a href="https://github.com/autoplot/dev/search?q=getFieldLabels&unscoped_q=getFieldLabels">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getFieldLabels">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2602">[view source]</a> <br> <br> <hr> <a name="getFieldNames"></a> <h2>getFieldNames</h2> getFieldNames( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a> <p>return the name of each field. field0, field1, ... are the default names when names are not discovered in the table. Changing the array will not affect internal representation.</p> <h3>Returns:</h3> a String[] <br><br> <a href="https://github.com/autoplot/dev/search?q=getFieldNames&unscoped_q=getFieldNames">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getFieldNames">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2589">[view source]</a> <br> <br> <hr> <a name="getFieldUnits"></a> <h2>getFieldUnits</h2> getFieldUnits( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a> <p>return the units that were associated with the field. This might also be the channel label for spectrograms. In "field0(str)" or "field0[str]" this is str. elements may be null if not found.</p> <h3>Returns:</h3> a String[] <br><br> <a href="https://github.com/autoplot/dev/search?q=getFieldUnits&unscoped_q=getFieldUnits">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getFieldUnits">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2620">[view source]</a> <br> <br> <hr> <a name="getFillValue"></a> <h2>getFillValue</h2> getFillValue( ) → double <p>return the fillValue. numbers that parse to this value are considered to be fill. Note validMin and validMax may be used as well.</p> <h3>Returns:</h3> Value of property fillValue. <br><br> <a href="https://github.com/autoplot/dev/search?q=getFillValue&unscoped_q=getFillValue">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getFillValue">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2863">[view source]</a> <br> <br> <hr> <a name="getHeaderDelimiter"></a> <h2>getHeaderDelimiter</h2> getHeaderDelimiter( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>get the header delimiter</p> <h3>Returns:</h3> the header delimiter. <br><br> <a href="https://github.com/autoplot/dev/search?q=getHeaderDelimiter&unscoped_q=getHeaderDelimiter">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getHeaderDelimiter">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l945">[view source]</a> <br> <br> <hr> <a name="getRecordParser"></a> <h2>getRecordParser</h2> getRecordParser( ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/RecordParser.html'>org.das2.qds.util.AsciiParser.RecordParser</a> <p>Getter for property recordParser.</p> <h3>Returns:</h3> Value of property recordParser. <br><br> <a href="https://github.com/autoplot/dev/search?q=getRecordParser&unscoped_q=getRecordParser">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getRecordParser">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2769">[view source]</a> <br> <br> <hr> <a name="getRegexForFormat"></a> <h2>getRegexForFormat</h2> getRegexForFormat( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> format ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>Convert FORTRAN (F77) style format to C-style format specifiers.</p> <h3>Parameters</h3> format - for example "%5d%5d%9f%s" <h3>Returns:</h3> for example "d5,d5,f9,a" <h3>See Also:</h3> <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/autoplot/metatree/MetadataUtil.html#normalizeFormatSpecifier'>org.autoplot.metatree.MetadataUtil#normalizeFormatSpecifier</a> <br> <br><br> <a href="https://github.com/autoplot/dev/search?q=getRegexForFormat&unscoped_q=getRegexForFormat">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getRegexForFormat">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2115">[view source]</a> <br> <br> <hr> <a name="getRegexParser"></a> <h2>getRegexParser</h2> getRegexParser( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> regex ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/RegexParser.html'>org.das2.qds.util.AsciiParser.RegexParser</a> <p>return a regex parser for the given regular expression. Groups are used for the fields, for example getRegexParser( 'X (\d+) (\d+)' ) would parse lines like "X 00005 00006".</p> <h3>Parameters</h3> regex - a String <h3>Returns:</h3> the regex parser <br><br> <a href="https://github.com/autoplot/dev/search?q=getRegexParser&unscoped_q=getRegexParser">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getRegexParser">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2212">[view source]</a> <br> <br> <hr> <a name="getRegexParserForFormat"></a> <h2>getRegexParserForFormat</h2> getRegexParserForFormat( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> format ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/RegexParser.html'>org.das2.qds.util.AsciiParser.RegexParser</a> <p>see private TimeParser(String formatString, Map<String,FieldHandler> fieldHandlers)</tt>, which is very similar.<ul> <li>"%5d%5d%9f%s" <li>"d5,d5,f9,a" </ul></p> <h3>Parameters</h3> format - a String <h3>Returns:</h3> an org.das2.qds.util.AsciiParser.RegexParser <h3>See Also:</h3> <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/TimeParser.html'>org.das2.datum.TimeParser</a> <br> <br><br> <a href="https://github.com/autoplot/dev/search?q=getRegexParserForFormat&unscoped_q=getRegexParserForFormat">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getRegexParserForFormat">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2198">[view source]</a> <br> <br> <hr> <a name="getRichFields"></a> <h2>getRichFields</h2> getRichFields( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/util/Map.html'>java.util.Map</a> <p>returns the high rank rich fields in a map from NAME to LABEL. NAME:>fieldX< or NAME:>fieldX-fieldY<</p> <h3>Returns:</h3> the high rank rich fields in a map from NAME to LABEL. <br><br> <a href="https://github.com/autoplot/dev/search?q=getRichFields&unscoped_q=getRichFields">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getRichFields">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l1288">[view source]</a> <br> <br> <hr> <a name="getUnits"></a> <h2>getUnits</h2> getUnits( int index ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> <p>Indexed getter for property units.</p> <h3>Parameters</h3> index - Index of the property. <h3>Returns:</h3> Value of the property at <CODE>index</CODE>. <br><br> <a href="https://github.com/autoplot/dev/search?q=getUnits&unscoped_q=getUnits">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getUnits">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2788">[view source]</a> <br> <br> <hr> <a name="getValidMax"></a> <h2>getValidMax</h2> getValidMax( ) → double <p>get the maximum value for any field.</p> <h3>Returns:</h3> the validMax <br><br> <a href="https://github.com/autoplot/dev/search?q=getValidMax&unscoped_q=getValidMax">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getValidMax">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2906">[view source]</a> <br> <br> <hr> <a name="getValidMin"></a> <h2>getValidMin</h2> getValidMin( ) → double <p>get the minimum valid value for any field.</p> <h3>Returns:</h3> validMin <br><br> <a href="https://github.com/autoplot/dev/search?q=getValidMin&unscoped_q=getValidMin">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#getValidMin">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2885">[view source]</a> <br> <br> <hr> <a name="guessDelimParser"></a> <h2>guessDelimParser</h2> guessDelimParser( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> line ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/DelimParser.html'>org.das2.qds.util.AsciiParser.DelimParser</a> <p></p> <h3>Parameters</h3> line - a String <h3>Returns:</h3> org.das2.qds.util.AsciiParser.DelimParser <br><br> <a href="https://github.com/autoplot/dev/search?q=guessDelimParser&unscoped_q=guessDelimParser">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#guessDelimParser">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l530">[view source]</a> <br> <br> guessDelimParser( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> line, int lineNumber ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/DelimParser.html'>org.das2.qds.util.AsciiParser.DelimParser</a><br> <hr> <a name="guessFieldCount"></a> <h2>guessFieldCount</h2> guessFieldCount( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> filename ) → int <p>return the field count that would result in the largest number of records parsed. The entire file is scanned, and for each line the number of decimal fields is counted. At the end of the scan, the fieldCount with the highest record count is returned.</p> <h3>Parameters</h3> filename - the file name, a local file opened with a FileReader <h3>Returns:</h3> the apparent field count. <br><br> <a href="https://github.com/autoplot/dev/search?q=guessFieldCount&unscoped_q=guessFieldCount">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#guessFieldCount">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l803">[view source]</a> <br> <br> <hr> <a name="guessLengthForFormat"></a> <h2>guessLengthForFormat</h2> guessLengthForFormat( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> format ) → int <p>return the length of the format specifier. %30d -> 30 %30d%5f -> 35. TODO: consider String.format(format,1) or String.format(format,1.0).</p> <h3>Parameters</h3> format - a String <h3>Returns:</h3> an int <br><br> <a href="https://github.com/autoplot/dev/search?q=guessLengthForFormat&unscoped_q=guessLengthForFormat">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#guessLengthForFormat">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2075">[view source]</a> <br> <br> <hr> <a name="guessSkipAndDelimParser"></a> <h2>guessSkipAndDelimParser</h2> guessSkipAndDelimParser( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> filename ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/DelimParser.html'>org.das2.qds.util.AsciiParser.DelimParser</a> <p>read in records, allowing for a header of non-records before guessing the delim parser. This will return a reference to the DelimParser and set skipLines. DelimParser header field is set as well. One must set the record parser explicitly.</p> <h3>Parameters</h3> filename - a String <h3>Returns:</h3> the record parser to use, or null if no records are found. <br><br> <a href="https://github.com/autoplot/dev/search?q=guessSkipAndDelimParser&unscoped_q=guessSkipAndDelimParser">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#guessSkipAndDelimParser">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l345">[view source]</a> <br> <br> <hr> <a name="guessSkipLines"></a> <h2>guessSkipLines</h2> guessSkipLines( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> filename, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/RecordParser.html'>org.das2.qds.util.AsciiParser.RecordParser</a> recParser ) → int <p>try to figure out how many lines to skip by looking for the line where the number of fields becomes stable.</p> <h3>Parameters</h3> filename - a String <br> recParser - an AsciiParser.RecordParser <h3>Returns:</h3> an int <br><br> <a href="https://github.com/autoplot/dev/search?q=guessSkipLines&unscoped_q=guessSkipLines">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#guessSkipLines">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l295">[view source]</a> <br> <br> <hr> <a name="isHeader"></a> <h2>isHeader</h2> isHeader( int iline, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> lastLine, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> thisLine, int recCount ) → boolean <p>returns true if the line is a header or comment.</p> <h3>Parameters</h3> iline - the line number in the file, starting with 0. <br> lastLine - the last line read. <br> thisLine - the line we are testing. <br> recCount - the number of records successfully read. <h3>Returns:</h3> true if the line is a header line. <br><br> <a href="https://github.com/autoplot/dev/search?q=isHeader&unscoped_q=isHeader">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#isHeader">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l175">[view source]</a> <br> <br> <hr> <a name="isIso8601Time"></a> <h2>isIso8601Time</h2> isIso8601Time( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> s ) → boolean <p>quick-n-dirty check to see if a string appears to be an ISO8601 time. minimally 2000-002T00:00, but also 2000-01-01T00:00:00Z etc. Note that an external code may explicitly indicate that the field is a time, This is just to catch things that are obviously times.</p> <h3>Parameters</h3> s - a String <h3>Returns:</h3> true if this is clearly an ISO time. <br><br> <a href="https://github.com/autoplot/dev/search?q=isIso8601Time&unscoped_q=isIso8601Time">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#isIso8601Time">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l192">[view source]</a> <br> <br> <hr> <a name="isKeepFileHeader"></a> <h2>isKeepFileHeader</h2> isKeepFileHeader( ) → boolean <p>Getter for property keepHeader.</p> <h3>Returns:</h3> Value of property keepHeader. <br><br> <a href="https://github.com/autoplot/dev/search?q=isKeepFileHeader&unscoped_q=isKeepFileHeader">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#isKeepFileHeader">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2745">[view source]</a> <br> <br> <hr> <a name="isRichHeader"></a> <h2>isRichHeader</h2> isRichHeader( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> header ) → boolean <p>return true if the header appears to contain JSON code which could be interpreted as a "Rich Header" (a.k.a. JSONHeadedASCII). This is a very simple test, simply looking for <code>#{</code> and <code>#}</code> with a colon contained within.</p> <h3>Parameters</h3> header - string containing the commented header. <h3>Returns:</h3> true if parsing as a Rich Header should be attempted. <h3>See Also:</h3> <a href='https://github.com/JSONheadedASCII/examples'>https://github.com/JSONheadedASCII/examples</a> <br> <br><br> <a href="https://github.com/autoplot/dev/search?q=isRichHeader&unscoped_q=isRichHeader">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#isRichHeader">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l1167">[view source]</a> <br> <br> isRichHeader( ) → boolean<br> <hr> <a name="newParser"></a> <h2>newParser</h2> newParser( int fieldCount ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser.html'>org.das2.qds.util.AsciiParser</a> <p>creates a parser with @param fieldCount fields, named "field0,...,fieldN"</p> <h3>Parameters</h3> fieldCount - the number of fields <h3>Returns:</h3> the file parser <br><br> <a href="https://github.com/autoplot/dev/search?q=newParser&unscoped_q=newParser">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#newParser">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l868">[view source]</a> <br> <br> newParser( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a> fieldNames ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser.html'>org.das2.qds.util.AsciiParser</a><br> <hr> <a name="readFile"></a> <h2>readFile</h2> readFile( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> filename, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/WritableDataSet.html'>org.das2.qds.WritableDataSet</a> <p>Parse the file using the current settings.</p> <h3>Parameters</h3> filename - the file to read <br> mon - a monitor <h3>Returns:</h3> a rank 2 dataset. <br><br> <a href="https://github.com/autoplot/dev/search?q=readFile&unscoped_q=readFile">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#readFile">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2631">[view source]</a> <br> <br> <hr> <a name="readFirstParseableRecord"></a> <h2>readFirstParseableRecord</h2> readFirstParseableRecord( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> filename ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>returns the first record that the record parser parses successfully. The recordParser should be set and configured enough to identify the fields. If no records can be parsed, then null is returned. The first record should be in the first 1000 lines.</p> <h3>Parameters</h3> filename - a String <h3>Returns:</h3> the first parseable line, or null if no such line exists. <br><br> <a href="https://github.com/autoplot/dev/search?q=readFirstParseableRecord&unscoped_q=readFirstParseableRecord">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#readFirstParseableRecord">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l257">[view source]</a> <br> <br> <hr> <a name="readFirstRecord"></a> <h2>readFirstRecord</h2> readFirstRecord( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> filename ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>return the first record that the parser would parse. If skipLines is more than the total number of lines, or all lines are comments, then null is returned.</p> <h3>Parameters</h3> filename - a String <h3>Returns:</h3> the first line after skip lines and comment lines. <br><br> <a href="https://github.com/autoplot/dev/search?q=readFirstRecord&unscoped_q=readFirstRecord">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#readFirstRecord">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l217">[view source]</a> <br> <br> readFirstRecord( <a href='https://docs.oracle.com/javase/8/docs/api/java/io/BufferedReader.html'>java.io.BufferedReader</a> reader ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a><br> <hr> <a name="readStream"></a> <h2>readStream</h2> readStream( <a href='https://docs.oracle.com/javase/8/docs/api/java/io/Reader.html'>java.io.Reader</a> in, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/WritableDataSet.html'>org.das2.qds.WritableDataSet</a> <p>Parse the stream using the current settings.</p> <h3>Parameters</h3> in - the input stream <br> mon - a ProgressMonitor <h3>Returns:</h3> an org.das2.qds.WritableDataSet <br><br> <a href="https://github.com/autoplot/dev/search?q=readStream&unscoped_q=readStream">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#readStream">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l968">[view source]</a> <br> <br> readStream( <a href='https://docs.oracle.com/javase/8/docs/api/java/io/Reader.html'>java.io.Reader</a> in, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> firstRecord, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/WritableDataSet.html'>org.das2.qds.WritableDataSet</a><br> <hr> <a name="readString"></a> <h2>readString</h2> readString( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> str, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/util/monitor/ProgressMonitor.html'>ProgressMonitor</a> mon ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/WritableDataSet.html'>org.das2.qds.WritableDataSet</a> <p></p> <h3>Parameters</h3> str - the data, encoded in a UTF-8 string <br> mon - null or a progress monitor <h3>Returns:</h3> the data <br><br> <a href="https://github.com/autoplot/dev/search?q=readString&unscoped_q=readString">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#readString">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l979">[view source]</a> <br> <br> <hr> <a name="removePropertyChangeListener"></a> <h2>removePropertyChangeListener</h2> removePropertyChangeListener( <a href='https://docs.oracle.com/javase/8/docs/api/java/beans/PropertyChangeListener.html'>java.beans.PropertyChangeListener</a> l ) → void <p>Removes a PropertyChangeListener from the listener list.</p> <h3>Parameters</h3> l - The listener to remove. <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=removePropertyChangeListener&unscoped_q=removePropertyChangeListener">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#removePropertyChangeListener">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2737">[view source]</a> <br> <br> <hr> <a name="setCommentPrefix"></a> <h2>setCommentPrefix</h2> setCommentPrefix( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> comment ) → void <p>Records starting with this are not processed as data, for example "#". This is initially "#". Setting this to null disables this check.</p> <h3>Parameters</h3> comment - the prefix <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setCommentPrefix&unscoped_q=setCommentPrefix">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setCommentPrefix">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l935">[view source]</a> <br> <br> <hr> <a name="setDelimParser"></a> <h2>setDelimParser</h2> setDelimParser( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> filename, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> delimRegex ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/DelimParser.html'>org.das2.qds.util.AsciiParser.DelimParser</a> <p>The DelimParser splits each record into fields using a delimiter like "," or "\\s+".</p> <h3>Parameters</h3> filename - filename to read in. <br> delimRegex - the delimiter, such as "," or "\t" or "\s+" <h3>Returns:</h3> the record parser that will split each line into fields <br><br> <a href="https://github.com/autoplot/dev/search?q=setDelimParser&unscoped_q=setDelimParser">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setDelimParser">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l630">[view source]</a> <br> <br> setDelimParser( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> line, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> delimRegex, int expectedColumnCount ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/DelimParser.html'>org.das2.qds.util.AsciiParser.DelimParser</a><br> setDelimParser( <a href='https://docs.oracle.com/javase/8/docs/api/java/io/Reader.html'>java.io.Reader</a> in, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> delimRegex ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/DelimParser.html'>org.das2.qds.util.AsciiParser.DelimParser</a><br> <hr> <a name="setFieldParser"></a> <h2>setFieldParser</h2> setFieldParser( int field, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/FieldParser.html'>org.das2.qds.util.AsciiParser.FieldParser</a> fp ) → void <p>set the special parser for a field.</p> <h3>Parameters</h3> field - the field number, 0 is the first column. <br> fp - the parser <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setFieldParser&unscoped_q=setFieldParser">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setFieldParser">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l851">[view source]</a> <br> <br> <hr> <a name="setFillValue"></a> <h2>setFillValue</h2> setFillValue( double fillValue ) → void <p>numbers that parse to this value are considered to be fill.</p> <h3>Parameters</h3> fillValue - New value of property fillValue. <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setFillValue&unscoped_q=setFillValue">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setFillValue">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2871">[view source]</a> <br> <br> <hr> <a name="setFixedColumnsParser"></a> <h2>setFixedColumnsParser</h2> setFixedColumnsParser( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> filename, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> delim ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/FixedColumnsParser.html'>org.das2.qds.util.AsciiParser.FixedColumnsParser</a> <p>looks at the first line after skipping, and splits it to calculate where the columns are. The FixedColumnsParser is the fastest of the three parsers.</p> <h3>Parameters</h3> filename - filename to read in. <br> delim - regex to split the initial line into the fixed columns. <h3>Returns:</h3> the record parser that will split each line. <br><br> <a href="https://github.com/autoplot/dev/search?q=setFixedColumnsParser&unscoped_q=setFixedColumnsParser">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setFixedColumnsParser">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l719">[view source]</a> <br> <br> setFixedColumnsParser( <a href='https://docs.oracle.com/javase/8/docs/api/java/io/Reader.html'>java.io.Reader</a> in, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> delim ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/FixedColumnsParser.html'>org.das2.qds.util.AsciiParser.FixedColumnsParser</a><br> setFixedColumnsParser( int[] columnOffsets, int[] columnWidths, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/FieldParser.html'>org.das2.qds.util.AsciiParser.FieldParser[]</a> parsers ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/FixedColumnsParser.html'>org.das2.qds.util.AsciiParser.FixedColumnsParser</a><br> <hr> <a name="setHeaderDelimiter"></a> <h2>setHeaderDelimiter</h2> setHeaderDelimiter( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> headerDelimiter ) → void <p>set the delimiter which explicitly separates header from the data. For example "-------" could be used. Normally the parser just looks at the number of fields and this is sufficient.</p> <h3>Parameters</h3> headerDelimiter - a String <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setHeaderDelimiter&unscoped_q=setHeaderDelimiter">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setHeaderDelimiter">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l955">[view source]</a> <br> <br> <hr> <a name="setKeepFileHeader"></a> <h2>setKeepFileHeader</h2> setKeepFileHeader( boolean keepHeader ) → void <p>Setter for property keepHeader. By default false but if true, the file header ignored by skipLines is put into the property PROPERTY_FILE_HEADER.</p> <h3>Parameters</h3> keepHeader - New value of property keepHeader. <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setKeepFileHeader&unscoped_q=setKeepFileHeader">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setKeepFileHeader">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2755">[view source]</a> <br> <br> <hr> <a name="setPropertyPattern"></a> <h2>setPropertyPattern</h2> setPropertyPattern( <a href='https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html'>java.util.regex.Pattern</a> propertyPattern ) → void <p>specify the Pattern used to recognize properties. Note property values are not parsed, they are provided as Strings. This is a regular expression with two groups for the property name and value. For example, (.+)=(.+)</p> <h3>Parameters</h3> propertyPattern - regular expression Pattern with two groups. <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setPropertyPattern&unscoped_q=setPropertyPattern">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setPropertyPattern">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l926">[view source]</a> <br> <br> <hr> <a name="setRecordCountLimit"></a> <h2>setRecordCountLimit</h2> setRecordCountLimit( int recordCountLimit ) → void <p>limit the number of records read. parsing will stop once this number of records is read into the result. This is Integer.MAX_VALUE by default.</p> <h3>Parameters</h3> recordCountLimit - an int <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setRecordCountLimit&unscoped_q=setRecordCountLimit">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setRecordCountLimit">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l900">[view source]</a> <br> <br> <hr> <a name="setRecordParser"></a> <h2>setRecordParser</h2> setRecordParser( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/RecordParser.html'>org.das2.qds.util.AsciiParser.RecordParser</a> recordParser ) → void <p>Setter for property recordParser.</p> <h3>Parameters</h3> recordParser - New value of property recordParser. <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setRecordParser&unscoped_q=setRecordParser">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setRecordParser">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2777">[view source]</a> <br> <br> <hr> <a name="setRecordStart"></a> <h2>setRecordStart</h2> setRecordStart( int recordStart ) → void <p>set the number of records to skip before accumulating the result.</p> <h3>Parameters</h3> recordStart - an int <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setRecordStart&unscoped_q=setRecordStart">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setRecordStart">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l911">[view source]</a> <br> <br> <hr> <a name="setRegexParser"></a> <h2>setRegexParser</h2> setRegexParser( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a> fieldNames ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/qds/util/AsciiParser/RecordParser.html'>org.das2.qds.util.AsciiParser.RecordParser</a> <p>The regex parser is a slow parser, but gives precise control.</p> <h3>Parameters</h3> fieldNames - a java.lang.String[] <h3>Returns:</h3> the parser for each record. <br><br> <a href="https://github.com/autoplot/dev/search?q=setRegexParser&unscoped_q=setRegexParser">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setRegexParser">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l695">[view source]</a> <br> <br> <hr> <a name="setSkipLines"></a> <h2>setSkipLines</h2> setSkipLines( int skipLines ) → void <p>skip a number of lines before trying to parse anything. This can be set to point at the first valid line, and the RecordParser will be configured using that line.</p> <h3>Parameters</h3> skipLines - an int <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setSkipLines&unscoped_q=setSkipLines">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setSkipLines">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l891">[view source]</a> <br> <br> <hr> <a name="setUnits"></a> <h2>setUnits</h2> setUnits( int index, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> units ) → void <p>Indexed setter for property units. This now sets the field parser for the field to be a UNITS_PARSER if it is the default DOUBLE_PARSER.</p> <h3>Parameters</h3> index - Index of the property. <br> units - New value of the property at <CODE>index</CODE>. <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setUnits&unscoped_q=setUnits">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setUnits">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2802">[view source]</a> <br> <br> setUnits( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units[]</a> u ) → void<br> <hr> <a name="setValidMax"></a> <h2>setValidMax</h2> setValidMax( double validMax ) → void <p>set the maximum value for any field. Values above this are to be considered invalid.</p> <h3>Parameters</h3> validMax - a double <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setValidMax&unscoped_q=setValidMax">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setValidMax">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2915">[view source]</a> <br> <br> <hr> <a name="setValidMin"></a> <h2>setValidMin</h2> setValidMin( double validMin ) → void <p>set the minimum valid value for any field. Values less than this are to be considered invalid.</p> <h3>Parameters</h3> validMin - a double <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setValidMin&unscoped_q=setValidMin">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setValidMin">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l2894">[view source]</a> <br> <br> <hr> <a name="setWhereConstraint"></a> <h2>setWhereConstraint</h2> setWhereConstraint( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> sparm, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> op, <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> sval ) → void <p>allow constraint for where condition is true. This doesn't need the data to be interpreted for "eq", string equality is checked for nominal data. Note sval is compared after trimming outside spaces.</p> <h3>Parameters</h3> sparm - column name, such as "field4" <br> op - constraint, one of eq gt ge lt le ne <br> sval - String value. For nominal columns, String equality is used. <h3>Returns:</h3> void (returns nothing) <br><br> <a href="https://github.com/autoplot/dev/search?q=setWhereConstraint&unscoped_q=setWhereConstraint">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/qds/util/AsciiParser.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/qds/util/AsciiParser.html#setWhereConstraint">[view on old javadoc]</a> <a href="https://sourceforge.net/p/autoplot/code/HEAD/tree/autoplot/trunk/QDataSet/src/org/das2/qds/util/AsciiParser.java#l1375">[view source]</a> <br> <br>