# Jubatus: Online machine learning framework for distributed environment
# Copyright (C) 2011,2012 Preferred Networks and Nippon Telegraph and Telephone Corporation.
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License version 2.1 as published by the Free Software Foundation.
#
# This library 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
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA

message id_with_score {
  0: string id
  1: double score
}

service recommender {

  #@cht #@update #@all_and
  bool clear_row(0: string id)

  #@cht #@update #@all_and
  bool update_row(0: string id, 1: datum row)

  #@broadcast #@update #@all_and
  bool clear()

  #@cht #@analysis #@pass
  datum complete_row_from_id(0: string id)

  #@random #@analysis #@pass
  datum complete_row_from_datum(0: datum row)

  #@cht #@analysis #@pass
  list<id_with_score> similar_row_from_id(0: string id, 1: uint size)

  #@cht #@analysis #@pass
  list<id_with_score> similar_row_from_id_and_score(0: string id, 1: double score)

  #@cht #@analysis #@pass
  list<id_with_score> similar_row_from_id_and_rate(0: string id, 1: float rate)

  #@random #@analysis #@pass
  list<id_with_score> similar_row_from_datum(0: datum row, 1: uint size)

  #@random #@analysis #@pass
  list<id_with_score> similar_row_from_datum_and_score(0: datum row, 1: double score)

  #@random #@analysis #@pass
  list<id_with_score> similar_row_from_datum_and_rate(0: datum row, 1: float rate)

  #@cht #@analysis #@pass
  datum decode_row(0: string id)

  #@random #@analysis #@pass
  list<string> get_all_rows()

  #@random #@analysis #@pass
  double calc_similarity(0: datum lhs, 1:datum rhs)

  #@random #@analysis #@pass
  double calc_l2norm(0: datum row)

}
