Metadata-Version: 2.0
Name: larray
Version: 0.22
Summary: N-D labeled arrays in Python
Home-page: https://github.com/liam2/larray
Author: Gaetan de Menten, Geert Bryon, Johan Duyck, Alix Damman
Author-email: gdementen@gmail.com
License: GPLv3
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries
Requires-Dist: numpy (>=1.10)
Requires-Dist: pandas (>=0.13.1)

LArray
======

larray provides a Labelled Array class

|build-status| |docs|


.. start-install

Installation
============

Pre-built binaries
------------------

The easiest route to installing larray is through
`Conda <http://conda.pydata.org/miniconda.html>`_.
For all platforms installing larray can be done with::

    conda install -c gdementen larray

This will install a lightweight version of larray
depending only on Numpy and Pandas libraries only.
Additional libraries are required to use the included
graphical user interface, make plots or use special
I/O functions for easy dump/load from Excel or
HDF files. Optional dependencies are described
below.

Installing larray with all optional dependencies
can be done with ::

    conda install -c gdementen larrayenv

You can also first add the channel `gdementen` to
your channel list ::

    conda config --add channels gdementen

and then install larray (or larrayenv) as ::

    conda install larray


Building from source
--------------------

The latest release of LArray is available from
https://github.com/liam2/larray.git

Once you have satisfied the requirements detailed below, simply run::

    python setup.py install


Required Dependencies
---------------------

- Python 2.7, 3.4, 3.5, or 3.6
- `numpy <http://www.numpy.org/>`__ (1.10.0 or later)
- `pandas <http://pandas.pydata.org/>`__ (0.13.1 or later)


Optional Dependencies
---------------------

For IO (HDF, Excel)
~~~~~~~~~~~~~~~~~~~

- `pytables <http://www.pytables.org/>`__:
  for working with files in HDF5 format.
- `xlrd <http://www.python-excel.org/>`__:
  for reading data and formatting information from older Excel files (ie: .xls)
- `openpyxl <http://www.python-excel.org/>`__:
  recommended package for reading and writing
  Excel 2010 files (ie: .xlsx)
- `xlsxwriter <http://www.python-excel.org/>`__:
  alternative package for writing data, formatting
  information and, in particular, charts in the
  Excel 2010 format (ie: .xlsx)
- `larray_eurostat <https://github.com/larray-project/larray_eurostat>`__:
  provides functions to easily download EUROSTAT files as larray objects.
  Currently limited to TSV files.

For Graphical User Interface
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

LArray includes a graphical user interface to
view and edit arrays.

- `pyqt <https://riverbankcomputing.com/software/pyqt/intro>`__ (4 or 5):
  for using the graphical user interface included in larray.
- `pyside <https://wiki.qt.io/PySide>`__:
  alternative to PyQt.
- `qtpy <https://github.com/spyder-ide/qtpy>`__:
  required if you install pyqt or pyside.
  Provides support for PyQt5, PyQt4 and PySide using the PyQt5 layout

For plotting
~~~~~~~~~~~~

- `matplotlib <http://matplotlib.org/>`__:
  required for plotting.


Update
------

If larray has been installed through conda, update
is done via ::

    conda update larray

Be careful if you have installed optional dependencies.
In that case, you may have to update some of them.

If larray has been installed through larrayenv,
you simply must do ::

    conda update larrayenv


.. |build-status| image:: https://travis-ci.org/liam2/larray.svg?branch=master
    :alt: build status
    :scale: 100%
    :target: https://travis-ci.org/liam2/larray

.. |docs| image:: https://readthedocs.org/projects/larray/badge/?version=latest
    :alt: Documentation Status
    :scale: 100%
    :target: https://larray.readthedocs.io/en/latest/?badge=latest


