=============================================================================== MacroQuest 1.0 =============================================================================== 1. Introduksjon --------------- MacroQuest er et makroseismisk spørreskjema på internett og består i i hovedsak av et sett av PHP 4.0 skript, en konfigurasjonsfil og en inndatafil. Det er ikke nødvendig med kunnskaper om PHP for å vedlikeholde programmet. For mer informasjon om PHP (Hypertext PreProcessor), se www.php.net. Dette dokumentet inneholder informasjon om filer tilhørende MacroQuest, installasjon, bruk av programmet og data som genereres. 2. Filer -------- MacroQuest består av følgende filer: * readme.txt - Denne filen du nå leser * macroquest.php - Skript som genererer liste av jordskjelv * macroquest_form.php - Skript som genererer spørreskjemaet * macroquest_submit.php - Skript som tar imot svar fra spørreskjema * macroquest.cfg - Konfigurasjonsfil * macroquest.def - Jordskjelvdefinisjonsfil * logo.png - UiB logo i Portable Networks Graphics format * style.css - Cascading Style Sheet for websidene som genereres 3. Installasjon --------------- Filene macroquest.php, macroquest_form.php, macroquest_submit.php, logo.png, style.css og macroquest.cfg legges i samme katalog på ønsket web-område. Skriptfilene (php) må ha nok filrettigheter til at webserver kan prosessere de. For å benytte MacroQuest må det lages en link fra websiden til filen "macroquest.php", konfigurasjonsfilen må settes opp korrekt, og jordskjelv legges inn i definisjonsfilen. I filen macroquest.cfg ligger blant annet informasjon til programmet om utdatakatalog og navnet på jordskjelvdefinisjonsfil. Endre innholdet i dennne filen etter behov. Konfigurasjonsfilen inneholder følgende elementer: * DEF_FILE - Katalog og navn på jordskjelvdefinisjonsfilen (macroquest.def). * OUTPUT_DIR - Katalog for utdata. * BACK_LINK - Webadressen bruker blir sendt ved klikk på linken "Tilbake". * WEBMASTER - Mailadresse bruker blir henvist ved feil på siden. Informasjon om jordskjelvene legges inn i jordskjelvdefinisjonsfilen som er beskrevet i neste del. 4. Jordskjelvdefinisjonsfilen ------------------------------ Jordskjelv som skal vises i listen over jordskjelv som publikum kan besvare spørreskjema for, legges til i jordskjelvdefinisjonsfilen (typisk kalt macroquest.def). Linjer i filen som starter med tegnet '#' behandles som kommentarer og ignoreres. Linjer i filen skal enten være kommentarlinjer eller jordskjelvdefinisjon (bortsett fra siste linje som kan være tom) Hvert jordskjelv representeres med GMT/UTC tid og en valgfri beskrivelse i fritekst. Programmet beregner selv lokal norsk tid, gitt at webserver er satt opp med riktig tidssone (+01 i Norge). MERK: Sjekk at tidspunkter i listen over jordskjelv vises med korrekt lokal tid. Skriptet skal også håndtere sommertid automatisk. Igjen, ved feil, sjekk konfigurasjon av tidssone og klokke på webserver. Tidspunkteter starter i kolonne 2. Merk det er påkrevd med en null ('0') før ensifrede kompontenter av dato og tid (for eksempel skal det skrives '09' og ikke ' 9' eller '9'). Den valgfrie beskrivelsen starter i kolonne 20 og må holdes på samme linje som det tilhørende tidspunktet. Formatet for en jordskjelvdefinisjon er: YYYY-MM-DD HH:MM Beskrivelse i fritekst Eksempel på en jordskjelvdefinisjon: 2000-11-29 22:08 Hvaler – Strømstad området, styrke 3.9 (Richter skala) Merk at kolonne 1, 18 og 19 skal være tom. 5. Utdata --------- Alle besvarelser av skjemaet for et gitt jordskjelv legges i en fil med navn generert fra jordskjelvets tidspunkt og filendelsen "txt" (YYYYMMMDDHHMM.txt). For eksempelet over blir besvarelsene lagt i en fil med navn "200011292208.txt". Utdatafilenes plassering bestemmes i en linje i macroquest.cfg. Hver besvarelse for et gitt skjelv er separert med en horisontal linje med "-". Innholdet i en besvarelse er selvforklarende bortsett fra de ulike delsvarene som er identifisert med en sammensetning av intensitet og spørsmålsnummer. De ulike spørsmålsnumrene for hver intensistet er vist under: Intensitet II: 1. Ble skjelvet merket av få innendørs? Intensitet III: 1. Ble skjelvet merket av flere? 2. Var det svake rystelser i bygningen - som av en liten lastebil? Intensitet IV: 1. Var det sterke rystelser som av buss/lastebil/tog – og lyd? 2. Ble rystelsene merket som ved en sprengning? 3. Klirret vindusruter eller dører? 4. Klirret kopper og kar? Intensitet V: 1. Ble skjelvet merket av folk utendørs; våknet de som sov? 2. Svingte lamper eller beveget bilder seg på veggen? 3. Ble små gjenstander flyttet/veltet? Intensitet VI: 1. Ble skjelvet merket av de fleste, løp noen ut av bygningen? 2. Falt bilder i gulvet, bøker ut av hyllene? 3. Ble tunge/større møbler flyttet? 4. Ble små skader (sprekker i grunnmur og murpussete flater) observert? Intensitet VII: 1. Var det vanskelig å stå oppreist? 2. Var det mindre skader på inventar? 3. Var det skader på grunnmur? Ble små eller moderate ødeleggelser observert i bygningen?