Readme file for STILT/WRF interface tar ball, for version v3.9 and later of the WRF model. 1. Codes assembled here are to enable use of the WRF-STILT interface as described in Nehrkorn, T., J. Eluszkiewicz, S. C. Wofsy, J. C. Lin, C. Gerbig, M. Longo, and S. Freitas, 2010: Coupled weather research and forecasting - stochastic time-inverted lagrangian transport ({WRF-STILT}) model. Meteor. Atmos. Phys., 107 (1), 51-64, doi:10.1007/s00703-010-0068-x. 2. For information on STILT (including fair-use policy) refer to: http://www.bgc-jena.mpg.de/bgc-systems/projects/stilt/pmwiki/pmwiki.php For a discussion of how to choose parameters related to the computation of boundary layer height within STILT, refer to file: NWP/p1229/doc/pblh-instructions.txt. 3. For information on WRF (including copyright notices), refer to: http://www.mmm.ucar.edu/wrf/users/ For WRF versions prior to WRF v3.3: Release 3-2-1 of the WRF-STILT interface contains additional files: As of version 3.2.1, there is a known bug in dyn_em/start_em.F (a missing initialization line for variable f_flux). Subdirectory NWP/WRFV3/dyn_em contains a corrected version of this routine, for version 3.2.1 of WRF. This bug was fixed as of Release 3.3, and this file is no longer needed. The WRF-STILT tar file (version Release 3-4 and later) no longer contain these files. For WRF version 3.8.1 and 3.9.1.1: The tar file includes files in NWP/wrfv3_files for a version of the Grell-Freitas (G-F) cumulus parameterization that outputs convective fluxes for inclusion in the ARL files (as previously only available for the now deprecated Grell-Devenyi, G-D, scheme). This is only available for v381 of the G-F scheme, and files are available to patch this version into both the v381 and v3911 version of WRF. The wrf-patch.in* files provide a mapping of the local filenames to their location in an installed WRFV3 directory tree (including Registry files with the appropriate modifications for the avgflx variables). For WRF version 3.9.1.1: This Release supports WRF output files generated with the hybrid vertical coordinate. The ARL files generated by wrfnc2arl will have the model id 9WRF/NWRF (instead of AWRF/DWRF) for 8-bit/16-bit files if the model was run with hyb_opt=2. The convertor will automatically override the specified (via the -M option) model id from AWRF/DWRF to 9WRF/NWRF as needed. 4. For compiling and running the wrf netcdf to arl converter, see NWP/arl-format/Readme.txt. A note on organizing the ARL format WRF output: For typical WRF-STILT implementations, the output of the converter is organized into separate directories according to the valid time of the forecast files: for example, directory 20081123 would contain converted wrfout files, for all domains (dnn, as in d01, d02, d03, ...) valid from times past 06 UTC 23 Nov 2008 through 06 UTC 24 Nov 2008. These files are then concatenated into correspondingly named files (e.g., d01.20081123.arl, d02.20081123.arl, ...) using the script: NWP/p1564/bin/concat_arl.csh. The sample code in the Readme file, and the concat_arl.csh script, assume that separate times are written to separate netcdf wrfout files. Netcdf files with multiple output times require an additional command-line argument to the wrfnc2arl program. A note MUU/MUV staggering: Starting with WRF version 3.4, the MUU/MUV are stored on staggered grids, and the var_sample files (in NWP/arl-format/data2arl/wrfnc2arl) reflect that. For output from earlier versions of WRF, edit the MUU/MUV entries in var_sample (or obtain an earlier version of that file from WRF-STILT-Release-3-2-1.tar.gz). A note on inclusion of TKE: The default var_sample file (in NWP/arl-format/data2arl/wrfnc2arl) does not process TKE, and is thus suitable for WRF runs using PBL schemes that do not output TKE. Depending on the WRF version and the PBL scheme used, the PBL TKE may have different names, e.g. TKE_MYJ (MYJ scheme, WRF versions 3.x), or TKE_PBL (WRF version 3.4). To accomodate these possibilities, separate var_sample files are included: var_sample_notke, var_sample_tkemyj, var_sample_tkepbl. As of version 3.5, TKE is vertically staggered, requiring the corresponding entry in the var_sample_file: var_sample_tkepbl_v35 Before running the wrfnc2arl converter, make sure to copy the appropriate one of these to the generic (var_sample) file. AER version control information: NWP/StiltCode: RunStiltv2_6e NWP/StiltScripts: RunStiltv2_6 NWP/arl-format: RunStiltv2_6a