odML (Open metaData Markup Language) core library
The open metadata Markup Language is a file based format (XML, JSON, YAML) for storing metadata in an organised human- and machine-readable way. odML is an initiative to define and establish an open, flexible, and easy-to-use format to transport metadata.
The Python-odML library can be easily installed via
pip. The source code is freely
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.
odML Version 1.4 introduced breaking format and API changes compared to the previous versions of odML. Files saved in the previous format versions can be converted to a 1.4 compatible format using the version converter from the odml/tools package.
Be aware that the value dtype
binary has been removed. Incorporating actual binary
data into odML files is discouraged, provide references to the original files using the
URL dtype instead.
For details regarding the introduced changes please check the github release notes.
- Python 2.7 or 3.5
- Python packages:
- enum (version 0.4.4)
- lxml (version 3.7.2)
- yaml (version 3.12)
- rdflib (version >=4.2.2)
- These packages will be downloaded and installed automatically if the
pipmethod is used to install odML. Alternatively, they can be installed from the OS package manager. On Ubuntu, they are available as:
- If you prefer installing using the Python package manager, the following packages are
required to build the lxml Python package on Ubuntu 14.04:
The simplest way to install Python-odML is from PyPI using the pip tool:
$ pip install odml
On Ubuntu, the pip package manager is available in the repositories as
If this method is used, the appropriate Python dependencies are downloaded and installed automatically.
Building from source
To download the Python-odML library please either use git and clone the repository from GitHub:
$ git clone https://github.com/G-Node/python-odml.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 Python-odML library, enter the corresponding directory and run:
$ cd python-odml $ python setup.py install
Note The master branch is our current development branch, not all features might be working as expected. Use the release tags instead.
odML Project page
More information about the project including related projects as well as tutorials and examples can be found at our odML project page.
Bugs & Questions
Should you find a behaviour that is likely a bug, please file a bug report at the github bug tracker.
If you have questions regarding the use of the library, feel free to join the #gnode IRC channel on freenode.