merge

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

構文

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

説明

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

例

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

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

load whales

getMemberNames(lss)

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

labelDefinitionsSummary(lss)

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

    "WhaleType"       "attribute"    "categorical"    {3×1 string}       {["N/A"   ]}       {0×0 double}    {0×0 double               }    ""     "Whale type"                
    "MoanRegions"     "roi"          "logical"        {["N/A"   ]}       {0×0 double}       {0×0 double}    {0×0 double               }    ""     "Regions where moans occur" 
    "TrillRegions"    "roi"          "logical"        {["N/A"   ]}       {0×0 double}       {0×0 double}    {1×1 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"    {3×1 string}       {["N/A"   ]}       {0×0 double}    {0×0 double               }    ""     "Whale type"                          
    "TrillRegions"    "roi"          "logical"        {["N/A"   ]}       {0×0 double}       {0×0 double}    {1×1 signalLabelDefinition}    ""     "Regions where trills occur"          
    "Calf"            "attribute"    "logical"        {["N/A"   ]}       {0×0 double}       {[       0]}    {0×0 double               }    ""     "Is the specimen a calf, or an adult?"

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

lssmerge = merge(lss,newlss);

getMemberNames(lssmerge)

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

labelDefinitionsSummary(lssmerge)

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

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

入力引数

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

labeledSignalSet オブジェクト

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

出力引数

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

labeledSignalSet オブジェクト

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

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

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

バージョン履歴

R2020a で導入

参考

信号ラベラー | labeledSignalSet | signalLabelDefinition