DBTranslator4RangeVariable.h

Go to the documentation of this file.

#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 */