Skip to content

smritigambhir/larray

 
 

Repository files navigation

LArray: N-dimensional labelled arrays

build status Documentation Status

LArray is open source Python library that aims to provide tools for easy exploration and manipulation of N-dimensional labelled data structures.

Library Highlights

  • N-dimensional labelled array objects to store and manipulate multi-dimensional data
  • I/O functions for reading and writing arrays in different formats: CSV, Microsoft Excel, HDF5, pickle
  • Arrays can be grouped into Session objects and loaded/dumped at once
  • User interface with an IPython console for rapid exploration of data
  • Compatible with the pandas library: LArray objects can be converted into pandas DataFrame and vice versa.

Installation

Pre-built binaries

The easiest route to installing larray is through Conda. 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 (1.10.0 or later)
  • pandas (0.13.1 or later)

Optional Dependencies

For IO (HDF, Excel)

  • pytables: for working with files in HDF5 format.
  • xlrd: for reading data and formatting information from older Excel files (ie: .xls)
  • openpyxl: recommended package for reading and writing Excel 2010 files (ie: .xlsx)
  • xlsxwriter: alternative package for writing data, formatting information and, in particular, charts in the Excel 2010 format (ie: .xlsx)
  • 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, edit and compare arrays.

  • pyqt (4 or 5): required by larray-editor (see below).
  • pyside: alternative to PyQt.
  • qtpy: required by larray-editor. Provides support for PyQt5, PyQt4 and PySide using the PyQt5 layout.
  • larray-editor: required to use the graphical user interface associated with larray. It assumes that qtpy and pyqt or pyside are installed. On windows, creates also a menu LArray in the Windows Start Menu.

For plotting

Documentation

The official documentation is hosted on ReadTheDocs at http://larray.readthedocs.io/en/stable/

Get in touch

  • Report bugs, suggest features or view the source code on GitHub.
  • For questions, ideas or general discussion, use the mailing list.

Packages

No packages published

Languages

  • Python 99.9%
  • Other 0.1%