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

matlab.System クラス

パッケージ: matlab

System object の基底クラス

説明

matlab.System は System object の基底クラスです。クラス定義ファイルでは、この基底クラス (またはこの基底クラスから派生する別のクラス) から、オブジェクトをサブクラス化しなければなりません。サブクラス化により、この基底クラスで提供されている実装やサービス メソッドを使用してオブジェクトを構成できるようになります。matlab.System 基底クラスから直接継承するには、クラス定義ファイルの最初の行で次の構文を入力します。ここで、ObjectName は構成するオブジェクト名です。

classdef ObjectName < matlab.System

メモ

コードで使用する各 matlab.System メソッドに対し、Access = protected と設定しなければなりません。

メソッド

allowModelReferenceDiscreteSampleTimeInheritanceImpl	離散サンプル時間に関するモデル参照のサンプル時間継承状態
getDiscreteStateImpl	離散状態プロパティ値
getGlobalNamesImpl	MATLAB システム ブロックのグローバル変数名
getHeaderImpl	System object 表示のヘッダー
getImpulseResponseLengthImpl	Dataflow Subsystem で用いる入力効果の長さを定義
getInputDimensionConstraintImpl	Dataflow Subsystem で用いる入力の次元制約を定義
getNumInputsImpl	System object への入力数
getNumOutputsImpl	System object からの出力数
getOutputDimensionConstraintImpl	Dataflow Subsystem で用いる出力の次元制約を定義
getSimulateUsingImpl	[シミュレーション実行方法] パラメーターの値を指定
getSimulinkFunctionNamesImpl	System object で使用する Simulink 関数名の登録
infoImpl	System object に関する情報
isDiscreteStateSpecificationMutableImpl	離散状態がデータ型を変更できるかどうかの制御
isInactivePropertyImpl	非アクティブなプロパティのステータス
isInputComplexityMutableImpl	System object の入力の実数/複素数が変更できるかどうかの設定
isInputDataTypeMutableImpl	System object の入力データ型が変更できるかどうかの設定
isInputSizeLockedImpl	入力サイズのロック状態
isInputSizeMutableImpl	System object の入力サイズが変更できるかどうかの設定
isTunablePropertyDataTypeMutableImpl	調整可能なプロパティがデータ型を変更できるかどうかの設定
loadObjectImpl	MAT ファイルからの System object の読み込み
processInputSpecificationChangeImpl	入力サイズ、実数/複素数、またはデータ型が変更されたときのアクションの実行
processTunedPropertiesImpl	調整可能なプロパティが変更された場合のアクション
releaseImpl	リソースの解放
resetImpl	System object の状態のリセット
saveObjectImpl	MAT ファイルへの System object の保存
setProperties	System object の作成時に名前と値のペアを使用したプロパティ値を設定
setupImpl	System object の初期化
showFiSettingsImpl	System object の固定小数点データ型タブの表示
showSimulateUsingImpl	[シミュレーション実行方法] パラメーターの可視性
stepImpl	システム出力と状態更新の式
supportsMultipleInstanceImpl	Simulink の For Each Subsystem における System object のサポート
validateInputsImpl	System object への入力の検証
validatePropertiesImpl	System object のプロパティ値の検証

属性

System object™ クラスおよびプロパティに属性を適用できます。属性の詳細については、クラスの属性またはプロパティの属性を参照してください。

クラス属性

次の表に、MATLAB^® System object クラスに適用できる属性を示します。

属性名

説明

StrictDefaults

仕様変更の変更を制限するメソッドの既定値をコントロールします。 isInputSizeMutableImpl isInputComplexityMutableImpl isInputDataTypeMutableImpl isTunablePropertyDataTypeMutableImpl isDiscreteStateDataTypeMutableImpl 既定では、これらのメソッドは true を返します。このクラス属性を追加すると、これらのメソッドは既定で false を返します。これらのメソッドが false を返すようにすることで、指定された入力の特性、調整可能なプロパティ、離散状態が変更できなくなります。これらのメソッドはいつでも個別に実装できます。カスタマイズされたメソッドは StrictDefaults 属性より優先されます。 Simulink® で使用される System object については、この属性は入力サイズの変更のみを制限します。Simulink は既に、調整可能なプロパティ、入力および状態について、実数/複素数およびデータ型を制限しているためです。

クラス属性値はクラス名の前にかっこで囲んで指定します。たとえば次のようにします。

classdef (StrictDefaults) MySystemObject < matlab.System

プロパティの属性

次の属性をカスタム System object の任意のプロパティに適用できます。

Nontunable	Nontunable を使用して、オブジェクトの使用中にユーザーがプロパティ値を変更できないようにします。既定の設定では、すべてのプロパティは調整可能です。Nontunable 属性は、変更すると副次的影響が出るプロパティをロックするのに便利です。またこの属性は、処理中に一定であると仮定されているプロパティ値をロックするのにも便利です。入力端子や出力端子の数に影響を及ぼすプロパティは、常に Nontunable に指定します。
Logical	Logical を使用すると、プロパティ値が論理スカラー値に制限されます。0 や 1 など、logicalに変換できる任意のスカラー値も有効です。
PositiveInteger	PositiveInteger を使用すると、プロパティ値が正の整数に制限されます。
DiscreteState	DiscreteState を使用すると、getDiscreteState メソッドを使用したときに状態値が表示されるようにプロパティがマークされます。

例

基本的な System object の作成

matlab.System からサブクラス化される単純な System object AddOne を作成します。このコードを MATLAB ファイル AddOne.m に配置します。

classdef AddOne < matlab.System
% ADDONE Compute an output value that increments the input by one

    methods (Access = protected)
       % stepImpl method is called when the object is called.
       function y = stepImpl(~,x)
          y = x + 1;
       end    
    end
end

AddOne のインスタンスを作成し、入力を指定してオブジェクトを実行することで、このオブジェクトを使用します。

hAdder = AddOne;
x = 1;
hAdder(x);

クラス定義ファイルで定義する InitialValue プロパティに Nontunable 属性を割り当てます。

properties (Nontunable)
   InitialValue
end

参考

matlab.system.StringSet | matlab.system.display.Action | matlab.system.display.Header | matlab.system.display.Section | matlab.system.display.SectionGroup | matlab.system.mixin.CustomIcon | matlab.system.mixin.FiniteSource | matlab.system.mixin.Nondirect | matlab.system.mixin.Propagates | matlab.system.mixin.SampleTime

トピック

• クラス
• クラスの属性
• プロパティの属性
• メソッドの属性
• 基本的な System object の定義
• プロパティ属性の定義