piegy 2.1.0__cp38-cp38-win32.whl

piegy-2.1.0.dist-info/METADATA

@@ -0,0 +1,112 @@
+Metadata-Version: 2.1
+Name: piegy
+Version: 2.1.0
+Summary: Payoff-Driven Stochastic Spatial Model for Evolutionary Game Theory
+Author-email: Chenning Xu <cxu7@caltech.edu>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2025, Chenning Xu
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice, this
+           list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+        
+Project-URL: Source, https://github.com/Chenning04/piegy.git
+Project-URL: Documentation, https://piegy.readthedocs.io/en/
+Keywords: Game Theory,Evolutionary Game Theory,Spatial Model,Stochastic Model,Payoff Driven
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: numpy
+Requires-Dist: matplotlib
+Requires-Dist: moviepy>=2.1.1
+Requires-Dist: seaborn>=0.13.2
+
+# piegy
+
+The package full name is: Payoff-Driven Stochastic Spatial Model for Evolutionary Game Theory. "pi" refers to "payoff, and "egy" is taken from "Evolutionary Game Theory".
+
+Provides a stochastic spatial model for simulating the interaction and evolution of two species in either 1D or 2D space, as well as analytic tools.
+
+## Installation
+
+To install *piegy*, run the following in terminal:
+
+```bash
+pip install piegy
+```
+
+## Documentation and Source
+
+See source code at: [piegy GitHub-repo](https://github.com/Chenning04/piegy.git). 
+The *piegy* documentation at: [piegy Documentation](https://piegy.readthedocs.io/en/). 
+
+## How the Model Works
+
+Our model can be summarized as "classical evolutionary game theory endowed with spatial structure and payoff-driven migration rules". Consider two species, predators and preys (denoted by *U* and *V*), in a rectangular region. We divide the region into N by M patches and simulate their interaction within a patch by classical game theory (i.e., payoff matrices and carrying capacity). Interactions across patches are simulated by payoff-driven migration rules. An individual migrates to a neighboring patch with probability weighted by payoff in the neighbors.
+
+We use the Gillepie algorithm as the fundamental event-selection algorithm. At each time step, one event is selected and let happen; and the step size is continuous, dependent on the current state in the space. Data are recorded every some specified time interval.
+
+## Analytic Tools
+
+The *piegy* package also provides a wide range of analytic and supportive tools alongside the main model, such as plotting, numerical tools, data saving & reading, etc. We also provide the *piegy.videos* module for more direct visualizations such as how population distribution change over time.
+
+## C Core
+
+From version 2 on, the *piegy* simulations are now equipped with a C core, which makes it significantly faster than previous versions.
+
+## Examples
+
+To get started, simply get our demo model and run simulation:
+
+```python
+from piegy import simulation, figures
+import matplotlib.pyplot as plt
+
+mod = simulation.demo_model()
+simulation.run(mod)
+
+fig1, ax1 = plt.subplots()
+figures.UV_dyna(mod, ax1)
+fig2, ax2 = plt.subplots(1, 2, figsize = (12.8, 4.8))
+figures.UV_heatmap(mod, ax2[0], ax2[1])
+```
+
+The figures reveal population dynamics and steady state population distribution.
+
+
+## Acknowledgments
+
+- Thanks Professor Daniel Cooney at University of Illinois Urbana-Champaign. This package is developed alongside a project with Prof. Cooney and received enormous help from him.
+- Special thanks to the open-source community for making this package possible.
+

piegy-2.1.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+piegy/__init__.py,sha256=3voZtYSFLmgQCRQsz2bTrhVSI_lJ-UXc78IY92ajWJM,2138
+piegy/__version__.py,sha256=XKaDCdQoaHEBFn0RdDb0Gcjwotejw9Xi7M87I6KNPW4,1576
+piegy/analysis.py,sha256=tJhJTSFJsK_Zr34s78Cy7Im1NtONctkdNmg0R0teTeU,8941
+piegy/data_tools.py,sha256=uYEoCYO7ZVtKBsNDgco7kERvBlOFFK7wpTuqcCwCBEU,3573
+piegy/figures.py,sha256=QAbCoIopa0FRkReXBG0ExFvG-wNevI8hK8Ar-Ph14II,18427
+piegy/simulation.py,sha256=KV_fXQXXG6QI-kkSDQqC3F8moFd0m_orBWA69magk9Q,20405
+piegy/simulation_py.py,sha256=s9cSdcIXc-n_njK5Y9KKolejOVrVtcy3Ou1UT7NmVdY,30340
+piegy/test_var.py,sha256=weIaC-3jL9A3tLa_kpqPVLR0NQHwzzhaMtP8P0sFlA4,24145
+piegy/videos.py,sha256=meG3kNCnmAsEc2LtLGk2VixQZ9Nx4dRYwK7DB17_LFk,10521
+piegy/C_core/piegyc.cp38-win32.pyd,sha256=fZ7TEQzuCAB3KHEbtAOIwSgzLZirO2Zhm6hQ-ELzCKc,74801
+piegy/tools/__init__.py,sha256=Zcr2OExiwY_Zeh_vVwDjbuHtTaI_eHOe8xwzgsVdja0,315
+piegy/tools/figure_tools.py,sha256=pz7Y2L1S1rVpbjwUwlsp1v1LRgi8IJq8ybLDn3woSNg,7213
+piegy/tools/file_tools.py,sha256=ThXsc2gBX8SbJWW07afolz1oHH0dJQfMvn9D3b-y7TE,659
+piegy-2.1.0.dist-info/LICENSE.txt,sha256=1ihCy5mwfvcRiquE82AHAMhd4iVUzDfgL7eG8_tPwQ0,1526
+piegy-2.1.0.dist-info/METADATA,sha256=kifTCjFWtsILaYF3m60BAVnRdy-eDMP8Lcaewc61P-k,5525
+piegy-2.1.0.dist-info/WHEEL,sha256=BsoMMMHJGneA25n2FDquZW143lDYOuIAMJ0po_3Su94,95
+piegy-2.1.0.dist-info/top_level.txt,sha256=k4QLYL8PqdqDuy95-4NZD_FVLqJDsmq67tpKkBn4vMw,6
+piegy-2.1.0.dist-info/RECORD,,

piegy-2.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.3.2)
+Root-Is-Purelib: false
+Tag: cp38-cp38-win32
+

piegy-2.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+piegy