ucar.nc2.ft.fmrc

Class Fmrc

java.lang.Object

ucar.nc2.ft.fmrc.Fmrc

@ThreadSafe
public class Fmrc
extends java.lang.Object

Forecast Model Run Collection, manages dynamic collections of GridDatasets. Fmrc represents a virtual dataset. To instantiate, you obtain an FmrcInv "snapshot" from which you can call getDatatset().

Assumes that we dont have multiple runtimes in the same file. Can handle different time steps in different files. Can handle different grids in different files. However this creates problems for the "typical dataset". Cannot handle different ensembles in different files. (LOOK fix) Cannot handle different levels in different files. ok

Since:

Jan 11, 2010

Author:

caron

Constructor Summary

Constructors

Constructor and Description
Fmrc(DatasetCollectionManager manager, FeatureCollectionConfig config)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	checkInvState(long lastInvChange)
void	checkNeeded(boolean force)
boolean	checkProtoState(long lastProtoChanged)
void	close()
GridDataset	getConstantForecastDataset(java.util.Date time)
GridDataset	getConstantOffsetDataset(double hour)
GridDataset	getDataset2D(NetcdfDataset result)
GridDataset	getDatasetBest()
GridDataset	getDatasetBest(FeatureCollectionConfig.BestDataset bd)
DateRange	getDateRangeForOffset(double offset)
DateRange	getDateRangeForRun(java.util.Date run)
FmrcInv	getFmrcInv(java.util.Formatter debug)
java.util.List<java.util.Date>	getForecastDates()
double[]	getForecastOffsets()
CollectionManager	getManager()
java.util.List<java.util.Date>	getRunDates()
GridDataset	getRunTimeDataset(java.util.Date run)
static void	main(java.lang.String[] args)
static Fmrc	open(FeatureCollectionConfig config, java.util.Formatter errlog)
static Fmrc	open(java.lang.String collection, java.util.Formatter errlog) Factory method
void	setNcml(org.jdom.Element outerNcml, org.jdom.Element innerNcml)
void	showDetails(java.util.Formatter out)
void	update()
void	updateProto()

Methods inherited from class java.lang.Object

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

Constructor Detail

Fmrc

public Fmrc(DatasetCollectionManager manager,
    FeatureCollectionConfig config)

Method Detail

open

public static Fmrc open(java.lang.String collection,
        java.util.Formatter errlog)
                 throws java.io.IOException

Factory method

Parameters:

collection - describes the collection. May be one of:

1. collection specification string
2. catalog:catalogURL
3. filename.ncml

collectionSpec date extraction is used to get rundates

errlog - place error messages here

Returns:

Fmrc or null on error

Throws:

java.io.IOException - on read error

See Also:

"http://www.unidata.ucar.edu/software/netcdf-java/reference/collections/CollectionSpecification.html"

open

public static Fmrc open(FeatureCollectionConfig config,
        java.util.Formatter errlog)
                 throws java.io.IOException

Throws:

java.io.IOException

setNcml

public void setNcml(org.jdom.Element outerNcml,
           org.jdom.Element innerNcml)

close

public void close()

getManager

public CollectionManager getManager()

getFmrcInv

public FmrcInv getFmrcInv(java.util.Formatter debug)
                   throws java.io.IOException

Throws:

java.io.IOException

getDateRangeForRun

public DateRange getDateRangeForRun(java.util.Date run)

getDateRangeForOffset

public DateRange getDateRangeForOffset(double offset)

getRunDates

public java.util.List<java.util.Date> getRunDates()
                                           throws java.io.IOException

Throws:

java.io.IOException

getForecastDates

public java.util.List<java.util.Date> getForecastDates()
                                                throws java.io.IOException

Throws:

java.io.IOException

getForecastOffsets

public double[] getForecastOffsets()
                            throws java.io.IOException

Throws:

java.io.IOException

getDataset2D

public GridDataset getDataset2D(NetcdfDataset result)
                         throws java.io.IOException

Throws:

java.io.IOException

getDatasetBest

public GridDataset getDatasetBest()
                           throws java.io.IOException

Throws:

java.io.IOException

getDatasetBest

public GridDataset getDatasetBest(FeatureCollectionConfig.BestDataset bd)
                           throws java.io.IOException

Throws:

java.io.IOException

getRunTimeDataset

public GridDataset getRunTimeDataset(java.util.Date run)
                              throws java.io.IOException

Throws:

java.io.IOException

getConstantForecastDataset

public GridDataset getConstantForecastDataset(java.util.Date time)
                                       throws java.io.IOException

Throws:

java.io.IOException

getConstantOffsetDataset

public GridDataset getConstantOffsetDataset(double hour)
                                     throws java.io.IOException

Throws:

java.io.IOException

updateProto

public void updateProto()

update

public void update()

checkInvState

public boolean checkInvState(long lastInvChange)
                      throws java.io.IOException

Throws:

java.io.IOException

checkProtoState

public boolean checkProtoState(long lastProtoChanged)
                        throws java.io.IOException

Throws:

java.io.IOException

checkNeeded

public void checkNeeded(boolean force)

showDetails

public void showDetails(java.util.Formatter out)
                 throws java.io.IOException

Throws:

java.io.IOException

main

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

Throws:

java.io.IOException