Metadata-Version: 2.1
Name: cafelytics
Version: 0.0.1
Summary: Open-Source Agricultural Simulation for coffee cooperatives
Home-page: https://github.com/mathematicalmichael/cafelytics.git
Author: Mathematical Michael
Author-email: consistentbayes@gmail.com
License: mit
Project-URL: Documentation, https://pyscaffold.org/
Description: <p align="left">
        <a href="https://pypi.org/project/cafelytics/"><img alt="PyPI" src="https://img.shields.io/pypi/v/cafelytics"></a>
        <a href="https://github.com/mindthegrow/cafelytics/actions"><img alt="Test Actions Status" src="https://github.com/mindthegrow/cafelytics/actions/workflows/main.yml/badge.svg"></a>
        <a href="https://github.com/mindthegrow/cafelytics/actions"><img alt="Build Actions Status" src="https://github.com/mindthegrow/cafelytics/actions/workflows/build.yml/badge.svg"></a>
        <a href="https://github.com/mindthegrow/cafelytics/actions"><img alt="Publish Actions Status" src="https://github.com/mindthegrow/cafelytics/actions/workflows/publish.yml/badge.svg"></a>
        <a href="https://cafelytics.readthedocs.io/en/stable/?badge=stable"><img alt="Documentation Status" src="https://readthedocs.org/projects/cafelytics/badge/?version=stable"></a>
        <a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
        <a href="https://coveralls.io/github/mindthegrow/cafelytics?branch=main"><img alt="Coverage Status" src="https://coveralls.io/repos/github/mindthegrow/cafelytics/badge.svg?branch=main"></a>
        <a href="https://codecov.io/gh/mindthegrow/cafelytics"><img alt="Coverage Status" src="https://codecov.io/gh/mindthegrow/cafelytics/branch/main/graph/badge.svg?token=HT880PYHPG"></a>
        <a href="https://pepy.tech/project/cafelytics"><img alt="Total Downloads" src="https://static.pepy.tech/personalized-badge/cafelytics?period=total&units=abbreviation&left_color=gray&right_color=blue&left_text=downloads"></a>
        </p>
        
        
        # cafélytics ☕️
        A basic simulation of a coffee operation. Please pardon the mess as this is a work in progress.
        This is a model that enables forecasting and experimentation under uncertainty, with the goal of steady year-over-year agricultural yields.
        It can help address questions such as:
        - _when should I expand / how much?_
        - _what will the impacts of various crop diversification strategies be?_
        - _how can I plan around disaster recovery and mitigation of lost income?_
        - _what would cooperative-wide yields look like if more farmers joined? what about if some left?_
        
        
        ## usage (python cli)
        
        The dataset provided can be used for forecasting with
        ```bash
        make run
        ```
        
        which is equivalent to 
        
        ```bash
        python3 src/cafe/simulateCoOp.py --farm data/fakeData.csv --trees data/trees.yml --years 75 --output testNewFarm.png
        ```
        
        and will output this plot, representing the outputs of a collective of farmers over a seventy-five year time span:
        ![image](https://user-images.githubusercontent.com/40366263/126931909-c49e1c8d-c1a4-4585-9092-f40e64725245.png)
        
        Some farmers who joined the cooperative had trees that were already very mature, so this simulation starts back in 1991 to show their hypothetical contributions towards the total yield of the group (in other words, their membership start date is not considered as a factor in this simulation at this time).
        
        
        ## contributing
        Contributions are welcome. There are many aspects of this project to improve, please see [CONTRIBUTING](/info/CONTRIBUTING.md) for a list of places to start. You may also raise an issue if you have questions or suggestions about this code. 
        
        
        ## license
        This software is released as-is, with no guarantee nor warranty. For more details, please see [LICENSE](/info/LICENSE.txt).
        
        
        ## try it out
        (Note: the following have not been tested in a long time, they make likely not work).
        Classic: [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/mindthegrow/cafelytics/binder/?urlpath=git-pull?repo=https://github.com/mindthegrow/cafelytics)
        
        Jupyterlab: [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/mindthegrow/cafelytics/master?urlpath=lab/tree/index.ipynb)
        
        
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Requires-Python: >=3.6
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Provides-Extra: dev
