Package oms3.io

Class DataIO

java.lang.Object

oms3.io.DataIO

public class DataIO
extends Object

Data Input/Output management.

Author:

Olaf David

Field Summary

Fields

Modifier and Type	Field	Description
static int	ANNUAL_MEAN
static String	CSPROPERTIES_EXT
static String	CSTABLE_EXT
static int	DAILY
static String	DATE_END
static String	DATE_FORMAT
static String	DATE_START
static String	HEADER
static String	HEADER1
static String	KEY_CONVERTED_FROM
static String	KEY_CREATED_AT
static String	KEY_CREATED_BY
static String	KEY_DIGEST
static String	KEY_FC_DAYS
static String	KEY_FC_START
static String	KEY_FORMAT
static String	KEY_HIST_YEAR
static String	KEY_MISSING_VAL
static String	KEY_NAME
static String	KEY_TYPE
static String	KEY_UNIT
static int	MEAN_MONTHLY
static int	MONTHLY_MEAN
static int	PERIOD_MAX
static int	PERIOD_MEAN
static int	PERIOD_MEDIAN
static int	PERIOD_MIN
static int	PERIOD_STANDARD_DEVIATION
static String	PROPERTIES
static String	PROPERTIES1
static String	PROPERTY
static String	PROPERTY1
static String	TABLE
static String	TABLE1
static String	VAL_DATE

Constructor Summary

Constructors

Constructor	Description
DataIO()

Method Summary

Modifier and Type	Method	Description
static CSTable	asTable(CSProperties p, String dim)
static boolean	columnExist(CSTable table, String name)	Check if a column exist in table.
static int	columnIndex(CSTable table, String name)	Gets a column index by name
static int[]	columnIndexes(CSTable table, String name)	Get the column indexes for a given column name.
static List<String>	columnNames(CSTable table, String name)
static TableModel	createTableModel(CSTable src)	Create a r/o data tablemodel
static String	diff(double[] o, double[] p)
static CSTable	extractColumns(CSTable table, String... colNames)	Extract the columns and create another table.
static int	findRowByDate(Date date, int dateColumn, CSTable table)
static TableModel	fromCSP(CSProperties p, int dim)	Returns a r/o table from a CSP file
static CSProperties	fromTable(CSTable t)
static AbstractTableModel	get2DBounded(CSProperties p, String pname)
static AbstractTableModel	getBoundProperties(CSProperties p, String boundName)
static Date[]	getColumnDateValues(CSTable t, String columnName)
static Double[]	getColumnDoubleValues(CSTable t, String columnName)	Get a column as an int array.
static double[]	getColumnDoubleValuesInterval(Date start, Date end, CSTable t, String columnName, int timeStep)
static Date	getDate(CSProperties p, String key)	Get a value as date.
static int	getInt(CSProperties p, String key)	Get a value as integer.
static AbstractTableModel	getProperties(CSProperties p)	Get the KVP as table.
static CSTable	getTable(CSProperties p, String boundName)
static AbstractTableModel	getUnBoundProperties(CSProperties p)
static boolean	isBound(CSProperties p, String key, int dim)
static List<String>	keysByMeta(CSProperties csp, String mkey, String mval)
static List<String>	keysByNotMeta(CSProperties csp, String mkey)
static List<String>	keysForBounds(CSProperties csp, int boundCount)
static SimpleDateFormat	lookupDateFormat(CSTable table, int col)
static void	main(String[] args)
static void	merge(CSProperties base, CSProperties overlay)	Merges two Properties, respects permissions
static boolean	playsRole(CSProperties p, String key, String role)
static void	print(Map<String,Object> props, String header, PrintWriter out)
static void	print(CSProperties props, PrintWriter out)	Print CSProperties.
static void	print(CSTable table, PrintWriter out)	Print a CSTable to a PrintWriter
static CSProperties	properties()	Create Empty properties
static List<String>	properties(File f)	Find all properties section names in a file.
static CSProperties	properties(Reader[] r, String name)	Create a CSProperty from an array of reader.
static CSProperties	properties(Reader r, String name)	Parse properties from a reader
static CSProperties	properties(Map<String,Object> p)	Convert from a Map to properties.
static CSProperties	properties(Properties p)	Convert Properties to CSProperties.
static Properties	properties(CSProperties p)	Convert CSProperties into Properties
static double[]	rowDoubleValues(String[] row, int[] idx)
static double[]	rowDoubleValues(String[] row, int[] idx, double[] vals)
static void	rowStringValues(String[] row, int[] idx, String[] vals)
static void	save(CSProperties csp, File f, String title)
static void	save(CSTable table, File file)	Saves a table to a file.
static int[]	sliceByTime(CSTable table, int timeCol, Date start, Date end)	Get a slice of rows out of the table matching the time window
static CSTable	synthESPInput(CSTable table, Date iniStart, Date iniEnd, int fcDays, int year)
static CSTable	table(File file)	Parse the first table from a file
static CSTable	table(File file, String name)	Parse a table from a given File.
static CSTable	table(String s)	Parse a table from a Reader.
static CSTable	table(String s, String name)	Parse a table from a Reader.
static CSTable	table(URL url)	Opens the first table found at the URL
static CSTable	table(URL url, String name)	Create a CSTable from a URL source.
static List<String>	tables(File f)	Find all table names in a file.
static String	toArrayString(String[] arr)	Create array string.
static String	toArrayString(String[][] arr)

Methods inherited from class java.lang.Object

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

Field Detail

TABLE

public static final String TABLE

See Also:

Constant Field Values

HEADER

public static final String HEADER

See Also:

Constant Field Values

PROPERTIES

public static final String PROPERTIES

See Also:

Constant Field Values

PROPERTY

public static final String PROPERTY

See Also:

Constant Field Values

TABLE1

public static final String TABLE1

See Also:

Constant Field Values

HEADER1

public static final String HEADER1

See Also:

Constant Field Values

PROPERTIES1

public static final String PROPERTIES1

See Also:

Constant Field Values

PROPERTY1

public static final String PROPERTY1

See Also:

Constant Field Values

CSPROPERTIES_EXT

public static final String CSPROPERTIES_EXT

See Also:

Constant Field Values

CSTABLE_EXT

public static final String CSTABLE_EXT

See Also:

Constant Field Values

KEY_CONVERTED_FROM

public static final String KEY_CONVERTED_FROM

See Also:

Constant Field Values

DATE_FORMAT

public static final String DATE_FORMAT

See Also:

Constant Field Values

DATE_START

public static final String DATE_START

See Also:

Constant Field Values

DATE_END

public static final String DATE_END

See Also:

Constant Field Values

KEY_CREATED_AT

public static final String KEY_CREATED_AT

See Also:

Constant Field Values

KEY_CREATED_BY

public static final String KEY_CREATED_BY

See Also:

Constant Field Values

KEY_UNIT

public static final String KEY_UNIT

See Also:

Constant Field Values

KEY_FORMAT

public static final String KEY_FORMAT

See Also:

Constant Field Values

KEY_TYPE

public static final String KEY_TYPE

See Also:

Constant Field Values

KEY_NAME

public static final String KEY_NAME

See Also:

Constant Field Values

KEY_MISSING_VAL

public static final String KEY_MISSING_VAL

See Also:

Constant Field Values

KEY_FC_START

public static final String KEY_FC_START

See Also:

Constant Field Values

KEY_FC_DAYS

public static final String KEY_FC_DAYS

See Also:

Constant Field Values

KEY_HIST_YEAR

public static final String KEY_HIST_YEAR

See Also:

Constant Field Values

KEY_DIGEST

public static final String KEY_DIGEST

See Also:

Constant Field Values

VAL_DATE

public static final String VAL_DATE

See Also:

Constant Field Values

DAILY

public static final int DAILY

See Also:

Constant Field Values

MEAN_MONTHLY

public static final int MEAN_MONTHLY

See Also:

Constant Field Values

MONTHLY_MEAN

public static final int MONTHLY_MEAN

See Also:

Constant Field Values

ANNUAL_MEAN

public static final int ANNUAL_MEAN

See Also:

Constant Field Values

PERIOD_MEAN

public static final int PERIOD_MEAN

See Also:

Constant Field Values

PERIOD_MEDIAN

public static final int PERIOD_MEDIAN

See Also:

Constant Field Values

PERIOD_STANDARD_DEVIATION

public static final int PERIOD_STANDARD_DEVIATION

See Also:

Constant Field Values

PERIOD_MIN

public static final int PERIOD_MIN

See Also:

Constant Field Values

PERIOD_MAX

public static final int PERIOD_MAX

See Also:

Constant Field Values

Constructor Detail

DataIO

public DataIO()

Method Detail

getColumnDoubleValuesInterval

public static double[] getColumnDoubleValuesInterval(Date start,
                                                     Date end,
                                                     CSTable t,
                                                     String columnName,
                                                     int timeStep)

lookupDateFormat

public static SimpleDateFormat lookupDateFormat(CSTable table,
                                                int col)

findRowByDate

public static int findRowByDate(Date date,
                                int dateColumn,
                                CSTable table)

synthESPInput

public static CSTable synthESPInput(CSTable table,
                                    Date iniStart,
                                    Date iniEnd,
                                    int fcDays,
                                    int year)

sliceByTime

public static int[] sliceByTime(CSTable table,
                                int timeCol,
                                Date start,
                                Date end)

Get a slice of rows out of the table matching the time window

Parameters:

table -

timeCol -

start -

end -

Returns:

the first and last row that matches the time window start->end

createTableModel

public static TableModel createTableModel(CSTable src)

Create a r/o data tablemodel

Parameters:

src -

Returns:

a table model to the CSTable

getProperties

public static AbstractTableModel getProperties(CSProperties p)

Get the KVP as table.

Parameters:

p -

Returns:

an AbstractTableModel for properties (KVP)

get2DBounded

public static AbstractTableModel get2DBounded(CSProperties p,
                                              String pname)
                                       throws ParseException

Throws:

ParseException

playsRole

public static boolean playsRole(CSProperties p,
                                String key,
                                String role)

isBound

public static boolean isBound(CSProperties p,
                              String key,
                              int dim)

getTable

public static CSTable getTable(CSProperties p,
                               String boundName)

getBoundProperties

public static AbstractTableModel getBoundProperties(CSProperties p,
                                                    String boundName)
                                             throws ParseException

Throws:

ParseException

getUnBoundProperties

public static AbstractTableModel getUnBoundProperties(CSProperties p)
                                               throws ParseException

Throws:

ParseException

toArrayString

public static String toArrayString(String[] arr)

Create array string.

Parameters:

arr -

Returns:

an array String.

toArrayString

public static String toArrayString(String[][] arr)

fromCSP

public static TableModel fromCSP(CSProperties p,
                                 int dim)

Returns a r/o table from a CSP file

Parameters:

p -

dim -

Returns:

a table model for properties with dimension.

keysByMeta

public static List<String> keysByMeta(CSProperties csp,
                                      String mkey,
                                      String mval)

Parameters:

csp -

mkey -

mval -

Returns:

the list of property keys that have a meta data value.

keysForBounds

public static List<String> keysForBounds(CSProperties csp,
                                         int boundCount)

keysByNotMeta

public static List<String> keysByNotMeta(CSProperties csp,
                                         String mkey)

getColumnDateValues

public static Date[] getColumnDateValues(CSTable t,
                                         String columnName)

getColumnDoubleValues

public static Double[] getColumnDoubleValues(CSTable t,
                                             String columnName)

Get a column as an int array.

Parameters:

t -

columnName -

Returns:

the column data as doubles.

getDate

public static Date getDate(CSProperties p,
                           String key)
                    throws ParseException

Get a value as date.

Parameters:

p -

key -

Returns:

a property as Date

Throws:

ParseException

getInt

public static int getInt(CSProperties p,
                         String key)
                  throws ParseException

Get a value as integer.

Parameters:

p -

key -

Returns:

a property value as integer.

Throws:

ParseException

save

public static void save(CSProperties csp,
                        File f,
                        String title)

print

public static void print(CSProperties props,
                         PrintWriter out)

Print CSProperties.

Parameters:

props - the Properties to print

out - the output writer to print to.

print

public static void print(Map<String,Object> props,
                         String header,
                         PrintWriter out)

print

public static void print(CSTable table,
                         PrintWriter out)

Print a CSTable to a PrintWriter

Parameters:

table - the table to print

out - the writer to write to

save

public static void save(CSTable table,
                        File file)
                 throws IOException

Saves a table to a file.

Parameters:

table - the table to save

file - the file to store it in (overwritten, if exists)

Throws:

IOException

properties

public static CSProperties properties(Reader r,
                                      String name)
                               throws IOException

Parse properties from a reader

Parameters:

r - the Reader

name - the name of the properties

Returns:

properties from a file.

Throws:

IOException

properties

public static CSProperties properties(Reader[] r,
                                      String name)
                               throws IOException

Create a CSProperty from an array of reader.

Parameters:

r -

name -

Returns:

merged properties.

Throws:

IOException

merge

public static void merge(CSProperties base,
                         CSProperties overlay)

Merges two Properties, respects permissions

Parameters:

base -

overlay -

properties

public static Properties properties(CSProperties p)

Convert CSProperties into Properties

Parameters:

p -

Returns:

the Properties.

properties

public static CSProperties properties(Properties p)

Convert Properties to CSProperties.

Parameters:

p - the Properties

Returns:

CSProperties

properties

public static CSProperties properties(Map<String,Object> p)

Convert from a Map to properties.

Parameters:

p - the source map

Returns:

CSProperties

properties

public static CSProperties properties()

Create Empty properties

Returns:

get some empty properties.

table

public static CSTable table(File file)
                     throws IOException

Parse the first table from a file

Parameters:

file - the file to parse

Returns:

the CSTable

Throws:

IOException

table

public static CSTable table(File file,
                            String name)
                     throws IOException

Parse a table from a given File.

Parameters:

file -

name -

Returns:

a CSTable.

Throws:

IOException

table

public static CSTable table(String s)
                     throws IOException

Parse a table from a Reader. Find the first table

Parameters:

s - the Reader to read from

Returns:

the CSTable

Throws:

IOException

table

public static CSTable table(String s,
                            String name)
                     throws IOException

Parse a table from a Reader.

Parameters:

s - the Reader to read from

name - the name of the table

Returns:

the CSTable

Throws:

IOException

table

public static CSTable table(URL url)
                     throws IOException

Opens the first table found at the URL

Parameters:

url - the URL

Returns:

the CSTable

Throws:

IOException

table

public static CSTable table(URL url,
                            String name)
                     throws IOException

Create a CSTable from a URL source.

Parameters:

url - the table URL

name - the name of the table

Returns:

a new CSTable

Throws:

IOException

columnExist

public static boolean columnExist(CSTable table,
                                  String name)

Check if a column exist in table.

Parameters:

table - the table to check

name - the name of the column

Returns:

columnIndex

public static int columnIndex(CSTable table,
                              String name)

Gets a column index by name

Parameters:

table - The table to check

name - the column name

Returns:

the index of the column

columnIndexes

public static int[] columnIndexes(CSTable table,
                                  String name)

Get the column indexes for a given column name. (e.g. use tmin to fetch tmin[0], tmin[1]...)

Parameters:

table -

name -

Returns:

columnNames

public static List<String> columnNames(CSTable table,
                                       String name)

rowStringValues

public static void rowStringValues(String[] row,
                                   int[] idx,
                                   String[] vals)

rowDoubleValues

public static double[] rowDoubleValues(String[] row,
                                       int[] idx,
                                       double[] vals)

rowDoubleValues

public static double[] rowDoubleValues(String[] row,
                                       int[] idx)

extractColumns

public static CSTable extractColumns(CSTable table,
                                     String... colNames)

Extract the columns and create another table.

Parameters:

table - the table

colName - the names of the columns to extract.

Returns:

A new Table with the Columns.

diff

public static String diff(double[] o,
                          double[] p)

asTable

public static CSTable asTable(CSProperties p,
                              String dim)

fromTable

public static CSProperties fromTable(CSTable t)

tables

public static List<String> tables(File f)
                           throws IOException

Find all table names in a file.

Parameters:

f - the file to search in

Returns:

a list of table names found in that file.

Throws:

IOException

properties

public static List<String> properties(File f)
                               throws IOException

Find all properties section names in a file.

Parameters:

f - the file to search in

Returns:

a list of section names found in that file.

Throws:

IOException

main

public static void main(String[] args)
                 throws IOException

Throws:

IOException