We're Hiring!

Semantic Types with new OME-XML release

General user discussion about using and improving the OME Data Model. Please ask new questions at https://forum.image.sc/tags/ome-xml
Please note:
Historical discussions about the OME Data Model. Please look for and ask new questions at https://forum.image.sc/tags/ome-xml

Semantic Types with new OME-XML release

Postby mmoulis » Mon Jul 18, 2011 2:45 pm

Hi !

I am currently using the new release of OME XML (2011-06) and i would like to make new types. So I would like to make my own types in a <SemanticTypeDefinitions> section but it seems to be invalid. When I try to validate my xml file with the bio format command tools xmlvalid, i get :

Code: Select all
Validating C:\***\test2.xml
cvc-complex-type.2.4.a: Invalid content was found starting with element 'SemanticTypeDefinitions'. One of '{"http://www.openmicroscopy.org/Schemas/OME/2011-06": Project, "http://www.openmicroscopy.org/Schemas/OME/2011-06":Dataset, "http://www.openmicroscopy.org/Schemas/OME/2011-06":Experiment, "http://www.openmicroscopy.org/Schemas/SPW/2011-06":Plate, "http://www.openmicroscopy.org/Schemas/SPW/2011-06":Screen, "http://www.openmicroscopy.org/Schemas/OME/2011-06":Experimenter, "http://www.openmicroscopy.org/Schemas/OME/2011-06":Group, "http://www.openmicroscopy.org/Schemas/OME/2011-06":Instrument, "http://www.openmicroscopy.org/Schemas/OME/2011-06":Image, "http://www.openmicroscopy.org/Schemas/SA/2011-06":StructuredAnnotations, "http://www.openmicroscopy.org/Schemas/ROI/2011-06":ROI, "http://www.openmicroscopy.org/Schemas/OME/2011-06":BinaryOnly}' is expected.
Error validating document: 1 errors found


It seems that the STD namespace is not recognized.

The header of my file XML file is :
Code: Select all
<?xml version="1.0" encoding="UTF-8"?>
<!-- Warning: this comment is an OME-XML metadata block, which contains crucial dimensional parameters and other important metadata. Please edit cautiously (if at all), and back up the original data before doing so. For more information, see the OME-TIFF web site: http://ome-xml.org/wiki/OmeTiff. -->
<OME
    xmlns="http://www.openmicroscopy.org/Schemas/OME/2011-06"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:STD="http://www.openmicroscopy.org/Schemas/STD/2009-09"
    xsi:schemaLocation="http://www.openmicroscopy.org/Schemas/OME/2011-06
                        http://www.openmicroscopy.org/Schemas/OME/2011-06/ome.xsd
                        http://www.openmicroscopy.org/Schemas/STD/2009-09
                        http://www.openmicroscopy.org/Schemas/STD/2009-09/STD.xsd">


So where is the problem ?

Thanks for your help,

Kind regards;

Marius
mmoulis
 
Posts: 14
Joined: Fri Jun 24, 2011 3:20 pm

Re: Semantic Types with new OME-XML release

Postby ajpatterson » Mon Jul 18, 2011 3:26 pm

Hi Marius,

Semantic Types were a carry over from the old OME server (which stopped active development in 2005).

They were removed completely from the schema in 2010. The modern way of adding user customisable values to the schema is using Structured Annotations (introduced in 2008).

See:
http://www.ome-xml.org/wiki/StructuredAnnotations
http://trac.openmicroscopy.org.uk/ome/w ... nnotations
http://trac.openmicroscopy.org.uk/ome/w ... nnotations

The namespace for structured annotations is
Code: Select all
http://www.openmicroscopy.org/Schemas/SA/2011-06/SA.xsd


A list of the Active and Legacy Schemas is always available at:
http://www.openmicroscopy.org/Schemas/
along with a history of the versions.

To see the changes between versions see the pages under:
http://www.ome-xml.org/wiki/ChangesFor

As a general rule all the namespaces you use in any single document need to be from the same schema version.

If you have any further questions just ask.

Hope this helps,

Andrew
--
Andrew Patterson
Software Developer, Open Microscopy Environment
Wellcome Trust Centre for Gene Regulation and Expression
University of Dundee
ajpatterson
 
Posts: 50
Joined: Fri May 01, 2009 11:18 am

Re: Semantic Types with new OME-XML release

Postby mmoulis » Mon Jul 18, 2011 3:34 pm

Thanks a lot!

I'll check these informations.

Kind regards,

Marius
mmoulis
 
Posts: 14
Joined: Fri Jun 24, 2011 3:20 pm

Re: Semantic Types with new OME-XML release

Postby mmoulis » Tue Jul 19, 2011 10:19 am

Hi again!

I tried to use Structured Annotations and everything is fine with Comment Annotation. When I add something like :
Code: Select all
<StructuredAnnotations xmlns="http://www.openmicroscopy.org/Schemas/SA/2011-06">
        <CommentAnnotation ID="Annotation:2" Namespace="">
            <Value>Some comments here</Value>
        </CommentAnnotation>
</StructuredAnnotations>

Everything is fine since I get back this comment in OMERO.insight after importation into OMERO.

But, when I try :
Code: Select all
<StructuredAnnotations xmlns="http://www.openmicroscopy.org/Schemas/SA/2011-06">
        <DoubleAnnotation ID="Annotation:4">
            <Description>DoubleAnnotation test</Description>
            <Value>3.012</Value>
        </DoubleAnnotation>
</StructuredAnnotations>


or :
Code: Select all
<StructuredAnnotations xmlns="http://www.openmicroscopy.org/Schemas/SA/2011-06">
        <XMLAnnotation ID="Annotation:1" Namespace="">
            <Description> XML ANNOTATION TEST</Description>
            <Value>
                <test>TEST</test>
            </Value>
        </XMLAnnotation>
</StructuredAnnotations>


I don't get back information from OMERO.insight or I don't find them.

So how can I retrieve my XML Annotations or Double Annotation or the other ones into OMERO.insight ?

Plus, how the field <Description>Description</Description> put into an annotation works ?

Thanks in advance,

Marius
mmoulis
 
Posts: 14
Joined: Fri Jun 24, 2011 3:20 pm

Re: Semantic Types with new OME-XML release

Postby wmoore » Tue Jul 19, 2011 11:26 am

If you have the web client set up, you should see XML annotations displayed in the image metadata panel beside the other annotations.

This is not supported in Insight yet, but will be in future. See http://trac.openmicroscopy.org.uk/ome/ticket/6287

Will.
User avatar
wmoore
Team Member
 
Posts: 674
Joined: Mon May 18, 2009 12:46 pm

Re: Semantic Types with new OME-XML release

Postby mmoulis » Tue Jul 19, 2011 11:37 am

I've just checked, and my XML Annotations are well displayed in OMERO.web.

I will wait the last version of OMERO clients to see them into insight.

Thanks a lot!

Marius
mmoulis
 
Posts: 14
Joined: Fri Jun 24, 2011 3:20 pm

Re: Semantic Types with new OME-XML release

Postby ajpatterson » Tue Jul 19, 2011 11:49 am

Hello Marius,

Not all of the Annotation types will be visible in OMERO.insight but you should be able to see them in OMERO.web as well as retrieve them pragmatically from the OMERO server using the API.

We are working on adding display of the other types to Insights and have an open story for these tasks.
http://trac.openmicroscopy.org.uk/ome/ticket/3541

I have added a link to this post from one of the the tasks.

Description is purely a text description of what the annotation value is. It is an optional attribute. Some clients may choose to display it, others might not. It should not be relied on to contain any important information. The unique identifier what any user code should use to locate annotations is the namespace. If you are writing Structured Annotations you should declare the namespace otherwise you could not recover your annotations at a later date.

For samples I normaly use:
Code: Select all
sample:ome:...

e.g.
Code: Select all
sample:ome:omero:render:cut-off-max


You probably want something like:
Code: Select all
your:company:url:yourapplication:...

Code: Select all
your:company:url:yourapplication:this:annotation:identifier


Hope this helps,

Andrew
--
Andrew Patterson
Software Developer, Open Microscopy Environment
Wellcome Trust Centre for Gene Regulation and Expression
University of Dundee
ajpatterson
 
Posts: 50
Joined: Fri May 01, 2009 11:18 am

Re: Semantic Types with new OME-XML release

Postby mmoulis » Tue Jul 19, 2011 12:51 pm

I really appreciate this quick but great support ! Thanks for all !

If I can make some suggestion :
* It might be very interesting that the external SAs be visible in "Acquisition" Tab in OMERO.insight and OMERO.web at the bottom of the sections Microscope, Image and so on. So, when a user check the acquisition metadatas using insight, he could see the OMERO's data model sections (microscope, Image, Channel1...) and the other metadatas sections such as "MyMetadataGroup1", "MyMetadatGroup2" and so on... I don't know if i am enough clear :oops:

* When I discover the OME-XML data model, I have to admit that i was quite lost. For example, the fact that STD and CA are deprecated is not obvious and should be underline in your website (http://www.ome-xml.org). To conclude, I suggest that the OME-XML documentation be more visible and more accessible

That said, I want to say that this forum and OMERO support in general is perfect.
mmoulis
 
Posts: 14
Joined: Fri Jun 24, 2011 3:20 pm


Return to User Discussion and Suggestions

Who is online

Users browsing this forum: No registered users and 1 guest