<h2>org.das2.dataset.DataSetUtil</h2><p></p> <h2>DataSetUtil( )</h2> <p></p> <hr> <a name="append"></a> <h2>append</h2> append( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds1, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds2, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/CacheTag.html'>org.das2.datum.CacheTag</a> ct ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> <p>provides convenient method for appending datasets together. The first dataset may be null, in which case the second is trivially returned. Presently a builder is used to create the new dataset, but in the future more efficient methods will be used. If both ds1 and ds2 are null, then null is returned.</p> <h3>Parameters</h3> ds1 - the first data set. May be null. <br> ds2 - the second data set. This data set should be after ds1, and may be null. <br> ct - the cache tag for the second dataset. May be null, in which case guessCacheTag is used to identify the dataset cache tag. <h3>Returns:</h3> org.das2.dataset.DataSet <br><br> <a href="https://github.com/autoplot/dev/search?q=append&unscoped_q=append">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#append">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> append( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds1, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds2 ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a><br> <hr> <a name="closestColumn"></a> <h2>closestColumn</h2> closestColumn( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> table, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) → int <p></p> <h3>Parameters</h3> table - a DataSet <br> datum - a Datum <h3>Returns:</h3> int <br><br> <a href="https://github.com/autoplot/dev/search?q=closestColumn&unscoped_q=closestColumn">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#closestColumn">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> closestColumn( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> table, double x, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> units ) → int<br> closestColumn( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> table, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> xdatum, int guessIndex ) → int<br> <hr> <a name="getAllPlaneIds"></a> <h2>getAllPlaneIds</h2> getAllPlaneIds( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String[]</a> <p>returns all planes, including the default plane "". This is to take care of inconsistent behavior of the ds.getPlaneIds() implementations.</p> <h3>Parameters</h3> ds - a DataSet <h3>Returns:</h3> java.lang.String[] <br><br> <a href="https://github.com/autoplot/dev/search?q=getAllPlaneIds&unscoped_q=getAllPlaneIds">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#getAllPlaneIds">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="getNextColumn"></a> <h2>getNextColumn</h2> getNextColumn( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) → int <p>returns the first column that is after the given datum. Note the if the datum identifies (==) an xtag, then the previous column is returned.</p> <h3>Parameters</h3> ds - a DataSet <br> datum - a Datum <h3>Returns:</h3> int <br><br> <a href="https://github.com/autoplot/dev/search?q=getNextColumn&unscoped_q=getNextColumn">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#getNextColumn">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="getPreviousColumn"></a> <h2>getPreviousColumn</h2> getPreviousColumn( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum ) → int <p>returns the first column that is before the given datum. Note the if the datum identifies (==) an xtag, then the previous column is returned.</p> <h3>Parameters</h3> ds - a DataSet <br> datum - a Datum <h3>Returns:</h3> int <br><br> <a href="https://github.com/autoplot/dev/search?q=getPreviousColumn&unscoped_q=getPreviousColumn">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#getPreviousColumn">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="getWeightsDataSet"></a> <h2>getWeightsDataSet</h2> getWeightsDataSet( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> <p></p> <h3>Parameters</h3> ds - a DataSet <h3>Returns:</h3> org.das2.dataset.DataSet <br><br> <a href="https://github.com/autoplot/dev/search?q=getWeightsDataSet&unscoped_q=getWeightsDataSet">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#getWeightsDataSet">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="getXTagArrayDouble"></a> <h2>getXTagArrayDouble</h2> getXTagArrayDouble( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> vds, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> units ) → double[] <p></p> <h3>Parameters</h3> vds - a DataSet <br> units - an Units <h3>Returns:</h3> double[] <br><br> <a href="https://github.com/autoplot/dev/search?q=getXTagArrayDouble&unscoped_q=getXTagArrayDouble">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#getXTagArrayDouble">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="getXTags"></a> <h2>getXTags</h2> getXTags( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumVector.html'>org.das2.datum.DatumVector</a> <p></p> <h3>Parameters</h3> ds - a DataSet <h3>Returns:</h3> org.das2.datum.DatumVector <br><br> <a href="https://github.com/autoplot/dev/search?q=getXTags&unscoped_q=getXTags">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#getXTags">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="guessCacheTag"></a> <h2>guessCacheTag</h2> guessCacheTag( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/CacheTag.html'>org.das2.datum.CacheTag</a> <p></p> <h3>Parameters</h3> ds - a DataSet <h3>Returns:</h3> org.das2.datum.CacheTag <br><br> <a href="https://github.com/autoplot/dev/search?q=guessCacheTag&unscoped_q=guessCacheTag">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#guessCacheTag">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="guessSizeBytes"></a> <h2>guessSizeBytes</h2> guessSizeBytes( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds ) → long <p>Give an estimate of the size of the data set, or PROPERTY_SIZE_BYTES if available. Generally this would be used as a penalty against the dataset, and it's probably better to overestimate the dataset size.</p> <h3>Parameters</h3> ds - a DataSet <h3>Returns:</h3> long <br><br> <a href="https://github.com/autoplot/dev/search?q=guessSizeBytes&unscoped_q=guessSizeBytes">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#guessSizeBytes">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="guessXTagWidth"></a> <h2>guessXTagWidth</h2> guessXTagWidth( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> table ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> <p>Provide a reasonable xTagWidth either by returning the specified xTagWidth property, or by statistically looking at the X tags.</p> <h3>Parameters</h3> table - a DataSet <h3>Returns:</h3> org.das2.datum.Datum <br><br> <a href="https://github.com/autoplot/dev/search?q=guessXTagWidth&unscoped_q=guessXTagWidth">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#guessXTagWidth">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="log10"></a> <h2>log10</h2> log10( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/VectorDataSet.html'>org.das2.dataset.VectorDataSet</a> ds ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/VectorDataSet.html'>org.das2.dataset.VectorDataSet</a> <p></p> <h3>Parameters</h3> ds - a VectorDataSet <h3>Returns:</h3> org.das2.dataset.VectorDataSet <br><br> <a href="https://github.com/autoplot/dev/search?q=log10&unscoped_q=log10">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#log10">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="xRange"></a> <h2>xRange</h2> xRange( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p>returns the xrange of the dataset. This assumes that the xtags are monotonic.</p> <h3>Parameters</h3> ds - a DataSet <h3>Returns:</h3> a DatumRange <br><br> <a href="https://github.com/autoplot/dev/search?q=xRange&unscoped_q=xRange">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#xRange">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="xTagBinarySearch"></a> <h2>xTagBinarySearch</h2> xTagBinarySearch( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> datum, int low, int high ) → int <p>returns the index of a tag, or the <tt>(-(<i>insertion point</i>) - 1)</tt>. (See Arrays.binarySearch)</p> <h3>Parameters</h3> ds - a DataSet <br> datum - a Datum <br> low - an int <br> high - an int <h3>Returns:</h3> int <br><br> <a href="https://github.com/autoplot/dev/search?q=xTagBinarySearch&unscoped_q=xTagBinarySearch">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#xTagBinarySearch">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="yRange"></a> <h2>yRange</h2> yRange( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p></p> <h3>Parameters</h3> ds - a DataSet <h3>Returns:</h3> org.das2.datum.DatumRange <br><br> <a href="https://github.com/autoplot/dev/search?q=yRange&unscoped_q=yRange">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#yRange">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br> <hr> <a name="zRange"></a> <h2>zRange</h2> zRange( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/dataset/DataSet.html'>org.das2.dataset.DataSet</a> ds ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p>guess a range that characterizes the data. The DataSet property name DataSet.PROPERTY_Z_RANGE can be used by the dataset to explicitly set this.</p> <h3>Parameters</h3> ds - a DataSet <h3>Returns:</h3> a DatumRange useful for setting axis range. <br><br> <a href="https://github.com/autoplot/dev/search?q=zRange&unscoped_q=zRange">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/dataset/DataSetUtil.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/dataset/DataSetUtil.html#zRange">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCore/src/org/das2/dataset/DataSetUtil.java">[view source]</a> <br> <br>