程序包 org.meteoinfo.data.dataframe

类 DataFrame

java.lang.Object

org.meteoinfo.data.dataframe.DataFrame

所有已实现的接口:

Iterable

public class DataFrame
extends Object
implements Iterable

作者:

Yaqiang Wang

构造器概要

构造器

构造器	说明
DataFrame()	Constructor
DataFrame(List index)	Constructor
DataFrame(List<ucar.ma2.Array> data, List index, List columns)	Constructor
DataFrame(List<ucar.ma2.Array> data, Index index, List<String> columns)	Constructor
DataFrame(List<ucar.ma2.Array> data, Index index, ColumnIndex columns)	Constructor
DataFrame(ColumnIndex columns)	Constructor
DataFrame(Index index)	Constructor
DataFrame(Index index, List<String> columns, Object data)	Constructor
DataFrame(Index index, ColumnIndex columns, Object data)	Constructor
DataFrame(ucar.ma2.Array data, List index, List<String> columns)	Constructor
DataFrame(ucar.ma2.Array data, Index index, List<String> columns)	Constructor
DataFrame(ucar.ma2.Array data, Index index, ColumnIndex columns)	Constructor

方法概要

限定符和类型	方法	说明
void	addColumn(int loc, String colName, Object o)	Add column data
void	addColumn(int loc, String colName, ucar.ma2.Array a)	Add column data
void	addColumn(int loc, Column column, ucar.ma2.Array a)	Add column data
void	addColumn(String colName, ucar.ma2.Array a)	Add column data
void	addColumn(Column column)	Add column data
void	addColumn(Column column, Series s)	Add column data
void	addColumn(Column column, ucar.ma2.Array a)	Add column data
void	append(Object name, List row)	Append row data
DataFrame	append(DataFrame df)	Append another data frame
<V> DataFrame	apply(Function<?,?> function)	Apply a function
Object	clone()
List	col(Integer column)	Return a data frame column as a list.
DataFrame	count()	Compute the sum of the numeric columns.
void	dataReshape(int nrow, int ncol)	Data reshape
void	dataToList()	Convert array 2D to array list.
<V> DataFrame	describe()
DataFrame	drop(Integer... cols)	Create a new data frame by leaving out the specified columns.
DataFrame	drop(List<String> colNames)	Create a new data frame by leaving out the specified columns.
DataFrame	drop(Column... cols)	Create a new data frame by leaving out the specified columns.
ucar.ma2.Array	getColumnData(int col)	Get column data array
ucar.ma2.Array	getColumnData(String colName)	Get column data array
List<ucar.ma2.DataType>	getColumnDataTypes()	Get column data types
List<String>	getColumnNames()	Get column names
ColumnIndex	getColumns()	Get columns
Object	getData()	Get data array
Index	getIndex()	Get index
int[]	getShape()	Get shape
Object	getValue(int row, int col)	Get value
Object	getValue(int row, String colName)	Get value
Object	getValue(Object row, Column col)	Get value
DataFrameGroupBy	groupBy(Integer... columns)	Group the data frame rows using columns
DataFrameGroupBy	groupBy(Object... columns)	Group the data frame rows using columns
DataFrameGroupBy	groupBy(List<Object> columns)	Group the data frame rows using columns
DataFrameGroupBy	groupBy(KeyFunction function)	Group the data frame rows using the specified key function.
DataFrameGroupBy	groupByIndex(String pStr)	Group the data frame rows using the specified key function.
DataFrameGroupBy	groupByIndex(WindowFunction function)	Group the data frame rows using the specified key function.
String	head(int n)	Convert to string - head
boolean	isArray2D()	Get if is 2D array
boolean	isEmpty()	Return true if the data frame contains no data.
Iterator	iterator()
ListIterator<List<Object>>	iterrows()
int	length()	Get the number of rows
DataFrame	max()	Compute the Maximum of the numeric columns.
DataFrame	mean()	Compute the mean of the numeric columns.
DataFrame	median()	Compute the median of the numeric columns.
DataFrame	min()	Compute the minimum of the numeric columns.
DataFrame	numeric()	Return a data frame containing only columns with numeric data.
static DataFrame	readTable(String fileName, String delimiter, int skipRows, String formatSpec, String encoding, int indexCol, String indexFormat, List<String> names, Integer header, int skipFooter)	Read data frame from ASCII file
static DataFrame	readTable(String fileName, String delimiter, int skipRows, String formatSpec, String encoding, int indexCol, String indexFormat, List<String> names, Integer header, int skipFooter, List<Object> usecolsin)	Read data frame from ASCII file
DataFrame	retain(Integer... cols)	Create a new data frame containing only the specified columns.
DataFrame	retain(Object... cols)	Create a new data frame containing only the specified columns.
List	row(Integer row)	Return a data frame row as a list.
Series	rowSeries(int row)	Get row series
void	saveCSV(String fileName, String delimiter, String dateFormat, String floatFormat, boolean index)	Save as CSV file
Object	select(int row, List<Integer> colRange)	Select by row and column ranges
Object	select(int row, ucar.ma2.Range colRange)	Select by row and column ranges
Object	select(List<Integer> rowRange, List<Integer> colRange)	Select by row and column ranges
Object	select(List<Integer> rowRange, ucar.ma2.Range colRange)	Select by row and column ranges
Object	select(List rowKeys, List<Integer> rowRange, List<Integer> colRange)	Select by row and column ranges
Object	select(List rowKeys, List<Integer> rowRange, ucar.ma2.Range colRange)	Select by row and column ranges
Object	select(ucar.ma2.Range rowRange, List<Integer> colRange)	Select by row and column ranges
Object	select(ucar.ma2.Range rowRange, ucar.ma2.Range colRange)	Select by row and column ranges
void	setColumn(String colName, Object a)	Set column data
void	setColumn(String colName, ucar.ma2.Array a)	Set column data
void	setColumns(List<String> colNames)	Set column names
void	setColumns(ColumnIndex value)	Set columns
void	setData(List<ucar.ma2.Array> value)	Set data array
void	setData(ucar.ma2.Array value)	Set data array
void	setIndex(List value)	Set index
void	setIndex(Index value)	Set index
void	setValue(int row, int col, Object v)	Set value
void	setValue(int row, String colName, Object v)	Set value
void	setValue(int row, Column column, Object v)	Set value
void	setValue(Object row, Column col, Object v)	Set value
void	setValues(int row, ucar.ma2.Range colRange, Number value)	Set values by row and column ranges
void	setValues(int row, ucar.ma2.Range colRange, ucar.ma2.Array value)	Set values by row and column ranges
int	size()	Get the number of columns
DataFrame	sortBy(boolean ascending, Integer... cols)
DataFrame	sortBy(Object... cols)
<V> DataFrame	sortBy(Comparator<List<V>> comparator)
DataFrame	sortBy(List<String> cols, List<Boolean> ascendings)
DataFrame	sortByIndex(boolean ascending)
DataFrame	sum()	Compute the sum of the numeric columns.
String	tail(int n)	Convert to string - tail
String	toString()
DataFrame	transpose()	Transpose
void	updateColumnFormats()	Update columns formats

从接口继承的方法 java.lang.Iterable

forEach, spliterator

从类继承的方法 java.lang.Object

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

构造器详细资料

DataFrame

public DataFrame()

Constructor

DataFrame

public DataFrame(ColumnIndex columns)

Constructor

参数:

columns - Columns

DataFrame

public DataFrame(Index index)

Constructor

参数:

index - Index

DataFrame

public DataFrame(List index)

Constructor

参数:

index - Index

DataFrame

public DataFrame(ucar.ma2.Array data,
                 Index index,
                 ColumnIndex columns)

Constructor

参数:

data - Data array

columns - Columns

index - Index

DataFrame

public DataFrame(ucar.ma2.Array data,
                 Index index,
                 List<String> columns)

Constructor

参数:

data - Data array

columns - Columns

index - Index

DataFrame

public DataFrame(Index index,
                 ColumnIndex columns,
                 Object data)

Constructor

参数:

index - Index

columns - Columns

data - Data

DataFrame

public DataFrame(Index index,
                 List<String> columns,
                 Object data)

Constructor

参数:

index - Index

columns - Columns

data - Data

DataFrame

public DataFrame(ucar.ma2.Array data,
                 List index,
                 List<String> columns)

Constructor

参数:

data - Data array

columns - Columns

index - Index

DataFrame

public DataFrame(List<ucar.ma2.Array> data,
                 Index index,
                 ColumnIndex columns)

Constructor

参数:

data - Data array list

columns - Columns

index - Index

DataFrame

public DataFrame(List<ucar.ma2.Array> data,
                 Index index,
                 List<String> columns)

Constructor

参数:

data - Data array list

columns - Columns

index - Index

DataFrame

public DataFrame(List<ucar.ma2.Array> data,
                 List index,
                 List columns)

Constructor

参数:

data - Data array list

columns - Columns

index - Index

方法详细资料

getData

public Object getData()

Get data array

返回:

Data array

setData

public void setData(ucar.ma2.Array value)

Set data array

参数:

value - Data array

setData

public void setData(List<ucar.ma2.Array> value)

Set data array

参数:

value - Data array

getIndex

public Index getIndex()

Get index

返回:

Index

setIndex

public void setIndex(Index value)

Set index

参数:

value - Index

setIndex

public void setIndex(List value)

Set index

参数:

value - Index value

getColumns

public ColumnIndex getColumns()

Get columns

返回:

Columns

getColumnNames

public List<String> getColumnNames()

Get column names

返回:

Column names

getColumnDataTypes

public List<ucar.ma2.DataType> getColumnDataTypes()

Get column data types

返回:

Column data types

setColumns

public void setColumns(ColumnIndex value)

Set columns

参数:

value - Columns

setColumns

public void setColumns(List<String> colNames)

Set column names

参数:

colNames - Column names

isArray2D

public boolean isArray2D()

Get if is 2D array

返回:

Boolean

iterator

public Iterator iterator()

指定者:

iterator 在接口中 Iterable

iterrows

public ListIterator<List<Object>> iterrows()

updateColumnFormats

public void updateColumnFormats()

Update columns formats

size

public int size()

Get the number of columns

返回:

The number of columns

length

public int length()

Get the number of rows

返回:

The number of rows

isEmpty

public boolean isEmpty()

Return true if the data frame contains no data.

 
 > DataFrame<Object> df = new DataFrame<>();
 > df.isEmpty();
 true 

返回:

the number of columns

col

public List col(Integer column)

Return a data frame column as a list.

 
 > DataFrame<Object> df = new DataFrame<>(
 >         Collections.emptyList(),
 >         Arrays.asList("name", "value"),
 >         Arrays.asList(
 >             Arrays.<Object>asList("alpha", "bravo", "charlie"),
 >             Arrays.<Object>asList(1, 2, 3)
 >         )
 >     );
 > df.col(1);
 [1, 2, 3] 

参数:

column - the column index

返回:

the list of values

row

public List row(Integer row)

Return a data frame row as a list.

 
 > DataFrame<Object> df = new DataFrame<>(
 >         Collections.emptyList(),
 >         Collections.emptyList(),
 >         Arrays.asList(
 >             Arrays.<Object>asList("alpha", "bravo", "charlie"),
 >             Arrays.<Object>asList(1, 2, 3)
 >         )
 >     );
 > df.row(1);
 [bravo, 2] 

参数:

row - the row index

返回:

the list of values

rowSeries

public Series rowSeries(int row)

Get row series

参数:

row - Row index

返回:

Series

getShape

public int[] getShape()

Get shape

返回:

Shape

getValue

public Object getValue(Object row,
                       Column col)

Get value

参数:

row - Row object

col - Column object

返回:

Value

getValue

public Object getValue(int row,
                       int col)

Get value

参数:

row - Row index

col - Column index

返回:

Value

getValue

public Object getValue(int row,
                       String colName)

Get value

参数:

row - Row index

colName - Column name

返回:

Value

setValue

public void setValue(Object row,
                     Column col,
                     Object v)

Set value

参数:

row - Row

col - Column

v - Value

setValue

public void setValue(int row,
                     int col,
                     Object v)

Set value

参数:

row - Row index

col - Column index

v - Value

setValue

public void setValue(int row,
                     String colName,
                     Object v)

Set value

参数:

row - Row index

colName - Column name

v - Value

setValue

public void setValue(int row,
                     Column column,
                     Object v)

Set value

参数:

row - Row index

column - Column

v - Value

getColumnData

public ucar.ma2.Array getColumnData(int col)
                             throws ucar.ma2.InvalidRangeException

Get column data array

参数:

col - Column index

返回:

Column data array

抛出:

ucar.ma2.InvalidRangeException

getColumnData

public ucar.ma2.Array getColumnData(String colName)
                             throws ucar.ma2.InvalidRangeException

Get column data array

参数:

colName - Column name

返回:

Column data array

抛出:

ucar.ma2.InvalidRangeException

addColumn

public void addColumn(Column column)

Add column data

参数:

column - Column

addColumn

public void addColumn(Column column,
                      ucar.ma2.Array a)
               throws ucar.ma2.InvalidRangeException

Add column data

参数:

column - Column

a - Column data array

抛出:

ucar.ma2.InvalidRangeException

addColumn

public void addColumn(Column column,
                      Series s)
               throws ucar.ma2.InvalidRangeException

Add column data

参数:

column - Column

s - Column data series

抛出:

ucar.ma2.InvalidRangeException

addColumn

public void addColumn(int loc,
                      Column column,
                      ucar.ma2.Array a)
               throws ucar.ma2.InvalidRangeException

Add column data

参数:

loc - Location

column - Column

a - Column data array

抛出:

ucar.ma2.InvalidRangeException

addColumn

public void addColumn(String colName,
                      ucar.ma2.Array a)
               throws ucar.ma2.InvalidRangeException

Add column data

参数:

colName - Column name

a - Column data array

抛出:

ucar.ma2.InvalidRangeException

addColumn

public void addColumn(int loc,
                      String colName,
                      ucar.ma2.Array a)
               throws ucar.ma2.InvalidRangeException

Add column data

参数:

loc - Location

colName - Column name

a - Column data array

抛出:

ucar.ma2.InvalidRangeException

addColumn

public void addColumn(int loc,
                      String colName,
                      Object o)
               throws ucar.ma2.InvalidRangeException

Add column data

参数:

loc - Location

colName - Column name

o - Column data object

抛出:

ucar.ma2.InvalidRangeException

setColumn

public void setColumn(String colName,
                      ucar.ma2.Array a)
               throws ucar.ma2.InvalidRangeException

Set column data

参数:

colName - Column name

a - Column data array

抛出:

ucar.ma2.InvalidRangeException

setColumn

public void setColumn(String colName,
                      Object a)
               throws ucar.ma2.InvalidRangeException

Set column data

参数:

colName - Column name

a - A value

抛出:

ucar.ma2.InvalidRangeException

append

public DataFrame append(DataFrame df)

Append another data frame

参数:

df - Another data frame

返回:

Appended data frame

dataToList

public void dataToList()

Convert array 2D to array list.

dataReshape

public void dataReshape(int nrow,
                        int ncol)
                 throws ucar.ma2.InvalidRangeException

Data reshape

参数:

nrow - Number of rows

ncol - Number of columns

抛出:

ucar.ma2.InvalidRangeException

append

public void append(Object name,
                   List row)

Append row data

参数:

name - Index element

row - Row data list

drop

public DataFrame drop(List<String> colNames)

Create a new data frame by leaving out the specified columns.

参数:

colNames - Column names

返回:

a shallow copy of the data frame with the columns removed

drop

public DataFrame drop(Column... cols)

Create a new data frame by leaving out the specified columns.

参数:

cols - the names of columns to be removed

返回:

a shallow copy of the data frame with the columns removed

drop

public DataFrame drop(Integer... cols)

Create a new data frame by leaving out the specified columns.

参数:

cols - the indices of the columns to be removed

返回:

a shallow copy of the data frame with the columns removed

retain

public DataFrame retain(Object... cols)

Create a new data frame containing only the specified columns.

 
 > DataFrame<Object> df = new DataFrame<>("name", "value", "category");
 > df.retain("name", "category").columns();
 [name, category] 

参数:

cols - the columns to include in the new data frame

返回:

a new data frame containing only the specified columns

retain

public DataFrame retain(Integer... cols)

Create a new data frame containing only the specified columns.

 
  DataFrame<Object> df = new DataFrame<>("name", "value", "category");
  df.retain(0, 2).columns();
 [name, category] 

参数:

cols - the columns to include in the new data frame

返回:

a new data frame containing only the specified columns

numeric

public DataFrame numeric()

Return a data frame containing only columns with numeric data.

 
 > DataFrame<Object> df = new DataFrame<>("name", "value");
 > df.append(Arrays.asList("one", 1));
 > df.append(Arrays.asList("two", 2));
 > df.numeric().columns();
 [value] 

返回:

a data frame containing only the numeric columns

select

public Object select(int row,
                     ucar.ma2.Range colRange)
              throws ucar.ma2.InvalidRangeException

Select by row and column ranges

参数:

row - Row index

colRange - Column range

返回:

Selected data frame or series

抛出:

ucar.ma2.InvalidRangeException

setValues

public void setValues(int row,
                      ucar.ma2.Range colRange,
                      Number value)
               throws ucar.ma2.InvalidRangeException

Set values by row and column ranges

参数:

row - Row index

colRange - Column range

value - The value

抛出:

ucar.ma2.InvalidRangeException

setValues

public void setValues(int row,
                      ucar.ma2.Range colRange,
                      ucar.ma2.Array value)
               throws ucar.ma2.InvalidRangeException

Set values by row and column ranges

参数:

row - Row index

colRange - Column range

value - The value array

抛出:

ucar.ma2.InvalidRangeException

select

public Object select(ucar.ma2.Range rowRange,
                     ucar.ma2.Range colRange)
              throws ucar.ma2.InvalidRangeException

Select by row and column ranges

参数:

rowRange - Row range

colRange - Column range

返回:

Selected data frame or series

抛出:

ucar.ma2.InvalidRangeException

select

public Object select(ucar.ma2.Range rowRange,
                     List<Integer> colRange)
              throws ucar.ma2.InvalidRangeException

Select by row and column ranges

参数:

rowRange - Row range

colRange - Column range

返回:

Selected data frame or series

抛出:

ucar.ma2.InvalidRangeException

select

public Object select(List<Integer> rowRange,
                     ucar.ma2.Range colRange)
              throws ucar.ma2.InvalidRangeException

Select by row and column ranges

参数:

rowRange - Row range

colRange - Column range

返回:

Selected data frame or series

抛出:

ucar.ma2.InvalidRangeException

select

public Object select(List rowKeys,
                     List<Integer> rowRange,
                     ucar.ma2.Range colRange)
              throws ucar.ma2.InvalidRangeException

Select by row and column ranges

参数:

rowKeys - Row keys

rowRange - Row range

colRange - Column range

返回:

Selected data frame or series

抛出:

ucar.ma2.InvalidRangeException

select

public Object select(List rowKeys,
                     List<Integer> rowRange,
                     List<Integer> colRange)
              throws ucar.ma2.InvalidRangeException

Select by row and column ranges

参数:

rowKeys - Row keys

rowRange - Row range

colRange - Column range

返回:

Selected data frame or series

抛出:

ucar.ma2.InvalidRangeException

select

public Object select(int row,
                     List<Integer> colRange)

Select by row and column ranges

参数:

row - Row index

colRange - Column range

返回:

Selected data frame or series

select

public Object select(List<Integer> rowRange,
                     List<Integer> colRange)

Select by row and column ranges

参数:

rowRange - Row range

colRange - Column range

返回:

Selected data frame or series

transpose

public DataFrame transpose()

Transpose

返回:

Transposed data frame

head

public String head(int n)

Convert to string - head

参数:

n - Head row number

返回:

The string

tail

public String tail(int n)

Convert to string - tail

参数:

n - Tail row number

返回:

The string

toString

public String toString()

覆盖:

toString 在类中 Object

readTable

public static DataFrame readTable(String fileName,
                                  String delimiter,
                                  int skipRows,
                                  String formatSpec,
                                  String encoding,
                                  int indexCol,
                                  String indexFormat,
                                  List<String> names,
                                  Integer header,
                                  int skipFooter)
                           throws FileNotFoundException,
                                  IOException,
                                  Exception

Read data frame from ASCII file

参数:

fileName - File name

delimiter - Delimiter

skipRows - Number of lines to skip at begining of the file

formatSpec - Format specifiers string

encoding - Fle encoding

indexCol - Column to be used as index

indexFormat - Index format

names - Column names

header - Row number to use as the column names

skipFooter - Number of lines at bottom of file to skip

返回:

DataFrame object

抛出:

FileNotFoundException

IOException

Exception

readTable

public static DataFrame readTable(String fileName,
                                  String delimiter,
                                  int skipRows,
                                  String formatSpec,
                                  String encoding,
                                  int indexCol,
                                  String indexFormat,
                                  List<String> names,
                                  Integer header,
                                  int skipFooter,
                                  List<Object> usecolsin)
                           throws FileNotFoundException,
                                  IOException,
                                  Exception

Read data frame from ASCII file

参数:

fileName - File name

delimiter - Delimiter

skipRows - Number of lines to skip at begining of the file

formatSpec - Format specifiers string

encoding - Fle encoding

indexCol - Column to be used as index

indexFormat - Index format

names - Column names

header - Row number to use as the column names

skipFooter - Number of lines at bottom of file to skip

usecolsin - Filter columns by column names or indices

返回:

DataFrame object

抛出:

FileNotFoundException

IOException

Exception

saveCSV

public void saveCSV(String fileName,
                    String delimiter,
                    String dateFormat,
                    String floatFormat,
                    boolean index)
             throws IOException

Save as CSV file

参数:

fileName - File name

delimiter - Delimiter

dateFormat - Date format string

floatFormat - Float format string

index - If write index

抛出:

IOException

describe

public <V> DataFrame describe()

sortBy

public DataFrame sortBy(List<String> cols,
                        List<Boolean> ascendings)

sortByIndex

public DataFrame sortByIndex(boolean ascending)

sortBy

public DataFrame sortBy(Object... cols)

sortBy

public DataFrame sortBy(boolean ascending,
                        Integer... cols)

sortBy

public <V> DataFrame sortBy(Comparator<List<V>> comparator)

groupBy

public DataFrameGroupBy groupBy(KeyFunction function)

Group the data frame rows using the specified key function.

参数:

function - the function to reduce rows to grouping keys

返回:

the grouping

groupBy

public DataFrameGroupBy groupBy(Integer... columns)

Group the data frame rows using columns

参数:

columns - The columns

返回:

The grouping

groupBy

public DataFrameGroupBy groupBy(Object... columns)

Group the data frame rows using columns

参数:

columns - The columns

返回:

The grouping

groupBy

public DataFrameGroupBy groupBy(List<Object> columns)

Group the data frame rows using columns

参数:

columns - The columns

返回:

The grouping

groupByIndex

public DataFrameGroupBy groupByIndex(WindowFunction function)

Group the data frame rows using the specified key function.

参数:

function - the function to reduce rows to grouping keys

返回:

the grouping

groupByIndex

public DataFrameGroupBy groupByIndex(String pStr)

Group the data frame rows using the specified key function.

参数:

pStr - Period string

返回:

the grouping

apply

public <V> DataFrame apply(Function<?,?> function)

Apply a function

类型参数:

V -

参数:

function - The function

返回:

Result data frame

count

public DataFrame count()

Compute the sum of the numeric columns.

返回:

the new data frame

sum

public DataFrame sum()

Compute the sum of the numeric columns.

返回:

the new data frame

mean

public DataFrame mean()

Compute the mean of the numeric columns.

返回:

the new data frame

min

public DataFrame min()

Compute the minimum of the numeric columns.

返回:

the new data frame

max

public DataFrame max()

Compute the Maximum of the numeric columns.

返回:

the new data frame

median

public DataFrame median()

Compute the median of the numeric columns.

返回:

the new data frame

clone

public Object clone()

覆盖:

clone 在类中 Object