$ -------------------------------------------------------------------- $ $ WAVEWATCH III shell input file $ $ -------------------------------------------------------------------- $ $ Define input to be used with flag for use and flag for definition $ as a homogeneous field (first three only); eight input lines. $ F F Water levels T F Currents T F Winds F Ice concentrations F Assimilation data : Mean parameters F Assimilation data : 1-D spectra F Assimilation data : 2-D spectra. $ $ Time frame of calculations ----------------------------------------- $ $ - Starting time in yyyymmdd hhmmss format. $ - Ending time in yyyymmdd hhmmss format. $ $ $ Define output data ------------------------------------------------- $ $ $ Define output server mode. This is used only in the parallel version $ of the model. To keep the input file consistent, it is always needed. $ IOSTYP = 1 is generally recommended. IOSTYP > 2 may be more efficient $ for massively parallel computations. Only IOSTYP = 0 requires a true $ parallel file system like GPFS. $ $ IOSTYP = 0 : No data server processes, direct access output from $ each process (requirese true parallel file system). $ 1 : No data server process. All output for each type $ performed by process that performes computations too. $ 2 : Last process is reserved for all output, and does no $ computing. $ 3 : Multiple dedicated output processes. $ 1 $ $ Five output types are available (see below). All output types share $ a similar format for the first input line: $ - first time in yyyymmdd hhmmss format, output interval (s), and $ last time in yyyymmdd hhmmss format (all integers). $ Output is disabled by setting the output interval to 0. $ $ ------------------------------------------------------------------- $ $ $ Type 1 : Fields of mean wave parameters $ Standard line and line with logical flags to activate output $ fields as defined in section 2.4 of the manual. The logical $ flags are not supplied if no output is requested. The logical $ flags can be placed on multiple consecutive lines. However, $ the total number and order of the logical flags is fixed. $ The raw data file is out_grd.ww3, $ see w3iogo.ftn for additional doc. $ $---------------------------------------------------------------- $ Output request flags identifying fields. $ $ The table below provides a full definition of field output parameters $ as well as flags indicating if they are available in different field $ output output file types (ASCII, grib, NetCDF). $ Further definitions are found in section 2.4 of the manual. $ $ Selection of field outputs may be made in two ways: $ F/T flags: first flag is set to F, requests made per group (1st line) $ followed by parameter flags (total of 10 groups). $ Namelists: first line is set to N, next line contains parameter $ symbol as per table below. $ $ Example of F/T flag use is given in this sample ww3_shel.inp, below. $ For namelist usage, see the sample ww3_ounf.inp for an example. $ $ ---------------------------------------- $ Output field parameter definitions table $ ---------------------------------------- $ $ All parameters listed below are available in output file of the types $ ASCII and NetCDF. If selected output file types are grads or grib, $ some parameters may not be available. The first two columns in the $ table below identify such cases by flags, cols 1 (GRB) and 2 (GXO) $ refer to grib (ww3_grib) and grads (gx_outf), respectively. $ $ Columns 3 and 4 provide group and parameter numbers per group. $ Columns 5, 6 and 7 provide: $ 5 - code name (internal) $ 6 - output tags (names used is ASCII file extensions, NetCDF $ variable names and namelist-based selection (see ww3_ounf.inp) $ 7 - Long parameter name/definition $ $ G G $ R X Grp Param Code Output Parameter/Group $ B O Numb Numbr Name Tag Definition $ -------------------------------------------------- $ 1 Forcing Fields $ ------------------------------------------------- $ T T 1 1 DW DPT Water depth. $ T T 1 2 C[X,Y] CUR Current velocity. $ T T 1 3 UA WND Wind speed. $ T T 1 4 AS AST Air-sea temperature difference. $ T T 1 5 WLV WLV Water levels. $ T T 1 6 ICE ICE Ice concentration. $ T T 1 7 IBG IBG Iceberg-induced damping $ T T 1 8 D50 D50 Median sediment grain size $ ------------------------------------------------- $ 2 Standard mean wave Parameters $ ------------------------------------------------- $ T T 2 1 HS HS Wave height. $ T T 2 2 WLM LM Mean wave length. $ T T 2 3 T02 T02 Mean wave period (Tm02). $ T T 2 4 T0M1 T0M1 Mean wave period (Tm0,-1). $ T T 2 5 T01 T01 Mean wave period (Tm01). $ T T 2 6 FP0 FP Peak frequency. $ T T 2 7 THM DIR Mean wave direction. $ T T 2 8 THS SPR Mean directional spread. $ T T 2 9 THP0 DP Peak direction. $ T T 2 10 HIG HIG Infragravity height $ ------------------------------------------------- $ 3 Spectral Parameters (first 5) $ ------------------------------------------------- $ F F 3 1 Ef EF Wave frequency spectrum $ F F 3 2 th1m TH1M Mean wave direction from a1,b2 $ F F 3 3 sth1m STH1M Directional spreading from a1,b2 $ F F 3 4 th2m Mean wave direction from a2,b2 $ F F 3 5 sth2m Directional spreading from a2,b2 $ F F 3 6 WN WN Wavenumber array $ ------------------------------------------------- $ 4 Spectral Partition Parameters $ ------------------------------------------------- $ T T 4 1 PHS PHS Partitioned wave heights. $ T T 4 2 PTP PTP Partitioned peak period. $ T T 4 3 PLP PLP Partitioned peak wave length. $ T T 4 4 PDIR PDIR Partitioned mean direction. $ T T 4 5 PSI PSPR Partitioned mean directional spread. $ T T 4 6 PWS PWS Partitionned wind sea fraction. $ T T 4 7 PWST TWS Total wind sea fraction. $ T T 4 8 PNR PNR Number of partitions. $ ------------------------------------------------- $ 5 Atmosphere-waves layer $ ------------------------------------------------- $ T T 5 1 UST UST Friction velocity. $ F T 5 2 CHARN CHA Charnock parameter $ F T 5 3 CGE CGE Energy flux $ F T 5 4 PHIAW FAW Air-sea energy flux $ F T 5 5 TAUWI[X,Y] TAW Net wave-supported stress $ F T 5 6 TAUWN[X,Y] TWA Negative part of the wave-supported stress $ F F 5 7 WHITECAP WCC Whitecap coverage $ F F 5 8 WHITECAP WCF Whitecap thickness $ F F 5 9 WHITECAP WCH Mean breaking height $ F F 5 10 WHITECAP WCM Whitecap moment $ ------------------------------------------------- $ 6 Wave-ocean layer $ ------------------------------------------------- $ F F 6 1 S[XX,YY,XY] SXY Radiation stresses. $ F F 6 2 TAUO[X,Y] TWO Wave to ocean momentum flux $ F F 6 3 BHD BHD Bernoulli head (J term) $ F F 6 4 PHIOC FOC Wave to ocean energy flux $ F F 6 5 TUS[X,Y] TUS Stokes transport $ F F 6 6 USS[X,Y] USS Surface Stokes drift $ F F 6 7 [PR,TP]MS P2S Second-order sum pressure $ F F 6 8 US3D USF Spectrum of surface Stokes drift $ F F 6 9 P2SMS P2L Micro seism source term $ ------------------------------------------------- $ 7 Wave-bottom layer $ ------------------------------------------------- $ F F 7 1 ABA ABR Near bottom rms amplitides. $ F F 7 2 UBA UBR Near bottom rms velocities. $ F F 7 3 BEDFORMS BED Bedforms $ F F 7 4 PHIBBL FBB Energy flux due to bottom friction $ F F 7 5 TAUBBL TBB Momentum flux due to bottom friction $ ------------------------------------------------- $ 8 Spectrum parameters $ ------------------------------------------------- $ F F 8 1 MSS[X,Y] MSS Mean square slopes $ F F 8 2 MSC[X,Y] MSC Spectral level at high frequency tail $ ------------------------------------------------- $ 9 Numerical diagnostics $ ------------------------------------------------- $ T T 9 1 DTDYN DTD Average time step in integration. $ T T 9 2 FCUT FC Cut-off frequency. $ T T 9 3 CFLXYMAX CFX Max. CFL number for spatial advection. $ T T 9 4 CFLTHMAX CFD Max. CFL number for theta-advection. $ F F 9 5 CFLKMAX CFK Max. CFL number for k-advection. $ ------------------------------------------------- $ 10 User defined $ ------------------------------------------------- $ F F 10 1 U1 User defined #1. (requires coding ...) $ F F 10 2 U2 User defined #1. (requires coding ...) $ ------------------------------------------------- $ $ Section 4 consist of a set of fields, index 0 = wind sea, index $ 1:NOSWLL are first NOSWLL swell fields. $ $ Actual active parameter selection section $ $ (1) Forcing Fields T $ DPT CUR WND AST WLV ICE IBG D50 F F T F F F F F $ (2) Standard mean wave Parameters T $ HS LM T02 T0M1 T01 FP DIR SPR DP T T F F T T T F T $ (3) Frequency-dependent parameters F $ EF TH1M STH1M TH2M STH2M WN $ T T T F F F $ (4) Spectral Partition Parameters T $ PHS PTP PLP PDIR PSPR PWS TWS PNR T T T T F F F F $ (5) Atmosphere-waves layer F $ UST CHA CGE FAW TAW TWA WCC WCF WCH WCM $ T T T T T T T T T T $ (6) Wave-Ocean layer F $ SXY TWO BHD FOC TUS USS P2S USF P2L $ T T T T T T T F F F $ (7) Wave-bottom layer F $ ABR UBR BED FBB TBB $ T T T T T $ (8) Spectrum parameters F $ MSS MSC $ T T $ (9) Numerical diagnostics F $ DTD FC CFX CFD CFK $ T T T T T $ (10) User defined (NOEXTR flags needed) F $ T T T T T T T T T T T $ U1 U2 $ T T F F F F F F F F F F F F $ $---------------------------------------------------------------- $ $ Type 2 : Point output $ Standard line and a number of lines identifying the $ longitude, latitude and name (C*10) of output points. $ The list is closed by defining a point with the name $ 'STOPSTRING'. No point info read if no point output is $ requested (i.e., no 'STOPSTRING' needed). $ Example for spherical grid. $ The raw data file is out_pnt.ww3, $ see w3iogo.ftn for additional doc. $ $ NOTE : Spaces may be included in the name, but this is not $ advised, because it will break the GrADS utility to $ plots spectra and source terms, and will make it more $ diffucult to use point names in data files. $ $ $ -0.25 -0.25 'Land ' $ 0.0 0.0 'Point_1 ' $ 2.0 1.0 'Point_2 ' $ 1.8 2.2 'Point_3 ' $ 2.1 0.9 'Point_4 ' $ 5.0 5.0 'Outside ' $ $ 0.0 0.0 'STOPSTRING' $ $ Type 3 : Output along track. $ Flag for formatted input file. $ The data files are track_i.ww3 and $ track_o.ww3, see w3iotr.ftn for ad. doc. $ 0 $ T $ $ Type 4 : Restart files (no additional data required). $ The data file is restartN.ww3, see $ w3iors.ftn for additional doc. $ $ $ Type 5 : Boundary data (no additional data required). $ The data file is nestN.ww3, see $ w3iobcmd.ftn for additional doc. $ 0 $ $ Type 6 : Separated wave field data (dummy for now). $ First, last step IX and IY, flag for formatted file $ 0 0 999 1 0 999 1 T $ $ Homogeneous field data --------------------------------------------- $ $ Homogeneous fields can be defined by a list of lines containing an ID $ string 'LEV' 'CUR' 'WND', date and time information (yyyymmdd $ hhmmss), value (S.I. units), direction (current and wind, oceanogr. $ convention degrees)) and air-sea temparature difference (degrees C). $ 'STP' is mandatory stop string. $ Also defined here are the speed with which the grid is moved $ continuously, ID string 'MOV', parameters as for 'CUR'. $ $ 'LEV' 19680606 010000 1.00 $ 'CUR' 19680606 073125 2.0 25. $ 'WND' 19680606 000000 20. 145. 2.0 $ 'MOV' 19680606 013000 4.0 25. 'STP' $ $ -------------------------------------------------------------------- $ $ End of input file $ $ -------------------------------------------------------------------- $