2013-11-02 10:35:33 -04:00
|
|
|
/*
|
|
|
|
* libretroshare/src/services: groutermatrix.h
|
|
|
|
*
|
|
|
|
* Services for RetroShare.
|
|
|
|
*
|
|
|
|
* Copyright 2013 by Cyril Soler
|
|
|
|
*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Library General Public
|
|
|
|
* License Version 2 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
|
|
|
|
* Library General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Library General Public
|
|
|
|
* License along with this library; if not, write to the Free Software
|
|
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
|
|
|
|
* USA.
|
|
|
|
*
|
|
|
|
* Please report all bugs and problems to "csoler@users.sourceforge.net".
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include <list>
|
|
|
|
|
|
|
|
#include "pgp/rscertificate.h"
|
|
|
|
#include "groutertypes.h"
|
|
|
|
#include "rsgrouter.h"
|
|
|
|
|
|
|
|
// The routing matrix records the event clues received from each friend
|
|
|
|
//
|
|
|
|
struct RoutingMatrixHitEntry
|
|
|
|
{
|
2013-11-05 16:15:26 -05:00
|
|
|
uint32_t friend_id ; // not the full key. Gets too big otherwise!
|
2013-11-02 10:35:33 -04:00
|
|
|
float weight ;
|
|
|
|
time_t time_stamp ;
|
|
|
|
};
|
|
|
|
|
|
|
|
class GRouterMatrix
|
|
|
|
{
|
|
|
|
public:
|
2013-11-05 16:15:26 -05:00
|
|
|
GRouterMatrix() ;
|
|
|
|
|
2013-11-02 10:35:33 -04:00
|
|
|
// Computes the routing probabilities for this id for the given list of friends.
|
|
|
|
// the computation accounts for the time at which the info was received and the
|
|
|
|
// weight of each routing hit record.
|
|
|
|
//
|
|
|
|
bool computeRoutingProbabilities(const GRouterKeyId& id, const std::vector<SSLIdType>& friends, std::vector<float>& probas) const ;
|
|
|
|
|
|
|
|
// Remove oldest entries.
|
|
|
|
//
|
|
|
|
bool autoWash() ;
|
|
|
|
|
|
|
|
// Update routing probabilities for each key, accounting for all received events, but without
|
|
|
|
// activity information
|
|
|
|
//
|
|
|
|
bool updateRoutingProbabilities() ;
|
|
|
|
|
|
|
|
// Record one routing clue. The events can possibly be merged in time buckets.
|
|
|
|
//
|
|
|
|
bool addRoutingClue(const GRouterKeyId& id,const GRouterServiceId& sid,float distance,const std::string& desc_string,const SSLIdType& source_friend) ;
|
|
|
|
|
2013-11-05 16:15:26 -05:00
|
|
|
// Dump info in terminal.
|
|
|
|
//
|
|
|
|
void debugDump() const ;
|
|
|
|
|
2013-11-02 10:35:33 -04:00
|
|
|
private:
|
2013-11-05 16:15:26 -05:00
|
|
|
uint32_t getFriendId(const SSLIdType& id) ;
|
|
|
|
|
2013-11-02 10:35:33 -04:00
|
|
|
// List of events received and computed routing probabilities
|
|
|
|
//
|
2013-11-05 16:15:26 -05:00
|
|
|
std::map<GRouterKeyId, std::list<RoutingMatrixHitEntry> > _routing_clues ;
|
|
|
|
std::map<GRouterKeyId, std::vector<float> > _time_combined_hits ; // hit matrix after time-convolution filter
|
2013-11-02 10:35:33 -04:00
|
|
|
|
|
|
|
// This is used to avoid re-computing probas when new events have been received.
|
|
|
|
//
|
|
|
|
bool _proba_need_updating ;
|
2013-11-05 16:15:26 -05:00
|
|
|
|
|
|
|
// Routing weights. These are the result of a time convolution of the routing clues and weights
|
|
|
|
// recorded in _routing_clues.
|
|
|
|
//
|
|
|
|
std::map<SSLIdType,uint32_t> _friend_indices ; // index for each friend to lookup in the routing matrix Not saved.
|
|
|
|
std::vector<SSLIdType> _reverse_friend_indices ;// SSLid corresponding to each friend index. Saved.
|
|
|
|
|
2013-11-02 10:35:33 -04:00
|
|
|
};
|
|
|
|
|