МИНИСТЕРСТВО СТРОИТЕЛЬСТВА ПРЕДПРИЯТИЙ НЕФТЯНОЙ И ГАЗОВОЙ ПРОМЫШЛЕННОСТИ

ВСЕСОЮЗНЫЙ НАУЧНО-ИССЛЕДОВАТЕЛЬСКИЙ ИНСТИТУТ ПО СТРОИТЕЛЬСТВУ МАГИСТРАЛЬНЫХ ТРУБОПРОВОДОВ

ВНИИСТ

ПО РАЗРАБОТКЕ ТЕХНИЧЕСКИХ ЗАДАНИЙ НА ПРОГРАММИРОВАНИЕ НАУЧНО-ТЕХНИЧЕСКИХ И ЭКОНОМИЧЕСКИХ ЗАДАЧ

Р 164-74

Москва 1975

МИНИСТЕРСТВО СТРОИТЕЛЬСТВА ПРЕДПРИЯТИЙ НЕФТЯНОЙ И ГАЗОВОЙ ПРОМЫШЛЕННОСТИ

ВСЕСОЮЗНЫЙ НАУЧНО-ИССЛЕДОВАТЕЛЬСКИЙ ИНСТИТУТ ПО СТРОИТЕЛЬСТВУ МАГИСТРАЛЬНЫХ ТРУБОПРОВОДОВ

ВНИИСТ

РУКОВОДСТВО

ПО РАЗРАБОТКЕ ТЕХНИЧЕСКИХ ЗАДАНИЙ НА ПРОГРАММИРОВАНИЕ НАУЧНО-ТЕХНИЧЕСКИХ И ЭКОНОМИЧЕСКИХ ЗАДАЧ

Р 164-74

ЦНТИ ВНИИСТа

Москва 1975

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

входные и выходные линии диаграммного символа проводятся черев середины сторон поля данного символа;

линии потока не должны пересекать диаграммные символы, но могут пересекать незанятые поля диаграммных символов;

линии потока, не удобные для проведения в пределах одного листа,следует заменять двумя внутристраничными связками (исходящей и входящей),внутри которых проставляют встречные адреса;

объединения линий потока осуществляют с помощью стрелок (рис Л);

Рис Л. Объединение линий потока

не допускается объединение линий потока, идущих от блоков разных типов (программных и системных);

не допускается ветвление линий потока, параллельность действий изображают стрелками, идущими от текста (рис.2).

Рис.2. Параллельность действий

14

Операция ветвления иоле: иметь различное количество воз -моасных исходов. Ь соответствий с ко дичее твои исходов различают три типа Еетвления:

I - число исходов 3;

П -    ¹¹ "    от 4 до 7;

Ш -    ^п    более 7.

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

йтип femifleHus

Рис.З. Операции ветвлений

15

Во втором случае в поле, находящемся непосредственно под символом ветвления, ставят знак мультиветвления с указанием признаков условий и соответствующих адресов.

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

Типы ветвления приведены на рис.З.

Допускается выносить часть текста из диаграммного символа в последний столбец страницы в символ аннотации. В этом случае текст в символе аннотации заканчивается знаком сноски ( ^х ) с указанием адреса сноски и заключается в скобки, например (Д1)^х.

В символе аннотации также ставят знак сноски и встречный адрес.

Каждый этап в диаграмме алгоритма может быть детализирован, т.е. представлен в виде дополнительной диаграммы. В этом

случае в диаграммном символе этана ставят ссылку с адресом дополнительной диаграммы.

Ссылку помещают в верхней части символа и отделяют от текста пунктирной линией.

В ссылке записывают метку-идсмтификатор МТ 01 дополни -тельной диаграммы и ее полный адрес 5Д2 (рис Л).

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

ОПИСАНИЕ МЕТОДОВ КОНТРОЛЯ ВВОДА И ОБРАБОТКИ ИНФОРМАЦИИ НА ЭВМ

3.12. Раздел "Описание методов контроля ввода и обработки информации на ЭВМ" предусматривает:

установление наличия и целесообразности контрольных сумм; установление целесообразности проведения балансового контроля или двойного счета;

описание способов контроля входных документов, норматив -но-справочной информации, выходных документов;

определение видо? информации, выдаваемой при обнаружении ошибок.

КОНТРОЛЬНЫЙ ПРИМЕР

3.13. Раздел "Контрольный пример" включает: входные формы, заполненные конкретными значениями; конкретные значения нормативно-справочной информации; конкретные значения информации, накопленной и хранимой для других задач;

выходные формы, заполненные от руки с указанием конкретных значений результатов.

4. ТЕХНИЧЕСКОЕ ОПИСАНИЕ ПРОГРАММЫ

4.1 • Техническое описание программы должно содержать разделы:

а)    описание задачи;

б)    инструкция по подготовке данных;

в)    инструкция по эксплуатации;

г)    машинная распечатка программы;

д)    машинные носители: перфокарты; перфоленты; магнитные ленты; магнитные диски.

17

ОПИСАНИЕ ЗАДАЧИ

4.2.    Раздел "Описание задачи" должен содержать следующие подразделы:

введение;

общие сведения о программе; уточнение постановки задачи; характеристику программы,

4.3.    В подразделе "Введение" должны быть отражены: принадлежность к функциональной подсистеме иди комплексу

задач;

основание для разработки; система программирования; марка ЭБк, на которой реализована программа; общие ограничения на применение программы и возможность дальнейшего ее усовершенствования; перечень исполнителей.

4.4.    Подраздел "Общие сведения о программе" должен содержать следующие данные:

класс программы (определяется по табл.З); идентификатор програ ммы; марку ЭВМ;

используемые внешние устройства;

используемую систему программирования (для программ в алгоритмических языках программирования указать также транслирующую систему);

краткое содержание программы (указывают системное,, экономическое или вспомогательное содержание программы); математический метод (если имеется); точность вычислений (если имеется); используемый метод контроля вычислений (если имеется); длину программы;

время работы (для программ в алгоритмических языках программирования указать и время трансляции); дату акта внедрения;

наименование предприятия, внедрившего программу; место хранения программы (отраслевой фонд, архив предприятия и т.д.).

Таблица 3 Классы программ Т

Шифр ! Наименование ! ! Определение РП Рабочая программа Программа для решения конкретной научно-инженерной или экономической задачи, имеющая самостоятельное значение дп Диспетчерская программа Управляющая программа,объединяющая отдельные программы в программный комплекс ПК Программный комплекс Система программ, объединенная единством архитектуры, информационной базы и диспетчерской программы АП Программа автоматизации программиро -вания Программа, реализующая на Э&М один из технологиче -ских процессов разработки

программ

4.5. Длину программы (с указанием единицы измерения, такой как: машинное слово, символ, байт) записывают в десятичной или восъмнричиой системе исчисления и включают как длину поля собственно программной части, так и длину поля данных и рабочего поля.

4.6. Время работы (если возможно) задается формульно-аналитической зависимостью от входных параметров и подсчитывается по наиболее длинной ветви программы.

При отсутствии такой зависимости дается эмпирическое время счета.

19

УДК л 65.012.122

Настоящее Руководство разработано с целью установить в Ищннефтегазстрое единый порядок оформления технических заданий на програшшро*-вание научно-технических и экономических задач, а также снизить трудозатраты на стадиях поста -новкж, программирования и внедрения задач, подлежащих реиенms на универсальных ЭВМ.

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

При составлении Руководства были учтены действующие общесоюзные нормативные документы и специфические особенности отрасли. Руководство разработано сотрудниками лаборатории математических методов исследования ВНИИСТа Н.А.Калиной и Н.И.Громовым при учасЖм В.А.Воробьевой.

4*7. При оформлении подраздела "Уточнение постановки за-* дачи” указывают возникшие в процессе программирования измене -ния в поставленной задаче*

4.8. Подраздел "Характеристика программы" содержит: перечень основных частей и блоков программы; перечень стандартных программ, входящих в систему математического обеспечения (СМО) ЭВМ и используемых в программе (если имеются);

перечень других используемых программ автоматизации программирования (если имеются) со ссылкой на источники;

указания правил задания информации при обращении к стандартным программам и программам автоматизации программирова -ния (если необходимо);

описание тела программы (если существует); использованные способы повышения надежности вычисления; взаимосвязь с диспетчерской программой и методы подключения к ней (если существует);

особенности работы программы; форму хранения программы.

4*9. Для ЭВМ без динамического распределения оперативной памяти следует задать в табличном виде относительное расположение:

программы и ее составных частей; массива входных данных; констант;

массива выходной информации; рабочего поля.

ИНСТРУКЦИЙ по ПОДГОТОВКЕ, ДАННЫХ

4Л0. "Инструкция по подготовке даьных" должна содержать подразделы:

назначение;

состав материалов;

прием и подготовка документов;

Всесоюзный тучно- j Руководство по разработке | жссдедовательскяй ; технических заданий на про-; ннститут по expo- ; грашированяе научно-твхни- jP 164-74 жтельству магжст- ; чесннх я экономических аа- ;

i да⁴    i

ВОДОВ ^DtUUOUl)    j    |

1. ВВЕДЕНИЕ

1.1.    Настоящее Руководство определяет:

состав технической документации ж материалов по постановке технико-экономических задач при реализации их на ЭВМ;

состав технической документации и материалов по програм -мам для ранения технико-зкономических задач на ЭВМ;

основные требования, предъявляемые к содержанию технмче -с кой документации, изложенные выше*

1.2.    Руководство предназначено для работников вычислительных центров и специалистов Мин нефтегаз строя, разрабатывающих и представляющих в отраслевой фонд алгоритмов и программ (ОФАП):

а)    описание алгоритмов и программ, реализующих задачи вычислительного характера:

научные и инженерные задачи;

задачи отраслевых автоматизированных систем управления (О АСУ);

задачи автоматизированных систем управления проннводст -вон, строительством (АСУП), (АСУС);

задачи автоматизированных систем управления разрабатывающим предприятием (АСУРП);

б)    программы и системы организующих и диспетчерских программ по задачам, указанным в п.1.2,а;

в)    стандартные программы (СП) и библиотеки стандартных программ (БСП) автоматизации программирования и обработки данных.

1.3. Руководство составлено на основании и в соответствии с "Положением о порядке подготовки, апробации и представлении материалов по математическому обеспечение электронных вычислительных машин в государственный фонд алгоритмов и программ [i J, "Обцеотраелевыми руководящими методическими материалами по соз-даншо АСУП" [3 ] .

2.    ОСНОВНЫЕ ПОЛОЖЕНИЯ

2.1.    При постановке технико-экономической задачи и разработке программного обеспечения к ней необходима следующая до -кументация:

постановка задачи, предназначенная для изложения экономической сущности задачи и представления необходимых исходных предпосылок, обеспечивающих разработку программ на ЭВМ;

техническое описание программы, предназначенное для изучения программы.

2.2.    Оформление документации осуществляется согласно Инструкции [зЦ.

3.    ПОСТАНОВКА ЗАДАЧИ

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

определение организационно-экономической сущности задачи; описание входной информации; описание выходной информации;

описание информации, хранимой для связи с другими задачами;

описание информации, накапливаемой для последующих решений данной задачи;

описание правил внесения изменений во входную информацию;

4

описание методов контроля ввода и обработки информации на ЭВМ;

контрольные пример.

ОПРЕДЕЛЕНИЕ ОРГАНИЗАДЮННО-ЭКОНОИИЧЕСКОЙ СУЩНОСТИ ЗАДАЧИ

3.2. Раздел "Определение организационно-экономической сущ-

ности задачи¹¹ включает:

название и цели задачи, звенья системы (органы управления, подразделения), для которых она предназначается; периодичность решения задачи;

взаимосвязь с другими задачами разрабатываемого комплекса; способы сбора исходных данных и использование результатов решения задачи;

ограничения по срокам выдачи результатов решения задачи.

ОПИСАНИЕ ВХОДНОЙ ИНФОЙЩИИ

3.3. Раздел "Описание входной информации¹¹ включает: описание образцов форм входных документов или макетов сообщений на машинных носителях информации; описание кодов информации;

определение периодичности поступления информации; определение источников поступления;

определение количества документо-строк по каждому из входных документов;

определение показателей (обозначение, разрядность, диапазон изменения, единицы измерения) в виде таблицы;

наименование других задач, результаты решения которых используют при решении данной задачи (раздельно на формах и на машинных носителях);

определение показателей, хранимых в подмассиве банка данных.

5

ЗА. Раздел "Описание выходной информации" включает: описание образцов форы выходных документов или макетов выходных сообщений на наниных носителях информации; описание кодов информации; определение периодичности выдачи результатов; указания адресов получателей информации; определение величества экземпляров; определение количества строк и столбцов в документе; установление последовательности и сроков выдачи ее на ЭВМ; формулирование требований по упорядоченности строки; описание показателей;

формулирование специальных требований к оформлению выходных документов.

ОПИСАНИЕ ИНФОРМАЦИИ, ХРАНИМОЙ ДЛЯ СВЯЗИ С ^РУГИМИ ЗАДАЧАМИ

3.5. Раздел Описание информации, хранимой для связи с другими задачами¹¹, включает:

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

перечень методов хранения информации и вид носителей.

ОПИСАНИЕ ИНФОРМАЦИИ, НАКАПЛИВАНИЮЙ ДЛЯ ПОСЛЕДУЮЩИХ РЕШЕНИЙ ДАННОЙ ЗАДАЧИ

3.6. Раздел "Описание информации, накапливаемой для последующих решений данной задачи", включает: описание показателей;

описание методов хранения информации и вида носителей.

6

ОПИСАНИЕ ПРАВИЛ ВНЕСЕНИЯ ИЗМЕНШЙ ВО ВХОДИЛО ИНФОРМАЦИЮ

3.7. Раздел "Описание правил внесения изменений во входную

информацию" включает;

описание системы внесения изменений (порядок, периодичность и т.д.);

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

установление среднего и максимального количества документ о-строк при каждом внесении изменений;

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

ФОРМУЛ ЙРОВАНИЕ АЛГОРИТМА РЕШЕНИЯ ЗАДАЧИ

3.3. Раздел "Формулирование алгоритма решения задачи" состоит из двух подразделов:

математического описания задачи;

диаграммы алгоритма.

3.9.    Подраздел "Математическое описание" содержит:

а)    математическую постановку задачи;

б)    метод решения.

Математическая постановка задачи должна содержать расчетную модель решения данной задачи с указанием на принятые в ней допущения и ограничения.

Приводятся все расчетные (рабочие) формулы.

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

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

3.10.    Метод решения должен раскрыть способ решения расчетной модели задачи.

Для известного метода необходимо дать ссылку на источник

7

с указанием ограничений на область применения. Для методов мало известных или разработанных авторами необходимо дать под -робкое теоретическое обоснование с анализом результатов решения.

Описания численных методов решения должны содержать а на -лиз точности вычислений.

З.П. Подраздел "Диаграмма адгоритма'‘содержит:

а)    общую диаграмму алгоритма (блок-схему задачи) и ее описание;

б)    подробную диаграмму алгоритма и ее описание.

Диаграмму алгоритма используют для наглядного представления общего или подробного процесса решения задачи, разделения его на отдельные взаимосвязанные части для облегчения и юшфе-тизации процесса составления программ.

Диаграммы алгоритмов выполняют с помощью диаграммных символов: системных - для общих диаграмм алгоритмов и программ -ных - для подробных диаграмм алгоритмов.

Конечная совокупность диаграммных символов, соединенных в полном соответствии с последовательность-, процесса обработки данных, составляет диаграмму.

Описания должны содержать подробный порядок работы час -тей и блоков алгоритма и дополнять соответствующую диаграмму алгоритма необходимыми уточнениями и пояснениями.

Условные графические обозначения

Условные графические обозначения системных диаграммных символов приведены в табл.1, а условные графические обозначе -ния программных диаграммных символов - в табл.2 (ГОСТ 19428-74).

Для обозначения собственных названий диаграммных символов в диаграмме используют первые 81 символ ГОСТ 10859-64.

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

8