JCGEBlocks

What is a CGE?

A Computable General Equilibrium (CGE) model is a quantitative economic model that represents an economy as interconnected markets for goods and services, factors of production, institutions, and the rest of the world. It is calibrated with data (typically a Social Accounting Matrix) and solved numerically as a system of nonlinear equations until equilibrium conditions (zero-profit, market-clearing, and income-balance) hold within tolerance.

What is JCGE?

JCGE is a block-based CGE modeling and execution framework in Julia. It defines a shared RunSpec structure and reusable blocks so models can be assembled, validated, solved, and compared consistently across packages. See https://jcge.org for details.

What is this package?

Standard CGE blocks built on the JCGE interfaces (https://jcge.org).

Responsibilities

• Production blocks (nested production functions)
• Trade blocks (Armington/CET as needed)
• Institution blocks (households, government)
• Market clearing blocks

Dependencies

• Depends on JCGECore, JCGERuntime, and the broader JCGE stack (https://jcge.org)

How to cite

If you use the JCGE framework, please cite:

Boero, R. JCGE - Julia Computable General Equilibrium Framework [software], 2026. DOI: 10.5281/zenodo.18282436 URL: https://JCGE.org

@software{boero_jcge_2026,
  title  = {JCGE - Julia Computable General Equilibrium Framework},
  author = {Boero, Riccardo},
  year   = {2026},
  doi    = {10.5281/zenodo.18282436},
  url    = {https://JCGE.org}
}

If you use this package, please cite:

Boero, R. JCGEBlocks.jl - Reusable CGE blocks for JCGE. [software], 2026. DOI: 10.5281/zenodo.18290873 URL: https://blocks.jcge.org SourceCode: https://github.com/equicirco/JCGEBlocks.jl

@software{boero_jcgeblocks_2026,
  title  = {JCGEBlocks.jl - Reusable CGE blocks for JCGE.},
  author = {Boero, Riccardo},
  year   = {2026},
  doi    = {10.5281/zenodo.18290873},
  url    = {https://blocks.jcge.org}
}

If you use a specific tagged release, please cite the version DOI assigned on Zenodo for that release (preferred for exact reproducibility).

Naming and functional forms

Block names are composed as Domain + Role + FunctionalForm when relevant. Examples: ProductionCDBlock, UtilityCESBlock, TransformationCETBlock.

For extensibility, blocks that support multiple forms also expose a form field and can be constructed via a generic wrapper (e.g., ProductionBlock(form=:cd)). This keeps the API stable while making the functional form explicit.

Production supports mixed forms via a per-activity map:

form = Dict(:a1=>:cd, :a2=>:cd_leontief)
prod = JCGEBlocks.ProductionBlock(:prod, activities, factors, commodities, form, params)

Using the helper production(...; form=:cd) will expand the symbol to a map.

Helper constructors

For consistency, use the lower-case helpers (e.g., production, household_demand, utility, government, investment) which build the general entry-point blocks.

Single vs multi-region usage

Single-region models use the standard helpers:

prod = production(:prod, activities, factors, commodities; form=:cd, params=params)
hh = household_demand(:household, Symbol[], commodities, factors; form=:cd, consumption_var=:Xp, params=params)
util = utility(:utility, Symbol[], commodities; form=:cd, consumption_var=:Xp, params=(alpha=params.alpha,))

Multi-region models use the regional helpers and the world-market block:

gov = government_regional(:gov, goods_r, factors_r, :JPN, params)
hh = household_demand_regional(:hh, goods_r, factors_r, :JPN; params=params)
util = utility_regional(:utility, goods_by_region, (alpha=alpha,))
world = international_market(:world, goods, regions, mapping)

Block catalog (planned)

• Production: ProductionCDBlock, ProductionCESBlock, ProductionLeontiefBlock (with ProductionBlock(form=...))
• Production (sectoral factor prices): ProductionCDLeontiefSectorPFBlock
• Factor supply/endowment: fixed factor availability (labor/capital) and shocks
• Government: GovernmentBudgetBlock (taxes, spending, saving)
• Government budget balance: GovernmentBudgetBalanceBlock
• Investment: InvestmentDemandBlock, savings-investment identity
• Investment composition/allocation: CompositeInvestmentBlock, InvestmentAllocationBlock
• Household: HouseholdDemandBlock, UtilityCDBlock/UtilityCESBlock, private saving
• Household income demand: HouseholdDemandIncomeBlock
• Trade/Armington: ArmingtonCESBlock
• Transformation/CET: TransformationCETBlock
• Monopoly rent: MonopolyRentBlock
• Import quotas: ImportQuotaBlock
• Prices: WorldPriceLinkBlock, ExchangeRateLinkBlock
• External balance: balance of payments (foreign savings)
• Market clearing: GoodsMarketClearingBlock, CompositeMarketClearingBlock, FactorMarketClearingBlock
• Activity analysis (fixed coefficients): ActivityAnalysisBlock
• Endowment-based CD demand: ConsumerEndowmentCDBlock
• Commodity market clearing (MPSGE-style): CommodityMarketClearingBlock
• Factor mobility/capital stock: MobileFactorMarketBlock, CapitalStockReturnBlock
• Composite consumption/price level: CompositeConsumptionBlock, PriceLevelBlock
• Closure: numeraire + macro closure choices