Здравствуйте.
Допустим мы разработали некую программу. При этом, стоит отметить, что основным назначением данной программы является не абстрактный drag and drop, не что-то классическое в том смысле программ, что мы привыкли видеть на GooglePlay или других аналогичных ресурсах. Назначением программы является реализация некого алгоритма и его тестирование. У этой программы нет графического интерфейса, пусть она даже строит некие графики. Возникает вопрос: Каким образом правильно 'описать'(нужно подобрать другое слово, но я не знаю какое лучше) разработанную программу ? При этом, мне конечно интересны общие рассуждения, ибо тут все, или подавляющее большинство намного опытнее меня, но кроме этого, было бы интересно почитать хорошие книги по данному вопросу, возможно с некой предысторией. Подскажите пожалуйста по возникшему вопросу

AkinaSashaMercuryВозникает вопрос: Каким образом правильно 'описать'(нужно подобрать другое слово, но я не знаю какое лучше) разработанную программу ?
Таки непонятно, о чём идёт речь. Нужна аннотация? Краткая справка? что-то ещё?
Об этом я и спрашиваю. Как лучше и как грамотно было бы описать реализованный/разработанный алгоритм в виде программы

eNoseSashaMercuryНазначением программы является реализация некого алгоритма и его тестирование. У этой программы нет графического интерфейса, пусть она даже строит некие графики. Возникает вопрос: Каким образом правильно 'описать'(нужно подобрать другое слово, но я не знаю какое лучше) разработанную программу ? так и пиши - "консольное приложение, реализующее алгоритм Х"

сам алгоритм патентовать нельзя (в РФ)

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

AkinaОпять непонятно.

Создаётся впечатление, что существует некий класс задач, для решения которых разработан некий алгоритм, а для его демонстрации написана программа. И требуется описАть, как именно данный алгоритм реализован в данной программе. Это - верно?

Да, вы меня очень правильно поняли

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

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

WebSharperSashaMercuryВозникает вопрос: Каким образом правильно 'описать'(нужно подобрать другое слово, но я не знаю какое лучше) разработанную программу ?

Кто целевая аудитория описания. С какой целью делается описание. Насколько подробное должно быть описание.

Специалисты в области математики и разработки программного обеспечения

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

Сейчас приведено подробное текстовое описание алгоритма, более того, приведено его строгое обоснование. Зачем добавлять всё это в виде программного кода ? Может быть хватит фразы о том что данный алгоритм реализован на языке таком-то, и привести несколько примеров результатов работающих программ ? Ведь реализация это дело техники, зачем вообще приводить куски кода ? (это не моя критика вашего предложения, а просто вопрос) Действительно ли это так критично и нужно ?

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

Главное алгоритм и его обоснование. Но и программу нужно что-то сказать, вот и не знаю как лучше и почему

WebSharper Зачем этим специалистами описывать программу? Чтобы они что?

Например "Это консольная программа реализует алгоритм Рунге-Кутта" это тоже описание.

Чтобы выслушать их мнение на докладе. Пусть это будет не метод Рунге-Кутта, а метод А. Который не так широко известен, и который нужно разработать и обосновать(не на одну и две страницы одной математики, вообще говоря) перед применением к конкретной задаче. И этим товарищам безусловно более интересен факт обоснования метода (потому что в основном они теоретики). Естественным образом представляется интерес к реализации метода на ЭВМ. Но это всё, как когда-то говорил Анатолий, не более чем дело техники. Более того, если углублять в детали реализации, то мы будем некий семантический разрыв между реальным алгоритмом и реализацией. Потому, я думаю, что есть смысл применить крупноблочную схему(скорее всего даже не в виде блок-схемы, а в виде предложений) для того чтобы описать как работает разработанная программа. Это то, к чему я пока пришёл. Время подумать ещё есть

maytonSashaMercuryпропущено...


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


да ладно вам, вы же всё-таки не экономист или, что ещё хуже, не 1с-ник в конце концов :D