Package adams.data.io.output

Class SimpleSpectrumWriter

  • All Implemented Interfaces:
    adams.core.AdditionalInformationHandler, adams.core.CleanUpHandler, adams.core.Destroyable, adams.core.GlobalInfoSupporter, adams.core.io.FileFormatHandler, adams.core.logging.LoggingLevelHandler, adams.core.logging.LoggingSupporter, adams.core.option.OptionHandler, adams.core.ShallowCopySupporter<adams.data.io.output.DataContainerWriter>, adams.core.SizeOfHandler, adams.data.CompressionSupporter<Spectrum>, adams.data.io.output.DataContainerWriter<Spectrum>, adams.data.io.output.StreamableDataContainerWriter<Spectrum>, adams.data.io.output.StreamableTextBasedDataContainerWriter<Spectrum>, Serializable, Comparable
    public class SimpleSpectrumWriter
extends AbstractSpectrumWriter
implements adams.data.CompressionSupporter<Spectrum>, adams.data.io.output.StreamableTextBasedDataContainerWriter<Spectrum>
    Writer that stores spectra in the simple CSV format.

    Valid options are: 

    -D (property: debug)
         If set to true, scheme may output additional info to the console.
 
    -output <java.io.File> (property: output)
         The file to write the spectrum to.
         default: /tmp/out.spec
    Author:
    fracpete (fracpete at waikato dot ac dot nz)
    See Also:
    Serialized Form

    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected boolean m_OutputSampleData
      whether to output the sample data as well.
      protected boolean m_UseCompression
      whether to use compression.

      • Fields inherited from class adams.data.io.output.AbstractDataContainerWriter

        m_Output, m_OutputIsFile

      • Fields inherited from class adams.core.option.AbstractOptionHandler

        m_OptionManager

      • Fields inherited from class adams.core.logging.LoggingObject

        m_Logger, m_LoggingIsEnabled, m_LoggingLevel

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean canWriteMultiple()
      Returns whether writing of multiple containers is supported.
      void defineOptions()
      Adds options to the internal list of options.
      String getFormatDescription()
      Returns a string describing the format (used in the file chooser).
      String[] getFormatExtensions()
      Returns the extension(s) of the format.
      boolean getOutputSampleData()
      Returns whether to output eh sample data as well.
      boolean getUseCompression()
      Returns whether compression is in use.
      String globalInfo()
      Returns a string describing the object.
      protected void initialize()
      Initializes the members.
      String outputSampleDataTipText()
      Returns the tip text for this property.
      void setOutputSampleData​(boolean value)
      Sets whether to output the sample data as well.
      void setUseCompression​(boolean value)
      Sets whether to use compression.
      String useCompressionTipText()
      Returns the tip text for this property.
      boolean write​(OutputStream stream, Spectrum data)
      Performs checks and writes the data to the stream.
      boolean write​(OutputStream stream, List<Spectrum> data)
      Performs checks and writes the data to the stream.
      protected boolean write​(List<Spectrum> data, BufferedWriter writer, boolean report)
      Writes its content with the given writer.
      protected boolean write​(List<Spectrum> data, String filename, boolean report)
      Writes its content to the given file.
      protected boolean writeData​(List<Spectrum> data)
      Performs the actual writing.

      • Methods inherited from class adams.data.io.output.AbstractDataContainerWriter

        checkData, cleanUp, compareTo, destroy, equals, forCommandLine, forName, getAdditionalInformation, getDefaultFormatExtension, getOutput, isOutputFile, reset, setOutput, shallowCopy, shallowCopy, write, write

      • Methods inherited from class adams.core.option.AbstractOptionHandler

        cleanUpOptions, finishInit, getDefaultLoggingLevel, getOptionManager, loggingLevelTipText, newOptionManager, setLoggingLevel, toCommandLine, toString

      • Methods inherited from class adams.core.logging.LoggingObject

        configureLogger, getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled, sizeOf

      • Methods inherited from interface adams.core.AdditionalInformationHandler

        getAdditionalInformation

      • Methods inherited from interface adams.core.CleanUpHandler

        cleanUp

      • Methods inherited from interface adams.data.io.output.DataContainerWriter

        getOutput, isOutputFile, outputTipText, setOutput, write, write

      • Methods inherited from interface adams.core.Destroyable

        destroy

      • Methods inherited from interface adams.core.io.FileFormatHandler

        getDefaultFormatExtension

      • Methods inherited from interface adams.core.logging.LoggingLevelHandler

        getLoggingLevel

      • Methods inherited from interface adams.core.option.OptionHandler

        cleanUpOptions, getOptionManager, toCommandLine

      • Methods inherited from interface adams.core.ShallowCopySupporter

        shallowCopy, shallowCopy

    • Field Detail

      • m_OutputSampleData

        protected boolean m_OutputSampleData
        whether to output the sample data as well.

      • m_UseCompression

        protected boolean m_UseCompression
        whether to use compression.

    • Constructor Detail

      • SimpleSpectrumWriter

        public SimpleSpectrumWriter()

    • Method Detail

      • globalInfo

        public String globalInfo()
        Returns a string describing the object.
        Specified by:
        globalInfo in interface adams.core.GlobalInfoSupporter
        Specified by:
        globalInfo in class adams.core.option.AbstractOptionHandler
        Returns:
        a description suitable for displaying in the gui

      • defineOptions

        public void defineOptions()
        Adds options to the internal list of options.
        Specified by:
        defineOptions in interface adams.core.option.OptionHandler
        Overrides:
        defineOptions in class adams.data.io.output.AbstractDataContainerWriter<Spectrum>

      • getFormatDescription

        public String getFormatDescription()
        Returns a string describing the format (used in the file chooser).
        Specified by:
        getFormatDescription in interface adams.core.io.FileFormatHandler
        Specified by:
        getFormatDescription in class adams.data.io.output.AbstractDataContainerWriter<Spectrum>
        Returns:
        a description suitable for displaying in the file chooser

      • getFormatExtensions

        public String[] getFormatExtensions()
        Returns the extension(s) of the format.
        Specified by:
        getFormatExtensions in interface adams.core.io.FileFormatHandler
        Specified by:
        getFormatExtensions in class adams.data.io.output.AbstractDataContainerWriter<Spectrum>
        Returns:
        the extension(s) (without the dot!)

      • setOutputSampleData

        public void setOutputSampleData​(boolean value)
        Sets whether to output the sample data as well.
        Parameters:
        value - if true then the sample data gets output as well

      • getOutputSampleData

        public boolean getOutputSampleData()
        Returns whether to output eh sample data as well.
        Returns:
        true if the sample data is output as well

      • outputSampleDataTipText

        public String outputSampleDataTipText()
        Returns the tip text for this property.
        Returns:
        tip text for this property suitable for displaying in the GUI or for listing the options.

      • setUseCompression

        public void setUseCompression​(boolean value)
        Sets whether to use compression.
        Specified by:
        setUseCompression in interface adams.data.CompressionSupporter<Spectrum>
        Parameters:
        value - true if to use compression

      • getUseCompression

        public boolean getUseCompression()
        Returns whether compression is in use.
        Specified by:
        getUseCompression in interface adams.data.CompressionSupporter<Spectrum>
        Returns:
        true if compression is used

      • useCompressionTipText

        public String useCompressionTipText()
        Returns the tip text for this property.
        Specified by:
        useCompressionTipText in interface adams.data.CompressionSupporter<Spectrum>
        Returns:
        tip text for this property suitable for displaying in the GUI or for listing the options.

      • initialize

        protected void initialize()
        Initializes the members.
        Overrides:
        initialize in class adams.core.option.AbstractOptionHandler

      • canWriteMultiple

        public boolean canWriteMultiple()
        Returns whether writing of multiple containers is supported.
        Specified by:
        canWriteMultiple in interface adams.data.io.output.DataContainerWriter<Spectrum>
        Overrides:
        canWriteMultiple in class AbstractSpectrumWriter
        Returns:
        true if multiple containers are supported

      • write

        protected boolean write​(List<Spectrum> data,
                        BufferedWriter writer,
                        boolean report)
        Writes its content with the given writer.
        Parameters:
        data - the spectra to write
        writer - the writer to use
        report - whether to output the report as well
        Returns:
        true if successfully written

      • write

        protected boolean write​(List<Spectrum> data,
                        String filename,
                        boolean report)
        Writes its content to the given file.
        Parameters:
        data - the spectra to write
        filename - the file to write to
        report - whether to output the report as well
        Returns:
        true if successfully written

      • writeData

        protected boolean writeData​(List<Spectrum> data)
        Performs the actual writing.
        Specified by:
        writeData in class adams.data.io.output.AbstractDataContainerWriter<Spectrum>
        Parameters:
        data - the data to write
        Returns:
        true if successfully written

      • write

        public boolean write​(OutputStream stream,
                     Spectrum data)
        Performs checks and writes the data to the stream.
        Specified by:
        write in interface adams.data.io.output.StreamableDataContainerWriter<Spectrum>
        Parameters:
        stream - the stream to write to
        data - the data to write
        Returns:
        true if successfully written
        See Also:
        write(OutputStream stream, List)

      • write

        public boolean write​(OutputStream stream,
                     List<Spectrum> data)
        Performs checks and writes the data to the stream.
        Specified by:
        write in interface adams.data.io.output.StreamableDataContainerWriter<Spectrum>
        Parameters:
        stream - the stream to write to
        data - the data to write
        Returns:
        true if successfully written