Skip to content
Bio-Formats is a Java library for reading and writing data in life sciences image file formats. It is developed by the Open Microscopy Environment (particularly UW-Madison LOCI and Glencoe Software). Bio-Formats is released under the GNU General Public License (GPL); commercial licenses are available from Glencoe Software.
Java PostScript C++ Python XSLT HTML Other
Pull request Compare This branch is 805 commits behind openmicroscopy:develop.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
ant
components
config
cpp
docs
jar
lib
pom
tools
.classpath-template
.gitattributes
.gitignore
.mailmap
.travis.yml
CMakeLists.txt
CONTRIBUTING.md
LICENSE.txt
README.md
build.xml
checkstyle.xml
excludebugs.xml
pom.xml
setup.cfg

README.md

Bio-Formats

Build Status

Bio-Formats is a standalone Java library for reading and writing life sciences image file formats. It is capable of parsing both pixels and metadata for a large number of formats, as well as writing to several formats.

Purpose

Bio-Formats' primary purpose is to convert proprietary microscopy data into an open standard called the OME data model, particularly into the OME-TIFF file format. See the statement of purpose for a thorough explanation and rationale.

Supported formats

Bio-Formats supports more than a hundred file formats.

For users

Many software packages use Bio-Formats to read and write microscopy formats.

For developers

You can use Bio-Formats to easily support these formats in your software.

More information

For more information, see the Bio-Formats web site.

Pull request testing

We welcome pull requests from anyone, but ask that you please verify the following before submitting a pull request:

  • verify that the branch merges cleanly into develop
  • verify that the branch compiles with the clean jars tools Ant targets
  • verify that the branch compiles using Maven
  • verify that the branch does not use syntax or API specific to Java 1.8+
  • run the unit tests (ant test) and correct any failures
  • test at least one file in each affected format, using the showinf command
  • internal developers only: run the data tests against directories corresponding to the affected format(s)
  • make sure that your commits contain the correct authorship information and, if necessary, a signed-off-by line
  • make sure that the commit messages or pull request comment contains sufficient information for the reviewer(s) to understand what problem was fixed and how to test it
Something went wrong with that request. Please try again.