Как рассчитывается оценка уровня комментированности программы

Наиболее простой метрикой стилистики и понятности программ является оценка уровня комментированности программы F:

где Nком — количество комментариев в программе; Nстр — количество строк или операторов исходного текста.

Таким образом, метрика F отражает насыщенность программы комментариями.

Исходя из практического опыта принято считать, что F>=0.1, т. е. на каждые десять строк программы должен приходиться минимум один комментарий. Как показывают исследования, комментарии распределяются по тексту программы неравномерно: в начале программы их избыток, а в середине или в конце — недостаток. Это объясняется тем, что в начале программы, как правило, расположены операторы описания идентификаторов, требующие более «плотного» комментирования. Кроме того, в начале программы также расположены «шапки», содержащие общие сведения об исполнителе, характере, функциональном назначении программы и т. п. Такая насыщенность компенсирует недостаток комментариев в теле программы, и поэтому формула (5) недостаточно точно отражает комментированность функциональной части текста программы.

Оценка задач / Дмитрий Симонов

Более удачен вариант, когда вся программа разбивается на n равных сегментов и для каждого из них определяется Fi:

Fi = sign (Nком/Nстр — 0.1),

Уровень комментированности программы считается нормальным, если выполняется условие: F=n. В противном случае какой-либо фрагмент программы дополняется комментариями до номинального уровня.

Метрики холстеда

Следующие пять характеристик являются продолжением метрики Холстеда.

1.Для измерения теоретической длины программы N^ М. Холстед вводит аппроксимирующую формулу:

N^ = n1*log2(n1) + n2*log2(n2), (6)

где n1 — словарь операторов; n2 — словарь операндов программы.

Вводя эту оценку, Холстед исходит из основных концепций теории информации, по аналогии с которыми частота использования операторов и операндов в программе пропорциональна двоичному логарифму количества их типов. Таким образом, выражение (6) представляет собой идеализированную аппроксимацию (1), т. е. справедливо для потенциально корректных программ, свободных от избыточности или несовершенств (стилистических ошибок). Несовершенствами можно считать следующие ситуации:

Читайте также:
Если при выполнении программы отклонение контролируемых параметров превышает стандарты

а) последующая операция уничтожает результаты предыдущей без их использования;

б) присутствуют тождественные выражения, решающие совершенно одинаковые задачи;

в) одной и той же переменной назначаются различные имена и т. п.

Подобные ситуации приводят к изменению N без изменения n.

М. Холстед утверждает, что для стилистически корректных программ отклонение в оценке теоретической длины N^ от реальной N не превышает 10%.

Метрики стилистики и понятности программ

ЦЕЛЬ РАБОТЫ: оценить качество программных продуктов с точки зрения их стилистики и понятности.

Оценка уровня комментированности

Наиболее простой метрикой стилистики и понятности программ является оценка уровня комментированности программы F:

Создание учебных заданий и тестов разного уровня сложности с учетом таксономии целей Блума.

где Nком – количество комментариев в программе; Nстр — количество строк или операторов исходного текста.

Таким образом метрика F отражает насыщенность программы комментариями.

Практически, принято считать что F ≤ 0,1, т.е. на каждые десять строк программы должен приходится минимум один комментарий.

Как показываю исследования, комментарии распределяются по тексту программы неравномерно: в начале программы их избыток, а в середине или в конце – недостаток. Это объясняется тем, что в начале программы, как правило, расположены операторы описания идентификаторов, требующие более «плотного» комментирования. Такая насыщенность компенсирует недостаток комментариев в теле программы, и поэтому формула (1) недостаточно точно отражает комментированность функциональной части текста программы.

Более информативным будет вариант, когда вся программа разбивается на n равных сегментов и для каждого из них определяется Fi:

Уровень комментируемости программы считается нормальным, если выполняется условие F = n. В противном случае какой либо фрагмент программы дополняется комментариями до номинального уровня.

Метрики Холседа для оценки стилистики

И понятности программ

Следующие характеристики являются продолжением метрики Холседа. Стилистика и понятность программ тесно связаны и с размером, и со сложностью программ.

Читайте также:
Познавательная программа правила дорожного движения для детей

Для измерения теоретической длины программы М.Холстед вводит аппроксимирующую формулу:

где η1 – словарь операторов; η2 – словарь операндов программы.

Вводя эту оценку, Холстед исходит из основных концепций теории информации, по аналогии с которыми частота использования операторов и операндов в программе пропорционально двоичному логарифму количества их типов. Таким образом, выражение (4) справедливо для потенциально корректных программ, свободных от избыточности или несовершенств (стилистических ошибок).

Несовершенствами можно считать следующие ситуации:

а) последующая операция уничтожает результаты предыдущей без их использования;

б) присутствуют тождественные выражения, решающие совершенно одинаковые задачи;

в) одной и той же переменной назначаются различные имена и т.п.

Подобные ситуации приводят к изменению N, без изменения η.

Для стилистически корректных программ отклонение в оценке теоретической длины от реальной N не превышает 10 %. Таким образом, измеряя η1, η2, N1 и N2 и сопоставляя значения N и для некоторой программы, можно говорить о наличии в программе стилистических ошибок, т.е. несовершенств.

Источник: infopedia.su

Метрики стилистики , корректности и интеллектуальности программ

Наиболее простой метрикой стилистики и понятности программ является оценка уровня комментированности программы F:

где Nком — количество комментариев в программе;

Nстр — количество строк или операторов исходного текста.

Таким образом, метрика F отражает насыщенность программы комментариями.

Исходя из практического опыта принято считать, что F>=0.1, т. е. на каждые десять строк программы должен приходиться минимум один комментарий. Как показывают исследования, комментарии распределяются по тексту программы неравномерно: в начале программы их избыток, а в середине или в конце — недостаток. Это объясняется тем, что в начале программы, как правило, расположены операторы описания идентификаторов, требующие более «плотного» комментирования. Кроме того, в начале программы также расположены «шапки», содержащие общие сведения об исполнителе, характере, функциональном назначении программы и т. п. Такая насыщенность компенсирует недостаток комментариев в теле программы, и поэтому формула (9) недостаточно точно отражает комментированность функциональной части текста программы.

Читайте также:
Как писать программу испытаний

Более удачен вариант, когда вся программа разбивается на n равных сегментов и для каждого из них определяется Fi:

Fi = sign (Nком/Nстр — 0.1),

Уровень комментированности программы считается нормальным, если выполняется условие: F=n. В противном случае какой-либо фрагмент программы дополняется комментариями до номинального уровня.

4.2. Метрики корректности и интеллектуальности программ

Понравилась статья? Добавь ее в закладку (CTRL+D) и не забудь поделиться с друзьями:

Источник: studopedia.ru

Рейтинг
( Пока оценок нет )
Загрузка ...
EFT-Soft.ru