Class Histogram

  • All Implemented Interfaces:
    CleanUpHandler, Destroyable, GlobalInfoSupporter, LoggingLevelHandler, LoggingSupporter, OptionHandler, ShallowCopySupporter<AbstractImageFeatureGenerator>, SizeOfHandler, Serializable, Comparable

    public class Histogram
    extends AbstractBufferedImageFeatureGenerator
    Turns an image into a histogram.
    In case of an 8-bit histogram, the image must already be converted to a gray image.
    The number of bins per channel can be chosen as well (1-256).

    -logging-level <OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST> (property: loggingLevel)
        The logging level for outputting errors and debugging output.
        default: WARNING
     
    -converter <adams.data.featureconverter.AbstractFeatureConverter> (property: converter)
        The feature converter to use to produce the output data.
        default: adams.data.featureconverter.SpreadSheet -data-row-type adams.data.spreadsheet.DenseDataRow -spreadsheet-type adams.data.spreadsheet.DefaultSpreadSheet
     
    -prefix <java.lang.String> (property: prefix)
        The (optional) prefix to use for the feature names.
        default: 
     
    -field <adams.data.report.Field> [-field ...] (property: fields)
        The fields to add to the output.
        default: 
     
    -notes <adams.core.base.BaseString> [-notes ...] (property: notes)
        The notes to add as attributes to the generated data, eg 'PROCESS INFORMATION'
        .
        default: 
     
    -histo-type <EIGHT_BIT|RGB> (property: histogramType)
        The type of histogram to generate.
        default: RGB
     
    -num-bins <int> (property: numBins)
        The number of bins per channel (1-256).
        default: 256
        minimum: 1
        maximum: 256
     
    -group-channels <boolean> (property: groupChannels)
        If enabled, grouping is by channel rather than by bin.
        default: false
     
    Version:
    $Revision$
    Author:
    fracpete (fracpete at waikato dot ac dot nz), Dale (dale at cs dot waikato dot ac dot nz)
    See Also:
    Serialized Form
    • Field Detail

      • m_NumBins

        protected int m_NumBins
        the number of bins per channel.
      • m_GroupChannels

        protected boolean m_GroupChannels
        whether to group the channels.
    • Constructor Detail

      • Histogram

        public Histogram()
    • Method Detail

      • setHistogramType

        public void setHistogramType​(Histogram.HistogramType value)
        Sets the type of histogram to generate.
        Parameters:
        value - the type
      • getHistogramType

        public Histogram.HistogramType getHistogramType()
        Returns the type of histogram to generate.
        Returns:
        the type
      • histogramTypeTipText

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

        public void setNumBins​(int value)
        Sets the number of bins to use per channel.
        Parameters:
        value - the number of bins
      • getNumBins

        public int getNumBins()
        Returns the number of bins to use per channel.
        Returns:
        the number of bins
      • numBinsTipText

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

        public void setGroupChannels​(boolean value)
        Sets the whether to group by channels.
        Parameters:
        value - true if to group by channels
      • getGroupChannels

        public boolean getGroupChannels()
        Returns whether to group by channels.
        Returns:
        true if to group by channels
      • groupChannelsTipText

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

        protected String[] getChannelSuffixes()
        Returns the channel suffixes to use.
        Returns:
        the suffixes