party
index
/home/gcallah/TandonDevOps/IndraABM/models/party.py

This is a model that inherits from model.py
Model description:
This model describes the flow pof population depends on the
number of male, female and beer

 
Modules
       
lib.actions
lib.model
random

 
Classes
       
lib.model.Model(builtins.object)
Party

 
class Party(lib.model.Model)
    Party(model_nm='model', props=None, grp_struct={'def_grp': {'mbr_creator': <function create_agent at 0x7c8bb5aeb790>, 'grp_action': None, 'mbr_action': <function def_action at 0x7c8bb5aeb8b0>, 'num_mbrs': 1, 'num_mbrs_prop': None, 'color': 'blue'}, 'red_grp': {'mbr_creator': <function create_agent at 0x7c8bb5aeb790>, 'grp_action': None, 'mbr_action': <function def_action at 0x7c8bb5aeb8b0>, 'num_mbrs': 1, 'num_mbrs_prop': None, 'color': 'red'}}, env_action=None, random_placing=True, serial_obj=None, exec_key=None, create_for_test=False)
 
The party model
 
 
Method resolution order:
Party
lib.model.Model
builtins.object

Methods defined here:
handle_props(self, props)
A generic parameter handling method.
We get height and width here, since so many models use them.

Methods inherited from lib.model.Model:
__init__(self, model_nm='model', props=None, grp_struct={'def_grp': {'mbr_creator': <function create_agent at 0x7c8bb5aeb790>, 'grp_action': None, 'mbr_action': <function def_action at 0x7c8bb5aeb8b0>, 'num_mbrs': 1, 'num_mbrs_prop': None, 'color': 'blue'}, 'red_grp': {'mbr_creator': <function create_agent at 0x7c8bb5aeb790>, 'grp_action': None, 'mbr_action': <function def_action at 0x7c8bb5aeb8b0>, 'num_mbrs': 1, 'num_mbrs_prop': None, 'color': 'red'}}, env_action=None, random_placing=True, serial_obj=None, exec_key=None, create_for_test=False)
Initialize self.  See help(type(self)) for accurate signature.
__repr__(self)
This returns a JSON representation of the model.
__str__(self)
Return str(self).
add_child(self, group)
Put a child agent in the womb.
group: which group will add new agent
The womb should move up into model eventually.
add_switch(self, agent_nm, from_grp_nm, to_grp_nm)
Switch agent from 1 group to another.
The agent and groups should be passed by name.
bar_graph(self)
collect_stats(self)
create_anew(self, model_nm, props, grp_struct, exec_key, env_action, random_placing, create_for_test=False)
Create the model for the first time.
create_env(self, env_action=None, random_placing=True)
Override this method to create a unique env...
but this one will already set the model name and add
the groups.
create_from_serial_obj(self, serial_obj)
Restore the model from its serialized version.
create_groups(self)
Override this method in your model to create all of your groups.
In general, you shouldn't need to: fill in the grp_struct instead.
create_pop_hist(self)
There are several methods that still (like in V2) reside in
Env, but which we mean to move to Model. So we provide an interface to
them here so when we move them other code won't break.
`create_pop_hist()` is such a method.
create_user(self)
This will create a user of the correct type.
from_json(self, jrep)
This method restores a model from its JSON rep.
get_locations(self)
get_periods(self)
get_pop_hist(self)
get_prop(self, prop_nm, default=None)
Have a way to get a prop through the model to hide props structure.
get_user_msgs(self)
handle_args(self)
handle_switches(self)
This will actually process the pending switches.
handle_womb(self)
This method adds new agents from the womb.
The womb should move up into model eventually.
is_api_user(self)
is_test_user(self)
line_graph(self)
pending_switches(self)
How many switches are there to execute?
rpt_census(self, acts, moves)
This is the default census report.
Right now, `acts` is not used: do we need it?
Return: a string saying what happened in a period.
rpt_stats(self)
This is a "wrap up" report on the results of a model run.
Each model can do what it wants here.
perhaps will take an iterator object?
a file?
Function takes in a CSV formatted string from function
collect_stats() and writes it to a csv file.
 
Note: added logic so func will not write to stdout
rpt_switches(self)
Generate a string to report our switches.
run(self, periods=None)
This method runs the model. If `periods` is not None,
it will run it for that many periods. Otherwise, on
a terminal, it will display the menu.
Return: 0 if run was fine.
runN(self, periods=10)
Run our model for N periods.
Return the total number of actions taken.
run_batch(self, runs, steps)
Run our model for N periods X steps.
Writes the period specific model statistics to a CSV file.
Files are saved as input filename-[integer-counter].csv
Returns the total number of actions taken.
scatter_plot(self)
to_json(self)
This method generates the JSON representation for this model.
update_pop_hist(self)
This method records our populations each period.

Data descriptors inherited from lib.model.Model:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

 
Functions
       
call_friend(agent)
move one agent in xxx_at_home to xxx_at_party
male at party will call male at home
female at party will call female at home
If the input agent is at home, then there is nothing happen
create_female(name, i, props=None, action=None, exec_key=None)
Create an female agent at the party
create_male(name, i, props=None, action=None, exec_key=None)
Create an male agent at the party
create_model(serial_obj=None, props=None)
drink_beer(agent, **kwargs)
Update the number of beer, and make sure every group at the party
share the same number of beer.
home_action(agent, **kwargs)
leave_party(agent)
change agent's group to xxx_at_party to xxx_at_home
If there is not beer to drink, leave the party
agent.set_attr(PLACE, HOME)
acts.add_switch(agent, agent.prim_group_nm(),
                opp_group[agent.prim_group_nm()])
main()

 
Data
        DEF_DRINK_BEER_RATE = 2
DEF_NUM_BEER = 15
DEF_NUM_MBRS = 5
DRINK_BEER_RATE = 'drink beer rate'
FEMALE = 'female'
FEMALE_AT_HOME = 'female at home'
FEMALE_AT_PARTY = 'female at party'
HOME = 'home'
MALE = 'male'
MALE_AT_HOME = 'male at home'
MALE_AT_PARTY = 'male at party'
MODEL_NAME = 'party'
NUM_OF_BEER = 'num of beer'
PARTY = 'party'
PLACE = 'place'
opp_group = {'female at home': 'female at party', 'female at party': 'female at home', 'male at home': 'male at party', 'male at party': 'male at home'}
party_grps = {'female at home': {'color': 'magenta', 'mbr_action': <function home_action>, 'mbr_creator': <function create_female>, 'num_mbrs': 5}, 'female at party': {'color': 'red', 'mbr_action': <function drink_beer>, 'mbr_creator': <function create_female>, 'num_mbrs': 5, 'num_mbrs_prop': 'initial_num_female_party'}, 'male at home': {'color': 'navy', 'mbr_action': <function home_action>, 'mbr_creator': <function create_male>, 'num_mbrs': 5}, 'male at party': {'color': 'blue', 'mbr_action': <function drink_beer>, 'mbr_creator': <function create_male>, 'num_mbrs': 5, 'num_mbrs_prop': 'initial_num_male_party'}}
party_opp_group = {'female at party': 'male at party', 'male at party': 'female at party'}