Package pulse.io.readers

Class LFRReader

  • All Implemented Interfaces:
    AbstractHandler, AbstractReader<List<ExperimentalData>>, CurveReader, Reflexive
    public class LFRReader
extends Object
implements CurveReader
    A CurveReader capable of reading ASCII master-files generated by the Linseis software.

    An .lfr file contains a table with filenames of individual experimental heating curves, their respective IDs (as they appear in the Linseis software), test temperatures, and other variables. The individual ASCII files encoded in ASCII represent tab-delimited time-temperature data.

    PULsE currently accepts the formats of only those files output by Linseis LFA systems that are in ASCII formats, so results from other systems may be edited to be readable by PULsE. Linseis automatically outputs .lf files for each shot, containing information about the shot. However, these are binary files with an unknown format. Therefore, after performing a shot, clicking “Export/Save As” in the Linseis AproSoft program will export the data for the heating curve recorded as a .txt file (in a readable format). This should be done for any shot or curve you wish to analyse in PULsE.

    After all shots have been recorded, click “Severals” in the Linseis analysis window and select all exported heating curve .txt files for the experiment. Clicking “Ok” and “Save” on the following windows will create a .lfr file with file locations and data for all the heating curves. Save this in the same folder as the .txt files.

    • Method Detail

      • 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 (.lfr).

      • read

        public List<ExperimentalData> read​(File file)
                            throws IOException
        Reads through the file, identifies the names of other files with individual heating curves, theirs external IDs and test temperatures (in degrees Celsius, later converted to Kelvin).

        Creates a List of ExperimentalData objects with the size equal to the number of individual entries in the master-file. Searches for the individual files listed in the namelist and stored in the same directory where the master-file has been found previously. Upon finding the individual files, invokes readSingleCurve on each of them sequentially and stores the ExperimentalData in a list. Finally, invokes the sort method on that list to sort it.

        Specified by:
        read in interface AbstractReader<List<ExperimentalData>>
        Specified by:
        read in interface CurveReader
        Parameters:
        file - the master-file with .lfr suffix
        Returns:
        a List of @code ExperimentalData}, containing all information stored in both the master file and linked individual files.
        Throws:
        IOException - if something goes wrong with reading the file
        See Also:
        CurveReader.sort(java.util.List<pulse.input.ExperimentalData>), readSingleCurve(java.io.File,pulse.input.Metadata)

      • readSingleCurve

        public ExperimentalData readSingleCurve​(File file,
                                        Metadata metadata)
                                 throws IOException
        Creates a single ExperimentalData object with the time-temperature information retrieved from file and using the previously generated Metadata object, containing the external ID and the test temperature of this heating curve.

        The time in Linseis files is usually stored in [ms], hence the time values are multiplied by 1E-3 to adhere to the PULsE format. The signal rise is recorded in [mV], hence it represents a relative scale, which however is functionally linked to the temperature rise. PULsE does not establish this functional relation. Instead, it uses the signal values in the dimensionless problem formulation.

        Parameters:
        file - the file with a data just enough for a single ExperimentalData object
        metadata - the previously loaded Metadata which includes the external ID and the test temperature
        Returns:
        an ExperimentalData object
        Throws:
        IOException

      • getInstance

        public static CurveReader getInstance()
        Retrieves the single instance of this class. As this class uses a singleton pattern, there is only one such instance.
        Returns:
        the single instance of this class.