gtsam/wrap/Class.cpp

/* ---------------------------------------------------------------------------- 
 
 * GTSAM Copyright 2010, Georgia Tech Research Corporation,  
 * Atlanta, Georgia 30332-0415
 * All Rights Reserved 
 * Authors: Frank Dellaert, et al. (see THANKS for the full author list) 
 
 * See LICENSE for the license information 
 
 * -------------------------------------------------------------------------- */

/** 
 * @file Class.cpp 
 * @author Frank Dellaert 
 * @author Andrew Melim 
 * @author Richard Roberts
 **/

#include "Class.h"
#include "utilities.h"
#include "Argument.h"

#include <boost/foreach.hpp>
#include <boost/lexical_cast.hpp>
#include <boost/range/adaptor/map.hpp>
#include <boost/range/algorithm/copy.hpp>

#include <vector> 
#include <iostream> 
#include <fstream> 
#include <iterator>     // std::ostream_iterator
//#include <cstdint> // on Linux GCC: fails with error regarding needing C++0x std flags 
//#include <cinttypes> // same failure as above 
#include <stdint.h> // works on Linux GCC 
using namespace std;
using namespace wrap;

/* ************************************************************************* */
void Class::assignParent(const Qualified& parent) {
  parentClass.reset(parent);
}

/* ************************************************************************* */
boost::optional<string> Class::qualifiedParent() const {
  boost::optional<string> result = boost::none;
  if (parentClass)
    result = parentClass->qualifiedName("::");
  return result;
}

/* ************************************************************************* */
static void handleException(const out_of_range& oor,
    const Class::Methods& methods) {
  cerr << "Class::method: key not found: " << oor.what() << ", methods are:\n";
  using boost::adaptors::map_keys;
  ostream_iterator<string> out_it(cerr, "\n");
  boost::copy(methods | map_keys, out_it);
}

/* ************************************************************************* */
Method& Class::mutableMethod(Str key) {
  try {
    return methods_.at(key);
  } catch (const out_of_range& oor) {
    handleException(oor, methods_);
    throw runtime_error("Internal error in wrap");
  }
}

/* ************************************************************************* */
const Method& Class::method(Str key) const {
  try {
    return methods_.at(key);
  } catch (const out_of_range& oor) {
    handleException(oor, methods_);
    throw runtime_error("Internal error in wrap");
  }
}

/* ************************************************************************* */
void Class::matlab_proxy(Str toolboxPath, Str wrapperName,
    const TypeAttributesTable& typeAttributes, FileWriter& wrapperFile,
    vector<string>& functionNames) const {

  // Create namespace folders 
  createNamespaceStructure(namespaces(), toolboxPath);

  // open destination classFile 
  string classFile = matlabName(toolboxPath);
  FileWriter proxyFile(classFile, verbose_, "%");

  // get the name of actual matlab object 
  const string matlabQualName = qualifiedName(".");
  const string matlabUniqueName = qualifiedName();
  const string cppName = qualifiedName("::");

  // emit class proxy code 
  // we want our class to inherit the handle class for memory purposes 
  const string parent =
      parentClass ? parentClass->qualifiedName(".") : "handle";
  comment_fragment(proxyFile);
  proxyFile.oss << "classdef " << name() << " < " << parent << endl;
  proxyFile.oss << "  properties\n";
  proxyFile.oss << "    ptr_" << matlabUniqueName << " = 0\n";
  proxyFile.oss << "  end\n";
  proxyFile.oss << "  methods\n";

  // Constructor 
  proxyFile.oss << "    function obj = " << name() << "(varargin)\n";
  // Special pointer constructors - one in MATLAB to create an object and 
  // assign a pointer returned from a C++ function.  In turn this MATLAB 
  // constructor calls a special C++ function that just adds the object to 
  // its collector.  This allows wrapped functions to return objects in 
  // other wrap modules - to add these to their collectors the pointer is 
  // passed from one C++ module into matlab then back into the other C++ 
  // module. 
  pointer_constructor_fragments(proxyFile, wrapperFile, wrapperName,
      functionNames);
  wrapperFile.oss << "\n";

  // Regular constructors 
  boost::optional<string> cppBaseName = qualifiedParent();
  for (size_t i = 0; i < constructor.nrOverloads(); i++) {
    ArgumentList args = constructor.argumentList(i);
    const int id = (int) functionNames.size();
    constructor.proxy_fragment(proxyFile, wrapperName, (bool) parentClass, id,
        args);
    const string wrapFunctionName = constructor.wrapper_fragment(wrapperFile,
        cppName, matlabUniqueName, cppBaseName, id, args);
    wrapperFile.oss << "\n";
    functionNames.push_back(wrapFunctionName);
  }
  proxyFile.oss << "      else\n";
  proxyFile.oss << "        error('Arguments do not match any overload of "
      << matlabQualName << " constructor');\n";
  proxyFile.oss << "      end\n";
  if (parentClass)
    proxyFile.oss << "      obj = obj@" << parentClass->qualifiedName(".")
        << "(uint64(" << ptr_constructor_key << "), base_ptr);\n";
  proxyFile.oss << "      obj.ptr_" << matlabUniqueName << " = my_ptr;\n";
  proxyFile.oss << "    end\n\n";

  // Deconstructor 
  {
    const int id = (int) functionNames.size();
    deconstructor.proxy_fragment(proxyFile, wrapperName, matlabUniqueName, id);
    proxyFile.oss << "\n";
    const string functionName = deconstructor.wrapper_fragment(wrapperFile,
        cppName, matlabUniqueName, id);
    wrapperFile.oss << "\n";
    functionNames.push_back(functionName);
  }
  proxyFile.oss
      << "    function display(obj), obj.print(''); end\n    %DISPLAY Calls print on the object\n";
  proxyFile.oss
      << "    function disp(obj), obj.display; end\n    %DISP Calls print on the object\n";

  // Methods 
  BOOST_FOREACH(const Methods::value_type& name_m, methods_) {
    const Method& m = name_m.second;
    m.proxy_wrapper_fragments(proxyFile, wrapperFile, cppName, matlabQualName,
        matlabUniqueName, wrapperName, typeAttributes, functionNames);
    proxyFile.oss << "\n";
    wrapperFile.oss << "\n";
  }
  if (hasSerialization)
    serialization_fragments(proxyFile, wrapperFile, wrapperName, functionNames);

  proxyFile.oss << "  end\n";
  proxyFile.oss << "\n";
  proxyFile.oss << "  methods(Static = true)\n";

  // Static methods 
  BOOST_FOREACH(const StaticMethods::value_type& name_m, static_methods) {
    const StaticMethod& m = name_m.second;
    m.proxy_wrapper_fragments(proxyFile, wrapperFile, cppName, matlabQualName,
        matlabUniqueName, wrapperName, typeAttributes, functionNames);
    proxyFile.oss << "\n";
    wrapperFile.oss << "\n";
  }
  if (hasSerialization)
    deserialization_fragments(proxyFile, wrapperFile, wrapperName,
        functionNames);

  proxyFile.oss << "  end\n";
  proxyFile.oss << "end\n";

  // Close file 
  proxyFile.emit(true);
}

/* ************************************************************************* */
void Class::pointer_constructor_fragments(FileWriter& proxyFile,
    FileWriter& wrapperFile, Str wrapperName,
    vector<string>& functionNames) const {

  const string matlabUniqueName = qualifiedName();
  const string cppName = qualifiedName("::");

  const int collectorInsertId = (int) functionNames.size();
  const string collectorInsertFunctionName = matlabUniqueName
      + "_collectorInsertAndMakeBase_"
      + boost::lexical_cast<string>(collectorInsertId);
  functionNames.push_back(collectorInsertFunctionName);

  int upcastFromVoidId;
  string upcastFromVoidFunctionName;
  if (isVirtual) {
    upcastFromVoidId = (int) functionNames.size();
    upcastFromVoidFunctionName = matlabUniqueName + "_upcastFromVoid_"
        + boost::lexical_cast<string>(upcastFromVoidId);
    functionNames.push_back(upcastFromVoidFunctionName);
  }

  // MATLAB constructor that assigns pointer to matlab object then calls c++ 
  // function to add the object to the collector. 
  if (isVirtual) {
    proxyFile.oss
        << "      if (nargin == 2 || (nargin == 3 && strcmp(varargin{3}, 'void')))";
  } else {
    proxyFile.oss << "      if nargin == 2";
  }
  proxyFile.oss << " && isa(varargin{1}, 'uint64') && varargin{1} == uint64("
      << ptr_constructor_key << ")\n";
  if (isVirtual) {
    proxyFile.oss << "        if nargin == 2\n";
    proxyFile.oss << "          my_ptr = varargin{2};\n";
    proxyFile.oss << "        else\n";
    proxyFile.oss << "          my_ptr = " << wrapperName << "("
        << upcastFromVoidId << ", varargin{2});\n";
    proxyFile.oss << "        end\n";
  } else {
    proxyFile.oss << "        my_ptr = varargin{2};\n";
  }
  if (!parentClass) // If this class has a base class, we'll get a base class pointer back
    proxyFile.oss << "        ";
  else
    proxyFile.oss << "        base_ptr = ";
  proxyFile.oss << wrapperName << "(" << collectorInsertId << ", my_ptr);\n"; // Call collector insert and get base class ptr 

  // C++ function to add pointer from MATLAB to collector.  The pointer always 
  // comes from a C++ return value; this mechanism allows the object to be added 
  // to a collector in a different wrap module.  If this class has a base class, 
  // a new pointer to the base class is allocated and returned. 
  wrapperFile.oss << "void " << collectorInsertFunctionName
      << "(int nargout, mxArray *out[], int nargin, const mxArray *in[])\n";
  wrapperFile.oss << "{\n";
  wrapperFile.oss << "  mexAtExit(&_deleteAllObjects);\n";
  // Typedef boost::shared_ptr 
  wrapperFile.oss << "  typedef boost::shared_ptr<" << cppName << "> Shared;\n";
  wrapperFile.oss << "\n";
  // Get self pointer passed in 
  wrapperFile.oss
      << "  Shared *self = *reinterpret_cast<Shared**> (mxGetData(in[0]));\n";
  // Add to collector 
  wrapperFile.oss << "  collector_" << matlabUniqueName << ".insert(self);\n";
  // If we have a base class, return the base class pointer (MATLAB will call the base class collectorInsertAndMakeBase to add this to the collector and recurse the heirarchy) 
  boost::optional<string> cppBaseName = qualifiedParent();
  if (cppBaseName) {
    wrapperFile.oss << "\n";
    wrapperFile.oss << "  typedef boost::shared_ptr<" << *cppBaseName
        << "> SharedBase;\n";
    wrapperFile.oss
        << "  out[0] = mxCreateNumericMatrix(1, 1, mxUINT32OR64_CLASS, mxREAL);\n";
    wrapperFile.oss
        << "  *reinterpret_cast<SharedBase**>(mxGetData(out[0])) = new SharedBase(*self);\n";
  }
  wrapperFile.oss << "}\n";

  // If this is a virtual function, C++ function to dynamic upcast it from a 
  // shared_ptr<void>.  This mechanism allows automatic dynamic creation of the 
  // real underlying derived-most class when a C++ method returns a virtual 
  // base class. 
  if (isVirtual)
    wrapperFile.oss << "\n"
        "void " << upcastFromVoidFunctionName
        << "(int nargout, mxArray *out[], int nargin, const mxArray *in[]) {\n"
            "  mexAtExit(&_deleteAllObjects);\n"
            "  typedef boost::shared_ptr<" << cppName
        << "> Shared;\n"
            "  boost::shared_ptr<void> *asVoid = *reinterpret_cast<boost::shared_ptr<void>**> (mxGetData(in[0]));\n"
            "  out[0] = mxCreateNumericMatrix(1, 1, mxUINT32OR64_CLASS, mxREAL);\n"
            "  Shared *self = new Shared(boost::static_pointer_cast<" << cppName
        << ">(*asVoid));\n"
            "  *reinterpret_cast<Shared**>(mxGetData(out[0])) = self;\n"
            "}\n";
}

/* ************************************************************************* */
Class Class::expandTemplate(const TemplateSubstitution& ts) const {
  Class inst = *this;
  inst.methods_ = expandMethodTemplate(methods_, ts);
  inst.static_methods = expandMethodTemplate(static_methods, ts);
  inst.constructor = constructor.expandTemplate(ts);
  inst.deconstructor.name = inst.name();
  return inst;
}

/* ************************************************************************* */
vector<Class> Class::expandTemplate(Str templateArg,
    const vector<Qualified>& instantiations) const {
  vector<Class> result;
  BOOST_FOREACH(const Qualified& instName, instantiations) {
    Qualified expandedClass = (Qualified) (*this);
    expandedClass.expand(instName.name());
    const TemplateSubstitution ts(templateArg, instName, expandedClass);
    Class inst = expandTemplate(ts);
    inst.name_ = expandedClass.name();
    inst.templateArgs.clear();
    inst.typedefName = qualifiedName("::") + "<" + instName.qualifiedName("::")
        + ">";
    result.push_back(inst);
  }
  return result;
}

/* ************************************************************************* */
void Class::addMethod(bool verbose, bool is_const, Str methodName,
    const ArgumentList& argumentList, const ReturnValue& returnValue,
    const Template& tmplate) {
  // Check if templated
  if (tmplate.valid()) {
    // Create method to expand
    // For all values of the template argument, create a new method
    BOOST_FOREACH(const Qualified& instName, tmplate.argValues()) {
      const TemplateSubstitution ts(tmplate.argName(), instName, *this);
      // substitute template in arguments
      ArgumentList expandedArgs = argumentList.expandTemplate(ts);
      // do the same for return type
      ReturnValue expandedRetVal = returnValue.expandTemplate(ts);
      // Now stick in new overload stack with expandedMethodName key
      // but note we use the same, unexpanded methodName in overload
      string expandedMethodName = methodName + instName.name();
      methods_[expandedMethodName].addOverload(methodName, expandedArgs,
          expandedRetVal, is_const, instName, verbose);
    }
  } else
    // just add overload
    methods_[methodName].addOverload(methodName, argumentList, returnValue,
        is_const, boost::none, verbose);
}

/* ************************************************************************* */
void Class::erase_serialization() {
  Methods::iterator it = methods_.find("serializable");
  if (it != methods_.end()) {
#ifndef WRAP_DISABLE_SERIALIZE
    isSerializable = true;
#else
    // cout << "Ignoring serializable() flag in class " << name << endl;
#endif
    methods_.erase(it);
  }

  it = methods_.find("serialize");
  if (it != methods_.end()) {
#ifndef WRAP_DISABLE_SERIALIZE
    isSerializable = true;
    hasSerialization = true;
#else
    // cout << "Ignoring serialize() flag in class " << name << endl;
#endif
    methods_.erase(it);
  }
}

/* ************************************************************************* */
void Class::verifyAll(vector<string>& validTypes, bool& hasSerialiable) const {

  hasSerialiable |= isSerializable;

  // verify all of the function arguments
  //TODO:verifyArguments<ArgumentList>(validTypes, constructor.args_list);
  verifyArguments<StaticMethod>(validTypes, static_methods);
  verifyArguments<Method>(validTypes, methods_);

  // verify function return types
  verifyReturnTypes<StaticMethod>(validTypes, static_methods);
  verifyReturnTypes<Method>(validTypes, methods_);

  // verify parents
  boost::optional<string> parent = qualifiedParent();
  if (parent
      && find(validTypes.begin(), validTypes.end(), *parent)
          == validTypes.end())
    throw DependencyMissing(*parent, qualifiedName("::"));
}

/* ************************************************************************* */
void Class::appendInheritedMethods(const Class& cls,
    const vector<Class>& classes) {

  if (cls.parentClass) {

    // Find parent
    BOOST_FOREACH(const Class& parent, classes) {
      // We found a parent class for our parent, TODO improve !
      if (parent.name() == cls.parentClass->name()) {
        methods_.insert(parent.methods_.begin(), parent.methods_.end());
        appendInheritedMethods(parent, classes);
      }
    }
  }
}

/* ************************************************************************* */
string Class::getTypedef() const {
  string result;
  BOOST_FOREACH(Str namesp, namespaces()) {
    result += ("namespace " + namesp + " { ");
  }
  result += ("typedef " + typedefName + " " + name() + ";");
  for (size_t i = 0; i < namespaces().size(); ++i) {
    result += " }";
  }
  return result;
}

/* ************************************************************************* */
void Class::comment_fragment(FileWriter& proxyFile) const {
  proxyFile.oss << "%class " << name() << ", see Doxygen page for details\n";
  proxyFile.oss
      << "%at http://research.cc.gatech.edu/borg/sites/edu.borg/html/index.html\n";

  constructor.comment_fragment(proxyFile);

  if (!methods_.empty())
    proxyFile.oss << "%\n%-------Methods-------\n";
  BOOST_FOREACH(const Methods::value_type& name_m, methods_)
    name_m.second.comment_fragment(proxyFile);

  if (!static_methods.empty())
    proxyFile.oss << "%\n%-------Static Methods-------\n";
  BOOST_FOREACH(const StaticMethods::value_type& name_m, static_methods)
    name_m.second.comment_fragment(proxyFile);

  if (hasSerialization) {
    proxyFile.oss << "%\n%-------Serialization Interface-------\n";
    proxyFile.oss << "%string_serialize() : returns string\n";
    proxyFile.oss << "%string_deserialize(string serialized) : returns "
        << name() << "\n";
  }

  proxyFile.oss << "%\n";
}

/* ************************************************************************* */
void Class::serialization_fragments(FileWriter& proxyFile,
    FileWriter& wrapperFile, Str wrapperName,
    vector<string>& functionNames) const {

//void Point3_string_serialize_17(int nargout, mxArray *out[], int nargin, const mxArray *in[])
//{
//  typedef boost::shared_ptr<Point3> Shared;
//  checkArguments("string_serialize",nargout,nargin-1,0);
//  Shared obj = unwrap_shared_ptr<Point3>(in[0], "ptr_Point3");
//  ostringstream out_archive_stream;
//  boost::archive::text_oarchive out_archive(out_archive_stream);
//  out_archive << *obj;
//  out[0] = wrap< string >(out_archive_stream.str());
//}

  int serialize_id = functionNames.size();
  const string matlabQualName = qualifiedName(".");
  const string matlabUniqueName = qualifiedName();
  const string cppClassName = qualifiedName("::");
  const string wrapFunctionNameSerialize = matlabUniqueName
      + "_string_serialize_" + boost::lexical_cast<string>(serialize_id);
  functionNames.push_back(wrapFunctionNameSerialize);

  // call
  //void Point3_string_serialize_17(int nargout, mxArray *out[], int nargin, const mxArray *in[])
  wrapperFile.oss << "void " << wrapFunctionNameSerialize
      << "(int nargout, mxArray *out[], int nargin, const mxArray *in[])\n";
  wrapperFile.oss << "{\n";
  wrapperFile.oss << "  typedef boost::shared_ptr<" << cppClassName
      << "> Shared;" << endl;

  // check arguments - for serialize, no arguments
  // example: checkArguments("string_serialize",nargout,nargin-1,0);
  wrapperFile.oss
      << "  checkArguments(\"string_serialize\",nargout,nargin-1,0);\n";

  // get class pointer
  // example: Shared obj = unwrap_shared_ptr<Point3>(in[0], "ptr_Point3");
  wrapperFile.oss << "  Shared obj = unwrap_shared_ptr<" << cppClassName
      << ">(in[0], \"ptr_" << matlabUniqueName << "\");" << endl;

  // Serialization boilerplate
  wrapperFile.oss << "  ostringstream out_archive_stream;\n";
  wrapperFile.oss
      << "  boost::archive::text_oarchive out_archive(out_archive_stream);\n";
  wrapperFile.oss << "  out_archive << *obj;\n";
  wrapperFile.oss << "  out[0] = wrap< string >(out_archive_stream.str());\n";

  // finish
  wrapperFile.oss << "}\n";

  // Generate code for matlab function
//  function varargout string_serialize(this, varargin)
//  % STRING_SERIALIZE usage: string_serialize() : returns string
//  % Doxygen can be found at http://research.cc.gatech.edu/borg/sites/edu.borg/html/index.html
//    if length(varargin) == 0
//      varargout{1} = geometry_wrapper(15, this, varargin{:});
//    else
//      error('Arguments do not match any overload of function Point3.string_serialize');
//    end
//  end

  proxyFile.oss
      << "    function varargout = string_serialize(this, varargin)\n";
  proxyFile.oss
      << "      % STRING_SERIALIZE usage: string_serialize() : returns string\n";
  proxyFile.oss
      << "      % Doxygen can be found at http://research.cc.gatech.edu/borg/sites/edu.borg/html/index.html\n";
  proxyFile.oss << "      if length(varargin) == 0\n";
  proxyFile.oss << "        varargout{1} = " << wrapperName << "("
      << boost::lexical_cast<string>(serialize_id) << ", this, varargin{:});\n";
  proxyFile.oss << "      else\n";
  proxyFile.oss
      << "        error('Arguments do not match any overload of function "
      << matlabQualName << ".string_serialize');\n";
  proxyFile.oss << "      end\n";
  proxyFile.oss << "    end\n\n";

  // Generate code for matlab save function
//  function sobj = saveobj(obj)
//    % SAVEOBJ Saves the object to a matlab-readable format
//    sobj = obj.string_serialize();
//  end

  proxyFile.oss << "    function sobj = saveobj(obj)\n";
  proxyFile.oss
      << "      % SAVEOBJ Saves the object to a matlab-readable format\n";
  proxyFile.oss << "      sobj = obj.string_serialize();\n";
  proxyFile.oss << "    end\n";
}

/* ************************************************************************* */
void Class::deserialization_fragments(FileWriter& proxyFile,
    FileWriter& wrapperFile, Str wrapperName,
    vector<string>& functionNames) const {
  //void Point3_string_deserialize_18(int nargout, mxArray *out[], int nargin, const mxArray *in[])
  //{
  //  typedef boost::shared_ptr<Point3> Shared;
  //  checkArguments("Point3.string_deserialize",nargout,nargin,1);
  //  string serialized = unwrap< string >(in[0]);
  //  istringstream in_archive_stream(serialized);
  //  boost::archive::text_iarchive in_archive(in_archive_stream);
  //  Shared output(new Point3());
  //  in_archive >> *output;
  //  out[0] = wrap_shared_ptr(output,"Point3", false);
  //}
  int deserialize_id = functionNames.size();
  const string matlabQualName = qualifiedName(".");
  const string matlabUniqueName = qualifiedName();
  const string cppClassName = qualifiedName("::");
  const string wrapFunctionNameDeserialize = matlabUniqueName
      + "_string_deserialize_" + boost::lexical_cast<string>(deserialize_id);
  functionNames.push_back(wrapFunctionNameDeserialize);

  // call
  wrapperFile.oss << "void " << wrapFunctionNameDeserialize
      << "(int nargout, mxArray *out[], int nargin, const mxArray *in[])\n";
  wrapperFile.oss << "{\n";
  wrapperFile.oss << "  typedef boost::shared_ptr<" << cppClassName
      << "> Shared;" << endl;

  // check arguments - for deserialize, 1 string argument
  wrapperFile.oss << "  checkArguments(\"" << matlabUniqueName
      << ".string_deserialize\",nargout,nargin,1);\n";

  // string argument with deserialization boilerplate
  wrapperFile.oss << "  string serialized = unwrap< string >(in[0]);\n";
  wrapperFile.oss << "  istringstream in_archive_stream(serialized);\n";
  wrapperFile.oss
      << "  boost::archive::text_iarchive in_archive(in_archive_stream);\n";
  wrapperFile.oss << "  Shared output(new " << cppClassName << "());\n";
  wrapperFile.oss << "  in_archive >> *output;\n";
  wrapperFile.oss << "  out[0] = wrap_shared_ptr(output,\"" << matlabQualName
      << "\", false);\n";
  wrapperFile.oss << "}\n";

  // Generate matlab function
//    function varargout = string_deserialize(varargin)
//    % STRING_DESERIALIZE usage: string_deserialize() : returns Point3
//    % Doxygen can be found at http://research.cc.gatech.edu/borg/sites/edu.borg/html/index.html
//      if length(varargin) == 1
//        varargout{1} = geometry_wrapper(18, varargin{:});
//      else
//        error('Arguments do not match any overload of function Point3.string_deserialize');
//      end
//    end

  proxyFile.oss << "    function varargout = string_deserialize(varargin)\n";
  proxyFile.oss
      << "      % STRING_DESERIALIZE usage: string_deserialize() : returns "
      << matlabQualName << "\n";
  proxyFile.oss
      << "      % Doxygen can be found at http://research.cc.gatech.edu/borg/sites/edu.borg/html/index.html\n";
  proxyFile.oss << "      if length(varargin) == 1\n";
  proxyFile.oss << "        varargout{1} = " << wrapperName << "("
      << boost::lexical_cast<string>(deserialize_id) << ", varargin{:});\n";
  proxyFile.oss << "      else\n";
  proxyFile.oss
      << "        error('Arguments do not match any overload of function "
      << matlabQualName << ".string_deserialize');\n";
  proxyFile.oss << "      end\n";
  proxyFile.oss << "    end\n\n";

  // Generate matlab load function
//    function obj = loadobj(sobj)
//      % LOADOBJ Saves the object to a matlab-readable format
//      obj = Point3.string_deserialize(sobj);
//    end

  proxyFile.oss << "    function obj = loadobj(sobj)\n";
  proxyFile.oss
      << "      % LOADOBJ Saves the object to a matlab-readable format\n";
  proxyFile.oss << "      obj = " << matlabQualName
      << ".string_deserialize(sobj);\n";
  proxyFile.oss << "    end" << endl;
}

/* ************************************************************************* */
string Class::getSerializationExport() const {
  //BOOST_CLASS_EXPORT_GUID(gtsam::SharedDiagonal, "gtsamSharedDiagonal");
  return "BOOST_CLASS_EXPORT_GUID(" + qualifiedName("::") + ", \""
      + qualifiedName() + "\");";
}

/* ************************************************************************* */
void Class::python_wrapper(FileWriter& wrapperFile) const {
  wrapperFile.oss << "class_<" << name() << ">(\"" << name() << "\")\n";
  constructor.python_wrapper(wrapperFile, name());
  BOOST_FOREACH(const StaticMethod& m, static_methods | boost::adaptors::map_values)
    m.python_wrapper(wrapperFile, name());
  BOOST_FOREACH(const Method& m, methods_ | boost::adaptors::map_values)
    m.python_wrapper(wrapperFile, name());
  wrapperFile.oss << ";\n\n";
}

/* ************************************************************************* */