org.nuiton.j2r.types
Class RDataFrame

java.lang.Object
  org.nuiton.j2r.types.REXPAbstract
      org.nuiton.j2r.types.RDataFrame

All Implemented Interfaces:

REXP

public class RDataFrame
extends REXPAbstract
implements REXP

Java implementation of the R data.frame

Author:

couteau

Field Summary

Fields inherited from class org.nuiton.j2r.types.REXPAbstract

attributes, dataInconsistencyText, engine, indexExceptionText, names, noVariable, variable

Constructor Summary

RDataFrame(REngine engine)
Constructor

RDataFrame(REngine engine, java.util.List<java.lang.String> names, java.util.List<java.lang.String> rowNames, java.util.List<java.util.List<? extends java.lang.Object>> data, java.lang.String variable)
Constructor

RDataFrame(REngine engine, java.lang.Object[] datatypes, int y)
Constructor

RDataFrame(REngine engine, java.lang.String[] names, java.lang.String[] rowNames, java.util.List<java.util.List<? extends java.lang.Object>> data, java.lang.String variable)
Constructor, used for autoconversion from rexp to data.frame.

Method Summary

void	checkX(int x) Check if the index is into the data.frame length throws a IndexOutOfBoundsException if not the index is too big.
void	exportCsv(java.io.File outputFile, boolean rowNames, boolean names) Export the data.frame into csv format.
java.lang.Object	get(int x, int y) Method to get the object located at the [x,y] coordinates.
java.util.List<java.util.List<? extends java.lang.Object>>	getData() Method to get the ArrayLists of the R data.frame (there is no synchronizing with R).
void	getFrom(java.lang.String variable) Method to get a data.frame from a variable in R.
java.lang.String	getRowName(int y) Method to get the row name of the row index y+1 of the R data.frame.
java.util.List<java.lang.String>	getRowNames() Method to get the names of the rows of the R data.frame
void	importCsv(java.io.File inputFile, boolean rowNames, boolean names) Import a dataframe form a csv file.
void	importCsv(java.io.File inputFile, boolean rowNames, boolean names, java.util.List<java.lang.Object> importTypes) Import a dataframe from a csv file.
void	importCsv(java.io.File inputFile, boolean rowNames, boolean names, java.lang.Object importType) Import a dataframe form a csv file.
void	set(int x, int y, java.lang.Object data) Method to set the value (x,y) to a Double value.
void	setData(java.util.List<java.util.List<? extends java.lang.Object>> data) Method to assign the data of the R data.frame (there is no synchronizing with R, use the commit() method to send data to R.
void	setRowName(int x, java.lang.String rowName) Method to assign the name of the ArrayList at the index x.
void	setRowNames(java.util.List<java.lang.String> rowNames) Method to assign the names of the rows of the R data.frame
java.lang.String	toRString() Method to export the data.frame in a String for evaluation in R.

Methods inherited from class org.nuiton.j2r.types.REXPAbstract

checkVariable, getAttribute, getAttributes, getEngine, getName, getNames, getVariable, setAttribute, setAttributes, setEngine, setName, setNames, setVariable

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.nuiton.j2r.types.REXP

getAttribute, getAttributes, getVariable, setAttribute, setAttributes

Constructor Detail

RDataFrame

public RDataFrame(REngine engine)

Constructor

Parameters:

engine - the engine in which the data frame will be located.

RDataFrame

public RDataFrame(REngine engine,
                  java.lang.Object[] datatypes,
                  int y)
           throws RException

Constructor

Parameters:

engine - the engine in which the data frame will be located.

datatypes - a table object determining the type of each column of the data.frame.

y - the length of each vector that compound the data.frame.

Throws:

RException

RDataFrame

public RDataFrame(REngine engine,
                  java.util.List<java.lang.String> names,
                  java.util.List<java.lang.String> rowNames,
                  java.util.List<java.util.List<? extends java.lang.Object>> data,
                  java.lang.String variable)
           throws RException

Constructor

Parameters:

engine - the engine in which the data frame will be located.

names - names of the the data.frame columns.

rowNames - names of the data.frame rows.

data - the data of the data.frame

variable - the name of the data.frame in R.

Throws:

RException - if an error occur while trying to initialize

RDataFrame

public RDataFrame(REngine engine,
                  java.lang.String[] names,
                  java.lang.String[] rowNames,
                  java.util.List<java.util.List<? extends java.lang.Object>> data,
                  java.lang.String variable)

Constructor, used for autoconversion from rexp to data.frame.

Parameters:

engine - the engine in which the data frame will be located.

names - names of the the data.frame columns.

rowNames - names of the data.frame rows.

data - the data of the data.frame

variable - the name of the data.frame in R.

Method Detail

getRowNames

public java.util.List<java.lang.String> getRowNames()
                                             throws RException

Method to get the names of the rows of the R data.frame

Returns:

a ArrayList of strings containing the names of each row of the R data.frame

Throws:

RException - if an error occurs while getting back the names from R.

java.lang.IndexOutOfBoundsException - when the row.names size get from R is bigger than the local data size.

getRowName

public java.lang.String getRowName(int y)
                            throws RException

Method to get the row name of the row index y+1 of the R data.frame.

Parameters:

y - index of the row (0 to n-1)

Returns:

the name of the ArrayList

Throws:

RException - if an error occurs while getting back the row name from R.

setRowNames

public void setRowNames(java.util.List<java.lang.String> rowNames)
                 throws RException

Method to assign the names of the rows of the R data.frame

Parameters:

rowNames - a ArrayList containing the names of the rows of the R data.frame

Throws:

RException - if an error occur while in R.

java.lang.IndexOutOfBoundsException - when the row names ArrayList is longer than the data.frame length

setRowName

public void setRowName(int x,
                       java.lang.String rowName)
                throws RException

Method to assign the name of the ArrayList at the index x.

Parameters:

x - index of the ArrayList (0 to n-1)

name - Name of the ArrayList.

Throws:

RException - if an error occur while in R.

java.lang.IndexOutOfBoundsException - when the index is out of the data.frame bounds.

toRString

public java.lang.String toRString()
                           throws RException

Method to export the data.frame in a String for evaluation in R.

Specified by:

toRString in interface REXP

Returns:

a R string representation of the data.frame to create it in R.

Throws:

RException - If no variable name is given

set

public void set(int x,
                int y,
                java.lang.Object data)
         throws RException

Method to set the value (x,y) to a Double value.

Parameters:

x - x coordinate (from 0 to size-1)

y - y coordinate (from 0 to size-1)

data - value to set

Throws:

RException - if no variable name has been given to the data.frame or the data type is not allowed at this location.

get

public java.lang.Object get(int x,
                            int y)
                     throws RException

Method to get the object located at the [x,y] coordinates.

Parameters:

x - x coordinates (between 0 and size-1)

y - y coordinates (between 0 and size-1)

Returns:

the Object located at the [x,y] coordinates

Throws:

RException - if no variable name has been given to the data.frame

java.lang.IndexOutOfBoundsException - if the x or y coordinates are not correct.

getData

public java.util.List<java.util.List<? extends java.lang.Object>> getData()

Method to get the ArrayLists of the R data.frame (there is no synchronizing with R).

Returns:

a ArrayList containing the ArrayLists of the R data.frame

setData

public void setData(java.util.List<java.util.List<? extends java.lang.Object>> data)
             throws RException

Method to assign the data of the R data.frame (there is no synchronizing with R, use the commit() method to send data to R.

Parameters:

data - a ArrayList of ArrayLists, containing each ArrayList of the R data.frame

engine - a REngine where the R session is located.

Throws:

RException

getFrom

public void getFrom(java.lang.String variable)
             throws RException

Method to get a data.frame from a variable in R.

Specified by:

getFrom in interface REXP

Parameters:

variable - name of the data.frame in R

engine - a REngine where the R session is located.

Throws:

RException

exportCsv

public void exportCsv(java.io.File outputFile,
                      boolean rowNames,
                      boolean names)
               throws java.io.IOException

Export the data.frame into csv format.

Parameters:

outputFile - the file to write

rowNames - true/false to determine if the row names will be put on the export.

names - true/false to determine if the column names will be put on the export.

Throws:

java.io.IOException

importCsv

public void importCsv(java.io.File inputFile,
                      boolean rowNames,
                      boolean names)
               throws java.io.FileNotFoundException,
                      java.io.IOException

Import a dataframe form a csv file. The dataframe will contain Strings. Use this method if you don't know the type of data that is in the csv file.

Parameters:

inputFile - Csv file to import.

rowNames - Does the csv file contains names of the rows.

names - Does the csv file contain names of the columns.

Throws:

java.io.FileNotFoundException

java.io.IOException

importCsv

public void importCsv(java.io.File inputFile,
                      boolean rowNames,
                      boolean names,
                      java.lang.Object importType)
               throws java.io.FileNotFoundException,
                      java.io.IOException

Import a dataframe form a csv file. The dataframe will contain Objects of the same class than importType. Use this method if you know the type of data that is in the csv file.

Parameters:

inputFile - Csv file to import.

rowNames - Does the csv file contains names of the rows.

names - Does the csv file contain names of the columns.

importType - Object of the class of the data imported (all the data have the same type). (Supported types : String, Double and Integer)

Throws:

java.io.FileNotFoundException

java.io.IOException

importCsv

public void importCsv(java.io.File inputFile,
                      boolean rowNames,
                      boolean names,
                      java.util.List<java.lang.Object> importTypes)
               throws java.io.FileNotFoundException,
                      java.io.IOException

Import a dataframe from a csv file. The dataframe will contain Objects of the same class than each element of importTypes (one element = one column). Use this method if you know the type of data that is in the csv file.

Parameters:

inputFile - Csv file to import.

rowNames - Does the csv file contains names of the rows.

names - Does the csv file contain names of the columns.

importTypes - ArrayList of Object of the class of the data imported (the ArrayList match the data type of the columns). (Supported types : String, Double and Integer)

Throws:

java.io.FileNotFoundException

java.io.IOException

checkX

public void checkX(int x)

Check if the index is into the data.frame length throws a IndexOutOfBoundsException if not the index is too big.

Specified by:

checkX in interface REXP

Parameters:

x - index