<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 ) &rarr; <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 ) &rarr; <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 ) &rarr; 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 ) &rarr; 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 ) &rarr; 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 ) &rarr; <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 ) &rarr; 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 ) &rarr; 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 ) &rarr; <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 ) &rarr; 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 ) &rarr; <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 ) &rarr; <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 ) &rarr; 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 ) &rarr; <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 ) &rarr; <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 ) &rarr; <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 ) &rarr; 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 ) &rarr; <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 ) &rarr; <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>