Demo of CCC for PSL Meetup#
This notebook provides a demonstration of the Cost-of-Capital-Calculator (CCC) for the PSL Meetup on April 29, 2019.
To run this notebook on your machine, you will need to follow the instructions to install CCC as described in the CCC README here. In particular, you need to:
Install the Anaconda distribution of Python
Install the CCC package by typing
conda install -c conda-forge ccc(orpip install cost-of-captial-calculator) in the command prompt.
Once you follow the above, you will be ready to work with this Jupyter Notebook.
First things first, import necessary packages#
# To install ccc package (if not already):
import sys
if 'ccc' not in sys.modules:
!pip install cost-of-capital-calculator
Requirement already satisfied: cost-of-capital-calculator in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (2.1.1)
Requirement already satisfied: taxcalc in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from cost-of-capital-calculator) (6.5.2)
Requirement already satisfied: pandas in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from cost-of-capital-calculator) (3.0.2)
Requirement already satisfied: bokeh in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from cost-of-capital-calculator) (3.9.0)
Requirement already satisfied: numpy in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from cost-of-capital-calculator) (2.4.3)
Requirement already satisfied: numba in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from cost-of-capital-calculator) (0.65.0)
Requirement already satisfied: paramtools in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from cost-of-capital-calculator) (0.20.0)
Requirement already satisfied: Jinja2>=2.9 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from bokeh->cost-of-capital-calculator) (3.1.6)
Requirement already satisfied: contourpy>=1.2 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from bokeh->cost-of-capital-calculator) (1.3.3)
Requirement already satisfied: narwhals>=1.13 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from bokeh->cost-of-capital-calculator) (2.19.0)
Requirement already satisfied: packaging>=16.8 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from bokeh->cost-of-capital-calculator) (26.1)
Requirement already satisfied: pillow>=7.1.0 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from bokeh->cost-of-capital-calculator) (12.2.0)
Requirement already satisfied: PyYAML>=3.10 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from bokeh->cost-of-capital-calculator) (6.0.3)
Requirement already satisfied: tornado>=6.2 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from bokeh->cost-of-capital-calculator) (6.5.5)
Requirement already satisfied: xyzservices>=2021.09.1 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from bokeh->cost-of-capital-calculator) (2026.3.0)
Requirement already satisfied: MarkupSafe>=2.0 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from Jinja2>=2.9->bokeh->cost-of-capital-calculator) (3.0.3)
Requirement already satisfied: llvmlite<0.48,>=0.47.0dev0 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from numba->cost-of-capital-calculator) (0.47.0)
Requirement already satisfied: python-dateutil>=2.8.2 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from pandas->cost-of-capital-calculator) (2.9.0.post0)
Requirement already satisfied: six>=1.5 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from python-dateutil>=2.8.2->pandas->cost-of-capital-calculator) (1.17.0)
Requirement already satisfied: marshmallow>=4.0.0 in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from paramtools->cost-of-capital-calculator) (4.3.0)
Requirement already satisfied: fsspec in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from paramtools->cost-of-capital-calculator) (2026.3.0)
Requirement already satisfied: sortedcontainers in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from paramtools->cost-of-capital-calculator) (2.4.0)
Requirement already satisfied: behresp in /home/runner/miniconda3/envs/ccc-dev/lib/python3.13/site-packages (from taxcalc->cost-of-capital-calculator) (0.11.0)
# import packages
import pandas as pd
import numpy as np
from bokeh.plotting import figure, show
from bokeh.io import output_notebook
# import CCC classes that we'll work with
from ccc.data import Assets
from ccc.parameters import Specification, DepreciationParams
from ccc.calculator import Calculator
# to print bokeh plots inline
output_notebook()
Create an instance of the Assets class#
This is the class that contains the data that underlie CCC. The basic object is a Pandas DataFrame where each row represents a combination of a specific type of asset, industry (approximately 6-digit NAICS) and tax treatment. The columns represent names and codes for the asset and industry classifications, the tax depreciation rules used for that asset, and the rate of economic depreciation (delta).
assets = Assets()
assets.df.head(n=5)
| Unnamed: 0 | tax_treat | assets | bea_asset_code | bea_ind_code | Industry | minor_code_alt | major_asset_group | minor_asset_group | major_industry | asset_name | delta | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0 | 0 | corporate | 0.0 | RD32 | 110C | Farms | 111 | Intellectual Property | Intellectual Property | Agriculture, forestry, fishing, and hunting | Aerospace products and parts manufacturing | 0.22 |
| 1 | 1 | corporate | 0.0 | RD32 | 113F | Forestry, fishing, and related activities | 113 | Intellectual Property | Intellectual Property | Agriculture, forestry, fishing, and hunting | Aerospace products and parts manufacturing | 0.22 |
| 2 | 2 | corporate | 0.0 | RD32 | 113F | Forestry, fishing, and related activities | 114 | Intellectual Property | Intellectual Property | Agriculture, forestry, fishing, and hunting | Aerospace products and parts manufacturing | 0.22 |
| 3 | 3 | corporate | 0.0 | RD32 | 2110 | Oil and gas extraction | 211110 | Intellectual Property | Intellectual Property | Mining | Aerospace products and parts manufacturing | 0.22 |
| 4 | 4 | corporate | 0.0 | RD32 | 2120 | Mining, except oil and gas | 212110 | Intellectual Property | Intellectual Property | Mining | Aerospace products and parts manufacturing | 0.22 |
Create instances of the two parameters classes#
The Specification class contains many of the model parameters, although depreciation system parameters are contained in the DepreciationParams class. Both are required arguments for the Calculator object.
A Specification object has methods that load the data from a file that contains the default parameter values (default_parameters.json) and then stores them as attributes of the Specification class object.
p.u looks into the instance of this class named p and executing the cell below will show you that p.u is dictionary containtin marginal tax rates on corporate and pass-through income.
Note that the Specification class has some arguments, such as call_tc, which defaults to False, but if set to True will call the Tax-Calculator to estimate marginal tax rates on individual filers’ income.
Similar to Specification, DepreciationParams loads default parameters from a JSON file, in this case the file tax_depreciation_rules.json.
# Create an instance of the Specification class
# p = Specification()
p = Specification(call_tc=True)
# Look at attributes
p.u
Using CPS
Calculator initial year = 2014
Calculator year = 2026
year: 2026
{'tau_pt': array([0.3091637]), 'tau_div': array([0.1836117]), 'tau_int': array([0.31832173]), 'tau_scg': array([0.30079057]), 'tau_lcg': array([0.19572499]), 'tau_td': array([0.20904989]), 'tau_h': array([0.07395446])}
{'c': array([0.21]), 'pt': array([0.3091637])}
# Create an instance of the DepreciationParams class
dp = DepreciationParams()
# Look at an attribute of the dp object
dp.EP1A
[{'value': {'system': 'GDS', 'life': 5.0, 'method': 'DB 200%'}, 'year': 2013}]
Create an instance of the Calculator class#
This class does the calculations on the data. It takes as arguments the data object (named assets here) and the parameters object (named p here).
Excuting the cell below creates an instance of the calculator class with these data and parameters, but does not yet excecute any calculations.
# Create an instance of the Calculator class
calc1 = Calculator(p, dp, assets)
With an instance of the Calculator class created, we can start doing some calculations with these data.
For instance, we can compute a table of the share of corporate vs non-corporate assets across each industry.
# Look at shares of assets across industry
calc1.asset_share_table()
| Industry | Corporate | Pass-Through | |
|---|---|---|---|
| 0 | Agriculture, forestry, fishing, and hunting | 0.309688 | 0.690312 |
| 1 | Mining | 0.826839 | 0.173161 |
| 2 | Utilities | 0.948540 | 0.051460 |
| 3 | Construction | 0.286840 | 0.713160 |
| 4 | Manufacturing | 0.859014 | 0.140986 |
| 5 | Wholesale trade | 0.715166 | 0.284834 |
| 6 | Retail trade | 0.728628 | 0.271372 |
| 7 | Transportation and warehousing | 0.789652 | 0.210348 |
| 8 | Information | 0.918722 | 0.081278 |
| 9 | Finance and insurance | 0.786056 | 0.213944 |
| 10 | Real estate and rental and leasing | 0.212052 | 0.787948 |
| 11 | Professional, scientific, and technical services | 0.501699 | 0.498301 |
| 12 | Management of companies and enterprises | 0.824397 | 0.175603 |
| 13 | Administrative and waste management services | 0.569110 | 0.430890 |
| 14 | Educational services | 0.590168 | 0.409832 |
| 15 | Health care and social assistance | 0.510425 | 0.489575 |
| 16 | Arts, entertainment, and recreation | 0.490811 | 0.509189 |
| 17 | Accommodation and food services | 0.482236 | 0.517764 |
| 18 | Other services, except government | 0.343467 | 0.656533 |
Specifying a reform policy#
To see some more interesting results, we will want to create another Calculator object with a change in policy or economic assumptions. We can do this in a way analogous to our original instantiation of the Calculator object above. In particular, we’ll need to create a new Specification object (we can use the same underlying data, which was in the object we named assets).
In the code below, we’ll specify our “reform” as current law tax policy for 2026 (the baseline parameters above came from the default model year, 2019). In addition, we’ll increase the corporate income tax rate from 21 to 25%.
# Create another policy
p2 = Specification(year=2026)
p2.update_specification({'CIT_rate': 0.35})
calc2 = Calculator(p2, dp, assets)
Tabular output#
Now with two Calculator objects named calc1 and calc2 (representing the baseline and reform policies), we are ready to compute some of the changes in effective tax rates, cost of capital, or other variables measured in this model.
We start with an overall summary table showing the marginal effective total tax rates (METTRs) for all investments, corporate investments, and pass-through investments under varying financing assumptions. This is done through the summary_table function. It takes a calculator object as an argument.
# Look at differences in METTRs between the two policies
calc1.summary_table(calc2) # calc1 is the baseline, calc2 the reform
| Marginal Effective Total Tax Rate Under Baseline Policy | Marginal Effective Total Tax Rate Under Reform Policy | Change from Baseline (pp) | ||
|---|---|---|---|---|
| 0 | Overall | 20.534616 | 33.775293 | 13.240677 |
| 1 | Corporations | 17.879366 | 40.396567 | 22.517201 |
| 2 | Equity Financed | 20.765483 | 44.183168 | 23.417685 |
| 3 | Debt Financed | 7.437863 | 24.552082 | 17.114219 |
| 4 | Pass-Through Entities | 24.953403 | 25.133693 | 0.180290 |
| 5 | Equity Financed | 26.673987 | 26.905401 | 0.231413 |
| 6 | Debt Financed | 17.055443 | 16.962702 | -0.092741 |
the Calculator.summary_table() method defaults to showing the results for the METTR, but there is a keyword argument that would allow you to view the output for other variables computed in CCC. We can use this to see changes in the cost of capital (denoted by \(\rho\) in the model):
# Look at how the cost of capital changed
calc1.summary_table(calc2, output_variable='rho')
| Cost of Capital Under Baseline Policy | Cost of Capital Under Reform Policy | Change from Baseline (pp) | ||
|---|---|---|---|---|
| 0 | Overall | 5.882398 | 7.058499 | 1.176101 |
| 1 | Corporations | 5.692199 | 7.842619 | 2.150420 |
| 2 | Equity Financed | 6.568428 | 9.324181 | 2.755753 |
| 3 | Debt Financed | 3.833356 | 4.702894 | 0.869539 |
| 4 | Pass-Through Entities | 6.109115 | 6.123827 | 0.014712 |
| 5 | Equity Financed | 7.097703 | 7.120174 | 0.022471 |
| 6 | Debt Financed | 3.698001 | 3.693871 | -0.004130 |
One can also save results to disk by specifying an output type (‘excel’, ‘json’, ‘csv’, ‘tex’) and a file path:
# Save these results to disk
calc1.summary_table(calc2, output_variable='rho', output_type='excel', path='cc_table.xlsx')
There are also Calculator methods to compute summary tables by asset type or industry. These are computed in the next two cells.
# Summary by asset type
calc1.asset_summary_table(calc2)
| Category | Marginal Effective Total Tax Rate Under Baseline Policy | Marginal Effective Total Tax Rate Under Reform Policy | Change from Baseline (pp) | |
|---|---|---|---|---|
| 0 | Overall | 20.534616 | 33.775293 | 13.240677 |
| 1 | Corporate | 17.879366 | 40.396567 | 22.517201 |
| 2 | Equipment | 6.939423 | 47.276329 | 40.336906 |
| 3 | Structures | 18.507616 | 35.523582 | 17.015965 |
| 4 | Intellectual Property | 6.939423 | 50.975397 | 44.035975 |
| 5 | Inventories | 29.211394 | 39.697137 | 10.485743 |
| 6 | Land | 26.482144 | 35.605173 | 9.123029 |
| 7 | Pass-through | 24.953403 | 25.133693 | 0.180290 |
| 8 | Equipment | -2.393863 | -2.264685 | 0.129179 |
| 9 | Structures | 22.870773 | 23.049730 | 0.178957 |
| 10 | Intellectual Property | -2.393863 | -2.264685 | 0.129179 |
| 11 | Inventories | 33.514165 | 33.691998 | 0.177833 |
| 12 | Land | 29.262602 | 29.445701 | 0.183099 |
# Summary by industry
calc1.industry_summary_table(calc2)
| Category | Marginal Effective Total Tax Rate Under Baseline Policy | Marginal Effective Total Tax Rate Under Reform Policy | Change from Baseline (pp) | |
|---|---|---|---|---|
| 0 | Overall | 20.534616 | 33.775293 | 13.240677 |
| 1 | Corporate | 17.879366 | 40.396567 | 22.517201 |
| 2 | Agriculture, forestry, fishing, and hunting | 18.743100 | 37.167827 | 18.424727 |
| 3 | Mining | 9.884838 | 37.629695 | 27.744857 |
| 4 | Utilities | 7.953978 | 30.244320 | 22.290342 |
| 5 | Construction | 19.279806 | 42.318383 | 23.038577 |
| 6 | Manufacturing | 18.156963 | 43.911390 | 25.754427 |
| 7 | Wholesale trade | 23.547580 | 43.276091 | 19.728511 |
| 8 | Retail trade | 24.554598 | 40.848842 | 16.294244 |
| 9 | Transportation and warehousing | 11.154932 | 36.009138 | 24.854206 |
| 10 | Information | 10.555951 | 41.108793 | 30.552842 |
| 11 | Finance and insurance | 18.806294 | 47.214743 | 28.408450 |
| 12 | Real estate and rental and leasing | 24.524221 | 37.116146 | 12.591924 |
| 13 | Professional, scientific, and technical ser... | 14.738673 | 50.935007 | 36.196333 |
| 14 | Management of companies and enterprises | 22.585830 | 45.139717 | 22.553887 |
| 15 | Administrative and waste management services | 14.453564 | 45.623551 | 31.169987 |
| 16 | Educational services | 22.571098 | 40.355980 | 17.784882 |
| 17 | Health care and social assistance | 20.729902 | 41.259664 | 20.529762 |
| 18 | Arts, entertainment, and recreation | 15.695304 | 37.897506 | 22.202202 |
| 19 | Accommodation and food services | 24.172861 | 39.857824 | 15.684963 |
| 20 | Other services, except government | 20.935523 | 39.113151 | 18.177628 |
| 21 | Pass-through | 24.953403 | 25.133693 | 0.180290 |
| 22 | Agriculture, forestry, fishing, and hunting | 20.674710 | 20.849822 | 0.175112 |
| 23 | Mining | 3.549464 | 3.694729 | 0.145265 |
| 24 | Utilities | 0.030808 | 0.166916 | 0.136108 |
| 25 | Construction | 20.984893 | 21.161206 | 0.176312 |
| 26 | Manufacturing | 18.131776 | 18.302764 | 0.170987 |
| 27 | Wholesale trade | 28.109367 | 28.287537 | 0.178171 |
| 28 | Retail trade | 28.421091 | 28.600500 | 0.179409 |
| 29 | Transportation and warehousing | 6.197178 | 6.348896 | 0.151718 |
| 30 | Information | 4.775218 | 4.923426 | 0.148207 |
| 31 | Finance and insurance | 24.137030 | 24.316051 | 0.179021 |
| 32 | Real estate and rental and leasing | 27.876832 | 28.059466 | 0.182635 |
| 33 | Professional, scientific, and technical ser... | 11.436593 | 11.598821 | 0.162227 |
| 34 | Management of companies and enterprises | 23.633720 | 23.812304 | 0.178584 |
| 35 | Administrative and waste management services | 10.839475 | 11.000807 | 0.161332 |
| 36 | Educational services | 23.531744 | 23.711555 | 0.179811 |
| 37 | Health care and social assistance | 20.817557 | 20.994495 | 0.176938 |
| 38 | Arts, entertainment, and recreation | 12.537359 | 12.702049 | 0.164690 |
| 39 | Accommodation and food services | 26.249878 | 26.430172 | 0.180294 |
| 40 | Other services, except government | 20.734681 | 20.911689 | 0.177008 |
Visualizations#
If one wants to visualize the effects of changes in tax policy, the Calculator class has a few methods for this.
We can use the grouped_bar method to show differential effects across assets (the default):
# Visualizing changes by asset type
aplot = calc1.grouped_bar(calc2)
show(aplot)
or we can change from the default asset category split to a split by industry by changing the value of the group_by_asset keyword argument:
# Visualizing changes by industry
iplot = calc1.grouped_bar(calc2, group_by_asset=False)
show(iplot)
There’s also a plot that illustrates the range of the effects of taxes on investments across asset types, by showing the min, max, and mean values:
# Plot to show variation in METTRs across assets
rplot = calc1.range_plot(calc2, output_variable='metr')
show(rplot)
changing to show the effects on pass-through businesses and for a different output variable:
show(rplot)
# Plot to show variation in METTRs across assets
output_notebook()
rplot2 = calc1.range_plot(calc2, corporate=False, output_variable='mettr')
show(rplot2)
There’s a bubble plot too, though it doesn’t yet allow for many options (currently only plots METTRs for corporate entities):
bplot = calc1.asset_bubble(calc2)
show(bplot)
WARNING:bokeh.core.validation.check:W-1000 (MISSING_RENDERERS): Plot has no renderers: figure(id='p1363', ...)
WARNING:bokeh.core.validation.check:W-1000 (MISSING_RENDERERS): Plot has no renderers: figure(id='p1421', ...)
Summary#
This notebook provides a brief example of how one would work with CCC. Please explore the source code to see additional flexiblity in the functions. And please leave any questions or suggestions in the CCC repo at PSLmodels/Cost-of-Capital-Calculator#issues.