Changes for June 2010
=====================


The list of the key changes for the June 2010 major release of the
ome-xml data model. This schema release will tie in with the OMERO 4.2
release.

The new major release of the schema has a new namespace and all version
numbers are reset to 1. As a major release, any file that validated
correctly using the last major release will probably not validate
correctly using this new release. Some files that failed to validate
before will now be valid. It is important to update any file readers and
writers to understand the changes.

The version number of all schema files is now 1.

This schema uses the new namespace:

::

    http://www.openmicroscopy.org/Schemas/[NameSpaceTitle]/2010-06/

For the OME schema

::

    http://www.openmicroscopy.org/Schemas/OME/2010-06/

and the schema file is located at

::

    http://www.openmicroscopy.org/Schemas/OME/2010-06/ome.xsd

General updates
---------------

This release represents a collection of general updates to solve problems.

-  The release has been brought in step with release of OMERO 4.2.
-  Integer types have been made more restrictive.
-  A problem with ``Well Sample Timepoint`` has been fixed.
-  ``Width`` and ``Height`` have been added to ROI ``Mask``.
-  Annotations have been reworked to add new types ('Term' and 'Tag') and 
   allow cross-linking of all annotations.

ome.xsd
^^^^^^^

-  Integer types have been made more restrictive.

ROI.xsd
^^^^^^^

-  ``Width`` has been added to ``Mask``.
-  ``Height`` has been added to ``Mask``.
-  ``AnnotationRef`` has been removed from ``Shape`` (``Shape`` is no longer 
   directly annotatable, annotations will be moved up to the ROI level).

SA.xsd
^^^^^^

-  ``CommentAnnotation`` has been renamed as ``StructuredAnnotations``.
-  ``TagAnnotation`` has been added to ``StructuredAnnotations``.
-  ``TermAnnotation`` has been added to ``StructuredAnnotations``.
-  ``Description`` has been added to ``Annotation``.
-  The list of ``AnnotationRef`` has been added to ``Annotation``.
-  ``Namespace`` in ``Annotation`` is now optional.
-  The list of ``AnnotationRef`` has been removed from ``ListAnnotation`` (it 
   is now inherited from the base ``Annotation``).
-  ``ROI:Shape`` is no longer in the list of annotatable objects.

SPW.xsd
^^^^^^^

-  ``WellOriginX`` in ``Plate`` has been documented.
-  ``WellOriginY`` in ``Plate`` has been documented.
-  ``NamingConvention`` in ``Plate`` has been documented. 
-  The type of ``Timepoint`` in ``WellSample`` is now an 'xsd:dateTime'.