Subnormal detection mode (-check-subnormal)

Обнаружьте операции, которые приводят к субнормальным значениям с плавающей точкой

Описание

Эта опция влияет на анализ Программы автоматического доказательства Кода только.

Укажите, что верификация должна проверять операции с плавающей точкой на субнормальные результаты.

Установите опцию

Пользовательский интерфейс (только десктопные решения): В вашей настройке проекта опция находится на узле Check Behavior.

Командная строка и файл опций: Используйте опцию -check-subnormal. Смотрите информацию о командной строке.

Почему использование эта опция

Используйте эту опцию, чтобы обнаружить операции с плавающей точкой, которые приводят к субнормальным значениям.

Субнормальные числа имеют величины меньше, чем самое маленькое число с плавающей запятой, которое может быть представлено без начальных нулей в мантиссе. Присутствие субнормальных чисел указывает на потерю значительных цифр. Эта потеря может накопиться по последующим операциям и в конечном счете привести к неожиданным значениям. Субнормальные числа могут также замедлить выполнение на целях без аппаратной поддержки.

Настройки

Значение по умолчанию: allow

allow

Верификация не проверяет операции на субнормальные результаты.

forbid

Верификация проверяет на субнормальные результаты.

Верификация останавливает путь к выполнению субнормальным результатом и препятствует тому, чтобы субнормальные значения распространили далее. Поэтому на практике вы видите только первое вхождение субнормального значения.

warn-all

Верификация проверяет на субнормальные результаты и подсветки все случаи субнормальных значений. Даже если субнормальный результат прибывает из предыдущих субнормальных значений, результат подсвечен.

Верификация продолжается, даже если проверка является красной.

warn-first

Проверки верификации на субнормальные результаты, но только подсвечивают первые случаи субнормальных значений. Если субнормальное значение распространяет к дальнейшим субнормальным результатам, те последующие результаты не подсвечены.

Верификация продолжается, даже если проверка является красной.

Для получения дополнительной информации результирующих цветов в каждом режиме, смотрите Subnormal float.

Советы

  • Если вы хотите видеть только те операции, где субнормальное значение происходит из несубнормальных операндов, используйте warn-first режим.

    Например, в следующем коде, arg1 и arg2 неизвестны. Верификация принимает, что они могут принять, все значения допускали тип double. Это предположение может привести к субнормальным результатам определенных операций. Если вы используете warn-first режим, первая операция, вызывающая субнормальный результат, подсвечен.

    warn-allwarn-first

    void func (double arg1, double arg2) 
    {
    	  double difference1 = arg1 - arg2;
    	  double difference2 = arg1 - arg2;
    	  double val1 = difference1 * 2;
    	  double val2 = difference2 * 2;
    }
    
    

    В этом примере все четыре операции могут иметь субнормальные результаты. Четыре проверки на субнормальные результаты являются оранжевыми.

    void func (double arg1, double arg2) 
    {
    	  double difference1 = arg1 - arg2;
    	  double difference2 = arg1 - arg2;
    	  double val1 = difference1 * 2;
    	  double val2 = difference2 * 2;
    }
    

    В этом примере, difference1 и difference2 может быть поднормаль если arg1 и arg2 достаточно близки. Первые две проверки на субнормальные результаты являются оранжевыми. val1 и val2 не может быть поднормаль если difference1 и difference2 поднормаль. Последние две проверки на субнормальные результаты являются зелеными.

    Посредством красных/оранжевых проверок вы видите только первую инстанцию, где субнормальное значение появляется. Вы не видите красные/оранжевые проверки от тех субнормальных значений распространение к последующим операциям.

  • Если вы хотите видеть, где субнормальное значение происходит, и не хотят видеть субнормальные результаты явиться результатом той же причины несколько раз, использовать forbid режим.

    Например, в следующем коде, arg1 и arg2 неизвестны. Верификация принимает, что они могут принять, все значения допускали тип double. Это предположение может привести к субнормальным результатам для arg1-arg2. Если вы используете forbid режим и выполняет операцию arg1-arg2 дважды по очереди только первая операция подсвечена. Вторая операция не подсвечена, потому что субнормальный результат для второй операции является результатом той же причины как первая операция.

    warn-allforbid

    void func (double arg1, double arg2) 
    {
    	  double difference1 = arg1 - arg2;
    	  double difference2 = arg1 - arg2;
    	  double val1 = difference1 * 2;
    	  double val2 = difference2 * 2;
    }
    
    

    В этом примере все четыре операции могут иметь субнормальные результаты. Четыре проверки на субнормальные результаты являются оранжевыми.

    void func (double arg1, double arg2) 
    {
    	  double difference1 = arg1 - arg2;
    	  double difference2 = arg1 - arg2;
    	  double val1 = difference1 * 2;
    	  double val2 = difference2 * 2;
    }
    

    В этом примере, difference1 может быть поднормаль если arg1 и arg2 достаточно близки. Первая проверка на субнормальные результаты является оранжевой. После этой проверки верификация исключает из фактора:

    • Близкие значения arg1 и arg2 ведомый к субнормальному значению difference1.

      В последующей операции arg1 - arg2, проверка является зеленой и difference2 не поднормаль. Результат проверки на difference2 * 2 является зеленым по той же причине.

    • Субнормальное значение difference1.

      В последующей операции difference1 * 2, проверка является зеленой.

Информация о командной строке

Параметр: -check-subnormal
Значение: allow | warn-first | warn-all | forbid
Значение по умолчанию: allow
Пример (Программа автоматического доказательства Кода): Polyspace Code Prover - источники file_name - поднормаль проверки запрещает
Пример (сервер программы автоматического доказательства кода): сервер программы автоматического доказательства полипробела кода - источники file_name - поднормаль проверки запрещает
Введенный в R2017b