kvAgregated

Dette programmet mottar observasjoner fra kvalobs og genererer aggregerte verdier på grunnlag av disse. De aggregerte verdiene sendes så tilbake til kvalobs.

Følgende liste viser hvilke parametre fra kvalobs som generer hva:

Merk at det også genereres aggregerte verdier av de aggregerte verdiene, så dersom for eksempel en stasjon kun rapporterer RR_1 vil både RR_12 og RR_24 aggregeres.

Det er også verd å merke seg at aggregeringene oppdateres etterhvert som grunnlagsdata oppdateres, så dersom for eksempel en observasjon av RR_1 endres av HQC, vil aggregerte verdier av RR_12 oppdateres tilsvarende.

De aggregerte parametrene vil ha lik stasjonsid, sensor og level som de parametrene som aggregeres. typeid, derimot, vil endres til å bli lik den negative verdien av den originale typeid. Dette medfører at aggregerte verdier lett kan skilles fra ikke-aggregerte verdier i kvalobs.

De aggregerte verdiene får kontrollflagg fylt ut med bare null-verdier, med unntak av fagg, og fmis, som settes i henhold til flaggdokumentet. Som ellers i kvalobs beregnes useinfo ut ifra kontrollinfo.

Det er viktig å merke seg at siden de aggregerte parametrene får negativ typeid, blir de av kvalobs oppfattet som forskjellige stasjoner fra “grunnlagsstasjonene”. Dette, sammen med at stasjoner med negativ typeid ikke fins i obs_pgm, medfører at det ikke blir gjort noen kvalitetskontroll av de aggregerte verdiene.

For å kjøre kvAgregated må sqlite3 være installert.

Under installasjon kjøres skriptet kvAgregateDbInit. Dette skriptet lager en cachedatabase for aggregatoren. For at den skal kunne brukes, må kvalobs-brukeren ha skriverettigheter dit. Databasen legges i fila {localstatedir}/kvagregated/database.sqlite. localstatedir er normalt området /var eller /usr/local/var på maskinen. For å gi kvalobsbrukeren skriverettigheter til denne kan man for eksempel si:

chmod kvalobs:kvalobs /var/kvagregated/database.sqlite

Når kvAgregated startes vil den i begynne med å hente ned data fra kvalobs for de siste 24 timene. Dette er resurskrevende, og programmet bør ikke startes mens kvalobs har mye annet å gjøre, dvs at hver hele og halve time bør unngås for oppstart.

Etter oppstarten vil aggregerte data genereres fortløpende, etterhvert som grunnlagsdata kommer inn.

kvAgregated tar flere kommandolinjeargumenter. For å få en liste over disse, kan du kjøre følgende kommando:

kvAgregated --help

Opsjonene til kommandolinja lar deg styre aggregeringen på forskjellige måter. For eksempel kan du begrense hvilke stasjoner eller parametre som skal aggregeres, eller du kan få aggregatoren til å gå igjennom, og reprosessere gammel data.

Hvis kvalobs går ned kan det være en god ide å også restarte kvAgregated, gjerne gjennom å si kvstart.

Idet aggregatoren begynner å kjøre igjen, vil den automatisk gå igjennom data for de siste tre timene, for å se om det har kommet noe nytt å aggregere siden den gikk ned.

Hvis aggregatorene har vært lengre nede enn tre timer, må kommandolinjeopsjoner settes for å få aggregatoren til å prosessere data lengre bak enn tre timer. Kjør kvAgregated –help for detaljer.

RR_12 vil ikke aggregeres fra RA dersom RA-verdien har minket betraktelig siden sist aggregering (for eksempel dersom målebøtta har blitt tømt).

Følgende korrigeringsalgoritme er implementert:

• Hvis RR_12(t) = RA(t)-RA(t-12) < 0 Sett RR_12(t) = 0

• Hvis RR_12(t) = RA(t)-RA(t-12) > 0 og RA(t-12)-RA(t-24) <= -100 sett RR_12(t) = RA(t)-RA(t-12)

ellers:

• Hvis RR_12(t) = RA(t)-RA(t-12) > 0 og RA(t)-RA(t-24) <= 0 Sett RR_12(t) = 0

• Hvis RR_12(t) = RA(t)-RA(t-12) > 0 og RA(t)-RA(t-24) > 0 og RA(t-12)-RA(t-24)>=0 sett RR_12(t) = RA(t)-RA(t-12)

• Hvis RR_12(t) = RA(t)-RA(t-12) > 0 og RA(t)-RA(t-24) >=0 og RA(t-12)-RA(t-24) < 0 sett RR_12(t) = RA(t)-RA(t-24)