ucar.nc2.internal.ncml

Class NcMLReaderNew

java.lang.Object

ucar.nc2.internal.ncml.NcMLReaderNew

public class NcMLReaderNew
extends Object

Read NcML and create NetcdfDataset, using builders and immutable objects.

See Also:

http://www.unidata.ucar.edu/software/netcdf/ncml/

Constructor Summary

Constructors

Constructor and Description
NcMLReaderNew()

Method Summary

Modifier and Type	Method and Description
static NetcdfDataset.Builder	mergeNcML(NetcdfFile ref, org.jdom2.Element ncmlElem) Use NCML to modify the referenced dataset, create a new dataset with the merged info Used to wrap each dataset of an aggregation before its aggregated
static Set<NetcdfDataset.Enhance>	parseEnhanceMode(String enhanceMode) Retrieve the set of Enhancements that is associated with the given NcML string.
static NetcdfDataset.Builder	readNcML(String ncmlLocation, String referencedDatasetUri, CancelTask cancelTask) Read an NcML file from a URL location, and construct a NetcdfDataset.
static void	setDebugFlags(DebugFlags debugFlag)
static void	wrapNcML(NetcdfDataset.Builder ncDataset, String ncmlLocation, CancelTask cancelTask) Use NCML to modify the dataset, getting NcML from a URL.
static void	wrapNcMLresource(NetcdfDataset.Builder ncDataset, String ncmlResourceLocation, CancelTask cancelTask) Use NCML to modify a dataset, getting the NcML document as a resource stream.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NcMLReaderNew

public NcMLReaderNew()

Method Detail

setDebugFlags

public static void setDebugFlags(DebugFlags debugFlag)

parseEnhanceMode

public static Set<NetcdfDataset.Enhance> parseEnhanceMode(String enhanceMode)

Retrieve the set of Enhancements that is associated with the given NcML string.

String	Enhancements
All	ConvertEnums, ConvertUnsigned, ApplyScaleOffset, ConvertMissing, CoordSystems
None	<empty>
ConvertEnums	ConvertEnums
ConvertUnsigned	ConvertUnsigned
ApplyScaleOffset	ApplyScaleOffset
ConvertMissing	ConvertMissing
CoordSystems	CoordSystems
IncompleteCoordSystems	CoordSystems
true	Alias for "All"
ScaleMissingDefer	Alias for "None"
AllDefer	ConvertEnums, CoordSystems
ScaleMissing	ConvertUnsigned, ApplyScaleOffset, ConvertMissing

Parameters:

enhanceMode - a string from the above table.

Returns:

the set corresponding to enhanceMode, or null if there is no correspondence.

wrapNcML

public static void wrapNcML(NetcdfDataset.Builder ncDataset,
                            String ncmlLocation,
                            CancelTask cancelTask)
                     throws IOException

Use NCML to modify the dataset, getting NcML from a URL. Used by CoordSysFactory.

Parameters:

ncDataset - modify this dataset

ncmlLocation - URL location of NcML

cancelTask - allow user to cancel task; may be null

Throws:

IOException - on read error

wrapNcMLresource

public static void wrapNcMLresource(NetcdfDataset.Builder ncDataset,
                                    String ncmlResourceLocation,
                                    CancelTask cancelTask)
                             throws IOException

Use NCML to modify a dataset, getting the NcML document as a resource stream. Uses ClassLoader.getResourceAsStream(ncmlResourceLocation), so the NcML can be inside of a jar file, for example.

Parameters:

ncDataset - modify this dataset

ncmlResourceLocation - resource location of NcML

cancelTask - allow user to cancel task; may be null

Throws:

IOException - on read error

mergeNcML

public static NetcdfDataset.Builder mergeNcML(NetcdfFile ref,
                                              @Nullable
                                              org.jdom2.Element ncmlElem)
                                       throws IOException

Use NCML to modify the referenced dataset, create a new dataset with the merged info Used to wrap each dataset of an aggregation before its aggregated

Parameters:

ref - referenced dataset

ncmlElem - parent element - usually the aggregation element of the ncml

Returns:

new dataset with the merged info

Throws:

IOException - on read error

readNcML

public static NetcdfDataset.Builder readNcML(String ncmlLocation,
                                             String referencedDatasetUri,
                                             CancelTask cancelTask)
                                      throws IOException

Read an NcML file from a URL location, and construct a NetcdfDataset.

Parameters:

ncmlLocation - the URL location string of the NcML document

referencedDatasetUri - if null (usual case) get this from NcML, otherwise use URI as the location of the referenced dataset.

cancelTask - allow user to cancel the task; may be null

Returns:

the resulting NetcdfDataset

Throws:

IOException - on read error, or bad referencedDatasetUri URI