Hi Nigel,<br><br>> Hi, we are looking at using bioformats.jar. Jason told me there is a<br>> new release committed that can export the most up to date OME-XML. How<br>> do we get access to this?<br><br>There is not yet an official release of the library supporting the 2007-06 OME-XML schema. But Jason is right that the latest development code in our Subversion repository now has this support. If you like, you can check out the code from our repository:
<br><br><a href="https://skyking.microscopy.wisc.edu/svn/java/trunk">https://skyking.microscopy.wisc.edu/svn/java/trunk</a><br><br>Any of command line svn, TortoiseSVN for Windows, or the Subclipse plugin for Eclipse will work to access the code.
<br><br>You can build the library from the command line using Ant (try "ant -p" for a list of targets, just "ant" to create bio-formats.jar, or "ant tools" to make loci_tools.jar). You will need JDK
1.4 or later (or jikes) in order to compile it. Alternately, with Eclipse, point your source path at the root folder, and set the inclusion rule to include only the "loci" subfolder, and things should compile. You may also want to set the compiler to
1.4-compatible to avoid an avalanche of 1.5-specific compiler warnings.<br><br>Please note that this code has not been officially released or announced, nor thoroughly tested. We are still in the process of finishing the 2007-06 OME-XML support, and though the basic functionality is working, many things are still missing. Nonetheless, feel free to email me if you encounter bugs.
<br><br>Alternately, you can wait for an official release. There will probably be a preliminary release within a week or so including this functionality, though it will not be finished, and will still default to the 2003/FC version of OME-XML for now. My best guess is that we will officially make the switch over to 2007-06 some time next month.
<br><br>> Also, in the previous version there seemed to be very little metadata in<br>> the core, almost everything was in the format-specific fields. Has this<br>> changed with the new release? It's much more useful for cross-vendor
<br>> facilities if search can be done over metadata independent of format.<br><br>Your statement that "it's much more useful for cross-vendor facilities if search can be done over metadata independent of format" is the central principle of Bio-Formats, and one of OME's guiding principles in general.
<br><br>As such, there are actually three types of metadata in Bio-Formats, which we call core metadata, original metadata, and OME metadata.<br><br>1) "Core metadata" only includes those things necessary to understand the basic structure of the pixels: image resolution; number of focal planes, time points, channels, and other dimensional axes; byte order; dimension order; color arrangement (RGB, indexed color or separate channels); and thumbnail resolution.
<br><br>2) "Original metadata" corresponds to the format-specific fields you mentioned. They are key/value pairs in the original format, with no guarantee of cross-format naming consistency or compatibility.<br>
<br>3) "OME metadata" is information from #1 and #2 converted by Bio-Formats into the OME data model. <b>Performing this conversion is the primary purpose of Bio-Formats.</b> Bio-Formats uses its ability to convert proprietary metadata into OME-XML as part of its integration with the OME and OMERO servers -- essentially, they are able to populate their databases in a structured way because Bio-Formats sorts the metadata into the proper places. This conversion is nowhere near complete or bug free, but we are constantly working to improve it. We would greatly appreciate any and all input from users concerning missing or improperly converted metadata fields.
<br><br>I am working on a "Bio-Formats Metadata Guide" document detailing these three kinds of metadata and how the Bio-Formats metadata API works. However, it is far from complete, with many unwritten sections. You can find a draft in the SVN repository here:
<br><br><a href="https://skyking.microscopy.wisc.edu/trac/java/browser/trunk/loci/formats/doc/metadata-guide.txt">https://skyking.microscopy.wisc.edu/trac/java/browser/trunk/loci/formats/doc/metadata-guide.txt</a><br><br>
I have tried to provide a lot of developer documentation online regarding how to use the Bio-Formats library, and link it all in a cohesive way from the Bio-Formats web site. If you feel anything is missing, or have trouble finding what you are looking for, please do not hesitate to ask.
<br><br>HTH,<br>Curtis<br><br>On Jan 17, 2008 4:57 PM, Nigel Goddard <<a href="mailto:ngoddard@axiope.com">ngoddard@axiope.com</a>> wrote:<br>> Hi, we are looking at using bioformats.jar. Jason told me there is a
<br>> new release committed that can export the most up to date OME-XML. How<br>> do we get access to this?<br>> <br>> Also, in the previous version there seemed to be very little metadata in<br>> the core, almost everything was in the format-specific fields. Has this
<br>> changed with the new release? It's much more useful for cross-vendor<br>> facilities if search can be done over metadata independent of format.<br>> <br>> thanks for your help,<br>> <br>> Nigel Goddard
<br>> Axiope Limited<br>> <br>> _______________________________________________<br>> ome-devel mailing list<br>> <a href="mailto:ome-devel@lists.openmicroscopy.org.uk">ome-devel@lists.openmicroscopy.org.uk</a>
<br>> <a href="http://lists.openmicroscopy.org.uk/mailman/listinfo/ome-devel">http://lists.openmicroscopy.org.uk/mailman/listinfo/ome-devel</a><br>> <br><br>