ucar.nc2.grib.collection

Class GribCdmIndex

java.lang.Object

ucar.nc2.grib.collection.GribCdmIndex

All Implemented Interfaces:

IndexReader

public class GribCdmIndex
extends java.lang.Object
implements IndexReader

Utilities for creating GRIB CDM index (ncx) files, both collections and partitions. Can be used as a standalone program. TODO review - is this working?

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

IndexReader.AddChildCallback

Field Summary

Fields

Modifier and Type	Field and Description
static FileCacheIF	gribCollectionCache
static java.lang.String	NCX_SUFFIX

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
static void	disableGribCollectionCache()
static java.io.File	getTopIndexFileFromConfig(FeatureCollectionConfig config)
static GribCdmIndex.GribCollectionType	getType(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) Open an ncx file and find out what type it is
static void	main(java.lang.String[] args)
static boolean	makeIndex(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, FeatureCollectionConfig config, boolean useCache, org.slf4j.Logger logger)
static GribCollectionImmutable	openGribCollection(FeatureCollectionConfig config, CollectionUpdateType updateType, org.slf4j.Logger logger) Open GribCollection from config.
static GribCollectionImmutable	openGribCollectionFromDataFile(boolean isGrib1, MFile mfile, CollectionUpdateType updateType, FeatureCollectionConfig config, java.util.Formatter errlog, org.slf4j.Logger logger)
static GribCollectionImmutable	openGribCollectionFromIndexFile(RandomAccessFile indexRaf, FeatureCollectionConfig config, org.slf4j.Logger logger) Create a grib collection / partition collection from an existing ncx2 file.
static GribCollectionImmutable	openGribCollectionFromRaf(RandomAccessFile raf, FeatureCollectionConfig config, CollectionUpdateType updateType, org.slf4j.Logger logger)
static GribCollectionMutable	openMutableGCFromIndex(java.lang.String indexFilename, FeatureCollectionConfig config, boolean dataOnly, boolean useCache, org.slf4j.Logger logger)
boolean	readChildren(java.nio.file.Path indexFile, IndexReader.AddChildCallback callback) Open a Partition ncx file and read children indexes
boolean	readMFiles(java.nio.file.Path indexFile, java.util.List<MFile> result) Read the MFiles from a GribCollection index file
static void	setGribCollectionCache(FileCacheIF cache)
static void	shutdown()
static boolean	updateGribCollection(boolean isGrib1, MCollection dcm, CollectionUpdateType updateType, FeatureCollectionConfig.PartitionType ptype, org.slf4j.Logger logger, java.util.Formatter errlog)
static boolean	updateGribCollection(FeatureCollectionConfig config, CollectionUpdateType updateType, org.slf4j.Logger logger) Update Grib Collection if needed
static boolean	updateGribCollectionFromPCollection(boolean isGrib1, PartitionManager dcm, 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

NCX_SUFFIX

public static final java.lang.String NCX_SUFFIX

See Also:

Constant Field Values

gribCollectionCache

public static 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(FileCacheIF cache)

shutdown

public static void shutdown()

getTopIndexFileFromConfig

public static java.io.File getTopIndexFileFromConfig(FeatureCollectionConfig config)

getType

public static GribCdmIndex.GribCollectionType getType(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

@Nullable
public static GribCollectionImmutable openCdmIndex(java.lang.String indexFilename,
                                                             FeatureCollectionConfig config,
                                                             boolean useCache,
                                                             org.slf4j.Logger logger)
                                                      throws java.io.IOException

Throws:

java.io.IOException

openMutableGCFromIndex

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

updateGribCollectionFromPCollection

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

Throws:

java.io.IOException

updateGribCollection

public static boolean updateGribCollection(FeatureCollectionConfig config,
                                           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

updateGribCollection

public static boolean updateGribCollection(boolean isGrib1,
                                           MCollection dcm,
                                           CollectionUpdateType updateType,
                                           FeatureCollectionConfig.PartitionType ptype,
                                           org.slf4j.Logger logger,
                                           java.util.Formatter errlog)
                                    throws java.io.IOException

Throws:

java.io.IOException

makeIndex

public static boolean makeIndex(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(FeatureCollectionConfig config,
                                                         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(RandomAccessFile raf,
                                                                FeatureCollectionConfig config,
                                                                CollectionUpdateType updateType,
                                                                org.slf4j.Logger logger)
                                                         throws java.io.IOException

Throws:

java.io.IOException

openGribCollectionFromDataFile

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

Throws:

java.io.IOException

openGribCollectionFromIndexFile

@Nullable
public static GribCollectionImmutable openGribCollectionFromIndexFile(RandomAccessFile indexRaf,
                                                                                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,
                            IndexReader.AddChildCallback callback)
                     throws java.io.IOException

Description copied from interface: IndexReader

Open a Partition ncx file and read children indexes

Specified by:

readChildren in interface IndexReader

Parameters:

indexFile - the Partition ncx index file to open

callback - for each child index, call this back

Returns:

true if indexFile is a partition collection

Throws:

java.io.IOException - on bad things

isPartition

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

Description copied from interface: IndexReader

Open an ncx file and find out what type it is

Specified by:

isPartition in interface IndexReader

Parameters:

indexFile - the ncx index file to open

Returns:

true if its a partition type index

Throws:

java.io.IOException - on bad

readMFiles

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

Description copied from interface: IndexReader

Read the MFiles from a GribCollection index file

Specified by:

readMFiles in interface IndexReader

Parameters:

indexFile - the Partition ncx index file to open

result - put results in this list

Returns:

true if indexFile is a GribCollection collection, and read ok

Throws:

java.io.IOException

main

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

Throws:

java.lang.Exception