Package pulse.io.readers

Class NetzschCSVReader

java.lang.Object

pulse.io.readers.NetzschCSVReader

All Implemented Interfaces:

AbstractHandler, AbstractReader<List<ExperimentalData>>, CurveReader, Reflexive

public class NetzschCSVReader
extends Object
implements CurveReader

Reads the .CSV files exported from Proteus LFA Analysis software. To load Proteus measurements in PULsE, the detector signal needs to be imported first, followed by the pulse data.

Note that by default the decimal separator is assumed to be a point (".").

Field Summary

Fields

Modifier and Type	Field	Description
protected static double	TO_SECONDS

Method Summary

Modifier and Type	Method	Description
protected static int	determineShotID(BufferedReader reader, File file)
protected static String	findLineByLabel(BufferedReader reader, String label, boolean ignoreLocale)
protected static String	findLineByLabel(BufferedReader reader, String label, String stopLabel, boolean ignoreLocale)
static String	getDelims()	Get the standard delimiter chars.
static CurveReader	getInstance()	As this class uses the singleton pattern, only one instance is created using an empty no-argument constructor.
String	getSupportedExtension()	Retrieves the supported extension of files, which this AbstractHandler is able to process.
protected static void	populate(AbstractData data, BufferedReader reader)
List<ExperimentalData>	read(File file)	Reads file, assuming that it contains data generated by Proteus with the detector signal.
protected void	setDefaultLocale()

Methods inherited from class java.lang.Object

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

Methods inherited from interface pulse.io.readers.AbstractHandler

isExtensionSupported

Field Detail

TO_SECONDS

protected static final double TO_SECONDS

See Also:

Constant Field Values

Method Detail

setDefaultLocale

protected void setDefaultLocale()

getSupportedExtension

public String getSupportedExtension()

Description copied from interface: AbstractHandler

Retrieves the supported extension of files, which this AbstractHandler is able to process.

Specified by:

getSupportedExtension in interface AbstractHandler

Returns:

The supported extension (.csv).

read

public List<ExperimentalData> read(File file)
                            throws IOException

Reads file, assuming that it contains data generated by Proteus with the detector signal.

This will throw an IllegalArgumentException if the first entry in this file does not contain the "Shot_data" string. If this is found, then an ID is extracted from the file, which will then be used to associate a pulse with the newly create ExperimentalData (this requires another reader. When the ID is identified, the file is searched for the keywords "Thickness_RT" and "Sample_temperature" to determine the sample thickness and baseline temperature of the shot. Then the method proceeds to search for the DETECTOR keyword, marking the beginning of the experimental time-signal sequence. If, for example, the file only contains the pulse data, the method will return an empty list and print an error message in the log, saying that the file was skipped. Otherwise, the time-signal sequence will be read, taking care to convert the time (in milliseconds by default) to second (used by default in PULsE).

Specified by:

read in interface AbstractReader<List<ExperimentalData>>

Specified by:

read in interface CurveReader

Parameters:

file - a File which has either all information encoded in its contents or provides URI links to other files, each containing the necessary information.

Returns:

a list containing either zero elements, if the procedure failed, or one element, corresponding to the stored shot data.

Throws:

IOException - if something goes wrong with reading the file

populate

protected static void populate(AbstractData data,
                               BufferedReader reader)
                        throws IOException,
                               ParseException

Throws:

IOException

ParseException

determineShotID

protected static int determineShotID(BufferedReader reader,
                                     File file)
                              throws IOException

Throws:

IOException

findLineByLabel

protected static String findLineByLabel(BufferedReader reader,
                                        String label,
                                        boolean ignoreLocale)
                                 throws IOException

Throws:

IOException

findLineByLabel

protected static String findLineByLabel(BufferedReader reader,
                                        String label,
                                        String stopLabel,
                                        boolean ignoreLocale)
                                 throws IOException

Throws:

IOException

getInstance

public static CurveReader getInstance()

As this class uses the singleton pattern, only one instance is created using an empty no-argument constructor.

Returns:

the single instance of this class.

getDelims

public static String getDelims()

Get the standard delimiter chars.

Returns:

delims