{"id":25193825,"url":"https://github.com/sharathsphd/coffee_causality","last_synced_at":"2026-05-18T00:10:16.691Z","repository":{"id":275811734,"uuid":"927173551","full_name":"SharathSPhD/coffee_causality","owner":"SharathSPhD","description":"Data-driven analysis of coffee shop sales using correlation, regression, and causal inference. A Jupyter Book project exploring foot traffic, weather patterns, and business analytics.","archived":false,"fork":false,"pushed_at":"2025-02-04T17:58:35.000Z","size":12433,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-04T18:32:31.563Z","etag":null,"topics":["business-analytics","causal-inference","correlation","data-analysis","foot-traffic","forecasting","github-pages","jupyter-notebook","machine-learning","open-source","python","regression","retail-analytics","statistics","storytelling","time-series","visualization","weather-analysis"],"latest_commit_sha":null,"homepage":"https://sharathsphd.github.io/coffee_causality/intro.html","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SharathSPhD.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-04T14:28:02.000Z","updated_at":"2025-02-04T18:30:40.000Z","dependencies_parsed_at":"2025-02-04T18:44:15.375Z","dependency_job_id":null,"html_url":"https://github.com/SharathSPhD/coffee_causality","commit_stats":null,"previous_names":["sharathsphd/coffee_causality"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SharathSPhD%2Fcoffee_causality","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SharathSPhD%2Fcoffee_causality/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SharathSPhD%2Fcoffee_causality/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SharathSPhD%2Fcoffee_causality/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SharathSPhD","download_url":"https://codeload.github.com/SharathSPhD/coffee_causality/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247187875,"owners_count":20898392,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["business-analytics","causal-inference","correlation","data-analysis","foot-traffic","forecasting","github-pages","jupyter-notebook","machine-learning","open-source","python","regression","retail-analytics","statistics","storytelling","time-series","visualization","weather-analysis"],"created_at":"2025-02-09T23:22:40.778Z","updated_at":"2026-05-18T00:10:11.672Z","avatar_url":"https://github.com/SharathSPhD.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Coffee Shop Causality Analysis\n\nA Python package demonstrating causal inference methods through a coffee shop business case study.\n\n## Features\n\n- Synthetic data generation for coffee shop sales\n- Multiple causal inference methods:\n  - Correlation Analysis\n  - Instrumental Variables (IV)\n  - Double Machine Learning (DML)\n  - Transfer Entropy\n- Interactive visualizations\n- Story-driven Jupyter notebooks\n- Documentation using Sphinx\n- Comprehensive test suite\n\n## Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/yourusername/coffee_causality.git\ncd coffee_causality\n```\n\n2. Create and activate virtual environment:\n```bash\n# Windows\npython -m venv venv\n.\\venv\\Scripts\\activate\n\n# Linux/Mac\npython -m venv venv\nsource venv/bin/activate\n```\n\n3. Install dependencies:\n```bash\npip install -r requirements.txt\n```\n\n4. Set up Jupyter kernel:\n```bash\npython -m ipykernel install --user --name=coffee_causality_venv --display-name \"Python (coffee_causality)\"\n```\n\n## Project Structure\n\n```\ncoffee_causality/\n├── .github/                    # GitHub Actions workflows and templates\n├── book/                      # Documentation and tutorials\n├── docs/                      # Sphinx documentation\n│   ├── build/                # Generated documentation\n│   ├── source/              # Documentation source files\n│   ├── Makefile            # Documentation build script\n│   └── conf.py            # Sphinx configuration\n├── notebooks/                 # Jupyter notebooks\n│   ├── A_Problem_Definition.ipynb       # Problem setup and data generation\n│   ├── B_Initial_Analysis.ipynb        # Basic statistical analysis\n│   ├── C_Advanced_Analysis.ipynb       # Advanced causal methods\n│   └── D_Transfer_Entropy.ipynb        # Information flow analysis\n├── plots/                     # Generated visualizations\n├── results/                   # Analysis results and outputs\n├── src/                      # Source code\n│   ├── __init__.py\n│   ├── data_generator.py     # Synthetic data generation\n│   ├── causal_analysis.py    # Causal inference implementations\n│   └── visualization.py      # Visualization tools\n\n├── .gitignore               # Git ignore rules\n├── LICENSE                  # GPLv3 License\n├── README.md               # This file\n└── requirements.txt        # Project dependencies\n```\n\n## Core Components\n\n### Source Code (`src/`)\n- `data_generator.py`: Creates synthetic coffee shop data with hidden confounders\n- `causal_analysis.py`: Implements various causal inference methods\n- `visualization.py`: Provides visualization tools for analysis results\n\n### Documentation (`docs/`)\n- API Reference\n- Implementation details\n- Usage guides and tutorials\n- Example notebooks\n\n### Analysis Notebooks (`notebooks/`)\n- Step-by-step analysis examples\n- Interactive visualizations\n- Results interpretation\n\n## Dependencies\n\n- **Data Processing**\n  - numpy: Numerical computing\n  - pandas: Data manipulation\n  \n- **Visualization**\n  - matplotlib: Basic plotting\n  - seaborn: Statistical visualizations\n  - networkx: Network analysis\n  \n- **Machine Learning**\n  - scikit-learn: Machine learning utilities\n  - econml: Double ML implementation\n  \n- **Causal Analysis**\n  - statsmodels: Statistical modeling\n  - IDTxl: Information theory\n  \n- **Development**\n  - jupyter: Notebook interface\n  - pytest: Testing framework\n  - sphinx: Documentation generation\n  - sphinx-rtd-theme: Documentation theme\n\n## Documentation\n\nThe documentation is built using Sphinx and can be found in the `docs/` directory. To build the documentation:\n\n```bash\ncd docs\nmake html\n```\n\nThe built documentation will be available in `docs/build/html/index.html`.\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing_feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing_feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the GPLv3 License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsharathsphd%2Fcoffee_causality","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsharathsphd%2Fcoffee_causality","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsharathsphd%2Fcoffee_causality/lists"}