Metadata-Version: 2.1
Name: polygraphs
Version: 0.0.23a0
Summary: Philosophical simulations on networks
Home-page: https://github.com/alexandroskoliousis/polygraphs
Author: Alexandros Koliousis
Author-email: Alexandros Koliousis <ak@akoliousis.com>, Amil Mohanan <amil@mohanan.net>
License: MIT License
Project-URL: Repository, https://github.com/alexandroskoliousis/polygraphs
Project-URL: Documentation, https://akoliousis.com/polygraphs/
Keywords: philosophy,epistemology,simulation
Requires-Python: >=3
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyYaml
Requires-Dist: pandas
Requires-Dist: numpy
Requires-Dist: h5py
Requires-Dist: matplotlib
Requires-Dist: networkx
Requires-Dist: six
Requires-Dist: torch
Requires-Dist: dgl

# PolyGraphs
<p align="center">
  <img src="https://akoliousis.com/polygraphs/eu_email_core.webp" alt="Visualisation of EU Email Core network" height="250">
</p>

<p align="center"><a href="https://akoliousis.com/polygraphs/">Documentation</a> | <a href="https://polygraphs.sites.northeastern.edu/">Website</a> | <a href="https://pypi.org/project/polygraphs/">PyPi</a></p>

PolyGraphs is a scaleable framework for performing simulations on networks built using PyTorch and DGL that can run on CPUs and GPUs.

## Getting Started
PolyGraphs requires and appropriately configured version of PyTorch and DGL before installation, see the [getting started guide](https://akoliousis.com/polygraphs/guide/introduction/getting-started) for more details. You can install the PolyGraphs library via PyPi:

```bash
pip install polygraphs
```

You can run simulations using a configuration file with the `polygraphs` command:

``` bash
polygraphs -f test.yaml
```

### Installing from Source
Advanced users can [install from source](https://akoliousis.com/polygraphs/guide/introduction/install-from-source), see the documentation for more details on running PolyGraphs on the [platform guide](https://akoliousis.com/polygraphs/guide/introduction/platform-guide).

## Analysing Simulation Results
Results from simulations can be processed using the [analysis module](https://akoliousis.com/polygraphs/guide/simulations/processing-results). 

## Papers About PolyGraphs
Ball, B., Koliousis, A., Mohanan, A. & Peacey, M. [Computational philosophy: reflections on the PolyGraphs project](https://doi.org/10.1057/s41599-024-02619-z). Humanit Soc Sci Commun 11, 186 (2024).

Ball, B., Koliousis, A., Mohanan, A. & Peacey, M. [Misinformation and higher-order evidence](https://doi.org/10.1057/s41599-024-03806-8). Humanit Soc Sci Commun 11, 1294 (2024).

## Contributing
Please file an [issue](https://github.com/alexandroskoliousis/polygraphs/issues) if you encounter a bug or have any suggestions. Bug-fixes, contributions, new features and extensions are welcomed through discussion in issues.
