This is the xml schema for image capture performance data, developed by The National Library of Sweden, used for inhouse digitization projects.
Reference to the latest version of xml schema:
schemaLocation="http://www.kb.se/namespace/image_capture_performance/icp_v1.xsd"
Recommended prefix for kb.se/ns/image_capture_performance: icp
Current version: 1.3.1 (2014-06-03)
Version history:
In version 1.3.1 to support older versions of Xerces the datatype of the @nameOfTarget attribute has been set to the same datatyp as the key. I also refactored out a type to represent nameOfTarget attribute
used for references to reduce code duplication (tns:nameOfTargetRefType).
In version 1.3, further changes has been made to allow for the use of multiple targets within a tns:imageData-element:
Changed the name of tns:imageData/tns:patchMeasurements to tns:imageData/tns:colorExposureMeasurements
Moved tns:imageData/tns:aggreagteMeasurements to tns:imageData/tns:colorExposureMeasurements
Removed attribute and key @nameOfTarget from tns:imageData/tns:colorExposureMeasurements/tns:aggreagteMeasurements
Moved tns:imageData/tns:periodicMeasurements, tns:imageData/tns:illuminationUniformity and tns:imageData/tns:opticalResolution the new element tns:imageData/tns:generalMeasurements. Updated relevant keys.
Moved tns:imageData/tns:patchMeasurements/Patch/center to tns:imageData/tns:generalInformation/targetData/center.
Added attribute @patchID to tns:imageData/tns:generalInformation/targetData/center
Added key to tns:imageData/tns:generalInformation/targetData/center/@patchID and reference to this key from tns:imageData/tns:patchMeasurements/Patch/@patchID
Moved tns:imageData/tns:aggregateMeasurements/resolution to tns:imageData/tns:generalInformation/opticalResolution
Expanded the information contained in tns:imageData/tns:generalInformation/opticalResolution. Attribute and key @nameOfTarget should correspond to tns:qualityData/tns:targetData/@nameOfTarget
Removed tns:imageData/tns:aggregateMeasurements/lengthOfTarget due to redundancy
Renamed tns:colorExposureMeasurements/tns:patch to tns:colorExposureMeasurements/tns:patchMeasurements
Updated constraints for the imageData element to support the new structure
Moved resolution from aggregateMeasurements to generalMeasurements
Renamed targetType to targetModel
Added element targetDescription under tns:qualityData/tns:targetData
Replaced tns:aggregateMeasurements/noise with new element tns:generalMeasurements/Tns:noise Added keys and constraints for @nameOfTarget and @patchID
Some cardinality fixes
In version 1.2, the following changed has been made to allow for the use of multiple targets within a tns:imageData-element: Added attribute nameOfTarget to tns:imageData/tns:generalInformation/tns:illuminationUniformity
tns:imageData/tns:generalInformation/tns:periodicMeasurement
tns:imageData/tns:patchMeasurements
tns:imageData/tns:aggregateMeasurements;
Renamed global target key “targetNameKey” to “targetDataKey”; Added a key in tns:imageData to make ./tns:generalINformation/@nameOfTarget unique within a tns:imageData element; Added reference to the afore mentioned @nameOfTarget-key in tns:imageData/tns:generalInformation/tns:illuminationUniformity tns:imageData/tns:generalInformation/tns:periodicMeasurement
tns:imageData/tns:patchMeasurements
tns:imageData/tns:aggregateMeasurements
In version 1.1, the following changes has been made: Elements deltaL, deltaC, meanDeltaL and meanDeltaC are made optional (set to minOccurs="0"); correction of misspelled dateOfIlluminationMeasurement
Image quality data for all files contained in this
package
Uniquely identifies an imageData element by equipmentName
captureDate and captureNumber attribute of the imageData element
Constraint that makes sure that the mix of the attributes
equipmentName, targetCaptureDate and captureNumber for the file element matches a present
captureKey in the document
Unique identifier for qualityLevelName
Constraint that makes sure that the qualityLevelName
element value is one of the qualityLevelNameKeys in the document.
Uniqe key for targetData in qualityData
Key reference to qualityData/targetData
Coordinates for one corner of the target. Assumes a
rectangular target. Only used when the target image is stored.
Image quality measurements for a single patch. At least
twelve patches must be measured in Digidaily, six color patches and six grayscale
patches.
Parent element for all aggregate
measurements.
Name of the used quality level. Allowed characters: a-z,
A-Z, 0-9 and ._%+-
Flag that denotes if the image has been manually checked
(1/true = checked). This check is only performed if the selection batch fails the
statistical IQ-control.
Stores whether the file was selected for statistical
control and the result from such a control. Data coded as an ínt. Possible to extend the
codes if necessary. -1 = not selected 0 = selected, failed the control 1 = selected,
passed the control.
Name of an image file that depicts the current object
and/or the target. Allowed characters: a-z, A-Z, 0-9 and ._%+-
Internal name of the tsrget Allowed characters: a-z, A-Z,
0-9 and ._%+-
Optional. Only used when the equipment produce several
images (front/back etc.) and it's possible to distinguish between them. Corresponds to the
attributes with the same name under captureData Allowed characters: a-z, A-Z, 0-9 and
._%+-
Date of capture for the image that contains the target used
for the IQ measurements.
Sequence number/identifier for the image quality
measurement. Allowed characters: a-z, A-Z, 0-9 and ._%+-
Images files for which the included IQ data is
valid
The model name of the image capture equipment. Allowed
characters: a-z, A-Z, 0-9 and ._%+-
Parent element for the color values
The color accuracy.
The exposure accuracy.
Color cast.
ID of the current patch. Matched against the ID of the
real-world patch, as found in the corresponding attribute under targetData/colorValues.
Allowed values: 1 or higher
Metadata about the current capture and the used targets
Parent element for the exposure and color accuracy measurements..
Image quality measurements other than exposure and color accuarcy, generally with a time frame of validity that is longer than a single day
Internal name of the image capture equipment. Allowed
characters: a-z, A-Z, 0-9 and ._%+-
Date of capture for the image(s) used for image quality
measurements.
Identifier for the combination of equipment and an image
that contains the target. Naming convension: front, back, left, right, middle, single etc.
An identical attribute is used for the element captureEquipment. Allowed characters: a-z,
A-Z, 0-9 and ._%+-
Sequence number/identifier for the image quality
measurement. The number is specific for each eqipment and it is reset daily. Included
since we might want to perform several IQ measurements during a single day and we must be
able to distinguish between them. Datatype is set to string to give the largest possible
flexibility for the sequence numbering. Ordinary numbers are prefered. Allowed characters:
a-z, A-Z, 0-9 and ._%+-
One or both element must exist
One or both element must exist
An issue/object can contain images that has been captured with several different equipments. Each instance of the imageData element contains image quality data for a single image capture equipment. The image quality data is valid during a limited period of time, usually one day. Hence, the same piece of equipment can appear in several instances if it has been used on multiple occasions that involves a time span that is longer than the period of validity.
For measurements that are valid for longer time frames, i.e. illumination uniformity, the measurement data are appended to the imageData element that contains the exposure and color accuracy measurements. This data cannot be stored separate instances of the element, as exposure and color accuracy data might not be obtainable in the illumination uniformity and noise measurements.
Some scanners can simultaneously produce multiple images, generally of both sides of an object (front/back/left/right). For a number of scanners, it's impossible to identify if an image depicts the front or back side of an object. As a result, we cannot tie these images to a specific sensor (or sensors, if the image is stitched).
Within an imageData the generalInformation/targetData/@nameOfTarget must be unique. This key is referenced by other elements under the same imageData element.
Reference data for the quality
measurements
Date when the package was created. Initally set to
optional
Color accuracy. The maximum value for all applicable
patches.
Color accuracy. The average value, computed using all
applicable patches.
Exposure correctness. The maximum value for all
applicable patches.
Exposure correctness. The average value, computed using
all applicable patches.
Color cast. The maximum value for all applicable
patches.
Color cast. The average value, computed using all
applicable patches.
Data for the image quality metric gain modulation
(tonseparation in Swedish). The name of each child element contains the approximate
luminosity value of the two patches used for the measurement. Not all elements has to be
used. Generally, measurements for one small intervall and one large intervall should be
performed.
Definition of the quality level(s) used for the image
quality measurements
Data about the real-world references/targets used for the
quality measurements. Multiple elements are allowed since multiple targets might have
been used for the qaulity measurements. Always store for reference, although some data
is only useful when we also store the images that contain the
targets.
Batch data related to the issue and the statistical
quality control. See related documentation for more information
The date when this quality level was adapted and/or
changed.
The maximum allowed average value of deltaE (color
accuracy) that is allowed, computed from all valid patches. Only measured on color
patches
The maximum allowed deltaE value (color accuracy) for a
single patch. Only measured on color patches
The maximum allowed average value of deltaL (exposure)
that is allowed, computed from all valid patches. Measured on all patches, both color
and greyscale
The maximum allowed deltaL value (exposure) for a single
patch. Measured on all patches, both color and greyscale
The maximum allowed average value of deltaC (color cast)
that is allowed, computed from all valid patches. Measured only on greyscale
patches
The maximum allowed deltaL (color cast) value for a
single patch.Measured on greyscale patches
Maximum allowed illumination difference between the
center and the corners. For A1 or larger formats
Maximum allowed illumination difference between the
center and the corners. For A2
Maximum allowed illumination difference between the
center and the corners. For A3 or smaller formats
The lowest allowed resolution of the image. The
resolution must be computed, the nominal resolution of the equipment is not
allowed.
Meaurement of the sharpness. Details to be decided, not
yet included in the quality levels.
Minimum allowed gain modulation (tonseparation) for this
range. This is a composite entry for L*95-L*90 and L*90-L*85. The two metrics are not
intended to be used at the same time.
Maximum allowed gain modulation (tonseparation) for this
range. This is a composite entry for L*95-L*90 and L*90-L*85. The two metrics are not
intended to be used at the same time.
Minimum allowed gain modulation (tonseparation) for this
range. This is a composite entry for the following ranges: L*95-L*85, L*95-L*80,
L*90-L*80. Only a single metrics is intened to be used at a measurement time.
Maximum allowed gain modulation (tonseparation) for this
range. This is a composite entry for the following ranges: L*95-L*85, L*95-L*80,
L*90-L*80. Only a single metrics is intened to be used at a measurement time.
Minimum allowed gain modulation (tonseparation) for this
range.
Maximum allowed gain modulation (tonseparation) for this
range.
Minimum allowed gain modulation (tonseparation) for this
range.
Maximum allowed gain modulation (tonseparation) for this
range.
The name of the qualityLevel. Allowed characters: a-z, A-Z,
0-9 and ._%+-
The id for the batch that the issue belongs to. OBS.
Vilken datatyp ska det vara?
The ID for the selection batch that contains the
batchID
Model of the physical target, e.g. Colorchecker SG.
Allowed characters: a-z, A-Z, 0-9 and ._%+-
Free-text element mainly used to describe a non-standard target, i.e. a home-made target for resolution measurements.
The number of patches that is used for the measurements.
Not necessary equal to the number of patches on the target. Set to twelve or higher (for
Digidaily), six color patches and six grayscale patches
The number of days since the real-world target was
measured
The color values of the patches. At least twelve patches
must be specified (six color patches and six grayscale) for exposure and color accuracy targets.
Must exist a nameOfTarget element with the same contents
under generalInformation. Allowed characters: a-z, A-Z, 0-9 and ._%+-
Date when the target's real-world color values was
measured
Element for storage of a numeric value from the
measurement
Element for storage of a string that represents the result of
the measurement. Allowed characters: a-z, A-Z, 0-9 and ._%+-
Date of the periodic measurement
Number of days since the measurement was
performed
At least one or both of resultString and resultNumeric is
needed.
Type of measurement, e.g. sharpness, stitching etc. Allowed
characters: a-z, A-Z, 0-9 and ._%+-
Allowed values 0 to 100.
Allowed values -100 to 100.
Allowed values -100 to 100.
ID of the patch. Corresponds to the patchID-attribute under
patchMeasurements. Allowed values: 1 or higher
The measured illumination uniformity for the size of
the real-world object, in deltaL. The element that is closest to the real-world size
of the object must be created. The other elements are optional.
Datetime of the last illumination
measurement
Days since the last illumination uniformity
measurement
The target model that was employed, e.g. ColorChecker SG. Allowed characters:
a-z, A-Z, 0-9 and ._%+-
Date of the capture of the image that contains the
target.
The number of patches that is used for the measurements.
Not necessary equal to the number of patches on the target. Mininum number of patches in
Digidaily is twelve (six color patches and six grayscale patches)
Date when the image quality measurements for this target were performed
The size of the area that was used for image quality
measurements, in pixels. E.g. 10x10.
Indicates if the target's orientation with regard to the
contents in the image. 0/false corresponds to the target being upsidedown with regard to
the main content in the image. 1/true is the opposite. Only used when the target image
is stored.
The target's coordinates in the reference image. Only
included when we store the image that contains the target.
Coordinates for the center of the patch. Only used when
the reference image, that contains the target, is saved.
ID of the current patch. Matched against the ID of the
real-world patch, as found in the corresponding attribute under targetData/colorValues.
Allowed values: 1 or higher
Date when the target's real-world color values was
measured
This is a composite entry for the following ranges: L*95-L*85, L*95-L*80, L*90-L*80. Only a single metric is intened to be used at measurement time
The actual interval/separation that was used for the measurement. L*95-L*80,L*95-L*80, or L*90-L*80 is the target, but the target patches might result in a slightly different interval.
This is a composite entry for L*95-L*90 and L*90-L*85. The two metrics are not intended to be used at the same time.
The actual interval/separation that was used for the measurement. L*95-L*90 or L*90-L*85 is the target, but the target patches might result in a slightly different interval.
The actual interval/separation that was used for the measurement. L85-L*20 is the target, but the target patches might result in a slightly different interval.
The actual interval/separation that was used for the measurement. L*85-L*10 is the target, but the target patches might result in a slightly different interval.
Datetime of the last optical resolution measurement
Days since the last measurement of opticalResolution measurement
The measured optical resolution for the captured image, measured in ppi. The nominal resolution is not allowed in this element.
The difference in illumination, measured between the
image corners and the center. Measured in deltaL. A result might be included for all
possible object sizes or onxsly for element that corresponds to the size of the current
object
Generic complex type for periodic measurement, e.g.
sharpness, stitching.
The computed resolution for the captured image, measured in ppi. The nominal resolution is not allowed in this element.
The optical resolution of the image.
Noise is computed as the standard deviation in the Y-channel
Measured noise for individual patches
The maximum noise value
Must exist a nameOfTarget element with the same contents
under generalInformation. Allowed characters: a-z, A-Z, 0-9 and ._%+-