********************************************************************************
* Segment 5 Intelligente Analyseverfahren (IAV), SWE 5.1 Ganglinienprognose    *
********************************************************************************

Version: 2.4.0

Übersicht
=========

Die Ganglinienprognose liefert für einen Zeitbereich in der Zukunft eine
Prognose der Verkehrswerte. Für alle Messquerschnitte werden die Verkehrswerte
QPkw, QLkw, QKfz, QB, VPkw, VLkw und VKfz prognostiziert. Je nach
Prognosehorizont werden dabei unterschiedliche Verfahren eingesetzt und deren
Ergebnisse zusammengefasst.

Als Ergebnis liefert das Verfahren für jede zu prognostizierende Größe eine
Ganglinie mit Prognosewerten im gewünschten Zeitbereich. Die Ergebnisganglinien
entstehen durch Verknüpfung aktueller Verkehrsdaten und kurzfristigen
Prognosedaten mit verschiedenen historischen Ganglinien, die durch
unterschiedliche Auswahlverfahren bestimmt werden.

Die Ganglinienprognose kann von unterschiedlichen Systemfunktionen mit
unterschiedlichen Parametern aufgerufen werden. Die Berechnung der
Prognoseganglinien erfolgt je nach aufrufender Systemfunktion einmalig oder
zyklisch für einen vorgegebenen Prognosezeitbereich.


Versionsgeschichte
==================

2.4.0
=====
- Umstellung auf Java 8 und UTF-8

2.3.0

  - Umstellung auf Maven-Build

2.2.3

  - Bugfix für Mantis #4033: Bei der Auswahl von Ganglinien in einer Anfrage,
    die aus mehreren Teilintervallen besteht, konnte es unter Umständen dazu
    kommen, das bei der Auswahl der Ereignisganglinien sich die Teilintervalle
    gegenseitig beeinflusst haben. 

2.2.2

  - Bugfix für Mantis #4034: Die Ganglinienprognose beendet sich unter
    bestimmten Umständen direkt nach dem Start, wenn beim Starten eine Anfrage
    eintrifft.
  - Mantis #4033: Beim Pattern Matching kommt es unter unbekannten Umständen
    zu einer IllegalArgumentException, weil die Liste der zu vergleichenden
    Ganglinien leer ist. Um das Problem weiter untersuchen zu können, wurden
    zusätzliche Logmeldungen und Fehlerprüfungen eingebaut.

2.2.1

  - Mantis #2363: Verbesserung für verwaltete Betriebsmeldungen
    Die Applikationskennung wird beim Start überschrieben mit
    {Main-Klasse}_{Applikations-ID}, damit sie nicht mehr zu lang wird.

2.2.0

  - Bearbeitung der Anfragen überarbeitet, so das weniger Arbeitsspeicher
    gebraucht wird. Es werden nur noch eine begrenzte Anzahl von Anfragen
    gleichzeitig bearbeitet und alle andern in eine Warteschlange gelegt und
    nacheinander abarbeitet. (Mantis #2103, #2104, #2105)
  - Loggausgaben beim Unit-Test werden wieder angezeigt.
  - Überarbeitung der JUnit-Tests damit sie nach DAF-Upgrade wieder wie gewohnt
    funtionieren.

2.1.0

  - Betriebsmeldungen um Systemobjekt in ID ergänzen, wenn sinnvoll.
    (Mantis #2088)
  - Quelltext kompatibler mit Java 6 gemacht.

2.0.0

  - Umstellung der Ganglinienspeicherung von der Behandlung als Parameter (atg.ganglinie)
    auf eine separate Speicherung in einer Derby DB.

1.3.0

  - Betriebsinformation und Prüfprozedur liegen jetzt im Zustand "akzeptiert"
    vor.
    
1.2.1

  - Betriebsinformation aktualisiert.
  - NEU: Debugausgaben, wenn nicht genug Daten für Prognose (Ganglinien,
    Kalender, Parameter).

1.2.0

  - Prüfprozedur und Prüfprotokoll in Release aufgenommen
  - Betriebsinformation in Release aufgenommen

1.1.0

  - Anpassung an überarbeitetet Funktionsbibliothek de.bsvrz.sys.funclib.bitctrl

1.0.0
  - Getestet Version.

0.9.0

  - Anpassung wegen neuer Paketstruktur der Kernsoftware.
  - Fast fertige aber noch nicht vollständig getestete Version.   

0.5.0

  - Erste Auslieferung, Vorabversion
  

Start der Applikation
=====================

Es wird eine Batchdatei mitgeliefert, die als Vorlage für ein Startskript dienen
kann. Im ersten Abschnitt muss der Skriptparameter -classpath angepasst werden.
-classpath muss auf die folgenden benötigten Bibliotheken verweisen:

 - kernsoftware-bibliothek.jar
 - de.bsvrz.sys.funclib.jar
 - de.bsvrz.iav.gllib.jar
 - de.bsvrz.iav.glprog.jar


Offene Punkte
=============

 - Ohne Kalender können keine Anfragen bearbeitet werden, siehe Hinweise.


Hinweise
========

 - Die aktuelle Version nimmt Anfragen entgegen, arbeitet sie aber nicht ab, da
   ohne Kalender keine geeigneten Ganglinien bestimmt werden können. Stattdessen
   wird eine Meldung für das Log und die Betriebsmeldungsverwaltung generiert,
   dass der Kalender nicht verfügbar ist und die Anfrage wird verworfen.


Disclaimer
==========

Segment 5 Intelligente Analyseverfahren (IAV), SWE 5.1 Ganglinienprognose
Copyright (C) 2007 BitCtrl Systems GmbH 

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51
Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.


Kontakt
=======

BitCtrl Systems GmbH
Weißenfelser Straße 67
04229 Leipzig
Phone: +49 341-490670
mailto: info@bitctrl.de
