Loading your own SAM

A social accounting matrix (SAM) records a balanced set of payments between production, factors, institutions, investment, government, and the rest of the world.

For a SAM using the canonical Hosoe account names:

from cge_core import StandardCGE

economy = StandardCGE.from_sam("sam.csv")
base = economy.solve()

For a country-specific SAM, state the economic roles explicitly:

economy = StandardCGE.from_sam(
    "country_sam.csv",
    factors=["LAB", "CAP"],
    household="HH",
    government="GOVT",
    investment="SAVINV",
    rest_of_world="ROW",
    indirect_tax="PTAX",
    tariff="TARIFF",
)
base = economy.solve()

from_sam() validates and converts the accounting table into the internal dataset expected by the Standard CGE model. A balanced SAM is necessary, but it does not by itself guarantee that every empirical SAM matches the Hosoe model’s structural assumptions.

If a temporary internal dataset is created, StandardCGE manages its lifecycle. For long-running applications, it may also be used as a context manager.