OMERO.web app to animate multi-dimensional microscopy using 3Dscript, directly from within the OMERO environment.
Project description
OMERO.3Dscript
Usage
- Open OMERO.web in the browser
- Open OMERO.3Dscript:
- by clicking on '3Dscript' on the top links
- right-click an image in the explorer and select 'Open with' -> '3Dscript'
- Enter the animation text (see https://bene51.github.io/3Dscript/ for more details)
- Click on 'Render'
Requirements for the server
- OpenCL capable graphics card
- Updated graphics drivers
Installation
OMERO.3Dscript needs to be installed on the machine that runs OMERO.web.
-
Install Fiji and the 3Dscript and 3Dscript.server plugins.
FIJI_HOME=/usr/local/share/Fiji.app mkdir $FIJI_HOME cd `dirname $FIJI_HOME` wget https://downloads.imagej.net/fiji/latest/fiji-linux64.zip unzip fiji-linux64.zip cd Fiji.app ./ImageJ-linux64 --update add-update-site 3Dscript "https://romulus.oice.uni-erlangen.de/updatesite/" ./ImageJ-linux64 --update add-update-site 3Dscript-server "https://romulus.oice.uni-erlangen.de/imagej/updatesites/3Dscript-server/" ./ImageJ-linux64 --update update apt-get update && apt-get install -y -qq ffmpeg > /dev/null
-
Install OMERO.3Dscript
pip install omero-3Dscript
-
Tell OMERO.3Dscript where to find Fiji
omero config set omero.web.omero_3Dscript.fiji_bin "/usr/local/share/Fiji.app/ImageJ-linux64"
:warning: On Mac OS X, you need to replace
ImageJ-linux64
withContents/MacOS/ImageJ-macosx
-
Add it to the OMERO.web UI:
omero config append omero.web.apps '"omero_3Dscript"' omero config append omero.web.ui.top_links '["3Dscript", "3Dscript_index", {"title": "Open 3Dscript in a new tab", "target": "_blank"}]' omero config append omero.web.open_with '["3Dscript", "3Dscript_index", {"supported_objects": ["image"], "target": "_blank", "label": "3Dscript"}]'
-
Restart OMERO.web as normal
Enabling the public user
If you want to grant the 'public user' the permission to render 3D animations using 3Dscript, you need to enable it as described here:
omero config set omero.web.public.enabled True
omero config set omero.web.public.user '<username>'
omero config set omero.web.public.password '<password>'
omero config set omero.web.public.url_filter '^/(webadmin/myphoto/|webclient/(?!(script_ui|ome_tiff|figure_script))|webgateway/(?!(archived_files|download_as))|iviewer|api|3Dscript)'
omero config set omero.web.public.get_only false
Pay attention to the last two lines.
See also
Publication
Schmid B., Tripal P., Fraass T. & Palmisano R. (2019), "3Dscript: animating 3D/4D microscopy data using a natural-language-based syntax", Nature methods 16(4): 278-280, PMID 30886414.
Schmid B., Tripal P., Winter Z. & Palmisano R. (2021), "3Dscript.server: true server-side 3D animation of microscopy images using a natural language-based syntax", Bioinformatics 37(24): 4901-4902, PMID 34152405.
Project details
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 Distributions
Built Distribution
Hashes for OMERO_3Dscript-0.0.10-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4a3536247e8aace973a99cab4a89793787713bd85f943c47e4935d12d3eef631 |
|
MD5 | 37bff81eb003f3e17637e6bdb65400e4 |
|
BLAKE2b-256 | fe7216ceb3cca4327587470b71a4e6ada730d11355b8b152786ac7cd031baf00 |