org.processmining.log.csvimport

Class CSVConversion

java.lang.Object

org.processmining.log.csvimport.CSVConversion

public final class CSVConversion
extends java.lang.Object

Conversion from CSV to a structure like XES. Use doConvertCSVToXES(ProgressListener, CSVFile, CSVConfig, CSVConversionConfig) to convert to XES, use convertCSV(ProgressListener, CSVConfig, CSVConversionConfig, CSVFile, CSVConversionHandler) to use your own CSVConversionHandler for some other format.

Example usage:

 CSVFileReferenceUnivocityImpl csvFile = new CSVFileReferenceUnivocityImpl(getFile().toPath());
 CSVConfig config = new CSVConfig(csvFile);
 try (ICSVReader reader = csvFile.createReader(config)) {
        CSVConversion conversion = new CSVConversion();
        CSVConversionConfig conversionConfig = new CSVConversionConfig(csvFile, config);
        conversionConfig.autoDetect();
 
        conversionConfig.setCaseColumns(ImmutableList.of("case"));
        conversionConfig.setEventNameColumns(ImmutableList.of("event"));
        conversionConfig.setCompletionTimeColumn("time");
        conversionConfig.setEmptyCellHandlingMode(CSVEmptyCellHandlingMode.SPARSE);
        conversionConfig.setErrorHandlingMode(CSVErrorHandlingMode.ABORT_ON_ERROR);
        Map<String, CSVMapping> conversionMap = conversionConfig.getConversionMap();
        CSVMapping mapping = conversionMap.get("time");
        mapping.setDataType(Datatype.TIME);
        mapping.setPattern("yyyy/MM/dd");
 
        ConversionResult<XLog> result = conversion.doConvertCSVToXES(new NoOpProgressListenerImpl(), csvFile, config,
                        conversionConfig);
 
        XLog log = result.getResult();
 }
 

Author:

F. Mannhardt

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	CSVConversion.ConversionResult<R>
static class	CSVConversion.NoOpProgressImpl
static class	CSVConversion.NoOpProgressListenerImpl
static interface	CSVConversion.ProgressListener

Constructor Summary

Constructors

Constructor and Description
CSVConversion()

Method Summary

Modifier and Type	Method and Description
<R> CSVConversion.ConversionResult<R>	convertCSV(CSVConversion.ProgressListener progress, CSVConfig importConfig, CSVConversionConfig conversionConfig, CSVFile csvFile, CSVConversionHandler<R> conversionHandler) Converts a CSVFileReferenceOpenCSVImpl into something determined by the supplied CSVConversionHandler.
CSVConversion.ConversionResult<org.deckfour.xes.model.XLog>	doConvertCSVToXES(CSVConversion.ProgressListener progressListener, CSVFile csvFile, CSVConfig importConfig, CSVConversionConfig conversionConfig) Convert a CSVFileReferenceOpenCSVImpl into an XLog using the supplied configuration.
CSVConversion.ConversionResult<org.deckfour.xes.model.XLog>	doConvertCSVToXES(CSVFile csvFile, CSVConfig importConfig, CSVConversionConfig conversionConfig) Convert a CSVFileReferenceOpenCSVImpl into an XLog using the supplied configuration.
double	getMaxSortingMemory()
void	setMaxSortingMemory(double maxSortingMemory)

Methods inherited from class java.lang.Object

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

Constructor Detail

CSVConversion

public CSVConversion()

Method Detail

doConvertCSVToXES

public CSVConversion.ConversionResult<org.deckfour.xes.model.XLog> doConvertCSVToXES(CSVFile csvFile,
                                                                                     CSVConfig importConfig,
                                                                                     CSVConversionConfig conversionConfig)
                                                                              throws CSVConversionException,
                                                                                     CSVConversionConfigException

Convert a CSVFileReferenceOpenCSVImpl into an XLog using the supplied configuration. Without progress information.

Parameters:

csvFile -

importConfig -

conversionConfig -

Returns:

Throws:

CSVConversionException

CSVConversionConfigException

doConvertCSVToXES

public CSVConversion.ConversionResult<org.deckfour.xes.model.XLog> doConvertCSVToXES(CSVConversion.ProgressListener progressListener,
                                                                                     CSVFile csvFile,
                                                                                     CSVConfig importConfig,
                                                                                     CSVConversionConfig conversionConfig)
                                                                              throws CSVConversionException,
                                                                                     CSVConversionConfigException

Convert a CSVFileReferenceOpenCSVImpl into an XLog using the supplied configuration.

Parameters:

progressListener -

csvFile -

importConfig -

conversionConfig -

Returns:

Throws:

CSVConversionException

CSVConversionConfigException

convertCSV

public <R> CSVConversion.ConversionResult<R> convertCSV(CSVConversion.ProgressListener progress,
                                                        CSVConfig importConfig,
                                                        CSVConversionConfig conversionConfig,
                                                        CSVFile csvFile,
                                                        CSVConversionHandler<R> conversionHandler)
                                                 throws CSVConversionException,
                                                        CSVConversionConfigException

Converts a CSVFileReferenceOpenCSVImpl into something determined by the supplied CSVConversionHandler. Use #doConvertCSVToXES(ProgressListener, CSVFileReferenceOpenCSVImpl, CSVConfig, CSVConversionConfig) in case you want to convert to an XLog.

Parameters:

progress -

importConfig -

conversionConfig -

csvFile -

conversionHandler -

Returns:

Throws:

CSVConversionException

CSVConversionConfigException

getMaxSortingMemory

public double getMaxSortingMemory()

setMaxSortingMemory

public void setMaxSortingMemory(double maxSortingMemory)