com.powsybl.timeseries

Class TimeSeriesTable

java.lang.Object

com.powsybl.timeseries.TimeSeriesTable

public class TimeSeriesTable
extends java.lang.Object

Utility class to load time series into a table and then:

• Get direct access to all values
• Compute statistics like mean, standard deviation, and Pearson product-moment correlation coefficient
• Convert to CSV

Some design considerations and limitations:

• Number of version loadable in the table has to be specified at creation
• Versions have to contiguous
• Once first batch of time series has been loaded, new time series cannot be added but data of existing one can be updated
• Concurrent load (i.e multi-thread) of data is supported (using same time series list)
• Concurrency between data loading and other operations (CSV writing, statistics computation) is NOT supported

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	TimeSeriesTable.Correlation

Constructor Summary

Constructors

Constructor and Description
TimeSeriesTable(int fromVersion, int toVersion, TimeSeriesIndex tableIndex)
TimeSeriesTable(int fromVersion, int toVersion, TimeSeriesIndex tableIndex, java.util.function.IntFunction<java.nio.ByteBuffer> byteBufferAllocator)

Method Summary

Modifier and Type	Method and Description
double[]	computePpmcc(java.lang.String timeSeriesName, int version)
static TimeSeriesTable	createDirectMem(int fromVersion, int toVersion, TimeSeriesIndex tableIndex)
static TimeSeriesTable	createMem(int fromVersion, int toVersion, TimeSeriesIndex tableIndex)
java.util.List<TimeSeriesTable.Correlation>	findMostCorrelatedTimeSeries(java.lang.String timeSeriesName, int version)
java.util.List<TimeSeriesTable.Correlation>	findMostCorrelatedTimeSeries(java.lang.String timeSeriesName, int version, int maxSize)
int	getDoubleTimeSeriesIndex(java.lang.String timeSeriesName)
double	getDoubleValue(int version, int timeSeriesNum, int point)
double	getMean(int version, int timeSeriesNum)
double	getStdDev(int version, int timeSeriesNum)
int	getStringTimeSeriesIndex(java.lang.String timeSeriesName)
java.lang.String	getStringValue(int version, int timeSeriesNum, int point)
TimeSeriesIndex	getTableIndex()
java.util.List<java.lang.String>	getTimeSeriesNames()
void	load(int version, java.util.List<? extends TimeSeries>... timeSeries)
void	load(int version, java.util.List<TimeSeries> timeSeriesList)
java.lang.String	toCsvString(char separator, java.time.ZoneId zoneId)
void	writeCsv(java.nio.file.Path file)
void	writeCsv(java.io.Writer writer, char separator, java.time.ZoneId zoneId)

Methods inherited from class java.lang.Object

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

Constructor Detail

TimeSeriesTable

public TimeSeriesTable(int fromVersion,
                       int toVersion,
                       TimeSeriesIndex tableIndex)

TimeSeriesTable

public TimeSeriesTable(int fromVersion,
                       int toVersion,
                       TimeSeriesIndex tableIndex,
                       java.util.function.IntFunction<java.nio.ByteBuffer> byteBufferAllocator)

Method Detail

createDirectMem

public static TimeSeriesTable createDirectMem(int fromVersion,
                                              int toVersion,
                                              TimeSeriesIndex tableIndex)

createMem

public static TimeSeriesTable createMem(int fromVersion,
                                        int toVersion,
                                        TimeSeriesIndex tableIndex)

getTableIndex

public TimeSeriesIndex getTableIndex()

load

@SafeVarargs
public final void load(int version,
                                    java.util.List<? extends TimeSeries>... timeSeries)

load

public void load(int version,
                 java.util.List<TimeSeries> timeSeriesList)

getTimeSeriesNames

public java.util.List<java.lang.String> getTimeSeriesNames()

getDoubleValue

public double getDoubleValue(int version,
                             int timeSeriesNum,
                             int point)

getStringValue

public java.lang.String getStringValue(int version,
                                       int timeSeriesNum,
                                       int point)

getDoubleTimeSeriesIndex

public int getDoubleTimeSeriesIndex(java.lang.String timeSeriesName)

getStringTimeSeriesIndex

public int getStringTimeSeriesIndex(java.lang.String timeSeriesName)

getMean

public double getMean(int version,
                      int timeSeriesNum)

getStdDev

public double getStdDev(int version,
                        int timeSeriesNum)

findMostCorrelatedTimeSeries

public java.util.List<TimeSeriesTable.Correlation> findMostCorrelatedTimeSeries(java.lang.String timeSeriesName,
                                                                                int version)

findMostCorrelatedTimeSeries

public java.util.List<TimeSeriesTable.Correlation> findMostCorrelatedTimeSeries(java.lang.String timeSeriesName,
                                                                                int version,
                                                                                int maxSize)

computePpmcc

public double[] computePpmcc(java.lang.String timeSeriesName,
                             int version)

writeCsv

public void writeCsv(java.nio.file.Path file)

toCsvString

public java.lang.String toCsvString(char separator,
                                    java.time.ZoneId zoneId)

writeCsv

public void writeCsv(java.io.Writer writer,
                     char separator,
                     java.time.ZoneId zoneId)