public class GridDataset extends Object implements GridDataset, FeatureDataset
GridDataset gridDs = GridDataset.open (uriString); List grids = gridDs.getGrids(); for (int i=0; i<grids.size(); i++) { GeoGrid grid = (Geogrid) grids.get(i); }
Modifier and Type | Class and Description |
---|---|
class |
GridDataset.Gridset
This is a set of GeoGrids with the same GeoCoordSys.
|
Constructor and Description |
---|
GridDataset(NetcdfDataset ds)
Create a GridDataset from a NetcdfDataset.
|
GridDataset(NetcdfDataset ds,
Formatter parseInfo)
Create a GridDataset from a NetcdfDataset.
|
Modifier and Type | Method and Description |
---|---|
void |
calcBounds()
Caclulate date range and bounding box, even if the data has to be scanned.
|
void |
close()
Close all resources associated with this dataset.
|
static GridDataset |
factory(String netcdfFileURI)
Deprecated.
: use GridDataset.open().
|
Attribute |
findGlobalAttributeIgnoreCase(String name)
Return the global attribute with the given name, ignoring case.
|
GeoGrid |
findGridByName(String fullName)
find the named GeoGrid.
|
GeoGrid |
findGridByShortName(String shortName)
find the named GeoGrid.
|
GridDatatype |
findGridDatatype(String name)
find the named GridDatatype.
|
GeoGrid |
findGridDatatypeByAttribute(String attName,
String attValue) |
LatLonRect |
getBoundingBox()
The boundingBox for the entire dataset.
|
CalendarDate |
getCalendarDateEnd()
Ending Calendar date for the entire dataset.
|
CalendarDateRange |
getCalendarDateRange()
Calendar Date range for the entire dataset.
|
CalendarDate |
getCalendarDateStart()
Starting Calendar date for the entire dataset.
|
VariableSimpleIF |
getDataVariable(String shortName)
Get the named data Variable.
|
List<VariableSimpleIF> |
getDataVariables()
The data Variables available in this dataset.
|
DateRange |
getDateRange()
Deprecated.
use getCalendarDateRange
|
String |
getDescription()
Text information about this dataset.
|
String |
getDetailInfo()
Get Details about the dataset.
|
void |
getDetailInfo(Formatter buff)
Show debug / underlying implementation details
|
Date |
getEndDate()
Deprecated.
use getEndCalendarDate
|
FeatureType |
getFeatureType()
Contains collections of this FeatureType.
|
List<Attribute> |
getGlobalAttributes()
List of global attributes.
|
List<GridDatatype> |
getGrids()
get the list of GridDatatype objects contained in this dataset.
|
List<GridDataset.Gridset> |
getGridsets()
Return GridDatatype objects grouped by GridCoordSys.
|
String |
getImplementationName()
Show who is implementing
|
long |
getLastModified()
Get last modified date of underlying file.
|
String |
getLocation()
The URI location of the dataset
|
String |
getLocationURI() |
String |
getName()
the name of the dataset is the last part of the location
|
NetcdfDataset |
getNetcdfDataset() |
NetcdfFile |
getNetcdfFile()
Return underlying NetcdfFile, or null if none.
|
Date |
getStartDate()
Deprecated.
use getStartCalendarDate
|
String |
getTitle()
Title of the dataset.
|
static GridDataset |
open(String location)
Open a netcdf dataset, using NetcdfDataset.defaultEnhanceMode plus CoordSystems
and turn into a GridDataset.
|
static GridDataset |
open(String location,
Set<NetcdfDataset.Enhance> enhanceMode)
Open a netcdf dataset, using NetcdfDataset.defaultEnhanceMode plus CoordSystems
and turn into a GridDataset.
|
void |
setFileCache(FileCache fileCache)
If the FileCache is set, the FileCacheable object must store it and call FileCache.release() on FileCacheable.close():
|
protected FileCache fileCache
public GridDataset(NetcdfDataset ds) throws IOException
ds
- underlying NetcdfDataset, will do Enhance.CoordSystems if not already done.IOException
- on read errorpublic GridDataset(NetcdfDataset ds, Formatter parseInfo) throws IOException
ds
- underlying NetcdfDataset, will do Enhance.CoordSystems if not already done.parseInfo
- put parse info here, may be nullIOException
- on read errorpublic static GridDataset open(String location) throws IOException
location
- netcdf dataset to open, using NetcdfDataset.acquireDataset().IOException
- on read errorNetcdfDataset.acquireDataset(java.lang.String, ucar.nc2.util.CancelTask)
public static GridDataset open(String location, Set<NetcdfDataset.Enhance> enhanceMode) throws IOException
location
- netcdf dataset to open, using NetcdfDataset.acquireDataset().enhanceMode
- open netcdf dataset with this enhanceModeIOException
- on read errorNetcdfDataset.acquireDataset(java.lang.String, ucar.nc2.util.CancelTask)
public String getTitle()
FeatureDataset
getTitle
in interface TypedDataset
getTitle
in interface FeatureDataset
public String getDescription()
FeatureDataset
getDescription
in interface TypedDataset
getDescription
in interface FeatureDataset
public String getLocation()
FeatureDataset
getLocation
in interface FeatureDataset
getLocation
in interface FileCacheable
public String getLocationURI()
getLocationURI
in interface TypedDataset
public DateRange getDateRange()
FeatureDataset
getDateRange
in interface FeatureDataset
public Date getStartDate()
FeatureDataset
getStartDate
in interface TypedDataset
getStartDate
in interface FeatureDataset
public Date getEndDate()
FeatureDataset
getEndDate
in interface TypedDataset
getEndDate
in interface FeatureDataset
public CalendarDateRange getCalendarDateRange()
FeatureDataset
getCalendarDateRange
in interface FeatureDataset
public CalendarDate getCalendarDateStart()
FeatureDataset
getCalendarDateStart
in interface GridDataset
getCalendarDateStart
in interface FeatureDataset
public CalendarDate getCalendarDateEnd()
FeatureDataset
getCalendarDateEnd
in interface GridDataset
getCalendarDateEnd
in interface FeatureDataset
public LatLonRect getBoundingBox()
FeatureDataset
getBoundingBox
in interface TypedDataset
getBoundingBox
in interface FeatureDataset
public void calcBounds() throws IOException
FeatureDataset
calcBounds
in interface FeatureDataset
IOException
- or read error.public List<Attribute> getGlobalAttributes()
TypedDataset
getGlobalAttributes
in interface TypedDataset
getGlobalAttributes
in interface FeatureDataset
public Attribute findGlobalAttributeIgnoreCase(String name)
FeatureDataset
findGlobalAttributeIgnoreCase
in interface TypedDataset
findGlobalAttributeIgnoreCase
in interface FeatureDataset
name
- attribute namepublic List<VariableSimpleIF> getDataVariables()
TypedDataset
getDataVariables
in interface TypedDataset
getDataVariables
in interface FeatureDataset
public VariableSimpleIF getDataVariable(String shortName)
TypedDataset
getDataVariable
in interface TypedDataset
getDataVariable
in interface FeatureDataset
shortName
- of data Variable.public NetcdfFile getNetcdfFile()
FeatureDataset
getNetcdfFile
in interface TypedDataset
getNetcdfFile
in interface FeatureDataset
public String getName()
public NetcdfDataset getNetcdfDataset()
public List<GridDatatype> getGrids()
GridDataset
getGrids
in interface GridDataset
public GridDatatype findGridDatatype(String name)
GridDataset
findGridDatatype
in interface GridDataset
name
- full unescaped namepublic List<GridDataset.Gridset> getGridsets()
getGridsets
in interface GridDataset
public GeoGrid findGridByName(String fullName)
fullName
- find this GeoGrid by full namepublic GeoGrid findGridByShortName(String shortName)
findGridByShortName
in interface GridDataset
shortName
- find this GeoGrid by short namepublic GeoGrid findGridDatatypeByAttribute(String attName, String attValue)
public String getDetailInfo()
getDetailInfo
in interface TypedDataset
public void getDetailInfo(Formatter buff)
FeatureDataset
getDetailInfo
in interface FeatureDataset
buff
- append info herepublic FeatureType getFeatureType()
FeatureDataset
getFeatureType
in interface FeatureDataset
public String getImplementationName()
FeatureDataset
getImplementationName
in interface FeatureDataset
public void close() throws IOException
TypedDataset
close
in interface TypedDataset
close
in interface FeatureDataset
close
in interface FileCacheable
IOException
- on io errorpublic long getLastModified()
FileCacheable
getLastModified
in interface FileCacheable
public void setFileCache(FileCache fileCache)
FileCacheable
public synchronized void close() throws java.io.IOException { if (cache != null) { cache.release(this); } else { reallyClose(); }
setFileCache
in interface FileCacheable
fileCache
- must store this, use it on close as above.public static GridDataset factory(String netcdfFileURI) throws IOException
IOException
Copyright © 1999–2015 UCAR/Unidata. All rights reserved.