Shareholder#

class bamengine.roles.shareholder.Shareholder(dividends)[source]#

Bases: Role

Shareholder role for households.

Tracks per-period dividend income for each household. The dividends array is overwritten each period by firms_pay_dividends with the current period’s dividend amount (total dividends / n_households).

Parameters:

dividends (Float1D) – Per-period dividend received by each household (overwritten each period, not cumulative).

Examples

Access from simulation:

>>> import bamengine as bam
>>> sim = bam.Simulation.init(n_households=500, seed=42)
>>> sh = sim.sh
>>> sh.dividends.shape
(500,)

Notes

The Shareholder role is one of three roles assigned to households:

  • Worker: employment and labor supply (see Worker)

  • Consumer: consumption and savings

  • Shareholder: per-period dividend income tracking

Currently dividends are distributed equally to all households. A future Capitalist extension will introduce firm ownership relationships to allow dividends to flow to specific households (shareholders).

See also

Consumer

Consumption role for households

Worker

Employment role for households

FirmsPayDividends

Dividend distribution event

dividends#

Per-period dividend received by each household (overwritten each period).

__init__(dividends)#
name = 'Shareholder'#