How econviz/utility-viz works
utility-viz is a Python toolkit for creating microeconomics diagrams from utility models through equilibrium analysis to rendered and exported figures. The main workflow defines or parses a utility function, solves a consumer optimum, then builds and saves a Canvas; the CLI exposes plotting and closed-form demand output. The graph also preserves documented analysis, diagram, layout, interactive, animation, theme, and TikZ capabilities. Edges cite README-described behavior or shown caller code; unsampled subsystem links are dashed and unverified.
Main entry points: plot.py Plot command · base.py Canvas · solver.py Equilibrium solver · core.py Utility models
Components 23
Entry points
- CLI
utility_viz/cli/main.py - Plot command
utility_viz/cli/plot.py
Economic models
- Utility parser
utility_viz/models/utility/parser.py - Utility models
utility_viz/models/utility/core.py - Equilibrium solver
utility_viz/models/optimization/solver.py - Analysis tools
utility_viz/models/optimization - Price and income paths
utility_viz/models/consumer/paths.py - Logging
utility_viz/utils/logging.py
Diagram composition
- Canvas
utility_viz/core/canvas/base.py - Diagram layers
utility_viz/core/canvas/layers.py - Demand diagram
utility_viz/core/diagrams/consumer/demand.py - Edgeworth box
utility_viz/core/diagrams/consumer/edgeworth - Multi-panel figure
utility_viz/core/layout/figure.py - Animation
utility_viz/core/animation/animator.py
Rendering and style
- Themes
utility_viz/core/themes/theme.py - Diagram settings
utility_viz/core/config/settings.py - Style objects
utility_viz/core/styles - Style application
utility_viz/core/rendering/stroke.py - Package errors
utility_viz/core/errors/exceptions.py
Output and interaction
- Figure export
utility_viz/core/export/exporter.py - TikZ backend
utility_viz/core/export/backend_tikz/renderer.py - Interactive widgets
utility_viz/core/interactive/widgets.py
Other components
- Python user
Connections 27
- Python user → Utility models: defines model
- Python user → Equilibrium solver: solves optimum
- Python user → Canvas: builds diagram
- Utility parser → Utility models: instantiates model
utility_viz/models/utility/parser.py - Equilibrium solver → Utility models: evaluates utility
utility_viz/models/optimization/solver.py - Python user → Analysis tools: requests analysis
- Python user → Price and income paths: builds paths
- Canvas → Diagram layers: adds layers
utility_viz/core/canvas/layers.py - Canvas → Themes: uses theme
utility_viz/core/canvas/base.py - Diagram settings → Themes: configures theme
utility_viz/core/config/settings.py - Diagram layers → Style application: styles artists
utility_viz/core/canvas/layers.py - Style objects → Style application: provides styles
utility_viz/core/rendering/stroke.py - Python user → Multi-panel figure: assembles panels
- Multi-panel figure → Canvas: creates panels
utility_viz/core/layout/figure.py - Python user → Demand diagram: builds demand view
- Python user → Edgeworth box: builds exchange view
- Python user → Animation: animates diagrams
- Python user → Interactive widgets: uses playground
- Python user → CLI: runs command
- CLI → Plot command: dispatches plot
utility_viz/cli/main.py - Plot command → Utility parser: builds model
utility_viz/cli/plot.py - Plot command → Equilibrium solver: solves optimum
utility_viz/cli/plot.py - Plot command → Canvas: builds diagram
utility_viz/cli/plot.py - Plot command → Diagram settings: loads settings
utility_viz/cli/plot.py - Python user → Figure export: saves figure
- Figure export → TikZ backend: renders TikZ
- Equilibrium solver → Logging: logs progress
utility_viz/models/optimization/solver.py