Вопросы с тегом «documentation»

44
Каковы хорошие способы документирования научного программного обеспечения?

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

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

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

23
Какой материал я должен включить в журнальную статью (или опубликовать в Интернете), чтобы сделать мои вычислительные исследования воспроизводимыми?

Воспроизводимость становится все более важной в научных исследованиях в области вычислительной техники. (Например, см. Эту статью Роджера Пенга в журнале « Наука» ; мне известны и другие подобные статьи и веб-сайты.) Однако мне не ясно, сколько информации я должен включить в журнальную статью (или...

19
Каков наилучший способ сделать воспроизводимые исследования, если вам нужны проприетарные библиотеки?

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

11
Для программного обеспечения, переданного в ACM TOMS, как лицензионное соглашение на программное обеспечение ACM взаимодействует с другими лицензиями?

Журнал « Ассоциация вычислительных машинных операций на математическом программном обеспечении» (ACM TOMS) публикует множество статей о численных алгоритмах, которые включают программные реализации. В соответствии с их редакционной политикой , представление статьи об алгоритме включает в себя...