<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1255">
<style>
<!--
@font-face
{font-family:Cambria}
@font-face
{font-family:Calibri}
@font-face
{font-family:Tahoma}
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri","sans-serif"}
a:link, span.MsoHyperlink
{color:blue;
text-decoration:underline}
a:visited, span.MsoHyperlinkFollowed
{color:purple;
text-decoration:underline}
span.EmailStyle17
{font-family:"Calibri","sans-serif";
color:windowtext}
.MsoChpDefault
{font-family:"Calibri","sans-serif"}
@page WordSection1
{margin:1.0in 1.0in 1.0in 1.0in}
div.WordSection1
{}
-->
</style>
</head>
<body lang="EN-US" link="blue" vlink="purple">
<p dir="ltr">Hi Mike</p>
<p dir="ltr">Thanks for this info. It's great to have this spec and the example data. We'll look at this and let you know if we have any questions or issues.</p>
<p dir="ltr">I don't know if we can get this into our upcoming release, as we already have a lot of work scheduled for that. We'll definitely cc you on the relevant tickets so you can follow our progress.</p>
<p dir="ltr">Thanks again for this contribution. We welcome all info and sample data from the commercial imaging community. Thanks to all at Bruker for their support of Bio-Formats.</p>
<p dir="ltr">Cheers,</p>
<p dir="ltr">Jason</p>
<p dir="ltr">Centre for Gene Regulation & Expression | Open Microscopy Environment | University of Dundee</p>
<div class="quote">On 9 Jun 2014 15:54, Mike Wussow <Mike.Wussow@bruker-nano.com> wrote:<br type="attribution">
</div>
<div>
<div class="WordSection1">
<p class="MsoNormal">Dear Bio-formats Community,</p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">Prairie View version 5.2 will be released the first week in July 2014. With this release we have found it necessary to make changes to our XML files. We realize that these changes will likely break the Bio-formats reader for our files
but were necessary changes that should serve our customers well moving forward. Therefore we are providing information on the changes and example data sets in advance of our release in the hopes that this community can update the Bio-formats reader to accommodate
these changes.</p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">A summary of the changes that have occurred to our XML files can be found here:
<a href="https://www.dropbox.com/s/sf2e634tpuv6ffh/Prairie%20View%20XML%20Evolution.docx">
https://www.dropbox.com/s/sf2e634tpuv6ffh/Prairie%20View%20XML%20Evolution.docx</a> as well as in the text below.</p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">Example data sets can be downloaded here: <a href="https://www.dropbox.com/sh/rtd73wcu4oboqt4/AABKM1rdhYLWjFVrw-YA5__Sa">
https://www.dropbox.com/sh/rtd73wcu4oboqt4/AABKM1rdhYLWjFVrw-YA5__Sa</a></p>
<p class="MsoNormal"> </p>
<p class="MsoNormal"><b><span style="font-size:8.0pt; font-family:"Arial","sans-serif"; color:black">Michael C. Wussow</span></b><span style="font-size:12.0pt; font-family:"Times New Roman","serif"; color:black"></span></p>
<p class="MsoNormal"><span style="font-size:8.0pt; font-family:"Arial","sans-serif"; color:black">Director Product Line Management</span></p>
<p class="MsoNormal"><span style="font-size:12.0pt; font-family:"Times New Roman","serif"; color:black"> </span></p>
<p class="MsoNormal"><span style="font-size:8.0pt; font-family:"Arial","sans-serif"; color:black">Bruker Nano Surfaces Division
</span><u><span style="font-size:8.0pt; font-family:"Arial","sans-serif"; color:blue"><a href="mailto:mike.wussow@bruker-nano.com">mike.wussow@bruker-nano.com</a></span></u><span style="font-size:12.0pt; font-family:"Times New Roman","serif"; color:black"></span></p>
<p class="MsoNormal"><span style="font-size:8.0pt; font-family:"Arial","sans-serif"; color:black">3030 Laura Lane, Suite 140
<a href="http://www.bruker.com/nano"><span style="color:blue">http://www.bruker.com/nano</span></a></span><span style="font-size:12.0pt; font-family:"Times New Roman","serif"; color:black"></span></p>
<p class="MsoNormal"><span style="font-size:8.0pt; font-family:"Arial","sans-serif"; color:black">Middleton, WI 53562-0677</span><span style="font-size:12.0pt; font-family:"Times New Roman","serif"; color:black"></span></p>
<p class="MsoNormal"><span style="font-size:8.0pt; font-family:"Arial","sans-serif"; color:black">Phone: +1 608-662-0022 x167</span></p>
<p class="MsoNormal"><span style="font-size:8.0pt; font-family:"Arial","sans-serif"; color:black">Cell:
</span><span style="font-size:8.0pt; font-family:"Arial","sans-serif"; color:black">+1
</span><span style="font-size:8.0pt; font-family:"Arial","sans-serif"; color:black">608-381-8252</span><span style="font-size:12.0pt; font-family:"Times New Roman","serif"; color:black"></span></p>
<div>
<div>
<div>
<div>
<div class="MsoNormal"><span style="font-size:10.0pt; font-family:"Tahoma","sans-serif"; color:#1F497D">
<hr size="8" width="600" noshade="" align="left" style="width:6.25in; color:#0071BC">
</span></div>
</div>
</div>
</div>
</div>
<p class="MsoNormal"> </p>
<div style="border:none; border-bottom:solid #4F81BD 1.0pt; padding:0in 0in 4.0pt 0in">
<p class="MsoNormalCxSpMiddle" style="margin-bottom:15.0pt; border:none; padding:0in">
<span style="font-size:26.0pt; font-family:"Cambria","serif"; color:#17365D; letter-spacing:.25pt">Prairie View XML Evolution</span></p>
</div>
<p class="MsoNormal" style="margin-top:24.0pt; line-height:115%; page-break-after:avoid">
<b><span style="font-size:14.0pt; line-height:115%; font-family:"Cambria","serif"; color:#365F91">Version 4.x and Earlier</span></b></p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">This is the format most Prairie View users are accustomed to seeing, and most third-party applications are able to handle. The largest issue with customers trying to parse this format is trying
to read the XML file like a text file, looking for certain strings or assuming a fixed order, when it should be read as an XML file using whatever XML parser is available in the programming language being used.</p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">Another lesser-known issue with this format is that while the first line in the file says it is XML version 1.0, the file actually contains some characters that aren’t valid for version 1.0
and instead require version 1.1. Some XML parsing libraries (for example, MATLAB’s) are picky about this distinction and refuse to read the XML files unless the version at the top of the file is changed from 1.0 to 1.1. However, Microsoft/.NET doesn’t support
version 1.1, so if the file is changed, Prairie View can no longer read the file. Removal of those characters is beyond the scope of Bruker’s current technical development projects.</p>
<p class="MsoNormal" style="margin-top:24.0pt; line-height:115%; page-break-after:avoid">
<b><span style="font-size:14.0pt; line-height:115%; font-family:"Cambria","serif"; color:#365F91">Version 5.0</span></b></p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">In addition to the traditional XML file format, Prairie View version 5.0 offers the option to ‘Use Smaller XML File Format’; the user can toggle this option under the ‘Preferences’ menu in
the Prairie View software. </p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">The smaller XML file format eliminates the duplicate state key/value pairs by introducing a hierarchical structure where only what has changed is written out. This saves tens to hundreds of
megabytes for larger data sets. However, most third-party applications designed to read the larger XML files will not read the smaller format because they don’t know where to find data that can exist in any one of three places. The differences are illustrated
in the following example.</p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">In earlier versions each data set XML file looked something like the following:</p>
<p class="MsoNormal" style="margin-right:0in; margin-bottom:10.0pt; margin-left:.5in; line-height:115%">
<?xml version="1.0" encoding="utf-8"?><br>
<PVScan version="4.3.2.24" date="3/27/2013 5:01:57 PM" <span style="color:red">…</span> ><br>
<span style="color:red"> …</span><br>
<Sequence <span style="color:red">…</span> ><br>
<Frame <span style="color:red">… </span>><br>
<PVStateShard><br>
<span style="color:red"> …All state key/value pairs are listed here, for every frame, even if they don’t change…
</span><br>
</PVStateShard><br>
</Frame><br>
<span style="color:red"> …There could be more frames here…<br>
</span> </Sequence><span style="color:red"><br>
…There could be more sequences here…<br>
</span></PVScan></p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">XML files using the smaller format look something like the following:</p>
<p class="MsoNormal" style="margin-right:0in; margin-bottom:10.0pt; margin-left:.5in; line-height:115%">
<?xml version="1.0" encoding="utf-8"?><br>
<PVScan version="5.0.64.100" date="4/15/2014 ţý9:01:26 AM" <span style="color:red">
…</span> ><br>
<span style="color:red"> …<br>
</span> <PVStateShard><br>
<span style="color:red"> …All state key/value pairs are listed here,<br>
this can be thought of as the grandparent state… </span><br>
</PVStateShard><br>
<span style="color:red"> …</span><br>
<Sequence <span style="color:red">…</span> ><br>
<span style="color:red"> …</span><br>
<PVStateShard><br>
<span style="color:red"> …Only state key/value pairs which differ from the grandparent state are listed here,<br>
this can be thought of as the parent state… </span><br>
</PVStateShard><br>
<span style="color:red"> …</span><br>
<Frame <span style="color:red">… </span>><br>
<PVStateShard><br>
<span style="color:red"> …Only state key/value pairs which differ from the parent state are listed here,<br>
this can be thought of as the child state… </span><br>
</PVStateShard><br>
</Frame><br>
<span style="color:red"> …There could be more frames here…<br>
</span> </Sequence><span style="color:red"><br>
…There could be more sequences here…<br>
</span></PVScan></p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">It is important to note that any XML parser capable of handling the smaller XML format can still read the old format. The old, larger format is like a special case of the smaller XML file
where the child state contains every state key/value pair and it is never necessary to look at the parent or grandparent state. It is still a good practice to check if those parent and grandparent nodes exist prior to trying to access them.<b><span style="font-size:14.0pt; line-height:115%; font-family:"Cambria","serif"; color:#365F91"></span></b></p>
<p class="MsoNormal" style="margin-top:24.0pt; line-height:115%; page-break-after:avoid">
<b><span style="font-size:14.0pt; line-height:115%; font-family:"Cambria","serif"; color:#365F91">Version 5.1</span></b></p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">There were no significant changes in the XML structure between version 5.0 and 5.1. The option for the user to select either the original or the smaller XML format exists in 5.1 as it did in
5.0.</p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">In Prairie View 5.1, OME TIFF support was updated and extended to allow Fiji/ImageJ to import our datasets using just the TIFF files. Almost every TIFF file written in version 5.1 is an OME
TIFF, as noted by the *.ome.tif file extension. In version 5.0, and earlier versions supporting OME TIFF, adding OME TIFF metadata to the TIFFs was done in post processing and did not change the file extension; that OME TIFF implementation was rudimentary
and designed with a single case in mind. The changes in 5.1 fully implement the OME TIFF format.</p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">A data set can be imported into Fiji/ImageJ using the OME TIFF metadata (instead of the Prairie View data set XML file) by selecting the first *ome.tif file in the folder (instead of the XML
file that would normally be used by the Bio-Formats import tool). The first *.ome.tif file is a little larger than the rest and contains information about all the other related TIF files.</p>
<p class="MsoNormal" style="margin-top:24.0pt; line-height:115%; page-break-after:avoid">
<b><span style="font-size:14.0pt; line-height:115%; font-family:"Cambria","serif"; color:#365F91">Version 5.2</span></b></p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">This version takes the smaller XML format introduced in version 5.1 and makes it the default format, with no option to go back to writing out the larger data set XML files. In addition, the
format of the state key/value pairs has changed slightly to incorporate indices and sub-indices where applicable.</p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">For example here are what some state key/value pairs looked like prior to version 5.2:</p>
<p class="MsoNormal" style="margin-right:0in; margin-bottom:10.0pt; margin-left:.5in; line-height:115%">
<Key key="linesPerFrame" permissions="Read, Write, Save" value="186" /><br>
<Key key="pmtGain_0" permissions="Write, Save" value="605" /><br>
<Key key="pmtGain_1" permissions="Write, Save" value="604" /><br>
<Key key="pmtGain_2" permissions="Write, Save" value="0" /><br>
<Key key="positionCurrent_XAxis" permissions="Write, Save" value="0.95" /><br>
<Key key="positionCurrent_YAxis" permissions="Write, Save" value="-4.45" /><br>
<Key key="positionCurrent_ZAxis" permissions="Write, Save" value="-9,62.45" /></p>
<span style="font-size:11.0pt; line-height:115%; font-family:"Calibri","sans-serif""><br clear="all" style="page-break-before:always">
</span>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%"> </p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">Here is what those same state key/value pairs look like in version 5.2:</p>
<p class="MsoNormal" style="margin-right:0in; margin-bottom:10.0pt; margin-left:.5in; line-height:115%">
<PVStateValue key="linesPerFrame" value="186" /><br>
<PVStateValue key="pmtGain"><br>
<IndexedValue index="0" value="605" description="Ch1 High Voltage" /><br>
<IndexedValue index="1" value="604" description="Ch2 High Voltage" /><br>
<IndexedValue index="2" value="0" description="Ch3 High Voltage" /><br>
</PVStateValue><br>
<PVStateValue key="positionCurrent"><br>
<SubindexedValues index="XAxis"><br>
<SubindexedValue subindex="0" value="0.95" /><br>
</SubindexedValues><br>
<SubindexedValues index="YAxis"><br>
<SubindexedValue subindex="0" value="-4.45" /><br>
</SubindexedValues><br>
<SubindexedValues index="ZAxis"><br>
<SubindexedValue subindex="0" value="-9" description="Focus" /><br>
<SubindexedValue subindex="1" value="62.45" description="Piezo" /><br>
</SubindexedValues><br>
</PVStateValue></p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">Notice that in addition to the slight formatting changes, description fields have been enhanced to include some human-recognizable identifiers for key/value pairs which would otherwise only
have a programmatically generated index associated with them. Since this new description field has just been introduced, not all key/value pairs have been implemented; more will be implemented over time.</p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">It is also worth noting that keys, indices, and sub-indices in version 5.2 are written in alphabetical/numerical order, whereas the order in older versions could vary based on a number of factors.</p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">Also new to version 5.2 is XML metadata related to Spectral Mode in Prairie View. If a sequence was collected in Spectral Mode, the sequence tag would have the SpectralMode attribute set to
“True”.</p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%"><Sequence SpectralMode="True" …</p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%">The rest of the metadata format is consistent with a non-spectral dataset except that instead of having a maximum of four image channels, there can be 16 channels with each channel corresponding
to subset of the entire emission spectrum. Each channel is denoted by the <File> tag and has attributes for channel name, channel number, timestamp and filename. Metadata for a spectral frame with 16 spectral channels is formatted as follows:</p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%"><Frame index="1" parameterSet="CurrentSettings" absoluteTime="0.374000000000024" relativeTime="0"></p>
<p class="MsoNormal" style="margin-right:0in; margin-bottom:10.0pt; margin-left:.5in; line-height:115%">
<File absoluteTime="0.374" relativeTime="0" filename="TSeries-06052014-1318-003_Cycle00001_Ch1_000001.ome.tif" wavelengthMax="531" wavelengthMin="526" channelName="SpectralChannel_01" channel="1"/></p>
<p class="MsoNormal" style="margin-right:0in; margin-bottom:10.0pt; margin-left:.5in; line-height:115%">
…</p>
<p class="MsoNormal" style="margin-right:0in; margin-bottom:10.0pt; margin-left:.5in; line-height:115%">
<File absoluteTime="0.374" relativeTime="0" filename="TSeries-06052014-1318-003_Cycle00001_Ch16_000001.ome.tif" wavelengthMax="828" wavelengthMin="808" channelName="SpectralChannel_16" channel="16"/></p>
<p class="MsoNormal" style="margin-right:0in; margin-bottom:10.0pt; margin-left:.5in; line-height:115%">
<ExtraParameters lastGoodFrame="0"/></p>
<p class="MsoNormal" style="margin-right:0in; margin-bottom:10.0pt; margin-left:.5in; line-height:115%">
<PVStateShard/></p>
<p class="MsoNormal" style="margin-bottom:10.0pt; line-height:115%"></Frame></p>
<p class="MsoNormal"> </p>
</div>
</div>
<br>
<span style="font-size:10pt;">The University of Dundee is a registered Scottish Charity, No: SC015096</span>
</body>
</html>