DBTranslator4RangeVariable.h

Go to the documentation of this file.

/***************************************************************************
 *   Copyright (C) 2005 by Christophe GONZALES and Pierre-Henri WUILLEMIN  *
 *   {prenom.nom}_at_lip6.fr                                               *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/
#ifndef GUM_LEARNING_DB_TRANSLATOR_4_RANGE_VARIABLE_H
#define GUM_LEARNING_DB_TRANSLATOR_4_RANGE_VARIABLE_H

#include <agrum/agrum.h>
#include <agrum/core/hashTable.h>
#include <agrum/core/set.h>
#include <agrum/learning/database/DBTranslator.h>
#include <agrum/variables/rangeVariable.h>


namespace gum {

  namespace learning {


    template < template < typename > class ALLOC = std::allocator >
    class DBTranslator4RangeVariable : public DBTranslator< ALLOC > {
      public:
      using allocator_type = typename DBTranslator< ALLOC >::allocator_type;


      // ##########################################################################
      // ##########################################################################



      template < template < typename > class XALLOC >
      DBTranslator4RangeVariable(
         const std::vector< std::string, XALLOC< std::string > >& missing_symbols,
         std::size_t max_dico_entries = std::numeric_limits< std::size_t >::max(),
         const allocator_type& alloc = allocator_type());


      DBTranslator4RangeVariable(
         std::size_t max_dico_entries = std::numeric_limits< std::size_t >::max(),
         const allocator_type& alloc = allocator_type());


      template < template < typename > class XALLOC >
      DBTranslator4RangeVariable(
         const RangeVariable&                                     var,
         const std::vector< std::string, XALLOC< std::string > >& missing_symbols,
         const bool  editable_dictionary = false,
         std::size_t max_dico_entries = std::numeric_limits< std::size_t >::max(),
         const allocator_type& alloc = allocator_type());

      DBTranslator4RangeVariable(
         const RangeVariable& var,
         const bool           editable_dictionary = false,
         std::size_t max_dico_entries = std::numeric_limits< std::size_t >::max(),
         const allocator_type& alloc = allocator_type());

      DBTranslator4RangeVariable(const DBTranslator4RangeVariable< ALLOC >& from);

      DBTranslator4RangeVariable(const DBTranslator4RangeVariable< ALLOC >& from,
                                 const allocator_type&                      alloc);

      DBTranslator4RangeVariable(DBTranslator4RangeVariable< ALLOC >&& from);

      DBTranslator4RangeVariable(DBTranslator4RangeVariable< ALLOC >&& from,
                                 const allocator_type&                 alloc);

      virtual DBTranslator4RangeVariable< ALLOC >* clone() const;

      virtual DBTranslator4RangeVariable< ALLOC >*
         clone(const allocator_type& alloc) const;

      virtual ~DBTranslator4RangeVariable();



      // ##########################################################################
      // ##########################################################################


      DBTranslator4RangeVariable< ALLOC >&
         operator=(const DBTranslator4RangeVariable< ALLOC >& from);

      DBTranslator4RangeVariable< ALLOC >&
         operator=(DBTranslator4RangeVariable< ALLOC >&& from);



      // ##########################################################################
      // ##########################################################################



      virtual DBTranslatedValue translate(const std::string& str) final;


      virtual std::string
         translateBack(const DBTranslatedValue translated_val) const final;


      virtual std::size_t domainSize() const final;

      virtual bool needsReordering() const final;

      virtual HashTable< std::size_t,
                         std::size_t,
                         ALLOC< std::pair< std::size_t, std::size_t > > >
         reorder() final;

      virtual const RangeVariable* variable() const final;

      virtual DBTranslatedValue missingValue() const final;



#ifndef DOXYGEN_SHOULD_SKIP_THIS

      private:
      // the RangeVariable assigned to the translator, if any
      RangeVariable __variable;

      // assign to each integer missing symbol a Boolean indicating whether
      // we already translated it or not. If we translated it, then we cannot
      // change the range of the variable so that this range contains the symbol.
      HashTable< std::string, bool, ALLOC< std::pair< std::string, bool > > >
         __status_int_missing_symbols;

      // the set of translations of the integer missing symbols found so far
      Set< long, ALLOC< long > > __translated_int_missing_symbols;

      // a string containing a non int missing symbol
      // (useful for back translations)
      std::string __nonint_missing_symbol;

#endif /* DOXYGEN_SHOULD_SKIP_THIS */
    };


  } /* namespace learning */

} /* namespace gum */


// always include the template implementation
#include <agrum/learning/database/DBTranslator4RangeVariable_tpl.h>

#endif /* GUM_LEARNING_DB_TRANSLATOR_4_RANGE_VARIABLE_H */