Metadata-Version: 2.1
Name: sma
Version: 2.0.2
Summary: Package for analysing social-ecological networks
Home-page: https://gitlab.com/t.seppelt/sesmotifanalyser
Author: Tim Seppelt
Author-email: t.seppelt-dev@posteo.de
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: networkx (>=2.3)
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: pandas

# SESMotifAnalyser: framework for analysing social-ecological systems

This package contains a Python based framework for analysing social-ecological systems.


## Documentation

**A comprehensive documentation is available [as PDF](https://gitlab.com/t.seppelt/sesmotifanalyser/raw/master/doc/_build/latex/SESMotifAnalyser.pdf?inline=false).**
Please contact t.seppelt[ÄT]posteo.de in case of any questions.

See the [examples folder](./examples/) for examples.

## Installation

The package can be installed using ``pip``.

```bash
pip install sma
```

It has the following dependencies: Python 3, numpy, scipy, networkx, pandas.

On the R side it depends on statnet, reticulate (with Python 3).


## ergm-userterms

In addition to the motif counting features written in Python, this repository contains `ergm-userterms` for some motifs, e.g. the 3-motifs I.C and II.C (closed and open triangles,
respecting the social-ecological types of the nodes).

After downloading and compiling the package, `ergm` models can be fitted and the motif counting
can be done directly in R:

```R
netw <- network(...)

# first parameter: which sesType should the nodes at the points of the triangles have
# second parameter: name of nodel attribute
summary(netw ~ openTriangles(0, 'sesType'))
```

## Integration in R and integrateR

The functions in this package can to some extend be called from R using the R package reticulate. An example can be found in the [examples folder](./examples/example.R). See also the corresponding section in the documentation.

Mario Angst is working on an R package which provides an interface to the SESMotifAnalyser. His project integrateR can be found on [Github](https://github.com/marioangst/integrateR).


