Created by sophie on 21.02.17. More...

Inherits IBaseAgent< CChairAgent >.

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

Classes
class	CChairAgentGenerator
	Class CChairAgentGenerator. More...

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

final CChairAgent	call () throws Exception

void	checkConditions ()
	check conditions More...

void	computeResult ()
	compute result of election More...

String	name ()

void	perceiveGroup ()
	perceive group More...

void	removeVoter ()
	remove most dissatisfied voter More...

void	startElection ()
	start election More...

void	storeDiss (final String p_name, final Double p_diss, final Integer p_iteration)
	store dissatisfaction value More...

void	storeVote (final String p_agentName, final BitVector p_vote)
	store vote More...

Private Member Functions
CGroup	determineGroup ()

int	getMaxIndex (final List< Double > p_dissValues)

BitVector	toBV (final AtomicIntegerArray p_vote)

Private Attributes
List< CVotingAgent >	m_agents

List< BitVector >	m_bitVotes

List< Double >	m_dissList

double	m_dissThreshold = 1.1

List< CVotingAgent >	m_dissVoters

final CEnvironment	m_environment
	environment More...

final String	m_fileName

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

int	m_iteration

boolean	m_iterative

final String	m_name
	name of chair More...

String	m_protocol

Detailed Description

Definition at line 63 of file CChairAgent.java.

Constructor & Destructor Documentation

org.lightvoting.simulation.agent.CChairAgent.CChairAgent	(	final String	p_name,
		final IAgentConfiguration< CChairAgent >	p_configuration,
		final CEnvironment	p_environment,
		final String	p_grouping,
		final String	p_protocol,
		final String	p_fileName
	)

Parameters

p_configuration	agent configuration of the agent generator
p_grouping	grouping algorithm
p_protocol	voting protocol
p_fileName	h5 file

Definition at line 101 of file CChairAgent.java.

Referenced by org.lightvoting.simulation.agent.CChairAgent.CChairAgentGenerator.generatesingle().

     {
         super( p_configuration );
         m_name = p_name;
         m_environment = p_environment;
         m_bitVotes = Collections.synchronizedList( new LinkedList<>() );
         m_dissList = Collections.synchronizedList( new LinkedList<>() );
         m_dissVoters = Collections.synchronizedList( new LinkedList<>() );
         m_grouping = p_grouping;
         m_protocol = p_protocol;
         m_iteration = 0;
         m_agents = Collections.synchronizedList( new LinkedList<>() );
         m_iterative = false;
         m_fileName = p_fileName;
     }

Here is the caller graph for this function:

Member Function Documentation

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

Definition at line 122 of file CChairAgent.java.

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

void org.lightvoting.simulation.agent.CChairAgent.checkConditions ( )

add literal for group of chair agent if it exists

Definition at line 159 of file CChairAgent.java.

References org.lightvoting.simulation.agent.CChairAgent.m_iteration, org.lightvoting.simulation.agent.CChairAgent.m_iterative, and org.lightvoting.simulation.environment.CGroup.readyForElection().

     {
         final CGroup l_group = this.determineGroup();
 
         // if conditions for election are fulfilled, trigger goal start/criterion/fulfilled
 
         final ITrigger l_trigger;
 
         // if m_iterative is true, we have the case of iterative voting, i.e. we already have the votes
         // we only need to repeat the computation of the result
 
         if  ( m_iterative && ( l_group.readyForElection() && !( l_group.electionInProgress() ) ) )
         {
             m_iteration++;
             this.computeResult();
             return;
         }
 
 
         if ( l_group.readyForElection() && ( !( l_group.electionInProgress() ) ) )
         {
             l_group.startProgress();
 
             l_trigger = CTrigger.from(
                 ITrigger.EType.ADDGOAL,
                 CLiteral.from( "start/criterion/fulfilled" )
             );
 
             this.trigger( l_trigger );
         }
     }

Here is the call graph for this function:

void org.lightvoting.simulation.agent.CChairAgent.computeResult ( )

Definition at line 260 of file CChairAgent.java.

References org.lightvoting.simulation.agent.CChairAgent.m_bitVotes, org.lightvoting.simulation.agent.CChairAgent.m_grouping, org.lightvoting.simulation.agent.CChairAgent.m_iteration, org.lightvoting.simulation.agent.CChairAgent.m_iterative, org.lightvoting.simulation.agent.CChairAgent.m_protocol, org.lightvoting.simulation.environment.CGroup.updateBasic(), and org.lightvoting.simulation.environment.CGroup.updateIterative().

     {
         final CGroup l_group = this.determineGroup();
 
         final CMinisumApproval l_minisumApproval = new CMinisumApproval();
 
         final List<String> l_alternatives = new LinkedList<>();
 
         for ( char l_char : "ABCDEF".toCharArray() )
 
             l_alternatives.add( String.valueOf( l_char ) );
 
         System.out.println( " Alternatives: " + l_alternatives );
 
         System.out.println( " Votes: " + m_bitVotes );
 
         final BitVector l_comResultBV = l_minisumApproval.applyRuleBV( l_alternatives, m_bitVotes, 3 );
 
         System.out.println( " Result of election as BV: " + l_comResultBV );
 
         // set inProgress and readyForElection to false in group
         l_group.reset();
 
         if ( "BASIC".equals( m_protocol ) )
         {
             this.beliefbase().add( l_group.updateBasic( this, l_comResultBV ) );
         }
 
 
         // if grouping is coordinated, reopen group for further voters
         if ( "COORDINATED".equals( m_grouping ) && !l_group.finale() && !m_iterative )
         {
             System.out.println( " reopening group " );
             m_environment.reopen( l_group );
         }
 
         // for the iterative case, you need to differentiate between the final election and intermediate elections.
         if ( "ITERATIVE".equals( m_protocol ) && ( l_group.finale() ) || m_iterative )
         {
             System.out.println( " Update iterative " );
 
             this.beliefbase().add( l_group.updateIterative( this,  l_comResultBV, m_iteration ) );
             return;
         }
 
 
         if ( "ITERATIVE".equals( m_protocol ) && !l_group.finale() )
         {
             System.out.println( " Update basic " );
             this.beliefbase().add( l_group.updateBasic( this,  l_comResultBV ) );
         }
 
         // TODO test all cases
 
     }

Here is the call graph for this function:

CGroup org.lightvoting.simulation.agent.CChairAgent.determineGroup ( )

private

Definition at line 193 of file CChairAgent.java.

     {
         final AtomicReference<CGroup> l_groupAtomic = new AtomicReference<>();
         final Collection l_groups = this.beliefbase().beliefbase().literal( "group" );
         l_groups.stream().forEach( i -> l_groupAtomic.set( ( (ILiteral) i ).values().findFirst().get().raw() ) );
         return l_groupAtomic.get();
     }

int org.lightvoting.simulation.agent.CChairAgent.getMaxIndex ( final List< Double > p_dissValues )

private

Definition at line 392 of file CChairAgent.java.

     {
         int l_maxIndex = 0;
         for ( int i = 0; i < p_dissValues.size(); i++ )
         {
             if ( p_dissValues.get( i ) > p_dissValues.get( l_maxIndex ) )
             {
                 System.out.println( " changed max index to " + i + " diss: " + p_dissValues.get( i ) );
                 l_maxIndex = i;
             }
         }
         return l_maxIndex;
     }

String org.lightvoting.simulation.agent.CChairAgent.name ( )

Definition at line 130 of file CChairAgent.java.

References org.lightvoting.simulation.agent.CChairAgent.m_name.

     {
         return m_name;
     }

void org.lightvoting.simulation.agent.CChairAgent.perceiveGroup ( )

add literal for group of chair agent if it exists

Definition at line 145 of file CChairAgent.java.

References org.lightvoting.simulation.environment.CEnvironment.detectGroup(), and org.lightvoting.simulation.agent.CChairAgent.m_environment.

     {
         if ( !( m_environment.detectGroup( this ) == null ) )
             this.beliefbase().add( m_environment.detectGroup( this ) );
     }

Here is the call graph for this function:

void org.lightvoting.simulation.agent.CChairAgent.removeVoter ( )

Definition at line 357 of file CChairAgent.java.

References org.lightvoting.simulation.agent.CChairAgent.m_dissList, org.lightvoting.simulation.agent.CChairAgent.m_dissThreshold, org.lightvoting.simulation.agent.CChairAgent.m_iterative, and org.lightvoting.simulation.environment.CGroup.size().

     {
         final CGroup l_group = this.determineGroup();
 
         final int l_maxIndex = this.getMaxIndex( m_dissList );
         final double l_max = m_dissList.get( l_maxIndex );
         System.out.println( " max diss is " + l_max );
 
         if ( l_max > m_dissThreshold )
         {
             System.out.println( " Determining most dissatisfied voter " );
             final CVotingAgent l_maxDissAg = m_dissVoters.get( l_maxIndex );
             System.out.println( " Most dissatisfied voter is " + l_maxDissAg.name() );
             // remove vote of most dissatisfied voter from list
             m_bitVotes.remove( l_maxDissAg.getBitVote() );
             m_dissVoters.remove( l_maxDissAg );
             l_group.remove( l_maxDissAg );
 
             System.out.println( "Removing " + l_maxDissAg.name() );
 
             // remove diss Values for next iteration
             m_dissList.clear();
 
             m_iterative = true;
             l_group.makeReady();
 
             if ( l_group.size() == 0 )
                 System.out.println( " Voter list is empty, we are done " );
 
             return;
         }
 
         System.out.println( " No dissatisfied voter left, we are done " );
     }

Here is the call graph for this function:

void org.lightvoting.simulation.agent.CChairAgent.startElection ( )

Definition at line 208 of file CChairAgent.java.

     {
         final CGroup l_group = this.determineGroup();
         l_group.triggerAgents( this );
     }

void org.lightvoting.simulation.agent.CChairAgent.storeDiss	(	final String	p_name,
		final Double	p_diss,
		final Integer	p_iteration
	)

Parameters

p_diss	dissatisfaction value
p_iteration	iteration number

Definition at line 325 of file CChairAgent.java.

References org.lightvoting.simulation.agent.CChairAgent.m_dissList.

     {
         final CGroup l_group = this.determineGroup();
 
         m_dissList.add( p_diss );
         final CVotingAgent l_dissAg = l_group.determineAgent( p_name );
         m_dissVoters.add( l_dissAg );
 
         System.out.println( "Storing diss " + p_diss );
 
         if ( m_dissList.size() == l_group.size() )
         {
             final ITrigger l_trigger = CTrigger.from(
                 ITrigger.EType.ADDGOAL,
                 CLiteral.from(
                     "all/dissValues/received",
                     CRawTerm.from( p_iteration )
                 )
 
             );
 
             this.trigger( l_trigger );
 
             System.out.println( p_iteration + " All voters submitted their dissatisfaction value" );
         }
     }

void org.lightvoting.simulation.agent.CChairAgent.storeVote	(	final String	p_agentName,
		final BitVector	p_vote
	)

Parameters

p_vote vote

Definition at line 221 of file CChairAgent.java.

References org.lightvoting.simulation.agent.CChairAgent.m_bitVotes.

     {
         final CGroup l_group = this.determineGroup();
 
         m_agents.add( l_group.determineAgent( p_agentName ) );
         m_bitVotes.add( p_vote );
 
         if ( m_bitVotes.size() == l_group.size() )
         {
 
             final ITrigger l_trigger = CTrigger.from(
                 ITrigger.EType.ADDGOAL,
                 CLiteral.from(
                     "all/votes/received" )
 
             );
 
             System.out.println( " CChairAgent.java: all votes received " );
 
             this.trigger( l_trigger );
         }
     }

BitVector org.lightvoting.simulation.agent.CChairAgent.toBV ( final AtomicIntegerArray p_vote )

private

Definition at line 244 of file CChairAgent.java.

     {
         final BitVector l_bitVector = new BitVector( p_vote.length() );
         for ( int i = 0; i < p_vote.length(); i++ )
             if ( p_vote.get( i ) == 1 )
                 l_bitVector.put( i, true );
         return l_bitVector;
     }