package gov.nasa.gsfc.spdf.cdfj; import java.io.*; import java.net.*; import java.nio.*; import java.util.*; import java.lang.reflect.*; /** * CDFReader extends GenericReader with access methods for time series * variables. Time series methods of this class do not require a detailed * knowledge of the internal structure of CDF. */ public class CDFReader extends GenericReader { Scalar scalar; CDFVector vector; public CDFReader() { } public static String version= "20191001"; /** * Constructs a reader for the given CDF file. */ public CDFReader(String cdfFile) throws CDFException.ReaderError { super(cdfFile); scalar = new Scalar(); scalar.rdr = this; vector = new CDFVector(); vector.rdr = this; } /** * Constructs a reader for the given URL for CDF file. */ public CDFReader(URL url) throws CDFException.ReaderError { super(url); scalar = new Scalar(); scalar.rdr = this; vector = new CDFVector(); vector.rdr = this; } /** * Returns {@link TimeSeries TimeSeries} of the specified variable * using the default {@link TimeInstantModel time instant model}. */ public TimeSeries getTimeSeries(String varName) throws CDFException.ReaderError { return getTimeSeries(varName, null, timeModelInstance()); } /** * Returns {@link TimeSeries TimeSeries} of the specified variable * using the specified {@link TimeInstantModel time instant model}. * @param varName variable name * @param tspec {@link TimeInstantModel time instant model}, May be * null, in which case the default model is used. */ public TimeSeries getTimeSeries(String varName, TimeInstantModel tspec) throws CDFException.ReaderError { TimeInstantModel _tspec = (tspec == null)?timeModelInstance():tspec; return getTimeSeries(varName, null, _tspec); } /** * Returns {@link TimeSeries TimeSeries} of the specified variable * in the specified time range using the default * {@link TimeInstantModel time instant model}. * @param varName variable name * @param startTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the first available time is used. * @param stopTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the stop time is assumed to be later than the last available time. */ public TimeSeries getTimeSeries(String varName, int[] startTime, int[] stopTime) throws CDFException.ReaderError { return getTimeSeries(varName, startTime, stopTime, null); } private TimeSeries getTimeSeries(String varName, double[] timeRange, TimeInstantModel tspec) throws CDFException.ReaderError { Variable var = thisCDF.getVariable(varName); TimeSeriesX ts = null; try { ts = new TSExtractor.GeneralTimeSeriesX(this, var, false, timeRange, tspec, false, true); return new TimeSeriesImpl(ts); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns {@link TimeSeries TimeSeries} of the specified variable in * the specified time range using the given * {@link TimeInstantModel time instant model}. * @param varName variable name * @param startTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the first available time is used. * @param stopTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the stop time is assumed to be later than the last available time. * @param tspec {@link TimeInstantModel time instant model}, May be * null, in which case the default model is used. * @return {@link TimeSeries time series} */ public TimeSeries getTimeSeries(String varName, int[] startTime, int[] stopTime, TimeInstantModel tspec) throws CDFException.ReaderError { TimeVariable tv = null; try { tv = TimeVariableFactory.getTimeVariable(this, varName); TimeInstantModel _tspec = tspec; if (_tspec == null) _tspec = timeModelInstance(); if (!tv.canSupportPrecision(_tspec.getOffsetUnits())) { throw new CDFException.ReaderError(varName + " has lower time precision than " + "requested."); } double[] trange = getAvailableTimeRange(varName); double[] tr = TSExtractor.getOverlap(this, trange, varName, startTime, stopTime); return getTimeSeries(varName, tr, tspec); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } private TimeSeriesOneD getTimeSeries(String varName, double[] timeRange, TimeInstantModel tspec, boolean columnMajor) throws CDFException.ReaderError { Variable var = thisCDF.getVariable(varName); TimeSeriesX ts = null; try { ts = new TSExtractor.GeneralTimeSeriesX(this, var, false, timeRange, tspec, true, columnMajor); return new TimeSeriesOneDImpl(ts); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns {@link TimeSeriesOneD time series} of the specified variable * in the specified time range using the given * {@link TimeInstantModel time instant model}. * @param varName variable name * @param startTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the first available time is used. * @param stopTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the stop time is assumed to be later than the last available time. * @param tspec {@link TimeInstantModel time instant model}, May be * null, in which case the default model is used. * @param columnMajor specifies whether the first index of the * variable dimension varies the fastest, i.e. IDL like. * @return {@link TimeSeriesOneD time series} */ public TimeSeriesOneD getTimeSeriesOneD(String varName, int[] startTime, int[] stopTime, TimeInstantModel tspec, boolean columnMajor) throws CDFException.ReaderError { try { TimeVariable tv = TimeVariableFactory.getTimeVariable(this, varName); TimeInstantModel _tspec = tspec; if (_tspec == null) _tspec = timeModelInstance(); if (!tv.canSupportPrecision(_tspec.getOffsetUnits())) { System.out.println("cannot support"); throw new Throwable(varName + " has lower time precision than " + "requested."); } double[] trange = getAvailableTimeRange(varName); double[] tr = TSExtractor.getOverlap(this, trange, varName, startTime, stopTime); return getTimeSeries(varName, tr, _tspec, columnMajor); } catch (Throwable th) { System.out.println(th.getMessage()); th.printStackTrace(); throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns available time range using default * {@link TimeInstantModel time instant model}. * @param varName variable name * @return double[2] 0th element is the first available offset time; * 1st element is the last available offset time; */ public double [] getAvailableTimeRange(String varName) throws CDFException.ReaderError { try { TimeVariable tv = TimeVariableFactory.getTimeVariable(this, varName); double[] times = tv.getTimes(); return new double[] {times[0], times[times.length - 1]}; } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } boolean overlaps(double[] t) { if (t[0] == Double.MIN_VALUE) return false; if (t[0] == Double.MAX_VALUE) return false; return true; } /** * Returns first available time for a variable. * Returned time has millisecond precision. * @return int[7] containing year, month, day, hour, minute, second and * millisecond, or null. * @throws CDFException.ReaderError if not a valid variable name. */ public int[] firstAvailableTime(String varName) throws CDFException.ReaderError { return firstAvailableTime(varName, null); } /** * Returns first available time which is not before the given time for a * variable. * Returned time has millisecond precision. * @param start a 3 to 7 element int[], containing year, * month (January is 1), day, hour, minute, second and millisecond. * @return int[7] containing year, month, day, hour, minute, second and * millisecond, or null. * @throws CDFException.ReaderError if not a valid variable name. */ public int[] firstAvailableTime(String varName, int[] start) throws CDFException.ReaderError { try { TimeVariable tv = TimeVariableFactory.getTimeVariable(this, varName); double[] times = tv.getTimes(); double[] trange = new double[] {times[0], times[times.length - 1]}; double[] tr; try { tr = TSExtractor.getOverlap(this, trange, varName, start, null); } catch (Exception ex) { return null; } if (tr[0] != Double.MIN_VALUE) { Calendar c = new GregorianCalendar(TimeZone.getTimeZone("GMT")); c.setTimeInMillis((long)tr[0]); if (tv.isTT2000()) { long l0 = c.getTime().getTime(); long l = (long)TimeUtil.getOffset(l0); c.setTimeInMillis((long)tr[0] - l + l0); } return GMT(c); } return null; } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns last available time for a variable. * Returned time has millisecond precision. * @return int[7] containing year, month, day, hour, minute, second and * millisecond, or null. * @throws CDFException.ReaderError if not a valid variable name. */ public int[] lastAvailableTime(String varName) throws CDFException.ReaderError { return lastAvailableTime(varName, null); } /** * Returns last available time which is not later than the given time * for a variable. * Returned time has millisecond precision. * @param stop a 3 to 7 element int[], containing year, * month (January is 1), day, hour, minute, second and millisecond. * @return int[7] containing year, month, day, hour, minute, second and * millisecond, or null. * @throws CDFException.ReaderError if not a valid variable name. */ public int[] lastAvailableTime(String varName, int[] stop) throws CDFException.ReaderError { try { TimeVariable tv = TimeVariableFactory.getTimeVariable(this, varName); double[] times = tv.getTimes(); double[] trange = new double[] {times[0], times[times.length - 1]}; double[] tr; try { tr = TSExtractor.getOverlap(this, trange, varName, null, stop); } catch (Exception ex) { return null; } if (tr[1] != Double.MAX_VALUE) { Calendar c = new GregorianCalendar(TimeZone.getTimeZone("GMT")); c.setTimeInMillis((long)tr[1]); if (tv.isTT2000()) { long l0 = c.getTime().getTime(); long l = (long)TimeUtil.getOffset(l0); c.setTimeInMillis((long)tr[1] - l + l0); } return GMT(c); } return null; } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } int[] GMT(Calendar c) { return new int[] {c.get(Calendar.YEAR), c.get(Calendar.MONTH) + 1, c.get(Calendar.DAY_OF_MONTH), c.get(Calendar.HOUR_OF_DAY), c.get(Calendar.MINUTE), c.get(Calendar.SECOND), c.get(Calendar.MILLISECOND)}; } /** * Returns {@link TimeInstantModel time instant model} with specified base * time and default offset units (millisecond) for a variable. * @param varName variable name * @param baseTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. */ public TimeInstantModel timeModelInstance(String varName, int[] baseTime) throws CDFException.ReaderError { if (baseTime.length < 3) throw new CDFException.ReaderError( "incomplete base time " + "definition."); try { boolean isTT2000 = TimeVariableFactory.getTimeVariable(this, varName).isTT2000(); long l = TSExtractor.getTime(baseTime); double msec = (!isTT2000)?(double)l: TimeUtil.milliSecondSince1970(l); msec += TimeVariableFactory.JANUARY_1_1970_LONG; return getTimeInstantModel(msec); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns {@link TimeInstantModel time instant model} with specified base * time and specified offset units (millisecond) for a variable. * @param varName variable name * @param baseTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. */ public TimeInstantModel timeModelInstance(String varName, int[] baseTime, TimePrecision offsetUnits) throws CDFException.ReaderError { TimeInstantModel model = timeModelInstance(varName, baseTime); model.setOffsetUnits(offsetUnits); return model; } private TimeInstantModel getTimeInstantModel(double msec) { TimeInstantModel tspec = TimeVariableFactory.getDefaultTimeInstantModel(msec); return tspec; } private double getTime(String varName, int[] time) throws CDFException.ReaderError { try { return TSExtractor.getTime(this, varName, time); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns default {@link TimeInstantModel time instant model}. *

* The base of default TimeInstantModel is January 1,1970 0:0:0 */ public static TimeInstantModel timeModelInstance() { return TimeVariableFactory.getDefaultTimeInstantModel(); } /** * Returns {@link TimeInstantModel time instant model} that uses * given units for the offset.. *

* The base of default TimeInstantModel is January 1,1970 0:0:0 */ public static TimeInstantModel timeModelInstance(String offsetUnits) { TimeInstantModel tim = TimeVariableFactory.getDefaultTimeInstantModel(); tim.setOffsetUnits(TimePrecision.getPrecision(offsetUnits)); return tim; } class TimeSeriesOneDImpl extends TimeSeriesImpl implements TimeSeriesOneD { boolean columnMajor; TimeSeriesOneDImpl(TimeSeriesX ts) throws CDFException.ReaderError { super(ts); if (!ts.isOneD()) { throw new CDFException.ReaderError( "Not 1D timeseries."); } columnMajor = ts.isColumnMajor(); } public double[] getValues() throws CDFException.ReaderError { return (double[])values; } public double[] getValuesOneD() throws CDFException.ReaderError { return (double[])values; } public boolean isColumnMajor() {return columnMajor;} } class TimeSeriesImpl implements TimeSeries { double[] times; Object values; TimeInstantModel tspec; public TimeSeriesImpl(TimeSeries ts) throws CDFException.ReaderError { times = ts.getTimes(); values = ts.getValues(); tspec = ts.getTimeInstantModel(); } public TimeInstantModel getTimeInstantModel() {return tspec;} public double[] getTimes() throws CDFException.ReaderError { return times; } public Object getValues() throws CDFException.ReaderError { return values; } } /** * Returns names of variables that the specified variable depends on. * @return String[] */ public String[] getDependent(String varName) { String[] anames = thisCDF.variableAttributeNames(varName); if (anames == null) return new String[0]; Vector dependent = new Vector(); for (int i = 0; i < anames.length; i++) { if (!anames[i].startsWith("DEPEND_")) continue; dependent.add( ((Vector)thisCDF.getAttribute(varName, anames[i])).get(0)); } String[] sa = new String[dependent.size()]; dependent.toArray(sa); return sa; } /** * Returns the name of the specified index of a multi-dimensional * variable * @param varName variable name * @param index index whose name is required * @return String */ public String getIndexName(String varName, int index) throws CDFException.ReaderError { try { int[] dim = getDimensions(varName); if (dim.length == 0) return null; if (index >= dim.length) return null; Vector attr = (Vector)getAttribute(varName, "DEPEND_" + (1 + index)); return (String)attr.get(0); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns the time series of the specified scalar variable, ignoring * points whose value equals fill value. *

* A double[2][] array is returned. The 0th element is the * array containing times, and the 1st element is the array containing * corresponding values. If a fill value has been specified for this * variable via the FILLVAL attribute, then points where the value is * equal to fill value are excluded. *

* @throws CDFException.ReaderError if variables is non-numeric, or * is not a scalar. */ public double[][] getScalarTimeSeries(String varName) throws CDFException.ReaderError { try { return scalar.getTimeSeries(varName); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns the time series of the specified scalar variable in the * specified time range, ignoring points whose value equals * fill value. *

* A double[2][] array is returned. The 0th element is the * array containing times, and the 1st element is the array containing * corresponding values. * If a fill value has been specified for this variable via the FILLVAL * attribute, then points where the * value is equal to fill value are excluded. *

* For numeric variables of dimension other than 0, and for * character string variables an exception is thrown. * @param startTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the first available time is used. * @param stopTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the stop time is assumed to be later than the last available time. * @throws CDFException.ReaderError if variables is non-numeric, or * is not a scalar. */ public double[][] getScalarTimeSeries(String varName, int[] startTime, int[] stopTime) throws CDFException.ReaderError { try { return scalar.getTimeSeries(varName, startTime, stopTime); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns the time series as a {@link TimeSeries TimeSeries}, of the * specified scalar variable in the specified time range, using the given * {@link TimeInstantModel time instant model}, ignoring points whose * value equals fill value. *

* If a fill value has been specified for this variable via the FILLVAL * attribute, then points where the value is equal to fill value are * excluded. *

* @param startTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the first available time is used. * @param stopTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the stop time is assumed to be later than the last available time. * @param tspec {@link TimeInstantModel time instant model}, May be * null, in which case the default model is used. * @throws CDFException.ReaderError if variables is non-numeric, or * is not a scalar. */ public TimeSeries getScalarTimeSeries(String varName, int[] startTime, int[] stopTime, TimeInstantModel tspec) throws CDFException.ReaderError { try { return scalar.getTimeSeries(varName, startTime, stopTime, tspec); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns the time series of the specified scalar variable, optionally * ignoring points whose value equals fill value. *

* A double[2][] array is returned. The 0th element is the * array containing times, and the 1st element is the array containing * corresponding values. If a fill value has been specified for this * variable via the FILLVAL attribute, then points where the value is * equal to fill value are excluded if ignoreFill = true. *

* @throws CDFException.ReaderError if variables is non-numeric, or * is not a scalar. */ public double[][] getScalarTimeSeries(String varName, boolean ignoreFill) throws CDFException.ReaderError { try { return scalar.getTimeSeries(varName, ignoreFill); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns the time series of the specified scalar variable in the * specified time range, optionally ignoring points whose value equals * fill value. *

* A double[2][] array is returned. The 0th element is the * array containing times, and the 1st element is the array containing * corresponding values. * If a fill value has been specified for this variable via the FILLVAL * attribute, then if ignoreFill has the value true, points where the * value is equal to fill value are excluded if ignoreFill = true. *

* @param startTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the first available time is used. * @param stopTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the stop time is assumed to be later than the last available time. * @throws CDFException.ReaderError if variables is non-numeric, or * is not a scalar. */ public double[][] getScalarTimeSeries(String varName, boolean ignoreFill, int[] startTime, int[] stopTime) throws CDFException.ReaderError { try { return scalar.getTimeSeries(varName, ignoreFill, startTime, stopTime); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns the time series as a {@link TimeSeries TimeSeries} of the * specified scalar variable in the specified time range using the given * {@link TimeInstantModel time instant model}, optionally ignoring points * whose * value equals fill value. *

* If a fill value has been specified for this variable via the FILLVAL * attribute, then if ignoreFill has the value true, points where the * value is equal to fill value are excluded if ignoreFill = true. *

* @param startTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the first available time is used. * @param stopTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the stop time is assumed to be later than the last available time. * @param tspec {@link TimeInstantModel time instant model}, May be * null, in which case the default model is used. * @throws CDFException.ReaderError if variables is non-numeric, or * is not a scalar. */ public TimeSeries getScalarTimeSeries(String varName, boolean ignoreFill, int[] startTime, int[] stopTime, TimeInstantModel tspec) throws CDFException.ReaderError { try { return scalar.getTimeSeries(varName, ignoreFill, startTime, stopTime, tspec); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /* void checkType(String varName) throws Throwable { Variable var = thisCDF.getVariable(varName); int type = var.getType(); if (DataTypes.typeCategory[type] == DataTypes.LONG) { throw new Throwable("This method cannot be used for " + "variables of type long. Use the get methods for the " + "variable " + "and the associated time variable. "); } } */ class Scalar { MetaData rdr; double[][] _getTimeSeries(String varName, boolean ignoreFill, double[] timeRange) throws Throwable { checkType(varName); Variable var = thisCDF.getVariable(varName); Method method = TSExtractor.getMethod(var, "TimeSeries", 0); return (double[][])method.invoke(null, new Object [] {rdr, var, new Boolean(ignoreFill), timeRange}); } TimeSeries _getTimeSeries(String varName, boolean ignoreFill, double[] timeRange, TimeInstantModel tspec) throws Throwable { checkType(varName); Variable var = thisCDF.getVariable(varName); Method method = TSExtractor.getMethod(var, "TimeSeriesObject", 0); TimeSeries ts = (TimeSeries)method.invoke(null, new Object [] {rdr, var, new Boolean(ignoreFill), timeRange, tspec}); return new TimeSeriesImpl(ts); } public double[][] getTimeSeries(String varName) throws Throwable { Variable var = thisCDF.getVariable(varName); if (var.getEffectiveRank() != 0) throw new Throwable(varName + " is not a scalar."); return _getTimeSeries(varName, true, null); } public double[][] getTimeSeries(String varName, int[] startTime, int[] stopTime) throws Throwable { if (thisCDF.getVariable(varName).getEffectiveRank() != 0) throw new Throwable(varName + " is not a scalar."); double[] trange = getAvailableTimeRange(varName); double[] tr = TSExtractor.getOverlap(rdr, trange, varName, startTime, stopTime); return _getTimeSeries(varName, true, tr); } public TimeSeries getTimeSeries(String varName, int[] startTime, int[] stopTime, TimeInstantModel tspec) throws Throwable { if (thisCDF.getVariable(varName).getEffectiveRank() != 0) throw new Throwable(varName + " is not a scalar."); double[] trange = getAvailableTimeRange(varName); double[] tr = TSExtractor.getOverlap(rdr, trange, varName, startTime, stopTime); return _getTimeSeries(varName, true, tr, tspec); } public double[][] getTimeSeries(String varName, boolean ignoreFill) throws Throwable { if (thisCDF.getVariable(varName).getEffectiveRank() != 0) throw new Throwable(varName + " is not a scalar."); return _getTimeSeries(varName, ignoreFill, null); } public double[][] getTimeSeries(String varName, boolean ignoreFill, int[] startTime, int[] stopTime) throws Throwable { if (thisCDF.getVariable(varName).getEffectiveRank() != 0) throw new Throwable(varName + " is not a scalar."); double[] trange = getAvailableTimeRange(varName); double[] tr = TSExtractor.getOverlap(rdr, trange, varName, startTime, stopTime); return _getTimeSeries(varName, ignoreFill, tr); } public TimeSeries getTimeSeries(String varName, boolean ignoreFill, int[] startTime, int[] stopTime, TimeInstantModel tspec) throws Throwable { if (thisCDF.getVariable(varName).getEffectiveRank() != 0) throw new Throwable(varName + " is not a scalar."); double[] trange = getAvailableTimeRange(varName); double[] tr = TSExtractor.getOverlap(rdr, trange, varName, startTime, stopTime); return _getTimeSeries(varName, ignoreFill, tr, tspec); } } /** * Returns the time series of the specified component of a 1 dimensional * variable, ignoring points whose value equals fill value. *

* A double[2][] array is returned. The 0th element is the * array containing times, and the 1st element is the array containing * corresponding values. If a fill value has been specified for this * variable via the FILLVAL attribute, then points where the value is * equal to fill value are excluded. *

* @throws CDFException.ReaderError if variables is non-numeric, or is * not a vector. */ public double[][] getVectorTimeSeries(String varName, int component) throws CDFException.ReaderError { try { return vector.getTimeSeries(varName, component); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns the time series of the specified component of 1 dimensional * variable in the specified time range, ignoring points whose * value equals fill value. *

* A double[2][] array is returned. The 0th element is the * array containing times, and the 1st element is the array containing * corresponding values. If a fill value has been specified for this * variable via the FILLVAL attribute, then points where the value is * equal to fill value are excluded. *

* @param startTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the first available time is used. * @param stopTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the stop time is assumed to be later than the last available time. * @throws CDFException.ReaderError if variables is non-numeric, or is * not a vector. */ public double[][] getVectorTimeSeries(String varName, int component, int[] startTime, int[] stopTime) throws CDFException.ReaderError { try { return vector.getTimeSeries(varName, component, startTime, stopTime); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns the time series as a {@link TimeSeries TimeSeries}, of the * specified component of a vector variable in the specified time range * using the given {@link TimeInstantModel time instant model}, ignoring * points * whose value * equals fill value. *

* If a fill value has been specified for this variable via the FILLVAL * attribute, then points where the value is equal to fill value are * excluded. *

* @param varName variable name * @param component index of the vector component * @param startTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the first available time is used. * @param stopTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the stop time is assumed to be later than the last available time. * @param tspec {@link TimeInstantModel time instant model}, May be * null, in which case the default model is used. * @throws CDFException.ReaderError if variables is non-numeric, or is * not a vector. */ public TimeSeries getVectorTimeSeries(String varName, int component, int[] startTime, int[] stopTime, TimeInstantModel tspec) throws CDFException.ReaderError { try { return vector.getTimeSeries(varName, component, startTime, stopTime, tspec); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns the time series of the specified component of a 1 dimensional * variable, optionally ignoring points whose value equals fill value. *

* A double[2][] array is returned. The 0th element is the * array containing times, and the 1st element is the array containing * corresponding values. If a fill value has been specified for this * variable via the FILLVAL attribute, then points where the value is * equal to fill value are excluded if ignoreFill = true. *

* @throws CDFException.ReaderError if variables is non-numeric, or is * not a vector. */ public double[][] getVectorTimeSeries(String varName, int component, boolean ignoreFill) throws CDFException.ReaderError { try { return vector.getTimeSeries(varName, component, ignoreFill); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns the time series of the specified component of 1 dimensional * variable in the specified time range, optionally ignoring points whose * value equals fill value. *

* A double[2][] array is returned. The 0th element is the * array containing times, and the 1st element is the array containing * corresponding values. If a fill value has been specified for this * variable via the FILLVAL attribute, then points where the value is * equal to fill value are excluded if ignoreFill = true. *

* @param startTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. * @param stopTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the stop time is assumed to be later than the last available time. * @throws CDFException.ReaderError if variables is non-numeric, or is * not a vector. */ public double[][] getVectorTimeSeries(String varName, int component, boolean ignoreFill, int[] startTime, int[] stopTime) throws CDFException.ReaderError { try { return vector.getTimeSeries(varName, component, ignoreFill, startTime, stopTime); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } /** * Returns the {@link TimeSeries time series} of the specified component * of 1 dimensional variable in the specified time range using the given * {@link TimeInstantModel time instant model}, optionally ignoring points * whose * value * equals fill value. *

* If a fill value has been specified for this variable via the FILLVAL * attribute, then if ignoreFill has the value true, points where the * value is equal to fill value are excluded if ignoreFill = true. *

* @param varName variable name * @param startTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the first available time is used. * @param stopTime a 3 to 7 element int[], containing year, * month (January is 1), * day,hour, minute, second and millisecond. May be null, in which case * the stop time is assumed to be later than the last available time. * @param tspec {@link TimeInstantModel time instant model}, May be * null, in which case the default model is used. * @throws CDFException.ReaderError if variables is non-numeric, or * is not a vector. * Use {@link #getTimeSeries(String varName) getTimeSeries( * String varName)} for string type. */ public TimeSeries getVectorTimeSeries(String varName, int component, boolean ignoreFill, int[] startTime, int[] stopTime, TimeInstantModel tspec) throws CDFException.ReaderError { try { return vector.getTimeSeries(varName, component, ignoreFill, startTime, stopTime, tspec); } catch (Throwable th) { throw new CDFException.ReaderError(th.getMessage()); } } class CDFVector { MetaData rdr; private double[][] _getTimeSeries(String varName, int component, boolean ignoreFill, double[] timeRange) throws Throwable { checkType(varName); Variable var = thisCDF.getVariable(varName); Method method = TSExtractor.getMethod(var, "TimeSeries", 1); return (double[][])method.invoke(null, new Object [] {rdr, var, new Integer(component), new Boolean(ignoreFill), timeRange}); } private TimeSeries _getTimeSeries(String varName, int component, boolean ignoreFill, double[] timeRange, TimeInstantModel tspec) throws Throwable { checkType(varName); Variable var = thisCDF.getVariable(varName); Method method = TSExtractor.getMethod(var, "TimeSeriesObject", 1); TimeSeries ts = (TimeSeries)method.invoke(null, new Object [] {rdr, var, new Integer(component), new Boolean(ignoreFill), timeRange, tspec}); return new TimeSeriesImpl(ts); } public double[][] getTimeSeries(String varName, int component) throws Throwable { Variable var = thisCDF.getVariable(varName); if (var.getEffectiveRank() != 1) throw new Throwable(varName + " is not a vector."); int dim = var.getEffectiveDimensions()[0]; if ((component < 0) || (component > dim)) throw new Throwable( "component exceeds dimension of " + varName + " (" + dim +")"); return _getTimeSeries(varName, component, true, null); } public double[][] getTimeSeries(String varName, int component, int[] startTime, int[] stopTime) throws Throwable { if (thisCDF.getVariable(varName).getEffectiveRank() != 1) throw new Throwable(varName + " is not a vector."); Integer dim = (Integer) (thisCDF.getVariable(varName).getElementCount().get(0)); if ((component < 0) || (component > dim.intValue())) throw new Throwable("Invalid component " + component + " for " + varName); double[] trange = getAvailableTimeRange(varName); double[] tr = TSExtractor.getOverlap(rdr, trange, varName, startTime, stopTime); return _getTimeSeries(varName, component, true, tr); } public TimeSeries getTimeSeries(String varName, int component, int[] startTime, int[] stopTime, TimeInstantModel tspec) throws Throwable { if (thisCDF.getVariable(varName).getEffectiveRank() != 1) throw new Throwable(varName + " is not a vector."); Integer dim = (Integer) (thisCDF.getVariable(varName).getElementCount().get(0)); if ((component < 0) || (component > dim.intValue())) throw new Throwable("Invalid component " + component + " for " + varName); double[] trange = getAvailableTimeRange(varName); double[] tr = TSExtractor.getOverlap(rdr, trange, varName, startTime, stopTime); return _getTimeSeries(varName, component, true, tr, tspec); } public double[][] getTimeSeries(String varName, int component, boolean ignoreFill) throws Throwable { if (thisCDF.getVariable(varName).getEffectiveRank() != 1) throw new Throwable(varName + " is not a vector."); Integer dim = (Integer) (thisCDF.getVariable(varName).getElementCount().get(0)); if ((component < 0) || (component > dim.intValue())) throw new Throwable("Invalid component " + component + " for " + varName); return _getTimeSeries(varName, component, ignoreFill, null); } public double[][] getTimeSeries(String varName, int component, boolean ignoreFill, int[] startTime, int[] stopTime) throws Throwable { if (thisCDF.getVariable(varName).getEffectiveRank() != 1) throw new Throwable(varName + " is not a vector."); Integer dim = (Integer) (thisCDF.getVariable(varName).getElementCount().get(0)); if ((component < 0) || (component > dim.intValue())) throw new Throwable("Invalid component " + component + " for " + varName); double[] trange = getAvailableTimeRange(varName); double[] tr = TSExtractor.getOverlap(rdr, trange, varName, startTime, stopTime); return _getTimeSeries(varName, component, ignoreFill, tr); } public TimeSeries getTimeSeries(String varName, int component, boolean ignoreFill, int[] startTime, int[] stopTime, TimeInstantModel tspec) throws Throwable { if (thisCDF.getVariable(varName).getEffectiveRank() != 1) throw new Throwable(varName + " is not a vector."); Integer dim = (Integer) (thisCDF.getVariable(varName).getElementCount().get(0)); if ((component < 0) || (component > dim.intValue())) throw new Throwable("Invalid component " + component + " for " + varName); double[] trange = getAvailableTimeRange(varName); double[] tr = TSExtractor.getOverlap(rdr, trange, varName, startTime, stopTime); return _getTimeSeries(varName, component, ignoreFill, tr, tspec); } } }