Update SMM and related files

README.md

@@ -4,7 +4,7 @@
 | --- | --- |
 | Org | [![OSE Lab cataloged](https://img.shields.io/badge/OSE%20Lab-catalogued-critical)](https://github.com/OpenSourceEcon) [![OS License: AGPL-3.0](https://img.shields.io/badge/OS%20License-AGPL%203.0-yellow)](https://github.com/OpenSourceEcon/CompMethods/blob/main/LICENSE) |
 | Package | [![Python 3.10](https://img.shields.io/badge/python-3.10-blue.svg)](https://www.python.org/downloads/release/python-31013/) [![Python 3.11](https://img.shields.io/badge/python-3.11-blue.svg)](https://www.python.org/downloads/release/python-3115/) [![PyPI Latest Release](https://img.shields.io/pypi/v/compmethods.svg)](https://pypi.org/project/compmethods/) [![PyPI Downloads](https://img.shields.io/pypi/dm/compmethods.svg?label=PyPI%20downloads)](https://pypi.org/project/compmethods/) |
-| Testing | ![example event parameter](https://github.com/OpenSourceEcon/CompMethods/actions/workflows/build_and_test.yml/badge.svg?branch=main) ![example event parameter](https://github.com/OpenSource/CompMethods/actions/workflows/deploy_docs.yml/badge.svg?branch=main) ![example event parameter](https://github.com/OpenSourceEcon/CompMethods/actions/workflows/check_format.yml/badge.svg?branch=main) [![Codecov](https://codecov.io/gh/OpenSourceEcon/CompMethods/branch/main/graph/badge.svg)](https://codecov.io/gh/OpenSourceEcon/compmethods) |
+| Testing | ![example event parameter](https://github.com/OpenSourceEcon/CompMethods/actions/workflows/build_and_test.yml/badge.svg?branch=main) ![example event parameter](https://github.com/OpenSourceEcon/CompMethods/actions/workflows/deploy_docs.yml/badge.svg?branch=main) ![example event parameter](https://github.com/OpenSourceEcon/CompMethods/actions/workflows/check_format.yml/badge.svg?branch=main) [![Codecov](https://codecov.io/gh/OpenSourceEcon/CompMethods/branch/main/graph/badge.svg)](https://codecov.io/gh/OpenSourceEcon/compmethods) |
 
 This repository contains the source material, code, and data for the book, [*Computational Methods for Economists using Python*](https://opensourceecon.github.io/CompMethods/), by Richard W. Evans (2023). This book is freely available online as an executable Jupyter Book at https://opensourceecon.github.io/CompMethods.
 

docs/book/CompMethods_references.bib

@@ -5,6 +5,42 @@ @BOOK{AddaCooper:2003
   YEAR = {2003},
 }
 
+@ARTICLE{AttanasioEtAl:2020,
+  AUTHOR = {Orazio Attanasio and Sarah Cattan and Emla Fitzsimons and Costas Meghir and Marta {Rubio-Codina}},
+  TITLE = {Estimating the Production Function for Human Capital: Results from a Randomized Control Trial in Colombia},
+  JOURNAL = {American Economic Review},
+  YEAR = {2020},
+  volume = {110},
+  number = {1},
+  pages = {48-85},
+  month = {January},
+  url = {https://pubs.aeaweb.org/doi/pdfplus/10.1257/aer.20150183},
+}
+
+@ARTICLE{BaileyEtAl:2019,
+  AUTHOR = {Martha J. Bailey and Olga Malkova and Zo\"{e} M. McLaren},
+  TITLE = {Does Access to Family Planning Increase Children's Opportunities? Evidence from the War on Poverty and the Early Years of Title X},
+  JOURNAL = {Journal of Human Resources},
+  YEAR = {2019},
+  volume = {54},
+  number = {4},
+  pages = {825-856},
+  month = {Fall},
+  url = {https://jhr.uwpress.org/content/54/4/825},
+}
+
+@ARTICLE{BarskySims:2012,
+  AUTHOR = {Barsky and Sims},
+  TITLE = {Information, Animal Spirits, and the Meaning of Innovations in Consumer Confidence},
+  JOURNAL = {American Economic Review},
+  YEAR = {2012},
+  volume = {102},
+  number = {4},
+  pages = {1343-1377},
+  month = {June},
+  url = {https://pubs.aeaweb.org/doi/pdfplus/10.1257/aer.102.4.1343},
+}
+
 @ARTICLE{BrockMirman:1972,
   AUTHOR = {William A. Brock and Leonard J. Mirman},
   TITLE = {Optimal Economic Growth and Uncertainty: The Discounted Case},
@@ -156,6 +192,18 @@ @ARTICLE{NeweyWest:1987
   month = {May}
 }
 
+@ARTICLE{Rust:1987,
+  AUTHOR = {John Rust},
+  TITLE = {Optimal Replacement of GMC Bus Engines: An Empirical Model of Harold Zurcher},
+  JOURNAL = {Econometrica},
+  YEAR = {1987},
+  volume = {55},
+  number = {5},
+  pages = {999-1033},
+  month = {September},
+  url = {https://www.jstor.org/stable/1911259},
+}
+
 @ARTICLE{Rust:2010,
   AUTHOR = {John Rust},
   TITLE = {Comments on: `Structural vs. Atheoretic Approaches to Econometrics'},
@@ -176,3 +224,15 @@ @INCOLLECTION{Smith:2020
   editor = {Matias Vernengo and Esteban Perez Caldentey and Barkley J. Rosser Jr.},
   url = {http://www.econ.yale.edu/smith/palgrave7.pdf},
 }
+
+@ARTICLE{StraubWerning:2020,
+  AUTHOR = {Ludwig Straub and Iv\'{a}n Werning},
+  TITLE = {Positive Long-run Capital Taxation: Chamley-Judd Revisited},
+  JOURNAL = {American Economic Review},
+  YEAR = {2020},
+  volume = {110},
+  number = {1},
+  pages = {86-119},
+  month = {January},
+  url = {https://pubs.aeaweb.org/doi/pdfplus/10.1257/aer.20150210},
+}

docs/book/_config.yml

@@ -75,22 +75,9 @@ repository:
   branch: main
   path_to_book: "docs/book"
 
-#######################################################################################
-# Advanced and power-user settings
-sphinx:
-  extra_extensions          : ['sphinx.ext.autodoc', 'sphinx.ext.mathjax',
-                               'sphinx.ext.viewcode', 'sphinx.ext.napoleon',
-                               'alabaster']   # A list of extra extensions to load by Sphinx.
-  config                    :   # key-value pairs to directly over-ride the Sphinx configuration
-    bibtex_reference_style: author_year
-    mathjax_path          : https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
-
 #######################################################################################
 # Advanced Sphinx settings
 sphinx:
-  extra_extensions: ['sphinx.ext.autodoc', 'sphinx.ext.mathjax',
-                     'sphinx.ext.viewcode', 'sphinx.ext.napoleon',
-                     'alabaster', 'sphinx_exercise']  # A list of extra extensions to load by Sphinx.
   config:  # key-value pairs to directly over-ride the Sphinx configuration
     bibtex_reference_style: author_year
     mathjax_path: https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
@@ -104,4 +91,6 @@ sphinx:
     - "sphinx.ext.viewcode"
     - "sphinx.ext.napoleon"
     - "sphinx.ext.mathjax"
+    - "alabaster"
     - "sphinx_exercise"
+    - "sphinx_proof"

docs/book/_static/custom.css

@@ -0,0 +1,15 @@
+/* docs/book/_static/custom.css */
+
+:root {
+    --background-color: rgba(55, 253, 20, 0.158);
+    --border-color: #9cfd14bb;
+}
+
+div.green {
+    background-color: var(--background-color);
+    border-color: var(--border-color);
+}
+
+div.green p.admonition-title {
+    background-color: var(--background-color);
+}

docs/book/appendix/glossary.md

@@ -20,6 +20,9 @@ Box, Inc.
 branch
   TODO: define branch
 
+calibration
+  TODO
+
 centralized version control system
   A centralized version control system or CVCS is an approach to version control in which all the files in a {term}`repository` as well as the change history (content and timing) are located on a central {term}`remote` server. User's check out versions of files from the repository and check them back in, creating new change history on the central server.
 
@@ -38,12 +41,21 @@ commit
 continuous integration
   Continuous integration or continuous integration unit testing is...
 
+data generating process (DGP)
+  The broadest definition of a data generating process (DGP) is a complete description of the mechanism that causes some observed phenomenon with all its dependencies. Unfortunately, in most realistic systems, this definition is too complex. A more practical definition of a data generating process is a simplified version of the process that causes some observed phenomenon with its key dependencies. The concept of a DGP is very similar to the concept of a {term}`model` . A key characteristic of a DGP is that it must be specified in such as way that it could be used to simulate data.
+
 distributed version control system
   A *distributed version control system* or DVCS is {term}`version control system` software on any computer, {term}`local` or {term}`remote`, that tracks the entire history of changes to a {term}`repository` and coordinates and organizes collaboration among multiple users. It is distributed in the sense that multiple {term}`clone`s of a single {term}`remote` repository have the same full history of that repository.
 
 Dropbox
   TODO: define Dropbox
 
+endogenous variables
+  Endogenous variables are outputs of the model or dependent on exogenous variables. These can include portions of the data $x$, sometimes designated as $y$ as in $y = g(x,\theta)$.
+
+exogenous variables
+  Exogenous variables are inputs to the model, taken as given, or from outside the model. These can include both data $x$ and parameters $\theta$.
+
 fork
   TODO: define fork
 
@@ -83,6 +95,9 @@ local version control system
 merge
   TODO: create *merge* entry...
 
+model
+  A model is a set of cause and effect mathematical relationships, often specified with parameters $\theta$, among data $x$ or $(x,y)$ used to understand, explain, and predict phenomena. A model might be specified as $g(x,\theta) = 0$ or $y = g(x,\theta)$, where $g$ is a function or vector of functions that represents the mathematical relationships between variables and parameters.
+
 OG-Core
   *`OG-Core`* is an open source large scale overlapping generations macroeconomic model of fiscal policy. This model is general and is a dependency of country calibrations that use `OG-Core`, such as `OG-USA`.
 
@@ -92,6 +107,12 @@ open source
 pull request
   TODO: define *pull request*...
 
+reduced form estimation
+  TODO
+
+reduced form model
+  A reduced form model in economics is a model in which the equations are either not derived from behavioral equations or are only implicitly a linear approximation of some more complicated model. However, because they are atheoretical and often nonparametric, machine learning models can be categorized as reduced form. Reduced form models are most often static, although time series econometric models are categorized as reduced form.
+
 remote
   *Remote* is a descriptor that refers to files that reside or operations that are carried out on a server to which a user has access using the internet.
 
@@ -101,6 +122,12 @@ repository
 source code management service
   A *source code management service* is a {term}`cloud` platform that hosts computer code files and provides either {term}`centralized version control system` (CVCS) or {term}`distributed version control system`. As the central hub of either CVCS or DVCS, the source code management service provides the platform and rules for distributed code collaboration. Leading examples are {term}`GitHub` and {term}`Bitbucket`.
 
+structural estimation
+  TODO
+
+structural model
+  A structural model in economics is a model in which the mathematical relationships among variables and parameters are derived from individuals', firms', or other organizations' optimization. These are often referred to as behavioral equations. Structural models can include linear models and linear approximations. But most often, structural models are nonlinear and dynamic.
+
 unit testing
   Unit testing is...
 

docs/book/conf.py

@@ -0,0 +1,11 @@
+# conf.py
+
+html_static_path = ["./_static"]
+
+# CSS files
+html_css_files = [
+    "custom.css",
+]
+
+# Get rid of transitions error/warning
+myst_footnote_transition = False

docs/book/struct_est/GMM.md

@@ -1,7 +1,7 @@
 (Chap_GMM)=
 # Generalized Method of Moments Estimation
 
-Put GMM chapter here.
+The most recent version of the [`GMMest.ipynb`](https://github.com/rickecon/StructEst_W20/blob/master/Notebooks/GMM/GMMest.ipynb) notebook is currently in the [StructEst_W20](https://github.com/rickecon/StructEst_W20) repository in the [`/Notebooks/GMM`](https://github.com/rickecon/StructEst_W20/tree/master/Notebooks/GMM) directory. All the accompanying data and images are also in that directory. I will be updating this chapter to include all the content from the [`GMMest.ipynb`](https://github.com/rickecon/StructEst_W20/blob/master/Notebooks/GMM/GMMest.ipynb) notebook along with exercises and lecture content from the GMM section of that course.
 
 
 (SecGMMFootnotes)=

docs/book/struct_est/MaxLikelihood.md

@@ -1,7 +1,7 @@
 (Chap_MaxLikeli)=
 # Maximum Likelihood Estimation
 
-Put maximum likelihood estimation chapter here.
+The most recent version of the [`MLest.ipynb`](https://github.com/rickecon/StructEst_W20/blob/master/Notebooks/MLE/MLest.ipynb) notebook is currently in the [StructEst_W20](https://github.com/rickecon/StructEst_W20) repository in the [`/Notebooks/MLE`](https://github.com/rickecon/StructEst_W20/tree/master/Notebooks/MLE) directory. All the accompanying data and images are also in that directory. I will be updating this chapter to include all the content from the [`MLest.ipynb`](https://github.com/rickecon/StructEst_W20/blob/master/Notebooks/MLE/MLest.ipynb) notebook along with exercises and lecture content from the maximum likelihood estimation section of that course.
 
 
 (SecMaxLikeliFootnotes)=