meta_agents

[tpike3]

Summary

This PR is useful for creating meta-agents that represent groups of agents with interdependent characteristics.

New meta-agent classes are created dynamically using the provided name, attributes and functions of sub agents, and unique attributes and functions.

Motive

To allow for more complex models of multiple levels

Implementation

Method has three paths of execution:

1. Add agents to existing metaagent
2. Create new meta-agent instance of existing metaagent class
3. Create new meta-agent class

Usage Examples

I added a basic example of alliance formation using the bilateral shapley value

Step 0- 50 Agents:

Step 8 - 17 Agents of increasing hierarchy added dynamically during code execution:

Additional Notes

Currently restricted to one parent agent and one meta-agent per agent. Goal is to assess usage and expand functionality.

[tpike3]

Forgot to save when I ran tests so build failing

[github-actions]

Performance benchmarks:

Model	Size	Init time [95% CI]	Run time [95% CI]
BoltzmannWealth	small	🔵 -0.1% [-1.2%, +1.0%]	🔵 +0.5% [+0.3%, +0.6%]
BoltzmannWealth	large	🔵 +0.5% [-0.5%, +2.1%]	🔵 -1.0% [-1.8%, +0.0%]
Schelling	small	🔵 +1.5% [+1.1%, +1.9%]	🔴 +104.3% [+103.7%, +105.0%]
Schelling	large	🔵 +0.7% [+0.4%, +1.1%]	🔵 -0.7% [-1.3%, -0.2%]
WolfSheep	small	🔵 +0.5% [+0.1%, +0.9%]	🔵 +5.5% [+0.5%, +10.2%]
WolfSheep	large	🔵 +0.1% [-0.3%, +0.6%]	🔵 -0.6% [-1.3%, -0.0%]
BoidFlockers	small	🔵 +2.1% [+1.4%, +2.7%]	🔵 +1.6% [+0.8%, +2.5%]
BoidFlockers	large	🔵 +1.9% [+1.3%, +2.6%]	🔵 +0.6% [+0.0%, +1.1%]