//-*- Mode: C++ -*-
// $Id$

#ifndef ALIHLTALTROCHANNELSELECTORCOMPONENT_H
#define ALIHLTALTROCHANNELSELECTORCOMPONENT_H
//* This file is property of and copyright by the ALICE HLT Project        * 
//* ALICE Experiment at CERN, All rights reserved.                         *
//* See cxx source for full Copyright notice                               *

/// @file   AliHLTAltroChannelSelectorComponent.h
/// @author Matthias Richter
/// @date   
/// @brief  A filter/selective readout component for Altro data.
///

// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt   

#include "AliHLTProcessor.h"

class TH1F;

/**
 * @class AliHLTAltroChannelSelectorComponent
 * A selector component for ALTRO Raw data. The component subscribes
 * to the RAW data {***:DDL_RAW }, and produces the same raw data block
 * with only the selected ALTRO channels.                               <br>
 * Three different modes are supported:
 * - -signal-threshold                                                  <br>
 *   the average of all signals in the channel is calculated and it is
 *   selected when the maximum signal exceeds average+threshold
 * - -rms-threshold                                                     <br>
 *   the implemented logic needs to be checked, never been used
 * - list of channels to select. 
 *   The list must be of identical specification as the RAW data and of
 *   data type {***:HWADDR16}: 16 bit hardware addresses
 *
 *
 * The AliAltroRawStreamV3 is used as input decoder to read and scan the
 * Altro Raw data.
 * 
 * <h2>General properties:</h2>
 *
 * Component ID: \b AltroChannelSelector                                <br>
 * Library: \b libAliHLTRCU                                             <br>
 * Input Data Types: kAliHLTDataTypeDDLRaw, kAliHLTDataTypeHwAddr16	<br>
 * Output Data Types: kAliHLTDataTypeDDLRaw                             <br>
 *
 * Mandatory arguments: <br>
 * <!-- NOTE: ignore the \li. <i> and </i>: it's just doxygen formatting -->
 *
 * Optional arguments: <br>
 * <!-- NOTE: ignore the \li. <i> and </i>: it's just doxygen formatting -->
 * \li -keep-corrupted
 *     keep corrupted channels, by default ignored
 * \li -talkative
 *     be a bit more verbose, prints out statistics message and warnings
 * \li -start-timebin <i> bin </i>
 *     all time bins below will be ignored    
 * \li -end-timebin <i> bin </i>
 *     all time bins above will be ignored    
 * \li -signal-threshold <i> adc_counts </i>
 *     the average will be calculated from all bins between start and end,
 *     a channel is considered active if the maximum is bigger than averge
 *     plus threshold
 * \li -rms-threshold <i> sigma </i>
 *
 * @ingroup alihlt_rcu_components
 */
class AliHLTAltroChannelSelectorComponent : public AliHLTProcessor {
 public:
  /** default constructor */
  AliHLTAltroChannelSelectorComponent();
  /** destructor */
  virtual ~AliHLTAltroChannelSelectorComponent();

  // interface functions: property getters
  const char* GetComponentID();
  void GetInputDataTypes(AliHLTComponentDataTypeList& list);
  AliHLTComponentDataType GetOutputDataType();
  void GetOutputDataSize(unsigned long& constBase, double& inputMultiplier);
  AliHLTComponent* Spawn();

 protected:
  // interface functions: processing
  int DoInit(int argc, const char** argv);
  int DoDeinit();
  int DoEvent(const AliHLTComponentEventData& evtData,
	      const AliHLTComponentBlockData* blocks, 
	      AliHLTComponentTriggerData& trigData,
	      AliHLTUInt8_t* outputPtr, 
	      AliHLTUInt32_t& size,
	      AliHLTComponentBlockDataList& outputBlocks );

 
 private:
  /** copy constructor prohibited */
  AliHLTAltroChannelSelectorComponent(const AliHLTAltroChannelSelectorComponent&);
  /** assignment operator prohibited */
  AliHLTAltroChannelSelectorComponent& operator=(const AliHLTAltroChannelSelectorComponent&);

  /** skip corrupted channels */
  bool fSkipCorrupted; //!transient

  /** more verbose output */
  bool fTalkative; //!transient

  unsigned int fStartTimeBin; //!transient
  unsigned int fEndTimeBin; //!transient
  unsigned int fSignalThreshold; //!transient
  float fRMSThreshold; //!transient
  bool fMakeHistogram; //!transient
  
  TH1F *fhThreshold;//! Histgram of the "threshold value" 
  TH1F *fhRMS;//! Histgrams of the "RMS value"

  ClassDef(AliHLTAltroChannelSelectorComponent, 0);
};

#endif