Package ucar.nc2.iosp.grid

Class GridServiceProvider

java.lang.Object

ucar.nc2.iosp.AbstractIOServiceProvider

ucar.nc2.iosp.grid.GridServiceProvider

All Implemented Interfaces:

ucar.nc2.iosp.IOServiceProvider

Direct Known Subclasses:

GempakGridServiceProvider, McIDASGridServiceProvider

public abstract class GridServiceProvider
extends ucar.nc2.iosp.AbstractIOServiceProvider

Superclass for Gempak grid, MciDAS grid

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	GridServiceProvider.IndexExtendMode

Field Summary

Fields

Modifier and Type	Field	Description
protected static boolean	addLatLon
protected static boolean	alwaysInCache
static boolean	debugMissing	debug flags
static boolean	debugMissingDetails	debug flags
static boolean	debugOpen	debug flags
static boolean	debugProj	debug flags
static boolean	debugTiming	debug flags
static boolean	debugVert	debug flags
protected static boolean	forceNewIndex
protected static GridServiceProvider.IndexExtendMode	indexFileModeOnOpen
protected static GridServiceProvider.IndexExtendMode	indexFileModeOnSync

Fields inherited from class ucar.nc2.iosp.AbstractIOServiceProvider

location, ncfile, raf, rafOrder

Constructor Summary

Constructors

Constructor	Description
GridServiceProvider()

Method Summary

Modifier and Type	Method	Description
protected abstract float[]	_readData(GridRecord gr)	Read the data for this GridRecord
static void	forceNewIndex(boolean b)	Set whether to force new index or not
boolean	isMissingXY(ucar.nc2.Variable v2, int timeIdx, int ensIdx, int levIdx)	Is this XY level missing?
protected abstract void	open(GridIndex index, ucar.nc2.util.CancelTask cancelTask)	Use the given index to fill the NetcdfFile object with attributes and variables.
void	open(ucar.unidata.io.RandomAccessFile raf, ucar.nc2.NetcdfFile ncfile, ucar.nc2.util.CancelTask cancelTask)	Open the service provider for reading.
ucar.ma2.Array	readData(ucar.nc2.Variable v2, ucar.ma2.Section section)	Read the data for the variable
static void	setDebugFlags(ucar.nc2.util.DebugFlags debugFlag)	Set the debug flags
static void	setExtendIndex(boolean b)	Deprecated. use setIndexFileModeOnSync and setIndexFileModeOnOpen
static void	setIndexAlwaysInCache(boolean b)	Set disk cache policy for index files.
static void	setIndexFileModeOnOpen(GridServiceProvider.IndexExtendMode mode)	This controls what happens when a GRIB file is opened, and the data file has changed since the index was written.
static void	setIndexFileModeOnSync(GridServiceProvider.IndexExtendMode mode)	This controls what happens when a GRIB file is synced (usually from FileCache), and the data or index file has changed since the file was placed in the cache.

Methods inherited from class ucar.nc2.iosp.AbstractIOServiceProvider

build, buildFinish, close, getDetailInfo, getFileTypeVersion, getLastModified, getStructureIterator, isBuilder, reacquire, readSection, readToByteChannel, readToOutputStream, release, sendIospMessage, setNetcdfFile, streamToByteChannel, syncExtend, toStringDebug

Methods inherited from class java.lang.Object

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

Methods inherited from interface ucar.nc2.iosp.IOServiceProvider

getFileTypeDescription, getFileTypeId, isValidFile

Field Detail

indexFileModeOnOpen

protected static GridServiceProvider.IndexExtendMode indexFileModeOnOpen

indexFileModeOnSync

protected static GridServiceProvider.IndexExtendMode indexFileModeOnSync

addLatLon

protected static boolean addLatLon

forceNewIndex

protected static boolean forceNewIndex

alwaysInCache

protected static boolean alwaysInCache

debugOpen

public static boolean debugOpen

debug flags

debugMissing

public static boolean debugMissing

debug flags

debugMissingDetails

public static boolean debugMissingDetails

debug flags

debugProj

public static boolean debugProj

debug flags

debugTiming

public static boolean debugTiming

debug flags

debugVert

public static boolean debugVert

debug flags

Constructor Detail

GridServiceProvider

public GridServiceProvider()

Method Detail

forceNewIndex

public static void forceNewIndex(boolean b)

Set whether to force new index or not

Parameters:

b - true to use

setDebugFlags

public static void setDebugFlags(ucar.nc2.util.DebugFlags debugFlag)

Set the debug flags

Parameters:

debugFlag - debug flags

setIndexFileModeOnOpen

public static void setIndexFileModeOnOpen(GridServiceProvider.IndexExtendMode mode)

This controls what happens when a GRIB file is opened, and the data file has changed since the index was written.

1. IndexExtendMode.extendwrite: when GRIB file length increases, extend the index. This is the case when the file is being appended to, as new data arrives.
2. IndexExtendMode.rewrite: when GRIB file length changes, rewrite the index. This is the safest thing to do, at the expense of performance.
3. IndexExtendMode.readonly: never modify an existing index, just use it. However, if there is no index, created one

Parameters:

mode - IndexExtendMode when file is opened

setIndexFileModeOnSync

public static void setIndexFileModeOnSync(GridServiceProvider.IndexExtendMode mode)

This controls what happens when a GRIB file is synced (usually from FileCache), and the data or index file has changed since the file was placed in the cache.

1. IndexExtendMode.extendwrite: when GRIB file or index length increases, extend the index. If file or index length decreases, rewrite it.
2. IndexExtendMode.rewrite: when GRIB file length changes, rewrite the index.
3. IndexExtendMode.readonly: never modify an existing index, just use it. However, if there is no index, created one

Parameters:

mode - IndexExtendMode when file is opened

setExtendIndex

public static void setExtendIndex(boolean b)

Deprecated.

use setIndexFileModeOnSync and setIndexFileModeOnOpen

Set how indexes are used for both open and sync

Parameters:

b - if true, set modes to IndexExtendMode.extendwrite, else IndexExtendMode.readonly

setIndexAlwaysInCache

public static void setIndexAlwaysInCache(boolean b)

Set disk cache policy for index files. Default = false, meaning try to write index files in same directory as grib file. True means always use the DiskCache area. TDS sets this to true, so it wont interfere with external indexer.

Parameters:

b - set to this value

open

protected abstract void open(GridIndex index,
                             ucar.nc2.util.CancelTask cancelTask)
                      throws IOException

Use the given index to fill the NetcdfFile object with attributes and variables.

Parameters:

index - GridIndex to use

cancelTask - cancel task

Throws:

IOException - problem reading the file

open

public void open(ucar.unidata.io.RandomAccessFile raf,
                 ucar.nc2.NetcdfFile ncfile,
                 ucar.nc2.util.CancelTask cancelTask)
          throws IOException

Open the service provider for reading.

Specified by:

open in interface ucar.nc2.iosp.IOServiceProvider

Overrides:

open in class ucar.nc2.iosp.AbstractIOServiceProvider

Parameters:

raf - file to read from

ncfile - netCDF file we are writing to (memory)

cancelTask - task for cancelling

Throws:

IOException - problem reading file

readData

public ucar.ma2.Array readData(ucar.nc2.Variable v2,
                               ucar.ma2.Section section)
                        throws IOException,
                               ucar.ma2.InvalidRangeException

Read the data for the variable

Parameters:

v2 - Variable to read

section - section infomation

Returns:

Array of data

Throws:

IOException - problem reading from file

ucar.ma2.InvalidRangeException - invalid Range

isMissingXY

public boolean isMissingXY(ucar.nc2.Variable v2,
                           int timeIdx,
                           int ensIdx,
                           int levIdx)
                    throws ucar.ma2.InvalidRangeException

Is this XY level missing?

Parameters:

v2 - Variable

timeIdx - time index

ensIdx - ensemble index

levIdx - level index

Returns:

true if missing

Throws:

ucar.ma2.InvalidRangeException - invalid range

_readData

protected abstract float[] _readData(GridRecord gr)
                              throws IOException

Read the data for this GridRecord

Parameters:

gr - grid identifier

Returns:

the data (or null)

Throws:

IOException - problem reading the data