editLabelDefinition

ラベルの定義のプロパティの編集

ページ内をすべて折りたたむ

構文

editLabelDefinition(lss,lblName,propName,val)

説明

editLabelDefinition(lss,lblName,propName,val) は、ラベルまたはサブラベルの定義 lblName の propName プロパティを val に変更します。

この関数は、Name、DefaultValue、Tag、Description、およびCategoriesプロパティのみを編集できます。ラベルの定義のその他のプロパティを変更するには、removeLabelDefinition を使用してその定義を削除してから、addLabelDefinitions を使用して目的のプロパティ値を持つ定義を追加します。

  • DefaultValueプロパティを編集した場合、既存のすべてのラベル値は変更されません。新しい既定値は、新しいメンバー、新しい領域、または新しい点にのみ適用されます。

  • Categoriesプロパティは、ターゲットのラベルまたはサブラベルの定義のLabelDataTypeが 'Categorical' の場合にのみ編集できます。

新しく指定されたカテゴリにより既存のカテゴリが置き換えられることはありません。既存の値に追加されます。

例

例

すべて折りたたむ

ライブ スクリプトを開く

クジラの歌の録音を含むラベル付き信号セットを読み込みます。ラベルの名前を取得します。

load whales
lss
lss = 
  labeledSignalSet with properties:

             Source: {2×1 cell}
         NumMembers: 2
    TimeInformation: "sampleRate"
         SampleRate: 4000
             Labels: [2×3 table]
        Description: "Characterize wave song regions"

 Use labelDefinitionsHierarchy to see a list of labels and sublabels.
 Use setLabelValue to add data to the set.


getLabelNames(lss)
ans = 3×1 string
    "WhaleType"
    "MoanRegions"
    "TrillRegions"

最初のラベルは、クジラの種類に対応しています。セットで利用可能な種類を取得します。

lbldefs = getLabelDefinitions(lss);
types = lbldefs(1)
types = 
  signalLabelDefinition with properties:

             Name: "WhaleType"
        LabelType: "attribute"
    LabelDataType: "categorical"
       Categories: [3×1 string]
     DefaultValue: []
        Sublabels: [0×0 signalLabelDefinition]
              Tag: ""
      Description: "Whale type"

 Use labeledSignalSet to create a labeled signal set.


types = types.Categories
types = 3×1 string
    "blue"
    "humpback"
    "white"

ラベルを変更して、マッコウクジラとシャチを組み込みます。ラベル付き信号セットに 2 つの新しいクジラの種類が含まれていることを確認します。

editLabelDefinition(lss,'WhaleType', ...
    'Categories',{'sperm','killer'})

lbldefs = getLabelDefinitions(lss);
types = lbldefs(1).Categories
types = 5×1 string
    "blue"
    "humpback"
    "white"
    "sperm"
    "killer"

ふるえ声の領域の定義には、ピークを識別するサブラベルがあります。

lbldefs(3).Sublabels
ans = 
  signalLabelDefinition with properties:

                      Name: "TrillPeaks"
                 LabelType: "point"
             LabelDataType: "numeric"
        ValidationFunction: []
    PointLocationsDataType: "double"
              DefaultValue: []
                 Sublabels: [0×0 signalLabelDefinition]
                       Tag: ""
               Description: "Trill peaks"

 Use labeledSignalSet to create a labeled signal set.

サブラベルの説明を変更します。

editLabelDefinition(lss,["TrillRegions" "TrillPeaks"], ...
    Description="Peaks of trill regions")

lbldefs = getLabelDefinitions(lss);
lbldefs(3).Sublabels
ans = 
  signalLabelDefinition with properties:

                      Name: "TrillPeaks"
                 LabelType: "point"
             LabelDataType: "numeric"
        ValidationFunction: []
    PointLocationsDataType: "double"
              DefaultValue: []
                 Sublabels: [0×0 signalLabelDefinition]
                       Tag: ""
               Description: "Peaks of trill regions"

 Use labeledSignalSet to create a labeled signal set.

入力引数

すべて折りたたむ

ラベル付き信号セット。labeledSignalSet オブジェクトとして指定します。

例: labeledSignalSet({randn(100,1) randn(10,1)},signalLabelDefinition("female")) は、属性 "female" を含むランダム信号の 2 つのメンバーのセットを指定します。

ラベルまたはサブラベル名。ラベルを指定するには、文字ベクトルまたは string スカラーを使用します。サブラベルを指定するには、文字ベクトルの 2 要素 cell 配列または 2 要素 string 配列を使用します。

  • 最初の要素は親ラベルの名前です。

  • 2 番目の要素はサブラベルの名前です。

例: signalLabelDefinition("Asleep",'LabelType','roi') は、臨床試験中に患者が睡眠状態であった信号の領域用に、"Asleep" という名前のラベルを指定します。

例: {'Asleep' 'REM'} または ["Asleep" "REM"] は、患者がレム睡眠状態である信号の領域を指定します。

プロパティ名。'Name'、'DefaultValue'、'Tag'、'Description'、または 'Categories' として指定します。

データ型: char | string

ラベル値。数値または logical 値、文字ベクトルまたは string、string のベクトル、または文字ベクトルの cell 配列として指定します。val は、propName に指定したデータ型でなければなりません。

バージョン履歴

R2018b で導入

参考

| |