merge

2 つ以上のラベル付き信号セットのマージ

R2020a 以降

構文

lssnew = merge(lss1,...,lssN)

説明

lssnew = merge(lss1,...,lssN) は、N 個のラベル付き信号セットのオブジェクト lss1,...,lssN をマージし、入力セットのすべてのメンバーとラベル値を含むラベル付き信号セット lssnew を返します。

例

ラベル付き信号セットのマージ

クジラの歌の録音を含むラベル付き信号セットを読み込みます。セットのメンバー名およびラベル定義の概要を表示します。

load whales

getMemberNames(lss)

ans = 2x1 string
    "Member{1}"
    "Member{2}"

labelDefinitionsSummary(lss)

ans=3×9 table
      LabelName        LabelType     LabelDataType     Categories     ValidationFunction    DefaultValue             Sublabels             Tag            Description         
    ______________    ___________    _____________    ____________    __________________    ____________    ___________________________    ___    ____________________________

    "WhaleType"       "attribute"    "categorical"    {3x1 string}       {["N/A"   ]}       {0x0 double}    {0x0 double               }    ""     "Whale type"                
    "MoanRegions"     "roi"          "logical"        {["N/A"   ]}       {0x0 double}       {0x0 double}    {0x0 double               }    ""     "Regions where moans occur" 
    "TrillRegions"    "roi"          "logical"        {["N/A"   ]}       {0x0 double}       {0x0 double}    {1x1 signalLabelDefinition}    ""     "Regions where trills occur"

同じデータ ソース、時間情報、およびラベルを持つ新しい信号セットを lss として作成します。新しいセットの最初のメンバーを削除し、残ったメンバーの名前を変更します。新しいセットのメンバー名を表示します。

newlss = copy(lss);

removeMembers(newlss,1)
setMemberNames(newlss,"YoungOne")

getMemberNames(newlss)

ans = 
"YoungOne"

信号が子供のクジラに対応するのか、成体のクジラに対応するのかを指定するラベル定義を作成します。新しいラベル付き信号セットに定義を追加し、メンバーにラベルを付けます。うめき声の領域を指定するラベルを削除します。新しいメンバーのラベル定義の概要を表示します。

calf = signalLabelDefinition('Calf','LabeldataType','logical','DefaultValue',false, ...
    'Description','Is the specimen a calf, or an adult?');

addLabelDefinitions(newlss,calf)
setLabelValue(newlss,1,"Calf",true)

removeLabelDefinition(newlss,"MoanRegions")
labelDefinitionsSummary(newlss)

ans=3×9 table
      LabelName        LabelType     LabelDataType     Categories     ValidationFunction    DefaultValue             Sublabels             Tag                 Description              
    ______________    ___________    _____________    ____________    __________________    ____________    ___________________________    ___    ______________________________________

    "WhaleType"       "attribute"    "categorical"    {3x1 string}       {["N/A"   ]}       {0x0 double}    {0x0 double               }    ""     "Whale type"                          
    "TrillRegions"    "roi"          "logical"        {["N/A"   ]}       {0x0 double}       {0x0 double}    {1x1 signalLabelDefinition}    ""     "Regions where trills occur"          
    "Calf"            "attribute"    "logical"        {["N/A"   ]}       {0x0 double}       {[       0]}    {0x0 double               }    ""     "Is the specimen a calf, or an adult?"

2 つのラベル付き信号セットをマージします。マージしたセットに元のセットのメンバー、定義、およびラベルが含まれていることを確認します。

lssmerge = merge(lss,newlss);

getMemberNames(lssmerge)

ans = 3x1 string
    "Member{1}"
    "Member{2}"
    "YoungOne"

labelDefinitionsSummary(lssmerge)

ans=4×9 table
      LabelName        LabelType     LabelDataType     Categories     ValidationFunction    DefaultValue             Sublabels             Tag                 Description              
    ______________    ___________    _____________    ____________    __________________    ____________    ___________________________    ___    ______________________________________

    "WhaleType"       "attribute"    "categorical"    {3x1 string}       {["N/A"   ]}       {0x0 double}    {0x0 double               }    ""     "Whale type"                          
    "MoanRegions"     "roi"          "logical"        {["N/A"   ]}       {0x0 double}       {0x0 double}    {0x0 double               }    ""     "Regions where moans occur"           
    "TrillRegions"    "roi"          "logical"        {["N/A"   ]}       {0x0 double}       {0x0 double}    {1x1 signalLabelDefinition}    ""     "Regions where trills occur"          
    "Calf"            "attribute"    "logical"        {["N/A"   ]}       {0x0 double}       {[       0]}    {0x0 double               }    ""     "Is the specimen a calf, or an adult?"

入力引数

lss1,...,lssN — 入力ラベル付き信号セット

labeledSignalSet オブジェクト

入力ラベル付き信号セット。labeledSignalSet オブジェクトとして指定します。すべての入力セットの時間情報の設定およびデータ ソース タイプが同じでなければなりません。

出力引数

lssnew — マージされたラベル付き信号セット

labeledSignalSet オブジェクト

マージされたラベル付き信号セット。labeledSignalSet オブジェクトとして返されます。セット lssnew には、入力ラベル付き信号セットから独立した信号ソース、ラベル定義、およびラベル値が含まれます。

• 入力ラベル付き信号セットのいずれかを変更しても、マージされたラベル付き信号セットに影響はありません。

• マージされた入力ラベル付き信号セットを変更しても、入力ラベル付き信号セットに影響はありません。

バージョン履歴

R2020a で導入

参考

labeledSignalSet | signalLabelDefinition