Python bindings to the OMERO.blitz server
Project description
Introduction
OMERO.py provides Python bindings to the OMERO.blitz server as well as a pluggable command-line interface.
Dependencies
Direct dependencies of OMERO.py are:
future
numpy
Pillow
Installation
We recommend installing omero-py in a Python virtual environment. You can create one using either venv or conda (preferred). If you opt for Conda, you will need to install it first, see miniconda for more details.
To install omero-py using venv:
python3.6 -m venv myenv . myenv/bin/activate pip install omero-py
You may need to replace python3.6 with python or python3 depending on your Python distribution.
To install omero-py using conda (preferred):
conda create -n myenv -c ome python=3.6 zeroc-ice36-python omero-py conda activate myenv
Setting of the environment variable OMERODIR is required for some functionality. $OMERODIR/var/log/ directory will contain log files. $OMERODIR/etc/grid/config.xml is used to store config.
If OMERODIR is set to an OMERO.server directory, the import and admin commands will be enabled:
# If you need import or admin commands: export OMERODIR=/path/to/OMERO.server/ # otherwise, can choose any location. export OMERODIR=$(pwd)
See: OMERO documentation for more details.
Usage
Contributing
See: OMERO documentation
Developer installation
OMERO.py currently depends on an externally built artifact which is automatically bundled in the PyPI package.
For a development installation we recommend creating a virtualenv with the following setup (example assumes python3.6 but you can create and activate the virtualenv using any compatible Python):
To install using venv:
python3.6 -mvenv myenv . myenv/bin/activate git clone https://github.com/ome/omero-py cd omero-py python setup.py devtarget pip install -e .
To install omero-py using conda (preferred):
conda create -n myenv -c ome python=3.6 zeroc-ice36-python conda activate myenv git clone https://github.com/ome/omero-py cd omero-py python setup.py devtarget pip install -e .
This will install omero-py into your virtualenv as an editable package, so any edits to src files should be reflected in your installation. Note that if you add or remove files you must rerun the last two steps.
Running tests
Unit tests are located under the test directory and can be run with pytest.
Integration tests
Integration tests are stored in the main repository (ome/openmicroscopy) and depend on the OMERO integration testing framework. Reading about Running and writing tests in the OMERO documentation is essential.
License
OMERO.py is released under the GPL v2.
Copyright
2009-2020, The Open Microscopy Environment, Glencoe Software, Inc.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file omero-py-5.6.0.tar.gz.
File metadata
- Download URL: omero-py-5.6.0.tar.gz
- Upload date:
- Size: 2.3 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.6.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e75f53cd59a37db2f58699114a9c8306361732f27d392e5f25dcf267f583e8e7 |
|
| MD5 | 7f0c45a7bf93964288ada4858dca8b02 |
|
| BLAKE2b-256 | 7eb39feff3e0a225e9e962e194d2ca348e7c1195a71c7afaf5de11bbe8cde846 |
File details
Details for the file omero_py-5.6.0-py3-none-any.whl.
File metadata
- Download URL: omero_py-5.6.0-py3-none-any.whl
- Upload date:
- Size: 2.8 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.6.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d7a7f48d72c6051b0380efec606f0d411d4affeaae87dcefc7e304be81243eda |
|
| MD5 | 0a63ab5142d2d3d17792373bd69951da |
|
| BLAKE2b-256 | a394e71fa0af89fab0732840014fb77bbf0bfaacfe749090f72452ddbe0baede |
