Pytania otagowane jako documentation

8
Jakie są dobre sposoby dokumentowania oprogramowania naukowego?
Wiele razy, kiedy odziedziczyłem lub napotkałem kod naukowy napisany przez innych ludzi (lub czasami nawet moją własną pracę), zauważyłem, że dokumentacja jest albo rzadka, albo nie istnieje. Jeśli mam szczęście, widzę pouczające komentarze. Jeśli mam szczęście, są nawet komentarze Doxygen i Doxyfile, więc mam interfejsy funkcyjne i trochę sformatowanego HTML …
8
Jak upewnić się, że wyniki moich symulacji i wyniki w mojej pracy są zawsze zsynchronizowane?
W jednym z moich artykułów wymieniam niektóre wyniki liczbowe oprócz niektórych liczb. Chciałbym się upewnić, że wyniki liczbowe w mojej pracy zawsze zgadzają się z kodem. W tej chwili po prostu kopiuję bezpośrednio wyniki liczbowe z wyników symulacji na papier, co jest niezwykle proste i mało zaawansowane technicznie, ale podatne …
5
Jakie materiały powinienem dołączyć do artykułu w czasopiśmie (lub opublikować online), aby moje badania obliczeniowe były odtwarzalne?
Powtarzalność staje się coraz ważniejsza w badaniach w dziedzinie obliczeń. (Na przykład zobacz ten artykuł autorstwa Rogera Penga w nauce ; znam też inne tego rodzaju artykuły i strony internetowe.) Jednak nie jest dla mnie jasne, ile informacji powinienem podać w artykule w czasopiśmie (lub w Internecie), aby zrobić moje …
6
Jaki jest najlepszy sposób na przeprowadzenie powtarzalnych badań, jeśli potrzebujesz zastrzeżonych bibliotek?
Powtarzalne badania w dziedzinie obliczeń mają na celu udostępnienie kodu potrzebnego do wygenerowania wyników w dokumencie obliczeniowym innym badaczom, aby mogli uruchomić ten kod w celu odtworzenia wyników w tym artykule. Chciałbym, aby wszystkie moje badania były powtarzalne, ale wpadam w drobną przeszkodę: kilka artykułów, nad którymi pracuję, korzysta z …
1
W jaki sposób w przypadku oprogramowania przesłanego do ACM TOMS umowa licencyjna na oprogramowanie ACM współdziała z innymi licencjami?
Czasopismo Association for Computing Machinery Transactions on Mathematical Software (ACM TOMS) publikuje wiele artykułów na temat algorytmów numerycznych obejmujących implementacje oprogramowania. Zgodnie z ich polityką redakcyjną , przesłanie artykułu z algorytmem zawiera kod źródłowy dla implementacji algorytmu opisanego we wspomnianym artykule. Ten kod źródłowy podlega Umowie o prawie autorskim i …
Korzystając z naszej strony potwierdzasz, że przeczytałeś(-aś) i rozumiesz nasze zasady używania plików cookie i zasady ochrony prywatności.
Licensed under cc by-sa 3.0 with attribution required.