Metadata-Version: 1.1
Name: rnlp
Version: 0.2.1
Summary: Converts text corpora into a set of relational facts.
Home-page: https://github.com/starling-lab/rnlp
Author: Alexander L. Hayes (@batflyer)
Author-email: alexander@batflyer.net
License: GPL-v3
Project-URL: Source, https://github.com/starling-lab/rnlp
Project-URL: Tracker, https://github.com/starling-lab/rnlp/issues
Description: ``rnlp``
        ========
        
        *Relational NLP Preprocessing: A Python package and tool for converting text into a set of relational facts.*
        
          .. image:: https://img.shields.io/pypi/pyversions/rnlp.svg?style=flat-square
          .. image:: https://img.shields.io/pypi/v/rnlp.svg?style=flat-square
          .. image:: https://img.shields.io/pypi/l/rnlp.svg?style=flat-square
          .. image:: https://img.shields.io/readthedocs/rnlp/stable.svg?flat-square
        	   :target: http://rnlp.readthedocs.io/en/stable/
        
        **Kaushik Roy** (`@kkroy36`_) and **Alexander L. Hayes** (`@batflyer`_)
        
        Installation
        ------------
        
        Stable builds on PyPi
        
        .. code-block:: bash
        
        		pip install rnlp
        
        Development builds on GitHub
        
        .. code-block:: bash
        
        		pip install git+git://github.com/starling-lab/rnlp.git
        
        Quick-Start
        -----------
        
        ``rnlp`` can be used either as a CLI tool or as an imported Python Package.
        
        +---------------------------------------+--------------------------------------+
        | **CLI**                               | **Imported**                         |
        +---------------------------------------+--------------------------------------+
        |.. code-block:: bash                   |.. code-block:: python                |
        |                                       |                                      |
        |  $ python -m rnlp -f files/doi.txt    |  from rnlp.corpus import declaration |
        |                                       |  import rnlp                         |
        |                                       |                                      |
        |                                       |  doi = declaration()                 |
        |                                       |  rnlp.converter(doi)                 |
        +---------------------------------------+--------------------------------------+
        
        Text will be converted into relational facts, relations encoded are:
        
        - between blocks of size 'n' (i.e. 2 sentences) in the blocks.
        
        - between block's of size n (i.e. 'n' sentences) and sentences in the blocks.
        
        - between sentences and words in the sentences.
        
        ---
        
        The relationships currently encoded are:
        
        1. earlySentenceInBlock - sentence occurs within a third of the block length
        
        2. earlyWordInSentence - word occurs within a third of the sentence length
        
        3. lateSentenceInBlock - sentence occurs after two-thirds of the block length
        
        4. midWayWordInSentence - word occurs between a third and two-thirds of the block length
        
        5. nextSentenceInBlock - sentence that follows a sentence in a block
        
        6. nextWordInSentence - word that follows a word in a sentence in a block
        
        7. sentenceInBlock - sentence occurs in a block
        
        8. wordInSentence - word occurs in a sentence.
        
        9. wordString - the string contained in the word.
        
        10. partOfSpeech - the part of speech of the word.
        
        ---
        
        Files contain a toy corpus (``files/``) and an image of a BoostSRL tree for predicting if a word in a sentence is the word "you".
        
        .. image:: https://raw.githubusercontent.com/starling-lab/rnlp/master/docs/img/output.png
        
        The tree says that if the word string contained in word 'b' is "you" then 'b' is the word "you". (This is of course true).
        A more interesting inference is the False branch that says that if word 'b' is an early word in sentence 'a' and word 'anon12035' is also an early word in sentence 'a' and if the word string contained in word 'anon12035' is "Thank", then the word 'b' has decent change of being the word "you". (The model was able to learn that the word "you" often occurs with the word "Thank" in the same sentence when "Thank" appears early in that sentence).
        
         .. _`@kkroy36`: https://github.com/kkroy36/
         .. _`@batflyer`: https://github.com/batflyer/
        
Keywords: nlp
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
