RT1

class rt1_model.RT1(V=None, SRF=None, int_Q=True, sig0=True, dB=True, fn_input=None, fnevals_input=None, I0=1.0)

Main class to perform RT-simulations.

Parameters:

  • V (rt1_model.volume.VolumeScatter object) – The volume-scattering phase function to use.

  • SRF (rt1_model.volume.SurfaceScatter object) – The surface-scattering phase function (BRDF) to use.

  • sig0 (bool) – Indicator if sigma0 (True) or intensity (False) values should be calculated.

  • dB (bool) – Indicator if results are returned in dB (True) or linear units (False). The default is True.

  • int_Q (bool (default = True)) – Indicator whether the interaction-term should be calculated or not.

  • fn_input (array_like(sympy expressions), optional (default = None)) – Optional input of pre-calculated array of sympy-expressions to speedup calculations where the same fn-coefficients can be used. If None, the coefficients will be calculated automatically at the initialization of the RT1-object.

  • fnevals_input (callable, optional (default = None)) – Optional input of pre-compiled function to numerically evaluate the fn_coefficients. if None, the function will be compiled using the fn-coefficients provided. Note that once the fnevals functions are provided, the fn-coefficients are no longer needed and have no effect on the calculated results!

  • I0 (array-like (float)) – Incident intensity. (Only relevant if sig0 = False) The default is 1.

Methods

__init__([V, SRF, int_Q, sig0, dB, ...])

analyze(R[, range_parameter])

A widget to analyze a given (monostatic) RT1 model specification.

analyze3d(R[, samples, contributions])

A widget to analyze the 3D scattering distribution of a selected RT1 specification.

calc(**params)

Calculate all model components and return result.

interaction(**params)

Numerical evaluation of the interaction-contribution.

jacobian([param_list, format])

Return the jacobian of the total backscatter (without interaction contribution).

set_bistatic([t_0, t_ex, p_0, p_ex])

Set bistatic evaluation geometry.

set_geometry(**kwargs)

Set the used (dynamic) incidence-angles when evaluating the model.

set_monostatic([p_0])

Set monostatic evaluation geometry.

surface(**params)

Numerical evaluation of the surface-contribution.

update_params(**kwargs)

Update the numerical values used for the model parameters.

volume(**params)

Numerical evaluation of the volume-contribution.

Attributes

NormBRDF

Normalization factor for the surface BRDF.

bsf

Fraction of bare-soil (e.g. signal with no attenuation due to vegetation).

omega

Single scattering albedo of the volume scattering layer.

p_0

Incident azimuth angle.

p_ex

Exit azimuth angle.

param_dict

A dictionary that is used to assign numerical values to the free parameters of the model.

t_0

Incident zenith angle.

t_ex

Exit zenith angle.

tau

Optical depth of the volume scattering layer.