<h2>org.das2.datum.DatumRange</h2><p>A DatumRange is provided as a means to carry an ordered pair of Datums representing an interval. This sort of data structure comes up often in processing, and it's useful to define once and get the operators implemented correctly. Consider using this object whenever you see pairs of Datums in interfaces and codes (e.g. tbegin,tend), they are probably a DatumRange!</p> <h2>DatumRange( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> s1, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> s2 )</h2> <p>Creates valid DatumRange from two Datums.</p> <h2>DatumRange( double s1, double s2, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> units )</h2> <p>create a datum range from two doubles in the context of units.</p> <hr> <a name="compareTo"></a> <h2>compareTo</h2> compareTo( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html'>Object</a> o ) → int <p>Compare this to another DatumRange, ordered by the lesser datum, then the greater datum. This is mostly provided for .equals, but also so there is a consistent ordering convention though out the system.</p> <h3>Parameters</h3> o - the DatumRange to compare this DatumRange to. <h3>Returns:</h3> an int < 0 if this comes before DatumRange a in this DatumRange's units space, 0 if they are equal, and > 0 otherwise. <br><br> <a href="https://github.com/autoplot/dev/search?q=compareTo&unscoped_q=compareTo">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#compareTo">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="contains"></a> <h2>contains</h2> contains( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> dr ) → boolean <p>returns true of param dr is contained by this, so that this.union(dr).equals(this).</p> <h3>Parameters</h3> dr - the datum range to test. <h3>Returns:</h3> true iff this.union(dr).equals(this); <br><br> <a href="https://github.com/autoplot/dev/search?q=contains&unscoped_q=contains">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#contains">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> contains( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> d ) → boolean<br> <hr> <a name="convertTo"></a> <h2>convertTo</h2> convertTo( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> u ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p>return this DatumRange in new units. Note this may cause some functions of a DatumRange to change, such as the next() for a MonthDatumRange, but implementations should attempt to preserve type.</p> <h3>Parameters</h3> u - the new units. <h3>Returns:</h3> the DatumRange in the new units. <br><br> <a href="https://github.com/autoplot/dev/search?q=convertTo&unscoped_q=convertTo">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#convertTo">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="equals"></a> <h2>equals</h2> equals( <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html'>Object</a> o ) → boolean <p>returns true if the two endpoints are equal.</p> <h3>Parameters</h3> o - an Object <h3>Returns:</h3> a boolean <br><br> <a href="https://github.com/autoplot/dev/search?q=equals&unscoped_q=equals">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#equals">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="getUnits"></a> <h2>getUnits</h2> getUnits( ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> <p>return the units of the DatumRange.</p> <h3>Returns:</h3> the units of the DatumRange. <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/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#getUnits">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="hashCode"></a> <h2>hashCode</h2> hashCode( ) → int <p></p> <h3>Returns:</h3> int <br><br> <a href="https://github.com/autoplot/dev/search?q=hashCode&unscoped_q=hashCode">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#hashCode">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="include"></a> <h2>include</h2> include( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> d ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p>return a new DatumRange that includes the given Datum, extending the range if necessary. For example, <pre> [0,1).include(2)→ [0,2) (note this is exclusive of 2 since it's the end). [0,1).include(-1)→ [-1,1). [0,1).include(0.5) → [0,1] (and returns the same DatumRange object) </pre> Also, including a fill Datum returns the same DatumRange as well.</p> <h3>Parameters</h3> d - the Datum to include <h3>Returns:</h3> the new range. <br><br> <a href="https://github.com/autoplot/dev/search?q=include&unscoped_q=include">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#include">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="intersection"></a> <h2>intersection</h2> intersection( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> dr ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p>returns the intersection of the two intersecting ranges. This is a range that contains(d) if and only if this.contains(d) and dr.contains(d).</p> <h3>Parameters</h3> dr - a valid datum range. <h3>Returns:</h3> the intersection of the two intersecting ranges. <h3>See Also:</h3> <a href='null'>DatumRangeUtil#sloppyIntersection(org.das2.datum.DatumRange, org.das2.datum.DatumRange)</a> <br> <br><br> <a href="https://github.com/autoplot/dev/search?q=intersection&unscoped_q=intersection">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#intersection">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="intersects"></a> <h2>intersects</h2> intersects( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> dr ) → boolean <p>returns true of the DatumRange overlaps this. Note that the endpoints are not included in the comparison, so that Tuesday.intersects(Wednesday)==false.</p> <h3>Parameters</h3> dr - a valid datum range <h3>Returns:</h3> true of the DatumRange overlaps this <br><br> <a href="https://github.com/autoplot/dev/search?q=intersects&unscoped_q=intersects">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#intersects">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="max"></a> <h2>max</h2> max( ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> <p>returns the bigger value or stop of the range.</p> <h3>Returns:</h3> the bigger value or stop of the range. <br><br> <a href="https://github.com/autoplot/dev/search?q=max&unscoped_q=max">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#max">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="middle"></a> <h2>middle</h2> middle( ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> <p>returns the middle value of the range, often useful when the most descriptive value is needed.</p> <h3>Returns:</h3> the middle value of the range. <br><br> <a href="https://github.com/autoplot/dev/search?q=middle&unscoped_q=middle">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#middle">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="min"></a> <h2>min</h2> min( ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> <p>returns the smaller value or start of the range.</p> <h3>Returns:</h3> the smaller value or start of the range. <br><br> <a href="https://github.com/autoplot/dev/search?q=min&unscoped_q=min">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#min">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="newDatumRange"></a> <h2><del>newDatumRange</del></h2> Deprecated: <hr> <a name="newRange"></a> <h2>newRange</h2> newRange( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> lower, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> upper ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p>create a new DatumRange. In the case where lower is greater than upper, the two will be reversed automatically.</p> <h3>Parameters</h3> lower - the lower bound <br> upper - the upper bound <h3>Returns:</h3> a new DatumRange <br><br> <a href="https://github.com/autoplot/dev/search?q=newRange&unscoped_q=newRange">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#newRange">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> newRange( double lower, double upper, <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Units.html'>Units</a> units ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a><br> newRange( double lower, double upper ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a><br> <hr> <a name="next"></a> <h2>next</h2> next( ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p>returns the next DatumRange covering the space defined by Units. Typically, this will be a range with a min equal to this datum's max, and the same width. Some implementations of DatumRange may return a range with a different width than this DatumRange's width, for example, when advancing month-by-month with a MonthDatumRange. When there is no next interval, then this same range will be returned.</p> <h3>Returns:</h3> the next DatumRange covering the space defined by Units. <br><br> <a href="https://github.com/autoplot/dev/search?q=next&unscoped_q=next">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#next">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="previous"></a> <h2>previous</h2> previous( ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p>returns the previous DatumRange covering the space defined by Units. See next(). When there is no previous interval, then this same range will be returned.</p> <h3>Returns:</h3> the previous DatumRange covering the space defined by Units <br><br> <a href="https://github.com/autoplot/dev/search?q=previous&unscoped_q=previous">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#previous">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="rescale"></a> <h2>rescale</h2> rescale( double min, double max ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p>returns DatumRange relative to this, where 0.0 is the minimum, and 1.0 is the maximum. For example rescale(1,2) is scanNext, rescale(-0.5,1.5) is zoomOut.</p> <h3>Parameters</h3> min - the new min normalized with respect to this range. 0.0 is this range's min, 1.0 is this range's max. <br> max - the new max with normalized with respect to this range. 0.0 is this range's min, 1.0 is this range's max. <h3>Returns:</h3> new DatumRange. <h3>See Also:</h3> <a href='null'>DatumRangeUtil#rescale(org.das2.datum.DatumRange, double, double)</a> <br> <br><br> <a href="https://github.com/autoplot/dev/search?q=rescale&unscoped_q=rescale">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#rescale">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="toString"></a> <h2>toString</h2> toString( ) → <a href='https://docs.oracle.com/javase/8/docs/api/java/lang/String.html'>String</a> <p>returns a human consumable representation of the string. This should also be parsable with DatumRangeUtil.parseDatumRange, but this has not been verified to complete certainty.</p> <h3>Returns:</h3> the DatumRange as a String. <br><br> <a href="https://github.com/autoplot/dev/search?q=toString&unscoped_q=toString">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#toString">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="union"></a> <h2>union</h2> union( <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> dr ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p>returns the union of the two intersecting or adjacent ranges.</p> <h3>Parameters</h3> dr - the other range of consistent units. <h3>Returns:</h3> DatumRange union of the two DatumRanges <br><br> <a href="https://github.com/autoplot/dev/search?q=union&unscoped_q=union">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#union">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="width"></a> <h2>width</h2> width( ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/Datum.html'>Datum</a> <p>returns the width of the range, which is simply the greater minus the lessor. Note that the units of the result will not necessarily be the same as the endpoints, for example with LocationDatums.</p> <h3>Returns:</h3> Datum that is the width of the range (max.subtract(min)). <br><br> <a href="https://github.com/autoplot/dev/search?q=width&unscoped_q=width">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#width">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br> <hr> <a name="zoomOut"></a> <h2>zoomOut</h2> zoomOut( double factor ) → <a href='http://www-pw.physics.uiowa.edu/~jbf/autoplot/doc/org/das2/datum/DatumRange.html'>DatumRange</a> <p>returns a scaled DatumRange, with a new width that is the this datumRange's width multiplied by factor, and the same center. 1.0 is the same range, 2.0 has twice the width, etc.</p> <h3>Parameters</h3> factor - double representing the new range's width divided by this range's width. <h3>Returns:</h3> a scaled DatumRange, with a new width that is the this datumRange's width multiplied by factor, and the same center. <br><br> <a href="https://github.com/autoplot/dev/search?q=zoomOut&unscoped_q=zoomOut">[search for examples]</a> <a href="https://github.com/autoplot/documentation/tree/master/javadoc/org/das2/datum/DatumRange.md">[view on GitHub]</a> <a href="http://www-pw.physics.uiowa.edu/~jbf/autoplot/javadoc2018/org/das2/datum/DatumRange.html#zoomOut">[view on old javadoc]</a> <a href="https://saturn.physics.uiowa.edu/svn/das2/dasCore/community/autoplot2011/trunk/dasCoreDatum/src/org/das2/datum/DatumRange.java">[view source]</a> <br> <br>