@Deprecated public class CoordSysBuilder extends Object implements CoordSysBuilderIF
You can use an NcML file alone (use registerNcML()) if file uses a convention attribute. If not, you must implement a class that implements isMine() to identify your files, and call wrapNcML in the augmentDataset method (see eg ATDRadarConvention class).
Subclasses Info:
// identify which variables are coordinate axes // default: 1) coordinate variables 2) variables with _coordinateAxisType attribute 3) variables listed // in a coordinates attribute on another variable. findCoordinateAxes(ncDataset); // identify which variables are used to describe coordinate system findCoordinateSystems(ncDataset); // identify which variables are used to describe coordinate transforms findCoordinateTransforms(ncDataset); // turn Variables into CoordinateAxis objects makeCoordinateAxes(ncDataset); // make Coordinate Systems for all Coordinate Systems Variables makeCoordinateSystems(ncDataset); // Assign explicit CoordinateSystem objects to variables assignExplicitCoordinateSystems(ncDataset); makeCoordinateSystemsImplicit(ncDataset); if (useMaximalCoordSys) makeCoordinateSystemsMaximal(ncDataset); makeCoordinateTransforms(ncDataset); assignCoordinateTransforms(ncDataset);
Modifier and Type | Class and Description |
---|---|
static interface |
CoordSysBuilder.ConventionNameOk
Deprecated.
Allow plug-ins to determine if it owns a file based on the file's Convention attribute.
|
class |
CoordSysBuilder.VarProcess
Deprecated.
Wrap each variable in the dataset with a VarProcess object.
|
Modifier and Type | Field and Description |
---|---|
static String |
resourcesDir
Deprecated.
|
Constructor and Description |
---|
CoordSysBuilder()
Deprecated.
|
Modifier and Type | Method and Description |
---|---|
void |
addUserAdvice(String advice)
Deprecated.
Give advice for a user trying to figure out why things arent working
|
void |
augmentDataset(NetcdfDataset ncDataset,
CancelTask cancelTask)
Deprecated.
Make changes to the dataset that are needed before processing scale/offset in NetcdfDataset.
|
static List<String> |
breakupConventionNames(String convAttValue)
Deprecated.
Breakup list of Convention names in the Convention attribute in CF compliant way.
|
static String |
buildConventionAttribute(String mainConv,
String... convAtts)
Deprecated.
Build a list of Conventions
|
void |
buildCoordinateSystems(NetcdfDataset ncDataset)
Deprecated.
Heres where the work is to identify coordinate axes and coordinate systems.
|
static CoordSysBuilderIF |
factory(NetcdfDataset ds,
CancelTask cancelTask)
Deprecated.
Get a CoordSysBuilder whose job it is to add Coordinate information to a NetcdfDataset.
|
String |
getConventionUsed()
Deprecated.
Get the name of the Convention.
|
String |
getParseInfo()
Deprecated.
Detailed information when the coordinate systems were parsed
|
static boolean |
getUseMaximalCoordSys()
Deprecated.
Get whether to make records into Structures.
|
String |
getUserAdvice()
Deprecated.
Specific advice to a user about problems with the coordinate information in the file.
|
static void |
registerConvention(String conventionName,
Class c)
Deprecated.
Register a class that implements a Convention.
|
static void |
registerConvention(String conventionName,
Class c,
CoordSysBuilder.ConventionNameOk match)
Deprecated.
Register a class that implements a Convention.
|
static void |
registerConvention(String conventionName,
String className)
Deprecated.
Register a class that implements a Convention.
|
static void |
registerNcML(String conventionName,
String ncmlLocation)
Deprecated.
Register an NcML file that implements a Convention by wrappping the dataset in the NcML.
|
void |
setConventionUsed(String convName)
Deprecated.
Pass in the name of the Convention used to locate this CoordSysBuilderIF.
|
static void |
setUseMaximalCoordSys(boolean b)
Deprecated.
If true, assign implicit CoordinateSystem objects to variables that dont have one yet.
|
public static final String resourcesDir
public static void registerNcML(String conventionName, String ncmlLocation)
conventionName
- name of Convention, must be in the "Conventions" global attribute.ncmlLocation
- location of NcML file, may be local file or URL.NcMLReader.wrapNcML(ucar.nc2.dataset.NetcdfDataset, java.lang.String, ucar.nc2.util.CancelTask)
public static void registerConvention(String conventionName, Class c)
conventionName
- name of Convention.
This name will be used to look in the "Conventions" global attribute.
Otherwise, you must implement the isMine() static method.c
- implementation of CoordSysBuilderIF that parses those kinds of netcdf files.public static void registerConvention(String conventionName, Class c, CoordSysBuilder.ConventionNameOk match)
conventionName
- name of Convention.
This name will be used to look in the "Conventions" global attribute.
Otherwise, you must implement the isMine() static method.match
- pass in your own matcher. if null, equalsIgnoreCase() will be used.c
- implementation of CoordSysBuilderIF that parses those kinds of netcdf files.public static void registerConvention(String conventionName, String className) throws ClassNotFoundException
conventionName
- name of Convention.
This name will be used to look in the "Conventions" global attribute.
Otherwise, you must implement the isMine() static method.className
- name of class that implements CoordSysBuilderIF.ClassNotFoundException
- if class could not be loadedpublic static void setUseMaximalCoordSys(boolean b)
b
- true if if you want to guess at Coordinate SystemsmakeCoordinateSystemsMaximal(ucar.nc2.dataset.NetcdfDataset)
public static boolean getUseMaximalCoordSys()
public static List<String> breakupConventionNames(String convAttValue)
convAttValue
- original value of Convention attributepublic static String buildConventionAttribute(String mainConv, String... convAtts)
mainConv
- this is the main conventionconvAtts
- list of others, onbly use "extra" Conventions@Nonnull public static CoordSysBuilderIF factory(NetcdfDataset ds, CancelTask cancelTask) throws IOException
ds
- the NetcdfDataset to modifycancelTask
- allow user to bail out.IOException
- on io errorpublic void setConventionUsed(String convName)
CoordSysBuilderIF
setConventionUsed
in interface CoordSysBuilderIF
convName
- the name of the Conventionpublic String getConventionUsed()
CoordSysBuilderIF
getConventionUsed
in interface CoordSysBuilderIF
public void addUserAdvice(String advice)
CoordSysBuilderIF
addUserAdvice
in interface CoordSysBuilderIF
advice
- add this advice to the User Advice Stringpublic String getParseInfo()
CoordSysBuilderIF
getParseInfo
in interface CoordSysBuilderIF
public String getUserAdvice()
CoordSysBuilderIF
getUserAdvice
in interface CoordSysBuilderIF
public void augmentDataset(NetcdfDataset ncDataset, CancelTask cancelTask) throws IOException
CoordSysBuilderIF
augmentDataset
in interface CoordSysBuilderIF
ncDataset
- modify this datasetcancelTask
- give user a chance to bail outIOException
- on errorpublic void buildCoordinateSystems(NetcdfDataset ncDataset)
buildCoordinateSystems
in interface CoordSysBuilderIF
ncDataset
- modify this dataset