Main Content

getLabelNames

ラベル付き信号セットのラベル名の取得

説明

lblnames = getLabelNames(lss) は、ラベル付き信号セット lss のラベル名を含む string 配列を返します。

sublblnames = getLabelNames(lss,lblname) は、ラベル付き信号セット lsslblname という名前のラベルのサブラベル名を含む string 配列を返します。

getLabelNames(lss,Name=Value) は、名前と値の引数を使用して指定した値にラベル タイプとフレーム ポリシーが等しいラベルについて、そのラベル付き信号セットのラベル名を含む string 配列を返します。

すべて折りたたむ

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

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.

セット内のラベルの名前を取得します。

str = getLabelNames(lss)
str = 3x1 string
    "WhaleType"
    "MoanRegions"
    "TrillRegions"

'TrillRegions' ラベルのみがサブラベルを持つことを確認します。

for kj = 1:length(str)
    sbstr = str{kj};
    sbl = [sbstr getLabelNames(lss,sbstr)]
end
sbl = 
"WhaleType"
sbl = 
"MoanRegions"
sbl = 1x2 string
    "TrillRegions"    "TrillPeaks"

入力引数

すべて折りたたむ

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

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

ラベル名。文字ベクトルまたは string スカラーとして指定します。

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

名前と値の引数

例: getLabelNames(lss,LabelType="roiFeature",FrameSize=50,FrameOverlapLength=5) は、フレーム サイズが 50 でフレームのオーバーラップの長さが 5 の roiFeature ラベルの名前を返します。

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

ラベル タイプ。"attribute""roi""point""attributeFeature"、または "roiFeature" として指定します。

例: LabelType="attribute"

データ型: char | string

フレーム サイズ。数値スカラーとして指定します。この引数を有効にするには、LabelType"roiFeature" に設定します。

例: LabelType="roiFeature",FrameSize=50

データ型: double

フレームのオーバーラップの長さ。数値スカラーとして指定します。この引数を有効にするには、LabelType"roiFeature" に設定します。FrameOverlapLengthFrameRate を同時に指定することはできません。

例: LabelType="roiFeature",FrameSize=50,FrameOverlapLength=5

データ型: double

フレーム レート。数値スカラーとして指定します。この引数を有効にするには、LabelType"roiFeature" に設定します。FrameRateFrameOverlapLength を同時に指定することはできません。

例: LabelType="roiFeature",FrameSize=50,FrameRate=45

データ型: double

出力引数

すべて折りたたむ

ラベル名。string 配列として返されます。

サブラベル名。string 配列として返されます。

バージョン履歴

R2018b で導入