0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

2つの関数が同じ入力なら同じ結果を返すことを保証するテストフレームワーク(9)

0
Last updated at Posted at 2026-11-17

この回では、IntelのIntrinsic関数をOpenPOWERへポートするために必要なテストフレームワークToukaのモジュール構成とモジュールごとのインターフェースや仕様について定義していこうかと思う。テストフレームワークはC言語で構築される。モジュールごとの正しさはテスト駆動開発で確認されるかもしれない。

データシリアライザ、データデシリアライザはテストデータ作成ソフトウェア、テスト実行ソフトウェア、テストデータ解析ソフトウェアそれぞれにおいて共通である。x86とOpenPOWERにおいても共通である。

テストを実行するソフトウェアを作る必要がある。モジュール構成は以下のようになる。x86とOpenPOWERの両方作る必要がある。

  • データシリアライザ(Data_Seriarizer)
      __m128の型の情報をバイナリデータにする
  • データデシリアライザ
      バイナリデータを__m128の型の情報に戻す
  • バイナリセーバー
      テストしたデータをファイルにセーブする。
      入力:テストにおける__Aと__Bと戻り値の集合
  • バイナリローダー
      テストするためのデータをファイルからロードする。
  • テストデータストア
      テストした、または、これからテストするデータをストアする。また、テストするデータを一個一個出力して行って、結果をストアする。
     以下のようなデータを保存する必要がある。テストする個数分ストアする
    __A
    __B
    戻り値
    エラー情報
    テストのインデックスを入力したらテスト内容を返す。
  • SIMDIntrinsic演算実行部(SIMD_Executer)
    x86においてはIntrinsic関数、OpenPOWERにおいてはそれをポートしたものを実行する。
       入力:__m128の型の__Aと__B
     出力 :__m128の型の戻り値
  • 制御部(Controller)

テストデータを作るソフトウェアを作る必要がある。以下のようなモジュール構成となる。x86のみでOK

  • ランダム値浮動小数点生成部(Random_FloatingPoint_Generator)
      出力:32ビット浮動小数点数
  • 浮動小数点エッヂケース生成部(FloatingPoint_Edgecase_Generator)
       出力:32ビット浮動小数点数
  • ランダム整数生成部(Random_Interger_Generator)
    出力:32ビット整数
  • 整数エッヂケース生成(Integer_Edgecase_Generator)
      出力:32ビット整数
  • __m128形成部(__m126_Generator)
      入力:32ビット浮動小数点✕4
     出力:__m128
    注:Intrinsicの種類によって入力される型や形成法は異なってくる
  • テストデータストア
      テストされるデータ全てを保存する。
  • バイナリセーバー
     テストするデータをセーブする。

テスト結果を解析するソフトウェアも作る必要がある。以下のようなモジュール構成となる。x86のみでOK。

  • テストデータストア
     テストされたデータ全てを保存する

それぞれのソフトウェアにおいて共通するモジュールは以下のようなものとなる。x86とOpenPOWERにおいても共通となる。

  • データシリアライザ
  • データデシリアライザ
  • __m128形成部
  • テストデータストア

モジュールごとの正しさを保証するテストコードは以下のようなものとなる

  • データシリアライザとデータでシリアライザで、ダミーのテストデータによりファイルをセーブしてロードして、内容が変わっていないことを確認する。
  • __m128形成部をテストする。4つの32ビット浮動小数点数より__m128を形成する。x86では難しくないが、OpenPOWERで同じものが形成できているかチェックする必要がある。

正当性を検査するIntrinsic関数をOpenPOWERにポートしたものは以下のようなものとなる。

/* The Intel API is flexible enough that we must allow aliasing with other
vector types, and their scalar components. */
typedef float __m128 __attribute__ ((__vector_size__ (16), __may_alias__));
/* Internal data types for implementing the intrinsics. */
typedef float __v4sf __attribute__ ((__vector_size__ (16)));

/* Perform the respective operation on the four SPFP values in A and B. */
extern __inline __m128 __attribute__((__gnu_inline__, __always_inline__,
__artificial__))
_mm_add_ps (__m128 __A, __m128 __B)
{
    return (__m128) ((__v4sf)__A + (__v4sf)__B);
}

このIntrinsicにおいて使われる型は32Bit Floating Pointとなる。よって、ランダム整数生成部はとりあえず必要ない。必要なのはランダム浮動小数点生成部となる。浮動小数点を扱うIntrinsicと整数を扱うIntrinsicのどちらが簡単かを判断する必要がある。
エッヂケースと普通の乱数のブレンド戦略をどうするか考えないといけない。_mm_add_psの場合は4つレーンがあるため、どのように値を配分するかも考えないといけない。
エッヂケースは後回しにして通常乱数だけでテストフレームワークをとりあえず作る手もある。

浮動小数点のエッヂケースには以下のようなものがある。

  • 正のゼロ
  • 負のゼロ
  • 正の無限大
  • 負の無限大
  • 正の最大有限値
  • 負の最大有限値
  • 最小正規数
  • 最大非正規数
  • 最小正非正規数
  • 1.0
  • -1.0
  • Quiet NaN
  • Signaling NaN

浮動小数点数の演算の組み合わせによるエッヂケースには以下のようなものがある。

  • 正の無限大  + 負の無限大  = NaN、invalid例外
  • +0      + −0      = ゼロの符号
  • 最大有限値  + 最大有限値   =オーバーフロー
  • 最小正規数  + −最大非正規数 = 非正規数への遷移
  • 1.0     + 2^-24     = 丸め境界(float)
  • 1.0     + −1.0      = 完全な桁落ち
  • qNaN    + 通常値      = NaN伝播
  • sNaN    +  通常値     = invalid例外、quiet化
  • 大きい正数  + 微小な正数    = 小さい加数の消失

かつてエラーが出たパターンをデータベース化する手もある。かつてエラーが出たパターンを優先的にテストすることもできる。

整数のエッヂケースには以下のようなものがある。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?