Skip to main content

Python extras to support visualization

Project description

An extension to the analyzere python library that facilitates “extras” including visualizations of Analyze Re LayerView objects.

Installation

pip install analyzere_extras

Usage

In order to make use of the visualization tools in the analyzere_extras module you will need to import the analyzere module.

First you will need to define your connection information:

import analyzere
analyzere.base_url = '<your server url>'
analyzere.username = '<your userid>'
analyzere.password = '<your password>'

Then you will need to query a LayerView that you would like to graph:

from analyzere import LayerView

lv = analyzere.LayerView.retrieve('011785b1-203b-696e-424e-7da9b0ec779a')

Now you can generate a graph of your LayerView:

from analyzere_extras.visualizations import LayerViewDigraph

g = LayerViewDigraph(lv)  # defaults: with_terms=True, compact=True, rankdir='TB'
g = LayerViewDigraph(lv, with_terms=False)  # omit Layer terms from nodes
g = LayerViewDigraph(lv, compact=False) # graph duplicate nodes
g = LayerViewDigraph(lv, rankdir='LR')  # render the graph from Left to Right
g = LayerViewDigraph(lv, warnings=False)  # disable error node highlighting

Then to render your graph:

g.render()  # defaults: filename=None, view=True, format=None, rankdir=None
g.render(filename='mygraph') # write graph to 'mygraph'
g.render(view=False)    # disable attempts to auto display the graph
g.render(format='pdf')  # change the output format 'pdf'
g.render(rankdir='LR')  # render the graph from Left to Right

Shortcut: generate a graph for a given LayerView Id:

graph = LayerViewDigraph.from_id('011785b1-203b-696e-424e-7da9b0ec779a')

Testing

We currently commit to being compatible with Python 2.7 and Python 3.4. In order to run tests against against each environment we use tox and py.test. You’ll need an interpreter installed for each of the versions of Python we test. You can find these via your system’s package manager or on the Python site.

To start, install tox:

pip install tox

Then, run the full test suite:

tox

To run tests for a specific module, test case, or single test, you can pass arguments to py.test through tox with --. E.g.:

tox -- tests/test_base_resources.py::TestReferences::test_known_resource

See tox --help and py.test --help for more information.

Publishing

  1. Install twine and wheel:

    pip install twine wheel
  2. Increment version number in setup.py according to PEP 440.

  3. Commit your change to setup.py and create a tag for it with the version number. e.g.:

    git tag 0.1.0
    git push origin 0.1.0
  4. Register the package:

    python setup.py register
  5. Package source and wheel distributions:

    python setup.py sdist bdist_wheel
  6. Upload to PyPI with twine:

    twine upload dist/*

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

analyzere_extras-0.1.0.tar.gz (7.5 kB view hashes)

Uploaded source

Built Distribution

analyzere_extras-0.1.0-py2.py3-none-any.whl (9.3 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page