K MODEL.DAT
Aus BAWiki
Basisinformationen
Datei-Typ
k_model.dat
Datei-Form
FORMATTED
Version
6.x / Dezember 2009
Beschreibung
Dezember 2009
Bedeutung der Datei
allgemeine Eingabesteuerdaten für das Softwarepaket K-Modell
Datei-Inhalt
- Block Test_Output zur Spezifikation des Umfangs der Test-Ausgaben:
- Key "Level" zur Steuerung des Umfangs der Testausgaben mit den zulässigen Werten None, Low, Moderate, Medium, High und Extreme.
- Block Start_Restart_Specifications mit verschiedenen Angaben zur Beschreibung des Anfangszustands:
- Key "Cold_Start" mit den Werten Yes oder No :
falls Yes, dann wird der Anfangszustand aus den Angaben in dem Block Initial_Spectra ermittelt; falls No, dann wird der Anfangszustand aus den in einem vorangehenden Modell-Lauf erzeugten Dateien
- BLFYYYYMMDDhhmmss und
- LAFYYYYMMDDhhmmss.
gelesen. Diese Dateien müssen für den Starttermin YYYYMMDDhhmmss in dem Arbeitsverzeichnis vorhanden sein.
- Key "Restart_Output_Timestep" mit Angaben zum Zeitschritt für das Schreiben von Sicherungsdateien
* BLFYYYYMMDDhhmmss und
* LAFYYYYMMDDhhmmss.
Die Sicherungsdateien können in einem späteren Simulationslauf als Restart-Dateien wieder verwendet werden.
3. Block Initial_Spectra zur näheren Beschreibung des Anfangszustands falls Cold_Start=Yes vereinbart wurde:
1. Key "Type_Of_Spectra" zur Bezeichnung der Art des Anfangsspektrums; die folgenden Möglichkeiten sind zulässig:
1. "Energy_Equal_Zero": keine anfängliche Seegangsenergie;
2. "Wind_Independent": wind-unabhängiges Seegangsspektrum, welches aus den nachfolgend angegebenen Seegangsparametern abgeleitet wird;
3. "Wind_Dependent": wind-abhängiges Seegangsspektrum, welches aus der nachfolgend angegebenen Fetch-Länge und dem lokalen Windfeld zum Start-Termin abgeleitet wird.
2. Key "Phillips_Parameter", Seegangsparameter, der mit Hilfe des Programmes WESPE bestimmt werden sollte;
3. Key "Peak_Frequency", Seegangsparameter, der mit Hilfe des Programmes WESPE bestimmt werden sollte;
4. Key "Overshoot_Factor", Seegangsparameter, der mit Hilfe des Programmes WESPE bestimmt werden sollte;
5. Key "Left_Peak_Width", Seegangsparameter, der mit Hilfe des Programmes WESPE bestimmt werden sollte;
6. Key "Right_Peak_Width", Seegangsparameter, der mit Hilfe des Programmes WESPE bestimmt werden sollte;
7. Key "Wave_Direction", Richtung, in die sich der Seegang ausbreitet, z.B. Norden (0.0 Grad) oder Osten (90.0 Grad);
8. Key "Fetch", Fetch-Länge in (m).
4. Block Timestep_For_Integration mit Angaben zu den verschiedenen Zeitschritten:
1. Key "Propagation_Timestep", Zeitschritt für die Seegangsausbreitung, die Tiefen- und die Strömungsrefraktion; verletzt der vom Anwender vorgegebene Zeitschritt die CFL-Bedingung, so wird der Zeitschritt (programmintern) so lange halbiert, bis die CFL-Bedingung wieder erfüllt ist, so dass ein CFL-bedingter Programmabbruch hierdurch vermieden wird; der programmintern benutzte Zeitschritt wird dabei niemals größer als der vom Anwender vorgegebene Wert sein;
2. Key "Source_Timestep", Zeitschritt für die Berücksichtigung der Quellen und Senken (Wind, nichtlineare Dissipation, sowie Dissipation durch Wechselwirkung mit der Sohle);
3. Key "Ratio_Propagation_Refraction", ganzzahliger Verhätniswert zwischen den Sub-Zeitschritten für Ausbreitung und Refraktion.
5. Block Options mit Angaben zur Berücksichtigung von zeit- und ortsvariabler Wasserbedeckung und Strömung, Radiation Stress sowie verschiedenen Angaben zur Steuerung der Interpolation von Randwerten und Berechnungsergebnissen zwischen verschiedenen Gitternetzen:
1. Key "Depth_Option" zur Steuerung des Einflusses der Wassertiefe:
1. Deep_Water: Tiefwasser-Approximation;
2. Time_Variable_Depth: zeitvariable Wassertiefe
3. sowie der Berechnung des Radiation Stress:
2. Key "Current_Option" zur Steuerung des Einflusses der Strömungsgeschwindigkeit:
1. No_Current: kein Strömungseinfluss;
2. Time_Variable_Current: zeitvariable Strömung.
3. Key "Radiation_Option" zur Steuerung der Berechnung des Radiation Stress:
1. No_Radiation_Stress: keine Berechnung des Radiation Stress;
2. With_Radiation_Stress: mit Berechnung des Radiation Stress.
4. (optional) Key "Import_Max_Radius" zur Vorgabe des max. (Such-) Radius in Meter beim Datenimport (Interpolation von dem Wasserstands- und Strömungsgitter auf das Seegangsgitter); wird dieser Key nicht angegeben, so wird der Wert 2000.0 m verwendet.
5. (optional) Key "Import_Min_Nearest" zur Vorgabe der minimal erforderlichen Anzahl Interpolationspunkte beim Datenimport; für jeden Berechnungspunkt des Seegangsgitters müssen im Umkreis von "Import_Max_Radius" eine Mindestanzahl von Punkten mit Wasserstand und Strömung vorhanden sein; wird dieser Key nicht angegeben, so wird der Wert 3 (Interpolationspunkte) benutzt.
6. (optional) Key "Export_Max_Radius" zur Vorgabe des max. (Such-) Radius in Meter beim Datenexport (Interpolation von dem Seegangsgitter auf das Wasserstands- und Strömungsgitter); wird dieser Key nicht angegeben, so wird der Wert 2000.0 m verwendet.
7. (optional) Key "Export_Min_Nearest" zur Vorgabe der minimal erforderlichen Anzahl Interpolationspunkte beim Datenexport; für jeden Punkt des Wasserstands- und Strömungsgitters (z.B. Gitterpunkte eines gekoppelten HN-Modells) müssen im Umkreis von "Export_Max_Radius" eine Mindestanzahl von Punkten mit Seegangsdaten vorhanden sein; wird dieser Key nicht angegeben, so wird der Wert 3 (Interpolationspunkte) benutzt.
6. Block Wave_Discretisation mit Angaben zur Diskretisierung des Seegangsspektrums:
1. Key "Nof_Wave_Numbers" bezeichnet die Anzahl der diskreten Wellenzahlen bzw. Frequenzen;
2. Key "Nof_Wave_Directions" bezeichnet die Anzahl der diskreten Wellenrichtungen;
3. Key "Lowest_Wave_Number" bezeichnet die kleinste Wellenzahl des diskreten Spektrums.
7. Block Output_Times_And_Timesteps enthält verschiedene Angaben zur Häufigkeit der Datenausgabe in verschiedenen BAW- und GKSS-spezifischen Formaten:
1. Key "Intrinsic_Data_Timestep" ist der Zeitschritt zur Ausgabe der Ergebnisse in GKSS-spezifischen Formaten; die Ergebnisse werden in den Dateien
1. MAPYYYYMMDDhhmmss (integrale Seegangsdaten) und
2. OUTYYYYMMDDhhmmss (spektrale Seegangsdaten)
abgelegt.
2. Key "Integrated_Data_Output" bezeichnet Anfangstermin, Endtermin sowie Zeitschritt zur Ausgabe der integralen Seegangsparameter in einem BAW-spezifischen Datenformat.
3. Key "Spectral_Data_Output" bezeichnet Anfangstermin, Endtermin sowie Zeitschritt zur Ausgabe der Seegangsspektren in einem BAW-spezifischen Datenformat.
8. Block Output_Files mit Namen und Typbezeichnungen der BAW-spezifischen Ergebnisdateien:
1. Key "Integrated_Data_File" bezeichnet den Dateinamen sowie den Dateityp (BDF) zur Aufnahme der integralen Seegangsparameter (Dateien des Typs dirz.bin.r, dirz.bin.i und dirz.bin).
2. Key "Spectral_Data_File" bezeichnet den Dateinamen sowie den Dateityp (NETCDF) zur Aufnahme der spektralen Seegangsdaten (Datei des Typs netcdf.cdf).
9. Block Output_Data zur Steuerung des Umfangs der Datenausgabe:
1. Key "Wave_Data" zum An- bzw. Abschalten der Ausgabe des Seegangs;
2. Key "Sea_Data" zum An- bzw. Abschalten der Ausgabe der Windsee;
3. Key "Swell_Data" zum An- bzw. Abschalten der Ausgabe der Dünung.
10. Block Open_Boundary_Data mit Hilfsinformationen zur Berechnung des Seegangs an offenen, durchströmten Modellrändern:
1. Key "Fetch_Length" mit Angaben zur richtungsabhängigen Fetchlänge (in km) mit der das Seegangsspektrum auf dem Rand berechnet werden soll.
11. Block Area_To_Be_Printed mit Angaben der in eine Druckerdatei zu schreibenden Ergebnisse für Teilgebiete:
1. Key "First_X": Koordinate für den linken Gebietsrand;
2. Key "Last_X": Koordinate für den rechten Gebietsrand;
3. Key "First_Y": Koordinate für den unteren Gebietsrand;
4. Key "Last_Y": Koordinate für den oberen Gebietsrand;
5. Key "X_Increment": Ausgabegitterweite in x-Richtung;
6. Key "Y_Increment": Ausgabegitterweite in y-Richtung.
12. (optional) Block Input_Files mit weiteren Eingabedateien:
1. (optional) Key "Specific_Locations" : Name einer Datei des Typs location.dat, mit Vereinbarung einer oder mehrerer Positionen zur Ausgabe der spektralen Seegangsdaten, wobei die Beschreibungen der Positionen in Dateien vom Typ geopos.dat vorhanden sein müssen;
2. (optional) Key "Alternative_Grid_File" : Name und Typ (GITTER05, UNTRIM_BAW) der Datei mit dem alternativen Berechnungsgitter (Datei des Typs untrim_grid.dat oder gitter.dat/bin), auf welchem die Berechnung des Seegangs, abweichend vom Gitter der vorfügbaren Wasserstands- und Strömungsdaten, durchgeführt werden soll.
Hinweise:
- Beim Lesen der Daten wird automatisch auch auf die Dictionary-Datei k_model_dico.dat in dem Verzeichnis $PROGHOME/dic/ zugegriffen.
Programme, welche diesen Datei-Typ benutzen
Beispiel-Datei
siehe $PROGHOME/examples/unk/k_model.dat
zurück zu: Dateikennblätter