För att installera: 1) Packa upp rullflaska.zip 2) Ladda hem maxflow-v3.01.zip från http://vision.csd.uwo.ca/code/ (C++ implementation av grafsnittsalgoritmen) 3) Ladda hem maxflow från http://www.mathworks.com/matlabcentral/fileexchange/21310-maxflow (wrapper så att man kan köra C++-koden från matlab) 4) Packa upp wrappern (punkt 3) och lägg filerna i en map som ska heta maxflow. Mappen ska ligga under mappen rullflaska 5) Packa upp maxflow-v3.01.zip och lägg filerna i en mapp som ska heta maxflow-v3.0 Mappen ska ligga inder mappen maxflow. 6) Starta matlab och se till så att du befinner dig i mappen maxflow. Kör filen make. 7) Om det inte blivit några problem ska allt vara installerat nu På en windowsdator kan kanse C++ kompilatorn Visual C++ express behöva laddas hem. Detta kan göras från http://www.microsoft.com/express/downloads/#2010-Visual-CPP För att beräkna täckningsgraden för en serie bilder. 1) Se till att alla bildfiler ligger i mappar döpta med passande datum (ex 20100623) i mappen bilder. Det måste finnas referensserier (en serie bilder på stenen utan bitumen och en serie bilder på stenen helt indränkt i bitumen) och minst en serie bilder på stenen vid olika avläsningstidpunkter. 2) Kör filen readFileNames(datum), där datum är ett datum eller en matris av datum (ex 20100623 el [20100620 20100623]) för de mappar där de aktuella bilderna ligger. Denna funktion kommer att organisera filnamnen i filen experiment.mat. 3) Kör sedan filen runexp(exnr, t), där exnr är numret på experimentet (datan för experimenten ligger i en lista i experiment.mat) och t är avläsningstidpunkten (t = [1 2 3 4] som motsvarar avläsningstidpunkterna [4h 24h 48h 72h]). Funktionen sparar en resultatfil som innehåller en bild som visar vad som blivit klassificerat som bakgrund, sten och bitumen. 4) För att beräkna täckningsgraden och visualisera resultatet, kör filen plotresult(exnr, t). Funktionen returnerar den beräknade täckningsgraden och visar en originalbild med konturerna mellan bakgrund och icke-bakgrund och mellan sten och bitumen. (Detta förutsätter att variabeln plotresult är satt till 1 i filen settings.m) Filnamn: För att funktionen readFileNames ska kunna organisera filerna som krävs av övriga funktioner måste bildfilerna ha passande namn. Namnet ska innehålla namnet på materialet, exponeringstid, tidpunkt (hur länge stenarna rullats) och eventuellt namn på bitumen- blandningen. För referensbilder (på sten utan bitumen) anges tipunkten till 'Ref'. Olika delar i filnamnet avgränsas med _. Exempel på filnamn: Material_A_80_110_48h_030s_P_20100623.jpg Material: Alla tecken mellan första och fjärde understrecket kommer att tolkas som namnet på materialet. I detta fall heter materialet A och består av stenar av fraktion 8 till 11 mm. Avläsningstidpunkt: Sekvenser av tecken som står mellan två understreck kommer att undersökas. För de sekvenser som slutar på h (får bara finnas en) kommer tecken som står innan h:et att tolkas som avläsningstidpunkt. Dessa tecken ska vara siffror, tillåtna siffror är för tillfället 4, 24, 48 eller 72. I exemplet har stenarna rullats i 48 timmar. Exponeringstid: Sekvenser som slutar på bokstaven s innehåller information om exponeringstiden. Siffror innan s:et är 1/exponeringstiden. Tillåtna exponeeringtider är för tillfället 1/30, 1/40, 1/50, 1/60, 1/80, 1/100, 1/125, 1/160, 1/200, 1/250, 1/320, 1/400 och 1/500 s. I exemplet är exponeringstiden 1/30 s. Bitumenblandnig: Andra sekvenser mellan två understreck (om de inte börjar på f eller är 'IR' eller 'Ref') kommer att tolkas som namnet på bitumenblandningen. Detta behöver inte anges, om inget anges sätts bitumenblandningen till en tom sträng. I exemplet heter bitumenblandningen P. Referensbilder: Filnamn som inte innehåller något segment som slutar på h utan istället innehåller ett segment 'Ref' är de bilder som föreställer aggregaten innan de har blivit indränkta med bitumen. Om det står 0h är det en bild på aggregatet helt indränkt i bitumen. Efter sista informationen ska ett understreck vara, efter sista understrecket kan vad helst stå. Filnamnen organiseras sedan en en lista, döpt till experiment. Listan innehåller olika fält: material bitumen ref tider material innehåller namnet på materialet tex 'A_80_110'. bitumen innehåller namnet på bitumenblandningen tex 'P'. Ett experiment har en unik kombination av materialnamn och namn på bitumenblandningen. Varje experiment får också ett nummer. ref innehåller en lista av strukturer (en för var och en av referensserierna) med två olika fält, exponeringar och datum. exponeringar innehåller en lista över filnamnen och datum innehåller ett nummer som motsvarar datumet (namnet på mappen). tider innehåller också en lista av strukturer (en för varje avläsningstidpunkt) med fälten exponeringar och datum. För att få sökvägen till bilden som föreställer stenen i experiment 1 som rullats i 48 timmar och har en exponeringstid på 1/30 sekund skrivs följande: ../bilder/experiment{1}.tider{3}.datum/experiment{1}.tider{3}.exponering{1} || || namn på mappen filnamn (i matlabkod: ['../bilder/' num2str(experiment{1}.tider{3}.datum) '/' experiment{1}.tider{3}.exponering{1}] )