[](https://mybinder.org/v2/gh/FZJ-IEK3-VSA/voila-tsam/HEAD?urlpath=voila/render/Time-Series-Aggregation-Module.ipynb)
<a href="https://www.fz-juelich.de/en/iek/iek-3"><img src="https://www.fz-juelich.de/static/media/Logo.2ceb35fc.svg" alt="Forschungszentrum Juelich Logo" width="230px"></a>
# pycallgraphix
pycallgraphix is a simple python package that enables users to easily visualize their python code structure. pycallgraphix takes standard [call graph](http://en.wikipedia.org/wiki/Call_graph) python packages a step further by allowing users to create a visual from only the functions they select. Users simply wrap the functions they wish to include with a pre-defined wrapper and pycallgraphix generates an image based on their connections.
## Features
* Call graph visualization of selected python functions in a PNG format
* Includes the time spent running selected functions and the number of calls to selected functions
* Color coded call graph image, based on the time spent running function calls
* Optional profiling of selected functions using cProfile
## Installation
Directly install via pip as follows:
pip install pycallgraphix
Alternatively, clone a local copy of the repository to your computer:
git clone https://github.com/FZJ-IEK3-VSA/pycallgraphix
Then install pycallgraphix via pip as follows:
cd pycallgraphix
pip install .
Finally, run the unit tests to ensure it is installed correctly:
python -m unittest test.test_store_calls
python -m unittest test.test_store_funcs
## Basic Workflow
A small example how to use pycallgraphix is as follows:
```python
import cProfile
from pycallgraphix.wrapper import MethodChart, register_method
```
Enable the profiler (optional):
```python
profiler = cProfile.Profile()
profiler.enable()
```
Define the call graph object. The execute function contains all the scripts or functions you wish to include in the graph. Scripts and functions do not need to be a part of the PyCallGraphObject class but all functions included in the call graph must be wrapped with the **@register_method** wrapper:
```python
class PyCallGraphObject:
def __init__(self) -> None:
self.execute()
methodchart = MethodChart()
methodchart.make_graphviz_chart(
time_resolution=3, filename="Method_Pattern.png"
)
profiler.disable()
profiler.dump_stats("profile.prof")
def execute(self):
self.sum_recursive(3, 4)
@register_method
def sum_recursive(self, a, b):
if b > 0:
a += 1
b -= 1
self.print_value(prefix='current', value=a)
return self.sum_recursive(a, b)
else:
self.print_value(prefix='final', value=a)
return a
@register_method
def print_value(self, prefix, value):
print("{} value = {}".format(prefix,value))
```
Finally run the code by initializing the PyCallGraphObject:
```python
run = PyCallGraphObject()
```
If created succesfully, the resulting graph looks like:
### Including functions from other directories and scripts
To include functions from other python files and scripts, simply import the wrapper into your script as follows:
```python
from pycallgraphix.wrapper import register_method
```
And wrap the desired functions. pycallgraphix will automatically locate it when creating the call graph:
```python
@register_method
def myExampleFunction(a, b):
....
```
## Detailed Example
A detailed example of what can be created with pycallgraphix was generated for one module of the House Infrastructure Simulator [(HiSim)](https://github.com/FZJ-IEK3-VSA/HiSim).
## License
MIT License
Copyright (c) 2022-2023 Katharina Rieck (FZJ/IEK-3), Matthew Keller (FZJ/IEK-3), Noah Pflugradt (FZJ/IEK-3), Jann Weinand (FZJ/IEK-3), Detlef Stolten (FZJ/IEK-3)
You should have received a copy of the MIT License along with this program.
If not, see https://opensource.org/licenses/MIT
## About Us
We are the [Institute of Energy and Climate Research - Techno-economic Systems Analysis (IEK-3)](https://www.fz-juelich.de/en/iek/iek-3) belonging to the [Forschungszentrum Jülich](https://www.fz-juelich.de/en). Our interdisciplinary department's research is focusing on energy-related process and systems analyses. Data searches and system simulations are used to determine energy and mass balances, as well as to evaluate performance, emissions and costs of energy systems. The results are used for performing comparative assessment studies between the various systems. Our current priorities include the development of energy strategies, in accordance with the German Federal Government’s greenhouse gas reduction targets, by designing new infrastructures for sustainable and secure energy supply chains and by conducting cost analysis studies for integrating new technologies into future energy market frameworks.
## Acknowledgments
* To create the singleton pattern, the following work was referenced:
https://refactoring.guru/design-patterns/singleton/python/example#example-1
* pycallgraphix makes use of the [python graphviz](https://pypi.org/project/graphviz/) package.
Raw data
{
"_id": null,
"home_page": "https://github.com/FZJ-IEK3-VSA/pycallgraphix",
"name": "pycallgraphix",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "call graph,wrapper,visual,pycall,graphix",
"author": "Matthew Keller, Katharina Rieck",
"author_email": "ma.keller@fz-juelich.de, k.rieck@fz-juelich.de",
"download_url": "https://files.pythonhosted.org/packages/e1/dc/970a261785d5764011bfd8c316f80446653874c1bd426029f098a3f58d8f/pycallgraphix-1.0.1.tar.gz",
"platform": null,
"description": "[](https://mybinder.org/v2/gh/FZJ-IEK3-VSA/voila-tsam/HEAD?urlpath=voila/render/Time-Series-Aggregation-Module.ipynb)\r\n\r\n<a href=\"https://www.fz-juelich.de/en/iek/iek-3\"><img src=\"https://www.fz-juelich.de/static/media/Logo.2ceb35fc.svg\" alt=\"Forschungszentrum Juelich Logo\" width=\"230px\"></a>\r\n\r\n# pycallgraphix\r\npycallgraphix is a simple python package that enables users to easily visualize their python code structure. pycallgraphix takes standard [call graph](http://en.wikipedia.org/wiki/Call_graph) python packages a step further by allowing users to create a visual from only the functions they select. Users simply wrap the functions they wish to include with a pre-defined wrapper and pycallgraphix generates an image based on their connections.\r\n\r\n## Features\r\n* Call graph visualization of selected python functions in a PNG format\r\n* Includes the time spent running selected functions and the number of calls to selected functions\r\n* Color coded call graph image, based on the time spent running function calls\r\n* Optional profiling of selected functions using cProfile\r\n\r\n## Installation\r\nDirectly install via pip as follows:\r\n\r\n\tpip install pycallgraphix\r\n\r\nAlternatively, clone a local copy of the repository to your computer:\r\n\r\n\tgit clone https://github.com/FZJ-IEK3-VSA/pycallgraphix\r\n\r\nThen install pycallgraphix via pip as follows:\r\n\r\n\tcd pycallgraphix\r\n\tpip install .\r\n\r\nFinally, run the unit tests to ensure it is installed correctly:\r\n\r\n python -m unittest test.test_store_calls\r\n python -m unittest test.test_store_funcs\r\n\r\n\r\n## Basic Workflow\r\n\r\nA small example how to use pycallgraphix is as follows:\r\n```python\r\nimport cProfile\r\nfrom pycallgraphix.wrapper import MethodChart, register_method\r\n```\r\n\r\nEnable the profiler (optional):\r\n```python\r\nprofiler = cProfile.Profile()\r\nprofiler.enable()\r\n```\r\n\r\nDefine the call graph object. The execute function contains all the scripts or functions you wish to include in the graph. Scripts and functions do not need to be a part of the PyCallGraphObject class but all functions included in the call graph must be wrapped with the **@register_method** wrapper:\r\n```python\r\nclass PyCallGraphObject:\r\n\r\n def __init__(self) -> None:\r\n self.execute()\r\n methodchart = MethodChart()\r\n methodchart.make_graphviz_chart(\r\n time_resolution=3, filename=\"Method_Pattern.png\"\r\n )\r\n profiler.disable()\r\n profiler.dump_stats(\"profile.prof\")\r\n\r\n def execute(self):\r\n self.sum_recursive(3, 4)\r\n\r\n @register_method\r\n def sum_recursive(self, a, b):\r\n if b > 0:\r\n a += 1\r\n b -= 1\r\n self.print_value(prefix='current', value=a)\r\n return self.sum_recursive(a, b)\r\n else:\r\n self.print_value(prefix='final', value=a)\r\n return a\r\n\r\n @register_method\r\n def print_value(self, prefix, value):\r\n print(\"{} value = {}\".format(prefix,value))\r\n```\r\n\r\nFinally run the code by initializing the PyCallGraphObject:\r\n```python\r\nrun = PyCallGraphObject()\r\n```\r\n\r\nIf created succesfully, the resulting graph looks like:\r\n\r\n\r\n\r\n### Including functions from other directories and scripts\r\n\r\nTo include functions from other python files and scripts, simply import the wrapper into your script as follows:\r\n```python\r\nfrom pycallgraphix.wrapper import register_method\r\n```\r\n\r\nAnd wrap the desired functions. pycallgraphix will automatically locate it when creating the call graph:\r\n```python\r\n@register_method\r\ndef myExampleFunction(a, b):\r\n ....\r\n```\r\n\r\n## Detailed Example\r\n\r\nA detailed example of what can be created with pycallgraphix was generated for one module of the House Infrastructure Simulator [(HiSim)](https://github.com/FZJ-IEK3-VSA/HiSim).\r\n\r\n\r\n\r\n\r\n## License\r\n\r\nMIT License\r\n\r\nCopyright (c) 2022-2023 Katharina Rieck (FZJ/IEK-3), Matthew Keller (FZJ/IEK-3), Noah Pflugradt (FZJ/IEK-3), Jann Weinand (FZJ/IEK-3), Detlef Stolten (FZJ/IEK-3)\r\n\r\nYou should have received a copy of the MIT License along with this program.\r\nIf not, see https://opensource.org/licenses/MIT\r\n\r\n\r\n## About Us\r\n\r\nWe are the [Institute of Energy and Climate Research - Techno-economic Systems Analysis (IEK-3)](https://www.fz-juelich.de/en/iek/iek-3) belonging to the [Forschungszentrum J\u00c3\u00bclich](https://www.fz-juelich.de/en). Our interdisciplinary department's research is focusing on energy-related process and systems analyses. Data searches and system simulations are used to determine energy and mass balances, as well as to evaluate performance, emissions and costs of energy systems. The results are used for performing comparative assessment studies between the various systems. Our current priorities include the development of energy strategies, in accordance with the German Federal Government\u00e2\u20ac\u2122s greenhouse gas reduction targets, by designing new infrastructures for sustainable and secure energy supply chains and by conducting cost analysis studies for integrating new technologies into future energy market frameworks.\r\n\r\n\r\n## Acknowledgments\r\n\r\n* To create the singleton pattern, the following work was referenced:\r\n https://refactoring.guru/design-patterns/singleton/python/example#example-1\r\n\r\n* pycallgraphix makes use of the [python graphviz](https://pypi.org/project/graphviz/) package.\r\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "pycallgraphix is an extension of standard call graph python packages that enables users to independently select the functions they wish to include in visualizations by simply applying a function wrapper.",
"version": "1.0.1",
"project_urls": {
"Homepage": "https://github.com/FZJ-IEK3-VSA/pycallgraphix"
},
"split_keywords": [
"call graph",
"wrapper",
"visual",
"pycall",
"graphix"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e5b7a9cf19a930deb05effb40bbc64f88ccf62acc1c2068c8cead8b41d3966b4",
"md5": "592b4dc2a68868986117dfe874b45c0e",
"sha256": "f3a9156fe19a2a9a6cbfb4ce40d5f60216dcbf392de609414c59a5a8293ef5e9"
},
"downloads": -1,
"filename": "pycallgraphix-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "592b4dc2a68868986117dfe874b45c0e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 10901,
"upload_time": "2024-01-15T14:17:39",
"upload_time_iso_8601": "2024-01-15T14:17:39.760932Z",
"url": "https://files.pythonhosted.org/packages/e5/b7/a9cf19a930deb05effb40bbc64f88ccf62acc1c2068c8cead8b41d3966b4/pycallgraphix-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e1dc970a261785d5764011bfd8c316f80446653874c1bd426029f098a3f58d8f",
"md5": "bad7f8ed672f4f4f10403e91ff6cb1fc",
"sha256": "ec818593427d1d77fbd8eda72637e0b37f8bd3a150f639bade648fe4b35e28e4"
},
"downloads": -1,
"filename": "pycallgraphix-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "bad7f8ed672f4f4f10403e91ff6cb1fc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 56113,
"upload_time": "2024-01-15T14:17:41",
"upload_time_iso_8601": "2024-01-15T14:17:41.519003Z",
"url": "https://files.pythonhosted.org/packages/e1/dc/970a261785d5764011bfd8c316f80446653874c1bd426029f098a3f58d8f/pycallgraphix-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-15 14:17:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "FZJ-IEK3-VSA",
"github_project": "pycallgraphix",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "pycallgraphix"
}
JSON
