net.agmodel.weatherData
Interface StationDataSet

All Superinterfaces:

DataSet, Serializable, ServerResult

All Known Implementing Classes:

StationDataSetImpl

public interface StationDataSet

extends DataSet

Interface to classes encapsulating a set of met data from a single station for a given period, resolution

Method Summary

String	getDSSAT(File outputDirectory, String instituteCode, String siteCode, TimeZone tz, String needDailyData, String noData) Writes the data into DSSAT v3.5 format weather data files.
String	getICASA(String instituteCode, String siteCode, TimeZone tz, String needDailyData, String noData) Gets a string containing ICASA format data.
String	getMetSourceID() Gets the identifier of the metsource that the data came from.
MetSequence	getSequence(MetElement element) Gets the data, if it exists, for a particular weather element.
Duration	getServerProcessingTime() Get the elapsed time taken by MetBroker and various databases to handle the request.\ This lumps together MetBroker's processing time (usually minimal), query processing on data sources (variable) and transmission time of data from the data source to MetBroker (often the slowest step).
WeatherStation	getWeatherStation() Get the details of the weather station that the data comes from

Methods inherited from interface net.agmodel.physical.DataSet

dumpDuration, getInterval, getNumberOfRows, getNumberOfSequences, getResolution, getSequence

Method Detail

getSequence

public MetSequence getSequence(MetElement element)

Gets the data, if it exists, for a particular weather element.

Parameters:

element - the weather element of interest.

Returns:

an implementation of Sequence, or null if not data exists for that element.

getWeatherStation

public WeatherStation getWeatherStation()

Get the details of the weather station that the data comes from

Returns:

the location and period of operation of the station.

getMetSourceID

public String getMetSourceID()

Gets the identifier of the metsource that the data came from.

Returns:

the met source identifier

getICASA

public String getICASA(String instituteCode,
                       String siteCode,
                       TimeZone tz,
                       String needDailyData,
                       String noData)

Gets a string containing ICASA format data.

Parameters:

instituteCode - a two letter institute code

siteCode - a two letter site code, allocated by the institute to the site

tz - the timezone for the output dates and times

needDailyData - a string explaining that daily data is needed

noData - a string to display if no data is available

Returns:

an ICASA format string, ready to be put into a file.

See Also:

ICASA standards

getDSSAT

public String getDSSAT(File outputDirectory,
                       String instituteCode,
                       String siteCode,
                       TimeZone tz,
                       String needDailyData,
                       String noData)
                throws IOException

Writes the data into DSSAT v3.5 format weather data files.

Parameters:

outputDirectory - the directory in which to write output files

instituteCode - a two letter institute code

siteCode - a two letter site code, allocated by the institute to the site

tz - the timezone for the output dates and times

needDailyData - a string explaining that daily data is needed

noData - a string to display if no data is available

Returns:

a null string if successful, or an error message.

IOException

See Also:

ICASA standards

getServerProcessingTime

public Duration getServerProcessingTime()

Get the elapsed time taken by MetBroker and various databases to handle the request.\ This lumps together MetBroker's processing time (usually minimal), query processing on data sources (variable) and transmission time of data from the data source to MetBroker (often the slowest step).

Returns:

the elapsed time between when MetBroker receives the query and when it begins to return the answer.