このページは機械翻訳を使用して翻訳されました。最新版の英語を参照するには、ここをクリックします。

perturbations

オブジェクトに定義された摂動

R2024a 以降

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

構文

perturbs = perturbations(obj)
perturbs = perturbations(obj,property)
perturbs = perturbations(obj,property,'None')
perturbs = perturbations(obj,property,'Selection',values,probabilities)
perturbs = perturbations(obj,property,'Normal',mean,deviation)
perturbs = perturbations(obj,property,'TruncatedNormal',mean,deviation,lowerLimit,upperLimit)
perturbs = perturbations(obj,property,'Uniform',minVal,maxVal)
perturbs = perturbations(obj,property,'Custom',perturbFcn)

説明

perturbs = perturbations(obj) は、オブジェクト obj で定義されたプロパティ摂動のリスト perturbs を返します。返される perturbs には、すべての摂動可能なプロパティがリストされます。どのプロパティも変化しない場合は、対応する Type は "Null" として返され、対応する Value は {Null,Null} として返されます。

perturbs = perturbations(obj,property) は、指定された property に適用された現在の摂動を返します。

perturbs = perturbations(obj,property,'None') は、乱してはならない property を定義します。

perturbs = perturbations(obj,property,'Selection',values,probabilities) は、対応する probabilities を持つ values のセットから抽出された property 摂動オフセットを定義します。

例

perturbs = perturbations(obj,property,'Normal',mean,deviation) は、指定された mean と標準の deviation を使用して正規分布から抽出された property 摂動オフセットを定義します。

perturbs = perturbations(obj,property,'TruncatedNormal',mean,deviation,lowerLimit,upperLimit) は、指定された mean、標準 deviation、下限、上限を持つ正規分布から抽出された property 摂動オフセットを定義します。

perturbs = perturbations(obj,property,'Uniform',minVal,maxVal) は、区間 [minVal, maxValue] 上の均一分布から抽出された property 摂動オフセットを定義します。

perturbs = perturbations(obj,property,'Custom',perturbFcn) を使用すると、摂動オフセット値を描くカスタム関数 perturbFcn を定義できます。

例

すべて折りたたむ

ライブ スクリプトを開く

insSensor オブジェクトを作成します。

sensor = insSensor
sensor = 
  insSensor with properties:

           MountingLocation: [0 0 0]            m    
               RollAccuracy: 0.2                deg  
              PitchAccuracy: 0.2                deg  
                YawAccuracy: 1                  deg  
           PositionAccuracy: [1 1 1]            m    
           VelocityAccuracy: 0.05               m/s  
       AccelerationAccuracy: 0                  m/s² 
    AngularVelocityAccuracy: 0                  deg/s
                  TimeInput: 0                       
               RandomStream: 'Global stream'

それぞれ等しい可能性をもつ 3 つの値として RollAccuracy プロパティの摂動を定義します。

values = {0.1 0.2 0.3}
values=1×3 cell array
    {[0.1000]}    {[0.2000]}    {[0.3000]}


probabilities = [1/3 1/3 1/3]
probabilities = 1×3

    0.3333    0.3333    0.3333


perturbations(sensor,'RollAccuracy','Selection',values,probabilities)
ans=7×3 table
            Property                Type                        Value                 
    _________________________    ___________    ______________________________________

    "RollAccuracy"               "Selection"    {1×3 cell}    {[0.3333 0.3333 0.3333]}
    "PitchAccuracy"              "None"         {[   NaN]}    {[                 NaN]}
    "YawAccuracy"                "None"         {[   NaN]}    {[                 NaN]}
    "PositionAccuracy"           "None"         {[   NaN]}    {[                 NaN]}
    "VelocityAccuracy"           "None"         {[   NaN]}    {[                 NaN]}
    "AccelerationAccuracy"       "None"         {[   NaN]}    {[                 NaN]}
    "AngularVelocityAccuracy"    "None"         {[   NaN]}    {[                 NaN]}

関数 perturb を使用して、sensor オブジェクトに摂動を与えます。

rng(2020)
perturb(sensor);
sensor
sensor = 
  insSensor with properties:

           MountingLocation: [0 0 0]            m    
               RollAccuracy: 0.5                deg  
              PitchAccuracy: 0.2                deg  
                YawAccuracy: 1                  deg  
           PositionAccuracy: [1 1 1]            m    
           VelocityAccuracy: 0.05               m/s  
       AccelerationAccuracy: 0                  m/s² 
    AngularVelocityAccuracy: 0                  deg/s
                  TimeInput: 0                       
               RandomStream: 'Global stream'

RollAccuracy が 0.5 度に摂動されます。

入力引数

すべて折りたたむ

摂動の対象となるオブジェクト。オブジェクトとして指定します。摂動を与えることができるオブジェクトには次のものがあります。

    プロパティ名として指定された摂動可能なプロパティ。指定された obj の摂動可能なプロパティの完全なリストを取得するには、perturbations を使用します。

    摂動オフセット値。プロパティ値の n 要素のセル配列として指定されます。この関数は、probabilities 入力で指定された値の対応する確率に基づいて、セル配列からプロパティの摂動値をランダムに抽出します。

    各摂動値の描画確率。非負スカラーの n 要素配列として指定されます。ここで、n は values 入力で提供される摂動値の数です。すべての要素の合計は 1 に等しくなければなりません。

    たとえば、一連の摂動値と確率のペアを {x1,x2,…,xn} および {p1,p2,…,pn} として指定できます。ここで、xi を引く確率は pi (i = 1, 2, …,n) です。

    スカラー、ベクトル、または行列として指定された、正規分布または切断正規分布の平均。mean の次元は、摂動する対応するプロパティと互換性がある必要があります。

    正規分布または切り捨て正規分布の標準偏差。非負のスカラー、非負のスカラーのベクトル、または非負のスカラーの行列として指定されます。deviation の次元は、摂動する対応するプロパティと互換性がある必要があります。

    切り捨て正規分布の下限。スカラー、ベクトル、または行列として指定します。lowerLimit の次元は、摂動する対応するプロパティと互換性がある必要があります。

    切り捨て正規分布の上限。スカラー、ベクトル、または行列として指定します。upperLimit の次元は、摂動する対応するプロパティと互換性がある必要があります。

    均一分布間隔の最小値。スカラー、ベクトル、または行列として指定します。minVal の次元は、摂動する対応するプロパティと互換性がある必要があります。

    均一分布間隔の最大値。スカラー、ベクトル、または行列として指定します。maxVal の次元は、摂動する対応するプロパティと互換性がある必要があります。

    関数ハンドルとして指定された摂動関数。関数の構文は次のようになります。

    offset = myfun(propVal)
    ここで、propVal は property の値であり、offset はプロパティの摂動オフセットです。

    出力引数

    すべて折りたたむ

    オブジェクトに定義された摂動。摂動プロパティのテーブルとして返されます。表には 3 つの列があります。

    • Property — プロパティ名。

    • Type — 摂動の種類。"None"、"Selection"、"Normal"、"TruncatedNormal"、"Uniform"、または "Custom" として返されます。

    • Value — 摂動値。セル配列として返されます。

    詳細

    すべて折りたたむ

    バージョン履歴

    R2024a で導入

    参考