Subscribe to Journal
Get full journal access for 1 year
only $4.92 per issue
All prices are NET prices.
VAT will be added later in the checkout.
Tax calculation will be finalised during checkout.
Rent or Buy article
Get time limited or full article access on ReadCube.
All prices are NET prices.
The peer-reviewed version of the software is available as Supplementary Software. The source code is available at https://github.com/bene51/3Dscript, and binary releases for Windows, Linux and Mac OS X versions are available from our Fiji update site, https://romulus.oice.uni-erlangen.de/updatesite/. User documentation is available at https://bene51.github.io/3Dscript.
All raw data used to create the figures and videos in this paper are available from the corresponding author upon reasonable request.
Wan, Y., Otsuna, H., Chien, C.-B. & Hansen, C. IEEE Pac. Vis. Symp. 2012, 201–208 (2012).
Schindelin, J. et al. Nat. Methods 9, 676–682 (2012).
Rueden, C. T. et al. BMC Bioinformatics 18, 529 (2017).
Royer, L. A. et al. Nat. Methods 12, 480–481 (2015).
Schmid, B., Schindelin, J., Cardona, A., Longair, M. & Heisenberg, M. BMC Bioinformatics 11, 274 (2010).
Pietzsch, T., Saalfeld, S., Preibisch, S. & Tomancak, P. Nat. Methods 12, 481–483 (2015).
We thank J. He and E. Haynes for the time-lapse image data of the zebrafish nervous system; A. Wandersee for the image data of the mouse organoid; D. Thieme for the image data of the human cornea; and A. Schmied and K. Enderle for extensive testing and feedback. This work was supported by DFG-CRC1181 Z02 (T.F.); DFG-CRC1181 C02 and DFG-FOR2438 P9 (C.K., A. Schmied and K. Enderle; awarded to C. Neufert, Med1, UK Erlangen); DFG-CRC1181 C05 and DFG-CRC796 B9 (A. Wandersee and B.R.; awarded to C. Becker, Med1, UK Erlangen); DFG-CRC1181 A02 (A.G.); and ERC-2014-CoG 647885 (SmartMic; J.H.).
The authors declare no competing interests.
Integrated supplementary information
Top: The ImageJ main window. Left: The animation editor, which is based on the Fiji Script Editor. Middle: The 3D window with the rendering output. Right: The control window for adjusting all possible settings of the integrated 3D renderer.
Leaf of A. thaliana, acquired with a Zeiss LSM880 NLO 2-photon microscope. All nine panels are rendered with identical settings for intensity and opacity minimum and maximum. Gamma for intensity increases from top to bottom (0.5, 1, 2), gamma for opacity increases from left to write (0.5, 1, 3). Scale bar: 50 µm..
From left to right: Independent transparency, combined transparency and maximum intensity projection rendering of colon tumors in an inflammation-related mouse colon cancer model. Images were acquired on a light sheet microscope after blood vessel staining (CD31; red) and ECi-based tissue clearing1. Gray: autofluorescence, scale bar: 500 µm.
Left: No lighting. Middle: ko = 0.7, kd = 0.3, ks = 0.2, s = 20. Right: ko = 0.4, kd = 0.5, ks = 0.3, s = 20. ko, kd, ks and s are the parameters of the Blinn-Phong shading model for the contributions of object light, diffuse light, specular light and shininess, respectively. No surfaces (e.g. in form of triangle meshes) were calculated. Example MRI dataset bundled with ImageJ, scale bar 20 mm.
In general, any third-party rendering software can integrate our text-based animation framework by implementing a couple of interfaces defined by our module. We have implemented modules that use POV-Ray (shown here) and the ImageJ 3D Viewer for rendering.
Supplementary Figures 1–5 and Supplementary Notes 1–8
Simultaneous rotation around multiple axes. 3D animation of mouse colon tumors using blood vessel staining (CD31, red), ECi-based tissue clearing and a LaVision BioTec lightsheet UltraMicroscope II (see also Fig. 1). The image volume is rotated around its y-axis (with a higher speed) and around the x-axis of the view (with a lower speed). Only a couple of text lines (Supplementary Notes, https://bene51.github.io/3Dscript/gallery.html) are required to describe an animation, which is hard to achieve with key frame-based animation. Scale bar, 500 μm.
Animated transformation through time. Animation of a growing zebrafish nervous system, imaged on a custom-built light-sheet microscope. While the time-lapse progresses, the image volume is spatially transformed. The animation text is available in the Supplementary Notes and at https://bene51.github.io/3Dscript/gallery.html. Scale bar, 100 μm.
Simultaneous pivoting and channel switching. Animation of a mouse paw, imaged on a LaVision BioTec light-sheet UltraMicroscope II. Pivoting is implemented with a macro. The animation text is available in the Supplementary Notes and at https://bene51.github.io/3Dscript/gallery.html. Scale bar, 500 μm.
Consecutive zoom-in and scroll-through at different positions. Animation of a mouse paw, imaged on a LaVision BioTec light-sheet UltraMicroscope II. The animation text is available in the Supplementary Notes and at https://bene51.github.io/3Dscript/gallery.html. Scale bar, 500 μm.
Macro for parameterized zooming. Animation of a human cornea imaged on a Zeiss LSM880 NLO two-photon microscope. The dataset is elongated in one dimension. Instead of zooming out during the entire animation, the zoom is adjusted to the rotation to always fill the available video canvas optimally, using a macro. The animation text is available in the Supplementary Notes and at https://bene51.github.io/3Dscript/gallery.html. Supplementary Video 6 and the Supplementary Notes describe in detail how this animation was created. Scale bar, 50 μm.
Composing an animation. This screencast demonstrates how the animation of the human cornea (Supplementary Video 5) is built up, and highlights the auto-completion features of the Animation Editor. A detailed step-by-step description also can be found in the Supplementary Notes.
Auto-completion. A dedicated animation editor, based on Fiji’s script editor, facilitates the composition of the animation description with auto-completion and recording capabilities.
The dedicated animation editor can record different rendering states and automatically create the description text to transition between them.
Rendering of an MRI image volume of a human head using the BigDataViewer. To demonstrate the extendibility of our framework, we wrote an adaptor for Fiji’s BigDataViewer. The animation text is available in the Supplementary Notes and at https://bene51.github.io/3Dscript/gallery.html.
Photo-realistic rendering of an organoid from the mouse intestine in a laboratory environment using POV-Ray. To demonstrate the extendibility of our framework, we wrote an adaptor that uses POV-Ray, a software for photorealistic rendering, instead of the integrated 3D renderer. The animation text is available in the Supplementary Notes and at https://bene51.github.io/3Dscript/gallery.html.
About this article
Cite this article
Schmid, B., Tripal, P., Fraaß, T. et al. 3Dscript: animating 3D/4D microscopy data using a natural-language-based syntax. Nat Methods 16, 278–280 (2019). https://doi.org/10.1038/s41592-019-0359-1
Science Advances (2021)
Inducible mouse models of colon cancer for the analysis of sporadic and inflammation-driven tumor progression and lymph node metastasis
Nature Protocols (2021)
Treatment with Cyclic AMP Activators Reduces Glioblastoma Growth and Invasion as Assessed by Two-Photon Microscopy
Journal of Cell Biology (2021)
TFG is required for autophagy flux and to prevent endoplasmic reticulum stress in CH12 B lymphoma cells