001/*
002 *    GeoAPI - Java interfaces for OGC/ISO standards
003 *    Copyright © 2004-2023 Open Geospatial Consortium, Inc.
004 *    http://www.geoapi.org
005 *
006 *    Licensed under the Apache License, Version 2.0 (the "License");
007 *    you may not use this file except in compliance with the License.
008 *    You may obtain a copy of the License at
009 *
010 *        http://www.apache.org/licenses/LICENSE-2.0
011 *
012 *    Unless required by applicable law or agreed to in writing, software
013 *    distributed under the License is distributed on an "AS IS" BASIS,
014 *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
015 *    See the License for the specific language governing permissions and
016 *    limitations under the License.
017 */
018package org.opengis.metadata.quality;
019
020import javax.measure.Quantity;
021import org.opengis.annotation.UML;
022
023import static org.opengis.annotation.Specification.*;
024
025
026/**
027 * Correctness of the temporal references of an item (reporting of error in time measurement).
028 *
029 * <h2>Standardized values</h2>
030 * In order to achieve well defined and comparable quality information, it is recommended to
031 * report data quality using {@linkplain Measure quality measures} listed in ISO 19157 annex.
032 * The following table provides a summary adapted to GeoAPI objects;
033 * see ISO 19157 for more complete descriptions and formulas.
034 * All identifiers should be in "ISO 19157" namespace.
035 *
036 * <table class="ogc">
037 *   <caption>Standardized values derived from ISO 19157</caption>
038 *   <tr>
039 *     <th>{@linkplain MeasureReference#getMeasureIdentification() Identifier}</th>
040 *     <th>{@linkplain MeasureReference#getNamesOfMeasure() Name of measure}</th>
041 *     <th>{@linkplain Measure#getBasicMeasure() Basic measure}</th>
042 *     <th>{@linkplain Measure#getValueType() Value type}</th>
043 *   </tr><tr>
044 *     <td>54</td>
045 *     <td>time accuracy at 68.3% significance level</td>
046 *     <td>LE68.3 or LE68.3(r)</td>
047 *     <td>{@link Quantity}</td>
048 *   </tr><tr>
049 *     <td>55</td>
050 *     <td>time accuracy at 50% significance level</td>
051 *     <td>LE50 or LE50(r)</td>
052 *     <td>{@link Quantity}</td>
053 *   </tr><tr>
054 *     <td>56</td>
055 *     <td>time accuracy at 90% significance level</td>
056 *     <td>LE90 or LE90(r)</td>
057 *     <td>{@link Quantity}</td>
058 *   </tr><tr>
059 *     <td>57</td>
060 *     <td>time accuracy at 95% significance level</td>
061 *     <td>LE95 or LE95(r)</td>
062 *     <td>{@link Quantity}</td>
063 *   </tr><tr>
064 *     <td>58</td>
065 *     <td>time accuracy at 99% significance level</td>
066 *     <td>LE99 or LE99(r)</td>
067 *     <td>{@link Quantity}</td>
068 *   </tr><tr>
069 *     <td>59</td>
070 *     <td>time accuracy at 99.8% significance level</td>
071 *     <td>LE99.8 or LE99.8(r)</td>
072 *     <td>{@link Quantity}</td>
073 *   </tr>
074 * </table>
075 *
076 * <p>{@linkplain Measure#getDefinition() Definitions}:</p>
077 * <ol start="54">
078 *   <li>Half length of the interval defined by an upper and a lower limit, in which the true value for the time instance lies with probability 68.3%.</li>
079 *   <li>Half length of the interval defined by an upper and a lower limit, in which the true value for the time instance lies with probability 50%.</li>
080 *   <li>Half length of the interval defined by an upper and a lower limit, in which the true value for the time instance lies with probability 90%.</li>
081 *   <li>Half length of the interval defined by an upper and a lower limit, in which the true value for the time instance lies with probability 95%.</li>
082 *   <li>Half length of the interval defined by an upper and a lower limit, in which the true value for the time instance lies with probability 99%.</li>
083 *   <li>Half length of the interval defined by an upper and a lower limit, in which the true value for the time instance lies with probability 99.8%.</li>
084 *   <li></li>
085 * </ol>
086 *
087 * @author  Martin Desruisseaux (IRD)
088 * @author  Alexis Gaillard (Geomatys)
089 * @version 3.1
090 * @since   2.0
091 */
092@UML(identifier="DQ_AccuracyOfATimeMeasurement", specification=ISO_19157)
093public interface AccuracyOfATimeMeasurement extends TemporalQuality, TemporalAccuracy {
094}