es.ants.felixgm.trmsim_wsn.trm.btrm_wsn
Class BTRM_WSN

java.lang.Object
  es.ants.felixgm.trmsim_wsn.trm.TRModel_WSN
      es.ants.felixgm.trmsim_wsn.trm.btrm_wsn.BTRM_WSN

public class BTRM_WSN
extends TRModel_WSN

This class models BTRM_WSN (Bio-inspired Trust and Reputation Model for Wireless Sensor Networks) algorithm used by a client in a P2P, Ad-hoc or Wireless Sensor Network, in order to find the most trustworthy server offering a desired service.

It needs some parameters to be passed as a BTRM_WSN_Parameters object. To do this, a file can be given following the next structure:

    ####################################
    # BTRM-WSN parameters file
    # Thu Jun 19 14:07:13 CEST 2008
    ####################################
    pathLengthFactor=0.71
    alpha=1.0
    phi=0.01
    initialPheromone=0.85
    q0=0.45
    numIterations=0.59
    punishmentThreshold=0.48
    rho=0.87
    beta=1.0
    numAnts=0.35
    transitionThreshold=0.66
 

This file can be downloaded here. But if any of the parameters can not be successfully extracted from the file, they are set to a default value.

For more information regarding BTRM-WSN algorithm, please check the following reference:

• Félix Gómez Mármol, Gregorio Martínez Pérez, "Providing Trust in Wireless Sensor Networks using a Bio-inspired Technic", Telecommunication Systems Journal, vol. 46, no. 2, pp. 163-180, 2011

Since:

0.2

Version:

0.4

Author:

Félix Gómez Mármol, Gregorio Martínez Pérez

Field Summary

Fields inherited from class es.ants.felixgm.trmsim_wsn.trm.TRModel_WSN

trmParameters

Constructor Summary

BTRM_WSN(BTRM_WSN_Parameters btrm_parameters)
Class BTRM_WSN constructor

Method Summary

GatheredInformation	gatherInformation(Sensor client, Service service) This method collects or gathers the required information from the network needed to evaluate each sensor offering a given service in order to determine whether to have a transaction with it or not
Network	generateRandomNetwork(int numSensors, double probClients, double rangeFactor, java.util.Collection<java.lang.Double> probServices, java.util.Collection<java.lang.Double> probGoodness, java.util.Collection<Service> services) This method generates a new random network specific for this trust and reputation model
static java.lang.String	get_name() Returns the name of this model, i.e., "BTRM_WSN"
Network	loadCurrentNetwork(java.lang.String fileName) This method loads a network from a XML file and creates the specific network corresponding to this trust and reputation model
Outcome	performTransaction(java.util.Vector<Sensor> path, Service service) This method actually requests a desired service to a specified server and evaluates the satisfaction of the client with the actually received service
Outcome	punish(java.util.Vector<Sensor> path, Outcome outcome) This method punishes a server if the client is not satisfied with the received service, according to that precise dissatisfaction
Outcome	reward(java.util.Vector<Sensor> path, Outcome outcome) This method rewards a server if the client is satisfied with the received service, according to that precise satisfaction
java.util.Vector<Sensor>	scoreAndRanking(Sensor client, GatheredInformation gi) This method computes a trust and/or reputation value for each reachable server from the specified client and returns either a sorted list of all the reachable servers or a path leading directly to the most trustworthy and/or reputable one

Methods inherited from class es.ants.felixgm.trmsim_wsn.trm.TRModel_WSN

get_TRMParameters, set_TRMParameters

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BTRM_WSN

public BTRM_WSN(BTRM_WSN_Parameters btrm_parameters)

Class BTRM_WSN constructor

Parameters:

btrm_parameters - Parameters needed for the algorithm, as described before

Method Detail

get_name

public static java.lang.String get_name()

Returns the name of this model, i.e., "BTRM_WSN"

Returns:

The name of this model, i.e., "BTRM_WSN"

gatherInformation

public GatheredInformation gatherInformation(Sensor client,
                                             Service service)

Description copied from class: TRModel_WSN

This method collects or gathers the required information from the network needed to evaluate each sensor offering a given service in order to determine whether to have a transaction with it or not

Specified by:

gatherInformation in class TRModel_WSN

Parameters:

client - The client applying this trust and reputation model in order to find the most trustworthy and reputable server offering a given service

service - The service requested by the given client

Returns:

The required information from the network needed to evaluate each sensor offering a given service in order to determine whether to have a transaction with it or not

scoreAndRanking

public java.util.Vector<Sensor> scoreAndRanking(Sensor client,
                                                GatheredInformation gi)

Description copied from class: TRModel_WSN

This method computes a trust and/or reputation value for each reachable server from the specified client and returns either a sorted list of all the reachable servers or a path leading directly to the most trustworthy and/or reputable one

Specified by:

scoreAndRanking in class TRModel_WSN

Parameters:

client - The client applying this trust and reputation model in order to find the most trustworthy and reputable server offering a given service

gi - The gathered information fro the network needed in order to compute the trust and/or reputation value for each reachable server

Returns:

Either a path leading to the most trustworthy server found, or a sorted list of all the reachable servers

performTransaction

public Outcome performTransaction(java.util.Vector<Sensor> path,
                                  Service service)

Description copied from class: TRModel_WSN

This method actually requests a desired service to a specified server and evaluates the satisfaction of the client with the actually received service

Specified by:

performTransaction in class TRModel_WSN

Parameters:

path - Path of sensors leading to the most trustworthy and reputable server or sorted list of all the reachable servers

service - Service requested by the client running this trust and reputation model

Returns:

Outcome with the satisfaction of the client with the received service

reward

public Outcome reward(java.util.Vector<Sensor> path,
                      Outcome outcome)

Description copied from class: TRModel_WSN

This method rewards a server if the client is satisfied with the received service, according to that precise satisfaction

Specified by:

reward in class TRModel_WSN

Parameters:

path - Path of sensors leading to the requesting server

outcome - Client's satisfaction with the received service

Returns:

Outcome with the updated transmitted distance of the messages sent

punish

public Outcome punish(java.util.Vector<Sensor> path,
                      Outcome outcome)

Description copied from class: TRModel_WSN

This method punishes a server if the client is not satisfied with the received service, according to that precise dissatisfaction

Specified by:

punish in class TRModel_WSN

Parameters:

path - Path of sensors leading to the requesting server

outcome - Client's dissatisfaction with the received service

Returns:

Outcome with the updated transmitted distance of the messages sent

generateRandomNetwork

public Network generateRandomNetwork(int numSensors,
                                     double probClients,
                                     double rangeFactor,
                                     java.util.Collection<java.lang.Double> probServices,
                                     java.util.Collection<java.lang.Double> probGoodness,
                                     java.util.Collection<Service> services)

Description copied from class: TRModel_WSN

This method generates a new random network specific for this trust and reputation model

Specified by:

generateRandomNetwork in class TRModel_WSN

Parameters:

numSensors - Number of sensors composing the network

probClients - Probability of a sensor to act as a client requesting services

rangeFactor - Maximum wireless range of every sensor. It determines the neighborhood of every sensor

probServices - A collection of probabilities of offering a certain service, one per service

probGoodness - A collection of goodnesses about offering a certain service, one per service

services - All the services offered by the generated Network

Returns:

A new random network specific for this trust and reputation model

loadCurrentNetwork

public Network loadCurrentNetwork(java.lang.String fileName)
                           throws java.lang.Exception

Description copied from class: TRModel_WSN

This method loads a network from a XML file and creates the specific network corresponding to this trust and reputation model

Specified by:

loadCurrentNetwork in class TRModel_WSN

Parameters:

fileName - Path of the XML to load the network from

Returns:

The loaded and generated specific network for this trust and reputation model

Throws:

java.lang.Exception - If the XML file given does not have the appropriate structure, or if a sensor links to an undefined sensor, or if a sensor links to itself