2.5.2. Struktura okna

WindowID
Title
NumberOfAxes_n
<opis_osi_0>
<opis_osi_1>
...
<opis_osi_n-1>
FirstDraw
NumberOfDraw_m
<opis_wykresu_1>
<opis_wykresu_2>
...
<opis_wykresu_m>

Każdy opis okna jest otoczony dodatkowymi liniami komentarza:

# okno x {
...
# koniec okna x }

które są automatycznie generowane przez program przy wymuszonym zapisie ekrnxxxx.cor. Nawiasy klamrowe ułatwiają przechodzenie od okna do okna w edytorze vi - klawiszem %.

Pola:

• Nazwa: WindowID

  Typ: unsigned long, zapisany w hexie

  Opis: Identyfikator okna, określający jego specjalne właściwości. Pole to jest najczęściej sumą bitową identyfikatora rodzaju okna (patrz niżej) i wyróżników wykresów, których dotyczą te właściwości. Najmłodszy bit dotyczy wykresu 1, starszy wykresu 2 itd. aż do 12 bitu, czyli ostatnie trzy cyfry w hexie mogą przybierać wartość od 000 (nie dotyczy żadnego wykresu) do 3ff (dotyczy 12 wykresów). Najstarsze 4 bity zarezerwowane są na identyfikatory rodzaju, i tak:

  • 80000XXX - okno definiowalne, czyli okno, którego skład może użytkownik określić sam; standardowo bity wykresów są niewykorzystywane (ten identyfikator występuje tylko w ekrnxxxx.def, nigdy w ekrnxxxx.cor)

  • 40000XXX - wydajności ciepłowni, rzadko używane okno; w oknie dodatkowym tworzony jest wykres tortowy z porcjami wyznaczonymi przez wykresy wyróżnione odpowiednimi bitami WindowID

  • 20000XXX - sumowanie godzinowo, najczęściej używana funkcja, w wyniku której w oknie dodatkowym pojawiają się dodatkowe zestawienia dotyczące wykresów wyróżnionych odpowiednimi bitami; takich operacji dokonuje się na wydajnościach, przepływach i wszystkich pozostałych wielkościach liczonych jako pewna wielkość dzielona przez czas (zawsze - godziny); przykładowo: 20000005 oznacza, że sumowane mają być wykres nr 1 i wykres nr 3

  Jest możliwe umieszczenie w oknie definiowalnym wydajności ciepłowni (wówczas identyfikator ma postać c0000XXX) albo sumowania godzinowego (wówczas identyfikator ma postać a0000XXX) i odpowiednich bitowych wyróżników wykresów. Generalnie jednak nie należy się tym przejmować, bo okna definiowalne są zwykle w pełni obsługiwane przez program. Należy natomiast pamiętać o tym, że nie są dozwolone identyfikatory mieszane, np. 60000XXX.

  Poza identyfikatorami będącymi sumami bitowymi występują jeszcze inne (oprócz 0 - rzadkie) identyfikatory:

  • 0 - najczęstszy: zwykłe okno bez żadnych szczególnych właściwości

  • 1 - zawory: obecnie już nie stosowane, zachowane dla kompatybilności wstecz - wszystkie wykresy w oknie traktowane są jako binarne wskazania krańcówek zaworów, gdzie wartość 1 oznacza zawór otwarty, wartość -1 oznacza zawór zamknięty, natomiast pozycja pośrednia to brak danych; dla takiego okna program sam wyznacza osie i pola DivBy wykresów (patrz dalej)

  • 2 - wykresxy: rzadko używana prymitywna funkcja y=f(x), bez żadnych filtrów czy uśrednień; takie okno tworzy tylko program przeglądający - w pliku ekrnxxxx.cor ta wartość jako identyfikator nie ma prawa się znaleźć

  • 3 - stosunek: występuje tylko na Ciepłowni Głównej w Suwałkach - w oknie muszą być dokładnie dwa wykresy, których stosunek wartości pierwszego do drugiego umieszczony jest w oknie dodatkowym.

  • 4 - różnica: występuje tylko na Ciepłowni Głównej w Suwałkach; w oknie dodatkowym podawana jest różnica wartości: ostatnia-pierwsza widocznego w oknie wyświetlanego wykresu, albo w przypadku rozdwojonego kursora wartość drugiego kursora minus wartość drugiego kursora.

• Nazwa: Title

  Typ: char, maksymalna długość 50 znaków

  Opis: Tytuł okna. Dozwolone są wszystkie znaki oprócz '*' (gwiazdka), który występuje tylko na początku tytułów okien definiowalnych. Ponieważ treść tytułu okna definiowalnego jest dowolny, '*' na początku nazwy w liście dostępnych okien pokazuje, że jest to okno definiowalne.

• Nazwa: NumberOfAxes

  Typ: unsigned char

  Opis: Ilość dostępnych osi, których może być nie więcej niż wykresów, czyli 12. Osie są indeksowane od zera.

• Nazwa: FirstDraw

  Typ: unsigned char

  Opis: Numer porządkowy pierwszego wykresu, zazwyczaj 1, czasami (np. Wydajności ciepłowni) 0.

• Nazwa: NumberOfDraw

  Typ: unsigned char, maksymalnie 12

  Opis: Ilość opisów wykresów. Wykresy indeksowane są od 1.