Workspace Dimensions

A dimension is a size that several workspace variables share. Naming one says that the variables agree about it: every variable with NFREQ has as many frequency points as every other local variable, so a propagation matrix computed on one frequency grid cannot be combined with a radiance computed on another.

Each workspace variable that has a shape reports it as an effective shape, which lists its dimensions from the outside in. For an array whose elements are all shaped alike, the effective shape covers both: spectral_propmat_path is [NPATH, NFREQ] because it holds one propagation matrix vector per path point, each of them over the same frequency grid. So the effective shape is what an index into the variable has to provide.

These are not free-form annotations. Methods and agendas verify them when a user supplies the data or composes the calls, and the failure says which variables disagreed and what sizes they had. Every method and agenda that verifies sizes lists what it requires under its own Constraints rubric.

Nothing here says how a size is read. That belongs to the group of the variable, since a size is read differently from a Vector than from a JacobianTargets, while the dimension is the same in both.

NALT

The number of altitude points.

Variables of this size

alt_grid atm_profile spectral_flux_profile spectral_nlte_srcvec_jac_profile spectral_nlte_srcvec_profile

spectral_propmat_jac_profile spectral_propmat_profile spectral_rad_field spectral_rad_operator

Variables whose elements are of this size

None.

NAUX

The number of auxiliary points.

Variables of this size

radar_aux

Variables whose elements are of this size

None.

NAZIMUTH

The number of azimuth angles.

Variables of this size

spectral_rad_field

Variables whose elements are of this size

None.

NDEPTH

The number of subsurface depth points.

Variables of this size

subsurf_profile

Variables whose elements are of this size

None.

NFREQ

The number of frequency points.

Variables of this size

freq_grid radar_aux spectral_absvec_scat spectral_flux_profile spectral_nlte_srcvec spectral_nlte_srcvec_jac spectral_phamat_spectral spectral_propmat spectral_propmat_jac spectral_propmat_scat

spectral_rad spectral_rad_bkg spectral_rad_bkg_jac spectral_rad_field spectral_rad_jac spectral_rad_jac_path spectral_rad_srcvec_path spectral_surf_refl spectral_surf_refl_jac spectral_tramat_path

Variables whose elements are of this size

freq_grid_path spectral_absvec_scat_path spectral_nlte_srcvec_jac_path spectral_nlte_srcvec_jac_profile spectral_nlte_srcvec_path spectral_nlte_srcvec_profile spectral_phamat_spectral_path

spectral_propmat_jac_path spectral_propmat_jac_profile spectral_propmat_path spectral_propmat_profile spectral_propmat_scat_path spectral_rad_scat_path

NLAT

The number of latitude points.

Variables of this size

lat_grid spectral_rad_field spectral_rad_operator

Variables whose elements are of this size

None.

NLEGENDRE

The number of Legendre coefficients.

Variables of this size

legendre_degree spectral_phamat_spectral

Variables whose elements are of this size

spectral_phamat_spectral_path

NLON

The number of longitude points.

Variables of this size

lon_grid spectral_rad_field spectral_rad_operator

Variables whose elements are of this size

None.

NMEAS

The number of measurements.

Variables of this size

measurement_gain_mat measurement_jac measurement_jac_error measurement_sensor

measurement_vec measurement_vec_error measurement_vec_error_covmat measurement_vec_fit

Variables whose elements are of this size

None.

NPATH

The number of path points.

Variables of this size

atm_path freq_grid_path freq_wind_shift_jac_path ray_path single_freq_path single_nlte_srcvec_jac_path single_nlte_srcvec_path single_propmat_jac_path single_propmat_path spectral_absvec_scat_path spectral_linevo_jac_path

spectral_linevo_path spectral_nlte_srcvec_jac_path spectral_nlte_srcvec_path spectral_phamat_spectral_path spectral_propmat_jac_path spectral_propmat_path spectral_propmat_scat_path spectral_rad_jac_path spectral_rad_scat_path spectral_rad_srcvec_path spectral_tramat_path

Variables whose elements are of this size

None.

NQUADRATURE

The number of quadrature points.

Variables of this size

None.

Variables whose elements are of this size

None.

NSTATE

The size of the model state vector.

Variables of this size

jac_targets measurement_averaging_kernel measurement_gain_mat measurement_jac measurement_jac_error model_state_covmat

model_state_vec model_state_vec_apriori single_rad_jac spectral_rad_bkg_jac spectral_rad_jac

Variables whose elements are of this size

None.

NTARGET

The number of Jacobian targets.

Variables of this size

covmat_diagonal_blocks jac_targets single_dispersion_jac single_nlte_srcvec_jac single_nlte_srcvec_jac_path single_propmat_jac single_propmat_jac_path

spectral_nlte_srcvec_jac spectral_propmat_jac spectral_rad_jac_path spectral_rad_srcvec_path spectral_surf_refl_jac spectral_tramat_path

Variables whose elements are of this size

spectral_nlte_srcvec_jac_path spectral_nlte_srcvec_jac_profile spectral_propmat_jac_path spectral_propmat_jac_profile

NZENITH

The number of zenith angles.

Variables of this size

spectral_rad_field zen_grid

Variables whose elements are of this size

None.