Lightweight computation graphs for Python
Project description
# Graphtik
[](https://img.shields.io/pypi/pyversions/graphtik.svg?label=Python) [](https://img.shields.io/pypi/v/graphtik.svg?label=PyPi%20version) [](https://img.shields.io/github/v/release/pygraphkit/graphtik.svg?label=GitHub%20release&include_prereleases) [](https://travis-ci.org/pygraphkit/graphtik) [](https://graphtik.readthedocs.io/) [](https://codecov.io/gh/pygraphkit/graphtik) [](https://img.shields.io/pypi/l/graphtik.svg)
[](https://img.shields.io/github/watchers/pygraphkit/graphtik.svg?style=social) [](https://img.shields.io/github/stars/pygraphkit/graphtik.svg?style=social) [](https://img.shields.io/github/forks/pygraphkit/graphtik.svg?style=social) [](http://img.shields.io/github/issues/pygraphkit/graphtik.svg?style=social)
[Full Documentation](https://pythonhosted.org/graphtik/)
> It’s a DAG all the way down
- <img src=”docs/source/images/barebone_2ops.svg” width=100
alt=”simple graphtik computation”>
## Lightweight computation graphs for Python
Graphtik is an an understandable and lightweight Python module for building and running ordered graphs of computations. The API posits a fair compromise between features and complexity without precluding any. It might be of use in computer vision, machine learning and other data science domains, or become the core of a custom ETL pipelne.
Graphtik is a temporary fork of [Graphkit](https://github.com/yahoo/graphkit) to experiment with Python 3.6+ features.
## Quick start
Here’s how to install:
pip install graphtik
OR with dependencies for plotting support (and you need to install [Graphviz](https://graphviz.org) program separately with your OS tools):
pip install graphtik[plot]
Here’s a Python script with an example Graphtik computation graph that produces multiple outputs (a * b, a - a * b, and abs(a - a * b) ** 3):
>>> from operator import mul, sub >>> from graphtik import compose, operation>>> # Computes |a|^p. >>> def abspow(a, p): ... c = abs(a) ** p ... return c>>> # Compose the mul, sub, and abspow operations into a computation graph. >>> graphop = compose(name="graphop")( ... operation(name="mul1", needs=["a", "b"], provides=["ab"])(mul), ... operation(name="sub1", needs=["a", "ab"], provides=["a_minus_ab"])(sub), ... operation(name="abspow1", needs=["a_minus_ab"], provides=["abs_a_minus_ab_cubed"], params={"p": 3})(abspow) ... )
<img src=”docs/source/images/barebone_3ops.svg” width=100 alt=”simple graphtik computation”>
>>> # Run the graph and request all of the outputs. >>> out = graphop({'a': 2, 'b': 5}) >>> print(out) {'a': 2, 'b': 5, 'ab': 10, 'a_minus_ab': -8, 'abs_a_minus_ab_cubed': 512}>>> # Run the graph and request a subset of the outputs. >>> out = graphop({'a': 2, 'b': 5}, outputs=["a_minus_ab"]) >>> print(out) {'a_minus_ab': -8}
- <img src=”docs/source/images/executed_3ops.svg” width=120
alt=”simple graphtik computation”>
As you can see, any function can be used as an operation in Graphtik, even ones imported from system modules!
## Plotting
For debugging the above graph-operation you may plot either the newly omposed graph or the execution plan of the last computation executed, using these methods:
`python graphop.plot(show=True) # open a matplotlib window graphop.plot("graphop.svg") # other supported formats: png, jpg, pdf, ... graphop.plot() # without arguments return a pydot.DOT object graphop.plot(solution=out) # annotate graph with solution values `
> TIP: The pydot.Dot instances returned by plot() are rendered as SVG in Jupyter/IPython.
# License
Code licensed under the Apache License, Version 2.0 license. See LICENSE file for terms.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file graphtik-2.0.0b0.tar.gz.
File metadata
- Download URL: graphtik-2.0.0b0.tar.gz
- Upload date:
- Size: 35.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.5rc1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 325de3e20faa55b46344fee51e91522c705df60b75b926287c16c416f88b2c62 |
|
| MD5 | 49ce80ece809fc7635952b8f03b3f251 |
|
| BLAKE2b-256 | 3ba6cd2452db66cefb181420906499bdab9d1a596d662f1ce334f24c903c81f6 |
File details
Details for the file graphtik-2.0.0b0-py2.py3-none-any.whl.
File metadata
- Download URL: graphtik-2.0.0b0-py2.py3-none-any.whl
- Upload date:
- Size: 30.1 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.5rc1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7d8df7be892fbb5c63e9a793595e6d1823a64874949b787836db767b129a73f2 |
|
| MD5 | 863e6d5a242d898e2fb4ac4633dd8af2 |
|
| BLAKE2b-256 | 3e63192a8bdc54e1c8672210dc9f6d88fbc4c5f17104764962928c51cc1046ec |
](https://img.shields.io/pypi/pyversions/graphtik.svg){kind=link}
](https://img.shields.io/pypi/v/graphtik.svg){kind=link}
](https://img.shields.io/github/v/release/pygraphkit/graphtik.svg){kind=link}
](https://travis-ci.org/pygraphkit/graphtik){kind=link}
](https://graphtik.readthedocs.io/){kind=link}
](https://codecov.io/gh/pygraphkit/graphtik){kind=link}
](https://img.shields.io/pypi/l/graphtik.svg){kind=link}
](https://img.shields.io/github/watchers/pygraphkit/graphtik.svg){kind=link}
](https://img.shields.io/github/stars/pygraphkit/graphtik.svg){kind=link}
](https://img.shields.io/github/forks/pygraphkit/graphtik.svg){kind=link}
](http://img.shields.io/github/issues/pygraphkit/graphtik.svg){kind=link}