odML-UI 1.3.0

odML Editor

The odML-Editor is a standalone GUI application used for working with the odML Documents. The Python odML library is available on GitHub. If you are not familiar with the version control system git, but still want to use it, have a look at the documentation available on the git-scm website.

Dependencies

The odML-Editor makes use of the Gtk 3+ library for the GUI, and the python-odml library. Following dependencies need to be installed for the odML-Editor.

• Python 2.7+ or Python 3.4+

• odml v1.3 (pip install odml) or (pip3 install odml)

For Ubuntu-based distributions:

• sudo apt-get install libgtk-3-0

• sudo apt-get install gobject-introspection

• For Python 3, sudo apt-get install python3-gi

• For Python 2, sudo apt-get install python-gi

For Fedora-based distributions:

• sudo dnf install gtk3

• sudo dnf install pygobject3

• For Python 3, sudo dnf install python3-gobject

• For Python 2, sudo dnf install python-gobject

Anaconda Dependencies

Anaconda environments require only the following packages before installing the odML-Editor:

• Python 2.7+ or Python 3.4+.

• Install the following packages in the following order.:

  $ conda install -c pkgw/label/superseded gtk3
  $ conda install -c conda-forge pygobject
  $ conda install -c conda-forge gdk-pixbuf
  $ conda install -c pkgw-forge adwaita-icon-theme

MacOS using homebrew:

For Python 2 (Python 3) * brew install gtk+ (gtk+3) * brew install pygobject (pygobject3) * brew install gnome-icon-theme * brew install gobject-introspection

Installation

To download the odML-Editor, please either use git and clone the repository from GitHub:

$ cd /home/usr/toolbox/
$ git clone https://github.com/G-Node/odml-ui.git

If you don’t want to use git, download the ZIP file also provided on GitHub to your computer (e.g. as above on your home directory under a “toolbox” folder).

To install the odML-Editor, enter the corresponding directory and run:

$ cd /home/usr/toolbox/odml-ui/
$ python setup.py install

Note: pip install gi will lead to a namespace conflict with the required GObject introspection library.

Documentation

odML related documentation can be found at the Python-odML tutorial page.

Bugs & Questions

Should you find a behaviour that is likely a bug or feel there is something missing, just create an issue over at the GitHub odML-Editor issue tracker.