An interface to convert odML structures to and from table-like representations, such as spreadsheets.
odMLtables provides a set of functions to simplify the setup, maintenance and usage of a metadata management structure using odML. In addition to the Python API, python-odmltables provides its main functionality also via a graphical user interface.
The following packages are required to use python-odmltables:
- Python >= 2.7
- numpy >= 1.8.2
- quantities >= 0.10.1
- odml >= 1.1
- xlrd >= 0.9.4
- xlwt >= 1.0.0
- For building the documentation:
- numpydoc >= 0.5
- sphinx >= 1.2.2
- For running tests:
- nose >= 1.3.3
- For the graphical user interface:
- pyqt4 >= 4.11.4
Official release versions are available at the [Python Package Index] (https://pypi.python.org/pypi/python-odmltables/) and can be installed using pip:
$ pip install --process-dependency-links python-odmltables
To install the latest version of odmltables you first need to download the odmltables source files and install it in a second step.
The latest version of python-odmltables is available on [GitHub] (https://github.com/INM-6/python-odmltables). You can either use git and download python-odmltables directly under Linux using:
$ cd /home/usr/toolbox/
$ git clone https://github.com/INM-6/python-odmltables.git
or alternatively download python-odmltables as ZIP file and unzip it to a folder.
The documentation of odmltables is based on [sphinx] (http://www.sphinx-doc.org/en/stable/) and can be vizualized in multiple formats. E.g., to access the documentation in html format navigate to the documentation folder within odmltables and compile the html documentation:
$ cd /home/usr/toolbox/python-odmltables/doc
$ make html
All output format available can be listed using:
$ make -n
On Linux, to set up python-odmltables you navigate to your python-odmltables folder and install it via:
$ cd /home/usr/toolbox/python-odmltables/
$ python setup.py install
You can start the odmltables graphical wizard by calling:
$ odml-tables
Alternatively, you may navigate to the python-odmltables folder and run:
$ ./odmltables-gui
On non-Linux operating systems we recommend using the Anaconda Python distribution, and installing all dependencies in a Conda environment, e.g.:
$ conda create -n neuroscience python numpy scipy pip six
$ source activate neuroscience
Then navigate to the folder where you downloaded python-odmltables and run:
$ python setup.py install
On Windows, to run the graphical wizard, execute odml-tables.exe in the Anaconda/Envs/neuroscience/Scripts folder in your User directory.
Alternatively, on Windows or Mac OS X you may navigate to the python-odmltables folder and run:
$ python odmltables-gui.py
If you observe a bug in odMLtables please add a bug report at [the github bug tracker] (https://github.com/INM-6/python-odmltables/issues)