ucar.nc2.grib.collection

Class GribCdmIndex

java.lang.Object

ucar.nc2.grib.collection.GribCdmIndex

All Implemented Interfaces:

thredds.inventory.partition.IndexReader

public class GribCdmIndex
extends java.lang.Object
implements thredds.inventory.partition.IndexReader

Utilities for creating GRIB CDM index (ncx3) files, both collections and partitions

Since:

12/5/13

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GribCdmIndex.GribCollectionType

Nested classes/interfaces inherited from interface thredds.inventory.partition.IndexReader

thredds.inventory.partition.IndexReader.AddChildCallback

Field Summary

Fields

Modifier and Type	Field and Description
static ucar.nc2.util.cache.FileCacheIF	gribCollectionCache

Constructor Summary

Constructors

Constructor and Description
GribCdmIndex(org.slf4j.Logger logger)

Method Summary

Modifier and Type	Method and Description
static GribCollectionImmutable	acquireGribCollection(ucar.nc2.util.cache.FileFactory factory, java.lang.Object hashKey, java.lang.String location, int buffer_size, ucar.nc2.util.CancelTask cancelTask, java.lang.Object spiObject)
static void	disableGribCollectionCache()
static GribCdmIndex.GribCollectionType	getType(ucar.unidata.io.RandomAccessFile raf) Find out what kind of index this is
static void	initDefaultCollectionCache(int minElementsInMemory, int maxElementsInMemory, int period)
boolean	isPartition(java.nio.file.Path indexFile)
static void	main(java.lang.String[] args)
static void	main2(java.lang.String[] args)
static void	main3(java.lang.String[] args)
static boolean	makeIndex(thredds.featurecollection.FeatureCollectionConfig config, java.util.Formatter errlog, java.nio.file.Path topPath)
static boolean	moveCdmIndex(java.lang.String indexFilename, org.slf4j.Logger logger)
static GribCollectionImmutable	openCdmIndex(java.lang.String indexFilename, thredds.featurecollection.FeatureCollectionConfig config, boolean useCache, org.slf4j.Logger logger)
static GribCollectionImmutable	openCdmIndex(java.lang.String indexFilename, thredds.featurecollection.FeatureCollectionConfig config, org.slf4j.Logger logger)
static GribCollectionImmutable	openGribCollection(thredds.featurecollection.FeatureCollectionConfig config, thredds.inventory.CollectionUpdateType updateType, org.slf4j.Logger logger) Open GribCollection from config.
static GribCollectionImmutable	openGribCollectionFromDataFile(boolean isGrib1, thredds.inventory.MFile mfile, thredds.inventory.CollectionUpdateType updateType, thredds.featurecollection.FeatureCollectionConfig config, java.util.Formatter errlog, org.slf4j.Logger logger)
static GribCollectionImmutable	openGribCollectionFromIndexFile(ucar.unidata.io.RandomAccessFile indexRaf, thredds.featurecollection.FeatureCollectionConfig config, org.slf4j.Logger logger) Create a grib collection / partition collection from an existing ncx2 file.
static GribCollectionImmutable	openGribCollectionFromRaf(ucar.unidata.io.RandomAccessFile raf, thredds.featurecollection.FeatureCollectionConfig config, thredds.inventory.CollectionUpdateType updateType, org.slf4j.Logger logger)
static GribCollectionMutable	openMutableGCFromIndex(java.lang.String indexFilename, thredds.featurecollection.FeatureCollectionConfig config, boolean dataOnly, boolean useCache, org.slf4j.Logger logger)
boolean	readChildren(java.nio.file.Path indexFile, thredds.inventory.partition.IndexReader.AddChildCallback callback)
boolean	readMFiles(java.nio.file.Path indexFile, java.util.List<thredds.inventory.MFile> result)
static void	setGribCollectionCache(ucar.nc2.util.cache.FileCacheIF cache)
static void	shutdown()
static boolean	updateGribCollection(thredds.featurecollection.FeatureCollectionConfig config, thredds.inventory.CollectionUpdateType updateType, org.slf4j.Logger logger) update Grib Collection if needed
static boolean	updateGribCollectionFromPCollection(boolean isGrib1, thredds.inventory.partition.PartitionManager dcm, thredds.inventory.CollectionUpdateType updateType, java.util.Formatter errlog, org.slf4j.Logger logger)

Methods inherited from class java.lang.Object

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

Field Detail

gribCollectionCache

public static ucar.nc2.util.cache.FileCacheIF gribCollectionCache

Constructor Detail

GribCdmIndex

public GribCdmIndex(org.slf4j.Logger logger)

Method Detail

initDefaultCollectionCache

public static void initDefaultCollectionCache(int minElementsInMemory,
                                              int maxElementsInMemory,
                                              int period)

disableGribCollectionCache

public static void disableGribCollectionCache()

setGribCollectionCache

public static void setGribCollectionCache(ucar.nc2.util.cache.FileCacheIF cache)

acquireGribCollection

public static GribCollectionImmutable acquireGribCollection(ucar.nc2.util.cache.FileFactory factory,
                                                            java.lang.Object hashKey,
                                                            java.lang.String location,
                                                            int buffer_size,
                                                            ucar.nc2.util.CancelTask cancelTask,
                                                            java.lang.Object spiObject)
                                                     throws java.io.IOException

Throws:

java.io.IOException

shutdown

public static void shutdown()

getType

public static GribCdmIndex.GribCollectionType getType(ucar.unidata.io.RandomAccessFile raf)
                                               throws java.io.IOException

Find out what kind of index this is

Parameters:

raf - open RAF

Returns:

GribCollectionType

Throws:

java.io.IOException - on read error

openCdmIndex

public static GribCollectionImmutable openCdmIndex(java.lang.String indexFilename,
                                                   thredds.featurecollection.FeatureCollectionConfig config,
                                                   org.slf4j.Logger logger)

openCdmIndex

public static GribCollectionImmutable openCdmIndex(java.lang.String indexFilename,
                                                   thredds.featurecollection.FeatureCollectionConfig config,
                                                   boolean useCache,
                                                   org.slf4j.Logger logger)

openMutableGCFromIndex

public static GribCollectionMutable openMutableGCFromIndex(java.lang.String indexFilename,
                                                           thredds.featurecollection.FeatureCollectionConfig config,
                                                           boolean dataOnly,
                                                           boolean useCache,
                                                           org.slf4j.Logger logger)

updateGribCollectionFromPCollection

public static boolean updateGribCollectionFromPCollection(boolean isGrib1,
                                                          thredds.inventory.partition.PartitionManager dcm,
                                                          thredds.inventory.CollectionUpdateType updateType,
                                                          java.util.Formatter errlog,
                                                          org.slf4j.Logger logger)
                                                   throws java.io.IOException

Throws:

java.io.IOException

updateGribCollection

public static boolean updateGribCollection(thredds.featurecollection.FeatureCollectionConfig config,
                                           thredds.inventory.CollectionUpdateType updateType,
                                           org.slf4j.Logger logger)
                                    throws java.io.IOException

update Grib Collection if needed

Returns:

true if the collection was updated

Throws:

java.io.IOException

makeIndex

public static boolean makeIndex(thredds.featurecollection.FeatureCollectionConfig config,
                                java.util.Formatter errlog,
                                java.nio.file.Path topPath)
                         throws java.io.IOException

Throws:

java.io.IOException

moveCdmIndex

public static boolean moveCdmIndex(java.lang.String indexFilename,
                                   org.slf4j.Logger logger)
                            throws java.io.IOException

Throws:

java.io.IOException

openGribCollection

public static GribCollectionImmutable openGribCollection(thredds.featurecollection.FeatureCollectionConfig config,
                                                         thredds.inventory.CollectionUpdateType updateType,
                                                         org.slf4j.Logger logger)
                                                  throws java.io.IOException

Open GribCollection from config. CollectionUpdater calls InvDatasetFc.update() calls InvDatasetFcGrib.updateCollection()

Throws:

java.io.IOException

openGribCollectionFromRaf

public static GribCollectionImmutable openGribCollectionFromRaf(ucar.unidata.io.RandomAccessFile raf,
                                                                thredds.featurecollection.FeatureCollectionConfig config,
                                                                thredds.inventory.CollectionUpdateType updateType,
                                                                org.slf4j.Logger logger)
                                                         throws java.io.IOException

Throws:

java.io.IOException

openGribCollectionFromDataFile

public static GribCollectionImmutable openGribCollectionFromDataFile(boolean isGrib1,
                                                                     thredds.inventory.MFile mfile,
                                                                     thredds.inventory.CollectionUpdateType updateType,
                                                                     thredds.featurecollection.FeatureCollectionConfig config,
                                                                     java.util.Formatter errlog,
                                                                     org.slf4j.Logger logger)
                                                              throws java.io.IOException

Throws:

java.io.IOException

openGribCollectionFromIndexFile

public static GribCollectionImmutable openGribCollectionFromIndexFile(ucar.unidata.io.RandomAccessFile indexRaf,
                                                                      thredds.featurecollection.FeatureCollectionConfig config,
                                                                      org.slf4j.Logger logger)
                                                               throws java.io.IOException

Create a grib collection / partition collection from an existing ncx2 file. PartionCollection.partition.getGribCollection().

Parameters:

indexRaf - the ncx2 file already open

config - special configuration

Returns:

the resulting GribCollection, or null on failure

Throws:

java.io.IOException - on io error

readChildren

public boolean readChildren(java.nio.file.Path indexFile,
                            thredds.inventory.partition.IndexReader.AddChildCallback callback)
                     throws java.io.IOException

Specified by:

readChildren in interface thredds.inventory.partition.IndexReader

Throws:

java.io.IOException

isPartition

public boolean isPartition(java.nio.file.Path indexFile)
                    throws java.io.IOException

Specified by:

isPartition in interface thredds.inventory.partition.IndexReader

Throws:

java.io.IOException

readMFiles

public boolean readMFiles(java.nio.file.Path indexFile,
                          java.util.List<thredds.inventory.MFile> result)
                   throws java.io.IOException

Specified by:

readMFiles in interface thredds.inventory.partition.IndexReader

Throws:

java.io.IOException

main2

public static void main2(java.lang.String[] args)
                  throws java.io.IOException

Throws:

java.io.IOException

main3

public static void main3(java.lang.String[] args)
                  throws java.io.IOException

Throws:

java.io.IOException

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

Throws:

java.lang.Exception