Metadata-Version: 1.1
Name: semantic
Version: 1.0.3
Summary: Common Natural Language Processing Tasks for Python
Home-page: https://github.com/crm416/semantic
Author: Charles Marsh
Author-email: crmarsh@princeton.edu
License: UNKNOWN
Description: ===========
        Semantic
        ===========
        
        .. image:: https://badge.fury.io/py/semantic.png
            :target: http://badge.fury.io/py/semantic
        
        Semantic is a Python library for extracting semantic information from text, including dates, numbers, mathematical equations, and unit conversions.
        
        For each of these four semantic types, semantic provides a service module. Typical usage often looks like this::
        
            #!/usr/bin/env python
            from semantic.dates import DateService
        
            service = DateService()
            date = service.extractDate("On March 3 at 12:15pm...")
            ...
        
        The full documentation can be found `here <https://pythonhosted.org/semantic/>`_, while the source code itself is also available on `GitHub <https://github.com/crm416/semantic>`_.
        
        Installation
        ============
        
        Installing semantic is simple::
        
            $ pip install semantic
        
        Features
        ========
        
        semantic contains four main modules, each of which corresponds to a different semantic extractor.
        
        Dates (*date.py*)
        -----------------
        
        Useful for:
        
        * Extracting relative (e.g., "a week from today") and absolute (e.g., "December 11, 2013") dates from text snippets.
        * Converting date objects to human-ready phrasing.
        
        Numbers (*number.py*)
        ---------------------
        
        Useful for:
        
        * Extracting numbers (integers or floats) from text snippets.
        * Converting numbers to human-readable strings.
        
        Example usage::
        
            #!/usr/bin/env python
            from semantic.numbers import NumberService
        
            service = NumberService()
        
            print service.parse("Two hundred and six")
            # 206
        
            print service.parse("Five point one five")
            # 5.15
        
            print service.parse("Eleven and two thirds")
            # 11.666666666666666
        
            print service.parseMagnitude("7e-05")
            # "seven to the negative five"
        
        
        Math (*solver.py*)
        ------------------
        
        Useful for performing mathematical operations expressed as words.
        
        Example usage::
        
            #!/usr/bin/env python
            from semantic.solver import MathService
        
            service = MathService()
        
            print service.parseEquation("Log one hundred and ten")
            # 4.70048
        
        Units (*units.py*)
        ------------------
        
        Useful for converting between units expressed as words.
        
        Example usage::
        
            #!/usr/bin/env python
            from semantic.solver import ConversionService
        
            service = ConversionService()
        
            print service.convert("Seven and a half kilograms to pounds")
            # (16.534, 'lbs')
        
            print service.convert("Seven and a half pounds per square foot to kilograms per meter squared")
            # (36.618, 'kg/m**2')
        
        
        Testing
        =======
        
        The test suite (*test.py*) contains tons of examples and use-cases for each of the four modules.
        
        Requirements
        ============
        
        The Dates, Numbers, and Math modules can run in isolation (i.e., without any dependencies), while the Units module requires `quantities <https://pypi.python.org/pypi/quantities>`_ and `Numpy <http://www.numpy.org>`_.
        
        License
        =======
        
        MIT © `Charles Marsh <http://www.princeton.edu/~crmarsh>`_
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Human Machine Interfaces
Classifier: Topic :: Text Processing :: Linguistic
