ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

symReadSSCParameters

Simscape コンポーネントからのパラメーターの読み込み

説明

[names,values,units] = symReadSSCParameters(componentName) は、componentName と呼ばれる Simscape™ コンポーネントから、すべてのパラメーターの名前、値および単位を含む cell 配列を返します。

すべて折りたたむ

Simscape コンポーネントのパラメーターの名前、値および単位を読み込みます。

現在のフォルダーに Simscape コンポーネント friction.ssc があるとします。

type('friction.ssc');
component friction < foundation.mechanical.rotational.branch

parameters
    brkwy_trq = { 25, 'N*m' };          % Breakaway friction torque
    Col_trq = { 20, 'N*m' };            % Coulomb friction torque
    visc_coef = { 0.001, 'N*m*s/rad' }; % Viscous friction coefficient
    trans_coef = { 10, 's/rad' };       % Transition approximation coefficient
    vel_thr = { 1e-4, 'rad/s' };        % Linear region velocity threshold
end

parameters (Access=private)
    brkwy_trq_th = { 24.995, 'N*m' };   % Breakaway torque at threshold velocity
end

function setup
    % Parameter range checking
    if brkwy_trq <= 0
        pm_error('simscape:GreaterThanZero','Breakaway friction torque' )
    end
    if Col_trq <= 0
        pm_error('simscape:GreaterThanZero','Coulomb friction torque' )
    end
    if Col_trq > brkwy_trq
        pm_error('simscape:LessThanOrEqual','Coulomb friction torque',...
                  'Breakaway friction torque')
    end
    if visc_coef < 0
        pm_error('simscape:GreaterThanOrEqualToZero','Viscous friction coefficient')
    end
    if trans_coef <= 0
        pm_error('simscape:GreaterThanZero','Transition approximation coefficient')
    end
    if vel_thr <= 0
        pm_error('simscape:GreaterThanZero','Linear region velocity threshold')
    end

    % Computing breakaway torque at threshold velocity
    brkwy_trq_th = visc_coef * vel_thr + Col_trq + (brkwy_trq - Col_trq) * ...
        exp(-trans_coef * vel_thr);
end

equations
    if (abs(w) <= vel_thr)
        % Linear region
        t == brkwy_trq_th * w / vel_thr;
    elseif w > 0
        t == visc_coef * w + Col_trq + ...
            (brkwy_trq - Col_trq) * exp(-trans_coef * w);
    else
        t == visc_coef * w - Col_trq - ...
            (brkwy_trq - Col_trq) * exp(-trans_coef * abs(w));
    end
end

end

コンポーネント friction.ssc のパラメーターの名前、値および単位を読み込みます。

[names,values,units] = symReadSSCParameters('friction.ssc');

この例では、結果の cell 配列のすべての要素がスカラーです。cell 配列はシンボリック ベクトルに変換できます。

names_sym = cell2sym(names)
names_sym =
[ Col_trq, brkwy_trq, brkwy_trq_th, trans_coef, vel_thr, visc_coef]
values_sym = cell2sym(values)
values_sym =
[ 20, 25, 4999/200, 10, 1/10000, 1/1000]

MATLAB® ワークスペースにある cell 配列 names の要素から個々のシンボリック変数を作成します。このコマンドは、シンボリック変数 Col_trqbrkwy_trqbrkwy_trq_thtrans_coefvel_thr および visc_coefsym オブジェクトとしてワークスペースに作成します。

syms(names)

入力引数

すべて折りたたむ

Simscape コンポーネント名。一重引用符で囲まれたファイル名として指定します。ファイルには拡張子 .ssc が付いていなければなりません。ファイル拡張子を指定しない場合、symReadSSCParameters によって .ssc であると仮定されます。コンポーネントは MATLAB パス上または現在のフォルダーになければなりません。

例: 'MyComponent.ssc'

出力引数

すべて折りたたむ

Simscape コンポーネントのすべてのパラメーターの名前。cell 配列として返されます。

データ型: cell

Simscape コンポーネントのすべてのパラメーターの値。cell 配列として返されます。

データ型: cell

Simscape コンポーネントのすべてのパラメーターの単位。cell 配列として返されます。

データ型: cell

R2016a で導入