When using our software, we kindly ask you to cite our website URL and related publications in all your work (publications, studies, oral presentations,...). In particular, we recommend to cite (Marée et al., Bioinformatics 2016) paper, and to use our logo when appropriate. See our license files for additional details.
## Presentation
The Cytomine-WebUI is the official front-end for Cytomine, developed in VueJS.
You will find more information about the Cytomine project on the [website](https://www.cytomine.org).
You can also find, on our official documentation [how to install it](https://documentation.cytomine.org/How-to-install-Cytomine?structure=Admins) and [an user guide](https://documentation.cytomine.org/UsersV2?structure=UsersV2).
- Scientific paper: Raphaël Marée, Loïc Rollus, Benjamin Stévens, Renaud Hoyoux, Gilles Louppe, Rémy Vandaele, Jean-Michel Begon, Philipp Kainz, Pierre Geurts and Louis Wehenkel. Collaborative analysis of multi-gigapixel imaging data using Cytomine, Bioinformatics, DOI: 10.1093/bioinformatics/btw013, 2016. http://dx.doi.org/10.1093/bioinformatics/btw013
The main features of this new front-end are
* A complete new Cytomine experience.
* Support of internationalization i.e. multiple languages (English and French currently available). You can contribute by adding new languages (See [here](https://documentation.cytomine.org/How-to-contribute?structure=Contributors).
* Reactive application.
* New lists of project, image, job with sorting, searching and filtering.
* Display details of images, jobs and projects in all the lists.
* A complete refactoring of the image viewer to focus on the main part : the image. The other components have been developed to be discreet and can be fold in if necessary. The viewer is now compatible with tablets.
* Rotation of images at any specific angle.
* Set up of magnification and resolution of each image directly from the viewer or the image list.
* Zoom beyond the maximum resolution of an image by activating a digital zoom.
* Display more than one image into a viewer for efficient comparison. These opened images can be linked to synchronize your navigation and allow you to easily browse though multiple images at once.
* Draw annotations with a preselected term.
* Opacity of each term color can be specificly set up.
* Straight lines and Free hand lines annotations are now available.
* Brightness, Contrast, Saturation and Hue of a image can be set up during visualization.
* The Workspace feature allows you to open multiple projects and image and go back to a currently opened image or project.
* A quick search across the platform is available in the top navigation bar.
* An advanced panel allowing you to search all across the platform.
* Set for projects default annotation layers and default property which will be displayed at the opening of an image.
* Follow in real time an other user viewer or part of viewer, only if this user have allowed the Cytomine platform to broadcast it.
* Simplification of user managment in projects.
* Change the ontology of a project is now possible.
* Edition of ontology terms had been simplified.
* Adding attached files to a project, a image, or an annotation is now possible.
* Manage files in storage is enriched by total size on disk and list of sub images for archived or converted images.
## Presentation
Front-end for Cytomine in VueJS. For more information about Cytomine, go to https://www.cytomine.org.
## Installation
This section assumes that you have access to an instance of Cytomine. The following steps will allow you to run locally a front-end interacting with this instance:
This section assumes that you have access to an instance of Cytomine (especially [Cytomine-core](https://github.com/cytomine/Cytomine-core)) and an installed proxy. These two conditions are filled if you have used [Cytomine-bootstrap](https://github.com/cytomine/Cytomine-bootstrap). The following steps will allow you to run a front-end interacting with this instance:
* Execute `npm install` to install the dependencies ;
* Change the value of constants `CYTOMINE_CORE_HOST` and `CYTOMINE_UPLOAD_HOST` in src/utils/constants.js ; you may also update other constants according to your Cytomine instance or your preferences;
* Execute `npm run build` to build all the files into a `dist` folder.
* Configure your proxy to redirect http request on the index.html file or replace the dist folder in your Cytomine-bootstrap by this one.
## Local installation
This section assumes that you have access to an instance of Cytomine (especially [Cytomine-core](https://github.com/cytomine/Cytomine-core)). The following steps will allow you to run locally a front-end interacting with this instance:
* Execute `npm install` to install the dependencies ;
* Change the value of constants `CYTOMINE_CORE_HOST` and `CYTOMINE_UPLOAD_HOST` in src/utils/constants.js ; you may also update other constants according to your Cytomine instance or your preferences;
...
...
@@ -19,3 +51,7 @@ This section assumes that you have access to an instance of Cytomine. The follow
### Remarks:
* If the front-end is not expected to run on the same host/port as the core, NGINX should be configured to allow CORS addressed to the core
* When using our software, we kindly ask you to show our website URL and our logo in all your work (web site, publications, studies, oral presentations, manuals, ...). If you use Cytomine for scientific purpose, please cite Marée et al., Bioinformatics 2016 as reference paper. See our license files for additional details.
- Scientific paper: Raphaël Marée, Loïc Rollus, Benjamin Stévens, Renaud Hoyoux, Gilles Louppe, Rémy Vandaele, Jean-Michel Begon, Philipp Kainz, Pierre Geurts and Louis Wehenkel. Collaborative analysis of multi-gigapixel imaging data using Cytomine, Bioinformatics, DOI: 10.1093/bioinformatics/btw013, 2016. http://dx.doi.org/10.1093/bioinformatics/btw013
