From 0bf31c468101fb5f0063dd9109d074f4788c3f70 Mon Sep 17 00:00:00 2001 From: Alberto Abella Date: Mon, 18 Dec 2023 15:14:14 +0100 Subject: [PATCH] updated PhotovoltaicMeasurement/doc/spec_IT.md --- PhotovoltaicMeasurement/doc/spec_IT.md | 1049 ++++++++++++------------ 1 file changed, 529 insertions(+), 520 deletions(-) diff --git a/PhotovoltaicMeasurement/doc/spec_IT.md b/PhotovoltaicMeasurement/doc/spec_IT.md index 8c5396a..cb0cc0b 100644 --- a/PhotovoltaicMeasurement/doc/spec_IT.md +++ b/PhotovoltaicMeasurement/doc/spec_IT.md @@ -1,502 +1,511 @@ - -[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) - Entità: FotovoltaicoMisura -========================== - - [Licenza aperta](https://github.com/smart-data-models//dataModel.GreenEnergy/blob/master/PhotovoltaicMeasurement/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: **Il modello di dati è destinato a misurare la potenza continua trasferita dal pannello fotovoltaico a un dispositivo inverter. - versione: 0.0.2 - - - ## Elenco delle proprietà - [*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o diversi formati/modelli. -- `activePower[number]`: Potenza attiva, dove phi è lo sfasamento della corrente rispetto alla tensione. Il codice dell'unità di misura (testo) viene fornito utilizzando i codici UN/CEFACT_Common_Codes (max 3 caratteri). Ad esempio, **KWT** rappresenta il Kilowatt. . Model: [https://schema.org/Number](https://schema.org/Number) - `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) - `current[number]`: Intensità elettrica della corrente. Il codice dell'unità (testo) è indicato utilizzando i [Codici comuni UN/CEFACT] (http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). Ad esempio, **AMP** rappresenta gli Ampere . Model: [https://schema.org/Number](https://schema.org/Number) - `dataProvider[string]`: una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzata - `dateCreated[date-time]`: Timestamp di creazione dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `dateEnergyMeteringStarted[date-time]`: La data di inizio della misurazione dell'energia in formato ISO8601 UTC. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `dateObservedFrom[date-time]`: Periodo di osservazione: Data e ora di inizio in formato ISO8601 UTC. L'attributo può essere utilizzato in aggiunta all'attributo 'dataOsservata' quando corrisponde a un intervallo di tempo da evidenziare. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Periodo di osservazione: Data e ora finale in formato ISO8601 UTC. Questo attributo può essere utilizzato in aggiunta all'attributo "dataOsservata" quando corrisponde a un intervallo di tempo da evidenziare. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: Descrizione dell'articolo - `id[*]`: Identificatore univoco dell'entità - `inverterStatus[array]`: Potenza attiva, dove phi è lo sfasamento della corrente rispetto alla tensione. Il codice dell'unità di misura (testo) viene fornito utilizzando i codici UN/CEFACT_Common_Codes (max 3 caratteri). Ad esempio, **KWT** rappresenta il Kilowatt. Enum:'00-Settore acceso, 01-Assenza di corrente / Batteria accesa, 02-Perdita di comunicazione, 03-Disturbo della batteria, 04-Arresto del sistema, 05-Discesa di tensione, 06-Sovratensione, 07-Caduta di tensione, 08-Aumento di tensione, 09-Rumore di linea, 10-Variazione di frequenza, 11-Distorsione transitoria, 12-Distorsione armonica'. . Model: [https://schema.org/Number](https://schema.org/Number) - `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 - `nominalPeakPowerGeneration[number]`: nominalPeakPowerGeneration è un numero. Il codice dell'unità di misura (testo) è fornito utilizzando i [Codici comuni UN/CEFACT] (http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). Ad esempio, **KWT** rappresenta il Kilowatt . Model: [https://schema.org/Number](https://schema.org/Number) - `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `reactivePower[number]`: Potenza reattiva utilizzata dai circuiti. Il codice dell'unità di misura (testo) è fornito utilizzando i [Codici comuni UN/CEFACT] (http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). Per esempio, **K5** rappresenta il kilovolt-ampere reattivo . Model: [https://schema.org/Number](https://schema.org/Number) - `refPhotovoltaicDevice[*]`: . Model: [Reference to a [Photovoltaic Device](https://github.com/smart-data-models/dataModel.Energy/PhotovoltaicDevice/doc/spec.md) which captured this observation, if the entity is used https://schema.org/URL](Reference to a [Photovoltaic Device](https://github.com/smart-data-models/dataModel.Energy/PhotovoltaicDevice/doc/spec.md) which captured this observation, if the entity is used https://schema.org/URL) - `refPointOfInterest[*]`: Riferimento a un [PointOfInterest](https://github.com/smart-data-models/dataModel.PointOfInterest/blob/master/PointOfInterest/doc/spec.md) collegato con il Repository . Model: [https://schema.org/URL](https://schema.org/URL) - `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. - `temperature[number]`: Temperatura registrata al momento dell'osservazione rispetto alla temperatura nominale di riferimento del dispositivo. Il codice dell'unità di misura (testo) è indicato utilizzando i [Codici comuni UN/CEFACT] (http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). Ad esempio, **CEL** rappresenta il grado Celsius. . Model: [https://schema.org/Number](https://schema.org/Number) - `type[string]`: Tipo di entità NGSI. Deve essere PhotovoltaicMeasurement - - Proprietà richieste -- `dateEnergyMeteringStarted` - `dateObserved` - `id` - `location` - `refPhotovoltaicDevice` - `temperature` - `type` - - Può avere i seguenti valori. - istantaneo. Dallo specifico istante di tempo - media. La media di un periodo di tempo - rms. La radice quadrata media di un periodo di tempo - massimo. Il massimo di un periodo di tempo - Minimo. Il minimo di un periodo di tempo. -Quando si usano i valori [average, rms, maximum, minimum] si deve usare un altro attributo Meta Data chiamato 'measurementInterval' per indicare la durata del periodo di misurazione in secondi. Anche l'attributo Meta Data 'timestamp' deve essere l'ora di fine del periodo di misura. - - - ## Modello di dati descrizione delle proprietà - Ordinati in ordine alfabetico (clicca per i dettagli) - - -
full yaml details - ```yaml -PhotovoltaicMeasurement: - description: The Data Model is intended to measure the continuous power transferred by the photo-voltaic panel to an Inverter Device. - properties: - activePower: - description: 'Active Power,where phi is the phase shift of the current compared to the voltage. The unit code (text) is given using the UN/CEFACT_Common_Codes (max 3 characters). For instance, For instance, **KWT** represents Kilowatt' - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: Kilowatt - 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 - current: - description: 'Electrical intensity of the current. The unit code (text) is given using the [UN/CEFACT Common Codes](http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). For instance, **AMP** represents Ampere' - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: Ampere - dataProvider: - description: A sequence of characters identifying the provider of the harmonised data entity - 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 - dateEnergyMeteringStarted: - description: The starting date for metering energy in an ISO8601 UTC format - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - 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 - dateObservedFrom: - description: 'Observation period: Start date and time in an ISO8601 UTC format. The attribute can be used in addition to the ''dateObserved attribute when it corresponds to a time interval to be highlighted' - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - type: Property - dateObservedTo: - description: 'Observation period: End date and time in an ISO8601 UTC format. The attribute can be used in addition to the ''dateObserved'' attribute when it corresponds to a time interval to be highlighted' - format: date-time - type: string - x-ngsi: - model: https://schema.org/DateTime - 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 - inverterStatus: - description: 'Active Power,where phi is the phase shift of the current compared to the voltage. The unit code (text) is given using the UN/CEFACT_Common_Codes (max 3 characters). For instance, For instance, **KWT** represents Kilowatt. Enum:''00-On sector, 01-Power failure / On battery, 02-Loss of communication, 03-Battery fault, 04-System shutdown, 05-Tension dip, 06-Overvoltage, 07-Voltage drop, 08-Voltage increase, 09-Line noise, 10-Frequency variation, 11-Transient distortion, 12-Harmonic distortion''' - items: - enum: - - 00-On sector - - 01-Power failure / On battery - - 02-Loss of communication - - 03-Battery fault - - 04-System shutdown - - 05-Tension dip - - 06-Overvoltage - - 07-Voltage drop - - 08-Voltage increase - - 09-Line noise - - 10-Frequency variation - - 11-Transient distortion - - 12-Harmonic distortion - type: string - type: array - x-ngsi: - model: https://schema.org/Number - 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 - nominalPeakPowerGeneration: - description: 'nominalPeakPowerGeneration is a number. The unit code (text) is given using the [UN/CEFACT Common Codes](http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). For instance, **KWT** represents Kilowatt' - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: Kilowatt - 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 - reactivePower: - description: 'Reactive Power used by circuits. The unit code (text) is given using the [UN/CEFACT Common Codes](http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). For instance, **K5** represents kilovolt-ampere-reactive' - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - refPhotovoltaicDevice: - 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: "" - x-ngsi: - model: 'Reference to a [Photovoltaic Device](https://github.com/smart-data-models/dataModel.Energy/PhotovoltaicDevice/doc/spec.md) which captured this observation, if the entity is used https://schema.org/URL' - type: Relationship - refPointOfInterest: - 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 a [PointOfInterest](https://github.com/smart-data-models/dataModel.PointOfInterest/blob/master/PointOfInterest/doc/spec.md) linked with the Repository' - x-ngsi: - model: https://schema.org/URL - type: Relationship - 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 - temperature: - description: 'Temperature recorded at the time of Observation compared to the nominal reference temperature of the device. The unit code (text) is given using the [UN/CEFACT Common Codes](http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). For instance, **CEL** represents Degree Celsius' - minimum: 0 - type: number - x-ngsi: - model: https://schema.org/Number - type: Property - units: degrees celsius - type: - description: NGSI Entity type. It has to be PhotovoltaicMeasurement - enum: - - PhotovoltaicMeasurement - type: string - x-ngsi: - type: Property - required: - - id - - type - - location - - dateObserved - - refPhotovoltaicDevice - - dateEnergyMeteringStarted - - temperature - 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.GreenEnergy/blob/master/PhotovoltaicMeasurement/LICENSE.md - x-model-schema: https://smart-data-models.github.io/data-models.Energy/PhotovoltaicMeasurement/schema.json - x-model-tags: "" - x-version: 0.0.2 -``` -
- - - - - ## Esempi di payload - #### PhotovoltaicMeasurement NGSI-v2 valori-chiave Esempio - Ecco un esempio di PhotovoltaicMeasurement 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à: FotovoltaicoMisura +========================== + + [Licenza aperta](https://github.com/smart-data-models//dataModel.GreenEnergy/blob/master/PhotovoltaicMeasurement/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: **Il modello di dati è destinato a misurare la potenza continua trasferita dal pannello fotovoltaico a un dispositivo inverter. + versione: 0.0.2 + + + + ## Elenco delle proprietà + + [*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o diversi formati/modelli. +- `activePower[number]`: Potenza attiva, dove phi è lo sfasamento della corrente rispetto alla tensione. Il codice dell'unità di misura (testo) viene fornito utilizzando i codici UN/CEFACT_Common_Codes (max 3 caratteri). Ad esempio, **KWT** rappresenta il Kilowatt. . Model: [https://schema.org/Number](https://schema.org/Number) - `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) - `current[number]`: Intensità elettrica della corrente. Il codice dell'unità (testo) è indicato utilizzando i [Codici comuni UN/CEFACT] (http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). Ad esempio, **AMP** rappresenta gli Ampere . Model: [https://schema.org/Number](https://schema.org/Number) - `dataProvider[string]`: una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzata - `dateCreated[date-time]`: Timestamp di creazione dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `dateEnergyMeteringStarted[date-time]`: La data di inizio della misurazione dell'energia in formato ISO8601 UTC. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `dateObservedFrom[date-time]`: Periodo di osservazione: Data e ora di inizio in formato ISO8601 UTC. L'attributo può essere utilizzato in aggiunta all'attributo 'dataOsservata' quando corrisponde a un intervallo di tempo da evidenziare. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `dateObservedTo[date-time]`: Periodo di osservazione: Data e ora finale in formato ISO8601 UTC. Questo attributo può essere utilizzato in aggiunta all'attributo "dataOsservata" quando corrisponde a un intervallo di tempo da evidenziare. . Model: [https://schema.org/DateTime](https://schema.org/DateTime) - `description[string]`: Descrizione dell'articolo - `id[*]`: Identificatore univoco dell'entità - `inverterStatus[array]`: Potenza attiva, dove phi è lo sfasamento della corrente rispetto alla tensione. Il codice dell'unità di misura (testo) viene fornito utilizzando i codici UN/CEFACT_Common_Codes (max 3 caratteri). Ad esempio, **KWT** rappresenta il Kilowatt. Enum:'00-Settore acceso, 01-Assenza di corrente / Batteria accesa, 02-Perdita di comunicazione, 03-Disturbo della batteria, 04-Arresto del sistema, 05-Discesa di tensione, 06-Sovratensione, 07-Caduta di tensione, 08-Aumento di tensione, 09-Rumore di linea, 10-Variazione di frequenza, 11-Distorsione transitoria, 12-Distorsione armonica'. . Model: [https://schema.org/Number](https://schema.org/Number) - `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 - `nominalPeakPowerGeneration[number]`: nominalPeakPowerGeneration è un numero. Il codice dell'unità di misura (testo) è fornito utilizzando i [Codici comuni UN/CEFACT] (http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). Ad esempio, **KWT** rappresenta il Kilowatt . Model: [https://schema.org/Number](https://schema.org/Number) - `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `reactivePower[number]`: Potenza reattiva utilizzata dai circuiti. Il codice dell'unità di misura (testo) è fornito utilizzando i [Codici comuni UN/CEFACT] (http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). Per esempio, **K5** rappresenta il kilovolt-ampere reattivo . Model: [https://schema.org/Number](https://schema.org/Number) - `refPhotovoltaicDevice[*]`: . Model: [Reference to a [Photovoltaic Device](https://github.com/smart-data-models/dataModel.Energy/PhotovoltaicDevice/doc/spec.md) which captured this observation, if the entity is used https://schema.org/URL](Reference to a [Photovoltaic Device](https://github.com/smart-data-models/dataModel.Energy/PhotovoltaicDevice/doc/spec.md) which captured this observation, if the entity is used https://schema.org/URL) - `refPointOfInterest[*]`: Riferimento a un [PointOfInterest](https://github.com/smart-data-models/dataModel.PointOfInterest/blob/master/PointOfInterest/doc/spec.md) collegato con il Repository . Model: [https://schema.org/URL](https://schema.org/URL) - `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. - `temperature[number]`: Temperatura registrata al momento dell'osservazione rispetto alla temperatura nominale di riferimento del dispositivo. Il codice dell'unità di misura (testo) è indicato utilizzando i [Codici comuni UN/CEFACT] (http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). Ad esempio, **CEL** rappresenta il grado Celsius. . Model: [https://schema.org/Number](https://schema.org/Number) - `type[string]`: Tipo di entità NGSI. Deve essere PhotovoltaicMeasurement + + Proprietà richieste +- `dateEnergyMeteringStarted` - `dateObserved` - `id` - `location` - `refPhotovoltaicDevice` - `temperature` - `type` + + Può avere i seguenti valori. - istantaneo. Dallo specifico istante di tempo - media. La media di un periodo di tempo - rms. La radice quadrata media di un periodo di tempo - massimo. Il massimo di un periodo di tempo - Minimo. Il minimo di un periodo di tempo. +Quando si usano i valori [average, rms, maximum, minimum] si deve usare un altro attributo Meta Data chiamato 'measurementInterval' per indicare la durata del periodo di misurazione in secondi. Anche l'attributo Meta Data 'timestamp' deve essere l'ora di fine del periodo di misura. + + + ## Modello di dati descrizione delle proprietà + Ordinati in ordine alfabetico (clicca per i dettagli) + + +
full yaml details + ```yaml +PhotovoltaicMeasurement: + description: The Data Model is intended to measure the continuous power transferred by the photo-voltaic panel to an Inverter Device. + properties: + activePower: + description: 'Active Power,where phi is the phase shift of the current compared to the voltage. The unit code (text) is given using the UN/CEFACT_Common_Codes (max 3 characters). For instance, For instance, **KWT** represents Kilowatt' + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: Kilowatt + 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 + current: + description: 'Electrical intensity of the current. The unit code (text) is given using the [UN/CEFACT Common Codes](http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). For instance, **AMP** represents Ampere' + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: Ampere + dataProvider: + description: A sequence of characters identifying the provider of the harmonised data entity + 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 + dateEnergyMeteringStarted: + description: The starting date for metering energy in an ISO8601 UTC format + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + 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 + dateObserved: + description: Date of the observed entity defined by the user + format: date-time + type: string + x-ngsi: + type: Property + dateObservedFrom: + description: 'Observation period: Start date and time in an ISO8601 UTC format. The attribute can be used in addition to the ''dateObserved attribute when it corresponds to a time interval to be highlighted' + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + type: Property + dateObservedTo: + description: 'Observation period: End date and time in an ISO8601 UTC format. The attribute can be used in addition to the ''dateObserved'' attribute when it corresponds to a time interval to be highlighted' + format: date-time + type: string + x-ngsi: + model: https://schema.org/DateTime + 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 + inverterStatus: + description: 'Active Power,where phi is the phase shift of the current compared to the voltage. The unit code (text) is given using the UN/CEFACT_Common_Codes (max 3 characters). For instance, For instance, **KWT** represents Kilowatt. Enum:''00-On sector, 01-Power failure / On battery, 02-Loss of communication, 03-Battery fault, 04-System shutdown, 05-Tension dip, 06-Overvoltage, 07-Voltage drop, 08-Voltage increase, 09-Line noise, 10-Frequency variation, 11-Transient distortion, 12-Harmonic distortion''' + items: + enum: + - 00-On sector + - 01-Power failure / On battery + - 02-Loss of communication + - 03-Battery fault + - 04-System shutdown + - 05-Tension dip + - 06-Overvoltage + - 07-Voltage drop + - 08-Voltage increase + - 09-Line noise + - 10-Frequency variation + - 11-Transient distortion + - 12-Harmonic distortion + type: string + type: array + x-ngsi: + model: https://schema.org/Number + 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 + nominalPeakPowerGeneration: + description: 'nominalPeakPowerGeneration is a number. The unit code (text) is given using the [UN/CEFACT Common Codes](http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). For instance, **KWT** represents Kilowatt' + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: Kilowatt + 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 + reactivePower: + description: 'Reactive Power used by circuits. The unit code (text) is given using the [UN/CEFACT Common Codes](http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). For instance, **K5** represents kilovolt-ampere-reactive' + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + refPhotovoltaicDevice: + 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: "" + x-ngsi: + model: 'Reference to a [Photovoltaic Device](https://github.com/smart-data-models/dataModel.Energy/PhotovoltaicDevice/doc/spec.md) which captured this observation, if the entity is used https://schema.org/URL' + type: Relationship + refPointOfInterest: + 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 a [PointOfInterest](https://github.com/smart-data-models/dataModel.PointOfInterest/blob/master/PointOfInterest/doc/spec.md) linked with the Repository' + x-ngsi: + model: https://schema.org/URL + type: Relationship + 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 + temperature: + description: 'Temperature recorded at the time of Observation compared to the nominal reference temperature of the device. The unit code (text) is given using the [UN/CEFACT Common Codes](http://wiki.goodrelations-vocabulary.org/Documentation/UN/CEFACT_Common_Codes). For instance, **CEL** represents Degree Celsius' + minimum: 0 + type: number + x-ngsi: + model: https://schema.org/Number + type: Property + units: degrees celsius + type: + description: NGSI Entity type. It has to be PhotovoltaicMeasurement + enum: + - PhotovoltaicMeasurement + type: string + x-ngsi: + type: Property + required: + - id + - type + - location + - dateObserved + - refPhotovoltaicDevice + - dateEnergyMeteringStarted + - temperature + 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.GreenEnergy/blob/master/PhotovoltaicMeasurement/LICENSE.md + x-model-schema: https://smart-data-models.github.io/data-models.Energy/PhotovoltaicMeasurement/schema.json + x-model-tags: "" + x-version: 0.0.3 +``` +
+ + + + + ## Esempi di payload + #### PhotovoltaicMeasurement NGSI-v2 valori-chiave Esempio + Ecco un esempio di PhotovoltaicMeasurement 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": "PhotovoltaicMeasurement:ENERGY-IMREDD-PV-0001", @@ -525,10 +534,10 @@ PhotovoltaicMeasurement: "temperature": 23.4 } ``` -
- #### FotovoltaicoMisura NGSI-v2 normalizzato Esempio - Ecco un esempio di PhotovoltaicMeasurement 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 +
+ #### FotovoltaicoMisura NGSI-v2 normalizzato Esempio + Ecco un esempio di PhotovoltaicMeasurement 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": "PhotovoltaicMeasurement:ENERGY-IMREDD-PV-0001", @@ -593,10 +602,10 @@ PhotovoltaicMeasurement: } } ``` -
- #### Misurazione fotovoltaica Valori-chiave NGSI-LD Esempio - Ecco un esempio di PhotovoltaicMeasurement 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 +
+ #### Misurazione fotovoltaica Valori-chiave NGSI-LD Esempio + Ecco un esempio di PhotovoltaicMeasurement 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": "PhotovoltaicMeasurement:ENERGY-IMREDD-PV-0001", @@ -630,10 +639,10 @@ PhotovoltaicMeasurement: ] } ``` -
- #### FotovoltaicoMisura NGSI-LD normalizzato Esempio - Ecco un esempio di PhotovoltaicMeasurement 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 +
+ #### FotovoltaicoMisura NGSI-LD normalizzato Esempio + Ecco un esempio di PhotovoltaicMeasurement 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": "PhotovoltaicMeasurement:ENERGY-IMREDD-PV-0001", @@ -703,12 +712,12 @@ PhotovoltaicMeasurement: ] } ``` -
- - - - 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)