= Post-publication sharing of raw data =
The OMERO.web framework allows raw data to be published to external web pages.
Selected datasets can be made visible to a ‘public user’ using the standard OMERO permissions system, ensuring you always have control over how users can interact with your data.
=== To begin with ===
You need to be made a member of a public group on the EPFL OMERO server before you can start sharing data.
=== Public group creation ===
(IMPORTANT) Please contact [[ mailto:claire.stoffel@epfl.ch | Claire Stoffel ]] if you want to create a public group dedicated to your lab/unit.
= Add data to a public group =
You can either move data from an existing group into a public group, or import data directly into a public group
=== Move data from a private to a public group ===
To move data into a public group, select a project, dataset or an image in the left
hand pane (from the OMERO.insight client or from [[ https://omero.epfl.ch/webclient/login/ | OMERO.web ]])
Right-click and select `Move to Group ...` in the menu, and choose the public group you belong to.
{F16736764, layout=inline, height=300} {F16736774, layout=inline, height=300}
=== Add new data to a public group ===
To import data directly into a public group, go to `File` > `Import...` in the OMERO.insight client. In the Import Location window, choose the public group you belong to in the `Group` drop-down menu.
{F16736810, size=full}
(IMPORTANT) You always remain the owner of any of your images in a public group, and can still change
rendering settings, add ROIs or annotate them.
= Share links to your published data =
(IMPORTANT) Log off from the private (regular) webclient (omero.epfl.ch), and then go to the **public** OMERO webclient: [[ https://omero-public.epfl.ch/webclient/ | omero-public.epfl.ch ]].
From this public page, browse in the public groups to select the item (image, dataset..) you want to share. You can create direct URLs to any item from a public group: To do so, select the chosen element (image, dataset,...) and hit the `create link` button in the right panel from the **public** OMERO.web. Paste this link and share it to people inside or outside EPFL, and they will be able to view your data without the need to enter credentials.
{F18975293, size=full}
Here are a few examples of public URLs
- to an `image` from a dataset : https://omero-public.epfl.ch/webclient/?show=image-2001
- to an `image` opened in the image viewer : https://omero-public.epfl.ch/webclient/img_detail/2001/?dataset=151
- to a `dataset` : https://omero-public.epfl.ch/webclient/?show=dataset-155
- to a `project` : https://omero-public.epfl.ch/webclient/?show=project-101
- to a `tag` : https://omero-public.epfl.ch/webclient/?show=tag-2452
= Guidelines to publish data with OMERO.web =
(IMPORTANT) Please contact [[ mailto:claire.stoffel@epfl.ch | Claire Stoffel ]] if you want to create a public group dedicated to your lab/unit.
The created group will be named `UNIT Public`
== Data layout: ==
=== Projects and Datasets ===
- Please create separate projects for each individual publication, named "//Author //et al,// date// "
Under "Project details" (right panel), you can add useful general informations on your publication, like the complete name and the DOI.
{F16782323, height=300}
Still at the project level, Key-Value pairs can be used to add more detailed informations on your publication:
{F16782338, layout=inline, height=300} {F16782365, layout=inline, height=300}
- You can create datasets for each figure or sub-figure of your publication
{F16782272, height=300}
At the dataset level, under "Dataset details" (right panel), you can add the complete legend of the publication figure or sub-figure that correspond to your dataset
{F16782434, height=300}
You can also make use of Key-Value pairs at the dataset level to add more detailed informations on each figure.
- Import the raw images that were used to create each figure from the publication in the corresponding OMERO dataset.
=== Attachements and tags ===
- Attach the figures generated with OMERO.figure (PDF), and figures generated with other softwares to the raw images from which they were generated, and/or to the OMERO dataset that contains them
- It is recommended to attach to datasets every files that describes the pipeline of how figures were generated from raw data. (text files, excels or .csv, processing scripts..)
- Data can also be tagged with OMERO tags to enhance the browsing possibilities through these data for any user with basic knowledge of OMERO. For example, tags can highlight the images displayed in the publication figures as images. Images only used for analysis which produced the published numerical data can also be tagged accordingly.
== General Tips ==
Having all the data belong to one user simplifies the UI experience for public users. If necessary, ownership of data can be transferred.
== Configuring URLs ==
The URL of the Project (corresponding to the publication) can be used for a DOI and data landing page. For example, ’https://omero.lifesci.dundee.ac.uk/webclient/?show=project-27936 corresponds to http://dx.doi.org/10.17867/10000109.
(IMPORTANT) You can include this DOI directly in the publication, like in [[ https://royalsocietypublishing.org/doi/10.1098/rsob.170099 | this example ]]
{F16783179, size=full}
---
{icon hand-o-right} [[ https://c4science.ch/w/bioimaging_and_optics_platform_biop/image-processing/omero/analysis/ | NEXT STEP: Analysis Softwares and OMERO ]]
---