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

Add explanation of Soil_Inertia1.m #224

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 16 additions & 16 deletions src/+equations/Soil_Inertia1.m
Original file line number Diff line number Diff line change
@@ -1,34 +1,34 @@
function [GAM] = Soil_Inertia1(SMC, theta_s0)
% soil inertia method by Murray and Verhoef (
% soil inertia method by Murray and Verhoef (2007), and the soil inertial (GAM) is used to calculate the soil heat flux
Copy link
Contributor

@Crystal-szj Crystal-szj Mar 25, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
% soil inertia method by Murray and Verhoef (2007), and the soil inertial (GAM) is used to calculate the soil heat flux
% soil inertia method by Murray and Verhoef (2007), and the soil inertial (GAM) is used to calculate the soil heat flux
% Input:
% SMC : soil moisture (m3 m-3)
% theta_s0 : saturated soil moisture (m3 m-3)
% Output:
% GAM : soil inertia (J m-2 K-1 s-0.5)
% Reference:
% Murray, T., Verhoef, A., 2007. Moving towards a more mechanistic approach in the determination of soil heat
% flux from remote measurements: I. A universal approach to calculate thermal inertia. Agricultural and Forest
% Meteorology 147, 80-87.


% % parameters

theta_s = theta_s0; % (saturated water content, m3/m3)
Sr = SMC / theta_s;

% fss = 0.58; %(sand fraction)
gamma_s = 0.27; % (soil texture dependent parameter)
dels = 1.33; % (shape parameter)
% fss = 0.58; % (sand fraction)
gamma_s = 0.27; % (soil texture dependent parameter; if fss>0.4, gamma_s=0.96 while fss=<0.4, gamma_s=0.27)
dels = 1.33; % (shape parameter, constant)

ke = exp(gamma_s * (1 - power(Sr, gamma_s - dels)));
ke = exp(gamma_s * (1 - power(Sr, gamma_s - dels))); % (Kersten number, Eq.(15))

phis = theta_s0; % (phis == theta_s)
lambda_d = -0.56 * phis + 0.51;
phis = theta_s0; % (porosity, phis=theta_s=theta_s0)
lambda_d = -0.56 * phis + 0.51; % (thermal conductivity for air-dry soil, Eq.(16))

QC = 0.20; % (quartz content)
lambda_qc = 7.7; % (thermal conductivity of quartz, constant)
QC = 0.20; % (quartz content, approximate to fss if no measured QC)
lambda_qc = 7.7; % (thermal conductivity of quartz, W/m.K, constant)

lambda_s = (lambda_qc^(QC)) * lambda_d^(1 - QC);
lambda_s = (lambda_qc^(QC)) * lambda_d^(1 - QC); % (thermal conductivity of the soil solids, Eq.(18))
lambda_wtr = 0.57; % (thermal conductivity of water, W/m.K, constant)

lambda_w = (lambda_s^(1 - phis)) * lambda_wtr^(phis);
lambda_w = (lambda_s^(1 - phis)) * lambda_wtr^(phis); % (thermal conductivity for saturated soil, Eq.(17))

lambdas = ke * (lambda_w - lambda_d) + lambda_d;
lambdas = ke * (lambda_w - lambda_d) + lambda_d; % Eq.(14)

Hcs = 2.0 * 10^6;
Hcw = 4.2 * 10^6;
Hcs = 2.0 * 10^6; % (heat capacity of solid soil minerals, J/m3.K)
Hcw = 4.2 * 10^6; % (heat capacity of water, J/m3.K)

Hc = (Hcw * SMC) + (1 - theta_s) * Hcs;
Hc = (Hcw * SMC) + (1 - theta_s) * Hcs; % Eq.(13)

GAM = sqrt(lambdas .* Hc);
GAM = sqrt(lambdas .* Hc); % Eq.(10)
end
Loading