Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
Open Microscopy Environment
OME XML Schema 1.0 RC5
Author: Ilya G. Goldberg
Copyright (C) 2002-2011 Open Microscopy Environment
The OME element must contain one or more Image and one or more Experimenter elements.
All other elements are optional.
This element describes the actual image and its meta-data.
The elements that are references (ending in Ref) refer to elements defined outside of the Image element.
If any of the required Image attributes are missing, its guaranteed to be an invalid document.
The only required elements are the CreationDate and Data.
The Image may also contain optional elements containing vendor-specific data (#wildCard element in the diagram).
There are also provisions to include vendor-specific data on a per-wavelength, per-timepoint, per-plane or per-XYZ stack.
The GUID is a globally unique identifier assigned by OME.
ImageType is a vendor-specific designation of the type of image this is.
Examples of ImageType include 'STK', 'SoftWorx', etc.
The Name attributes are in all cases the name of the element instance. In this case, the name of the image,
not necessarily the filename.
PixelSize* is in microns.
TimeIncrement is used for time series that have a global timing specification instead of per-timepoint timing info.
For example in a video stream. The unit is seconds.
Similarly, WaveStart and WaveIncrement are used in spectral images like FTIR. These are both positive integers.
The creation date of the Image - when the Image was acquired.
The element contains a string in the dateTime format (i.e. 1988-04-07T18:39:09)
The Image will be unreadable if any attributes are missing.
The Pixels may be stored externally or internally.
DimensionOrder is a string enumeration which must be set to 'XYZCT', 'XYZTC', 'XYCTZ', 'XYCZT', 'XYTCZ', or 'XYTZC'.
BitsPerPixel is an integer enumeration and must be set to 1, 8 or 16.
BigEndian is a boolean ('true' or 'false'). True for essentially all CPUs other than Intel.
This element describes the type of experiment. The required Type attribute must contain one or more entries from the following list:
FP FRET Time-lapse 4-D+ Screen Immunocytochemistry FISH Electrophysiology Ion-Imaging Colocalization PGI/Documentation
FRAP Photoablation Optical-Trapping Photoactivation Fluorescence-Lifetime Other
FP refers to fluorescent proteins, PGI/Docuemntation is not a 'data' image.
The optional Description element may contain free text to further describe the experiment.
Excitation wavelength in nm.
There must be one per channel in the Image, even for a single-plane image.
Either the Fluor or the excitation and emission wavelengths (in nm) or both must be specified.
Currently, these are all optional, which is an incorrect schema specification (FIXME?).
Either ChannelInfo element or the WaveStart and WaveIncrement Image attributes must be used.
This is also not correctly specified in the schema (FIXME?).
The optional FilterID, LightSourceID, CameraID and OTFID attributes refer to a Filter, LightSource Camera and OTF
elements defined within the Instrument element.
There is optionally one of these per Image.
This specifies mapping of image wavelengths to RGB or greyscale colorspace with one byte per pixel per RGB channel.
Elements of type ChannelScaleType specify the scaling of pixel values (up to 16 bit) to colorspace values (8 bit).
These elements have three required attributes: the ChannelNumber, BlackLevel, and WhiteLevel.
The fourth Gamma attribute is optional.
The ChannelNumber specifies the wave number in the pixel dump. Channels are numbered from 0.
Pixel values between BlackLevel and WhiteLevel will be assigned values 0-255, respectively.
Values below BlackLevel or above WhiteLevel will be assigned 0 and 255 respectively.
Either the GreyChannel or one or more of RedChannel, GreenChannel, BlueChannel must be specified.
The Projection element specifies that the display is a maximum intensity projection.
The range of Z-sections for the projection is specified with the Zstart and Zstop attributes.
Presence of the Movie element indicates that the display should be a movie.
The range of timepoints to display in the movie is specified by the Tstart and Tstop attributes.
The MIME type of the desired video format is specified by Movie's MIMEtype attribute.
The ROI element describes a 3-D region of interest. It is up to the viewer to either display the ROI only,
or to simply mark it somehow.
The wave number, black level, white level and optional gamma for the red channel of an RGB image.
The wave number, black level, white level and optional gamma for the green channel of an RGB image.
The wave number, black level, white level and optional gamma for the blue channel of an RGB image.
The wave number, black level, white level and optional gamma for a greyscale image.
The GreyChannel element may contain an optional ColorMap attribute, which can be set to ''
The presence of this element indicates the user wants to view the Image as a maximum intensity projection.
The Zstart and Zstop attributes are optional. If they are not specified, then the entire Z stack will be projected.
The time range the user is interested in the initial viewer display. A range of timepoints indicates a movie
If they are not specified, the movie is to include all timepoints.
If the Time attributes point to a single time-point, that is the timepoint to be initially displayed.
If the entire element is missing, the first time-point will be displayed
This element describes the instrument used to capture the Image.
It is primarily a container for manufacturer's model and catalog numbers for the
Microscope, LightSource, Camera, Objective and Filters components.
Additionally, one or more OTF elements may be specified, describing the optical transfer function under different conditions.
The Objective element contains the additional elements LensNA and Magnification.
The Filters element can be composed either of separate excitation, emission filters and a dichroic mirror
or a single filter set.
The OTF element contains an optical transfer function.
The same OTF can be used for all wavelengths, or there may be one per wavelength.
There may be multiple light sources, cameras and filters on a microscope.
Each of these has their own ID attribute, which can be referred to from ChannelInfo.
It is understood that the light path configuration can be different for each wavelength,
but cannot be different for each timepoint or each plane of an XYZ stack.
The StageLabel is used to specify a name and position for a stage position in the microscope's reference frame.
The PlateInfo element associates the image with a microtiter plate.
This element must contain a Well element to specify what well this image belongs to.
When several images are acquired within a single well, they are differentiated by using the optional Sample element.
The ExperimenterID attribute is required, and the presence of at least one Experimenter element is required within OME.
The required elements are the same as for the ContactInfo type, but include the OMEname element,
which is the experimenters login or username in OME.
Interestingly, Experimenters don't have a group affiliation.\
This is because this is an image-centric document, so the image itself is affiliated with an experimenter and a group.
We can infer that at the time of acquisition, the experimenter who acquired the image belonged to that group,
but that may no longer be the case.
This is the username of the experimenter (in a 'unix' or 'database' sense).First name, optionally containing a middle initial.A person's last or surname.A person's email address.
The Screen element is a grouping for Plates.
The required attribute is the Screen's Name and ID - both must be unique within the document.
The Screen element may contain an ExternalRef attribute that refers to an external database.
A description of the screen may be specified in the Description element.
Screens may contain overlapping sets of Plates i.e. Screens and Plates have a many-to-many relationship.
Plates contain one or more ScreenRef elements to specify what screens they belong to.
The ScreenRef element is a reference to a Screen element.
Plate elements may have one or more ScreenRef elements to define the screen that a plate belongs to.
Plates may belong to more than one screen.
This element identifies microtiter plates within a screen.
A plate can belong to more than one screen.
The Screen(s) that a plate belongs to are specified by the ScreenRef element.
The EternRef attribute may contain a reference to an external database.
The PlateID and Name attributes are required.
The Name identifies the plate to the user. It is used much like the PlateID, and so must be unique within the document.
This is a sample number within a well.
It has an optional ExternRef attribute which may specify a link to an external database.
Standard well designation (A12, B01, etc) goes in the Address attribute.
This attribute is checked against the regular expression '^[A-Z]+[0-9]+$'.
The contents of this element may contain descriptive information.
A description of the microscope's objective lens.
Required tags include the lens numerical aperture, and the magnification, both of which a floating point (real) numbers.
Filters may be separate excitation dichroic mirror and emission filters specified by the
ExFilter, Dichroic and EmFilter tags respectively.
Alternatively all three components may be specified by a single filter set.
There should be one filter element specified per wavelength in the image.
The wave number associated with a filter set is specified in ChannelInfo's required ChannelNumber attribute.
All elements are FilterSpec type, so they have the required attributes Manufacturer, Model, and LotNumber.
The ExFilter an EmFilter elements may also contain a Type attribute which may be set to
'LongPass', 'ShortPass', 'BandPass', or 'MultiPass'.
The magnification of the lens - i.e. '60.0' is a 60X lens.The numerical aperture of the lens expressed as a floating point (real) number.
Excitation filter manufacturer specification.
The optional Type attribute may contain 'LongPass', 'ShortPass', 'BandPass', or 'MultiPass'.
Emission filter manufacturer specification.
The optional Type attribute may contain 'LongPass', 'ShortPass', 'BandPass', or 'MultiPass'.
Filter set manufacturer specification
The type of detector used to capture the image.
The DetectorID can be used as a reference within the ChannelInfo element in the Image element.
The Type attribute can be set to 'CCD', 'Intensified-CCD', 'PMT', etc.
Just some free-form text to describe Images, Screens and Projects.
The content model is ANY, which means that en entire XML sub-document can be placed here.
The microscope's manufacturer specification.
The thumbnail may be an external URI reference specified by the href attribute, or it may contain an SVG sub-document
(denoted by the #wildCard 'element').
The MIMEtype is a required attribute, and must be set to 'SVG' if the tag's contents are an SVG document.
The ProjectID and Name attributes are required.
Datasets can be grouped into projects using a many-to-many relationship.
A Dataset may belong to one or more Projects by including one or more ProjectRef elements which refer to ProjectIDs.
Projects do not directly contain images - only by virtue of containing datasets, which themselves contain images.
There may be one or more of these in a Dataset.
This empty element has a required ProjectID attribute that refers to Projects defined within the OME element.
This empty element has a required ExperimenterID attribute which refers to one of the Experimenters defined within OME.
The GroupID and Name attributes are required.
Contact information should be specified for the leader of the group and a contact person.
The Leader and/or Contact may themselves be experimenters defined in OME,
in which case they can refer to Experimenters defined within OME using their ExperimenterRef elements.
Contact information for a Group leader.
The contact info may be specified within this element using FirstName, LastName, email and Institution elements,
or the contact information may be specified using the ExperimenterRef element if the group leader is defined as an Experimenter.
An element type to specify an Experimenter under OME.
It consists of a Person element group and a login name specified under OMEname.
The Contact element describes the contact person for a group of experimenters - typically a project leader or lab manager.
This person may be specified as a reference to an OME experimenter, or the full contact information can be specified
within the element using the FIrstName, LastName, email and Institution elements.
This empty element has a reference (the GroupID attribute) to a Group defined within OME.An element type to specify a group of people.
This is an element type to describe contact information for a person.
The person may be an OME Experimenter, in which case the element contains an ExperimenterRef element only,
or if the contact is not an OME experimenter, the contact information can be described within the element using the
FirstName, LastName, email and Institution elements (the Person element group).
This empty element can be used (via the required InstrumentID attribute) to refer to an Instrument defined within OME.
The organizing structure that people belong to other than groups. A university, or company, etc.
We do not specify people belonging to groups.
While Images belong to a person and a group, the relationship between people and groups is not up to OME.
We do not specify a department element, and do not mean for Institution to be used in this way.
We simply wish to say XXX at YYY. Where YYY has a better chance of being tied to a geographically fixed location
and of being more recognizable than a group of experimenters.
The dichroic mirror used for this filter combination.
A three dimensional 'Region of Interest'. The Z coordinates are optional.
If they are not used, and the Image has more than one plane,
the entire set of planes is assumed to be included in the ROI.
Multiple ROIs may be specified - these are meant to be displayed somehow.
An element type specifying a filter specification.
Unlike the ManufactSpec, filters are referred to by lot number rather than serial number.
The lightsource for the instrument. An instrument may have several light sources.
The type of lightsource is specified by one of the child-elements which are 'Laser', 'Filament' or 'Arc'.
Each of the light source types has its own Type attribute to further differentiate the light source
(eg, Nd-YAG for Laser or Hg for Arc).
A LightSourceID must be specified for each light source,
and the individual light sources can be referred to by their LightSourceIDs (eg from ChannelInfo).
The optical transfer function. FilterID refers to the set of filters used in computing the OTF.
BitsPerPixel is an integer '1', '8', '16'.
The OpticalAxisAvg is a boolean specifying wether or not optical axis averaging was done.
SizeX, SizeY specify the width and height of the OTF.
This element must contain either an External element or a BinData element.
Both of these work the same way as they do for the Data element within Image.
An element specifying a collection of images that are always processed together.
Images can belong to more than one Dataset, and a Dataset may contain more than one Image.
Images contain one or more DatasetRef elements to specify what datasets they belong to.
Once a Dataset has been processed in any way, its collection of images cannot be altered.
Wether or not the list of Images in this dataset can be altered is specified by the Locked attribute.
The ExperimenterRef and GroupRef elements specify the person and group this Dataset belongs to.
Projects may contain one or more Datasets, and Datasets may belong to one or more Projects.
This relationship is specified by listing ProjectRef elements within the Dataset element.
The DatasetRef element refers to a Dataset by specifying the DatasetID attribute.
One or more DatasetRef elements may be listed within the Image element to specify what Datasets
the Image belongs to.
This element allows the grouping of several OME XML documents into one group.
This is useful for specifying many documents and Images belonging to a single Screen, or Project or Dataset.
All of the element IDs (i.e. ProjectID, InstrumentID, ExperimenterID, etc) become valid across the entire document group,
meaning references are valid across documents, and not only within a document. This also means that the element IDs
must be unique across the entire group, and not only within a single document.
The documents in the group are specified using one or more DocumentRef elements.
Each of the documents in the group must have the same documents listed in their respective DocumentGroup element.
It is not necessary (or even possible, due to the SHA1 attribute) to make self-references in this list.
The DocumentRef element refers to an external OME XML document using the href and SHA1 attributes.Any custom image attributes belong here. Data definitions for these attributes belong in DataDefinitions. Custom Attributes are stored in a record based format where one element corresponds to one record. Attributes of an element correspond to fields of the record.The Temperature is in Celsius, AirPressure is in millibars, Humidity and CO2Percent are percent-fractions from 0.0 to 1.0.Specifies which component of Photometric Interpretation to map a channel component to. i.e. w/ RGB this could be 'R', 'G', 'B'
This can be null if a channel maps to a logical channel but is not included in the photometric interpretation. If this was null then the channel specified would normally be ignored.
Replaces ChannelNumber in ChannelInfo
