【HALCON】scale_y_funct_1d 関数について - 1D関数のY軸スケーリング

HALCONのscale_y_funct_1d関数は、1D関数のY軸の値を指定されたスケールでスケーリングし、新しい関数を生成するための関数です。この関数は、Y軸方向のデータの振幅や範囲を調整する際に便利で、元の1D関数を保持しながらスケーリング済みの新しい関数を生成します。

scale_y_funct_1d 関数の概要

scale_y_funct_1d関数は、1D関数のY値をスケール値に基づいて拡大または縮小します。元の関数は変更せず、新しいスケールされた関数が生成されます。

関数の構文

scale_y_funct_1d(Function, Scale, &FunctionScaled)

• Function
  元の1D関数。
• Scale
  Y軸に適用するスケーリング値。
• FunctionScaled
  スケールされた新しい1D関数。

使用例

次の例では、1D関数のY軸方向の値を2倍にスケーリングし、新しい関数を生成します。

* 1D関数の作成
create_funct_1d("parabola", 0.0, 1.0, 0.1, &Function)

* Y軸方向に2倍のスケーリングを適用
scale_y_funct_1d(Function, 2.0, &FunctionScaled)

* スケーリング結果を表示
disp_funct_1d(FunctionScaled)

このコードでは、Functionという元の関数が2倍のスケーリングを適用され、新しい関数FunctionScaledが生成されます。

応用シナリオ

• データの調整: 元のデータを保持しつつ、データの範囲や振幅を調整したい場合に役立ちます。
• 信号処理: 信号データの振幅を調整して、異なる強度で解析や検証を行う際に便利です。
• 関数フィッティング: 元の関数を変更せずに、異なるスケールでの関数フィッティングを行いたい場合に使用します。

スケーリング結果の具体例

1D関数をスケール値2.0で拡大した場合、Y軸の値が2倍に拡大されます。元の関数を保持しながら、新しいスケール済みの関数を生成することで、元データの安全性を保ちつつ、様々なスケールでのデータ検証を行うことができます。

結論

HALCONのscale_y_funct_1d関数は、1D関数のY軸スケーリングを行い、元の関数を変更せずに新しい関数を生成します。データ検証や信号処理の際に、元データを保持しながら異なるスケールで結果を確認できるため、効率的かつ安全な処理が可能です。