Bio-Formats Documentation Release 4.4.9 The Open Microscopy Environment October 15, 2013 CONTENTS I About Bio-Formats 2 1 Why Java? 4 2 Bio-Formats metadata processing 5 3 Help 6 3.1 Reporting a bug ................................................... 6 3.2 Troubleshooting ................................................... 7 4 Bio-Formats versions 9 4.1 Version history .................................................... 9 II User Information 23 5 Using Bio-Formats with ImageJ and Fiji 24 5.1 ImageJ ........................................................ 24 5.2 Fiji .......................................................... 25 5.3 Bio-Formats features in ImageJ and Fiji ....................................... 26 5.4 Installing Bio-Formats in ImageJ .......................................... 26 5.5 Using Bio-Formats to load images into ImageJ ................................... 28 5.6 Managing memory in ImageJ/Fiji using Bio-Formats ................................ 32 5.7 Upgrading the Bio-Formats importer for ImageJ to the latest trunk build ...................... 34 6 OMERO 39 7 Image server applications 40 7.1 BISQUE ....................................................... 40 7.2 OME Server ..................................................... 40 8 Libraries and scripting applications 43 8.1 Command line tools ................................................. 43 8.2 FARSIGHT ...................................................... 44 8.3 i3dcore ........................................................ 44 8.4 ImgLib ........................................................ 44 8.5 ITK .......................................................... 45 8.6 Qu for MATLAB ................................................... 46 8.7 Subimager ...................................................... 46 9 Numerical data processing applications 47 9.1 IDL .......................................................... 47 9.2 KNIME ........................................................ 47 9.3 MATLAB ...................................................... 47 9.4 VisAD ........................................................ 48 10 Visualization and analysis applications 49 10.1 Bitplane Imaris .................................................... 49 i 10.2 CellProfiler ...................................................... 49 10.3 Comstat2 ....................................................... 50 10.4 Endrov ........................................................ 50 10.5 FocalPoint ...................................................... 50 10.6 Graphic Converter .................................................. 51 10.7 Icy .......................................................... 51 10.8 imago ......................................................... 51 10.9 Iqm .......................................................... 51 10.10 Macnification ..................................................... 51 10.11 MIPAV ........................................................ 51 10.12 Vaa3D ........................................................ 52 10.13 VisBio ........................................................ 52 10.14 XuvTools ....................................................... 53 III Developer Documentation 54 11 Using Bio-Formats 55 11.1 An in-depth guide to using Bio-Formats ....................................... 55 11.2 Generating test images ................................................ 57 12 Bio-Formats as a Java library 59 12.1 API documentation .................................................. 59 12.2 Examples ....................................................... 60 13 Interfacing from non-Java code 70 13.1 Interfacing with Bio-Formats from non-Java code .................................. 70 13.2 Bio-Formats C++ bindings .............................................. 70 13.3 Build instructions for C++ bindings ......................................... 70 13.4 Building C++ bindings in Windows ......................................... 72 13.5 Building C++ bindings in Mac OS X ........................................ 73 13.6 Building C++ bindings in Linux ........................................... 74 14 SCIFIO 75 14.1 SCientific Imaging Formats Input and Output .................................... 75 15 Writing new Bio-Formats file format readers 76 15.1 Bio-Formats file format reader guide ........................................ 76 16 Contributing to Bio-Formats 80 16.1 Developing Bio-Formats ............................................... 80 16.2 Testing individual commits (internal developers) .................................. 81 16.3 Public test data .................................................... 82 16.4 Bio-Formats service and dependency infrastructure ................................. 85 IV Formats 88 17 Dataset Structure Table 90 17.1 Flex Support ..................................................... 93 18 Supported Formats 94 18.1 3i SlideBook ..................................................... 99 18.2 Andor Bio-Imaging Division (ABD) TIFF ..................................... 100 18.3 AIM ......................................................... 100 18.4 Alicona 3D ...................................................... 101 18.5 Amersham Biosciences Gel ............................................. 102 18.6 Amira Mesh ..................................................... 102 18.7 Analyze 7.5 ...................................................... 103 18.8 Animated PNG .................................................... 104 18.9 Aperio SVS TIFF ................................................... 104 18.10 Applied Precision CellWorX ............................................. 105 ii 18.11 AVI (Audio Video Interleave) ............................................ 106 18.12 Axon Raw Format .................................................. 107 18.13 BD Pathway ..................................................... 108 18.14 Becker & Hickl SPCImage .............................................. 108 18.15 Bio-Rad Gel ..................................................... 109 18.16 Bio-Rad PIC ..................................................... 110 18.17 Bitplane Imaris .................................................... 110 18.18 Bruker MRI ..................................................... 111 18.19 Burleigh ....................................................... 112 18.20 Canon DNG ..................................................... 113 18.21 Cellomics ....................................................... 113 18.22 cellSens VSI ..................................................... 114 18.23 DeltaVision ...................................................... 115 18.24 DICOM ........................................................ 116 18.25 ECAT7 ........................................................ 117 18.26 EPS (Encapsulated PostScript) ............................................ 117 18.27 Evotec/PerkinElmer Opera Flex ........................................... 118 18.28 FEI .......................................................... 119 18.29 FEI TIFF ....................................................... 119 18.30 FITS (Flexible Image Transport System) ...................................... 120 18.31 Gatan Digital Micrograph .............................................. 121 18.32 Gatan Digital Micrograph 2 ............................................. 121 18.33 GIF (Graphics Interchange Format) ......................................... 122 18.34 Hamamatsu Aquacosmos NAF ............................................ 123 18.35 Hamamatsu HIS ................................................... 124 18.36 Hamamatsu ndpi ................................................... 124 18.37 Hamamatsu VMS .................................................. 125 18.38 Hitachi S-4800 .................................................... 126 18.39 ICS (Image Cytometry Standard) .......................................... 126 18.40 Imacon ........................................................ 127 18.41 ImagePro Sequence ................................................. 128 18.42 ImagePro Workspace ................................................. 129 18.43 IMAGIC ....................................................... 129 18.44 IMOD ........................................................ 130 18.45 Improvision Openlab LIFF .............................................. 131 18.46 Improvision Openlab Raw .............................................. 132 18.47 Improvision TIFF .................................................. 132 18.48 InCell 1000 ...................................................... 133 18.49 InCell 3000 ...................................................... 134 18.50 INR .......................................................... 135 18.51 IPLab ......................................................... 135 18.52 IPLab-Mac ...................................................... 136 18.53 JEOL ......................................................... 137 18.54 JPEG ......................................................... 137 18.55 JPEG 2000 ...................................................... 138 18.56 JPK .......................................................... 139 18.57 JPX .......................................................... 140 18.58 Khoros VIFF (Visualization Image File Format) Bitmap .............................. 140 18.59 Kodak BIP ...................................................... 141 18.60 Lambert Instruments FLIM ............................................. 142 18.61 Leica LCS LEI ...................................................