Stationens allmänna konfiguration sparas i filen /home/meteor/metcam/config/metcamrc. Nedan finns korta utdrag ur filen med kommentarer om vad parametrarna har för effekt.
[site] sitename = "Your site name" code = TST longitude = 18.0 latitude = 60.0 height = 50.0 rootdir = /home/meteor/metcam
Ovanstående avsnitt [site] reglerar de mest allmänna uppgifter för stationen. Den beskrivande stationsnamn sitename kommer att visas på stationens hemsida. Förkortningen code består av tre bokstaver/siffor, och visas på alla bilder som stationen producerar. Koordinaterna lagras i longitude, latitude och height. Sedan anger rootdir var själva programvaran finns.
[grab] device = /dev/video0 input = 0 ; Currently not used norm = pal ; Currently not used width = 720 height = 524 wait = 0 rotate = 0 top = 0 left = 0 bottom = -1 right = -1 quality = 100 trigger = 0 once = 0
Under [grab] anges var programmet tar videosignalen ifrån. Under device skall anges den V4L-kamera som överensstämmer med meteorkameran eller den tillhörande framegrabber. Om du bara har en kamera ansluten är standardvärdet troligen korrekt. Sedan anges med width och height storleken på bildrutorna som kameran/framegrabbern skall skicka till programmet.
Det går att välja en mindre del av bilden genom att välja värden för top, left, bottom och right som skiljer sig från standardvärden. Bilden kan roteras med hjälp av rotate, men det kommer dock ta extra processortid - det är bättre att rotera kameran fysiskt.
Med wait kommer programmet vänta ett antal sekunder för att ge kameran möjlighet att komma igång. Kvaliten på jpeg-bilderna som produceras ställs med quality. Övriga parametrar input, norm, trigger och once har ingen effekt på programmet längre, men finns med för att kunna vara kompatibel med tidigare versioner av programmet.
[filestruct] archive = data/day/snap%Y-%m-%d-%H-%M-%S.jpg longsumarchive = data/longsum/longsum%Y-%m-%d-%H-%M-%S.jpg longmaxarchive = data/longmax/longmax%Y-%m-%d-%H-%M-%S.jpg #diffmaskarchive = data/diffmask/diffmask-%H.jpg logpath = data/log/%F.log trigpath = data/trigger/trig%s-%03d.jpg triglogpath = data/trigger/trig%s.log maskname = config/mask.jpg trigexec = bin/mktriganim2
Under [filestruct] anges var programmet skall lagra sina olika produkter. Det rekommenderas att inte ändra i denna filstruktur, eftersom en del av skripten som bearbetar data i efterhand använder sig av denna filstruktur.
Med archive lagras varje minut (beroende på nsum i följande avsnitt) en bild på hur himlen såg ut under den senaste minuten. Filnamnet innehåller datumstämpel och kan därför användas för att skapa en film över den senaste nattens himmel. Med longsumarchive och longmaxarchive visas var programmet lagrar långa integreringar (motsvarande nlongsum alternativt nlongmax gånger nsum frames, se nästa avsnitt). Diffmaskarchive används för att kunna lokalisera pixlar som varierar onödigt mycket, och rekommenderas inte under vanlig drift. En diagnostisk logfil med info om bl a himlens ljusstyrka skrivs till logpath, och trigpath och triglogpath används när programmet registrerar en händelse som kan vara en meteor, och skall lagra inspelningen. Slutligen anger maskname namnet på en bild som anger vilken del av synfältet som programmet skall bortse ifrån, och trigexec är det programmet som anropas efter att en händelse har spelats in, och behöver analyseras närmare.
Om något av ovanstående alternativ kommenteras ut, kommer den produkten inte att lagras alls. Detta kan vara en lösning om man av någon anledning vill begränsa datamängden som programmet producerar.
[process] nsum = 1500 nlongsum = 10 nlongmax = 60 ndiffmask = 10 keep_avg = 0 diff_trig_day = 1000.0 diff_trig_night = 0.90 level_day = 90 shadow_filter = 3 diff_consec_limit = 3 diff_pos_thresh = 2.0 diff_pos_hilim = 50.0 angle_hilim = 45.0 save_before_trigger = 15 save_after_trigger = 25 delay = 0 skip = 3 scale = 128
Avsnittet [process] sätter upp parametrar som avgör vilka bilder som skall analyseras av programmet, vilka gränsvärden som anger att en intressant händelse har inträffat, och hur data skall lagras. Parametern nsum anger hur många videoframes skall läsas innan en bild skrivs till archive (förra avsnitt). Vanligtvis motsvarar detta en minut (60 x 25 fps = 1200 frames per minut). Om din framegrabber har en annan bildfrekvens behöver denna siffra anpassas.
Sedan anger nlongsum, nlongmax och ndiffmask antalet minuter efter vilka en bild skall skrivas till longsumarchive, longmaxarchive och diffmaskarchive (se ovan). Om keep_avg = 0 sparar programmet istället max-värden som upmättes under den senaste minuten. Däremot om keep_avg = 1 kommer programmet att lagra en integrerad (summerad) bild som 'minutbild'. En maxbild är nyttigare om man vill kontrollera i efterhand om programmet sett/missat något meteorspår, medan en integrerad bild ger en bättre kontrast och snyggare bildserie, och kan vara användbar om man vill kalibrera kamerans stjärnpositioner.
Värden på diff_trig_day och diff_trig_night motsvarar hur många sigma en pixel måste avvika från sitt långtidsmedelvärde för att programmet skall betrakta pixeln som signifikant avvikande. Det finns olika värden för dag och natt, och gränsen mellan dag och natt ställs med level_day. Programmet räknar varje minut ut ett medelvärde för hela bildrutan och jämför detta med värdet på level_day. Parametern kan lätt kalibreras genom att läsa logfilen under logpath (se ovan), som innehåller bl a det upmätta bakgrundsvärdet.
Om programmet ser att en pixel avvikar signifikant flera bildrutor i rad, nämligen diff_consec_limit till antalet, betraktas händelsen som signifikan rörelse och inspelning börjar. De avvikande pixlarna måste dock förflytta sig minst diff_pos_thresh pixlar, och högst diff_pos_hilim pixlar - detta för att kräva att rörelsen är någorlunda linjär, och inte att händelsen inte består av pixlar som ligger slumpmässigt fördelad över hela bilden. Dessutom skall pixlarna ligga i linje, så att vilkeln mellan pixlar inte avvikar mer än angle_hilim grader, delat med antalet bildrutor mellan punkterna. Standardvärdet 45 grader för angle_hilim rekommenderas starkt.
För att spara processorkraft kan programmet välja att inte analyserar alla bildrutor för rörelse, men instället hoppa över ett visst antal bilder, som anges av skip. Notera att valet av skip påverkar vilka värden som skall sättas in för diff_pos_thresh och diff_pos_hilim, eftersom dessa två parametrar inte skalas upp med värdet på skip. Dessutom är diff_pos_thresh beroende på bildernas spatiella upplösning. T ex, för en kamera med 1/2" chip och 180 graders fält skall diff_pos_thresh sättas till 1.5. Däremot täcker 1/3" chip med samma lins en mindre del av bildfältet, dock med högre upplösning, och då skall diff_pos_thresh sättas till 2.0.
När händelsen avslutas sparar programmet hela sekvensken, och dessutom ett antal bildrutor före (save_before_trigger) och efter (save_after_trigger) händelsen. Däremot, om händelsen överskrider programmets minnesbuffer (typiskt 10 sekunder), så sparas hela den tillgängliga bufferten utan hänsyn till save_after_trigger), och en eventuell forstättning kan komma att registreras som en ny händelse.
Parametern shadow_filter används för att filtrera ut mörka fläcker mot en ljus bakgrund, t ex fåglar dagtid. Bilderna som sparas för publicering på nätet skalas så att medelvärdet är minst lika med scale, vanligtvis 128 (utav 255 djupnivåer). Parametern delay har ingen funktion i nuläget, den finns med för att konfigurationsfilen skall vara kompatibel med tidigare versioner.
[annotation] text = %Y-%m-%d %H:%M:%S %Z fg_red = 255 fg_green = 255 fg_blue = 255 bg_red = 0 bg_green = 0 bg_blue = 0
Avsnittet [annotation] reglerar vilket datumstämpel som skall anges på bilderna (för tillfället enbart livebilden på nätet). Själva strängen definieras i text, och färgerna med de övriga parametrar. Värdet 0 motsvarar svart (till bakgrunden). Om bakgrundsvärdet sätts till -1 blir bakgrunden transparent.
[ftp] dir = /home/meteor/metcam/data file = snap.jpg tmp = uploading.jpeg passive = 1 debug = 0 auto = 0 local = 1 ssh = 0
Avsnittet [ftp] härstammar från programmet webcam (ett rörelsedetekterande program för webbkameror, som används som förebilde för metcam), och dessa parametrar bestämmer var programmet skall spara minutbilderna för publicering på nätet. Ovanstående värden ser till att bilderna sparas till filmappen dir, med namnet file. Det rekommenderas inte att ändra dessa värden. Notera att dir skall stämma överens med rootdir i avsnittet [site].
[www] site_url = "http://yourhostname/~meteor" content_dir = "www/content" style_file = "www/style/style.css"
Slutligen anger site_url under avsnittet [www] var den lokala hemsidan till denna station finns. Om man väljer att installera de tillhörande paketen (se kapitlet Software) kommer det där finnas livebilder, filmer för varje dygn, senaste händelser och mycket mer. Detta kräver dock också att det installeras såkallade cronjobs för att ständigt uppdatera data på webservern, se Configurera cronjobs.