-----------------------------------------------------------------
OSU 1-D PBL/LAND MODEL "OSU1DPBL"
-----------------------------------------------------------------
Greetings.  Thank you for your interest in the OSU atmospheric boundary-layer (ABL) model, which includes a coupled land-surface scheme.  Note that the coupled boundary-layer scheme plus land-surface scheme has also been called the 'CAPS' model, 'Coupled Atmospheric-boundary-layer - Plant - Soil' model, hence the file name 'caps104c.f'.

The land scheme is very similar to the old OSU land model that was in the GFS (prior to May 2005) and the CFSv1, also previously in MM5 and initially in WRF --ancestor of the Noah LSM.

The PBL scheme (in our form attached here, or similarly coded) is very similar to what was in the GFS (until a recent update with stable boundary layer using the MYJ/TKE scheme), and was previously in the NCAR climate model (originally Troen and Mahrt, Holtslag and Boville at NCAR, Hong and Pan in GFS), MM5, and now a WRF option.  The PBL scheme includes a simple cloud model (Ek and Mahrt 1991).  The radiation scheme is a simple model that calculates incoming solar and longwave at the surface, accounting for cloud cover.

-----------------------------------------------------------------
The OSU1DPBL code, ancillary files, and user guide are vailable from the NCEP/EMC ftp site:  ftp.emc.ncep.noaa.gov/mmb/gcp/ldas/noahlsm/OSU1DPBL.  There are 9 files:
  16jun.ctl
  OSU1DPBL-userguide.pdf
  README-OSU1DPBL.txt
  caps104c.f
  desert.ctl
  extract.ctl
  extract.f
  extract.txt
  print.f
-----------------------------------------------------------------
file name details

MODEL CODE:
1 --> caps104c.f Coupled Atmospheric boundary-layer-Plant-Soil ('CAPS') model written in FORTRAN (F77); generates binary output files

OSU1DPBL MODEL USER GUIDE:
2 --> OSU1DPBL-userguide.pdf (29MB) - it's from 1991, but much of what it says still applies.

3 --> README-OSU1DPBL.txt - this information/file.

OSU1DPBL INPUT FILE:
4 --> 16jun.ctl sample input (control) file necessary to initialize the model (data from HAPEX-MOBILHY 16 June 1986, southwest France).
5 --> desert.ctl additional sample input (control) file

OSU1DPBL EXTRACTION PROGRAM:
6 --> extract.f allows extraction of specific data from binary output (output is tab-delimited ascii text files).
7 --> extract.ctl control file w/parameters to extract
8 --> extract.txt documentation file describes extract.ctl

OSU1DPBL PRINT PROGRAM:
9 --> print.f converts binary output to ascii, only if you want all output the model generates; generally use extract.f
-----------------------------------------------------------------
PROCEDURE:

Compile and run the model (e.g. caps104c.x), specifying the input control file (e.g.16jun.ctl), and binary output file (e.g. 16jun.bin).

Run extract, specifying the input control file (e.g. extract.ctl), and binary output file (e.g. 16jun.bin) which is used as input.

Three output files will be generated, i.e. 16jun.prof, 16jun.proftime, 16jun.time.

Compile and run print (e.g. print.x), specifying the binary output file (e.g. 16jun.bin) and ascii text output file (e.g. 16jun.out)... only if you want all output the model generates.

Generally I run the model and then extract whatever I am interested in examining (only a subset of all the output that's available), e.g. potential temperature and specific humidity profiles at various model times (e.g. 16jun.prof), times series of surface fluxes every model output hour (e.g. 16jun.time), timeseries of temperature some level in the atmosphere, e.g. at 20 m (e.g. 16jun.proftime), etc.
------------------------------------------------
end of message