Class SwarmBuilder

java.lang.Object
com.tnsai.coordination.groups.swarm.SwarmBuilder

public final class SwarmBuilder extends Object
Builder for creating Swarm instances.

Usage Example


 Swarm swarm = Swarm.builder()
     .name("Explorer Swarm")
     .behavior(SwarmBehavior.EXPLORATION)
     .intelligence(SwarmIntelligence.antColony(0.5, 0.3))
     .neighborDetection(NeighborDetection.random())
     .neighborRadius(5)
     .pheromoneDecay(0.15)
     .add(agent1, agent2, agent3)
     .build();
 
  • Method Details

    • id

      public SwarmBuilder id(String id)
      Sets the swarm ID.
      Parameters:
      id - swarm ID
      Returns:
      this builder
    • name

      public SwarmBuilder name(String name)
      Sets the swarm name.
      Parameters:
      name - swarm name
      Returns:
      this builder
    • description

      public SwarmBuilder description(String description)
      Sets the swarm description.
      Parameters:
      description - swarm description
      Returns:
      this builder
    • behavior

      public SwarmBuilder behavior(SwarmBehavior behavior)
      Sets the swarm behavior.
      Parameters:
      behavior - behavior type
      Returns:
      this builder
    • intelligence

      public SwarmBuilder intelligence(SwarmIntelligence intelligence)
      Sets the swarm intelligence algorithm.
      Parameters:
      intelligence - intelligence strategy
      Returns:
      this builder
    • neighborDetection

      public SwarmBuilder neighborDetection(NeighborDetection detection)
      Sets the neighbor detection strategy.
      Parameters:
      detection - detection strategy
      Returns:
      this builder
    • neighborRadius

      public SwarmBuilder neighborRadius(int radius)
      Sets the neighbor radius.
      Parameters:
      radius - detection radius
      Returns:
      this builder
    • pheromoneDecay

      public SwarmBuilder pheromoneDecay(double decay)
      Sets the pheromone decay rate.
      Parameters:
      decay - decay rate (0.0 to 1.0)
      Returns:
      this builder
    • policy

      public SwarmBuilder policy(com.tnsai.agents.groups.GroupPolicy policy)
      Sets the group policy.
      Parameters:
      policy - policy
      Returns:
      this builder
    • add

      public SwarmBuilder add(com.tnsai.agents.Agent agent)
      Adds a member to the swarm.
      Parameters:
      agent - agent to add
      Returns:
      this builder
    • add

      public SwarmBuilder add(com.tnsai.agents.Agent... agents)
      Adds multiple members to the swarm.
      Parameters:
      agents - agents to add
      Returns:
      this builder
    • addAll

      public SwarmBuilder addAll(List<com.tnsai.agents.Agent> agents)
      Adds multiple members to the swarm.
      Parameters:
      agents - agents to add
      Returns:
      this builder
    • autoStart

      public SwarmBuilder autoStart(boolean autoStart)
      Sets whether to auto-start after build.
      Parameters:
      autoStart - auto-start flag
      Returns:
      this builder
    • build

      public Swarm build()
      Builds the Swarm.
      Returns:
      new Swarm instance