Abstract
For quality, interpretation, reproducibility and sharing value, microscopy images should be accompanied by detailed descriptions of the conditions that were used to produce them. Micro-Meta App is an intuitive, highly interoperable, open-source software tool that was developed in the context of the 4D Nucleome (4DN) consortium and is designed to facilitate the extraction and collection of relevant microscopy metadata as specified by the recent 4DN-BINA-OME tiered-system of Microscopy Metadata specifications. In addition to substantially lowering the burden of quality assurance, the visual nature of Micro-Meta App makes it particularly suited for training purposes.
Main
For microscopy images to be appropriately interpreted and reproduced, and to satisfying Findable Accessible Interoperable and Reusable (FAIR) principles1, they should be accompanied by detailed descriptions of microscope hardware, image acquisition settings, image pixel and dimensional structure and instrument performance. Currently, documentation of imaging experiments is seriously impaired by the lack of easy-to-use software tools that facilitate the extraction and collection of relevant microscopy metadata. Micro-Meta App is an intuitive open-source software designed to tackle these issues that has been developed in the context of the 4D Nucleome (4DN) consortium2,3, and of nascent global bioimaging community organizations, including BioImaging North America (BINA)4,5 and Quality Assessment and Reproducibility in light microscopy (QUAREP-LiMi)6,7,8, whose goal is to improve reproducibility, data quality and sharing value for imaging experiments. The App provides a visual interface for building comprehensive descriptions of the conditions used to produce microscopy datasets as specified by the 4DN-BINA-OME tiered-system of Microscopy Metadata specifications9,10,11,12,13. To ensure wide adoption by microscope users with different skill levels and needs, Micro-Meta App is ideally suited for training purposes and interoperates closely with MethodsJ2 (refs. 14,15) and OMERO.mde16,17, two complementary tools described in parallel manuscripts.
Microscopy metadata improve data quality and reproducibility
In addition to providing essential information about the provenance (that is, origin, lineage)18,19 of microscopy results, the establishment of community-driven, documentation and quality control (QC) specifications for light microscopy would make it possible to faithfully interpret scientific claims, facilitate comparisons within and between experiments, foster reproducibility and maximize the likelihood of data reuse6,7,8,20,21,22,23,24,25. First and foremost, such information would facilitate the compilation of accurate Methods sections for scientific publications26,27,28,29. Furthermore, it would provide clear guidance to microscope and software manufacturers about what information should be written automatically in the headers of image files during image acquisition to ensure scientific rigor. Finally, machine-actionable versions of the same information30 could be uploaded alongside image-datasets on the growing number of public image data resources22,31,32,33,34,35,36,37,38,39,40,41,42,43 that allow the deposition of raw image data associated with scientific manuscripts, emulating for light microscopy the successful path that led to genomics community standards44,45,46,47,48.
To promote the development of shared standards, the NIH-funded 4DN2,3 and the CZI-funded BINA4,5 have recently proposed the 4DN-BINA-OME (NBO) Microscopy Metadata specifications9,10,11,12,13. These specifications consist of an extension of the Open Microscopy Environment (OME) data model (that is, the basis for the widely adopted BioFormats library)49,50,51,52, which is organized in three tiers (details in Supplementary Information), and allows the classification of imaging experiments into levels of increasing complexity11,12,13,53. These specifications not only provide an OME-based comprehensive set of metadata that should be recorded, but they also specify which information subset should be included depending on experimental intent, technical intricacy and image analysis needs. The 4DN-BINA-OME specifications lay the foundations for upcoming community-sanctioned standards being developed by QUAREP-LiMi6,7. Their purpose is to provide a scalable, interoperable and OME-Next-Generation File Format (NGFF)54,55 compatible framework, guiding scientists as to what provenance metadata and calibration metrics should be afforded to ensure quality, reproducibility and value for different categories of light microscopy experiments.
To render metadata specifications and QC standards actionable and easy to adopt, experimental scientists require software tools (or, even better, automated pipelines) to easily extract all available metadata from microscope configuration and image files and produce well-documented, high-quality, reproducible and reusable datasets. Despite some advances26,56,57, current tools offer limited functionalities, and are not integrated with community standards. Here, we present a suite of three interoperable software tools (Extended Data Fig. 1) that were developed to provide complementary, intuitive approaches for the bench-side collection of experimental and microscopy metadata10,11,13. In two related manuscripts, we describe: (1) OMERO.mde, which emphasizes the development of flexible, nascent specifications for experimental metadata16,17,58 and (2) the ImageJ/Fiji MethodsJ2 plugin14,15, which automatically generates Methods for scientific publications. Here, we present Micro-Meta App (Figs. 1 and 2 and Supplementary Video 1), which works both as a stand-alone app and as an integrated resource in web repositories2,59,60. It offers a visual guide to navigate the steps required for the rigorous documentation of imaging experiments as sanctioned by 4DN-BINA-OME11,12,13,59.
Flowchart depicting the three sections of Micro-Meta App (1). a, The function of the initial section is to select among the three available 4DN-BINA-OME11,13 documentation tier levels (2), which is most appropriate for a given experimental -design, instrument-complexity and image analysis needs (details in Supplementary Information). b, The purpose of the Manage Instrument section is to create (or edit) a visual representation of the hardware configuration of a given microscope, which is then saved in a Microscope.JSON file (3) containing a list of components and associated 4DN-OME-BINA-specified metadata-information. c, The aim of the Manage Settings section is to collect relevant hardware information from an existing Microscope.JSON file (3), use BioFormats52 to retrieve existing OME-compatible microscopy metadata from an image of interest (4) and create (or edit) a Settings.JSON file (5) containing a rigorous description of the acquisition settings used for a given imaging experiment.
a, Illustrated is the use of the Manage Instrument section of Micro-Meta App to build a graphical record of the hardware components comprising the TIRF Epifluorescence Structured light Microscope (TESM) that was custom built at the Biomedical Imaging Group of UMass Chan Medical School. The resulting diagram allows the collection of all metadata-information sanctioned by Tier 3 (Fig. 1 and Supplementary Information) of the 4DN-BINA-OME model11,13. Specifically, by clicking on icons representing individual hardware components (for example, Objective, Filter Set or Camera), it is possible to record specific information describing each of them (for example, Objective Manufacturer, Model, Magnification and Numerical Aperture (NA)). b, Photograph depicting the TESM microscope illustrated in a. c, Use of the Manage Settings section of Micro-Meta App to build a graphical record of the lightpath (that is, from the illumination source to the detector) used for the acquisition of the 4,6-diamidino-2-phenylindole (DAPI) channel of the image in d. As shown, clicking on icons positioned along the lightpath it is possible to record the acquisition parameters (for example, Camera Bit Depth, Amplification Gain, Binning, etc.) that were used during the acquisition of a given image. d, Representative image obtained using the indicated microscope and settings (a and c).
Micro-Meta App: intuitive microscopy experiment documentation
In the absence of tools that expedite image data documentation and QC, the metadata provided by manufacturers often does not align with existing minimal information criteria (that is, OME and BioFormats)50,52 and, as a consequence, is extremely variable, interfering with quality assessment, reproducibility and meaningful reuse of third-party datasets (Extended Data Figs. 2 and 3). Micro-Meta App, developed to address these unmet needs, consists of an interactive open-source and interoperable software tool to facilitate and (where possible) automate the annotation of light microscopy datasets. It provides a visual approach for documenting imaging experiments based on available OME-compatible community-sanctioned tiered systems (details in Supplementary Information) of specifications, such as 4DN-BINA-OME11,12,13,53. Thus, Micro-Meta App can adapt to varying levels of imaging complexity and to evolving data-models emerging from the community. To this aim, Micro-Meta App uses two parallel dataflows (Fig. 1):
-
1.
In ‘Manage Instrument’ (hardware specifications; Figs. 1b and 2a and Extended Data Fig. 4) microscope users and custodians create accurate graphical depictions of microscope configurations by dragging-and-dropping icons representing hardware components onto the workspace while collecting relevant information scaling with microscope modality, experimental design, instrument-complexity and image analysis needs according to the 4DN-BINA-OME tier-level system11,12,13,53. From this, Micro-Meta App automatically generates interoperable Microscope.JSON files containing structured descriptions of the microscope Hardware Specifications (examples illustrated in Supplementary Information)61 that can be saved locally, and shared with other scientists via community repositories such as the 4DN-Data-Portal2,29,60,62, thus substantially lowering the burden of rigorous record-keeping and facilitating dissemination. Furthermore, such files can be imported in MethodsJ2 to automatically generate the Methods and Acknowledgement sections of scientific publications14,15.
-
2.
To document the conditions used to produce specific image-datasets, ‘Manage Settings’ (Figs. 1c and 2b and Extended Data Fig. 5) (1) automatically extracts Hardware Specifications metadata from available Microscope.JSON files, (2) uses BioFormats52 to import OME metadata stored in the header of image files (Extended Data Figs. 2 and 3) and (3) interactively guides the user to enter missing, instrument-specific, tier-appropriate, 4DN-BINA-OME sanctioned ‘Settings’ metadata used during the relevant ‘Image Acquisition’ session. From this, the App generates interoperable Settings.JSON files containing comprehensive documentation of the ‘Image Acquisition Settings’ relative to individual microscopy datasets (examples illustrated in Supplementary Information)61. These files can be stored as described in (1) and associated with related Microscope.JSON files and image-datasets to ensure proper imaging experiment documentation.
Detailed descriptions of the functionality, implementation and documentation material of Micro-Meta App are available in Supplementary Information, Methods and ref. 63.
Case studies: use at core facilities
To demonstrate feasibility and test usability, Micro-Meta App was employed, with minimal initial training, at 16 partnering core facilities (Extended Data Fig. 6) to document both example microscope instrumentation and the settings used for the acquisition of exemplar image-datasets (Fig. 2, Extended Data Figs. 7–9 and Supplementary Figs. 3–15)64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83. The most striking result (detailed in Supplementary Information) was that, in comparison with the baseline represented by BioFormats alone (Extended Data Figs. 2 and 3), the use of Micro-Meta App considerably increased the uniformity of reported metadata fields, facilitating comparison of image data within and across different microscopes and imaging experiments. In addition, since the App’s data model is defined dynamically on the basis of shared and evolving community specifications, the use of this method maximizes reproducibility, quality and value, while minimizing effort on the part of individual scientists. Example Microscope.JSON, Settings.JSON and image files produced for the use case in Extended Data Fig. 9 are publicly available on Zenodo as illustrated in the Data Availability section and in Supplementary Information61.
Case studies: integration to 4DN-Data-Portal
An initial impetus for the development of Micro-Meta App was the need to expedite and, where possible, automate the rigorous reporting of imaging experiments and QC procedures for the purpose of integrating 4DN imaging and omics experiments2. Thus, the Micro-Meta App was embedded into the 4DN-Data-Portal (Extended Data Fig. 10)59,60,62 and the content of the Microscope .JSON file was integrated directly into the portal’s database. This allows microscopy metadata associated with individual experiments to be used for searching, filtering and visualization purposes.
Case studies: teaching with Micro-Meta App
Micro-Meta App provides a digital representation of freely configurable microscopes, ideal for microscopy custodians to provide users with a detailed inventory of all available microscopes and for teaching purposes (Supplementary Video 1). Micro-Meta App was used by graduate students at UMass Medical School84 for working on (1) specific problem sets and (2) self-driven exploration of microscope components, functions and imaging modalities. The success of these pilots indicates that Micro-Meta App could be used in online teaching-modules (for example, GlobalBioImaging (GBI) Training Resources)85 for familiarizing users with the intricacies of specific instrument hardware configurations and for the interactive application of microscopy concepts.
Future directions
Micro-Meta App has been developed and will continue to evolve in close collaboration with communities that include 4DN2,3, BINA5, GBI86 and QUAREP-LiMi6,7,8,87. Ongoing efforts include:
-
1.
Outreach and education: to increase awareness and promote adoption of microscopy documentation and QC, and disseminate the use of Micro-Meta App, we have initiated an extensive outreach effort directed towards microscope users, custodians and manufacturers, which includes university classes (Case Studies), online training and workshops88,89,90. This will be augmented with specialized inperson courses as circumstances allow and in close collaboration with our community partners91,92.
-
2.
Creation of Instrument and Hardware components databases: while engaging with microscopy manufacturers to ensure the full automation of light microscopy data provenance and QC reporting, it will be necessary to engage the community to reduce the burden imposed on individual microscope custodians and users that need to document similar imaging experiments, therefore maximizing their adoption of community standards. For this purpose, and echoing 4DN59,60,62, we are developing exchange-sites for microscopy metadata JSON files, similar to ImageJ/Fiji plugin repositories. Furthermore, integration with the Research Resource ID (RRID) effort93 could promote the recognition of microscope configurations as a quantifiable scientific output, providing credit to the work of imaging scientists.
-
3.
Further integration with MethodsJ2: Micro-Meta App will be extended to automatically generate text for scientific publications and MethodsJ2 (refs. 14,15) will be adapted to use Micro-Meta App Settings.JSON files as sources of image acquisition settings and QC metadata.
-
4.
Further OMERO and OMERO.mde integration: a pilot Micro-Meta App OMERO plugin is available94. Future development will include extracting experimental metadata developed using OMERO.mde16,17 and saving 4DN-BINA-OME metadata11,12,13 as collections of key-value pairs associated with individual OMERO image-datasets.
-
5.
Implementation of additional microscopy modalities and QC: currently, the App implements the Core OME data model and the 4DN-BINA-OME Basic extension11,12,13. Efforts to implement the Confocal and Advanced as well as the Calibration and Performance 4DN-BINA-OME extensions are underway. As a proof-of-concept, we are collaborating with QUAREP-LiMi95 to automatically annotate imaging datasets with calibration metrics calculated using the open-hardware Meta-Max96 calibration tool.
Conclusions
Easily accessible and facile tools such as Micro-Meta App, MethodsJ2 and OMERO.mde are essential for microscope custodians and users to see image data documentation and QC as routine tasks in their imaging workflow, therefore promoting better quality, reproducibility and value for imaging data. In addition, reaching this goal will entail partnering with manufacturers to promote the automated interpretation of metadata stored in image file headers, the development of community-wide repositories for microscopy hardware metadata specifications and the automated annotation of datasets to be uploaded in imaging data repositories30. Thus, key support from funding agencies and institutions will ultimately lead to automating all aspects of the process used by members of the community to annotate and upload metadata-rich imaging datasets to both local and public repositories38,40,51. As an added advantage, full documentation of the provenance and QC of imaging experiments will be key for the development of pipelines to integrate images and their metadata with -omics data from the same experiment, such as is underway as part of 4DN.
Methods
Software implementation
Micro-Meta App is available in two JavaScript (JS) implementations. The first was designed to facilitate integration of the software into third-party web portals, such as the 4DN-Data Portal)2,59,60,62,97 and OMERO94, and was developed using the JS React library, which is used widely to build web-based user interfaces. Starting from this version, a stand-alone version of the App was developed by wrapping the React implementation using the JS Electron library, with the specific purpose of lowering the barrier of adoption of the tool by laboratories that do not have access to, or prefer not to use, imaging databases.
Dependencies
For the Micro-Meta App to work, the following elements are generated in advance as described in the following sections and made available via GitHub:
-
1.
JSON schema: a JSON file or a series of files that define the underlying schema, which are used to construct the graphical user interface (GUI) of the application on the basis of the 4DN-BINA-OME Microscopy Metadata specifications11,12,13.
-
2.
Dimensions and coordinates: a JSON file that codifies the dimensions of the canvases used by the Manage Instrument GUI of the Micro-Meta App as well as the position on the canvas occupied by icons representing each microscope hardware component.
-
3.
Icons: a series of SVG files, each containing an icon representing the individual hardware components.
In addition, the stand-alone version of Micro-Meta App depends on the 4DN Microscopy Metadata Reader98, which implements the BioFormats library52 to allow the user to import known OME metadata directly from the file header of an image data file of interest. To maximize flexibility, these elements can be customized to meet the needs of individual users.
XSD to JSON schema converter
The main function of this Java-encoded component99 is to transform the XML schema definition (XSD) implementation of the 4DN-BINA-OME data model11,12,13,100 into a JSON-based schema, which is subsequently ingested by Micro-Meta App to automatically generate the software GUI and the associated data insertion forms. The XSD to JSON schema converter middleware uses the Xerces2 Java XML Parser101 and W3C Java XML bindings libraries102 to navigate the XSD schema, and produces two kinds of version-aware JSON files:
-
1.
A comprehensive JSON file containing an array of schemas for all necessary individual components that constitute the 4DN-BINA-OME data model (for example, Objective, Filter or Detector). This comprehensive JSON file is made available on GitHub and is designed specifically to facilitate the remote loading of the schema by web portal embedded React implementations of the Micro-Meta App. This schema is available as an individual file on GitHub (https://github.com/WU-BIMAC/4DNMetadataSchemaXSD2JSONConverter/blob/master/latest/fullSchema.json).
-
2.
A series of JSON files, each containing the schema of individual components, which were designed to be employed by the Electron implementation of the App. These individual schema files are available within a subdirectory of the main repository on GitHub (https://github.com/WU-BIMAC/4DNMetadataSchemaXSD2JSONConverter/tree/master/latest/schemas).
The middleware was designed specifically to maximize flexibility and extensibility. As such, the software allows the introduction of implementation-specific modifications of the resulting JSON schema so that it can be adapted for special purposes. For example, the introduction of a ‘Version’ field allows validation of whether the data being saved is compatible with the specific version of the schema being employed. As a further example, the introduction of the ‘Category’ field allows the organization of different components in specific submenus across the sidebar. To facilitate the evolution of the model while ensuring back-compatibility, the GitHub repository supports versioning by storing all revisions of the output JSON schema.
TXT to JSON dimensions converter
This Java-encoded component99 is used to process an input text file containing the dimensions of the Manage Instrument canvas of Micro-Meta App alongside the desired x,y positions where each icon has to be placed. As a result, the software produces a Dimensions and Coordinate JSON file that is made available for remote loading from GitHub (https://github.com/WU-BIMAC/4DNMetadataSchemaXSD2JSONConverter/tree/master/latest/dimensions)99 and is ready to be used to implement the ‘snap-in-place’ functionality of the software.
ICON
Scalable vector graphic (SVG) files containing icons representing the different microscope hardware components were generated specifically for this project and are made available in a version-aware manner for remote loading from GitHub (https://github.com/WU-BIMAC/4DNMetadataSchemaXSD2JSONConverter/tree/master/latest/images)99. Custom-made icons can be similarly generated by developer users and manufacturers for representation of their hardware components within the application.
Microscopy metadata reader
This software is written in JAVA to fully take advantage of the BioFormats library and the OME-XML metadata structure98. Using these two dependencies, this software accesses all the OME-compatible metadata present in user-selected images and maps it to the 4DN-BINA-OME microscopy metadata specifications11,12,13 that extend the OME Data Model50,52 to produce a temporary, Micro-Meta App-compatible JSON object that can be read by Micro-Meta App. The object is then passed on to the Micro-Meta App and read by the Manage Settings section of the App to prepopulate the corresponding metadata fields.
JS React implementation of Micro-Meta App
This is the core implementation of the Micro-Meta App, and it is the starting point for embedding it into a third-party web portal, and for wrapping it into Electron for local execution97. This component ingests JSON schema files, JSON Dimension and Coordinate files and Icon images produced as described above and uses a series of custom React classes to produce a set of individual windows composing the GUI. Specifically, these windows can be categorized into two main sections: the Manage Instrument and the Manage Settings (Figs. 1 and 2 and Supplementary Figs. 2 and 3). In the Manage Instrument section, the application employs a Canvas setup that provides the flexibility to incorporate as many icon elements as necessary to describe the hardware components of any given microscope. For this purpose, the toolbar is generated dynamically as dictated by the underlying JSON schema produced as described above and by the selected tier level. On this basis, elements present in each of the graphical menus present on the sidebar can be dragged to the canvas and dropped either to a custom position specified by the user, or they can be snapped-in-place as defined by the position and dimension file produced by the Dimension Converter component.
In the Manage Settings, the application builds a series of nested windows that are launched by individual buttons allowing the user to select individual hardware components and enter specific settings for each of them. Of particular interest is the Channel interface in which the user can define the LightPath configuration associated with each channel of a given image by following a predefined graphical flowchart (Supplementary Fig. 3d).
JS Electron implementation of Micro-Meta App
This implementation of the Micro-Meta App is encoded in JS103. It uses the Electron library to wrap the React implementation of Micro-Meta App with all necessary schemas, icon images and position/dimension to ensure its correct functionality. This discrete executable file can interact directly with the underlying operating system and launch the software from the local file system.
Beta testing
Micro-Meta App was developed in the context of community efforts organized around the 4DN Consortium need for imaging data dissemination and integration with omics datasets2,3 and the BINA5 effort to improve rigor, QC and reproducibility in light microscopy. As part of this effort, several core facilities were identified to serve as reference beta-testing sites for the Micro-Meta App (a subset of the facilities listed in Extended Data Fig. 6). To this aim, the stand-alone JS Electron implementation of Micro-Meta App was deployed locally and microscope custodians at individual beta-testing sites were trained both on the use of the App and on bug and feature request reporting. Such feedback was collected either directly or by taking advantage of the GitHub issue-reporting feature and incorporated into the main development branch in a close-iterative cycle ahead of the release of the initial production version of the software
Reporting Summary
Further information on research design is available in the Nature Research Reporting Summary linked to this article.
Data availability
Data associated with this manuscript is available as follows: (1) Example Microscopy Metadata JSON files and associated image data file related to the use case presented in Fig. 2 and Extended Data Fig. 9 are publicly available on Zenodo at: https://doi.org/10.5281/zenodo.4891883. These files were produced using Micro-Meta App at UMass Medical School to document the acquisition of the FSWT-6hVirus-10minFIX-stk_4-EPI.tif.ome.tif example image file using the TIRF Epifluorescence Structured Illumination Microscope (TESM)79 custom built by the Biomedical Imaging Group. These files demonstrate the usability of Micro-Meta App to document microscopy experiments. (2) Example datasets associated with Extended Data Figs. 7–8 and Supplementary Figs. 3–15 and used at 16 different imaging core facilities to evaluate the functionality and test the usability of Micro-Meta App, can be made available upon request from the corresponding author. These exemplar image data files were not produced to test hypotheses or reach conclusions that are part of this study. Rather, they were used successfully as case studies to test the feasibility of the Micro-Meta App approach. (3) Data associated with Extended Data Fig. 10 are available publicly on the 4DN-Data Portal as follows: panel 10ahttps://data.4dnucleome.org/files-microscopy/4DNFI7639BEB/; 10bhttps://omero.hms.harvard.edu/pathviewer/vanilla-viewer/975042/; 10chttps://data.4dnucleome.org/microscope-configurations/28f1c0f2-d903-4761-93c6-dd3994db3462/. (4) Supplementary Video 1 is also available publicly at: https://vimeo.com/manage/videos/604291798
Code availability
This manuscript describes the Micro-Meta App software tool whose function is to facilitate the collection of Microscopy Metadata that can be used to document the hardware specifications, image acquisition settings and QC metrics used to produce high-quality, reproducible and valuable light microscopy image data. Micro-Meta App is available in two JS implementations that are described in detail above. To promote the adoption and reuse of Micro-Meta App, the executables and source code for both JS-React and -Electron implementations of Micro-Meta App are available on GitHub97,103. In addition, a website describing Micro-Meta App104 was developed alongside complete documentation and tutorials105. More specifically, as listed in the Reporting Summary document associated with this publication, and on the README file on GitHub (https://github.com/WU-BIMAC/MicroMetaApp-Electron), the software is available as follows: (1) Project name: Micro-Meta App. (2) Project home page: https://github.com/WU-BIMAC/MicroMetaApp.github.io. (3) Documentation (including video tutorials): https://micrometaapp-docs.readthedocs.io/en/latest/index.html. Note: if you intend to use the Micro-Meta App on MacOS you might encounter difficulties unzipping and launching the MacOS Zip. To address these issues please follow the special instructions specified in this VIDEO: https://vimeo.com/529609242. (4) Executable: https://github.com/WU-BIMAC/MicroMetaApp-Electron/releases/latest (https://doi.org/10.5281/zenodo.4750765). (5) Source code: (i) https://github.com/WU-BIMAC/MicroMetaApp-Electron (https://doi.org/10.5281/zenodo.4750765); (ii) https://github.com/WU-BIMAC/MicroMetaApp-React (https://doi.org/10.5281/zenodo.4889259). (6) Operating system(s): (i) Windows ×32; (ii) Windows ×64 (tested on Win 7 Pro v.6.1.760; Win 8.1 v.6.3.9600; Win 10 Home v.10.0.19040–10.0.19041–10.0.19042; Win 10 Pro v.10.0.19041–10.0.19042; Win 10 Enterprise v.10.0.18362, 10.0.19041 and 10.0.19042); (iii) MacOS (tested on High Sierra v.10.13.6; Mojave v.10.14.6; Catalina v.10.15.7; Big Sur v.11.0–11.1–11.2–11.3–11.3.1–11.4–11.5 Beta). (7) Programming language: JS and Java. (8) Other requirements: Java v.1.8.0. In addition, see dependencies listed in Methods and the Supplementary Information. (9) License: GNU GPL v.3 (https://www.gnu.org/licenses/gpl-3.0.html).
Change history
24 December 2021
A Correction to this paper has been published: https://doi.org/10.1038/s41592-021-01388-w
References
Wilkinson, M. D. et al. The FAIR guiding principles for scientific data management and stewardship. Sci. Data 3, 160018 (2016).
Dekker, J. et al. The 4D nucleome project. Nature 549, 219–226 (2017).
4D Nucleome Consortium. The 4D Nucleome Web Portal https://www.4dnucleome.org/ (2017).
BioImaging North America. https://www.bioimagingna.org (2018).
Strambio-De-Castillia, C. et al. Quality control and data management working group (BINA). Bioimaging North America https://www.bioimagingna.org/qc-dm-wg (2019).
Nelson, G. et al. QUAREP-LiMi: a community-driven initiative to establish guidelines for quality assessment and reproducibility for instruments and images in light microscopy. Preprint at http://arxiv.org/abs/2101.09153 (2021).
Boehm, U. et al. QUAREP-LiMi: a community endeavor to advance quality assessment and reproducibility in light microscopy. Nat. Methods https://doi.org/10.1038/s41592-021-01162-y (2021).
Nelson, G. et al. QUAREP-LiMi: a community-driven initiative to establish guidelines for quality assessment and reproducibility for instruments and images in light microscopy. J. Microsc. 284, 56–73 (2021).
Huisman, M. et al. Minimum information guidelines for fluorescence microscopy: increasing the value, quality, and fidelity of image data. Preprint at https://arxiv.org/abs/1910.11370v3 (2019).
Huisman, M. et al. A perspective on Microscopy Metadata: data provenance and quality control. Preprint at https://arxiv.org/abs/1910.11370 (2021).
Hammer, M. et al. Towards community-driven metadata standards for light microscopy: tiered specifications extending the OME model. Preprint at BioRxiv https://doi.org/10.1101/2021.04.25.441198 (2021).
Rigano, A. et al. 4DN-BINA-OME (NBO) Tiered Microscopy Metadata Specifications—v.2.01 https://github.com/WU-BIMAC/NBOMicroscopyMetadataSpecs; https://doi.org/10.5281/zenodo.4710731 (2021).
Hammer, M. et al. Towards community-driven metadata standards for light microscopy: tiered specifications extending the OME model. Nat. Methods https://doi.org/10.1038/s41592-021-01327-9 (2021).
Ryan, J. et al. MethodsJ2: a software tool to capture and generate comprehensive microscopy methods text and improve reproducibility. Nat. Methods https://doi.org/10.1038/s41592-021-01290-5 (2021).
Ryan, J. et al. MethodsJ2: a software tool to improve microscopy methods reporting. Preprint at BioRxiv https://doi.org/10.1101/2021.06.23.449674 (2021).
Kunis, S. et al. MDEmic: a metadata annotation tool to facilitate FAIR image data management in the bioimaging community. Nat. Methods https://doi.org/10.1038/s41592-021-01288-z (2021).
Kunis, S. et al. MDEmic in a use case for microscopy metadata harmonization: facilitating FAIR principles in practical application with metadata annotation tools. Preprint at http://arxiv.org/abs/2103.02942 (2021).
Ram, S. & Liu, J. A. Semiotics framework for analyzing data provenance research. J. Comput. Sci. Eng. 2, 221–248 (2008).
Ram, S. & Liu, J. A. Semantic foundation for provenance management. J. Data Semant. 1, 11–17 (2012).
Nature Editorial Staff. Better research through metrology. Nat. Methods 15, 395 (2018).
Pines, J. Image integrity and standards. Open Biol. 10, 200165 (2020).
Swedlow, J. R. et al. A global view of standards for open image data formats and repositories. Nat. Methods https://doi.org/10.1038/s41592-021-01113-7 (2021).
Sheen, M. R. Replication study: biomechanical remodeling of the microenvironment by stromal caveolin-1 favors tumor invasion and metastasis. eLife 8, e45120 (2019).
Viana, M. P. et al. Robust integrated intracellular organization of the human iPS cell: where, how much, and how variable. Preprint at BioRxiv https://doi.org/10.1101/2020.12.08.415562 (2021).
Botvinik-Nezer, R. et al. Variability in the analysis of a single neuroimaging dataset by many teams. Nature 582, 84–88 (2020).
Marqués, G., Pengo, T. & Sanders, M. A. Imaging methods are vastly underreported in biomedical research. eLife 9, e55133 (2020).
Heddleston, J. M., Aaron, J. S., Khuon, S. & Chew, T.-L. A guide to accurate reporting in digital image processing: can anyone reproduce your quantitative analysis? J. Cell Sci. 134, jcs254151 (2021).
Aaron, J. S. & Chew, T.-L. A guide to accurate reporting in digital image acquisition: can anyone replicate your microscopy data? J. Cell Sci. 134, jcs254144 (2021).
Montero Llopis, P. et al. Best practices and tools for reporting reproducible fluorescence microscopy methods. Nat. Methods https://doi.org/10.1038/s41592-021-01156-w (2021).
Sarkans, U. et al. REMBI: recommended metadata for biological images—realizing the full potential of the bioimaging revolution by enabling data reuse. Nat. Methods https://doi.org/10.1038/s41592-021-01166-8 (2021).
Orloff, D. N., Iwasa, J. H., Martone, M. E., Ellisman, M. H. & Kane, C. M. The cell: an image library-CCDB: a curated repository of microscopy data. Nucleic Acids Res. 41, D1241–D1250 (2013).
Movincell Consortium. Multi-dimensional marine organism dataview. Movincell http://movincell.org/ (2015).
Tohsato, Y., Ho, K. H. L., Kyoda, K. & Onami, S. SSBD: a database of quantitative data of spatiotemporal dynamics of biological phenomena. Bioinformatics 32, 3471–3479 (2016).
Iudin, A., Korir, P. K., Salavert-Torres, J., Kleywegt, G. J. & Patwardhan, A. EMPIAR: a public archive for raw electron microscopy image data. Nat. Methods 13, 387–388 (2016).
HuBMAP Consortium. The Human BioMolecular Atlas Program—HuBMAP https://hubmapconsortium.org/ (2017).
Rozenblatt-Rosen, O., Stubbington, M. J. T., Regev, A. & Teichmann, S. A. The Human Cell Atlas: from vision to reality. Nature 550, 451–453 (2017).
Allen Institute for Cell Science. Allen Cell Explorer https://www.allencell.org/ (2017).
Williams, E. et al. The Image Data Resource: a bioimage data integration and publication platform. Nat. Methods 14, 775–781 (2017).
Ellisman, M. et al. Cell Image Library http://www.cellimagelibrary.org/home (2019).
Ellenberg, J. et al. A call for public archives for biological image data. Nat. Methods 15, 849–854 (2018).
DORY Working Group. Defining our Research Methodology https://doryworkspace.org/ (2019).
Rozenblatt-Rosen, O. et al. Building a high-quality Human Cell Atlas. Nat. Biotechnol. 39, 149–153 (2021).
Lindeboom, R. G. H., Regev, A. & Teichmann, S. A. Towards a Human Cell Atlas: taking notes from the past. Trends Genet. 37, 625–630 (2021).
Rung, J. & Brazma, A. Reuse of public genome-wide gene expression data. Nat. Rev. Genet. 14, 89–99 (2013).
Brazma, A. et al. Minimum information about a microarray experiment (MIAME)—toward standards for microarray data. Nat. Genet. 29, 365–371 (2001).
Ioannidis, J. P. A. et al. Repeatability of published microarray gene expression analyses. Nat. Genet. 41, 149–155 (2009).
Brazma, A. Minimum Information About a Microarray Experiment (MIAME)—successes, failures, challenges. ScientificWorldJournal 9, 420–423 (2009).
Sansone, S.-A. et al. The First RSBI (ISA-TAB) Workshop: ‘can a simple format work for complex studies?’. OMICS 12, 143–149 (2008).
Swedlow, J. R., Goldberg, I. G., Brauner, E. & Sorger, P. K. Informatics and quantitative analysis in biological imaging. Science 300, 100–102 (2003).
Goldberg, I. G. et al. The open microscopy environment (OME) data model and XML file: open tools for informatics and quantitative analysis in biological imaging. Genome Biol 6, R47 (2005).
Allan, C. et al. OMERO: flexible, model-driven data management for experimental biology. Nat. Methods 9, 245–253 (2012).
Linkert, M. et al. Metadata matters: access to image data in the real world. J. Cell Biol. 189, 777–782 (2010).
Hammer, M. et al. 4DN-BINA-OME (NBO)—Microscopy Metadata Specifications—Tiers System_v.2.01 https://doi.org/10.5281/zenodo.4710731 (2021).
Moore, J. et al. OME-NGFF: a next-generation file format for expanding bioimaging data access strategies. Preprint at BioRxiv https://doi.org/10.1101/2021.03.31.437929 (2021).
Moore, J. et al. OME-NGFF: a next-generation file format for expanding bioimaging data access strategies. Nat. Methods https://doi.org/10.1038/s41592-021-01326-w (2022).
Hay, J. et al. PyOmeroUpload: a Python toolkit for uploading images and metadata to OMERO. Wellcome Open Res 5, 96 (2020).
Russell, D. P. W. & Sorger, P. K. Maintaining the provenance of microscopy metadata using OMERO.forms software. Preprint at BioRxiv https://doi.org/10.1101/109199 (2017).
Moore, J. et al. On bringing bioimaging data into the open (world). In Proc. 12th SWAT4(HC)LS (Semantic Web Applications and Tools for Healthcare and Life Sciences) Conference (eds Cornet, R. & Waagmeester, A.) 44–53 (CEUR-WS.org, 2019).
Reiff, S. B. et al. The 4D Nucleome Data Portal: a resource for searching and visualizing curated nucleomics data. Preprint at BioRxiv https://doi.org/10.1101/2021.10.14.464435 (2021).
Rigano, A. et al. Micro-Meta App—4DN Data Portal (https://data.4dnucleome.org/tools/micro-meta-app) https://doi.org/10.5281/zenodo.5140157 (2021).
Bellve, K., Rigano, A., Fogarty, K. & Strambio-De-Castillia, C. Example microscopy metadata JSON files produced using Micro-Meta App to document the acquisition of example images using the custom-built TIRF epifluorescence structured illumination microscope. Zenodo https://doi.org/10.5281/zenodo.4891883 (2021).
Alver, B., 4DN-DCIC & Park, P. 4DN Data Portal https://data.4dnucleome.org/ (2018).
Rigano, A. et al. Micro-Meta App: an interactive software tool to facilitate the collection of microscopy metadata based on community-driven specifications. Preprint at BioRxiv https://doi.org/10.1101/2021.05.31.446382 (2021).
Abdelfattah, A. S. et al. Bright and photostable chemigenetic indicators for extended in vivo voltage imaging. Science 365, 699–704 (2019).
Qian, Y. et al. A genetically encoded near-infrared fluorescent calcium ion indicator. Nat. Methods 16, 171–174 (2019).
Grimm, J. B. et al. A general method to optimize and functionalize red-shifted rhodamine dyes. Nat. Methods 17, 815–821 (2020).
Kiepas, A., Voorand, E., Mubaid, F., Siegel, P. M. & Brown, C. M. Optimizing live-cell fluorescence imaging conditions to minimize phototoxicity. J. Cell Sci. 133, jcs242834 (2020).
Fernandez, A. et al. Programmable emulsions via nucleophile-induced covalent surfactant modifications. Chem. Mater. 32, 4663–4671 (2020).
Drosopoulos, W. C., Vierra, D. A., Kenworthy, C. A., Coleman, R. A. & Schildkraut, C. L. Dynamic assembly and disassembly of the human DNA polymerase δ holoenzyme on the genome in vivo. Cell Rep 30, 1329–1341.e5 (2020).
Ayala-Nunez, N. V. et al. Zika virus enhances monocyte adhesion and transmigration favoring viral dissemination to neural cells. Nat. Commun. 10, 4430 (2019).
Aghajanian, A. et al. Decreased inspired oxygen stimulates de novo formation of coronary collaterals in adult heart. J. Mol. Cell. Cardiol. 150, 1–11 (2021).
Watson, N. A. et al. Kinase inhibition profiles as a tool to identify kinases for specific phosphorylation sites. Nat. Commun. 11, 1684 (2020).
Upton, R. L., Davies-Manifold, Z., Marcello, M., Arnold, K. & Crick, C. R. A general formulation approach for the fabrication of water repellent materials: how composition can impact resilience and functionality. Mol. Syst. Des. Eng. 5, 477–483 (2020).
Lim, H. C. & Bernhardt, T. G. A PopZ-linked apical recruitment assay for studying protein–protein interactions in the bacterial cell envelope. Mol. Microbiol. 112, 1757–1768 (2019).
Lim, H. C. et al. Identification of new components of the RipC-FtsEX cell separation pathway of Corynebacterineae. PLoS Genet. 15, e1008284 (2019).
da Silva, P. F. L. et al. The bystander effect contributes to the accumulation of senescent cells in vivo. Aging Cell 18, e12848 (2019).
Dalle Pezze, P. et al. Dynamic modelling of pathways to cellular senescence reveals strategies for targeted interventions. PLoS Comput. Biol. 10, e1003728 (2014).
Proksch, S. et al. hMSC-Derived VEGF release triggers the chemoattraction of alveolar osteoblasts. Stem Cells 33, 3114–3124 (2015).
Navaroli, D. M. et al. Rabenosyn-5 defines the fate of the transferrin receptor following clathrin-mediated endocytosis. Proc. Natl Acad. Sci. USA 109, E471–E480 (2012).
Hannibal, L. et al. Metabolic profiling in human fibroblasts enables subtype clustering in glycogen storage disease. Front. Endocrinol. 11, 579981 (2020).
Pimentel, J. A., Carneiro, J., Darszon, A. & Corkidi, G. A segmentation algorithm for automated tracking of fast swimming unlabelled cells in three dimensions. J. Microsc. 245, 72–81 (2012).
Silva-Villalobos, F., Pimentel, J. A., Darszon, A. & Corkidi, G. Imaging of the 3D dynamics of flagellar beating in human sperm. Conf. Proc. IEEE Eng. Med. Biol. Soc 2014, 190–193 (2014).
Jubrail, J. et al. Arpin is critical for phagocytosis in macrophages and is targeted by human rhinovirus. EMBO Rep 21, e47963 (2020).
Hammer, M. & Grunwald, D. Foundations in Biomedical Science (BBS 614) graduate course. Courses of the Graduate School of Biomedical Sciences https://www.umassmed.edu/gsbs/academics/courses/ (2020).
Grebnev, G. & BioImaging, G. Global BioImaging Training Resource https://globalbioimaging.org/international-training-courses/repository (2021).
GlobalBioimaging. Global Bioimaging Website https://globalbioimaging.org/ (2018).
Strambio-De-Castillia, C., Kunis, S., Fallisch, A. & Nitschke, R. QUAREP-LiMi: Work Group (WG) 7—Metadata https://quarep.org/working-groups/wg-7-metadata/ (2020).
Rigano, A., Nitschke, R. & Strambio-De-Castillia, C. 2021 ELMI Workshops: QUAREP-LiMi Workshop—Micro-Meta App https://www.elmi2021.org/sponsors/workshop-schedule.html (2021).
Rigano, A. & Strambio-De-Castillia, C. 2021 OME Community Meeting—Live Demos: Micro-Meta App https://www.openmicroscopy.org/events/ome-community-meeting-2021/day1/ (2021).
Strambio-De-Castillia, C. 2021 OME Community Flash Talk: Micro-Meta App https://www.youtube.com/watch?v=LO2-5U_9s6w&list=PL-oOCWFUMH51ACy8QhTYc4ppaoICJQDU_&index=2 (2021).
Waters, J., Jug, F., Elliott, H. & Lambert, T. Cold Spring Harbor Laboratory Courses. Quantitative Imaging: From Acquisition to Analysis https://meetings.cshl.edu/courses.aspx?course=C-QICM&year=21 (2021).
North, A. & Bewersdorf, J. Marine Biology Laboratory Courses. Optical Microscopy and Imaging in the Biomedical Sciences (OMIBS) https://www.mbl.edu/education/courses/optical-microscopy-imaging/ (2021).
RRID Initiative. Research Resource Identifier https://www.rrids.org/https://www.rrids.org/ (2015).
Rigano, A., Moore, W., Ehmsen, S., Alver, B. & Strambio-De-Castillia, C. Micro-Meta App—OMERO plug-in. Github https://github.com/WU-BIMAC; https://doi.org/10.5281/zenodo.4750762 (2021).
Schroth-Diez, B., Bakker, G.-J., Fallisch, A. & Nitschke, R. QUAREP-LiMi: Work Group (WG) 2—Detection system performance https://quarep.org/working-groups/wg-2-detection-system-performance/ (2020).
Huisman, M. Vision Beyond Optics: Standardization, Evaluation and Innovation for Fluorescence Microscopy in Life Sciences. Doctoral dissertation, University of Massachusetts Medical School https://doi.org/10.13028/zq9e-9v53 (2019).
Rigano, A. et al. Micro-Meta App - React. Github https://github.com/WU-BIMAC; https://doi.org/10.5281/zenodo.4751438 (2021).
Rigano, A. & Strambio-De-Castillia, C. 4DN Microscopy Metadata Reader. Github https://github.com/WU-BIMAC; https://doi.org/10.5281/zenodo.4827439 (2021).
Rigano, A. & Strambio-De-Castillia, C. 4DN Metadata Schema XSD to JSON Converter. Github https://github.com/WU-BIMAC; https://doi.org/10.5281/zenodo.4827269 (2021).
Rigano, A. & Strambio-De-Castillia, C. 4DN-BINA-OME (NBO) Tiered Microscopy Metadata Specifications - v2.01 - XSD Schema https://github.com/WU-BIMAC/NBOMicroscopyMetadataSpecs (2021).
Xerces2 Java XML Parser 2.12.1 Release. The Apache Software Foundation https://xerces.apache.org/xerces2-j/ (2018).
W3C. W3C Java XML Bindings Libraries https://www.w3.org/TR/2003/WD-DOM-Level-3-Core-20030609/java-binding.html (2003).
Rigano, A. et al. Micro-Meta App-Electron. Github https://github.com/WU-BIMAC; https://doi.org/10.5281/zenodo.4750765 (2021).
Strambio-De-Castillia, C. & Rigano, A. Micro-Meta App: Microscopy Metadata for the Real World! https://wu-bimac.github.io/MicroMetaApp.github.io/ (2020).
Strambio-De-Castillia, C. Micro-Meta App Read The Docs Documentation https://micrometaapp-docs.readthedocs.io/en/latest/index.html (2020).
Allen, L., O’Connell, A. & Kiermer, V. How can we ensure visibility and diversity in research contributions? How the Contributor Role Taxonomy (CRediT) is helping the shift from authorship to contributorship. Learn. Publ. 32, 71–74 (2019).
Acknowledgements
We would like to thank L. Lifshitz at the Biomedical Imaging Group of the Program in Molecular Medicine at the University of Massachusetts Medical School for invaluable intellectual input and countless fruitful discussions and for his friendship, advice and steadfast support throughout the development of this project. We acknowledge M. Luban for critically reading and editing the manuscript. This project could never have been carried out without the leadership, insightful discussions, support and friendship of all OME consortium members, with particular reference to J. Swedlow, J. Moore, C. Allan, J.M. Burel and W. Moore. We are massively indebted to the RIKEN community for their fantastic work to bring open science into biology. We would like to particularly acknowledge N. Kobayashi and S. Onami for their friendship and support. We thank all members of Bioimaging North America, German Bioimaging, Euro-Bioimaging (in particular A. Keppler and F. Paina) and QUAREP-LiMi (in particular all members of the Working Group 7—Metadata; https://quarep.org/working-groups/wg-7-metadata/) for invaluable intellectual input, fruitful discussions and advice. We are also indebted to the following individuals for their continued and steadfast support: J. Luban, R. Davis and T. Pederson at the University of Massachusetts Medical School; J. Ritland, R. Singer and W. Zipfel of the 4D Nucleome Consortium; I. Fingerman, J. Satterlee, J. Mietz, R. Conroy and O. Blondel at the NIH. This work was supported by grant 2019-198155 (5022) awarded to C.S.-D.-C. by the Chan Zuckerberg Initiative DAF, an advised fund of Silicon Valley Community Foundation, as part of their Imaging Scientist Program. Major funding also came from: (1) NIH grant U01CA200059 to P.J.P., C.S.-D.-C and D.G.; (2) NIH grants 1U01EB021238 and 8U01DA047733-05, and NSF grant 1917206 to D.G. C.M.B. was funded in part by grant 2020-225398 from the Chan Zuckerberg Initiative DAF, an advised fund of Silicon Valley Community Foundation. R.A.C. was funded by NIH grant 5R01GM126045-04. T.G. and O.F. are members of the RTmfm network, and the MRI and IMAG’IC core facilities are supported by the National Infrastructure France BioImaging (grant ANR-10-INBS-04) and IBISA consortium. M.S.I. was supported by grant number 2019-198107, from the Chan Zuckerberg Initiative DAF, an advised fund of Silicon Valley Community Foundation. The UNC Neuroscience Microscopy Core (RRID:SCR_019060) is supported, in part, by funding from the NIH-NINDS Neuroscience Center Support Grant P30 NS045892 and the NIH-NICHD Intellectual and Developmental Disabilities Research Center Support Grant P50 HD103573. SK was funded by the Deutsche Forschungsgemeinschaft: SFB 944 (Reference 180879236 INF). R.N. was funded by the Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) grant Ni 451/9-1 MIAP-Freiburg. S.W.-P. was funded by the Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) project-ID 267205415—SFB 1208, project INF.
Author information
Authors and Affiliations
Contributions
Author contribution categories used here were devised by the CRediT initiative106. A.R. was the principal software developer for this project. In addition, he was involved in conceptualization, methodology, validation, investigation, resources and data curation. S.E. was involved in validation, resources and visualization. S.U.O. contributed to software development. J.R. was involved with software development, validation, resources and data curation. A.B. was involved with conceptualization, methodology and software development. M.H. was involved with conceptualization, methodology, validation, data curation, and writing (review and editing). K.K. performed validation. U.B., C.M.B, J.J.C., R.A.C., O.F., T.G., M.S.I., J.L., A.L., M.M., P.M.-L., G.N., R.N. and J.A.P. were involved with validation, resources, data curation and writing (review and editing). K.B. was involved with software and resources. A.C. was involved with validation, data curation and writing (review and editing). K.E.F. and A.B.H. and S.K. provided resources. D.P.K. and W.Y.M. performed validation and data curation. S.W.-P. was involved with validation, resources and data curation; P.J.P. was involved in project supervision and administration; B.H.A. was involved in conceptualization, methodology, validation, resources, writing (review and editing), supervision, project administration and funding acquisition. D.G. was involved with conceptualization, methodology, investigation, resources, writing (review and editing), supervision, project administration and funding acquisition; C.S.-D.-C. was involved with conceptualization, methodology, software development, validation, investigation, resources, data curation, writing (original draft), writing (review and editing), visualization, supervision, project administration and funding acquisition.
Corresponding author
Ethics declarations
Competing interests
The authors declare no competing interests.
Additional information
Peer review information Nature Methods thanks Jon Mulholland, Brian Slaughter and the other, anonymous, reviewer(s) for their contribution to the peer review of this work. Rita Strack was the primary editor on this article and managed its editorial process and peer review in collaboration with the rest of the editorial team.
Publisher’s note Springer Nature remains neutral with regard to jurisdictional claims in published maps and institutional affiliations.
Extended data
Extended Data Fig. 1 Quality, rigor, reproducibility and sharing value for imaging experiments require the definition of community-driven Microscopy Metadata specifications and the adoption of easy-to-use metadata collection tools to facilitate the documentation and quality control tasks for experimental scientists.
The establishment of FAIR1, community-driven Microscopy image data Standards implies parallel development on three interrelated fronts: 1) WHERE: Next-Generation File Formats (NGFF) where the ever-increasing scale and complexity of image data and metadata would be contained for exchange55 (blue bubble). 2) WHAT: Community-driven specifications for what ‘data provenance’ information (microscope hardware specifications, image acquisition settings and image structure metadata) and quality control metrics are essential for rigor, reproducibility, and reuse and should therefore be captured in Microscopy Metadata (magenta bubble). 3) HOW: Shared rules for how the (ideally) automated capture, representation and storage of Microscopy Metadata should be implemented in practice (yellow bubble). Micro-Meta App, MethodsJ2 and OMERO.mde14,15,16,17,63 are three highly interoperable tools and complementary that function to: 1) train users on the importance of documentation and quality control; 2) facilitate metadata extraction, collection, and storage; 3) automatically write Methods sections; and 4) facilitate the development of experimental metadata specifications in connection with local core facilities. The different tools leverage different use- styles and preferences and are based on different software platforms in order to appeal to the broadest community including microscope builders, imaging scientists working in core facilities and experimental scientists. Thus: Micro-Meta App is used as a stand- alone app and can be integrated in third-party data portals2,59,60,62. MethodsJ2 works as an ImageJ plugin. OMERO.mde works in the context of the OMERO image data repository. The concept is to bring the tools to software platforms people are already using and lower the bar to enable broad uptake.
Extended Data Fig. 2 Table I | Percentage of OME Data Model Core <Instrument> element attributes that can be retrieved from image file headers and interpreted by BioFormats.
The fraction of attributes associated with <Instrument> sub-elements (for example, <Microscope>, <Objective>, <Detector>, etc.,) of the core of the OME Data Model, whose values could be retrieved in the header of the raw image data files associated with the case studies presented in Fig. 2, Extended Data Figs. 6–9 and Supplementary Figs. 3–15, was determined and is reported above.
Extended Data Fig. 3 Table II | Percentage of OME Data Model Core <Image> element attributes that can be retrieved from image file headers and interpreted by BioFormats.
The fraction of attributes associated with <Image> sub-elements (for example, <LightSourceSettings>, <Objective>, <Detector>, etc.,) of the core of the OME Data Model, whose values could be retrieved in the header of the raw image data files associated with the case studies presented in Fig. 2, Extended Data Figs. 6–9 and Supplementary Figs. 3–15, was determined and is reported above.
Extended Data Fig. 4 The Micro-Meta App is designed to aid in the collection of 4DN-BINA-OME sanctioned Microscope Hardware Specifications metadata.
Micro-Meta App can be used as a stand-alone desktop application. Alternatively, it can be launched from a third-party portal such as the 4DN-Data Portal (Extended Data Fig. 10), where Microscope files can be stored as image-dataset attachments. In either situation: Α) After selecting the desired location for saving Microscope.JSON files for later use (not shown), before creating a new microscope file it is first necessary to select the desired Tier for the experiment at hand. Β) The Manage Instrument workflow in Micro-Meta App. The App can be used to create a structured Microscope.JSON file containing a description of the hardware components of a given microscopy Instrument based on the 4DN-BINA-OME ontology <Instrument> class model. C) A new microscope can be created totally from scratch by selecting either an Inverted or an Upright Microscope Stand. D) Alternatively, a previously saved Microscope.JSON file can be selected among those saved on an available repository and opened for further editing, such as in the depicted example. E) In this example, the “Magnification” drop- down menu is opened [1] and an “Objective” is dragged and snapped-in-place in the designated position [2] on the workspace. F) In this example, an additional “Objective” [3] is dragged onto the workspace and relevant metadata fields are entered using the designated metadata entry form [4]. G) Once all changes are entered, the microscope file can be saved to file or to the desired repository.
Extended Data Fig. 5 The Micro-Meta App utilizes the information contained in a previously generated Microscope metadata file and interactively aids in the collection of 4DN- BINA-OME sanctioned Image Acquisition settings metadata.
Once a Microscope.JSON file is available (Figs. 1–2 and Extended Data Fig. 4), it is used as the basis for collecting the Image Acquisition Settings utilized for a specific microscopy experiment. After clicking on Manage Settings (A), the user first selects the Microscope metadata file describing the instrument used to acquire the image of interest (B), then the image file (C), and finally, if available, an existing Settings metadata file (D). From these files Micro-Meta App imports all relevant metadata for the user to inspect, edit and when missing enter from scratch. E) In the main window of Manage Settings the user accesses different sections of Settings metadata by launching the corresponding metadata collection windows. For example, the Edit image settings button [1.1] opens the metadata entry form [1.2] allowing to inspect and edit general Image metadata. In addition, the Edit Planes button [2.1] opens an interface where a given image Plane can be selected [2.2], and Plane metadata (for example, TimeStamp, ExposureTime) can be inspected and edited [2.3]. Finally, the Edit Objective Settings button [3.1] allows users to select the Objective that was used to acquire the image of interest, among those available in the Microscope file [3.2] and enter the relevant Objective Settings [3.3]. The same procedure is also used for the Imaging Environment, Microscope Table, Microscope Stand, and Sample Positioning Settings (not shown). F) After clicking the Edit Channels button in the main Manage Settings window (E), the list of Channels that were found in the image file header is displayed (top left) to be individually selected [4.1]. In the Channel interface [4.2] the Edit Channel Settings button [5.1] launches a general Channel metadata editing form [5.2], while an interactive GUI manages the different components of the channel’s Lightpath. In this example, the user clicks on LightSource [6.1] to select one of the available Light Sources present in the Microscope file, add it to the Lightpath and enter the associated settings that were applied during image acquisition [6.2]. G) Advanced features of the Lightpath are managed via one of the seven Add additional element(s) [7.1] buttons found at key locations along the lightpath. In the example, the Add [7.3] button is used to append an additional Shutter [7.4] after the existing Shutter, Mirror, Dichroic and BeamSplitter [7.2].
Extended Data Fig. 6 Table III | List of Microscopes documented using Micro-Meta App.
List of key information regarding the microscopes, experiment types and image data file formats that were utilized to assess the feasibility of the Micro- Meta App approach to document microscopy experiments.
Extended Data Fig. 7 Micro-Meta App was utilized at the Centre for Cell Imaging of the University of Liverpool to document a Zeiss Axio Observer Z1 inverted microscope equipped with a LSM 710 confocal scan head and the settings that were applied to the microscope to acquire specific example image-datasets.
Illustrated here is the use of Micro-Meta App for Tier 1 (Minimum Information/Materials & Methods), 4DN-BINA- OME-specified11,12,13 documentation of: (A-B) the Zeiss Axio Observer Z1 inverted microscope equipped with a LSM 710 confocal scan head, owned by the Centre for Cell Imaging (CCI) of the University of Liverpool (Extended Data Fig. 6-Table III); and (C-D) the settings that were applied to the microscope for the acquisition of example published image-datasets73. A) Picture of the indicated microscope. B) Micro-Meta App-generated schematic representation of the indicated microscope. C) Particles composed of superhydrophobic polymer–nanoparticle composite (SPNC) material were analyzed by confocal microscopy to shed light on the differences in composite architecture between different coating polymers. Preparations of SiO2-polydimethylsiloxane (PDMS) coated SPNC (40–75 μm) particles were labelled by staining PDMS with Nile Red. Confocal 3D Z-stacks were acquired using the microscope indicated in Panels A and B. Depicted here is a slice from the middle (24 μm) of a Z-stack depicting a representative particle73. D) Micro-Meta App-generated schematic representation of the lightpath associated with the 561 Channel utilized for the acquisition of the image in Panel C. To demonstrate the functionality and usability of the App and to assess the feasibility of the overall microscopy documentation approach, Micro-Meta App was tested independently at 16 sites (Extended Data Figs. 6–9 and Supplementary Figs. 3–15).
Extended Data Fig. 8 Micro-Meta App was utilized at the Montpellier Resources Imagerie of the University of Montpellier to document a Andor Dragonfly Spinning Disk confocal microscope system and the settings that were applied to the microscope to acquire specific example image-datasets.
Illustrated here is the use of Micro-Meta App for Tier 2 (Advanced Quantification and/or Live cell Imaging), 4DN-BINA-OME- specified11,12,13 documentation of: (A-B) the Andor Dragonfly Spinning Disk confocal microscope system (with Nikon Eclipse Ti inverted compound microscope stand) owned by the Montpellier Resources Imagerie at the Centre de Recherche de Biologie cellulaire de Montpellier (MRI-CRBM) of the University of Montpellier (Extended Data Fig. 6-Table III); and (C-D) the settings that were applied to the microscope for the acquisition of example published image-datasets70. A) Picture of the indicated microscope. B) Micro-Meta App-generated schematic representation of the indicated microscope. C) Cerebral organoids were cocultured with ZIKV-infected monocytes, fixed, permeabilized, stained with DAPI to detect all cellular nuclei (405 channel, visualized in blue) anti-CTIP2 (488 channel, visualized in green), anti-PAX6 (568 channel, visualized in magenta) and anti- ZIKV2-E (Flavivirus group antigen Antibody (D1-4G2-4-15 (4G2); 640 channel, visualized in yellow), and clarified. 3D Z- stacks of representative organoids were acquired using the indicated microscope (Panels A and B) equipped with a 20x, NA 0.8, air Nikon objective. The displayed image corresponds to a representative Z-plane70. D) Micro-Meta App-generated schematic representation of the lightpath associated with the 488 Channel utilized for the acquisition of the image in Panel C. To demonstrate the functionality and usability of the App and to assess the feasibility of the overall microscopy documentation approach, Micro-Meta App was tested independently at 16 sites (Extended Data Figs. 6–9 and Supplementary Figs. 3–15).
Extended Data Fig. 9 Micro-Meta App was utilized at UMass Medical School to document a custom built TIRF Epifluorescence Structured light Microscope and the settings that were applied to the microscope to acquire specific example image-datasets.
Illustrated here is the use of Micro-Meta App for Tier 3 (Manufacturing/Technical Development/Full Documentation), 4DN-BINA-OME-specified11,12,13 documentation of: (A-B) the custom build TIRF Epifluorescence Structured light Microscope (TESM; based on Olympus IX71) developed, built and owned by the Biomedical Imaging Group79 at the Program in Molecular Medicine of the UMass Medical School (Extended Data Fig. 6-Table III); and (C-D) the settings that were applied to the microscope for the acquisition of example images. A) Picture of the indicated microscope. B) Micro-Meta App- generated schematic representation of the indicated microscope. C) TZM-bl human cells were infected with HIV-1 retroviral vectors, fixed and permeabilized before staining with mouse-anti-p24 primary followed by DyLight488-anti-Mouse secondary antibodies, to detect HIV-1 viral Capsid. In addition, cells were counterstained using rabbit-anti-LaminB1 primary followed by DyLight649-anti-Rabbit secondary antibodies, to visualize the nuclear envelope and with DAPI to visualize the nuclear chromosomal DNA. Displayed is a representative image obtained using the indicated microscope (Panels A and B)79. D) Micro-Meta App-generated schematic representation of the lightpath associated with the DAPI channel utilized for the acquisition of the image in Panel C. E) The insert shows a detail of the optical path followed by the 405-laser beam, in which the TIRF lightpath was used for epifluorescence illumination by orienting the beam perpendicular to the specimen plane. Specifically, in this portion of the lightpath the 405-laser beam passes through an electronically controlled shutter (405 Shutter), a mirror (405 Mirror), a dichroic filter (Dichroic 1), a 50/50 beam splitter (50/50 Epi vs. TIRF BS) and finally a shutter to control the TIRF lightpath illumination (TIRF Shutter). Example Microscope.JSON, Settings.JSON and associated image data file for this use case are available at: https://doi.org/10.5281/zenodo.4891883. To demonstrate the functionality and usability of the App and to assess the feasibility of the overall microscopy documentation approach, Micro-Meta App was tested independently at 16 sites (Extended Data Figs. 6–9 and Supplementary Figs. 3–15).
Extended Data Fig. 10 Micro-Meta App is integrated in the 4DN-Data Portal for the documentation of imaging experiments.
In order to facilitate the full documentation of microscopy experiments (A), ensure the quality, reproducibility and value of image data (B), and facilitate their integration with genomic data, Micro-Meta App (C) was incorporated in the 4DN-Data Portal and made an integral part of the imaging experiment documentation and quality control workflow developed by the 4DN-Data Coordination and Integration Center (DCIC) of the NIH-funded 4DN Consortium2,59,60,62. For this use the App’s data flow was adapted to allow the direct ingestion of the content of the JSON Microscope- and Settings-files into the portal database, which allows individual fields to be utilized for filtering and searching purposes and to be visualized directly on the portal. Data for this figure is available publicly on the 4DN-Data Portal59,60 as follows: A) https://data.4dnucleome.org/files-microscopy/4DNFI7639BEB/; B) https://omero.hms.harvard.edu/pathviewer/vanilla-viewer/975042/; C) https://data.4dnucleome.org/microscope-configurations/28f1c0f2-d903-4761-93c6-dd3994db3462/.
Supplementary information
Supplementary Information
Supplementary 4DN-BINA-OME tier-system description, Micro-Meta App description (including detailed descriptions of the ‘Manage Instrument’, Image Acquisition ‘Manage Settings’ sections of the App), case studies (including detailed descriptions of the ‘use at core facilities’ and ‘teaching with Micro-Meta App’ case studies), video 1, Figs. 1–15 and references.
Supplementary Video
Video 1 was used as an introduction to Micro-Meta App for use by Graduate Students at the University of Massachusetts Medical School84 is also available at: https://vimeo.com/557097919. Images labeled with (*) and (**) at minutes 0:16–0:33 of Video 1 are used with permission from the author from Figs. 5 and 6 of Smith et al.100.
Rights and permissions
Open Access This article is licensed under a Creative Commons Attribution 4.0 International License, which permits use, sharing, adaptation, distribution and reproduction in any medium or format, as long as you give appropriate credit to the original author(s) and the source, provide a link to the Creative Commons license, and indicate if changes were made. The images or other third party material in this article are included in the article’s Creative Commons license, unless indicated otherwise in a credit line to the material. If material is not included in the article’s Creative Commons license and your intended use is not permitted by statutory regulation or exceeds the permitted use, you will need to obtain permission directly from the copyright holder. To view a copy of this license, visit http://creativecommons.org/licenses/by/4.0/.
About this article
Cite this article
Rigano, A., Ehmsen, S., Öztürk, S.U. et al. Micro-Meta App: an interactive tool for collecting microscopy metadata based on community specifications. Nat Methods 18, 1489–1495 (2021). https://doi.org/10.1038/s41592-021-01315-z
Received:
Accepted:
Published:
Issue Date:
DOI: https://doi.org/10.1038/s41592-021-01315-z
This article is cited by
-
Caterina Strambio-De-Castillia
Nature Methods (2021)
-
Towards community-driven metadata standards for light microscopy: tiered specifications extending the OME model
Nature Methods (2021)
