Skip to content

Latest commit

 

History

History
637 lines (590 loc) · 28.5 KB

spec_JA.md

File metadata and controls

637 lines (590 loc) · 28.5 KB
Raw

Smart Data Models

エンティティExcELIN2

オープン・ライセンス

文書は自動的に生成される

グローバルな記述：CIMデータモデルからの引用。詳細励磁系モデル - ELIN（VATECH）。 このモデルは全静的励磁システムを表しています。PI電圧制御器は、比例電流制御器のための所望の界磁電流設定点を確立します。PIコントローラの積分器には、その信号を現在の界磁電流に一致させるための追従入力があります。 この励磁システムモデルとともに使用される電力系統安定化装置モデル：PssELIN2、PssIEEE2B、Pss2B.。

バージョン: 0.0.1

プロパティのリスト

[*] 属性に型がない場合は、複数の型があるか、異なるフォーマット/パターンがある可能性があるためです。

  • address[object]: 郵送先住所 . Model: https://schema.org/address
  • alternateName[string]: この項目の別名
  • areaServed[string]: サービスまたは提供品が提供される地理的地域 . Model: https://schema.org/Text
  • dataProvider[string]: ハーモナイズされたデータ・エンティティの提供者を識別する一連の文字。
  • dateCreated[date-time]: エンティティの作成タイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられます。
  • dateModified[date-time]: エンティティの最終変更のタイムスタンプ。これは通常、ストレージプラットフォームによって割り当てられる。
  • description[string]: この商品の説明
  • efdbas[number]: ゲイン（Efdbas）。 代表値 = 0.1。デフォルト：0.0 . Model: https://schema.org/Number
  • id[*]: エンティティの一意識別子
  • iefmax[number]: リミッター（Iefmax）。 代表値 = 1。デフォルト：0.0 . Model: https://schema.org/Number
  • iefmax2[number]: 最小開回路励磁電圧 (Iefmax2). 代表値 = -5。デフォルト：0.0 . Model: https://schema.org/Number
  • iefmin[number]: リミッター（Iefmin）。 代表値 = 1。デフォルト：0.0 . Model: https://schema.org/Number
  • k1[number]: 電圧レギュレータ入力ゲイン（K1）。 代表値=0 デフォルト値：0.0 . Model: https://schema.org/Number
  • k1ec[number]: 電圧レギュレータ入力制限 (K1ec)。 代表値 = 2。デフォルト：0.0 . Model: https://schema.org/Number
  • k2[number]: ゲイン（K2）。 代表値 = 5。デフォルト：0.0 . Model: https://schema.org/Number
  • k3[number]: ゲイン（K3）。 代表値 = 0.1。デフォルト：0.0。 . Model: https://schema.org/Number
  • k4[number]: ゲイン（K4）。 デフォルト：0.0。 . Model: https://schema.org/Number
  • kd1[number]: 電圧コントローラーの微分ゲイン（Kd1）。 代表値 = 34.5。デフォルト：0.0 . Model: https://schema.org/Number
  • ke2[number]: ゲイン（Ke2）。 代表値 = 0.1。デフォルト：0.0。 . Model: https://schema.org/Number
  • ketb[number]: ゲイン（Ketb）。 代表値 = 0.06。デフォルト：0.0 . Model: https://schema.org/Number
  • location[*]: アイテムへの Geojson 参照。Point、LineString、Polygon、MultiPoint、MultiLineString、MultiPolygon のいずれか。
  • name[string]: このアイテムの名前
  • owner[array]: 所有者の固有IDを参照するJSONエンコードされた文字列を含むリスト。
  • pid1max[number]: コントローラフォローアップゲイン（PID1max）。 代表値 = 2。デフォルト：0.0 . Model: https://schema.org/Number
  • seeAlso[*]: アイテムに関する追加リソースを指すURIのリスト
  • seve1[number]: 整流リアクタンス（Se[Ve1]）の背面、対応する励磁電圧Ve1における励磁器飽和関数値。 代表値 = 0. デフォルト: 0.0 . Model: https://schema.org/Number
  • seve2[number]: 整流リアクタンス(Se[Ve2])の背面、対応する励磁電圧Ve2における励磁器飽和関数値。 代表値 = 1。デフォルト：0.0 . Model: https://schema.org/Number
  • source[string]: エンティティ・データの元のソースを URL として示す一連の文字。ソース・プロバイダの完全修飾ドメイン名、またはソース・オブジェクトの URL を推奨する。
  • tb1[number]: 電圧コントローラ微分ウォッシュアウト時定数（Tb1）。 代表値 = 12.45。デフォルト：0 . Model: https://schema.org/Number
  • te[number]: 時定数 (Te)。 代表値 = 0。デフォルト: 0 . Model: https://schema.org/Number
  • te2[number]: 時定数 (Te2)。 代表値 = 1。デフォルト：0 . Model: https://schema.org/Number
  • ti1[number]: コントローラ・フォローアップ・デッドバンド（Ti1）。 代表値 = 0 デフォルト: 0.0 . Model: https://schema.org/Number
  • ti3[number]: 時定数(Ti3)。 代表値 = 3。デフォルト：0 . Model: https://schema.org/Number
  • ti4[number]: 時定数（Ti4）。 代表値 = 0 デフォルト: 0 . Model: https://schema.org/Number
  • tr4[number]: 時定数 (Tr4)。 代表値 = 1。デフォルト：0。 . Model: https://schema.org/Number
  • type[string]: NGSIタイプ。ExcELIN2でなければならない。
  • upmax[number]: リミッター（Upmax）。 代表値 = 3。デフォルト：0.0。 . Model: https://schema.org/Number
  • upmin[number]: リミッター（Upmin）。 代表値 = 0 デフォルト: 0.0 . Model: https://schema.org/Number
  • ve1[number]: 飽和が定義される整流リアクタンス（Ve1）より後ろの励磁機オルタネータ出力電圧。 代表値 = 3。デフォルト：0.0 . Model: https://schema.org/Number
  • ve2[number]: 飽和が定義される整流リアクタンスより後ろの励磁機オルタネータ出力電圧（Ve2）。 デフォルト：0.0。 . Model: https://schema.org/Number
  • xp[number]: 励磁トランスの実効リアクタンス (Xp)。 代表値 = 1。デフォルト：0.0 . Model: https://schema.org/Number

必須プロパティ

CIMデータモデルとCIMpy - https://github.com/sogno-platform/cimpyからの引用。このデータモデルは、IEC61970標準によって規定された共通情報モデル（CIM）をスマートデータモデルに直接変換したものです。このモデルに基づくPythonクラスは、Institute for Automation of Complex Power Systems (ACS), EON Energy Research Center (EONERC) and RWTH University Aachen, Germanyによって開発されました。プロパティによっては、間違ったタイプを持つことがあります。このような場合は、問題を提起するか、[email protected] までメールをお送りください。

プロパティのデータモデル記述

アルファベット順（クリックで詳細表示）

full yaml details 
ExcELIN2:    
  description: 'Adapted from CIM data models. Detailed Excitation System Model - ELIN (VATECH).  This model represents an all-static excitation system. A PI voltage controller establishes a desired field current set point for a proportional current controller. The integrator of the PI controller has a follow-up input to match its signal to the present field current.  Power system stabilizer models used in conjunction with this excitation system model: PssELIN2, PssIEEE2B, Pss2B.'    
  properties:    
    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    
    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    
    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    
    efdbas:    
      description: 'Gain (Efdbas).  Typical Value = 0.1. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        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    
    iefmax:    
      description: 'Limiter (Iefmax).  Typical Value = 1. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    iefmax2:    
      description: 'Minimum open circuit excitation voltage (Iefmax2).  Typical Value = -5. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    iefmin:    
      description: 'Limiter (Iefmin).  Typical Value = 1. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    k1:    
      description: 'Voltage regulator input gain (K1).  Typical Value = 0. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    k1ec:    
      description: 'Voltage regulator input limit (K1ec).  Typical Value = 2. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    k2:    
      description: 'Gain (K2).  Typical Value = 5. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    k3:    
      description: 'Gain (K3).  Typical Value = 0.1. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    k4:    
      description: 'Gain (K4).  Typical Value = 0. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    kd1:    
      description: 'Voltage controller derivative gain (Kd1).  Typical Value = 34.5. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    ke2:    
      description: 'Gain (Ke2).  Typical Value = 0.1. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    ketb:    
      description: 'Gain (Ketb).  Typical Value = 0.06. Default: 0.0'    
      type: number    
      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    
    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    
    pid1max:    
      description: 'Controller follow up gain (PID1max).  Typical Value = 2. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        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    
    seve1:    
      description: 'Exciter saturation function value at the corresponding exciter voltage, Ve1, back of commutating reactance (Se[Ve1]).  Typical Value = 0. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    seve2:    
      description: 'Exciter saturation function value at the corresponding exciter voltage, Ve2, back of commutating reactance (Se[Ve2]).  Typical Value = 1. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        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    
    tb1:    
      description: 'Voltage controller derivative washout time constant (Tb1).  Typical Value = 12.45. Default: 0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    te:    
      description: 'Time constant (Te).  Typical Value = 0. Default: 0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    te2:    
      description: 'Time Constant (Te2).  Typical Value = 1. Default: 0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    ti1:    
      description: 'Controller follow up dead band (Ti1).  Typical Value = 0. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    ti3:    
      description: 'Time constant (Ti3).  Typical Value = 3. Default: 0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    ti4:    
      description: 'Time constant (Ti4).  Typical Value = 0. Default: 0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    tr4:    
      description: 'Time constant (Tr4).  Typical Value = 1. Default: 0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    type:    
      description: NGSI type. It has to be ExcELIN2    
      enum:    
        - ExcELIN2    
      type: string    
      x-ngsi:    
        type: Property    
    upmax:    
      description: 'Limiter (Upmax).  Typical Value = 3. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    upmin:    
      description: 'Limiter (Upmin).  Typical Value = 0. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    ve1:    
      description: 'Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve1).  Typical Value = 3. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    ve2:    
      description: 'Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve2).  Typical Value = 0. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
    xp:    
      description: 'Excitation transformer effective reactance (Xp).  Typical Value = 1. Default: 0.0'    
      type: number    
      x-ngsi:    
        model: https://schema.org/Number    
        type: Property    
  required: []    
  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.EnergyCIM/blob/master/ExcELIN2/LICENSE.md    
  x-model-schema: https://smart-data-models.github.io/dataModels.CIMEnergyClasses/ExcELIN2/schema.json    
  x-model-tags: ""    
  x-version: 0.0.1

ペイロードの例

ExcELIN2をJSON-LD形式でkey-valuesとした例は利用できない。options=keyValues`を使用した場合はNGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返す。

JSON-LD形式のExcELIN2を正規化した例はありません。これは、オプションを使用しない場合、NGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返します。

JSON-LD形式のExcELIN2のkey-valuesの例は利用できない。options=keyValues`を使うとNGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返す。

JSON-LD形式のExcELIN2を正規化した例はありません。これは、オプションを使用しない場合はNGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返します。

マグニチュード単位の扱い方については、FAQ 10を参照のこと。

Smart Data Models +++ Contribution Manual +++ About