Vejledning i udformning af rapporter i Biomodeller O Indledning ...

Indledning
Vejledning i udformning af rapporter i
Biomodeller O
Jesper J rgensen
Dept. of Mathematics and Physics
Royal Veterinary and Agricultural University
Thorvaldsensvej 50
DK-1871 Frederiksberg C, Denmark
jesper@dina.kvl.dk
February 12, 1998
Som afslutning pa Biomodeller O skal man udarbejde en rapport om en biologisk
model i Maple. Formalet med vejledningen er at give en r kke retningslinier,
som man kan f lge ved udformningen af denne rapport.
Arbejdsforl bet
Projektforl bet starter omkring halvvejs gennem kurset ved at de studerende
nder sammen i grupper og aftaler et emne for projektet med l rerne. Herefter
aftales hvad projektet konkret skal omhandle og problemstillingen afgr nses.
Kort efter at deltagerne har fordelt sig i grupper og disse har valgt emner
afholdes det f rste af to seminarer om projekterne. Her pr senterer grupperne
deres projektemner for hinanden.
Maple velserne forts tter, men fungerer nu som en slags vejledning af projektarbejdet.
Da velserne foregar i EDB-rummene er det klart at det fortrinsvis
er her, at der arbejdes med problemstillinger der vedr rer Maple. Herudover
kan der til velserne aftales tid til individuel vejledning af grupperne.
Et par uger f r a everingstidspunktet afholdes det andet seminar, hvor grupperne
kort pr senterer deres projekter og de andre deltagere pa kurset kan
komme med kritik og bem rkninger til disse. Desuden vil der pa denne dag
v re en plenumdiskusion af kursets forl b.
Rapporten form, indhold og omfang
Rapporten skal udformes som et Maple worksheet og skal selvf lgelig v re udf rt
saledes at uddata fra rapportens Maple kommandoer er synlige. Desuden b r
1

Maples faciliteter til redigering af tekst, f. eks. afsnit (section), underafsnit (subsection),
styles (titel) etc. bruges. Det ses gerne at rapporten udformes pa
engelsk, men dette er ikke noget krav. Formalet med ovenstaende krav er, at
de f rdige rapporter kan l gges ud pa Webbet og der l ses af sa mange som
muligt.
Rapportens omfang kan afh nge meget af hvilket emne man v lger. Normalt
vil en st relse der svarer til en mindre tidskrift artikel v re passende, men
det pr cise omfang b r aftales med ens vejleder (l rerne).
Rapportens opdeling i afsnit
Opdelingen af rapporten i afsnit b r nogenlunde ligne hvad man nder i en
artikel eller en videnskabelig rapport. F. eks. kunne den indeholde disse hovedafsnit:
Forord (Eng: Preface)
Indledning (Eng: Introduction)
...
Diskusion/Konklusion (Eng: Discussion/Conclusion)
Literaturhenvisninger (Eng: References)
Efterf lgende vil vi beskrive hvad disse afsnit kan og b r indeholde.
Forord
Her skrives oplysninger af ikke teknisk karakter som er relevante for rapporten,
f. eks.
hvem har skrevet rapporten: navnene pa forfatterne og deres studienumre
ihvilken forbindelse er rapporten skrevet: hvornar, hvilket kursus og ved
hvilket institut
henvender rapporten sig til en speciel l serkreds
er der nogen man vil takke for hj lp i forbindelse med rapportens tilblivelse.
Har der f. eks. v ret medvejledere eller personer fra andre instituter involverede
i projekter, har man lant data fra andre, etc.
2

Indledning
Her skriver man den tekniske indledning.
hvad er formalet med projektet (ud over at man gerne vil besta kurset).
der gives et overblik over problemstillingen uden at man gar i detaljer.
hvad er relationen til omverdenen: ihvilken sammenh ng skal modellen
betragtes, har andre lavet noget lignende?
De centrale afsnit
Man kan ikke give faste rammer for hvad disse afsnit skal indeholde og hvordan
pr sentationen skal opdeles. Dette vil variere fra projekt til projekt. Men de
kan bl. a. indeholde en beskrivelse af det biologiske system der skal modelleres
og en udledning af den matematiske model. Der kan ogsa v re et afsnit om
veri kation af modellens anvendelighed.
Konklusion
I dette afsnit skriver man en samlet konklusion pa projektet. Afsnittet kan evt.
opdeles i to afsnit: Diskussion og Konklusion, men for rapporter af den st relse,
som vi her tales om, vil det ofte v re nok med kun et afsnit. Her er nogle af de
ting man kan skrive ikonklusionen:
hvordan virkede modellen
var den realistisk: Passede den pa den virkelighed som den skulle modellere
status af rapporten: Blev I f rdige eller var der problemer? Hvad var
disse?
hvordan var Maple som v rkt j.
Literaturhenvisninger
Her listes den literatur, der refereres til i rapporten, f. eks. ved brug af numre,
forfatternavne, etc.
Generelle retningslinier
T nk altid pa at rapporten skal l ses af andre end jer selv og overvej fra starten
hvem det er rapporten er tilt nkt. Pr v evt. at forestille jer, at I er i l serens
sted. S rg for at rapporten er sa selvforklarende som det nu ermuligt. Det er
klart, at hvis rapporten bygger pa en artikel skal man ikke gengive denne ordret,
men det vil v re en god ide med et kort resume.
3

Det er vigtigt, at man altid starter med at fort lle hvad det er man vil
med et afsnit. Det er f. eks. en typisk fejl, at man kaster sig direkte ud i en
lang matematisk udledning for til sidst at na frem til det centrale matematiske
problem i en model, uden at man fra starten har sagt, at det er det man vil na
frem til. Det er helt klart nemmere for l seren, at man fra starten af ved hvad
formalet med udledningen er.
Skriv rapportteksten l bende. Det kan godt v re, at det man skriver i
starten viser sig at v re noget vr vl, men det kan lige sa godt v re at meget
af det kan bruges efter en lettere omskrivning. Det er meget sv rere at huske
hvad man t nkte pa for en maned siden, da man traf nogle valg, hvis man ikke
har skrevet det ned end hvis man har.
S rg for at Maple koden er godt kommenteret eller aller bedst at Maple koden
er ettet ind mellem den resterende tekst. Der er f. eks. ingen grund til f rst
at udlede en r kke ligninger matematisk for derefter at gentage udledningen i
Maple kode.
Husk at et godt eksempel kan v re meget bedre end en lang og indviklet
forklaring. I hvertfald kan det v re en god ide at starte med et eksempel sa
l seren har et klart billede af hvad det er man vil beskrive.
4