Goulib 1.7.0

library of useful Python code for scientific + technical applications

Goulib
======

library of useful Python code for scientific + technical applications

.. image:: https://pypip.in/license/Goulib/badge.png
:target: https://github.com/goulu/Goulib/blob/master/LICENSE.TXT
:alt: License
.. image:: https://pypip.in/version/Goulib/badge.png
:target: https://pypi.python.org/pypi/Goulib/
:alt: Version
.. image:: https://travis-ci.org/goulu/Goulib.png?branch=master
:target: https://travis-ci.org/goulu/Goulib
:alt: Build
.. image:: https://coveralls.io/repos/goulu/Goulib/badge.png
:target: https://coveralls.io/r/goulu/Goulib
:alt: Tests
.. image:: https://www.ohloh.net/accounts/543923/widgets/account_tiny.gif
:target: https://www.ohloh.net/accounts/543923?ref=Tiny
.. image:: https://api.coderwall.com/goulu/endorsecount.png
:target: https://coderwall.com/goulu

:author: Philippe Guglielmetti [e-mail]
:installation: "pip install Goulib"
:distribution: https://pypi.python.org/pypi/Goulib
:documentation: https://goulib.readthedocs.org/
:source: https://github.com/goulu/Goulib

Modules
-------

colors
hex RGB colors and related functions
datetime2
additions to datetime standard library
decorators
useful decorators
drawing
handle vector graphics in .dxf, .svg and .pdf formats
expr
simple symbolic math expressions
geom
vector, matrix and quaternion operations + line, arc, circle entities for use in 2D and 3D graphics applications.
graph
efficient Euclidian Graphs for NetworkX and related algorithms
interval
operations on [x..y[ intervals
itertools2
additions to itertools standard library
markup
simple HTML/XML generation (forked from `markup <http://pypi.python.org/pypi/markup/>`_)
math2
additions to math standard library
motion
functions of time which provide (position, velocity, acceleration, jerk) tuples
nvd3
JavaScript charts using http://nvd3.org/ and and http://d3js.org
( Obsolete. use `python-nvd3 <http://pypi.python.org/pypi/python-nvd3/>`_ which is derived from this module. )
optim
optimization algorithms : knapsack, travelling salesman, simulated annealing
piecewise
piecewise-defined functions
polynomial
manipulation of polynomials, forked from http://code.activestate.com/recipes/362193-manipulate-simple-polynomials-in-python/ by Rick Muller
table
Table class with Excel + CSV I/O, easy access to columns, HTML output, and much more.
workdays
WorkCalendar class with datetime operations on working hours
merges and improves `BusinessHours <http://pypi.python.org/pypi/BusinessHours/>`_ and `workdays <http://pypi.python.org/pypi/workdays/>`_ packages

Requirements
------------
Goulib uses only standard Python libs, except:
- `graph` needs `NetworkX <http://networkx.github.io/>`_ and `RTree <http://toblerity.org/rtree/>`_
+ some algorithms need `SciPy <http://scipy.org/>`_ and `NumPy <http://numpy.org/>`_

- `drawings` needs:
+ `dxfgrabber <http://pypi.python.org/pypi/dxfgrabber/>`_ and `dxfwrite <http://pypi.python.org/pypi/dxfwrite/>`_
+ PIL or `pillow <http://pypi.python.org/pypi/pillow/>`_ for bitmap output (Pillow is prefered over PIL because of Travis CI tests)

- `table.Table.read_xls` needs `xlrd <http://pypi.python.org/pypi/xlrd/>`_
- `table.Table.read_html` needs `lxml <http://pypi.python.org/pypi/lxml/>`_

automated `nose <http://pypi.python.org/pypi/nose/>`_ tests generated by `pythoscope <http://pypi.python.org/pypi/pythoscope/>`_