This repository contains Monte Carlo simulation models that project costs related to living expenses in major US cities and the annual economic cost of shipping carbon dioxide from Europe to US ports. It includes Jupyter notebooks, markdown reports, and supporting data files for reproducible analysis.
Features
- Monte Carlo simulations for cost of living projections in Houston and New York City.
- Monte Carlo modeling of the annual cost of shipping supercritical CO2 across the Atlantic.
- Transparent, reproducible computational notebooks combining data analysis and domain-specific modeling.
- Markdown reports documenting methodology, findings, and revisions.
Tech Stack
- Python 3 (Jupyter Notebooks)
- NumPy (for statistical sampling and distributions)
- Markdown for documentation
Getting Started
Prerequisites
Ensure Python 3 and Jupyter Notebook are installed. Recommended to use a virtual environment.
Installation
# Clone the repository
$ git clone https://github.com/justin-napolitano/cost-of-living-projections.git
$ cd cost-of-living-projections
# (Optional) Create and activate a virtual environment
$ python3 -m venv venv
$ source venv/bin/activate # On Windows use `venv\Scripts\activate`
# Install dependencies
$ pip install numpy jupyter
Running the Notebooks
Launch Jupyter Notebook:
$ jupyter notebook
Open and run the following notebooks:
cost_of_living_monte_carlo.ipynbβ Monte Carlo models for Houston and NYC cost of living.shipping_projections.ipynbβ Monte Carlo simulation of CO2 shipping costs.carbon-storage-projects.ipynbβ Related analysis on carbon storage projects.europe_ports.ipynbβ Data and analysis related to European ports.
Project Structure
βββ carbon-storage-projects.ipynb # Analysis of carbon storage projects
βββ cost_of_living_monte_carlo.ipynb # Monte Carlo models for cost of living
βββ cost_of_living_monte_carlo.md # Markdown report on cost of living projections
βββ cost_of_living_monte_carlo_files/ # Supporting files for cost of living notebooks
βββ europe_ports.ipynb # Data and analysis related to European ports
βββ histogram.png # Visualization image
βββ nyc-housing.csv # NYC housing data
βββ README.md # This file
βββ shipping_carbon_feasibility.md # Feasibility analysis of shipping carbon
βββ shipping_carbon_feasibility_files/ # Supporting files for feasibility report
βββ shipping_projections.ipynb # Monte Carlo simulation of shipping costs
βββ shipping_projections.md # Markdown report on shipping projections
βββ shipping_projections_files/ # Supporting files for shipping projections
Future Work / Roadmap
- Update cost of living data, particularly for Houston, with more recent and granular data sources.
- Refine Monte Carlo models with improved input distributions based on newly scraped or acquired data.
- Extend shipping cost models to incorporate more detailed infrastructure and operational variables.
- Automate data scraping and preprocessing to maintain up-to-date projections.
- Enhance documentation and add more comprehensive tests for reproducibility.