visad.data.text
Class TextAdapter

java.lang.Object
  extended by visad.data.text.TextAdapter

public class TextAdapter
extends java.lang.Object

this is an VisAD file adapter for comma-, tab- and blank-separated ASCII text file data. It will attempt to create a FlatField from the data and descriptions given in the file and/or the constructor. The text files contained delimited data. The delimiter is determined as follows: if the file has a well-known extension (.csv, .tsv, .bsv) then the delimiter is implied by the extension. In all other cases, the delimiter for the data (and for the "column labels") is determined by reading the first line and looking, in order, for a tab, comma, or blank. Which ever one is found first is taken as the delimiter. Two extra pieces of information are needed: the VisAD "MathType" which is specified as a string (e.g., (x,y)->(temperature)) and may either be the first line of the file or passed in through one of the constructors. The second item are the "column labels" which contain the names of each field in the data. The names of all range components specified in the "MathType" must appear. The names of domain components are optional. The values in this string are separated by the delimiter, as defined above. See visad.data.text.README.text for more details.


Constructor Summary
TextAdapter(java.lang.String filename)
          Create a VisAD FlatField from a local Text (comma-, tab- or blank-separated values) ASCII file
TextAdapter(java.lang.String filename, java.lang.String map, java.lang.String params)
          Create a VisAD FlatField from a local Text (comma-, tab- or blank-separated values) ASCII file
TextAdapter(java.net.URL url)
          Create a VisAD FlatField from a remote Text (comma-, tab- or blank-separated values) ASCII file
TextAdapter(java.net.URL url, java.lang.String map, java.lang.String params)
          Create a VisAD FlatField from a local Text (comma-, tab- or blank-separated values) ASCII file
 
Method Summary
 Field getData()
          get the data
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

TextAdapter

public TextAdapter(java.lang.String filename)
            throws java.io.IOException,
                   VisADException
Create a VisAD FlatField from a local Text (comma-, tab- or blank-separated values) ASCII file

Parameters:
filename - name of local file.
Throws:
java.io.IOException - if there was a problem reading the file.
VisADException - if an unexpected problem occurs.

TextAdapter

public TextAdapter(java.lang.String filename,
                   java.lang.String map,
                   java.lang.String params)
            throws java.io.IOException,
                   VisADException
Create a VisAD FlatField from a local Text (comma-, tab- or blank-separated values) ASCII file

Parameters:
filename - name of local file.
map - the VisAD "MathType" as a string defining the FlatField
params - the list of parameters used to define what columns of the text file correspond to what MathType parameters.
Throws:
java.io.IOException - if there was a problem reading the file.
VisADException - if an unexpected problem occurs.

TextAdapter

public TextAdapter(java.net.URL url)
            throws java.io.IOException,
                   VisADException
Create a VisAD FlatField from a remote Text (comma-, tab- or blank-separated values) ASCII file

Parameters:
url - File URL.
Throws:
java.io.IOException - if there was a problem reading the file.
VisADException - if an unexpected problem occurs.

TextAdapter

public TextAdapter(java.net.URL url,
                   java.lang.String map,
                   java.lang.String params)
            throws java.io.IOException,
                   VisADException
Create a VisAD FlatField from a local Text (comma-, tab- or blank-separated values) ASCII file

Parameters:
url - File URL.
map - the VisAD "MathType" as a string defining the FlatField
params - the list of parameters used to define what columns of the text file correspond to what MathType parameters.
Throws:
java.io.IOException - if there was a problem reading the file.
VisADException - if an unexpected problem occurs.
Method Detail

getData

public Field getData()
get the data

Returns:
a Field of the data read from the file Changed by jk