Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
ucar.nc2.dt.DataIterator use ucar.nc2.ft.*
ucar.nc2.dt.PointCollection
ucar.nc2.dt.PointObsDataset use ucar.nc2.ft.*
ucar.nc2.dt.PointObsDatatype use ucar.nc2.ft.*
ucar.nc2.dt.StationCollection
ucar.nc2.dt.StationObsDataset use ucar.nc2.ft.*
ucar.nc2.dt.StationObsDatatype use ucar.nc2.ft.*
ucar.nc2.dt.TimeSeriesCollection use ucar.nc2.ft.*
ucar.nc2.dt.TrajectoryObsDataset
ucar.nc2.dt.TrajectoryObsDatatype use ucar.nc2.ft.*
ucar.nc2.dt.TypedDataset use ucar.nc2.ft.*
ucar.nc2.dt.TypedDatasetFactoryIF use ucar.nc2.ft.*

Deprecated Classes

Class and Description
ucar.nc2.dt.trajectory.ARMTrajectoryObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.grid.CFGridWriter use CFGridWriter2
ucar.nc2.dt.point.CFPointObWriter use WriterCFPointCollection
ucar.nc2.dt.point.CFstationObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.trajectory.COSMICTrajectoryObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.DataIteratorAdapter use ucar.nc2.ft.*
ucar.nc2.dt.DatatypeIterator use ucar.nc2.ft.*
ucar.nc2.FileWriter use FileWriter2
ucar.nc2.FileWriter.ChunkingIndex use FileWriter2.ChunkingIndex
ucar.nc2.FileWriter.FileWriterProgressEvent use FileWriter2.FileWriterProgressEvent
ucar.nc2.dt.trajectory.Float10TrajectoryObsDataset use ucar.nc2.ft.point
ucar.nc2.grib.grib2.Grib2DataReader use Grib2DataReader2
ucar.nc2.grib.GribVariableRenamer As of version 4.5.0 - this was only intended to be used for the 4.2 - 4.3 transition. Extended to work with 4.5 dataset names, but deprecated to reminder users to update the variable names used in their applications. Try to figure out what GRIB name in 4.2 maps to in 4.3 NCEP IDD datasets. Not guaranteed to be correct. See ToolsUI IOSP/GRIB2/GRIB-RENAME
ucar.nc2.grib.GribVariableRenamer.VariableRenamerBean
ucar.nc2.dt.point.MadisPointObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.point.MadisStationObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.point.decode.MetarParseReport
thredds.inventory.MFileCollectionManager
ucar.nc2.dt.trajectory.MultiTrajectoryObsDataset use ucar.nc2.ft.*
ucar.nc2.dt.point.NdbcDataset use ucar.nc2.ft.point
ucar.nc2.NetcdfFileWriteable use NetcdfFileWriter
ucar.nc2.dt.point.OldUnidataPointObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.point.OldUnidataStationObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.point.PointObsDatasetFactory use ucar.nc2.ft.point
ucar.nc2.dt.point.PointObsDatasetImpl use ucar.nc2.ft.point
ucar.nc2.dt.point.PointObsDatatypeImpl use ucar.nc2.ft.point
ucar.nc2.dt.point.PointObVar use ucar.nc2.ft.point
ucar.nc2.dt.trajectory.RafTrajectoryObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.point.RecordDatasetHelper use ucar.nc2.ft.*
ucar.nc2.dt.trajectory.SimpleTrajectoryObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.trajectory.SingleTrajectoryObsDataset use ucar.nc2.ft.*
ucar.nc2.dt.point.StationDatasetCollection use ucar.nc2.ft.point
ucar.nc2.dt.point.StationDatasetHelper use ucar.nc2.ft.point
ucar.nc2.dt.StationImpl use ucar.unidata.geoloc.StationImpl
ucar.nc2.dt.point.StationObsDatasetImpl use ucar.nc2.ft.point
ucar.nc2.dt.point.StationObsDatasetInfo use ucar.nc2.ft.point
ucar.nc2.dt.point.StationObsDatatypeImpl use ucar.nc2.ft.point
ucar.nc2.StructurePseudo use ucar.nc2.dataset.StructurePseudoDS
ucar.nc2.dt.trajectory.TrajectoryObsDatasetFactory use ucar.nc2.dt.TypedDatasetFactory
ucar.nc2.dt.trajectory.TrajectoryObsDatasetImpl use ucar.nc2.ft.*
ucar.nc2.dt.TypedDatasetFactory
ucar.nc2.dt.TypedDatasetImpl use ucar.nc2.ft.*
ucar.nc2.dt.point.UnidataObsDatasetHelper use ucar.nc2.ft.point
ucar.nc2.ft.point.standard.plug.UnidataPointFeature
ucar.nc2.dt.point.UnidataPointObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.point.UnidataStationObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.point.UnidataStationObsDataset2 use UnidataStationObsDataset instead of this.
ucar.nc2.dt.point.UnidataStationObsMultidimDataset use ucar.nc2.ft.point
ucar.nc2.dt.trajectory.UnidataTrajectoryObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.trajectory.UnidataTrajectoryObsDataset2 use ucar.nc2.ft.point
ucar.nc2.dt.VariableSimpleSubclass use ucar.nc2.ft.*
ucar.nc2.dt.point.WriterCFPointDataset use WriterCFPointCollection
ucar.nc2.dt.point.WriterCFStationObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.point.WriterProfileObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.point.WriterStationObsDataset use ucar.nc2.ft.point
ucar.nc2.dt.trajectory.ZebraClassTrajectoryObsDataset use ucar.nc2.ft.point

Deprecated Fields

Field and Description
ucar.nc2.iosp.grid.GridDefRecord.WIND_FLAG use Grib2Tables.VectorComponentFlag

Deprecated Methods

Method and Description
thredds.catalog.InvService.addDatasetRoot(InvProperty) use InvCatalogImpl
thredds.catalog.InvDatasetImpl.addService(InvService) add services only to catalog
ucar.nc2.NetcdfFileWriteable.addVariable(String, Class, Dimension[]) use addVariable(String varName, DataType dataType, ArrayList dims);
ucar.ma2.Range.appendShape(List, int) use Section.appendRange(int size)
ucar.nc2.util.net.HttpClientManager.appendUrlContentsToFile(HTTPSession, String, File, long, long)
ucar.unidata.geoloc.LatLonPointImpl.betweenLon(double, double, double)
ucar.ma2.Range.checkInRange(List, int[]) use Section.checkInRange(int shape[])
ucar.httpservices.HTTPSession.clearState()
ucar.ma2.Range.computeSize(List) use Section.computeSize()
ucar.nc2.iosp.IospHelper.copyToArrayBB(StructureData) use StructureDataDeep.copyToArrayBB
ucar.nc2.util.net.HttpClientManager.copyUrlContentsToFile(HTTPSession, String, File)
ucar.nc2.FileWriter.copyVarData(NetcdfFileWriteable, List<Variable>, Structure, long)
ucar.nc2.iosp.netcdf3.N3iosp.createValidNetcdf3ObjectName(String) use makeValidNetcdfObjectName
ucar.nc2.util.URLnaming.escapeQuery(String)
ucar.ma2.Range.factory(int[]) use Section(int[] shape)
ucar.ma2.Range.factory(int[], int[]) use Section(int[] origin, int[] shape)
ucar.nc2.dt.grid.GridDataset.factory(String) : use GridDataset.open().
ucar.nc2.dataset.CoordinateAxis1D.findCoordElement(double, int) use findCoordElement(coordVal)
ucar.nc2.dataset.CoordinateAxis1DTime.findTimeIndexFromDate(Date) use findTimeIndexFromCalendarDate
ucar.nc2.dt.grid.GridCoordSys.findTimeIndexFromDate(Date) use CoordinateAxis1DTime.findTimeIndexFromDate
ucar.nc2.dt.grid.GridCoordSys.findXYCoordElement(double, double, int[]) use findXYindexFromCoord
ucar.nc2.ft.NestedPointFeatureCollection.flatten(LatLonRect, DateRange) use CalendarDateRange
ucar.nc2.ft.StationTimeSeriesFeatureCollection.flatten(List<String>, DateRange, List<VariableSimpleIF>) use CalendarDateRange
ucar.units.ASCII_CharStream.getColumn()
ucar.units.SimpleCharStream.getColumn()
ucar.nc2.util.net.HttpClientManager.getContentAsString(HTTPSession, String)
ucar.nc2.ft.PointFeature.getData() use getFeatureData() or getDataAll()
thredds.catalog.InvCatalog.getDataset() use getDatasets()
thredds.catalog.InvService.getDatasetRoots() put roots only in the catalog
ucar.nc2.dt.grid.GeoGrid.getDataSlice(int, int, int, int) use readDataSlice
ucar.nc2.units.DateType.getDate() use getCalendarDate()
ucar.nc2.dataset.CoordinateAxis1DTime.getDateRange() use getCalendarDateRange()
ucar.nc2.ft.PointFeatureCollection.getDateRange() use getCalendarDateRange()
ucar.nc2.ft.FeatureDataset.getDateRange() use getCalendarDateRange
ucar.nc2.ft.PointFeatureIterator.getDateRange() use getCalendarDateRange()
ucar.nc2.dt.GridCoordSystem.getDateRange() use getCalendarDateRange()
ucar.nc2.dt.grid.GridCoordSys.getDateRange() use getCalendarDateRange
ucar.nc2.dt.grid.GridDataset.getDateRange() use getCalendarDateRange
ucar.nc2.ft.FeatureDataset.getEndDate() use getCalendarDateEnd
ucar.nc2.dt.grid.GridDataset.getEndDate() use getEndCalendarDate
thredds.catalog.InvService.getFullName() services should always be at top level.
ucar.nc2.dt.grid.GridDataset.Gridset.getGeoCoordSys() use getGeoCoordSystem() if possible.
ucar.ma2.Array.getIndexIteratorFast() use getIndexIterator
ucar.nc2.units.DateFormatter.getISODate(String) As of netCDF-JAVA 4.3.10. Use CalendarDateFormatter.isoStringToDate(String) instead
ucar.nc2.dt.grid.GridCoordSys.getLatLonBoundingBox(LatLonRect) use getRangesFromLatLonRect.
ucar.units.ASCII_CharStream.getLine()
ucar.units.SimpleCharStream.getLine()
ucar.nc2.dataset.CoordinateAxis2D.getMidpoints() use getCoordValuesArray
ucar.nc2.VariableSimpleIF.getName() use getFullName or getShortName
ucar.nc2.CDMNode.getName() Replaced by CDMNode.getShortName() and CDMNode.getFullName()
ucar.httpservices.HTTPMethod.getName()
ucar.nc2.Variable.getNameAndDimensions(StringBuffer) use getNameAndDimensions(StringBuilder buf)
ucar.nc2.ft.PointFeature.getNominalTimeAsDate() use getNominalTimeAsCalendarDate()
ucar.nc2.ft.PointFeature.getObservationTimeAsDate() use getObservationTimeAsCalendarDate()
ucar.ma2.Range.getOrigin(List) use Section.getOrigin()
ucar.httpservices.HTTPSession.getRetryCount()
ucar.httpservices.HTTPSession.getSessionURL()
ucar.ma2.Range.getShape(List) use Section.getShape()
ucar.nc2.units.DateFormatter.getStandardDateOnlyString(Date) use toDateOnlyString
ucar.nc2.units.DateFormatter.getStandardDateString(Date) use toDateTimeStringISO
ucar.nc2.units.DateFormatter.getStandardDateString2(Date) use toDateTimeString
ucar.nc2.ft.FeatureDataset.getStartDate() use getCalendarDateStart
ucar.nc2.dt.grid.GridDataset.getStartDate() use getStartCalendarDate
ucar.nc2.dataset.CoordinateAxis1DTime.getTimeDate(int) use getCalendarDate()
ucar.nc2.dataset.CoordinateAxis1DTime.getTimeDates() use getCalendarDates() to correctly interpret calendars
ucar.nc2.dt.grid.GridCoordSys.getTimeDates() use getCalendarDates
ucar.nc2.dt.grid.GridCoordSys.getTimeIndex(String)
ucar.nc2.dt.grid.GridCoordSys.getTimeName(int)
ucar.nc2.dt.grid.GeoGrid.getUnitString() use getUnitsString()
ucar.nc2.util.net.HttpClientManager.getUrlContentsAsString(HTTPSession, String, int)
ucar.nc2.time.CalendarPeriod.getValueInMillisecs() dont use because these are fixed length and thus approximate.
ucar.nc2.dataset.CoordinateAxis1DTime.hasTime(Date) use hasCalendarDate
ucar.nc2.time.CalendarDateFormatter.isoStringToDate(String) use isoStringToCalendarDate
ucar.nc2.Variable.isUnknownLength() use isVariableLength()
ucar.nc2.iosp.netcdf3.N3iosp.isValidNetcdf3ObjectName(String) use isValidNetcdfObjectName
ucar.nc2.dataset.NetcdfDataset.makeArray(DataType, List<String>) use Array#makeArray directly
ucar.nc2.iosp.IospHelper.makeArrayBB(ArrayStructure) use StructureDataDeep.copyToArrayBB
ucar.nc2.dataset.CoordSysBuilder.makeDummyTransformVariable(NetcdfDataset, CoordinateTransform) use CoordTransBuilder.makeDummyTransformVariable
thredds.catalog.InvDatasetScan.makeLatestCatalogForDirectory(String, URI) Instead use makeProxyDsResolver() which provides more general proxy dataset handling.
ucar.ma2.Range.makeSectionSpec(List) use Section.toString()
ucar.nc2.iosp.netcdf3.N3iosp.makeValidNetcdf3ObjectName(String) use makeValidNetcdfObjectName
ucar.ma2.Range.max() use last()
ucar.ma2.Range.min() use first()
ucar.httpservices.HTTPFactory.newSession(AuthScope)
ucar.nc2.dt.DataIterator.next() use nextData()
ucar.nc2.time.CalendarDateRange.of(DateRange)
ucar.nc2.time.CalendarDateFormatter.parseISODate(String) As of 4.3.10 use CalendarDateFormatter.isoStringToDate(String) instead
ucar.ma2.Range.parseSpec(String) use new Section(String sectionSpec)
ucar.nc2.NCdumpW.printArray(Array, String, CancelTask) use toString()
ucar.nc2.ui.Ncdumpx.printArray(Array, String, CancelTask) use toString()
ucar.nc2.NetcdfFile.read(String, boolean) use readSection(), flatten=false no longer supported
ucar.nc2.iosp.grid.GridDefRecord.readDouble(String) use getParamDouble(String key)
ucar.nc2.dods.DODSNetcdfFile.reGroupVariable(Group, DODSVariable)
thredds.catalog.InvDatasetImpl.removeService(InvService) put services in catalog
ucar.httpservices.HTTPMethod.sessionCompatible(HttpHost)
ucar.nc2.dods.DODSNetcdfFile.setAllowDeflate(boolean) use setAllowCompression
ucar.nc2.util.DiskCache2.setCachePathPolicy(int, String) use setCachePathPolicy(CachePathPolicy cachePathPolicy, String cachePathPolicyParam)
ucar.unidata.geoloc.projection.Stereographic.setCentralMeridian(double)
ucar.httpservices.HTTPSession.setCredentials(String, Credentials)
ucar.httpservices.HTTPSession.setCredentialsProvider(AuthScope, CredentialsProvider)
ucar.httpservices.HTTPSession.setCredentialsProvider(String, CredentialsProvider)
thredds.catalog.InvCatalogImpl.setDataset(InvDatasetImpl) Use addDataset() instead; datamodel now allows multiple top level datasets.
ucar.nc2.ft.PointFeatureCollection.setDateRange(DateRange) use setCalendarDateRange()
ucar.ma2.Range.setDefaults(List, int[]) use Section.setDefaults(int[] shape)
ucar.nc2.iosp.grid.GridServiceProvider.setExtendIndex(boolean) use setIndexFileModeOnSync and setIndexFileModeOnOpen
ucar.httpservices.HTTPSession.setGlobalCompression()
ucar.httpservices.HTTPSession.setGlobalCredentials(String, Credentials)
ucar.httpservices.HTTPSession.setGlobalCredentialsProvider(AuthScope, CredentialsProvider)
ucar.httpservices.HTTPSession.setGlobalCredentialsProvider(CredentialsProvider, String)
ucar.httpservices.HTTPSession.setGlobalCredentialsProvider(String, CredentialsProvider)
ucar.httpservices.HTTPSession.setGlobalProxy(String, int)
ucar.httpservices.HTTPMethod.setMethodHeaders(List<Header>)
ucar.nc2.NetcdfFileWriteable.setName(String) use NetcdfFileWriteable.createNew(String filename);
ucar.nc2.util.DiskCache2.setPolicy(int) use setCachePathPolicy(CachePathPolicy cachePathPolicy)
ucar.httpservices.HTTPSession.setProxy(String, int)
ucar.httpservices.HTTPMethod.setRequestHeader(Header)
ucar.httpservices.HTTPMethod.setRequestHeader(String, String)
ucar.httpservices.HTTPSession.setRetryCount(int)
ucar.unidata.geoloc.projection.Stereographic.setScale(double)
ucar.unidata.geoloc.projection.Stereographic.setTangentLat(double)
ucar.unidata.geoloc.projection.Stereographic.setTangentLon(double)
ucar.nc2.dataset.NetcdfDataset.setValues(Variable, int, double, double) use Variable.setValues()
ucar.nc2.dataset.NetcdfDataset.setValues(Variable, List<String>) use Variable.setValues()
ucar.nc2.ft.StationTimeSeriesFeature.subset(DateRange) use subset(CalendarDateRange dateRange)
thredds.catalog.InvCatalogImpl.subset(InvDataset) in favor of thredds.catalog.util.DeepCopyUtils.subsetCatalogOnDataset
ucar.nc2.ft.PointFeatureCollection.subset(LatLonRect, DateRange) use CalendarDateRange
ucar.ma2.Range.toArray(List) use Section.getRanges()
ucar.nc2.time.CalendarDateRange.toDateRange()
ucar.nc2.units.DateFormatter.toDateString(Date) use toDateOnlyString
ucar.ma2.Range.toList(Range[]) use Section.getRanges()
ucar.ma2.Range.toString(List) use Section.toString()
thredds.catalog.InvDatasetImpl.writeHtmlDescription(StringBuilder, InvDatasetImpl, boolean, boolean, boolean, boolean) Instead use InvDatasetImpl.writeHtmlDescription(StringBuilder buff, InvDatasetImpl ds, boolean complete, boolean isServer, boolean datasetEvents, boolean catrefEvents, boolean resolveRelativeUrls)
ucar.nc2.FileWriter.writeToFile(NetcdfFile, String, boolean, int)
ucar.nc2.FileWriter.writeToFile(NetcdfFile, String, boolean, int, boolean)

Deprecated Constructors

Constructor and Description
opendap.dap.Attribute(AttributeTable) Use the ctor with the name.
opendap.dap.AttributeTable() Use constructor that takes the name of the table.
ucar.nc2.NetcdfFile(String) use NetcdfFile.open( location) or NetcdfDataset.openFile( location)
ucar.nc2.NetcdfFile(URL) use NetcdfFile.open( http:location) or NetcdfDataset.openFile( http:location)
ucar.nc2.NetcdfFileWriteable() use createNew(String filename, boolean fill)
ucar.nc2.NetcdfFileWriteable(String) use openExisting(String filename, boolean fill)
ucar.nc2.NetcdfFileWriteable(String, boolean) use createNew(String filename, boolean fill)