Skip to content

This is a limited-functionality, beta - implementation of the integration of Micro-Meta App in the OMERO.web client

License

Notifications You must be signed in to change notification settings

WU-BIMAC/MicroMetaApp-Omero

Repository files navigation

This software is a Micro-Meta App dependency, which was developed as part of a global community initiative including the 4D Nucleome Imaging Working Group, BINA Quality Control and Data Management Working Group and QUAREP-LiMi.

News! The works of this global community effort resulted in multiple publications featured on a recent Nature Methods FOCUS ISSUE dedicated to Reporting and reproducibility in microscopy.

Learn More! For a thorought description of Micro-Meta App consult our recent Nature Methods and BioRxiv.org publications!

Background If you want to learn more about the importannce of metadata and quality control to ensure full reproducibility, quality and scientific value in light microscopy, please take a look at our recent publications describing the development of community-driven light microscopy metadata specifications (Nature Methods and BioRxiv.org) and our overview manuscript entitled "A perspective on Microscopy Metadata: data provenance and quality control", which is available on ArXiv.org.

4DN Micro-Meta App OMERO plugin -- alpha prototype

  1. Quick start guide
  2. Summary
  3. Background
  4. Description
  5. Website
  6. Installation
  7. Documentation
  8. Step-by-Step Instructions
  9. Tutorial Videos
  10. Example data files

Quick start guide

Use these videos to get started with using Micro-Meta App after intallation into OMERO and downloading the example data files:

  1. Video 1
  2. Video 2

Summary

Micro-Meta App is an interactive tool that was developed by Alex Rigano in the Strambio De Castillia's lab at the University of Massachusetts Chan Medical School to facilitate the documentation of light microscopy experiments on the basis of the scalable 4DN-BINA-OME Microscopy Metadata specifications that extend the OME Data Model.

Micro-Meta App is used to visually and intuitively document the microscopy conditions used to acquire specific datasets based on community-driven 4DN-BINA-OME Microscopy Metadata specifications.

This repository contains a prototype of a plugin to be integrated into the OMERO.web browser.

Other available implementations of Micro-Meta App include:

Micro-Meta App: Create Microscope GUI Micro-Meta App is designed to aid in the collection of both Microscope Hardware Specifications and Image Acquisition Settings metadata. In this example, a previously saved Microscope file was selected from an available repository and opened for further editing. In order to add the metadata associated with a newly purchased objective to a Microscope file the “Magnification” drop-down menu is opened [1] and an additional “Objective” [2] is dragged onto the workspace.

Background

Adequate recordkeeping is essential for most experiments as it is necessary in order to evaluate results, share data and allow experiments to be repeated. Keeping notes on microscopy experiments should be relatively unchallenging, as the microscope is a machine equipped with a limited number of known parts and settings. Nevertheless, to this date no widely adopted set of metadata guidelines to be recorded or published with imaging data exists. Metadata automatically recorded by microscopes from different companies vary widely and pose a substantial challenge for microscope users to create a good faith record of their work. Similarly, the complexity and aim of experiments using microscopes varies leading to different reporting requirements from the simple description of a sample to the need to document the complexities of sub-diffraction resolution imaging in living cells and beyond. To address this challenge, the 4DN consortium has put forth a 4DN extension of the OME Core metadata model, which includes a tiered system of reporting guidelines that scales quality control and reporting requirements with experimental complexity and a comprehensive list of metadata key-value pairs that should be recorded for each tier, and a detailed explanation of why these values matter. Micro-Meta App was developed in order to lessen the recordkeeping burden, support the collection of microscopy provenance medatata and facilitate the wide adoption of these standards by the the imaging community at large.

Description

Micro-Meta App is a novel application that provides an interactive and intuitive approach for rigorous record-keeping in fluorescence microscopy and is based on the 4DN-OME Microscopy metadata standard and on the proposed tiered-system of guidelines. The user’s data processing workflow consists of multiple steps. First, in the Create Microscope modality (Figure 1), the App allows the users to build a graphical representation of the microscope hardware by dragging-and-dropping individual components onto the workspace and entering the relevant attribute values based on the selected tier level. Second, Micro-Meta App generates tier-specific descriptions of the microscope hardware and exports them in a Microscope file that can be used as a template and shared with the community, with a significant reduction in the recordkeeping burden. Then, in the Use Microscope modality, Micro-Meta App opens an existing Microscope file, imports Image Acquisition settings from the header of image data files to be annotated and interactively guides the user through the collection of all missing instrument-specific and tier-appropriate image acquisition settings and calibration metrics required to ensure reuse and reproducibility of image data. Finally, the App generates JSON files that contain comprehensive descriptions of the conditions utilized to produce individual microscopy datasets, and that can be stored on the user’s file system, or on third party repositories. To lower the barrier of adoption of Micro-Meta App by a wide community of users the application is available as a stand-alone program, as a plugin of the OMERO web client and as a service of the 4DN data portal.

Installation

Requirements

The Micro-Meta App Omero.web plugin requires a working Omero.server and Omero.web environment to be installated.

Install

  1. Download the latest pip friendly (.tar.gz) release from here.

  2. Run

pip install </path/to/package/folder/nameofthefile.tar.gz>

Or if you prefer a manual installation unpack the file in your pluging folder (that should be added to your python path).

  1. Add the plugin to your omero with
omero config append omero.web.apps '"omero_microMetaApp"'
  1. Optionally add a top menu link with
omero config append omero.web.ui.top_links '["Micro-Meta-App", "microMetaAppOmero_index", {"title": "Micro-Meta-App", "target": "_blank"}]'