This tar file contains the Spherical Harmonic Discrete Ordinate Method
(SHDOM) radiative transfer model written by Frank Evans at the
University of Colorado.  This model computes polarized monochromatic or
spectral band radiative transfer in a one, two, or three-dimensional
medium for either collimated solar and/or thermal emission sources of
radiation.  The model is written in a variant of Fortran 77 and in
Fortran90, and it requires a Fortran 90 compiler.  The distribution also
contains Fortran 90 programs for generating the optical property files
input to SHDOM from physical properties of water cloud particles
and aerosols.  

This is a preliminary beta distribution because more testing is needed
of polarized SHDOM, though first order testing has been done.  The
distribution is available from http://nit.colorado.edu.  This Web site
also contains results of validation testing, examples useful for
learning how to run the model, and a PDF version of journal articles.

The new polarized distribution does not contain make_ice_table.f90
because the Ping Yang ice scattering database it used was not polarized
and was obsolete (2000).  The broadband k-distribution programs
(ckdfu.f, ckdswrrtm.f, ckdlwrrtm.f) were also dropped because Monte
Carlo methods are much more efficient for broadband flux and heating
rate calculations.  These codes (and cloudprp.f and old scripts) are
still available in the last distribution of unpolarized SHDOM 
(shdom_unpol.tar.gz).


The following is a list of the files:

 README             this file

 shdom.txt          documentation file for SHDOM
 shdom.f90          main program
 shdomsub1.f        subroutines used during solution procedure
 shdomsub2.f        subroutines used before or after solution procedure
 shdomsub3.f        input/output subroutines 
 shdom_mpi.f90      subroutines that make MPI calls
 shdom_nompi.f      dummy routines for not using MPI
 shdom_netcdf.f90   subroutines that make netcdf calls
 shdom_nonetcdf.f90 dummy routines for not using netcdf
 fftpack.f          Fast Fourier Transform routines
 ocean_brdf.f       scalar ocean surface reflectance routines

 propgen.txt        documentation for the optical property generation system
 make_mie_table.f90 makes scattering table for spherical particles
 miewig.f           subroutines for Mie scattering
 indexwatice.f      water/ice refractive index routines
 make_tmatrix_table.f90   makes scattering table for spheroids and cylinder
 tmatrixwig.f       subroutines for T-matrix calculations
 lpd.f              matrix solver routines for T-matrix routines
 tmd.par.f          array size parameter file for T-matrix routines
 plotscattab.f90    makes phase functions versus angle from scattering tables
 propgen.f90        makes SHDOM property file from particle properties file
 AsciiPropertyFileToNetcdf.f90

 makefile           Unix makefile for compiling shdom and companion programs

 run_mono_les       script to do monochromatic solar or thermal RT in a cloud
 run_brdf           script demonstrating five surface reflection models
 run_polarized      script to make scattering tables, property file, and
                      run polarized SHDOM for cloud and dust aerosol
 run_visualize      script demonstrating SHDOM visualization image output
 run_multproc       script demonstrating SHDOM with multiple processors on SMP
 put.c              small C program for scripts

 lesw16.nml          example namelist input file
 les2y21.lwc         LWC file for propgen (2D slice of LES field)
 les_stcu.lwc        LWC file for propgen (full LES field) for run_visualize
 era0621nh12_t21.lwc LWC file (large grid sparse cumulus LES field)
 aero0822nh15c_t13_iy249.lwc  LWC file for polarization example script

 idl/           directory of IDL files for reading and visualizing SHDOM files
                   See shdom1dplots.pro, shdom2dplots.pro, 
                      plot_brdf.pro, and plot_polarized.pro

 Updatelist.txt  list of distribution dates with bug fixes and updates made

Comments, bug reports, and suggestions are welcome.  

    Frank Evans           March 7, 2014
    Dept. of Atmospheric and Oceanic Sciences
    University of Colorado, Boulder 80309-0311
    evans@nit.colorado.edu     (719) 580-5003