public class CoordinateAxis1D extends CoordinateAxis
If this is char valued, it will have rank 2, otherwise it will have rank 1.
If string or char valued, only getCoordName() can be called.
If the coordinates are regularly spaced, isRegular() is true, and the values are equal to getStart() + i * getIncrement().
This will also set "cell bounds" for this axis. By default, the cell bounds are midway between the coordinates values, and are therefore contiguous, and can be accessed though getCoordEdge(i). The only way the bounds can be set is if the coordinate variable has an attribute "bounds" that points to another variable bounds(ncoords,2). These contain the cell bounds, and must be ascending or descending as the coordinate values are. In this case isContiguous() is true when bounds1(i+1) == bounds2(i) for all i.
| Modifier and Type | Class and Description |
|---|---|
static class |
CoordinateAxis1D.Builder<T extends CoordinateAxis1D.Builder<T>> |
CoordinateAxis.AxisComparatordefaultCoordsSizeToCache, defaultSizeToCache, permitCaching| Modifier and Type | Method and Description |
|---|---|
static CoordinateAxis1D.Builder<?> |
builder()
Get Builder for this class that allows subclassing.
|
CoordinateAxis |
copyNoCache()
Make a copy, with an independent cache.
|
int |
findCoordElement(double coordVal)
Given a coordinate value, find what grid element contains it.
|
int |
findCoordElementBounded(double coordVal)
Given a coordinate position, find what grid element contains it, or is closest to it.
|
double[] |
getBound1()
Get the coordinate bound1 as a double array.
|
double[] |
getBound2()
Get the coordinate bound1 as a double array.
|
double[] |
getCoordBounds(int i)
Get the coordinate bounds for the ith coordinate.
|
double |
getCoordBoundsMidpoint(int i) |
double |
getCoordEdge(int index)
Get the ith coordinate edge.
|
double[] |
getCoordEdges()
Get the coordinate edges as a double array.
|
java.lang.String |
getCoordName(int index)
The "name" of the ith coordinate.
|
double |
getCoordValue(int index)
Get the ith coordinate value.
|
double[] |
getCoordValues()
Get the coordinate values as a double array.
|
double |
getIncrement()
Get increment value if isRegular()
|
double |
getMaxEdgeValue() |
double |
getMaxValue()
The largest coordinate value.
|
double |
getMinEdgeValue() |
double |
getMinValue()
The smallest coordinate value.
|
double |
getStart()
Get starting value if isRegular()
|
boolean |
isContiguous()
If the edges are contiguous or disjoint
Caution: many datasets do not explicitly specify this info, this is often a guess; default is true.
|
boolean |
isInterval()
If this coordinate has interval values.
|
boolean |
isRegular()
If true, then value(i) = getStart() + i * getIncrement().
|
CoordinateAxis1D |
section(Range r)
Create a new CoordinateAxis1D as a section of this CoordinateAxis1D.
|
CoordinateAxis1D.Builder<?> |
toBuilder()
Turn into a mutable Builder.
|
equals, fromVariableDS, getAxisType, getBoundaryRef, getCalendarFromAttribute, getInfo, getPositive, getUnitsString, hashCode, isIndependentCoordinate, isNumericapplyScaleOffset, applyScaleOffset, convertMissing, convertMissing, convertUnsigned, convertUnsigned, convertUnsigned, fillValueIsMissing, getCoordinateSystems, getDatasetLocation, getDescription, getEnhanceMode, getFillValue, getMissingDataArray, getMissingValues, getNetcdfFile, getOffset, getOriginalDataType, getOriginalName, getOriginalVariable, getScaledOffsetType, getScaleFactor, getSignedness, getUnsignedConversionType, getValidMax, getValidMin, hasFillValue, hasMissing, hasMissingValue, hasScaleOffset, hasValidData, invalidDataIsMissing, isFillValue, isInvalidData, isMissing, isMissingValue, lookupEnumString, missingDataIsMissing, readToStream, reallyRead, reallyRead, showScaleMissingProxy, toStringDebugattributes, compareTo, createNewCache, findAttribute, findAttributeString, findDimensionIndex, getDataType, getDimension, getDimensions, getDimensionsString, getElementSize, getEnumTypedef, getFileTypeId, getFullName, getNameAndDimensions, getNameAndDimensions, getNameAndDimensions, getParentGroup, getParentStructure, getRanges, getRank, getShape, getShape, getShapeAsSection, getSize, getSizeToCache, getSPobject, hasCachedData, isCaching, isCoordinateVariable, isMemberOfStructure, isMetadata, isScalar, isUnlimited, isVariableLength, read, read, read, read, read, readScalarByte, readScalarDouble, readScalarFloat, readScalarInt, readScalarLong, readScalarShort, readScalarString, reduce, section, section, slice, toStringgetFullName, getShortNameaddCoordinateSystem, removeCoordinateSystemgetShortNamefilter, findAttributeDouble, findAttributeIgnoreCase, findAttributeInteger, getName, hasAttribute, hasAttributeIgnoreCase, isEmpty, iteratorpublic static CoordinateAxis1D.Builder<?> builder()
public CoordinateAxis copyNoCache()
CoordinateAxiscopyNoCache in class CoordinateAxispublic int findCoordElement(double coordVal)
edge[i] <= value < edge[i+1] (if values are ascending) edge[i] > value >= edge[i+1] (if values are descending)
coordVal - position in this coordinate systempublic int findCoordElementBounded(double coordVal)
coordVal - position in this coordinate systempublic double[] getBound1()
java.lang.UnsupportedOperationException - if !isNumeric()public double[] getBound2()
java.lang.UnsupportedOperationException - if !isNumeric()public double[] getCoordBounds(int i)
i - coordinate indexpublic double getCoordBoundsMidpoint(int i)
public double getCoordEdge(int index)
Coordinate edges must be strictly monotonic:
coordEdge(0) < coordValue(0) < coordEdge(1) < coordValue(1) ...
... coordEdge(i) < coordValue(i) < coordEdge(i+1) < coordValue(i+1) ...
... coordEdge(n-1) < coordValue(n-1) < coordEdge(n)
index - which coordinate. Between 0 and getNumElements() inclusive.java.lang.UnsupportedOperationException - if !isNumeric()public double[] getCoordEdges()
java.lang.UnsupportedOperationException - if !isNumeric()public java.lang.String getCoordName(int index)
index - which one ?public double getCoordValue(int index)
index - which coordinate. Between 0 and getNumElements()-1 inclusive.java.lang.UnsupportedOperationException - if !isNumeric()public double[] getCoordValues()
java.lang.UnsupportedOperationException - if !isNumeric()public double getIncrement()
public double getMaxEdgeValue()
public double getMaxValue()
CoordinateAxisgetMaxValue in class CoordinateAxispublic double getMinEdgeValue()
public double getMinValue()
CoordinateAxisgetMinValue in class CoordinateAxispublic double getStart()
public boolean isContiguous()
CoordinateAxisisContiguous in class CoordinateAxispublic boolean isInterval()
isInterval in class CoordinateAxispublic boolean isRegular()
public CoordinateAxis1D section(Range r) throws InvalidRangeException
r - the section rangeInvalidRangeException - if IllegalRangepublic CoordinateAxis1D.Builder<?> toBuilder()
VariabletoBuilder in class CoordinateAxis