Package ucar.nc2.dataset

Class CoordinateAxis1D

    • Field Detail

      • wasRead

        protected boolean wasRead

      • coords

        protected double[] coords

    • Constructor Detail

      • CoordinateAxis1D

        @Deprecated
public CoordinateAxis1D​(NetcdfDataset ncd,
                        VariableDS vds)
        Deprecated.
        Use CoordinateAxis1D.builder()
        Create a 1D coordinate axis from an existing Variable
        Parameters:
        ncd - the containing dataset
        vds - wrap this VariableDS, which is not changed.

      • CoordinateAxis1D

        @Deprecated
public CoordinateAxis1D​(NetcdfDataset ds,
                        Group group,
                        String shortName,
                        DataType dataType,
                        String dims,
                        String units,
                        String desc)
        Deprecated.
        Use CoordinateAxis1D.builder()
        Constructor when theres no underlying variable. You better set the values too!
        Parameters:
        ds - the containing dataset.
        group - the containing group; if null, use rootGroup
        shortName - axis name.
        dataType - data type
        dims - list of dimension names
        units - units of coordinates, preferably udunit compatible.
        desc - long name.

    • Method Detail

      • getNames

        @Deprecated
public List<NamedObject> getNames()
        Deprecated.
        will move in ver 6
        Get the list of names, to be used for user selection. The ith one refers to the ith coordinate.
        Returns:
        List of ucar.nc2.util.NamedObject, or empty list.

      • getCoordName

        public String getCoordName​(int index)
        The "name" of the ith coordinate. If nominal, this is all there is to a coordinate. If numeric, this will return a String representation of the coordinate.
        Parameters:
        index - which one ?
        Returns:
        the ith coordinate value as a String

      • getCoordValue

        public double getCoordValue​(int index)
        Get the ith coordinate value. This is the value of the coordinate axis at which the data value is associated. These must be strictly monotonic.
        Parameters:
        index - which coordinate. Between 0 and getNumElements()-1 inclusive.
        Returns:
        coordinate value.
        Throws:
        UnsupportedOperationException - if !isNumeric()

      • getMinValue

        public double getMinValue()
        Description copied from class: CoordinateAxis
        The smallest coordinate value. Only call if isNumeric.
        Overrides:
        getMinValue in class CoordinateAxis
        Returns:
        the minimum coordinate value

      • getMaxValue

        public double getMaxValue()
        Description copied from class: CoordinateAxis
        The largest coordinate value. Only call if isNumeric.
        Overrides:
        getMaxValue in class CoordinateAxis
        Returns:
        the maximum coordinate value

      • getMinEdgeValue

        public double getMinEdgeValue()

      • getMaxEdgeValue

        public double getMaxEdgeValue()

      • getCoordEdge

        public double getCoordEdge​(int index)
        Get the ith coordinate edge. Exact only if isContiguous() is true, otherwise use getBound1() and getBound2(). This is the value where the underlying grid element switches from "belonging to" coordinate value i-1 to "belonging to" coordinate value i. In some grids, this may not be well defined, and so should be considered an approximation or a visualization hint. 

          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)
        Parameters:
        index - which coordinate. Between 0 and getNumElements() inclusive.
        Returns:
        coordinate edge.
        Throws:
        UnsupportedOperationException - if !isNumeric()

      • getCoordValues

        public double[] getCoordValues()
        Get the coordinate values as a double array.
        Returns:
        coordinate value.
        Throws:
        UnsupportedOperationException - if !isNumeric()

      • getCoordEdges

        public double[] getCoordEdges()
        Get the coordinate edges as a double array. Exact only if isContiguous() is true, otherwise use getBound1() and getBound2().
        Returns:
        coordinate edges.
        Throws:
        UnsupportedOperationException - if !isNumeric()

      • isContiguous

        public boolean isContiguous()
        Description copied from class: CoordinateAxis
        If the edges are contiguous or disjoint Caution: many datasets do not explicitly specify this info, this is often a guess; default is true.
        Overrides:
        isContiguous in class CoordinateAxis
        Returns:
        true if the edges are contiguous or false if disjoint. Assumed true unless set otherwise.

      • isInterval

        public boolean isInterval()
        If this coordinate has interval values. If so, then one should use getBound1, getBound2, and not getCoordEdges()
        Overrides:
        isInterval in class CoordinateAxis
        Returns:
        true if coordinate has interval values

      • getBound1

        public double[] getBound1()
        Get the coordinate bound1 as a double array. bound1[i] # coordValue[i] # bound2[i], where # is < if increasing (bound1[i] < bound1[i+1]) else < if decreasing.
        Returns:
        coordinate bound1.
        Throws:
        UnsupportedOperationException - if !isNumeric()

      • getBound2

        public double[] getBound2()
        Get the coordinate bound1 as a double array. bound1[i] # coordValue[i] # bound2[i], where # is < if increasing (bound1[i] < bound1[i+1]) else < if decreasing.
        Returns:
        coordinate bound2.
        Throws:
        UnsupportedOperationException - if !isNumeric()

      • getCoordBounds

        public double[] getCoordBounds​(int i)
        Get the coordinate bounds for the ith coordinate. Can use this for isContiguous() true or false.
        Parameters:
        i - coordinate index
        Returns:
        double[2] edges for ith coordinate

      • getCoordBoundsMidpoint

        public double getCoordBoundsMidpoint​(int i)

      • findCoordElement

        public int findCoordElement​(double coordVal)
        Given a coordinate value, find what grid element contains it. This means that 
         edge[i] <= value < edge[i+1] (if values are ascending)
 edge[i] > value >= edge[i+1] (if values are descending)
        Parameters:
        coordVal - position in this coordinate system
        Returns:
        index of grid point containing it, or -1 if outside grid area

      • findCoordElementBounded

        public int findCoordElementBounded​(double coordVal)
        Given a coordinate position, find what grid element contains it, or is closest to it.
        Parameters:
        coordVal - position in this coordinate system
        Returns:
        index of grid point containing it, or best estimate of closest grid interval.

      • findCoordElement

        public int findCoordElement​(double coordVal,
                            int lastIndex)
        Deprecated.
        use findCoordElement(coordVal)

      • getStart

        public double getStart()
        Get starting value if isRegular()
        Returns:
        starting value if isRegular()

      • getIncrement

        public double getIncrement()
        Get increment value if isRegular()
        Returns:
        increment value if isRegular()

      • isRegular

        public boolean isRegular()
        If true, then value(i) = getStart() + i * getIncrement().
        Returns:
        if evenly spaced.

      • correctLongitudeWrap

        @Deprecated
public void correctLongitudeWrap()
        Deprecated.
        do not use.

      • readValues

        protected void readValues()

      • builder

        public static CoordinateAxis1D.Builder<?> builder()
        Get Builder for this class that allows subclassing.
        See Also:
        "https://community.oracle.com/blogs/emcmanus/2010/10/24/using-builder-pattern-subclasses"