Tethne

Tethne is a Python package for integrated bibliographic and corpus analysis developed by the Digital Innovation Group at Arizona State University. Tethne provides simple tools for generating networks from bibliographic datasets, and provides a framework for weaving together techniques from scientometrics, computational linguistics, topic modeling, and social influence modeling. Rather than reinvent or re-implement existing algorithms, Tethne is designed to interface with existing software packages, and to provide mechanisms for drawing the results and functionalities of those packages together.

Need help?

We now have a Google group for Tethne users: https://groups.google.com/forum/#!forum/tethne-users

Documentation

For more information, see the Tethne website.

The documentation project (ReST sources, etc.) can be found in tethne-docs.

Key features

Flexible core model for text and citation-data.
Provides core analytic features of popular citation-analysis software (e.g. Citespace).
Integrates popular topic modeling software (e.g. MALLET).
Export network models to mainstream formats (e.g. for visualization in Cytoscape).
Leverages powerful computational and network-analysis libraries in Python.

How to Contribute

Fork this repository.
Check out the develop branch: git checkout develop
Create a new branch for your contribution, e.g. git checkout -b issue45
Make your changes. Be sure to include a docstring for each function and class!
Write tests. We aim for 95% test coverage. Put your tests in tests, where they belong.

Ensure that all of your tests are passing. We use nose. Test with:

$ nosetests --with-coverage --cover-package=tethne --cover-min-percentage=95

Check for code cleanliness! Code should conform to PEP 0008. We use Pylint. For example:
```
$ pylint tethne/mycontribution.py
```
Create a pull request. Be sure to select diging/develop as the base branch.

Requirements

These should be installed automatically when you install Tethne, but just in case they aren't:

networkx>=1.8.1
Unidecode>=0.04.16
iso8601
rdflib

New in v0.7

v0.7 was a nearly ground-up refactor, resulting in a more modular and testable codebase and a simplified API. Here are some of the most notable changes:

Network-building functions were made significantly more abstract and flexible.
Numpy and SciPy are no longer required. We weren't really taking advantage of the performance gains afforded by those packages, and some users were running into installation issues with SciPy.
Plotting functionality has been removed. This was causing bloat, and we were making aesthetic and formatting decisions for the user that weren't easily customizable.
Huge improvements to the WoS reader. The old reader was bloated and suffered from some nasty bugs.
Re-designed Corpus and Paper classes. See the docs for more information.
Introduced Feature and FeatureSet classes to provide a more consistent and user-friendly mechanism for managing document features.

Contributors

License

Tethne is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Tethne is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

About

Tethne is developed by the ASU Digital Innovation Group (DigInG), part of the Laubichler Lab in the Center for Biology & Society, School of Life Sciences.

This material is based upon work supported by the National Science Foundation Graduate Research Fellowship Program under Grant No. 2011131209, and NSF Doctoral Dissertation Research Improvement Grant No. 1256752.