• Login
  • Help/Guide
  • About Trac
  • Preferences
  • Wiki
  • Timeline
  • Roadmap
  • Browse Source
  • View Tickets
  • Search

Context Navigation

  • ← Previous Change
  • Next Change →

Changeset 194 for Xml/Working

Show
Ignore:
Timestamp:
08/14/08 17:02:28 (4 months ago)
Author:
andrew
Message:

Version before major relax of schema

Files:
1 modified

  • Xml/Working/ome-roi-sa.xsd (modified) (105 diffs)

Legend:

Unmodified
Added
Removed

  • Xml/Working/ome-roi-sa.xsd

    r191 r194  
    3131        <xsd:import namespace="http://www.openmicroscopy.org/Schemas/STD/2008-02" schemaLocation="http://www.openmicroscopy.org/Schemas/STD/2008-02/STD.xsd"/> 
    3232        <xsd:import namespace="http://www.openmicroscopy.org/Schemas/BinaryFile/2008-02" schemaLocation="http://www.openmicroscopy.org/Schemas/BinaryFile/2008-02/BinaryFile.xsd"/> 
    33         <xsd:import namespace="http://www.openmicroscopy.org/Schemas/CA/2008-02" schemaLocation="http://www.openmicroscopy.org/Schemas/CA/2008-02/CA.xsd"/> 
     33        <xsd:import namespace="http://www.openmicroscopy.org/Schemas/CA/2008-02" schemaLocation="CA.xsd"/> 
    3434        <xsd:import namespace="http://www.openmicroscopy.org/Schemas/SPW/2008-02" schemaLocation="http://www.openmicroscopy.org/Schemas/SPW/2008-02/SPW.xsd"/> 
    3535        <xsd:import namespace="http://www.openmicroscopy.org/Schemas/SA/2008-02" schemaLocation="SA.xsd"/> 
    … …  
    4444                </xsd:documentation> 
    4545        </xsd:annotation> 
    46         <xsd:element name="OME"> 
     46        <xsd:element name="OME"> <!-- top level definition --> 
    4747                <xsd:annotation> 
    4848                        <xsd:documentation> 
    … …  
    6969                                <xsd:element ref="SA:StructuredAnnotations" minOccurs="0" maxOccurs="1"/> 
    7070                        </xsd:sequence> 
    71                         <xsd:attribute name="UUID" type="UniversallyUniqueIdentifier"/> 
    72                 </xsd:complexType> 
    73         </xsd:element> 
    74         <xsd:element name="Image"> 
     71                        <xsd:attribute name="UUID" type="UniversallyUniqueIdentifier" use="optional"/> 
     72                </xsd:complexType> 
     73        </xsd:element> 
     74        <xsd:element name="Image"> <!-- top level definition --> 
    7575                <xsd:annotation> 
    7676                        <xsd:documentation> 
    … …  
    9292                <xsd:complexType> 
    9393                        <xsd:sequence> 
    94                                 <xsd:element ref="CreationDate"/> 
    95                                 <xsd:element ref="ExperimenterRef" minOccurs="0"/> 
    96                                 <xsd:element ref="Description" minOccurs="0"/> 
    97                                 <xsd:element ref="ExperimentRef" minOccurs="0"/> 
    98                                 <xsd:element ref="GroupRef" minOccurs="0"/> 
     94                                <xsd:element ref="CreationDate" minOccurs="1" maxOccurs="1"/> 
     95                                <xsd:element ref="ExperimenterRef" minOccurs="0" maxOccurs="1"/> 
     96                                <xsd:element ref="Description" minOccurs="0" maxOccurs="1"/> 
     97                                <xsd:element ref="ExperimentRef" minOccurs="0" maxOccurs="1"/> 
     98                                <xsd:element ref="GroupRef" minOccurs="0" maxOccurs="1"/> 
    9999                                <xsd:element ref="DatasetRef" minOccurs="0" maxOccurs="unbounded"/> 
    100                                 <xsd:element ref="InstrumentRef" minOccurs="0"/> 
    101                                 <xsd:element ref="ObjectiveRef" minOccurs="0"/> 
    102                                 <xsd:element ref="ImagingEnvironment" minOccurs="0"/> 
    103                                 <xsd:element ref="Thumbnail" minOccurs="0"/> 
     100                                <xsd:element ref="InstrumentRef" minOccurs="0" maxOccurs="1"/> 
     101                                <xsd:element ref="ObjectiveRef" minOccurs="0" maxOccurs="1"/> 
     102                                <xsd:element ref="ImagingEnvironment" minOccurs="0" maxOccurs="1"/> 
     103                                <xsd:element ref="Thumbnail" minOccurs="0" maxOccurs="1"/> 
    104104                                <xsd:element ref="LogicalChannel" minOccurs="0" maxOccurs="unbounded"/> 
    105                                 <xsd:element ref="DisplayOptions" minOccurs="0"/> 
    106                                 <xsd:element ref="StageLabel" minOccurs="0"/> 
    107                                 <xsd:element ref="Pixels" maxOccurs="unbounded"/> 
     105                                <xsd:element ref="DisplayOptions" minOccurs="0" maxOccurs="1"/> 
     106                                <xsd:element ref="StageLabel" minOccurs="0" maxOccurs="1"/> 
     107                                <xsd:element ref="Pixels" minOccurs="1" maxOccurs="unbounded"/> 
    108108                                <xsd:element ref="Region" minOccurs="0" maxOccurs="unbounded"/> 
    109                                 <xsd:element ref="CA:CustomAttributes" minOccurs="0"/> 
     109                                <xsd:element ref="CA:CustomAttributes" minOccurs="0" maxOccurs="1"/> 
    110110                                <xsd:element ref="ROI" minOccurs="0" maxOccurs="unbounded"/> 
    111111                                <xsd:element ref="MicrobeamManipulation" minOccurs="0" maxOccurs="unbounded"/> 
    … …  
    121121                                </xsd:annotation> 
    122122                        </xsd:attribute> 
    123                         <xsd:attribute name="AcquiredPixels" type="PixelsID"> 
     123                        <xsd:attribute name="AcquiredPixels" use="optional" type="PixelsID"> 
    124124                                <xsd:annotation> 
    125125                                        <xsd:documentation> 
    … …  
    132132                </xsd:complexType> 
    133133        </xsd:element> 
    134         <xsd:element name="CreationDate" type="xsd:dateTime"> 
     134        <xsd:element name="CreationDate" type="xsd:dateTime"> <!-- top level definition --> 
    135135                <xsd:annotation> 
    136136                        <xsd:documentation> 
    … …  
    140140                </xsd:annotation> 
    141141        </xsd:element> 
    142         <xsd:element name="Pixels"> 
     142        <xsd:element name="Pixels"> <!-- top level definition --> 
    143143                <xsd:annotation> 
    144144                        <xsd:documentation> 
    … …  
    152152                <xsd:complexType> 
    153153                        <xsd:sequence> 
    154                                 <xsd:choice maxOccurs="unbounded"> 
    155                                         <xsd:element ref="Bin:BinData"/> 
    156                                         <xsd:element ref="TiffData"/> 
     154                                <xsd:choice minOccurs="1" maxOccurs="unbounded"> 
     155                                        <xsd:element ref="Bin:BinData" minOccurs="1" maxOccurs="1"/> 
     156                                        <xsd:element ref="TiffData" minOccurs="1" maxOccurs="1"/> 
    157157                                </xsd:choice> 
    158158                                <xsd:element ref="Plane" minOccurs="0" maxOccurs="unbounded"/> 
    … …  
    202202                                </xsd:annotation> 
    203203                        </xsd:attribute> 
    204                         <xsd:attribute name="PhysicalSizeX" type="xsd:float"> 
     204                        <xsd:attribute name="PhysicalSizeX" use="optional" type="xsd:float"> 
    205205                                <xsd:annotation> 
    206206                                        <xsd:documentation>Physical size of a pixel</xsd:documentation> 
    207207                                </xsd:annotation> 
    208208                        </xsd:attribute> 
    209                         <xsd:attribute name="PhysicalSizeY" type="xsd:float"> 
     209                        <xsd:attribute name="PhysicalSizeY" use="optional" type="xsd:float"> 
    210210                                <xsd:annotation> 
    211211                                        <xsd:documentation>Physical size of a pixel</xsd:documentation> 
    212212                                </xsd:annotation> 
    213213                        </xsd:attribute> 
    214                         <xsd:attribute name="PhysicalSizeZ" type="xsd:float"> 
     214                        <xsd:attribute name="PhysicalSizeZ" use="optional" type="xsd:float"> 
    215215                                <xsd:annotation> 
    216216                                        <xsd:documentation>Physical size of a pixel</xsd:documentation> 
    217217                                </xsd:annotation> 
    218218                        </xsd:attribute> 
    219                         <xsd:attribute name="TimeIncrement" type="xsd:float"/> 
    220                         <xsd:attribute name="WaveStart" type="xsd:positiveInteger"/> 
    221                         <xsd:attribute name="WaveIncrement" type="xsd:positiveInteger"/> 
    222                 </xsd:complexType> 
    223         </xsd:element> 
    224         <xsd:element name="TiffData"> 
     219                        <xsd:attribute name="TimeIncrement" use="optional" type="xsd:float"/> 
     220                        <xsd:attribute name="WaveStart" use="optional" type="xsd:positiveInteger"/> 
     221                        <xsd:attribute name="WaveIncrement" use="optional" type="xsd:positiveInteger"/> 
     222                </xsd:complexType> 
     223        </xsd:element> 
     224        <xsd:element name="TiffData"> <!-- top level definition --> 
    225225                <xsd:annotation> 
    226226                        <xsd:documentation> 
    … …  
    230230                <xsd:complexType> 
    231231                        <xsd:sequence> 
    232                                 <xsd:element name="UUID" minOccurs="0"> 
     232                                <xsd:element name="UUID" minOccurs="0" maxOccurs="1"> 
    233233                                        <xsd:annotation> 
    234234                                                <xsd:documentation> 
    … …  
    240240                                                <xsd:simpleContent> 
    241241                                                        <xsd:extension base = "UniversallyUniqueIdentifier"> 
    242                                                                 <xsd:attribute name="FileName" type="xsd:string"> 
     242                                                                <xsd:attribute name="FileName" use="optional" type="xsd:string"> 
    243243                                                                        <xsd:annotation> 
    244244                                                                                <xsd:documentation> 
    … …  
    257257                                </xsd:element> 
    258258                        </xsd:sequence> 
    259                         <xsd:attribute name="IFD" type="xsd:integer" default="0"> 
     259                        <xsd:attribute name="IFD" type="xsd:integer" default="0" use="optional"> 
    260260                                <xsd:annotation> 
    261261                                        <xsd:documentation> 
    … …  
    265265                                </xsd:annotation> 
    266266                        </xsd:attribute> 
    267                         <xsd:attribute name="FirstZ" type="xsd:integer" default="0"> 
     267                        <xsd:attribute name="FirstZ" type="xsd:integer" default="0" use="optional"> 
    268268                                <xsd:annotation> 
    269269                                        <xsd:documentation> 
    … …  
    273273                                </xsd:annotation> 
    274274                        </xsd:attribute> 
    275                         <xsd:attribute name="FirstT" type="xsd:integer" default="0"> 
     275                        <xsd:attribute name="FirstT" type="xsd:integer" default="0" use="optional"> 
    276276                                <xsd:annotation> 
    277277                                        <xsd:documentation> 
    … …  
    281281                                </xsd:annotation> 
    282282                        </xsd:attribute> 
    283                         <xsd:attribute name="FirstC" type="xsd:integer" default="0"> 
     283                        <xsd:attribute name="FirstC" type="xsd:integer" default="0" use="optional"> 
    284284                                <xsd:annotation> 
    285285                                        <xsd:documentation> 
    … …  
    289289                                </xsd:annotation> 
    290290                        </xsd:attribute> 
    291                         <xsd:attribute name="NumPlanes" type="xsd:integer"> 
     291                        <xsd:attribute name="NumPlanes" use="optional" type="xsd:integer"> 
    292292                                <xsd:annotation> 
    293293                                        <xsd:documentation> 
    … …  
    301301        </xsd:element> 
    302302         
    303         <xsd:element name="Plane"> 
     303        <xsd:element name="Plane"> <!-- top level definition --> 
    304304                <xsd:annotation> 
    305305                        <xsd:documentation> 
    … …  
    318318                                                </xsd:documentation> 
    319319                                        </xsd:annotation> 
    320                                         <xsd:element name="HashSHA1" type="Hex40"/> 
     320                                        <xsd:element name="HashSHA1" type="Hex40" minOccurs="1" maxOccurs="1"/> 
    321321                                </xsd:choice> 
    322322                        </xsd:sequence> 
    … …  
    355355        </xsd:complexType> 
    356356         
    357         <xsd:element name="Experiment"> 
     357        <xsd:element name="Experiment"> <!-- top level definition --> 
    358358                <xsd:annotation> 
    359359                        <xsd:documentation> 
    … …  
    368368                <xsd:complexType> 
    369369                        <xsd:sequence> 
    370                                 <xsd:element ref="Description" minOccurs="0"/> 
    371                                 <xsd:element ref="ExperimenterRef"> 
     370                                <xsd:element ref="Description" minOccurs="0" maxOccurs="1"/> 
     371                                <xsd:element ref="ExperimenterRef" minOccurs="1" maxOccurs="1"> 
    372372                                        <xsd:annotation> 
    373373                                                <xsd:documentation> 
    … …  
    407407                </xsd:complexType> 
    408408        </xsd:element> 
    409         <xsd:element name="ExperimentRef"> 
     409        <xsd:element name="ExperimentRef"> <!-- top level definition --> 
    410410                <xsd:complexType> 
    411411                        <xsd:complexContent> 
    … …  
    417417        </xsd:element> 
    418418 
    419         <xsd:element name="MicrobeamManipulation"> 
     419        <xsd:element name="MicrobeamManipulation"> <!-- top level definition --> 
    420420                <xsd:annotation> 
    421421                        <xsd:documentation> 
    … …  
    452452        </xsd:element> 
    453453         
    454         <xsd:element name="MicrobeamManipulationRef"> 
     454        <xsd:element name="MicrobeamManipulationRef"> <!-- top level definition --> 
    455455                <xsd:complexType> 
    456456                        <xsd:complexContent> 
    … …  
    461461                </xsd:complexType> 
    462462        </xsd:element>   
    463         <xsd:element name="LogicalChannel"> 
     463        <xsd:element name="LogicalChannel"> <!-- top level definition --> 
    464464                <xsd:annotation> 
    465465                        <xsd:documentation> 
    … …  
    472472                                The SamplesPerPixel attribute is the number of channel components in the logical channel. 
    473473                                The IlluminationType attribute is a string enumeration which may be set to 'Transmitted', 'Epifluorescence', 'Oblique', or 'NonLinear'. 
    474                                 The optional PinholeAize attribute allows specifying adjustable pin hole diameters for confocal microscopes. 
     474                                The optional PinholeSize attribute allows specifying adjustable pin hole diameters for confocal microscopes. 
    475475                                The PhotometricInterpretation attribute is used to describe how to display a multi-component channel.  This attribute may be set to: 
    476476                                'monochrome', 'RGB', 'ARGB', 'CMYK', 'HSV'.  The default for single-component channels is 'monochrome'. 
    … …  
    489489                <xsd:complexType> 
    490490                        <xsd:sequence> 
    491                                 <xsd:element ref="LightSourceRef" minOccurs="0"/> 
    492                                 <xsd:element ref="OTFRef" minOccurs="0"/> 
    493                                 <xsd:element ref="DetectorRef" minOccurs="0"/> 
    494                                 <xsd:element ref="FilterSetRef" minOccurs="0"/> 
    495                                 <xsd:element ref="ChannelComponent" maxOccurs="unbounded"/> 
     491                                <xsd:element ref="LightSourceRef" minOccurs="0" maxOccurs="1"/> 
     492                                <xsd:element ref="OTFRef" minOccurs="0" maxOccurs="1"/> 
     493                                <xsd:element ref="DetectorRef" minOccurs="0" maxOccurs="1"/> 
     494                                <xsd:element ref="FilterSetRef" minOccurs="0" maxOccurs="1"/> 
     495                                <xsd:element ref="ChannelComponent" minOccurs="1" maxOccurs="unbounded"/> 
    496496                        </xsd:sequence> 
    497497                        <xsd:attribute name="ID" use="required" type="LogicalChannelID"/> 
    … …  
    514514                                </xsd:simpleType> 
    515515                        </xsd:attribute> 
    516                         <xsd:attribute name="PinholeSize" type="xsd:positiveInteger"/> 
    517                         <xsd:attribute name="PhotometricInterpretation" default="Monochrome"> 
     516                        <xsd:attribute name="PinholeSize" use="optional" type="xsd:float"/> 
     517                        <xsd:attribute name="PhotometricInterpretation" default="Monochrome" use="optional"> 
    518518                                <xsd:annotation> 
    519519                                        <xsd:documentation> 
    … …  
    533533                                </xsd:simpleType> 
    534534                        </xsd:attribute> 
    535                         <xsd:attribute name="Mode"> 
     535                        <xsd:attribute name="Mode" use="optional"> 
    536536                                <xsd:simpleType> 
    537537                                        <xsd:restriction base="xsd:string"> 
    … …  
    554554                                </xsd:simpleType> 
    555555                        </xsd:attribute> 
    556                         <xsd:attribute name="ContrastMethod"> 
     556                        <xsd:attribute name="ContrastMethod" use="optional"> 
    557557                                <xsd:simpleType> 
    558558                                        <xsd:restriction base="xsd:string"> 
    … …  
    575575                </xsd:complexType> 
    576576        </xsd:element> 
    577         <xsd:element name="LogicalChannelRef"> 
     577        <xsd:element name="LogicalChannelRef"> <!-- top level definition --> 
    578578                <xsd:complexType> 
    579579                        <xsd:complexContent> 
    … …  
    584584                </xsd:complexType> 
    585585        </xsd:element> 
    586         <xsd:element name="DisplayOptions"> 
    587                 <xsd:annotation> 
    588                         <xsd:documentation> 
    589                                 There is optionally one of these per Image. 
     586        <xsd:element name="DisplayOptions"> <!-- top level definition --> 
     587                <xsd:annotation> 
     588                        <xsd:documentation> 
     589                                There is optionally one of these per Image. They provide support for the Origionam OME Perl server. 
    590590                                This specifies mapping of image channel components to RGB or greyscale colorspace with one byte per pixel per RGB channel. 
    591591                                RedChannel, GreenChannel, BlueChannel, and GreyChannel specify the scaling of pixel values to 8-bit colorspace values. 
    … …  
    596596                                The range of timepoints to display is specified by the TStart and TStop attributes. 
    597597                                The MIME type of the desired video format is specified by Movie's MIMEtype attribute. 
    598                                 The ROI element describes a 3-D region of interest.  It is up to the viewer to either display the ROI only, 
    599                                 or to simply mark it somehow. 
     598                                The ROI element originally describes a 3-D region of interest. It now use the new ROI  
     599                                model. It is up to the loader to convert the new ROI structure to the old format if  
     600                                it is required.  It is up to the viewer to either display the ROI only, or to simply 
     601                                mark it somehow. 
    600602                        </xsd:documentation> 
    601603                </xsd:annotation> 
    602604                <xsd:complexType> 
    603605                        <xsd:sequence> 
    604                                 <xsd:element ref="RedChannel"/> 
    605                                 <xsd:element ref="GreenChannel"/> 
    606                                 <xsd:element ref="BlueChannel"/> 
    607                                 <xsd:element ref="GreyChannel"/> 
    608                                 <xsd:element ref="Projection" minOccurs="0"/> 
    609                                 <xsd:element ref="Time" minOccurs="0"/> 
     606                                <xsd:element ref="RedChannel" minOccurs="1" maxOccurs="1"/> 
     607                                <xsd:element ref="GreenChannel" minOccurs="1" maxOccurs="1"/> 
     608                                <xsd:element ref="BlueChannel" minOccurs="1" maxOccurs="1"/> 
     609                                <xsd:element ref="GreyChannel" minOccurs="1" maxOccurs="1"/> 
     610                                <xsd:element ref="Projection" minOccurs="0" maxOccurs="1"/> 
     611                                <xsd:element ref="Time" minOccurs="0" maxOccurs="1"/> 
    610612                                <xsd:element ref="ROI" minOccurs="0" maxOccurs="unbounded"/> 
    611613                        </xsd:sequence> 
    … …  
    625627                </xsd:complexType> 
    626628        </xsd:element> 
    627         <xsd:element name="RedChannel" type="ChannelSpecType"> 
     629        <xsd:element name="RedChannel" type="ChannelSpecType"> <!-- top level definition --> 
    628630                <xsd:annotation> 
    629631                        <xsd:documentation> 
    … …  
    634636                </xsd:annotation> 
    635637        </xsd:element> 
    636         <xsd:element name="GreenChannel" type="ChannelSpecType"> 
     638        <xsd:element name="GreenChannel" type="ChannelSpecType"> <!-- top level definition --> 
    637639                <xsd:annotation> 
    638640                        <xsd:documentation> 
    … …  
    643645                </xsd:annotation> 
    644646        </xsd:element> 
    645         <xsd:element name="BlueChannel" type="ChannelSpecType"> 
     647        <xsd:element name="BlueChannel" type="ChannelSpecType"> <!-- top level definition --> 
    646648                <xsd:annotation> 
    647649                        <xsd:documentation> 
    … …  
    652654                </xsd:annotation> 
    653655        </xsd:element> 
    654         <xsd:element name="GreyChannel"> 
     656        <xsd:element name="GreyChannel"> <!-- top level definition --> 
    655657                <xsd:annotation> 
    656658                        <xsd:documentation> 
    … …  
    677679                </xsd:complexType> 
    678680        </xsd:element> 
    679         <xsd:element name="Projection"> 
     681        <xsd:element name="Projection"> <!-- top level definition --> 
    680682                <xsd:annotation> 
    681683                        <xsd:documentation> 
    … …  
    690692                </xsd:complexType> 
    691693        </xsd:element> 
    692         <xsd:element name="Time"> 
     694        <xsd:element name="Time"> <!-- top level definition --> 
    693695                <xsd:annotation> 
    694696                        <xsd:documentation> 
    … …  
    705707                </xsd:complexType> 
    706708        </xsd:element> 
    707         <xsd:element name="Instrument"> 
     709        <xsd:element name="Instrument"> <!-- top level definition --> 
    708710                <xsd:annotation> 
    709711                        <xsd:documentation> 
    … …  
    725727                <xsd:complexType> 
    726728                        <xsd:sequence> 
    727                                 <xsd:element ref="Microscope"/> 
     729                                <xsd:element ref="Microscope" minOccurs="1" maxOccurs="1"/> 
    728730                                <xsd:element ref="LightSource" minOccurs="0" maxOccurs="unbounded"/> 
    729731                                <xsd:element ref="Detector" minOccurs="0" maxOccurs="unbounded"/> 
    … …  
    737739                </xsd:complexType> 
    738740        </xsd:element> 
    739         <xsd:element name="StageLabel"> 
     741        <xsd:element name="StageLabel"> <!-- top level definition --> 
    740742                <xsd:annotation> 
    741743                        <xsd:documentation> 
    … …  
    750752                </xsd:complexType> 
    751753        </xsd:element> 
    752         <xsd:element name="Experimenter"> 
     754        <xsd:element name="Experimenter"> <!-- top level definition --> 
    753755                <xsd:annotation> 
    754756                        <xsd:documentation> 
    … …  
    761763                <xsd:complexType> 
    762764                        <xsd:sequence> 
    763                                 <xsd:choice> 
     765                                <xsd:choice minOccurs="1" maxOccurs="1"> 
    764766                                        <xsd:annotation> 
    765767                                                <xsd:documentation> 
    … …  
    777779                                                <xsd:element ref="LastName" minOccurs="1" maxOccurs="1"/> 
    778780                                                <xsd:element ref="Email" minOccurs="0" maxOccurs="1"/> 
    779                                                 <xsd:element ref="Institution" minOccurs="0"/> 
     781                                                <xsd:element ref="Institution" minOccurs="0" maxOccurs="1"/> 
    780782                                                <xsd:element ref="OMEName" minOccurs="0" maxOccurs="1"/> 
    781783                                        </xsd:sequence> 
    … …  
    795797                </xsd:complexType> 
    796798        </xsd:element> 
    797         <xsd:element name="OMEName" type="xsd:string"> 
     799        <xsd:element name="OMEName" type="xsd:string"> <!-- top level definition --> 
    798800                <xsd:annotation> 
    799801                        <xsd:documentation>This is the username of the experimenter (in a 'unix' or 'database' sense).</xsd:documentation> 
    800802                </xsd:annotation> 
    801803        </xsd:element> 
    802         <xsd:element name="FirstName" type="xsd:string"> 
     804        <xsd:element name="FirstName" type="xsd:string"> <!-- top level definition --> 
    803805                <xsd:annotation> 
    804806                        <xsd:documentation>First name, optionally containing a middle initial.</xsd:documentation> 
    805807                </xsd:annotation> 
    806808        </xsd:element> 
    807         <xsd:element name="LastName" type="xsd:string"> 
     809        <xsd:element name="LastName" type="xsd:string"> <!-- top level definition --> 
    808810                <xsd:annotation> 
    809811                        <xsd:documentation>A person's last or surname.</xsd:documentation> 
    810812                </xsd:annotation> 
    811813        </xsd:element>