Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

for chgres_cube - soil parameter references in program_setup.f90, turned on doxygen documentation for private functions #352

Merged
merged 10 commits into from
Feb 25, 2021
Next Next commit
turned on documentation of private functions
  • Loading branch information
edwardhartnett committed Feb 24, 2021
commit 9e0e80b88aef2d1bbd81dad47622c73302d6fa44
4 changes: 2 additions & 2 deletions docs/Doxyfile.in
Original file line number Diff line number Diff line change
Expand Up @@ -402,13 +402,13 @@ EXTRACT_ALL = NO
# be included in the documentation.
# The default value is: NO.

EXTRACT_PRIVATE = NO
EXTRACT_PRIVATE = YES

# If the EXTRACT_PACKAGE tag is set to YES all members with package or internal
# scope will be included in the documentation.
# The default value is: NO.

EXTRACT_PACKAGE = NO
EXTRACT_PACKAGE = YES

# If the EXTRACT_STATIC tag is set to YES all static members of a file will be
# included in the documentation.
Expand Down
25 changes: 22 additions & 3 deletions sorc/chgres_cube.fd/program_setup.f90
Original file line number Diff line number Diff line change
Expand Up @@ -588,9 +588,28 @@ subroutine calc_soil_params_driver(localpet)

end subroutine calc_soil_params_driver

!> Compute soil parameters. Will be used to rescale soil moisture
!! differences in soil type between the input grid and target
!! model grid.
!> Compute soil parameters. Will be used to rescale soil moisture
!! differences in soil type between the input grid and target model
!! grid.
!!
!! The calculations are those used in the Noah Land Surface Model. For
!! more information see (Implementation of Noah land surface model
!! advances in the National Centers for Environmental Prediction
!! operational mesoscale Eta
!! model)[https://doi.org/10.1029/2002JD003296].
!!
!! For more details about the soil parameters/properties see (Coupling
!! an Advanced Land Surface–Hydrology Model with the Penn State–NCAR
!! MM5 Modeling System. Part I: Model Implementation and Sensitivity)
!! [https://journals.ametsoc.org/view/journals/mwre/129/4/1520-0493_2001_129_0569_caalsh_2.0.co_2.xml].
!!
!! The original source for soil properties is here:
!!
!! Cosby, B. J., G. M. Hornberger, R. B. Clapp, and T. R. Ginn, 1984:
!! (A statistical exploration of the relationships of soil moisture
!! characteristics to the physical properties of
!! soils)[https://agupubs.onlinelibrary.wiley.com/doi/10.1029/WR020i006p00682]. Water
!! Resour. Res.,20, 682–690.
!!
!! @param [in] num_soil_cats number of soil type categories
!! @param [in] smlow reference parameter for wltsmc
Expand Down