Main Content

editLabelDefinition

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

R2018b 以降

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

構文

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: {2x1 cell}
         NumMembers: 2
    TimeInformation: "sampleRate"
         SampleRate: 4000
             Labels: [2x3 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 = 3x1 string
    "WhaleType"
    "MoanRegions"
    "TrillRegions"

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

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

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

 Use labeledSignalSet to create a labeled signal set.


types = types.Categories
types = 3x1 string
    "blue"
    "humpback"
    "white"

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

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

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

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

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

                      Name: "TrillPeaks"
                 LabelType: "point"
             LabelDataType: "numeric"
        ValidationFunction: []
    PointLocationsDataType: "double"
              DefaultValue: []
                 Sublabels: [0x0 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: [0x0 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 で導入

参考

| |