An OMERO.web app for visualizing images in OMERO.
Also see SUPPORT.md
- OMERO 5.4.0 or newer.
In order to build you need:
- nodejs version 6.x
- npm version equal or greater to 3.0!
To build an uncompressed version, run:
$ npm run debug
To build an uglified version, run:
$ npm run prod
All builds will build into the build directory and deploy to the plugin directory which can then be used like any Django plugin.
Intructions on how to add the OMERO.iviewer app to your installed OMERO.web apps can be found in the OMERO.iviewer README.
Note:
Should you like or need to rebuild OMERO.iviewer's internal ol3 viewer, please read the section ol3-viewer below!
Building the uncompressed version of iviewer as described above the application can be deployed locally or to a test server, to then be debugged. It is also possible to run/debug it with webpack dev-server:
$ npm run dev
will build the bundle and start the webpack dev-server (localhost:8080)
Either development setup expects the following:
- an OMERO server installation
- an iviewer 'deploy' to that OMERO server:
$ export PYTHONPATH=$PYTHONPATH:/path/to/iviewer-project-root/plugin $ bin/omero config append omero.web.apps '"omero_iviewer"'
Notes:
The webpack dev-server config expects a local OMERO server at http://localhost (default port 80). Should the server instance use a different port you will need to modify all proxy target entries in webpack.dev.config.js:
devServer: {
proxy: {
'/iviewer/**': {
target: 'http://localhost:your_port'
},
'/api/**': {
target: 'http://localhost:your_port'
}, ...
}
}
If you want to bind the webpack dev server to a port other than 8080 you will need to change its port property in webpack.dev.config.js:
devServer: {
port: your_port
}
The initial data type (e.g. image, dataset, well) and its respective ID can be set/changed in index-dev.html:
<html>
<head>
<link rel="stylesheet" type="text/css" href="build/css/all.min.css" />
<script type="text/javascript">
// modify according to your needs
// in particular: choose an existing id !
window.INITIAL_REQUEST_PARAMS = {
'VERSION': "DEV_SERVER",
'WEB_API_BASE': 'api/v0/',
//'IMAGES': "1",
'DATASET': "1",
//'WELL': "1"
};
</script>
...To build the html in build/docs, run:
$ npm run docs
The OMERO.iviewer's internal image viewer is based on OpenLayers 3,
The following software has to be installed in order to compile the java script code:
npm(node package manager)apache ant(and therefore a java runtime)python(for closure's calcdeps.py)
To build the OpenLayers viewer for OMERO.iviewer (deploys into libs directory), run:
$ ant
For further options type ant -p.
More detailed resources on how to create a web app and development setup can be found at:
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent