diff --git a/DataQualityAssessment/doc/spec_IT.md b/DataQualityAssessment/doc/spec_IT.md index 4209d92..2aab225 100644 --- a/DataQualityAssessment/doc/spec_IT.md +++ b/DataQualityAssessment/doc/spec_IT.md @@ -1,468 +1,492 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entità: DatiQualitàValutazione -============================== - - [Licenza aperta](https://github.com/smart-data-models//dataModel.DataQuality/blob/master/DataQualityAssessment/LICENSE.md) - [documento generato automaticamente](https://docs.google.com/presentation/d/e/2PACX-1vTs-Ng5dIAwkg91oTTUdt8ua7woBXhPnwavZ0FxgR8BsAI_Ek3C5q97Nd94HS8KhP-r_quD4H0fgyt3/pub?start=false&loop=false&delayms=3000#slide=id.gb715ace035_0_60) - - - Descrizione globale: **Questa entità descrive le proprietà di qualità dei dati di una misurazione, come la temperatura.** - versione: 0.0.2 - - - ## Elenco delle proprietà - [*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o diversi formati/modelli. -- `accuracy[number]`: L'accuratezza misura l'errore numerico sistematico massimo prodotto nella misurazione di un sensore. - `address[object]`: L'indirizzo postale . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Il paese. Ad esempio, la Spagna . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) - - `addressLocality[string]`: La località in cui si trova l'indirizzo civico e che si trova nella regione . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) - - `addressRegion[string]`: La regione in cui si trova la località, e che si trova nel paese . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) - - `district[string]`: Un distretto è un tipo di divisione amministrativa che, in alcuni paesi, è gestita dal governo locale. - - `postOfficeBoxNumber[string]`: Il numero di casella postale per gli indirizzi di casella postale. Ad esempio, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) - - `postalCode[string]`: Il codice postale. Ad esempio, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) - - `streetAddress[string]`: L'indirizzo stradale . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) -- `alternateName[string]`: Un nome alternativo per questa voce - `areaServed[string]`: L'area geografica in cui viene fornito il servizio o l'articolo offerto. . Model: [https://schema.org/Text](https://schema.org/Text) - `completeness[number]`: La completezza quantifica il numero di misurazioni o osservazioni mancate in una determinata finestra temporale. - `dataProvider[string]`: una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzata - `dateCalculated[date-time]`: Data dell'entità calcolata definita dall'utente - `dateCreated[date-time]`: Timestamp di creazione dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `description[string]`: Descrizione dell'articolo - `id[*]`: Identificatore univoco dell'entità - `location[*]`: Riferimento geojson all'elemento. Può essere un punto, una stringa di linea, un poligono, un multi-punto, una stringa di linea o un poligono multiplo. - `name[string]`: Il nome di questo elemento - `outlier[object]`: Include informazioni sulle caratteristiche di outlier della misura. - `isOutlier[boolean]`: Determinare se la misura è stata considerata un outlier o meno. -- `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `precision[number]`: La precisione misura la deviazione standard di un set di dati. In altre parole, misura quanto i valori del set di dati siano vicini l'uno all'altro. - `seeAlso[*]`: elenco di uri che puntano a risorse aggiuntive sull'elemento - `source[string]`: Una sequenza di caratteri che indica la fonte originale dei dati dell'entità come URL. Si consiglia di utilizzare il nome di dominio completamente qualificato del provider di origine o l'URL dell'oggetto di origine. - `synthetic[object]`: Include informazioni sull'origine della misura - `isSynthetic[boolean]`: Determinare se la misura è stata creata in modo sintetico o meno. -- `timeliness[number]`: Tempestività media del flusso di dati - `type[string]`: Tipo di entità NGSI. Deve essere DataQualityAssessment - - Proprietà richieste -- `id` - `type` - - - - ## Modello di dati descrizione delle proprietà - Ordinati in ordine alfabetico (clicca per i dettagli) - - -
full yaml details - ```yaml -DataQualityAssessment: - description: 'This entity describes the data quality properties of a measurement, such as temperature.' - properties: - accuracy: - description: Accuracy measures the maximum systematic numerical error produced in a sensor measurement - type: number - x-ngsi: - type: Property - address: - description: The mailing address - properties: - addressCountry: - description: 'The country. For example, Spain' - type: string - x-ngsi: - model: https://schema.org/addressCountry - type: Property - addressLocality: - description: 'The locality in which the street address is, and which is in the region' - type: string - x-ngsi: - model: https://schema.org/addressLocality - type: Property - addressRegion: - description: 'The region in which the locality is, and which is in the country' - type: string - x-ngsi: - model: https://schema.org/addressRegion - type: Property - district: - description: 'A district is a type of administrative division that, in some countries, is managed by the local government' - type: string - x-ngsi: - type: Property - postOfficeBoxNumber: - description: 'The post office box number for PO box addresses. For example, 03578' - type: string - x-ngsi: - model: https://schema.org/postOfficeBoxNumber - type: Property - postalCode: - description: 'The postal code. For example, 24004' - type: string - x-ngsi: - model: https://schema.org/https://schema.org/postalCode - type: Property - streetAddress: - description: The street address - type: string - x-ngsi: - model: https://schema.org/streetAddress - type: Property - streetNr: - description: Number identifying a specific property on a public street - type: string - x-ngsi: - type: Property - type: object - x-ngsi: - model: https://schema.org/address - type: Property - alternateName: - description: An alternative name for this item - type: string - x-ngsi: - type: Property - areaServed: - description: The geographic area where a service or offered item is provided - type: string - x-ngsi: - model: https://schema.org/Text - type: Property - completeness: - description: Completeness quantifies the number of missed measurements or observations in a given time window - maximum: 1 - minimum: 0 - type: number - x-ngsi: - type: Property - units: P1 - dataProvider: - description: A sequence of characters identifying the provider of the harmonised data entity - type: string - x-ngsi: - type: Property - dateCalculated: - description: Date of the calculated entity defined by the user - format: date-time - type: string - x-ngsi: - type: Property - dateCreated: - description: Entity creation timestamp. This will usually be allocated by the storage platform - format: date-time - type: string - x-ngsi: - type: Property - dateModified: - description: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform - format: date-time - type: string - x-ngsi: - type: Property - description: - description: A description of this item - type: string - x-ngsi: - type: Property - id: - anyOf: - - description: Identifier format of any NGSI entity - maxLength: 256 - minLength: 1 - pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ - type: string - x-ngsi: - type: Property - - description: Identifier format of any NGSI entity - format: uri - type: string - x-ngsi: - type: Property - description: Unique identifier of the entity - x-ngsi: - type: Property - location: - description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' - oneOf: - - description: Geojson reference to the item. Point - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - type: number - minItems: 2 - type: array - type: - enum: - - Point - type: string - required: - - type - - coordinates - title: GeoJSON Point - type: object - x-ngsi: - type: GeoProperty - - description: Geojson reference to the item. LineString - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - items: - type: number - minItems: 2 - type: array - minItems: 2 - type: array - type: - enum: - - LineString - type: string - required: - - type - - coordinates - title: GeoJSON LineString - type: object - x-ngsi: - type: GeoProperty - - description: Geojson reference to the item. Polygon - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - items: - items: - type: number - minItems: 2 - type: array - minItems: 4 - type: array - type: array - type: - enum: - - Polygon - type: string - required: - - type - - coordinates - title: GeoJSON Polygon - type: object - x-ngsi: - type: GeoProperty - - description: Geojson reference to the item. MultiPoint - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - items: - type: number - minItems: 2 - type: array - type: array - type: - enum: - - MultiPoint - type: string - required: - - type - - coordinates - title: GeoJSON MultiPoint - type: object - x-ngsi: - type: GeoProperty - - description: Geojson reference to the item. MultiLineString - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - items: - items: - type: number - minItems: 2 - type: array - minItems: 2 - type: array - type: array - type: - enum: - - MultiLineString - type: string - required: - - type - - coordinates - title: GeoJSON MultiLineString - type: object - x-ngsi: - type: GeoProperty - - description: Geojson reference to the item. MultiLineString - properties: - bbox: - items: - type: number - minItems: 4 - type: array - coordinates: - items: - items: - items: - items: - type: number - minItems: 2 - type: array - minItems: 4 - type: array - type: array - type: array - type: - enum: - - MultiPolygon - type: string - required: - - type - - coordinates - title: GeoJSON MultiPolygon - type: object - x-ngsi: - type: GeoProperty - x-ngsi: - type: GeoProperty - name: - description: The name of this item - type: string - x-ngsi: - type: Property - outlier: - description: Includes information about the outlier characteristics of the measurement - properties: - isOutlier: - description: Determine whether the measurement has been considered an outlier or not - type: boolean - x-ngsi: - type: Property - methodology: - anyOf: - - description: Identifier format of any NGSI entity - maxLength: 256 - minLength: 1 - pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ - type: string - x-ngsi: - type: Property - - description: Identifier format of any NGSI entity - format: uri - type: string - x-ngsi: - type: Property - description: Reference to the other entity including AI methodology information - x-ngsi: - type: Relationship - type: object - x-ngsi: - type: Property - owner: - description: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) - items: - anyOf: - - description: Identifier format of any NGSI entity - maxLength: 256 - minLength: 1 - pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ - type: string - x-ngsi: - type: Property - - description: Identifier format of any NGSI entity - format: uri - type: string - x-ngsi: - type: Property - description: Unique identifier of the entity - x-ngsi: - type: Property - type: array - x-ngsi: - type: Property - precision: - description: 'Precision measures the standard deviation of a dataset. That is, it measures how close the values in the dataset are to each other' - type: number - x-ngsi: - type: Property - seeAlso: - description: list of uri pointing to additional resources about the item - oneOf: - - items: - format: uri - type: string - minItems: 1 - type: array - - format: uri - type: string - x-ngsi: - type: Property - source: - description: 'A sequence of characters giving the original source of the entity data as a URL. Recommended to be the fully qualified domain name of the source provider, or the URL to the source object' - type: string - x-ngsi: - type: Property - synthetic: - description: Includes information about the origin of the measurement - properties: - isSynthetic: - description: Determine whether the measurement has been created synthetically or not - type: boolean - x-ngsi: - type: Property - methodology: - anyOf: - - description: Identifier format of any NGSI entity - maxLength: 256 - minLength: 1 - pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ - type: string - x-ngsi: - type: Property - - description: Identifier format of any NGSI entity - format: uri - type: string - x-ngsi: - type: Property - description: Reference to the other entity including AI methodology information - x-ngsi: - type: Relationship - type: object - x-ngsi: - type: Property - timeliness: - description: Average timeliness of the data-stream - type: number - x-ngsi: - type: Property - units: minutes - type: - description: NGSI Entity type. It has to be DataQualityAssessment - enum: - - DataQualityAssessment - type: string - x-ngsi: - type: Property - required: - - id - - type - type: object - x-derived-from: "" - x-disclaimer: 'Redistribution and use in source and binary forms, with or without modification, are permitted provided that the license conditions are met. Copyleft (c) 2022 Contributors to Smart Data Models Program' - x-license-url: https://github.com/smart-data-models/dataModel.DataQuality/blob/master/DataQualityAssessment/LICENSE.md - x-model-schema: https://smart-data-models.github.io/dataModel.DataQuality/DataQualityAssessment/schema.json - x-model-tags: "" - x-version: 0.0.2 -``` -
- - - - - ## Esempi di payload - #### Valutazione della qualità dei dati Valori chiave NGSI-v2 Esempio - Ecco un esempio di DataQualityAssessment in formato JSON-LD come valori-chiave. Questo è compatibile con NGSI-v2 quando si usa `options=keyValues` e restituisce i dati di contesto di una singola entità. -
show/hide example + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + Entità: DatiQualitàValutazione +============================== + + [Licenza aperta](https://github.com/smart-data-models//dataModel.DataQuality/blob/master/DataQualityAssessment/LICENSE.md) + [documento generato automaticamente](https://docs.google.com/presentation/d/e/2PACX-1vTs-Ng5dIAwkg91oTTUdt8ua7woBXhPnwavZ0FxgR8BsAI_Ek3C5q97Nd94HS8KhP-r_quD4H0fgyt3/pub?start=false&loop=false&delayms=3000#slide=id.gb715ace035_0_60) + + + Descrizione globale: **Questa entità descrive le proprietà di qualità dei dati di una misurazione, come la temperatura.** + versione: 0.0.2 + + + + ## Elenco delle proprietà + + [*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o diversi formati/modelli. +- `accuracy[number]`: L'accuratezza misura l'errore numerico sistematico massimo prodotto nella misurazione di un sensore. - `address[object]`: L'indirizzo postale . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Il paese. Ad esempio, la Spagna . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La località in cui si trova l'indirizzo civico e che si trova nella regione . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La regione in cui si trova la località, e che si trova nel paese . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un distretto è un tipo di divisione amministrativa che, in alcuni paesi, è gestita dal governo locale. + - `postOfficeBoxNumber[string]`: Il numero di casella postale per gli indirizzi di casella postale. Ad esempio, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: Il codice postale. Ad esempio, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: L'indirizzo stradale . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: Numero che identifica una proprietà specifica su una strada pubblica +- `alternateName[string]`: Un nome alternativo per questa voce - `areaServed[string]`: L'area geografica in cui viene fornito il servizio o l'articolo offerto. . Model: [https://schema.org/Text](https://schema.org/Text) - `completeness[number]`: La completezza quantifica il numero di misurazioni o osservazioni mancate in una determinata finestra temporale. - `dataProvider[string]`: una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzata - `dateCalculated[date-time]`: Data dell'entità calcolata definita dall'utente - `dateCreated[date-time]`: Timestamp di creazione dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `description[string]`: Descrizione dell'articolo - `id[*]`: Identificatore univoco dell'entità - `location[*]`: Riferimento geojson all'elemento. Può essere un punto, una stringa di linea, un poligono, un multi-punto, una stringa di linea o un poligono multiplo. - `name[string]`: Il nome di questo elemento - `outlier[object]`: Include informazioni sulle caratteristiche di outlier della misura. - `isOutlier[boolean]`: Determinare se la misura è stata considerata un outlier o meno. + - `methodology[*]`: Riferimento all'altra entità, incluse le informazioni sulla metodologia AI +- `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `precision[number]`: La precisione misura la deviazione standard di un set di dati. In altre parole, misura quanto i valori del set di dati siano vicini l'uno all'altro. - `seeAlso[*]`: elenco di uri che puntano a risorse aggiuntive sull'elemento - `source[string]`: Una sequenza di caratteri che indica la fonte originale dei dati dell'entità come URL. Si consiglia di utilizzare il nome di dominio completamente qualificato del provider di origine o l'URL dell'oggetto di origine. - `synthetic[object]`: Include informazioni sull'origine della misura - `isSynthetic[boolean]`: Determinare se la misura è stata creata in modo sintetico o meno. + - `methodology[*]`: Riferimento all'altra entità, comprese le informazioni sulla metodologia AI +- `timeliness[number]`: Tempestività media del flusso di dati - `type[string]`: Tipo di entità NGSI. Deve essere DataQualityAssessment + + Proprietà richieste +- `id` - `type` + + + + ## Modello di dati descrizione delle proprietà + Ordinati in ordine alfabetico (clicca per i dettagli) + + +
full yaml details + ```yaml +DataQualityAssessment: + description: 'This entity describes the data quality properties of a measurement, such as temperature.' + properties: + accuracy: + description: Accuracy measures the maximum systematic numerical error produced in a sensor measurement + type: number + x-ngsi: + type: Property + address: + description: The mailing address + properties: + addressCountry: + description: 'The country. For example, Spain' + type: string + x-ngsi: + model: https://schema.org/addressCountry + type: Property + addressLocality: + description: 'The locality in which the street address is, and which is in the region' + type: string + x-ngsi: + model: https://schema.org/addressLocality + type: Property + addressRegion: + description: 'The region in which the locality is, and which is in the country' + type: string + x-ngsi: + model: https://schema.org/addressRegion + type: Property + district: + description: 'A district is a type of administrative division that, in some countries, is managed by the local government' + type: string + x-ngsi: + type: Property + postOfficeBoxNumber: + description: 'The post office box number for PO box addresses. For example, 03578' + type: string + x-ngsi: + model: https://schema.org/postOfficeBoxNumber + type: Property + postalCode: + description: 'The postal code. For example, 24004' + type: string + x-ngsi: + model: https://schema.org/https://schema.org/postalCode + type: Property + streetAddress: + description: The street address + type: string + x-ngsi: + model: https://schema.org/streetAddress + type: Property + streetNr: + description: Number identifying a specific property on a public street + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + model: https://schema.org/address + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + type: Property + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + completeness: + description: Completeness quantifies the number of missed measurements or observations in a given time window + maximum: 1 + minimum: 0 + type: number + x-ngsi: + type: Property + units: P1 + dataProvider: + description: A sequence of characters identifying the provider of the harmonised data entity + type: string + x-ngsi: + type: Property + dateCalculated: + description: Date of the calculated entity defined by the user + format: date-time + type: string + x-ngsi: + type: Property + dateCreated: + description: Entity creation timestamp. This will usually be allocated by the storage platform + format: date-time + type: string + x-ngsi: + type: Property + dateModified: + description: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform + format: date-time + type: string + x-ngsi: + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + duplicate: + description: Includes information about duplicated data + properties: + foundMatches: + description: 'Property: If this is a duplicate, determine measurements it does match with' + items: + type: string + type: array + isDuplicate: + description: 'Property: Determine whether the measurement is duplicated or not' + type: boolean + type: object + x-ngsi: + type: Property + id: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Unique identifier of the entity + x-ngsi: + type: Property + location: + description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + oneOf: + - description: Geojson reference to the item. Point + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + type: number + minItems: 2 + type: array + type: + enum: + - Point + type: string + required: + - type + - coordinates + title: GeoJSON Point + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. LineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: + enum: + - LineString + type: string + required: + - type + - coordinates + title: GeoJSON LineString + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. Polygon + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: + enum: + - Polygon + type: string + required: + - type + - coordinates + title: GeoJSON Polygon + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiPoint + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + type: number + minItems: 2 + type: array + type: array + type: + enum: + - MultiPoint + type: string + required: + - type + - coordinates + title: GeoJSON MultiPoint + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiLineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + type: + enum: + - MultiLineString + type: string + required: + - type + - coordinates + title: GeoJSON MultiLineString + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiLineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + name: + description: The name of this item + type: string + x-ngsi: + type: Property + outlier: + description: Includes information about the outlier characteristics of the measurement + properties: + isOutlier: + description: Determine whether the measurement has been considered an outlier or not + type: boolean + x-ngsi: + type: Property + methodology: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Reference to the other entity including AI methodology information + x-ngsi: + type: Relationship + outlierScore: + description: A score indicating the degree of outlierness + type: number + x-ngsi: + type: Property + type: object + x-ngsi: + type: Property + owner: + description: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) + items: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Unique identifier of the entity + x-ngsi: + type: Property + type: array + x-ngsi: + type: Property + precision: + description: 'Precision measures the standard deviation of a dataset. That is, it measures how close the values in the dataset are to each other' + type: number + x-ngsi: + type: Property + seeAlso: + description: list of uri pointing to additional resources about the item + oneOf: + - items: + format: uri + type: string + minItems: 1 + type: array + - format: uri + type: string + x-ngsi: + type: Property + source: + description: 'A sequence of characters giving the original source of the entity data as a URL. Recommended to be the fully qualified domain name of the source provider, or the URL to the source object' + type: string + x-ngsi: + type: Property + synthetic: + description: Includes information about the origin of the measurement + properties: + isSynthetic: + description: Determine whether the measurement has been created synthetically or not + type: boolean + x-ngsi: + type: Property + methodology: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Reference to the other entity including AI methodology information + x-ngsi: + type: Relationship + type: object + x-ngsi: + type: Property + timeliness: + description: Average timeliness of the data-stream + type: number + x-ngsi: + type: Property + units: minutes + type: + description: NGSI Entity type. It has to be DataQualityAssessment + enum: + - DataQualityAssessment + type: string + x-ngsi: + type: Property + required: + - id + - type + type: object + x-derived-from: "" + x-disclaimer: 'Redistribution and use in source and binary forms, with or without modification, are permitted provided that the license conditions are met. Copyleft (c) 2023 Contributors to Smart Data Models Program' + x-license-url: https://github.com/smart-data-models/dataModel.DataQuality/blob/master/DataQualityAssessment/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.DataQuality/DataQualityAssessment/schema.json + x-model-tags: "" + x-version: 0.0.3 +``` +
+ + + + + ## Esempi di payload + #### Valutazione della qualità dei dati Valori chiave NGSI-v2 Esempio + Ecco un esempio di DataQualityAssessment in formato JSON-LD come valori-chiave. Questo è compatibile con NGSI-v2 quando si usa `options=keyValues` e restituisce i dati di contesto di una singola entità. +
show/hide example ```json { "id": "urn:ngsi-ld:DataQualityAssessment:Temperature:smartsantander:u7jcfa:f3058", @@ -471,7 +495,13 @@ DataQualityAssessment: "source": "https://salted-project.eu", "outlier": { "isOutlier": true, + "outlierScore": 0.7 "methodology": "urn:ngsi-ld:AI-Methodology:Outlier:Temperature:smartsantander:u7jcfa:f3058" + }, + "duplicate": { + "isDuplicate": true, + "foundMatches": ["urn:ngsi-ld:DataQualityAssessment:Temperature:smartsantander:u7jcfa:f3062" + ] }, "synthetic": { "isSynthetic": false, @@ -483,10 +513,10 @@ DataQualityAssessment: "completeness": 0.5 } ``` -
- #### Valutazione della qualità dei dati NGSI-v2 normalizzato Esempio - Ecco un esempio di DataQualityAssessment in formato JSON-LD normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano le opzioni e restituisce i dati di contesto di una singola entità. -
show/hide example +
+ #### Valutazione della qualità dei dati NGSI-v2 normalizzato Esempio + Ecco un esempio di DataQualityAssessment in formato JSON-LD normalizzato. Questo è compatibile con NGSI-v2 quando non si utilizzano le opzioni e restituisce i dati di contesto di una singola entità. +
show/hide example ```json { "id": "urn:ngsi-ld:DataQualityAssessment:Temperature:smartsantander:u7jcfa:f3058", @@ -503,9 +533,17 @@ DataQualityAssessment: "type": "StructuredValue", "value": { "isOutlier": true, + "outlierScore": 0.7 "methodology": "urn:ngsi-ld:AI-Methodology:Outlier:Temperature:smartsantander:u7jcfa:f3058" } }, + "duplicate": { + "type": "StructuredValue", + "value": { + "isDuplicate": true, + "foundMatches": ["urn:ngsi-ld:DataQualityAssessment:Temperature:smartsantander:u7jcfa:f3062"] + } + }, "synthetic": { "type": "StructuredValue", "value": { @@ -531,10 +569,10 @@ DataQualityAssessment: } } ``` -
- #### Valutazione della qualità dei dati Valori chiave NGSI-LD Esempio - Ecco un esempio di DataQualityAssessment in formato JSON-LD come valori-chiave. Questo è compatibile con NGSI-LD quando si usa `options=keyValues` e restituisce i dati di contesto di una singola entità. -
show/hide example +
+ #### Valutazione della qualità dei dati Valori chiave NGSI-LD Esempio + Ecco un esempio di DataQualityAssessment in formato JSON-LD come valori-chiave. Questo è compatibile con NGSI-LD quando si usa `options=keyValues` e restituisce i dati di contesto di una singola entità. +
show/hide example ```json { "id": "urn:ngsi-ld:DataQualityAssessment:Temperature:smartsantander:u7jcfa:f3058", @@ -543,8 +581,14 @@ DataQualityAssessment: "source": "https://salted-project.eu", "outlier": { "isOutlier": true, + "outlierScore": 0.7, "methodology": "urn:ngsi-ld:AI-Methodology:Outlier:Temperature:smartsantander:u7jcfa:f3058" }, + "duplicate": { + "isDuplicate": true, + "foundMatches": ["urn:ngsi-ld:DataQualityAssessment:Temperature:smartsantander:u7jcfa:f3062" + ] + }, "synthetic": { "isSynthetic": false, "methodology": "urn:ngsi-ld:AI-Methodology:Synthetic:Temperature:smartsantander:u7jcfa:f3058" @@ -559,10 +603,10 @@ DataQualityAssessment: ] } ``` -
- #### Valutazione della qualità dei dati NGSI-LD normalizzato Esempio - Ecco un esempio di DataQualityAssessment in formato JSON-LD normalizzato. Questo è compatibile con NGSI-LD quando non si utilizzano opzioni e restituisce i dati di contesto di una singola entità. -
show/hide example +
+ #### Valutazione della qualità dei dati NGSI-LD normalizzato Esempio + Ecco un esempio di DataQualityAssessment in formato JSON-LD normalizzato. Questo è compatibile con NGSI-LD quando non si utilizzano opzioni e restituisce i dati di contesto di una singola entità. +
show/hide example ```json { "id": "urn:ngsi-ld:DataQualityAssessment:Temperature:smartsantander:u7jcfa:f3058", @@ -585,6 +629,10 @@ DataQualityAssessment: "type": "Property", "value": true }, + "outlierScore": { + "type": "Property", + "value": 0.7 + }, "methodology": { "type": "Relationship", "object": "urn:ngsi-ld:AI-Methodology:Outlier:Temperature:smartsantander:u7jcfa:f3058" @@ -592,6 +640,20 @@ DataQualityAssessment: }, "observedAt": "2022-09-10T10:01:20Z" }, + "duplicate": { + "type": "Property", + "value": { + "isDuplicate": { + "type": "Property", + "value": true + } + "foundMatches": { + "type": "Property", + "value": ["urn:ngsi-ld:DataQualityAssessment:Temperature:smartsantander:u7jcfa:f3062" + ] + } + } + }, "synthetic": { "type": "Property", "value": { @@ -636,12 +698,12 @@ DataQualityAssessment: ] } ``` -
- - - - Vedere [FAQ 10](https://smartdatamodels.org/index.php/faqs/) per ottenere una risposta su come gestire le unità di grandezza. - - ---- - [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM) +
+ + + + Vedere [FAQ 10](https://smartdatamodels.org/index.php/faqs/) per ottenere una risposta su come gestire le unità di grandezza. + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM)