From 357ccfcaf438be0cc52f10bf8e7c8dd5ffdc7340 Mon Sep 17 00:00:00 2001 From: Thorsten Vitt Date: Tue, 11 Apr 2017 17:33:04 +0200 Subject: [PATCH] Updated docs --- README.rst | 45 ++++++++++++++++++++++++++++++--------------- docs/concept.rst | 4 ++-- docs/delta.rst | 15 ++------------- 3 files changed, 34 insertions(+), 30 deletions(-) diff --git a/README.rst b/README.rst index e15db26..2f9acd8 100644 --- a/README.rst +++ b/README.rst @@ -3,7 +3,7 @@ PyDelta ------- -pydelta is a library and tool to perform stylometric analyses like authorship attribution, and to evaluate methods for that. It originated as a commandline tool which implements three algorithms in the form described by Argamon in a paper on John Burrows Delta. +pydelta is a library to perform stylometric analyses like authorship attribution, and to evaluate methods for that. It originated as a commandline tool which implements three algorithms in the form described by Argamon in a paper on John Burrows Delta. (S. Argamon, "Interpreting Burrows’s Delta: Geometric and Probabilistic Foundations," Literary and linguistic computing, vol. 23, iss. 2, pp. 131-147, 2008.) @@ -11,23 +11,33 @@ Delta is a measure to describe the stylistic difference between texts. It is use in computational stylistics, especially in author attribution. This implementation is for research purposes only, If you want to use a reliable implementation with a nice Gui and much more features you should -have a closer look at the great R tool 'stylo': -https://sites.google.com/site/computationalstylistics/ +have a closer look at the great R tool Stylo_. +.. _Stylo: https://sites.google.com/site/computationalstylistics/ -Installation and Requirements -============================= +Documentation +============= -PyDelta requires **Python 3.3 or newer**. It has quite a set of dependencies (NumPy, Pandas, SciPy, SciKit-Learn, …), but it comes with a setup script that installs it with its dependencies. +Documentation_ for the _next_ branch is updated on each commit. -Developers can clone the repo and run pip to install:: +.. _Documentation: http://dev.digital-humanities.de/ci/job/pydelta-next/Documentation/index.html - git clone -b next https://github.com/cophi-wue/pydelta - cd pydelta - pip install -r requirements.txt -This will also install a version of scikit-learn that features -k-Medoids-Clustering which is not in the official version yet. + +Different branches, different versions +====================================== + +There are currently three different long-running branches: + +1. The **master** branch contains a rather old version of pydelta capable of running single experiments with a bunch of delta measures. Will be replaced sometime soon. +2. The **develop** branch is based on the script in the master version, but it contains more delta methods as well as some very unpolished command line scripts that we used, e.g., in order to produce the results presented at DH 2015 in Sidney. +3. The **next** branch is more or less a re-implementation that is not yet feature complete. It does not contain a command-line executable, and some of the methods that did not perform well have been left out. + + +Installation and Requirements +============================= + +PyDelta requires **Python 3.3 or newer**. It has quite a set of dependencies (NumPy, Pandas, SciPy, SciKit-Learn, …), but it comes with a setup script that installs it with its dependencies. If you only wish to use it, not to hack on it, pip can clone and install it for you:: @@ -35,11 +45,16 @@ If you only wish to use it, not to hack on it, pip can clone and install it for (Note that the Python 3 version of pip is sometimes called ``pip3``). +Developers can clone the repo and run pip to install:: -Usage -===== + git clone -b next https://github.com/cophi-wue/pydelta + cd pydelta + pip install -r requirements.txt + +This will also install a version of scikit-learn that features +k-Medoids-Clustering which is not in the official version yet. You may need to +install numpy, scipy, and Cython separately first. -There is no command line script yet. Read on in the Concepts guide to get started. ---- diff --git a/docs/concept.rst b/docs/concept.rst index b444e4a..4708200 100644 --- a/docs/concept.rst +++ b/docs/concept.rst @@ -73,7 +73,7 @@ The latter is created from a *descriptor* which consists of the distance functio CompositeDeltaFunction("manhattan-z_score", "burrows", "Burrows' Delta") -Running Multiple Experiments -============================ +3. Clustering +------------- TODO diff --git a/docs/delta.rst b/docs/delta.rst index 30b1556..fc917ca 100644 --- a/docs/delta.rst +++ b/docs/delta.rst @@ -1,11 +1,8 @@ -delta package -============= +API documentation +================= The end-user facing stuff from the submodules is also exported by the package, so you can call, e.g., ``delta.Corpus``. -Submodules ----------- - delta.corpus module ------------------- @@ -56,14 +53,6 @@ delta.graphics module :undoc-members: :show-inheritance: -delta.experiments module ------------------------- - -.. automodule:: delta.experiments - :members: - :undoc-members: - :show-inheritance: - Module contents ---------------