// @(#)root/tmva $Id$ 
// Author: Andreas Hoecker, Joerg Stelzer, Helge Voss, Kai Voss 

/**********************************************************************************
 * Project: TMVA - a Root-integrated toolkit for multivariate data analysis       *
 * Package: TMVA                                                                  *
 * Class  : GiniIndexWithLaplace                                                  *
 * Web    : http://tmva.sourceforge.net                                           *
 *                                                                                *
 * Description: Implementation of the GiniIndex With Laplace correction           *
 *              as separation criterion                                           *
 *                                                                                *
 * Authors (alphabetical):                                                        *
 *      Andreas Hoecker <Andreas.Hocker@cern.ch> - CERN, Switzerland              *
 *      Helge Voss      <Helge.Voss@cern.ch>     - MPI-K Heidelberg, Germany      *
 *      Kai Voss        <Kai.Voss@cern.ch>       - U. of Victoria, Canada         *
 *                                                                                *
 * Copyright (c) 2005:                                                            *
 *      CERN, Switzerland                                                         * 
 *      U. of Victoria, Canada                                                    * 
 *      Heidelberg U., Germany                                                    * 
 *                                                                                *
 * Redistribution and use in source and binary forms, with or without             *
 * modification, are permitted according to the terms listed in LICENSE           *
 * (http://ttmva.sourceforge.net/LICENSE)                                         *
 **********************************************************************************/

#ifndef ROOT_TMVA_GiniIndexWithLaplace
#define ROOT_TMVA_GiniIndexWithLaplace

//////////////////////////////////////////////////////////////////////////
//                                                                      //
// GiniIndexWithLaplace                                                 //
//                                                                      //
// Implementation of the GiniIndex With Laplace correction              // 
//     as separation criterion                                          //
//                                                                      //
//     Large Gini Indices (maximum 0.5) mean , that the sample is well  //
//     mixed (same amount of signal and bkg)                            //
//     bkg. Small Indices mean, well separated.                         //
//     general defniniton:                                              //     
//     Gini(Sample M) = 1 - (c(1)/N)^2 - (c(2)/N)^2 .... - (c(k)/N)^2   // 
//     Where: M is a smaple of whatever N elements (events)             //
//            that belong to K different classes                        //
//            c(k) is the number of elements that belong to class k     //
//     for just Signal and Background classes this boils down to:       //
//     the "Lapalace correction to the probability distribution would   //
//       turn the c(1)/N into (c(1)+1)/(N+2)                            //
//     using this the simple Gini Index  for two classes                //
//               Gini(Sample) = 2s*b/(s+b)^2                            //  
//       turns into                                                     //
//        GiniLaplace(Sample) = 2(s*b+s+b+1)/(s+b+2)^2                  //  
//////////////////////////////////////////////////////////////////////////

#ifndef ROOT_TMVA_SeparationBase
#include "TMVA/SeparationBase.h"
#endif

namespace TMVA {

   class GiniIndexWithLaplace : public SeparationBase {
      
   public:
      
      // construtor for the GiniIndexWithLaplace
      GiniIndexWithLaplace() { fName="GiniLaplace"; }

      // copy constructor
      GiniIndexWithLaplace( const GiniIndexWithLaplace& g): SeparationBase(g) {}

      //destructor
      virtual ~GiniIndexWithLaplace(){}
      
      // Return the separation index (a measure for "purity" of the sample")
      virtual Double_t GetSeparationIndex( const Double_t &s, const Double_t &b );

   protected:
      
      ClassDef(GiniIndexWithLaplace,0) // Implementation of the GiniIndexWithLaplace as separation criterion
   };  

} // namespace TMVA

#endif

 GiniIndexWithLaplace.h:1
 GiniIndexWithLaplace.h:2
 GiniIndexWithLaplace.h:3
 GiniIndexWithLaplace.h:4
 GiniIndexWithLaplace.h:5
 GiniIndexWithLaplace.h:6
 GiniIndexWithLaplace.h:7
 GiniIndexWithLaplace.h:8
 GiniIndexWithLaplace.h:9
 GiniIndexWithLaplace.h:10
 GiniIndexWithLaplace.h:11
 GiniIndexWithLaplace.h:12
 GiniIndexWithLaplace.h:13
 GiniIndexWithLaplace.h:14
 GiniIndexWithLaplace.h:15
 GiniIndexWithLaplace.h:16
 GiniIndexWithLaplace.h:17
 GiniIndexWithLaplace.h:18
 GiniIndexWithLaplace.h:19
 GiniIndexWithLaplace.h:20
 GiniIndexWithLaplace.h:21
 GiniIndexWithLaplace.h:22
 GiniIndexWithLaplace.h:23
 GiniIndexWithLaplace.h:24
 GiniIndexWithLaplace.h:25
 GiniIndexWithLaplace.h:26
 GiniIndexWithLaplace.h:27
 GiniIndexWithLaplace.h:28
 GiniIndexWithLaplace.h:29
 GiniIndexWithLaplace.h:30
 GiniIndexWithLaplace.h:31
 GiniIndexWithLaplace.h:32
 GiniIndexWithLaplace.h:33
 GiniIndexWithLaplace.h:34
 GiniIndexWithLaplace.h:35
 GiniIndexWithLaplace.h:36
 GiniIndexWithLaplace.h:37
 GiniIndexWithLaplace.h:38
 GiniIndexWithLaplace.h:39
 GiniIndexWithLaplace.h:40
 GiniIndexWithLaplace.h:41
 GiniIndexWithLaplace.h:42
 GiniIndexWithLaplace.h:43
 GiniIndexWithLaplace.h:44
 GiniIndexWithLaplace.h:45
 GiniIndexWithLaplace.h:46
 GiniIndexWithLaplace.h:47
 GiniIndexWithLaplace.h:48
 GiniIndexWithLaplace.h:49
 GiniIndexWithLaplace.h:50
 GiniIndexWithLaplace.h:51
 GiniIndexWithLaplace.h:52
 GiniIndexWithLaplace.h:53
 GiniIndexWithLaplace.h:54
 GiniIndexWithLaplace.h:55
 GiniIndexWithLaplace.h:56
 GiniIndexWithLaplace.h:57
 GiniIndexWithLaplace.h:58
 GiniIndexWithLaplace.h:59
 GiniIndexWithLaplace.h:60
 GiniIndexWithLaplace.h:61
 GiniIndexWithLaplace.h:62
 GiniIndexWithLaplace.h:63
 GiniIndexWithLaplace.h:64
 GiniIndexWithLaplace.h:65
 GiniIndexWithLaplace.h:66
 GiniIndexWithLaplace.h:67
 GiniIndexWithLaplace.h:68
 GiniIndexWithLaplace.h:69
 GiniIndexWithLaplace.h:70
 GiniIndexWithLaplace.h:71
 GiniIndexWithLaplace.h:72
 GiniIndexWithLaplace.h:73
 GiniIndexWithLaplace.h:74
 GiniIndexWithLaplace.h:75
 GiniIndexWithLaplace.h:76
 GiniIndexWithLaplace.h:77
 GiniIndexWithLaplace.h:78
 GiniIndexWithLaplace.h:79
 GiniIndexWithLaplace.h:80
 GiniIndexWithLaplace.h:81
 GiniIndexWithLaplace.h:82
 GiniIndexWithLaplace.h:83
 GiniIndexWithLaplace.h:84
 GiniIndexWithLaplace.h:85