Structured proposal for OEIT
Pascal Olivier Gaggero
Dear All,
The OEIT development team is proud to present this structured proposal of OEIT 1.0. The starting point of this work was the “technical preview” version of OEIT presented and discussed in April at the annual EIT conference in Heilbad Heiligenstadt. Based on the feedback we received from the community and the experience we gathered while trying to implement legacy format readers/writers, we propose the following modifications:
· The OEIT archive now has a single entry point: oeit.xml.
o This file contains explicit references to the other XML files.
o This file contains an explicit reference to the OEIT schema document. It also implements the version management of OEIT files.
· The XML gives a full description of the binary content (see info/streams.xml for details).
o References to the configurations are no longer explicitly recorded into the binary stream.
o Timestamps are no longer part of the mandatory binary stream structure although we strongly recommend their use. If required, they must now be explicitly declared in the XML as for any other data types. This accomplishes two objectives: 1) it facilitates compatibility with systems where such information is not readily available, and 2) it makes it possible to use "legacy" files, such as the Goettingen GET and the Sheffield RAW formats, directly as the binary data stream inside the OEIT file.
· We recognize the need for a better geometry description (electrode shape, orientation, etc.) but we propose to postpone implementing these features to future versions of OEIT.
· All XML files are now gathered into the “info” folder.
· EIT data are stored into the “EIT” folder which contains sub-folders corresponding to the selected data stream (e.g. “0000”). The .frames binary files corresponding to the binary streams are located inside these sub-folders.
· The “aux” folder has been renamed “auxiliary” because, in Windows, no folders can be named “aux”. Inside this folder, data are organized in data streams each stored into numbered sub-folders: “0000”, “0001” up to “9999”.
· The “log” folder stores the logs coming from the various data sources. Here we can have two kinds of data sources 1) eit and 2) auxiliary. Thus, a log file named “eit-0000.log” refers to EIT data stream 0000.
· In the XML files, all values are now disambiguated using appended physical units.
· The <user_data> tag is introduced everywhere to provide additional flexibility to the format, Comments can also be added to every tag using the attribute “comment”.
You can have a look at our work by downloading (http://www.open-eit.org/examples ) the sample OEIT file: “Sample 1 (GOE MF II like acquisition)”. Although documents concerning the recommended file structure and best practices in OEIT have not been written yet, this example reflects the proposed file structure and xml coding principle.
Additionally, the full documentation about the XML format can be downloaded as a XML schema document at http://www.open-eit.org/schema.
We are looking forward for your comments,
Best regards,
Pascal Gaggero, Bartek Grychtol, Hervé Gagnon, Colin Jones, Alistair Boyle and Andy Adler
Andy Adler
Thanks for all of this work. From my point of view, I'm hoping we can
soon put this into EIDORS, so simplify the interface with data.
Can I make a request?
In order to read the sample OEIT file at
http://www.open-eit.org/examples
you need to open it with a zip file reader and then
look at the components.
Would it be possible to put the various components
on the web site, too?
One comment from my side is on the XML description of
the measurements:
http://www.open-eit.org/examples
We have (in info/frame_types.xml)
<frame_type_list>
<frame_type id="get_frame">
<acquisition start="0 us" duration="369.82 us">
<stim_list>
<stim type="CurrentInjection">
<elec ref="e1">
<multiplier>1</multiplier>
</elec>
<elec ref="e2">
<multiplier>-1</multiplier>
</elec>
</stim>
[etc ...]
I would like to propose we shorten this and encode it as follows:
<frame_type_list>
<frame_type id="get_frame">
<acquisition start="0 us" duration="369.82 us">
<stim_list>
<stim type="CurrentInjection">
<elec ref="e1" multiplier="1"/>
<elec ref="e2" multiplier="-1"/>
</stim>
[etc ...]
--
Andy Adler <ad...@sce.carleton.ca> +1-613-520-2600x8785
> You received this message because you are subscribed to the Google Groups
> "Open EIT Format" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to open-eit-form...@googlegroups.com.
> For more options, visit https://groups.google.com/groups/opt_out.
Pascal Olivier Gaggero
Andy Adler
Thanks.
Can you make the changes on the OEIT website?
I can also make these changes in the mirrored dev dir on EIDORS>