TDKVF.DAT

Basisinformationen

Datei-Typ

tdkvf.dat

Datei-Form

FORMATTED

Version

9.x / Juli 2009

Beschreibung

Juli 2009

Bedeutung der Datei

enthält allgemeine Eingabedaten für das Programm TDKVF

Datei-Inhalt

Vorbemerkungen zur Benutzung des Programms Eine erfolgreiche Ausführung des Programms TDKVF garantiert noch nicht, dass die damit erzielten Ergebnisse korrekt sind. Von dem Anwender sind in jedem Fall die Ergebnisse auf Plausibilität zu prüfen, bevor diese weitergehend verwendet werden. Hierbei sollen in jedem Fall die Ergebnisse für

• KF (Eintrittszeit Flutstromkenterung),
• KE (Eintrittszeit Ebbestromkenterung),
• KPVF (Kenterpunktabstand Flutstromkenterung) und
• KPVE (Kenterpunktabstand Ebbestromkenterung)

kontrolliert werden. Die Plausibilitätskontrolle sollte nicht nur für die Mittelwerte, sondern auch für die einzelnen Ereignisse durchgeführt werden. Sind die Ergebnisse nicht plausibel, so liegt dies häufig an einer unzweckmäßigen Wahl der verschiedenen Zeitfenster-Parameter oder an unzureichenden (Hilfs-) Referenzpositionen.

Kenntnis der realen Gegebenheiten, insbesondere der Abstände der Kenterpunkte der Strömung von den lokalen Thw- bzw. Tnw-Zeiten sind für eine erfolgreiche Anwendung von TDKVF unverzichtbare Voraussetzung.

Das Programm ist ungeeignet zur Analyse von Systemen, in denen nicht über den gesamten Analysezeitraum ein dominantes Tidesignal vorhanden ist. In diesen Fällen sollte geprüft werden, ob die Verwendung des Programms LZKVF eine geeignete Alternative darstellt.
Dateiinhalt (optional) maximale Feldgrenzen für verschiedene Fortran-Felder

• Topografie:

1. MAXELE: maximale Anzahl der (Dreiecke) im Gitter (sind Vierecke in einem Gitter enthalten, so werden diese beim Lesen in zwei Dreiecke zerlegt).
2. MAXKNO2D: maximale Anzahl der Punkte (Knoten des Gitters).
3. MAXKNO3D: maximale Anzahl der Berechnungspunkte. Bei drei-dimensionalen Datensätzen i.d.R. deutlich größer als MAXKNO2D anzugeben.
4. MAX_LPROFIL: maximale Anzahl der in einer Profiltopographie vorhandenen Längs- und Quer-Profile.
5. MAX_GEOPOS: maximale Anzahl der Geopositionen (Geopositionen sind besonders ausgezeichnete Profilpunkte mit z.B. zusätzlichen Textinformationen).
6. MAX_PKNO: maximale Anzahl der auf Längs- und Quer-Profilen vorhandenen Profilpunkte.
7. MAX_SEGMENT: maximale Anzahl der Segmente auf Längs- und Quer-Profilen.

• Analysedaten:

1. MAXXTR: maximale Anzahl der (Thw- oder Tnw-) Ereignisse innerhalb des Analysezeitraums.
2. MAXANAKNO2D: maximale Anzahl der in einem Analysezyklus verarbeitbaren 2D-Berechnungspunkte (für tiefengemittelte Daten).
3. MAXANAKNO3D: maximale Anzahl der in einem Analysezyklus verarbeitbaren 3D-Berechnungspunkte (für tiefenstrukturierte Daten).
4. MAX_SKALAR_2D: maximale Länge des Extremwertspeichers für tiefengemittelte, skalare Daten; sollte dem Wert von Anzahl der Ereignisse im Analysezeitraum multipliziert mit MAXANAKNO2D entsprechen.
5. MAX_SKALAR_3D: maximale Länge des Extremwertspeichers für tiefenstrukturierte, skalare Daten; sollte dem Wert von Anzahl der Ereignisse im Analysezeitraum

   multipliziert mit MAXANAKNO3D entsprechen.

6. MAX_VEKTOR_2D: maximale Länge des Extremwertspeichers für tiefengemittelte, vektorielle Daten; sollte dem Dreifachen von MAX_SKALAR_2D entsprechen.
7. MAX_VEKTOR_3D: maximale Länge des Extremwertspeichers für tiefenstrukturierte, vektorielle Daten; sollte dem Vierfachen von MAX_SKALAR_3D entsprechen.

• Zeitserie, z-Schichten und Datenvariationen:

1. MAXNAZ: maximale Länge der zu analysierenden Zeitserien, so wie sie in den Datendateien abgelegt sind.
2. MAXKMX: maximale Anzahl der z-Schichten im drei-dimensionalen Berechnungsgitter.
3. MAXVAR: maximale Anzahl der Datenvariationen, i.d.R. 1.

Die vom Anwender vorgegebenen maximalen Feldgrenzen können die Performance des Programms beeinflussen. Optimale Performance (geringster CPU-Zeitbedarf) wird erreicht, falls die Analyse für alle Datenpunkte in einem Analysezyklus durchgeführt werden kann. Dann ist allerdings der Memorybedarf der Anwendung am größten, da sehr viele Daten bis zu deren Ausgabe zwischengespeichert werden müssen. Die Analyse ist genau dann in einem Analysezyklus möglich, falls MAXANAKNO2D größer oder gleich MAXKNO2D und MAXANAKNO3D ebenfalls größer oder gleich MAXKNO3D vereinbart wird, und darüber hinaus die anderen Maximalwerte die o.g. Anforderungen ebenfalls erfüllen. Das funktioniert natürlich nur dann, insofern keine Einschränkungen durch das vorhandene Memory gegeben sind.
Art der Analyse, Eingangsdaten

• Datei 1: Wasserstand, (bedarfsweise) zeitvariable Topografie:

• ZEIDIR: Zeitserienanalyse.
• Dateiname des Typs dirz.bin mit den zu analysierenden Zeitserien.

• In der Datei müssen Wasserstands-Zeitserien sowie (optional) Topografie-Zeitserien enthalten sein, falls die Simulation mit alternativer Topografie durchgeführt wurde.
• Datei 2: Strömung:

• ZEIDIR: Zeitserienanalyse.
• Dateiname des Typs dirz.bin mit den zu analysierenden Zeitserien.

• In der Datei müssen Strömungs-Zeitserien enthalten sein.

Anmerkungen: Liegen Zeitserien für tiefengemittelte Daten vor, so können alle Daten in einer Datei enthalten sein. Tiefenstrukturierte Daten liegen dagegen immer in verschiedenen Dateien vor. Sollen Daten mit alternativer Topografie verarbeitet werden, so ist eine Analyse nur für Daten mit zeitlich konstanter Topografie möglich. Daten einer Simulation mit Morphodynamik können für die Ermittlung der Tidekennwerte der Strömung nicht verwendet werden.
Analysezeitraum

• Beginn des Analysezeitraums.
• Ende des Analysezeitraums.

Der Beginn des Analysezeitraums sollte ca. 3-4 Stunden vor dem ersten zu analysierenden Tnw an der Haupt-Referenzposition liegen. Der Analysezeitraum sollte ca. 3-4 Stunden nach dem Eintritt des Tnw an der Haupt-Referenzposition enden. Idealer Weise sollte die Analyse mit einem Tnw beginnen und mit einem Tnw enden. Der Analysezeitraum sollte möglichst nicht den gesamten in der Datei abgespeicherten Zeitraum umfassen. Vor Beginn sowie nach Ende des Analysezeitraums sollten in der Datei noch Daten für jeweils eine Tide enthalten sein. Bei sehr großen Simulationsgebieten ist auch das ggf. nicht ausreichend.
Koordinaten der Haupt-Referenzposition Tidezuordnung

• X-Koordinate,
• Y-Koordinate, und
• Z-Koordinate.

Die Lage dieser Position muss so gewählt werden, dass

1. der zur Position am nächsten gelegene Knotenpunkt niemals trockenfällt,
2. die gewünschten Thw-, Tnw-, Kf- und Ke-Ereignisse einwandfrei erkennbar sind, und
3. das erste und letzte zu analysierende Ereignis hinreichend weit von Beginn und Ende des Analysezeitraums entfernt liegt (siehe auch oben).
   

Werden von mit Programm DIDAMINTQ querschnittsintegrierte Daten weiter verarbeitet, so muss hierfür ein geeigneter Haupt-Profilpunkt aus den damit erzeugten geopos-Dateien gewählt werden.
Koordinaten der Haupt-Referenzposition Phasenbezug

• X-Koordinate,
• Y-Koordinate, und
• Z-Koordinate.

Es gelten die obigen Empfehlungen. Auf diese Position werden die Eintrittszeitdifferenzen der lokalen Flut- und Ebbestromkenterung bezogen. Die Lage ist zweckmäßig zu wählen, um die Interpretation der Eintrittszeitdifferenzen in Bezug auf die Ausbreitung der Tidewelle im ortsspezifischen Modell zu erleichtern.
Additionskonstante für die Koordinaten

• X: x-Koordinate des Nullpunkts.
• Y: y-Koordinate des Nullpunkts.
• Z: z-Koordinate des Nullpunkts.

Falls die Koordinaten in der Gitterdatei gegen einen von (0.0,0.0,0.0) abweichenden Ursprung verschoben sind, müssen hier die entsprechenden Werte vorgegeben werden. Die hier angegebenen Zahlen werden zu den Gitterkorrdinaten addiert.
Steuerdaten für die Analyse

• Wasserstand:

• IFV: Zeitfenster in Minuten, innerhalb dem ein Thw- bzw. Tnw-Eintritt vor dem Eintritt an der jeweiligen Referenzposition erfolgen muss, um noch als zu demselben (Tide-) Ereignis gehörend erkannt zu werden. Der Wert liegt typischer Weise zwischen 60 und 180 Minuten.
• IFN: Zeitfenster in Minuten, innerhalb dem ein Thw- bzw. Tnw-Eintritt nach dem Eintritt an der jeweiligen Referenzposition erfolgen muss, um noch als zu demselben (Tide-) Ereignis gehörend erkannt zu werden. Der Wert liegt typischer Weise zwischen 60 und 180 Minuten.
• ZEITFENSTER: Zeitraum in Minuten, innerhalb dem ein Extremwert (Maximum oder Minimum) ein absolutes Extrema sein muss, um als ein gültiges Thw- oder Tnw-Ereignis registriert zu werden. Dieser Parameter hilft bei der Suche nach den richtigen Extrema, da relative Extrema damit sicher ausgeschlossen werden können. Der Wert liegt typischer Weise zwischen 30 und 120 Minuten.
• KHLIMIT: minimale Wasserbedeckung in Metern für die Analyse. Unterschreitet die aktuelle Wasserbedeckung diesen Wert, so wird eine Position als trocken gefallen betrachtet und die Wasserstands- sowie Strömungsdaten nicht analysiert. Der Wert liegt typischer Weise zwischen 0.01 und 0.10 Metern.

Hinweis: dieser Wert kann von der in der Simulation benutzten minimalen Schichtdicke abweichen. Liegt der in der Simulation benutzte Wert über dem hier gesetzten Wert, so wird auch für die Analyse der in der Simulation benutzte Wert verwendet. War der in der Simulation benutzte Wert hingegen kleiner, so wird der hier angegebene Wert benutzt. Im Idealfall sollte allerdings derselbe Wert wie in der Simulation benutzt werden, um die volle Genauigkeit auszuschöpfen. Insbesondere bei tiefenstrukturierten Daten werden bei einem zu groß gewählten KHLIMIT-Wert die Berechnungsschichten des z-Gitters in der Analyse vorzeitig trockengelegt und damit die Genauigkeit der Analyseergebnisse verschlechtert. Dies spielt insbesondere dann eine Rolle, falls aus tiefengemittelten Eingangsdaten abgeleitete Analyseergebnisse mit aus tiefenstrukturierten Eingangsdaten abgeleiteten tiefengemittelten Analyseergebnissen verglichen werden sollen.

Für diese vier Parameter sollten dieselben Werte wie in dem Programm TDKWF verwendet werden. Zur Defintion von Thw und Tnw siehe unter Tidekennwerte des Wasserstands.

• Ebbestromkenterung sowie Stauwasserdauer bei Ebbestromkenterung (Ke):

• IFV: Zeitfenster in Minuten, innerhalb dem Ke vor dem Eintritt des lokalen Tnw erfolgen darf, um noch als zu demselben (Tide-) Ereignis gehörend erkannt zu werden.

Der Wert beträgt typischer Weise zwischen 0 und 60 Minuten.

• IFN: Zeitfenster in Minuten, innerhalb dem Ke nach dem Eintritt des lokalen Tnw erfolgen darf, um noch als zu demselben (Tide-) Ereignis gehörend erkannt zu werden.

Der Wert liegt typischer Weise zwischen 60 und 180 Minuten.

• ZEITFENSTER: Zeitraum in Minuten, innerhalb dem ein Strömungsminimum ein absolutes Minimum sein muss, um als ein gültiges Ke-Ereignis registriert zu werden. Dieser Parameter hilft bei der Suche nach den richtigen Extrema, da relative Extrema damit sicher ausgeschlossen werden können. Der Wert liegt typischer Weise zwischen 30 und 90 Minuten.
• VSTAU: Grenzgeschwindigkeit in m/s zur Berechnung der Stauwasserdauer bei Ke. Die Stauwasserdauer bei Ke bezeichnet den Zeitraum, in dem die

Strömungsgeschwindigkeit kleiner als VSTAU ist. Der Wert liegt typischer Weise zwischen 0.1 und 0.2 m/s.

Hinweis: In den tiefen (Schifffahrts-) Rinnen der deutschen Ästuare erfolgt Ke i.d.R. nach Tnw. Die Zeitdifferenz wächst von der Tidegrenze nach See an, und kann in den seewärtigen Gebieten zwei Stunden betragen.

• Flutstromkenterung sowie Stauwasserdauer bei Flutstromkenterung (Kf):

• IFV: Zeitfenster in Minuten, innerhalb dem Kf vor dem Eintritt des lokalen Thw erfolgen darf, um noch als zu demselben (Tide-) Ereignis gehörend erkannt zu werden. Der Wert beträgt typischer Weise zwischen 0 und 60 Minuten.
• IFN: Zeitfenster in Minuten, innerhalb dem Kf nach dem Eintritt des lokalen Thw erfolgen darf, um noch als zu demselben (Tide-) Ereignis gehörend erkannt zu werden. Der Wert liegt typischer Weise zwischen 60 und 180 Minuten.
• ZEITFENSTER: Zeitraum in Minuten, innerhalb dem ein Strömungsminimum ein absolutes Minimum sein muss, um als ein gültiges Kf-Ereignis registriert zu werden. Dieser Parameter hilft bei der Suche nach den richtigen Extrema, da relative Extrema damit sicher ausgeschlossen werden können. Der Wert liegt typischer Weise zwischen 30 und 90 Minuten.
• VSTAU: Grenzgeschwindigkeit in m/s zur Berechnung der Stauwasserdauer bei Kf. Die Stauwasserdauer bei Kf bezeichnet den Zeitraum, in dem die Strömungsgeschwindigkeit kleiner als VSTAU ist. Der Wert liegt typischer Weise zwischen 0.1 und 0.2 m/s.

Hinweis: In den tiefen (Schifffahrts-) Rinnen der deutschen Ästuare erfolgt Kf i.d.R. nach Thw. Die Zeitdifferenz wächst von der Tidegrenze nach See an, und kann in den seewärtigen Gebieten zwei bis drei Stunden betragen.

Auswahl der Analysemethoden, Dateien für die Analyseergebnisse Für die Auswahl der Analysen muss jeweils ein Steuerwort, gefolgt von logischen Indikatoren zur Kennzeichnung der Durchführung und Datenausgabe tiefengemittelter sowie tiefenstrukturierter Analysen, und schließlich der (gemeinsame) Namensbestandteil der Dateien für die jeweiligen Analyseergebnisse angegeben werden. Die Ergebnisse werden getrennt für tiefengemittelte und tiefenstrukturierte Daten in eine Datei des Typs dirz.bin geschrieben. Steuerworte für flutstrombezogene Strömungskenngrößen:

• KF: Eintrittszeit Flutstromkenterung Kf
• (optional) VFX: maximale Flutstromgeschwindigkeit
• (optional) VFM: mittlere Flutstromgeschwindigkeit
• (optional) QF: Flutstromvolumen
• (optional) FDAU: Flutstromdauer
• (optional) STWKF: Stauwasserdauer bei Flutstromkenterung
• (optional) KPVF: Kenterpunktabstand Flutstromkenterung
• (optional) DTVFX: Differenzen der Eintrittszeit des Flutstrommaximums
• (optional) FW: Eulerscher Flutweg

Steuerworte für ebbestrombezogene Strömungskenngrößen:

• KE: Eintrittszeit Ebbestromkenterung Ke
• (optional) VEX: maximale Ebbestromgeschwindigkeit
• (optional) VEM: mittlere Ebbestromgeschwindigkeit
• (optional) QE: Ebbestromvolumen
• (optional) EDAU: Ebbestromdauer
• (optional) STWKE: Stauwasserdauer bei Ebbestromkenterung
• (optional) KPVE: Kenterpunktabstand Ebbestromkenterung
• (optional) DTVEX: Differenzen der Eintrittszeit des Ebbestrommaximums
• (optional) EW: Eulerscher Ebbeweg

Steuerworte für dimensionslose, tidebezogene Strömungskenngrößen (Verhältniswerte):

• (optional) FEDAU: Verhältnis Flutstromdauer : Ebbestromdauer
• (optional) FEX: Verhältnis max. Flutstromgeschwindigkeit : max. Ebbestromgeschwindigkeit
• (optional) FEM: Verhältnis mittl. Flutstromgeschwindigkeit : mittl. Ebbestromgeschwindigkeit
• (optional) FEW: Verhältnis Eulerscher Flutweg : Eulerscher Ebbeweg
• (optional) FEQ: Verhältnis Flutstromvolumen : Ebbestromvolumen

Steuerworte für dimensionsbehaftete, tidebezogene Strömungskenngrößen:

• (optional) VR: Eulerscher Reststrom
• (optional) SR: Eulerscher Reststromweg
• (optional) QR: Restdurchfluß
• (optional) QT: Tidestromvolumen

Hinweise:

1. Die Eintrittszeitdifferenzen werden für alle Datenpunkte in Bezug auf die oben genannte Referenzposition Phasenbezug ermittelt.
2. Falls FW, EW, VR, SR, FEM oder FEW gewählt wurde, so muss auch VFM und VEM angegeben werden.
3. Falls STWKF, STWKE, DTVFX, DTVEX oder FEX gewählt wurde, so muss auch VFX und VEX angegeben werden.
4. Falls QR, QT oder FEQ gewählt wurde, so muss auch QF und QE angegeben werden.

• Ende der Eingabe der Analysegrößen

• ENDDATA

• (optional) Hilfs-Referenzpositionen

Mit den Hilfs-Referenzpositionen (HR) kann eine verkettete Liste von räumlich über das zu analysierende System verteilten Punkten erzeugt werden, die an dem Haupt-Referenzpunkt Tidezuordnung (RT) ihren Ausgang nimmt. Programmintern werden zunächst, ausgehend von dem Haupt-Referenzpunkt RT an allen HRs die Kennwertanalysen durchgeführt, wobei für die korrekte Phasenzuordnung der Ereignisse auf den jeweiligen Vorgänger (Referenzposition) verwiesen wird. Auf diesem Wege gelingt es, eine konsistente Zuordnung der einzelnen Kennwerte zu den richtigen Tiden (Ereignissen) auch in großen Systemen zu erzielen, in denen die Laufzeit der Tidewelle vergleichbar mit der Tidedauer oder sogar größer als diese ist.

• X: x--Koordinate der Hilfs-Referenzposition.
• Y: y-Koordinate der Hilfs-Referenzposition.
• Z: z-Koordinate der Hilfs-Referenzposition.
• HORD: Ordnungszahl der Hilfs-Referenzposition. Diese muss größer als 1 sein (mit 1 wird die Haupt-Referenzposition Tidezuordnung bezeichnet).
• VORD: Ordnungszahl der vorangehenden (Hilfs-) Referenzposition, von der diese Hilfs-Referenzposition ihre Analysezeitfenster übernimmt. Wenigstens ein Mal muss auf die Haupt-Referenzposition Tidezuordnung RT verwiesen werden. Es kann mehrfach auf dieselbe Vorgänger-Referenzposition verwiesen werden, z.B. bei Verzweigungen.

Die Lage dieser Positionen muss so gewählt werden, dass

1. der zur Position am nächsten gelegene Knotenpunkt niemals trockenfällt, und
2. die gewünschten Thw-, Tnw-, Kf- und Ke-Ereignisse einwandfrei erkennbar sind.

• Ende der Eingabesteuerdaten

• ENDDATA

Programme, welche diesen Datei-Typ benutzen

TDKVF

Beispiel-Datei

$PROGHOME/examples/Tdkvf/Tdkvf.dat (Analyse tiefengemittelter Daten), und

$PROGHOME/examples/Tdkvf/Tdkvf.3D.dat (Analyse tiefenstrukturierter Daten).

---

zurück zu: Dateikennblätter

---

Strukturübersicht