BDI agent with voting capabilities. More...

Inherits IBaseAgent< CVotingAgent >.

Collaboration diagram for org.lightvoting.simulation.agent.CVotingAgent:

Classes
class	CVotingAgentGenerator
	Class CVotingAgentGenerator. More...

Public Member Functions
	CVotingAgent (final String p_name, final IAgentConfiguration< CVotingAgent > p_configuration, final IBaseAgent< CChairAgent > p_chairagent, final CEnvironment p_environment, final int p_altNum, final String p_grouping, final String p_fileName)
	constructor of the agent More...

final CVotingAgent	call () throws Exception

BitVector	getBitVote ()

CChairAgent	getChair ()
	get associated chair agent More...

AtomicIntegerArray	getVote ()

final String	name ()
	Get agent's name. More...

Private Member Functions
double	computeDiss (final int[] p_resultValues)
	compute dissatisfaction of voter with given committee More...

Double	computeDissBV (final BitVector p_result)

AtomicIntegerArray	convertPreferences (final AtomicDoubleArray p_atomicPrefValues)

BitVector	convertPreferencesToBits (final AtomicDoubleArray p_atomicPrefValues)

List< CGroup >	determineActiveGroups ()

void	determineGroupCoordinated (final List< CGroup > p_activeGroups)

AtomicDoubleArray	generatePreferences (final int p_altNum)

void	joinGroup ()

void	joinGroupCoordinated ()

void	joinGroupRandom ()

void	openNewGroup ()

void	perceiveEnv ()

double	sigmoidValue (double p_var)

Map	sortMapDESC (final Map< CGroup, Integer > p_valuesMap)

void	submitDiss (final CChairAgent p_chairAgent, final Integer p_iteration, final BitVector p_result) throws InterruptedException

void	submitVote (final CChairAgent p_chairAgent)

Private Attributes
final int	m_altNum
	number of alternatives More...

final AtomicDoubleArray	m_atomicPrefValues
	agent's preferences More...

final BitVector	m_bitVote

CChairAgent	m_chair
	associated chair agent; More...

final CEnvironment	m_environment
	environment More...

final String	m_fileName

String	m_grouping
	grouping algorithm: "RANDOM" or "COORDINATED" More...

Integer	m_joinThreshold
	threshold for joining a group in the case of coordinated grouping More...

final String	m_name
	name of the agent More...

AtomicIntegerArray	m_vote
	agent's vote More...

boolean	m_voted
	variable indicating if agent already submitted its vote More...

Detailed Description

re-used code from http://stackoverflow.com/questions/8119366/sorting-hashmap-by-values

Definition at line 69 of file CVotingAgent.java.

Constructor & Destructor Documentation

org.lightvoting.simulation.agent.CVotingAgent.CVotingAgent	(	final String	p_name,
		final IAgentConfiguration< CVotingAgent >	p_configuration,
		final IBaseAgent< CChairAgent >	p_chairagent,
		final CEnvironment	p_environment,
		final int	p_altNum,
		final String	p_grouping,
		final String	p_fileName
	)

Parameters

p_name	name of the agent
p_configuration	agent configuration of the agent generator
p_chairagent	corresponding chair agent
p_environment	environment reference
p_altNum	number of alternatives
p_grouping	grouping algorithm
p_fileName	h5 file

Definition at line 132 of file CVotingAgent.java.

Referenced by org.lightvoting.simulation.agent.CVotingAgent.CVotingAgentGenerator.generatesingle().

     {
         super( p_configuration );
         m_name = p_name;
         m_environment = p_environment;
 
         m_chair = (CChairAgent) p_chairagent;
         m_storage.put( "chair", p_chairagent.raw() );
 
         m_beliefbase.add(
             CLiteral.from(
                 "chair",
                 CRawTerm.from( p_chairagent )
             )
         );
 
         // sleep chair, Long.MAX_VALUE -> inf
         p_chairagent.sleep( Long.MAX_VALUE );
 
         m_altNum = p_altNum;
 
         m_atomicPrefValues = this.generatePreferences( m_altNum );
         m_vote = this.convertPreferences( m_atomicPrefValues );
         m_bitVote = this.convertPreferencesToBits( m_atomicPrefValues );
         m_voted = false;
         m_joinThreshold = 5;
         m_grouping = p_grouping;
         m_fileName = p_fileName;
     }

Here is the caller graph for this function:

Member Function Documentation

final CVotingAgent org.lightvoting.simulation.agent.CVotingAgent.call ( ) throws Exception

Definition at line 169 of file CVotingAgent.java.

     {
         // run default cycle
         return super.call();
     }

double org.lightvoting.simulation.agent.CVotingAgent.computeDiss ( final int[] p_resultValues )

private

Parameters

p_resultValues committee

Returns: dissatisfaction with committee

Definition at line 429 of file CVotingAgent.java.

     {
         double l_diss = 0;
 
         for ( int i = 0; i < p_resultValues.length; i++ )
         {
             if ( p_resultValues[i] == 1 )
                 l_diss = l_diss + ( 1 - m_atomicPrefValues.get( i ) );
         }
         return l_diss;
     }

Double org.lightvoting.simulation.agent.CVotingAgent.computeDissBV ( final BitVector p_result )

private

Definition at line 267 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.m_atomicPrefValues.

     {
         double l_diss = 0;
 
         for ( int i = 0; i < p_result.size(); i++ )
         {
             if ( p_result.get( i ) )
                 l_diss = l_diss + ( 1 - m_atomicPrefValues.get( i ) );
         }
         return l_diss;
     }

AtomicIntegerArray org.lightvoting.simulation.agent.CVotingAgent.convertPreferences ( final AtomicDoubleArray p_atomicPrefValues )

private

Definition at line 296 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.m_altNum.

     {
         final int[] l_voteValues = new int[m_altNum];
         for ( int i = 0; i < m_altNum; i++ )
             if ( p_atomicPrefValues.get( i ) > 0.5 )
                 l_voteValues[i] = 1;
             else
                 l_voteValues[i] = 0;
         System.out.println( "Vote: " + Arrays.toString( l_voteValues ) );
         return new AtomicIntegerArray( l_voteValues );
     }

BitVector org.lightvoting.simulation.agent.CVotingAgent.convertPreferencesToBits ( final AtomicDoubleArray p_atomicPrefValues )

private

Definition at line 308 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.m_altNum.

     {
         final BitVector l_voteValues = new BitVector( m_altNum );
         for ( int i = 0; i < m_altNum; i++ )
             if ( p_atomicPrefValues.get( i ) > 0.5 )
                 l_voteValues.put( i, true );
             else
                 l_voteValues.put( i, false );
         System.out.println( "Vote as BitVector: " + l_voteValues  );
         return l_voteValues;
     }

List<CGroup> org.lightvoting.simulation.agent.CVotingAgent.determineActiveGroups ( )

private

Definition at line 321 of file CVotingAgent.java.

     {
         final AtomicReference<List<CGroup>> l_groupList = new AtomicReference<>();
 
         m_beliefbase.beliefbase().literal( "groups" ).stream().forEach( i ->
             l_groupList.set( ( (ILiteral) i ).values().findFirst().get().raw() ) );
 
         final List<CGroup> l_activeGroups = new LinkedList<>();
 
         for ( int i = 0; i < l_groupList.get().size(); i++ )
             if ( l_groupList.get().get( i ).open() )
             {
                 l_activeGroups.add( l_groupList.get().get( i ) );
             }
 
         return l_activeGroups;
     }

void org.lightvoting.simulation.agent.CVotingAgent.determineGroupCoordinated ( final List< CGroup > p_activeGroups )

private

Definition at line 388 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.m_joinThreshold.

     {
         final CGroup l_group;
         // choose group to join
         final Map<CGroup, Integer> l_groupDistances = new HashMap<>();
         final BitVector l_vote = this.getBitVote();
         System.out.println( "Vote: " + l_vote );
         for ( int i = 0; i < p_activeGroups.size(); i++ )
         {
             final BitVector l_com =  p_activeGroups.get( i ).result();
             System.out.println( "Committee: " + l_com );
 
             System.out.println( "Vote: " + l_vote );
             System.out.println( "Committee: " + l_com );
             l_com.xor( l_vote );
             final int l_HD = l_com.cardinality();
             System.out.println( "Hamming distance: " + l_HD );
             l_groupDistances.put( p_activeGroups.get( i ), l_HD );
         }
         final Map l_sortedDistances = this.sortMapDESC( l_groupDistances );
         final Map.Entry<CGroup, Integer> l_entry = (Map.Entry<CGroup, Integer>) l_sortedDistances.entrySet().iterator().next();
         l_group = l_entry.getKey();
 
         // if Hamming distance is above the threshold, do not join the chair but create a new group
         if ( l_entry.getValue() > m_joinThreshold )
         {
             this.openNewGroup();
             return;
         }
         m_environment.addAgentCoordinated( l_group, this );
         this.beliefbase().add( l_group.literal( this ) );
         System.out.println( this.name() + " joins group " + l_group );
     }

AtomicDoubleArray org.lightvoting.simulation.agent.CVotingAgent.generatePreferences ( final int p_altNum )

private

Definition at line 281 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.m_altNum, and org.lightvoting.simulation.agent.CVotingAgent.sigmoidValue().

     {
         final Random l_random = new Random();
         final double[] l_prefValues = new double[m_altNum];
         for ( int i = 0; i < m_altNum; i++ )
             l_prefValues[i] = this.sigmoidValue( l_random.nextDouble() - 0.5 );
         System.out.println( "Preference Values: " + Arrays.toString( l_prefValues ) );
         return new AtomicDoubleArray( l_prefValues );
     }

Here is the call graph for this function:

BitVector org.lightvoting.simulation.agent.CVotingAgent.getBitVote ( )

Definition at line 202 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.m_bitVote.

     {
         return m_bitVote;
     }

CChairAgent org.lightvoting.simulation.agent.CVotingAgent.getChair ( )

Returns: chair agent

Definition at line 192 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.m_chair.

     {
         return m_chair;
     }

AtomicIntegerArray org.lightvoting.simulation.agent.CVotingAgent.getVote ( )

Definition at line 197 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.m_vote.

     {
         return m_vote;
     }

void org.lightvoting.simulation.agent.CVotingAgent.joinGroup ( )

private

Definition at line 219 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.joinGroupCoordinated(), and org.lightvoting.simulation.agent.CVotingAgent.m_grouping.

     {
         if ( "RANDOM".equals( m_grouping ) )
             this.joinGroupRandom();
 
         if ( "COORDINATED".equals( m_grouping ) )
             this.joinGroupCoordinated();
     }

Here is the call graph for this function:

void org.lightvoting.simulation.agent.CVotingAgent.joinGroupCoordinated ( )

private

Definition at line 372 of file CVotingAgent.java.

Referenced by org.lightvoting.simulation.agent.CVotingAgent.joinGroup().

     {
         System.out.println( "join group according to coordinated grouping algorithm" );
 
         final List<CGroup> l_activeGroups = this.determineActiveGroups();
 
         if ( l_activeGroups.isEmpty() )
         {
             this.openNewGroup();
             return;
         }
 
         else
             this.determineGroupCoordinated( l_activeGroups );
     }

Here is the caller graph for this function:

void org.lightvoting.simulation.agent.CVotingAgent.joinGroupRandom ( )

private

Definition at line 353 of file CVotingAgent.java.

     {
 
         final List<CGroup> l_activeGroups = this.determineActiveGroups();
 
         if ( l_activeGroups.isEmpty() )
         {
             this.openNewGroup();
             return;
         }
 
         final Random l_rand = new Random();
 
         final CGroup l_randomGroup = l_activeGroups.get( l_rand.nextInt( l_activeGroups.size() ) );
         m_environment.addAgentRandom( l_randomGroup, this );
         this.beliefbase().add( l_randomGroup.literal( this ) );
 
     }

final String org.lightvoting.simulation.agent.CVotingAgent.name ( )

Returns: name of agent

Definition at line 182 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.m_name.

     {
         return m_name;
     }

void org.lightvoting.simulation.agent.CVotingAgent.openNewGroup ( )

private

Definition at line 339 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.m_grouping.

     {
         final CGroup l_group;
 
         if ( "RANDOM".equals( m_grouping ) )
             l_group = m_environment.openNewGroupRandom( this );
 
         else
             l_group = m_environment.openNewGroupCoordinated( this );
 
         this.beliefbase().add( l_group.literal( this ) );
         System.out.println( "opened new group " + l_group );
     }

void org.lightvoting.simulation.agent.CVotingAgent.perceiveEnv ( )

private

Definition at line 211 of file CVotingAgent.java.

References org.lightvoting.simulation.environment.CEnvironment.literal(), and org.lightvoting.simulation.agent.CVotingAgent.m_environment.

     {
         this.beliefbase().add( m_environment.literal( this ) );
         System.out.println( this.name() + " perceived environment " );
     }

Here is the call graph for this function:

double org.lightvoting.simulation.agent.CVotingAgent.sigmoidValue ( double p_var )

private

Definition at line 291 of file CVotingAgent.java.

Referenced by org.lightvoting.simulation.agent.CVotingAgent.generatePreferences().

     {
         return 1 / ( 1 + Math.pow( Math.E, -1 * p_var ) );
     }

Here is the caller graph for this function:

Map org.lightvoting.simulation.agent.CVotingAgent.sortMapDESC ( final Map< CGroup, Integer > p_valuesMap )

private

Definition at line 443 of file CVotingAgent.java.

     {
         final List<Map.Entry<CGroup, Integer>> l_list = new LinkedList<>( p_valuesMap.entrySet() );
 
         /* Sorting the list based on values in descending order */
 
         Collections.sort( l_list, ( p_first, p_second ) ->
             p_second.getValue().compareTo( p_first.getValue() ) );
 
         /* Maintaining insertion order with the help of LinkedList */
 
         final Map<CGroup, Integer> l_sortedMap = new LinkedHashMap<>();
         for ( final Map.Entry<CGroup, Integer> l_entry : l_list )
         {
             l_sortedMap.put( l_entry.getKey(), l_entry.getValue() );
         }
 
         return l_sortedMap;
     }

void org.lightvoting.simulation.agent.CVotingAgent.submitDiss	(	final CChairAgent	p_chairAgent,
		final Integer	p_iteration,
		final BitVector	p_result
	)		throws InterruptedException

private

Definition at line 252 of file CVotingAgent.java.

     {
         p_chairAgent.trigger(
             CTrigger.from(
                 ITrigger.EType.ADDGOAL,
                 CLiteral.from(
                     "diss/received",
                     CRawTerm.from( this.name() ),
                     CRawTerm.from( this.computeDissBV( p_result ) ),
                     CRawTerm.from( p_iteration )
                 )
             )
         );
     }

void org.lightvoting.simulation.agent.CVotingAgent.submitVote ( final CChairAgent p_chairAgent )

private

Definition at line 230 of file CVotingAgent.java.

References org.lightvoting.simulation.agent.CVotingAgent.m_voted.

     {
         if ( m_voted )
             return;
 
         p_chairAgent.trigger(
             CTrigger.from(
                 ITrigger.EType.ADDGOAL,
                 CLiteral.from(
                     "vote/received",
                     CRawTerm.from( this.name() ),
                     CRawTerm.from( this.getBitVote() )
                 )
             )
         );
 
         m_voted = true;
 
     }