メインコンテンツ

parameters

ドメインまたはコンポーネントのパラメーターを宣言する

親の節: component | domain

構文

parameters
    par1 = {value,'unit'};
end

説明

parameters はパラメーター宣言セクションを開始し、end キーワードで終了します。

  • コンポーネント ファイルでは、このセクションにはコンポーネント パラメーターの宣言が含まれます。コンポーネント パラメーターを使用すると、コンポーネント ファイルから生成された Simscape™ ブロックの調整可能なパラメーターを指定できます。パラメーターはブロック ダイアログ ボックスに表示され、モデルのビルドおよびシミュレーション時に変更できます。

  • ドメイン ファイルでは、このセクションにはドメイン パラメーターの宣言が含まれます。ドメイン パラメーターの主な目的は、同じパラメーター値を、ドメインに接続されているコンポーネントのすべてまたは一部に伝播することです。

各パラメーターは、単位付きの値として宣言します。

parameters
    par1 = {value,'unit'};
end

value は初期パラメーター値です。unit は、単位レジストリで定義されている有効な単位文字列です。

単位なしのパラメーターを宣言するために、同じ構文を使用できます。

 par1 = {value,'1'};

あるいは、単位を省略して次の構文を使用することもできます。

 par1 = value;

ただし、内部的には、このパラメーターは 2 つのメンバーの値と単位の配列 {value,'1'} として扱われます。

コンポーネント パラメーターの場合、パラメーター宣言の後にコメントを追加することで、パラメーター名 (ブロック ダイアログ ボックスでパラメーターをどのように表示するか) を指定できます。

parameters
    comp_par1 = {value,'unit'}; % Parameter name
end

すべて展開する

次の例では、回転バネのバネ定数を指定するコンポーネント パラメーター k (既定値 10 N*m/rad) を宣言します。ブロック ダイアログ ボックスおよびプロパティ インスペクターでは、このパラメーターの名前は [Spring rate] になります。

parameters
    k = {10,'N*m/rad'};   % Spring rate
end

ドメイン パラメーターの目的は、同じパラメーター値を、ドメインに接続されているコンポーネントのすべてまたは一部に伝播することです。たとえば、次の油圧ドメインには、1 つのアクロス変数 p、1 つのスルー変数 q、および 1 つのパラメーター t が含まれています。

domain t_hyd
  variables
    p = {1e6,'Pa'}; % pressure
  end
  variables(Balancing = true)
    q = {1e-3,'m^3/s'}; % flow rate
  end
  parameters
    t = {303,'K'}; % fluid temperature
  end
end

このドメインに接続されたノードをもつすべてのコンポーネントは、流体温度パラメーター t にアクセスでき、このパラメーターを方程式で使用できます。

バージョン履歴

R2008b で導入