crop_irradiance.uniform_crops.formalisms package
Submodules
crop_irradiance.uniform_crops.formalisms.config module
crop_irradiance.uniform_crops.formalisms.lumped_leaves module
- crop_irradiance.uniform_crops.formalisms.lumped_leaves.calc_absorbed_diffuse_irradiance(incident_diffuse_irradiance: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, diffuse_extinction_coefficient: float, canopy_reflectance_to_diffuse_irradiance: float) float[source]
Calculates the absorbed diffuse irradiance by a leaf layer per unit ground area.
- Parameters:
incident_diffuse_irradiance – [W m-2ground] incident diffuse irradiance at the top of the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
diffuse_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of diffuse irradiance
canopy_reflectance_to_diffuse_irradiance – [-] canopy reflectance to diffuse irradiance for the given irradiance band
- Returns:
[W m-2ground] the absorbed diffuse irradiance by a leaf layer per unit ground area
- crop_irradiance.uniform_crops.formalisms.lumped_leaves.calc_absorbed_direct_irradiance(incident_direct_irradiance: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, direct_extinction_coefficient: float, canopy_reflectance_to_direct_irradiance: float) float[source]
Calculates the absorbed direct irradiance by a leaf layer per unit ground area.
- Parameters:
incident_direct_irradiance – [W m-2ground] incident direct (beam) irradiance at the top of the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
direct_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance
canopy_reflectance_to_direct_irradiance – [-] canopy reflectance to direct (beam) irradiance
- Returns:
[W m-2ground] the absorbed direct irradiance by a leaf layer per unit ground area
- crop_irradiance.uniform_crops.formalisms.lumped_leaves.calc_beer_absorption(incident_irradiance: float, extinction_coefficient: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float) float[source]
Calculates irradiance absorption by a uniform leaf layer following Beer-Lambert’s law.
- Parameters:
incident_irradiance – [W m-2ground] incident irradiance at the upper side of the leaf layer
extinction_coefficient – [m2groud m-2leaf] extinction coefficient of the incident irradiance through the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
- Returns:
[W m-2ground] absorbed irradiance per unit ground area
- Notes
- The unit of the incident irradiance given above may be set differently by the user (e.g. J cm-2ground), in
which case the absorbed irradiance will have the same unit (e.g. J cm-2ground)
- crop_irradiance.uniform_crops.formalisms.lumped_leaves.calc_de_pury_absorption(incident_direct_irradiance: float, incident_diffuse_irradiance: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, direct_extinction_coefficient: float, diffuse_extinction_coefficient: float, canopy_reflectance_to_direct_irradiance: float, canopy_reflectance_to_diffuse_irradiance: float) float[source]
Calculates the absorbed direct and diffuse irradiance by a leaf layer per unit ground area.
- Parameters:
incident_direct_irradiance – [W m-2ground] incident direct (beam) irradiance at the top of the canopy
incident_diffuse_irradiance – [W m-2ground] incident diffuse irradiance at the top of the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
direct_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance
diffuse_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of diffuse irradiance
canopy_reflectance_to_direct_irradiance – [-] canopy reflectance to direct (beam) irradiance
canopy_reflectance_to_diffuse_irradiance – [-] canopy reflectance to diffuse irradiance for the given irradiance band
- Returns:
the absorbed direct and diffuse irradiance by a leaf layer per unit ground area
- Return type:
[W m-2ground]
crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves module
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.absorbed_irradiance_by_shaded_leaf_layer(incident_direct_irradiance: float, incident_diffuse_irradiance: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, leaf_scattering_coefficient: float, canopy_reflectance_to_direct_irradiance: float, canopy_reflectance_to_diffuse_irradiance: float, direct_extinction_coefficient: float, direct_black_extinction_coefficient: float, diffuse_extinction_coefficient: float) float[source]
Calculates the absorbed irradiance by shaded leaves of a leaf layer per unit ground area.
- Parameters:
incident_direct_irradiance – [W m-2ground] incident direct (beam) irradiance at the top of the canopy
incident_diffuse_irradiance – [W m-2ground] incident diffuse irradiance at the top of the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
leaf_scattering_coefficient – [-] leaf scattering coefficient
canopy_reflectance_to_direct_irradiance – [-] canopy reflectance to direct (beam) irradiance
canopy_reflectance_to_diffuse_irradiance – [-] canopy reflectance to diffuse irradiance
direct_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
diffuse_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of diffuse irradiance
- Returns:
[W m-2ground] the absorbed irradiance by shaded leaves of a leaf layer per unit ground area
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.absorbed_irradiance_by_sunlit_and_shaded_leaves_per_leaf_layer(incident_direct_irradiance: float, incident_diffuse_irradiance: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, leaf_scattering_coefficient: float, canopy_reflectance_to_direct_irradiance: float, canopy_reflectance_to_diffuse_irradiance: float, direct_extinction_coefficient: float, direct_black_extinction_coefficient: float, diffuse_extinction_coefficient: float) dict[source]
Calculates the absorbed irradiance by sunlit and shaded leaves of a leaf layer per unit ground area.
- Parameters:
incident_direct_irradiance – [W m-2ground] incident direct (beam) irradiance at the top of the canopy
incident_diffuse_irradiance – [W m-2ground] incident diffuse irradiance at the top of the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
leaf_scattering_coefficient – [-] leaf scattering coefficient
canopy_reflectance_to_direct_irradiance – [-] canopy reflectance to direct (beam) irradiance
canopy_reflectance_to_diffuse_irradiance – [-] canopy reflectance to diffuse irradiance
direct_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
diffuse_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of diffuse irradiance
- Returns:
- [W m-2ground] the absorbed irradiance by sunlit and shaded leaves of a leaf layer per unit ground area, where
leaves categories (‘sunlit’, ‘shaded’) are returned as dictionary keys
References
- Goudriaan J. (1988)
The bare bones of leaf-angle distribution in radiation models for canopy photosynthesis and energy exchange. Agricultural and Forest Meteorology 43, 155 - 169.
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.absorbed_irradiance_by_sunlit_leaf_layer(incident_direct_irradiance: float, incident_diffuse_irradiance: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, leaf_scattering_coefficient: float, canopy_reflectance_to_direct_irradiance: float, canopy_reflectance_to_diffuse_irradiance: float, direct_extinction_coefficient: float, direct_black_extinction_coefficient: float, diffuse_extinction_coefficient: float)[source]
Calculates the absorbed irradiance by sunlit leaves of a leaf layer per unit ground area.
- Parameters:
incident_direct_irradiance – [W m-2ground] incident direct (beam) irradiance at the top of the canopy
incident_diffuse_irradiance – [W m-2ground] incident diffuse irradiance at the top of the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
leaf_scattering_coefficient – [-] leaf scattering coefficient
canopy_reflectance_to_direct_irradiance – [-] canopy reflectance to direct (beam) irradiance
canopy_reflectance_to_diffuse_irradiance – [-] canopy reflectance to diffuse irradiance
direct_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
diffuse_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of diffuse irradiance
- Returns:
[W m-2ground] the absorbed irradiance by sunlit leaves of a leaf layer per unit ground area
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_absorbed_diffuse_irradiance_at_given_depth(incident_diffuse_irradiance: float, cumulative_leaf_area_index: float, canopy_reflectance_to_diffuse_irradiance: float, diffuse_extinction_coefficient: float) float[source]
Calculates the absorbed diffuse irradiance per unit leaf area at a given depth inside the canopy.
- Parameters:
incident_diffuse_irradiance – [W m-2ground] incident diffuse irradiance at the top of the canopy
cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index
canopy_reflectance_to_diffuse_irradiance – [-] canopy reflectance to diffuse irradiance for the given irradiance band
diffuse_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of diffuse irradiance
- Returns:
[W m-2leaf] the absorbed diffuse irradiance per unit leaf area at the given depth inside the canopy
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_absorbed_diffuse_irradiance_by_shaded_leaf_layer(incident_diffuse_irradiance: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, canopy_reflectance_to_diffuse_irradiance: float, direct_black_extinction_coefficient: float, diffuse_extinction_coefficient: float) float[source]
Calculates the absorbed diffuse irradiance by a leaf layer per unit ground area.
- Parameters:
incident_diffuse_irradiance – [W m-2ground] incident diffuse irradiance at the top of the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
canopy_reflectance_to_diffuse_irradiance – [-] canopy reflectance to diffuse irradiance for the given irradiance band
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
diffuse_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of diffuse irradiance
- Returns:
[W m-2ground] the absorbed diffuse irradiance by a shaded leaf layer per unit ground area
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_absorbed_diffuse_irradiance_by_sunlit_leaf_layer(incident_diffuse_irradiance: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, canopy_reflectance_to_diffuse_irradiance: float, direct_black_extinction_coefficient: float, diffuse_extinction_coefficient: float) float[source]
Calculates the absorbed diffuse irradiance by a leaf layer per unit ground area.
- Parameters:
incident_diffuse_irradiance – [W m-2ground] incident diffuse irradiance at the top of the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
canopy_reflectance_to_diffuse_irradiance – [-] canopy reflectance to diffuse irradiance for the given irradiance band
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
diffuse_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of diffuse irradiance
- Returns:
[W m-2ground] the absorbed diffuse irradiance by a sunlit leaf layer per unit ground area
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_absorbed_direct_irradiance(incident_direct_irradiance: float, leaf_scattering_coefficient: float, direct_black_extinction_coefficient: float) float[source]
Calculates the absorbed direct (beam) irradiance per unit leaf area (depth-independent).
- Parameters:
incident_direct_irradiance – [W m-2ground] incident direct (beam) irradiance at the top of the canopy
leaf_scattering_coefficient – [-] leaf scattering coefficient
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
- Returns:
[W m-2leaf] the absorbed direct (beam) irradiance per unit leaf area (depth-independent)
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_absorbed_direct_irradiance_by_sunlit_leaf_layer(incident_direct_irradiance: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, leaf_scattering_coefficient: float, direct_black_extinction_coefficient: float) float[source]
Calculates the absorbed direct irradiance by a leaf layer per unit ground area.
- Parameters:
incident_direct_irradiance – [W m-2ground] incident direct (beam) irradiance at the top of the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
leaf_scattering_coefficient – [-] leaf scattering coefficient
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
- Returns:
[W m-2ground] the absorbed direct irradiance by a sunlit leaf layer per unit ground area
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_absorbed_scattered_irradiance_at_given_depth(incident_direct_irradiance: float, cumulative_leaf_area_index: float, direct_extinction_coefficient: float, direct_black_extinction_coefficient: float, canopy_reflectance_to_direct_irradiance: float, leaf_scattering_coefficient: float) float[source]
Calculates the absorbed scattered irradiance per unit leaf area at a given depth inside the canopy.
- Parameters:
incident_direct_irradiance – [W m-2ground] incident direct (beam) irradiance at the top of the canopy
cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index
direct_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
canopy_reflectance_to_direct_irradiance – [-] canopy reflectance to direct (beam) irradiance
leaf_scattering_coefficient – [-] leaf scattering coefficient
- Returns:
[W m-2leaf] the absorbed diffuse irradiance per unit leaf area at the given depth inside the canopy
Notes
- This function is not used directly in crop_irradiance package. It was implemented so that it could be used by
dependent packages (see crop_energy_balance from https://github.com/RamiALBASHA/crop_energy_balance)
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_absorbed_scattered_irradiance_by_shaded_leaf_layer(incident_direct_irradiance: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, direct_extinction_coefficient: float, direct_black_extinction_coefficient: float, canopy_reflectance_to_direct_irradiance: float, leaf_scattering_coefficient: float) float[source]
Calculates the absorbed scattered irradiance by a leaf layer per unit ground area.
- Parameters:
incident_direct_irradiance – [W m-2ground] incident direct (beam) irradiance at the top of the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
direct_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
canopy_reflectance_to_direct_irradiance – [-] canopy reflectance to direct (beam) irradiance
leaf_scattering_coefficient – [-] leaf scattering coefficient
- Returns:
[W m-2ground] the absorbed scattered irradiance by a sunlit leaf layer per unit ground area
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_absorbed_scattered_irradiance_by_sunlit_leaf_layer(incident_direct_irradiance: float, upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, direct_extinction_coefficient: float, direct_black_extinction_coefficient: float, canopy_reflectance_to_direct_irradiance: float, leaf_scattering_coefficient: float) float[source]
Calculates the absorbed scattered irradiance by a leaf layer per unit ground area.
- Parameters:
incident_direct_irradiance – [W m-2ground] incident direct (beam) irradiance at the top of the canopy
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
direct_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
canopy_reflectance_to_direct_irradiance – [-] canopy reflectance to direct (beam) irradiance
leaf_scattering_coefficient – [-] leaf scattering coefficient
- Returns:
[W m-2ground] the absorbed scattered irradiance by a sunlit leaf layer per unit ground area
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_canopy_reflectance_to_direct_irradiance(direct_black_extinction_coefficient: float, leaf_scattering_coefficient: float) float[source]
Calculates canopy reflectance to direct (beam) irradiance.
- Parameters:
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance through a canopy of black leaves
leaf_scattering_coefficient – [-] leaf scattering coefficient
- Returns:
[-] canopy reflectance to direct (beam) irradiance
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_diffuse_extinction_coefficient(leaf_area_index: float, leaf_angle_distribution_factor: float, clumping_factor: float, leaf_scattering_coefficient: float, sky_sectors_number: int = 3, sky_type: str = 'soc') -> (<class 'float'>, <class 'float'>)[source]
Calculates the diffuse extinction coefficients for canopies with non-black and black leaves.
- Parameters:
leaf_area_index – [m2leaf m-2ground] leaf area index of the whole canopy
leaf_angle_distribution_factor – [-] factor describing leaf angle distribution (for spherical distributions its value equals rad(56) = 0.9773843811168246)
clumping_factor – [-] clumping factor to describe the spatial dependency of the positions of the leaves (Weiss et al. 2004)
leaf_scattering_coefficient – [-] leaf scattering coefficient
sky_sectors_number – [-] number of sky sectors to be used
sky_type – one of ‘soc’ or ‘uoc’ (Sky OverCast and Uniform OverCast, respectively)
- Returns:
[m2ground m-2leaf] the extinction coefficient of diffuse irradiance through a canopy of non-black leaves [m2ground m-2leaf] the extinction coefficient of diffuse irradiance through a canopy of black leaves
References
- Goudriaan J. (1988)
The bare bones of leaf-angle distribution in radiation models for canopy photosynthesis and energy exchange. Agricultural and Forest Meteorology 43, 155 - 169.
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_direct_black_extinction_coefficient(solar_inclination: float, leaf_angle_distribution_factor: float, clumping_factor: float) float[source]
Calculates the extinction coefficient of direct (beam) irradiance through a canopy of black leaves.
- Parameters:
solar_inclination – [rad] angle of solar inclination
leaf_angle_distribution_factor – [-] factor describing leaf angle distribution (for spherical distributions its value equals rad(56) = 0.9773843811168246)
clumping_factor – [-] clumping factor to describe the spatial dependency of the positions of the leaves (Weiss et al. 2004)
- Returns:
[m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance through a canopy of black leaves
References
- Goudriaan J. (1977).
Crop Micrometeorology: A Simulation Study. Simulation monographs, Pudoc, Wageningen, 257 pp.
- Weiss M., Baret F., Smith G. J., Jonckheere I., Coppin P., 2004.
Review of methods for in situ leaf area index (LAI) determination. Agricultural Forest Meteorology 121, 37 - 53
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_direct_extinction_coefficient(solar_inclination: float, leaf_scattering_coefficient: float, leaf_angle_distribution_factor: float, clumping_factor: float) float[source]
Calculates the extinction coefficient of direct (beam) irradiance through a canopy.
- Parameters:
solar_inclination – [rad] angle of solar inclination
leaf_scattering_coefficient – [-] leaf scattering coefficient
leaf_angle_distribution_factor – [-] factor describing leaf angle distribution (for spherical distributions its value equals rad(56) = 0.9773843811168246)
clumping_factor – [-] clumping factor to describe the spatial dependency of the positions of the leaves (Weiss et al. 2004)
- Returns:
[m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance through the canopy
References
- Goudriaan J. (1977).
Crop Micrometeorology: A Simulation Study. Simulation monographs, Pudoc, Wageningen, 257 pp.
- Weiss M., Baret F., Smith G. J., Jonckheere I., Coppin P., 2004.
Review of methods for in situ leaf area index (LAI) determination. Agricultural Forest Meteorology 121, 37 - 53
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_leaf_scattering_coefficient(leaf_reflectance: float, leaf_transmittance: float) float[source]
Calculates leaf scattering coefficient.
- Parameters:
leaf_reflectance – [-] leaf reflectance coefficient for a given irradiance band
leaf_transmittance – [-] leaf transmittance coefficient for a given irradiance band
- Returns:
[-] leaf scattering coefficient
References
- Goudriaan J. (1977).
Crop Micrometeorology: A Simulation Study. Simulation monographs, Pudoc, Wageningen, 257 pp.
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_shaded_fraction(cumulative_leaf_area_index: float, direct_black_extinction_coefficient: float) float[source]
Calculates the fraction of shaded leaves at a given depth inside the canopy.
- Parameters:
cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
- Returns:
[-] fraction of shaded leaves at a given depth inside the canopy
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_sky_sectors_weight(sky_sectors_number: int, sky_type: str) list[source]
Calculates the contributions from sky sectors (rings) to diffuse irradiance.
- Parameters:
sky_sectors_number – [-] number of sky sectors to be used
sky_type – one of ‘soc’ or ‘uoc’ (Sky OverCast and Uniform OverCast, respectively)
- Returns:
[-] the contributions from sky sectors (rings) to diffuse irradiance
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_sunlit_fraction(cumulative_leaf_area_index: float, direct_black_extinction_coefficient: float) float[source]
Calculates the fraction of sunlit leaves at a given depth inside the canopy.
- Parameters:
cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
- Returns:
[-] fraction of sunlit leaves at a given depth inside the canopy
- crop_irradiance.uniform_crops.formalisms.sunlit_shaded_leaves.calc_sunlit_fraction_per_leaf_layer(upper_cumulative_leaf_area_index: float, leaf_layer_thickness: float, direct_black_extinction_coefficient: float) float[source]
Calculates the fraction of sunlit leaves at a given depth inside the canopy.
- Parameters:
upper_cumulative_leaf_area_index – [m2leaf m-2ground] cumulative downwards leaf area index at the top of the considered layer
leaf_layer_thickness – [m2leaf m-2ground] leaf area index of the considered layer
direct_black_extinction_coefficient – [m2ground m-2leaf] the extinction coefficient of direct (beam) irradiance for black leaves
- Returns:
[-] fraction of sunlit leaves of the considered layer