preprocessor/include/VariableTable.hh

/*
 * Copyright (C) 2003-2008 Dynare Team
 *
 * This file is part of Dynare.
 *
 * Dynare 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 3 of the License, or
 * (at your option) any later version.
 *
 * Dynare 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 Dynare.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef _VARIABLETABLE_HH
#define _VARIABLETABLE_HH

using namespace std;

#include <map>
#include <vector>

#include "SymbolTable.hh"

//! Used to keep track of variables in the sense of the models, i.e. pairs (symbol, lead/lag)
/*! Warning: some methods access variables through the tuple (type, symbol_id, lag), but internally the class uses a lexicographic order over (type, lag, symbol_id) */
class VariableTable
{
private:
  //! A reference to the symbol table
  const SymbolTable &symbol_table;
  //! A variable is a tuple (type, lag, symbol_id)
  /*! Warning: don't change the order of elements in the tuple, since this determines the lexicographic ordering in sort() */
  typedef pair<pair<Type, int>, int> var_key_type;

  typedef map<var_key_type, int> variable_table_type;
  //! Maps a tuple (type, lag, symbol_id) to a variable ID
  variable_table_type variable_table;

  typedef map<int, var_key_type> inv_variable_table_type;
  //! Maps a variable ID to a tuple (type, lag, symbol_id)
  inv_variable_table_type inv_variable_table;
  //! Contains the sorted IDs (indexed by variable IDs)
  vector<int> sorted_ids_table;
public:
  VariableTable(const SymbolTable &symbol_table_arg);
  //! Number of dynamic endogenous variables inside the model block
  int var_endo_nbr;
  //! Number of dynamic exogenous variables inside the model block
  int var_exo_nbr;
  //! Number of dynamic deterministic exogenous variables inside the model block
  int var_exo_det_nbr;
  //! Maximum lag over all types of variables (positive value)
  int max_lag;
  //! Maximum lead over all types of variables
  int max_lead;
  //! Maximum lag over endogenous variables (positive value)
  int max_endo_lag;
  //! Maximum lead over endogenous variables
  int max_endo_lead;
  //! Maximum lag over exogenous variables (positive value)
  int max_exo_lag;
  //! Maximum lead over exogenous variables
  int max_exo_lead;
  //! Maximum lag over deterministic exogenous variables (positive value)
  int max_exo_det_lag;
  //! Maximum lead over deterministic exogenous variables
  int max_exo_det_lead;
  //! Maximum lag over recursive variables (positive value)
  int max_recur_lag;
  //! Maximum lead over recursive variables
  int max_recur_lead;
  //! Thrown when trying to access an unknown variable by (type, symb_id, lag)
  class UnknownVariableKeyException
  {
  public:
    Type type;
    int symb_id, lag;
    UnknownVariableKeyException(Type type_arg, int symb_id_arg, int lag_arg) : type(type_arg), symb_id(symb_id_arg), lag(lag_arg) {}
  };
  //! Thrown when trying to access an unknown variable by var_id
  class UnknownVariableIDException
  {
  public:
    //! Variable ID
    int id;
    UnknownVariableIDException(int id_arg) : id(id_arg) {}
  };
  //! Thrown when getSortID() called before sort()
  class NotYetSortedException
  {
  };
  //! Thrown when sort() or addVariable() called after sort()
  class AlreadySortedException
  {
  };
  //! Adds a variable in the table, and returns its (newly allocated) variable ID
  /*! Also works if the variable already exists */
  int addVariable(Type type, int symb_id, int lag) throw (AlreadySortedException);
  //! Return variable ID
  inline int getID(Type type, int symb_id, int lag) const throw (UnknownVariableKeyException);
  //! Return lag of variable
  inline int getLag(int var_id) const throw (UnknownVariableIDException);
  //! Return symbol ID of variable
  inline int getSymbolID(int var_id) const throw (UnknownVariableIDException);
  //! Get variable type
  inline Type getType(int var_id) const throw (UnknownVariableIDException);
  //! Get number of variables
  inline int size() const;
  //! Get variable ID of sorted variable table
  /*! In practice, only used for endogenous variables */
  inline int getSortID(int var_id) const throw (NotYetSortedException, UnknownVariableIDException);
  //! Sorts variable table
  /*! The order used is a lexicographic order over the tuple (type, lag, symbol_id) */
  void sort() throw (AlreadySortedException);
  //! Get the number of dynamic variables 
  inline int get_dyn_var_nbr() const;
};

inline int
VariableTable::getSortID(int var_id) const throw (NotYetSortedException, UnknownVariableIDException)
{
  if (sorted_ids_table.size() == 0)
    throw NotYetSortedException();

  if (var_id < 0 || var_id >= size())
    throw UnknownVariableIDException(var_id);

  return sorted_ids_table[var_id];
}

inline int
VariableTable::getID(Type type, int symb_id, int lag) const throw (UnknownVariableKeyException)
{
  variable_table_type::const_iterator it = variable_table.find(make_pair(make_pair(type, lag), symb_id));
  if (it == variable_table.end())
    throw UnknownVariableKeyException(type, symb_id, lag);
  else
    return it->second;
}

inline Type
VariableTable::getType(int var_id) const throw (UnknownVariableIDException)
{
  inv_variable_table_type::const_iterator it = inv_variable_table.find(var_id);
  if (it != inv_variable_table.end())
    return it->second.first.first;
  else
    throw UnknownVariableIDException(var_id);
}

inline int
VariableTable::getSymbolID(int var_id) const throw (UnknownVariableIDException)
{
  inv_variable_table_type::const_iterator it = inv_variable_table.find(var_id);
  if (it != inv_variable_table.end())
    return it->second.second;
  else
    throw UnknownVariableIDException(var_id);
}

inline int
VariableTable::getLag(int var_id) const throw (UnknownVariableIDException)
{
  inv_variable_table_type::const_iterator it = inv_variable_table.find(var_id);
  if (it != inv_variable_table.end())
    return it->second.first.second;
  else
    throw UnknownVariableIDException(var_id);
}

inline int
VariableTable::size() const
{
  return variable_table.size();
}

inline int 
VariableTable::get_dyn_var_nbr() const
{
  return var_endo_nbr + symbol_table.exo_nbr + symbol_table.exo_det_nbr;
}

#endif