CxxWorkspace
- class pyarts3.arts.CxxWorkspace(*args, **kwargs)
The core ARTS Workspace
Overview
Method
Ignore a workspace variable.
Method
Inversion by the so called optimal estimation method (OEM).
Method
Reads split catalog data from a folder structure similar to
arts-cat-dataMethod
Reads a workspace variable from an XML file.
Method
As
ReadXML(), but reads indexed file names.Method
Sets an atmospheric target.
Method
Set a measurement error to polynomial fit.
Method
Set magnetic field derivative.
Method
Set magnetic field derivative for overlapping fields.
Method
Set wind field derivative for overlapping fields.
Method
Set pressure derivative.
Method
Set sensor frequency derivative to use polynomial fitting offset
Method
Set isotopologue ratio derivative
Method
Set volume mixing ratio derivative.
Method
Sets a subsurface target
Method
Sets a surface target
Method
Set temperature derivative.
Method
Set wind field derivative.
Method
Finalize the retrieval setup.
Method
Initialize the retrieval setup.
Method
Integrate Disort spectral radiance.
Method
As
Ignore()but for agenda output.Method
Update state of the model in preparation for a forward model run
Method
Initialize the Wigner tables
Method
Unloads the Wigner tables from static data (see
WignerInit())Method
Writes all the builtin partition functions to file.
Method
Writes a workspace variable to an XML file.
Method
As
WriteXML(), but creates indexed file names.Method
Sets
abs_bandsto the state of the model.Method
Keeps first band of ID
Method
Adapts select band to use ordered Line mixing coefficients.
Method
Reads HITRAN data from a file.
Method
Same as
abs_bandsReadSpeciesSplitCatalog()but for reading the old ARTSCAT format.Method
Reads all species in
abs_speciesfrom a basenameMethod
Reads all xml-files in a given directory and puts them into
abs_bands.Method
Saves all bands in
abs_bandsto a directoryMethod
Remove all bands whose lines all strictly falls outside a frequency range
Method
Remove all lines that strictly falls outside a frequency range
Method
Set all bands to use non-LTE calculations.
Method
Set the Zeeman splitting for lines within the frequency range
Method
Read data from a CIA data file for all CIA molecules defined
Method
Read data from a CIA XML file and check that all CIA tags defined
Method
Reads a species split CIA dataset.
Method
Sets the O2-66 microwave band data for ECS.
Method
Sets ECS data for air from other data if available.
Method
Sets the CO2-626, CO2-628, and CO2-636 band data for ECS.
Method
Sets the CO2-626, CO2-628, and CO2-636 band data for ECS.
Method
Resets/initializes the ECS data.
Method
Get
abs_lookup_datafrom available data.Method
Compute the lookup table for all species in
abs_bands.Method
Initialize an empty lookup table.
Method
Precompute the lookup table for a single species, adding it to the map.
Method
Compute the lookup table for all species in
abs_bands.Method
Set up a simple wide lookup table for all species in
abs_bands.Method
Sets the data for MT CKD 4.0 Water model
Method
Initialize the predefined model data
Method
Reads
abs_predef_datacatalog but only forabs_speciesMethod
Sets
abs_speciesto contain all species in ARTSMethod
Set
abs_speciesto the named species.Method
Reads HITRAN Crosssection coefficients
Method
Set the magnetic field to use the magnitude field functional.
Method
Set the wind field to use the magnitude field functional.
Method
Append data to the atmospheric field based on available absorption data.
Method
Append base data to the atmospheric field
Method
Append species data to the atmospheric field based on collision-induced absorption data.
Method
Append isotopologue ratio data to the atmospheric field based on line data.
Method
Append NLTE data to the atmospheric field based on line data.
Method
Append species data to the atmospheric field based on line data.
Method
Append species data to the atmospheric field based on absorption lookup table data.
Method
Append species data to the atmospheric field based on absorption predefined model data.
Method
Append species data to the atmospheric field based on
abs_species.Method
Append species data to the atmospheric field based on absorption cross-section fit data.
Method
Fits non-LTE atmospheric field values
Method
Sets
atm_fieldto the state of the model.Method
Sets the atmospheric field to be the 1D atmospheric profile.
Method
Add the hydrostatic pressure to the atmospheric field
Method
Use IGRF to compute the magnetic field at each point.
Method
Initialize the atmospheric field with some altitude and isotopologue ratios
Method
Initialize the non-LTE atmospheric field from the LTE temperature field.
Method
Read atmospheric data files from a directory
Method
For forward calculations, this should be similar to
atm_fieldIGRF().Method
Gets the atmospheric points along the path.
Method
Set
atm_path = atm_profile.Method
Initialize an atmospheric point with some isotopologue ratios
Method
Extract an atmospheric profile from the atmospheric field.
Method
Fits non-LTE distributions to the level data.
Method
Extract an atmospheric profile and its grids.
Method
Space radiation into Disort is isotropic cosmic background radiation.
Method
Set the downwelling boundary condition using the observer agenda.
Method
Perform Disort calculations for spectral flux.
Method
Same as
disort_settingsLayerThermalEmissionLinearInTau()but considers non-LTEMethod
Use a source function that changes linearly in optical thickness.
Method
Sets the legendre coefficients from the path-variable.
Method
Turns off fractional scattering in Disort calculations.
Method
Turns off source radiation in Disort calculations.
Method
Turns off Legendre coefficients in Disort calculations.
Method
Turns off single albedo scattering in Disort calculations.
Method
Turns off boundary condition from space for Disort calculations.
Method
Turns off solar radiation in Disort calculations.
Method
Turns off surface boundary condition for Disort calculations.
Method
Turns off BDRF in Disort calculations.
Method
Get optical thickness from path.
Method
Uses Set the FOV to the sun input for Disort calculations.
Method
Sets the single scattering albedo from the path-variable.
Method
Subsurface boundary emission into Disort is based on temperature.
Method
Use a source function that changes linearly in optical thickness.
Method
Get optical thickness from subsurface path.
Method
Turns off single albedo scattering in Disort calculations.
Method
Surface radiation into Disort is isotropic from surface temperature.
Method
Sets the surface to Lambertian.
Method
Executes
disort_settings_agenda, see it for more detailsMethod
Executes an operator emulating
disort_settings_agenda, see it, and alsodisort_settings_agendaOperator, for more detailsMethod
Set
disort_settings_agendato exclusively use provided external operator. Seedisort_settings_agendaOperatorfor more details.Method
Setup for Disort standard calculations.
Method
Setup for Disort subsurface calculations.
Method
Executes
disort_settings_downwelling_wrapper_agenda, see it for more detailsMethod
Executes an operator emulating
disort_settings_downwelling_wrapper_agenda, see it, and alsodisort_settings_downwelling_wrapper_agendaOperator, for more detailsMethod
Set
disort_settings_downwelling_wrapper_agendato a specific predefined optionMethod
Set
disort_settings_downwelling_wrapper_agendato exclusively use provided external operator. Seedisort_settings_downwelling_wrapper_agendaOperatorfor more details.Method
Perform Disort calculations for spectral flux.
Method
Use Disort for clearsky calculations of spectral flux field.
Method
Extract a 1D path through the atmosphere and calculate spectral flux using Disort.
Method
Convert units of the Disort spectral radiance field.
Method
Perform Disort calculations for spectral radiance.
Method
Perform CDisort calculations for spectral radiance.
Method
Sets a ray path from a point and depth profile and calculates spectral radiance using Disort.
Method
Use Disort for clearsky calculations of spectral radiance field.
Method
Use the disort settings agenda to calculate spectral radiance
Method
Extract a 1D path through the atmosphere and calculate spectral radiance using Disort.
Method
Extract a 1D path through the atmospheric field and calculate spectral radiance using Disort
Method
Computes the spectral flux
Method
Same as
freq_gridWindShift()but for single frequency values.Method
Frequency grid useful for
atm_profileFitNonLTE().Method
Composition method, creates a frequency grid from a single frequency.
Method
Applies wind shift to the
freq_gridfor the local frequency grid.Method
Gets the frequency grids along the path.
Method
Gets the value of the variable with the given name.
Method
Sets a gravity operator from the gravitational constant and the mass of the planet
Method
Checks if the workspace contains the variable.
Method
Overloaded function.
Method
Executes
inversion_iterate_agenda, see it for more detailsMethod
Executes an operator emulating
inversion_iterate_agenda, see it, and alsoinversion_iterate_agendaOperator, for more detailsMethod
Set
inversion_iterate_agendato a specific predefined optionMethod
Set
inversion_iterate_agendato exclusively use provided external operator. Seeinversion_iterate_agendaOperatorfor more details.Method
Sets an atmospheric target.
Method
Set a measurement error to polynomial fit.
Method
Set magnetic field derivative.
Method
Set magnetic field derivative for overlapping fields.
Method
Set wind field derivative for overlapping fields.
Method
Set pressure derivative.
Method
Set sensor frequency derivative to use polynomial fitting offset
Method
Set isotopologue ratio derivative
Method
Set volume mixing ratio derivative.
Method
Sets a subsurface target
Method
Sets a surface target
Method
Set temperature derivative.
Method
Set wind field derivative.
Method
Clears
jac_targetsifdo_jacevaluates false.Method
Finalize
jac_targets.Method
Initialize or reset the
jac_targets.Method
Turns off
jac_targetsMethod
Toggles logarithmic/relative or absolute retrievals.
Method
Toggles logarithmic/relative or absolute retrievals.
Method
Toggles logarithmic/relative or absolute retrievals.
Method
Toggles logarithmic or absolute retrievals.
Method
Toggles logarithmic or absolute retrievals.
Method
Toggles logarithmic or absolute retrievals.
Method
Toggles relative or absolute retrievals.
Method
Toggles relative humidity or absolute retrievals.
Method
Toggles relative or absolute retrievals.
Method
Toggles relative or absolute retrievals.
Method
Sets
legendre_degreetodisort_settingslegendre_polynomial_dimensionMethod
Calculate the averaging kernel matrix.
Method
Executes
measurement_inversion_agenda, see it for more detailsMethod
Executes an operator emulating
measurement_inversion_agenda, see it, and alsomeasurement_inversion_agendaOperator, for more detailsMethod
Set
measurement_inversion_agendato a specific predefined optionMethod
Set
measurement_inversion_agendato exclusively use provided external operator. Seemeasurement_inversion_agendaOperatorfor more details.Method
Applies transformations to the atmospheric state Jacobian
Method
Applies transformations to the line-by-line state Jacobian
Method
Applies transformations to the measurement sensor state Jacobian
Method
Applies transformations to the subsurface state Jacobian
Method
Applies transformations to the surface state Jacobian
Method
Apply all transformations to the Jacobian related to states in
model_state_vecFromData()Method
Add a sensor to
measurement_sensorthat has a Gaussian zenith response.Method
Adds sensor elements from a raw perturbation of the sensor
Method
Adds a sensor with a dirac channel opening around the frequency grid.
Method
Adds a sensor with a Gaussian channel opening around the frequency grid.
Method
Adds a sensor with a Gaussian channel opening around the frequency grid.
Method
Update
measurement_sensorfrommodel_state_vec.Method
Initialize
measurement_sensorto empty.Method
Creates a single simple Dirac-opening sensor
Method
Creates a single simple Gaussian-opening sensor.
Method
Creates a single simple Gaussian-opening sensor.
Method
Add the measurement error to the measurement. Conditionally, also to the Jacobian.
Method
Sets measurement vector by looping over all sensor elements
Method
Sets measurement vector by looping over all sensor elements
Method
Set the error and its Jacobian from the state of the model.
Method
Sets a constant measurement vector error covariance matrix.
Method
Calculates the covariance matrix describing the error due to uncertainties in the observation system.
Method
Sets the fitted measurement vector to the current measurement vector.
Method
Set a species model state covariance matrix element.
Method
Initialises the model state covariance matrix to the identity matrix.
Method
Calculates the covariance matrix describing the error due to smoothing.
Method
Sets
model_state_vec’s atmospheric part.Method
Sets
model_state_vec’s absorption line part.Method
Get
model_state_vecfrom available dataMethod
Sets
model_state_vec’s sensor part.Method
Sets
model_state_vec’s subsurface part.Method
Sets
model_state_vec’s surface part.Method
Sets
model_state_vecto the sizejac_targetsdemand.Method
Sets
model_state_vecto the sizejac_targetsdemand.Method
Get
model_state_vec_apriorifrom available dataMethod
Sets the a priori state of the model state vector to the current state.
Method
Integrate the spectral flux profile to get the line non-LTE flux
Method
Fill the path with with points that crosses the grid of the atmspheric field.
Method
Add the limb point to the ray path
Method
Fill the path with geometric step points.
Method
Fill the path with geometric step points.
Method
Fix azimuth angle errors that can occur for 180 and 0 degrees zenith.
Method
Create a depth profile ray path from a point.
Method
Get a geometric radiation path
Method
Wraps
ray_pathGeometric()for straight downlooking paths from the top-of-the-atmosphere altitudeMethod
Wraps
ray_pathGeometric()for straight uplooking paths from the surface altitude at the positionMethod
Initialize the ray path with a single point.
Method
Remove points that are too close to each other.
Method
Remove non-atmospheric points to the ray path
Method
Remove all non-geometric grid crossings from the ray path.
Method
Add the geometric extremes to the ray path.
Method
Adds observers that covers all zenith angles for each altitude point.
Method
Create a ray path field from a set of observers.
Method
Executes
ray_path_observer_agenda, see it for more detailsMethod
Executes an operator emulating
ray_path_observer_agenda, see it, and alsoray_path_observer_agendaOperator, for more detailsMethod
Set
ray_path_observer_agendafrom programmable geometric settings.Method
Set
ray_path_observer_agendato exclusively use provided external operator. Seeray_path_observer_agendaOperatorfor more details.Method
Get a list of observer positions and line of sights to represent observing all angles of a profile.
Method
Add \(n\) observers per altitude point.
Method
Wraps
sun_pathFromObserverAgenda()for all paths to all suns.Method
Sets a path of Zeeman effect magnetic field properties.
Method
Method
Method
Method
Method
Gets the previous geometric point along
ray_pathMethod
Gets the previous refractive point along
ray_pathMethod
Executes
ray_point_back_propagation_agenda, see it for more detailsMethod
Executes an operator emulating
ray_point_back_propagation_agenda, see it, and alsoray_point_back_propagation_agendaOperator, for more detailsMethod
Set
ray_point_back_propagation_agendato a specific predefined optionMethod
Set
ray_point_back_propagation_agendato exclusively use provided external operator. Seeray_point_back_propagation_agendaOperatorfor more details.Method
Read variable from file.
Method
Saves variable to file.
Method
Initialize scattering species.
Method
Set the variable to the new value.
Method
Add line-by-line absorption to the propagation matrix.
Method
Initialize single-point propagation matrix fields.
Method
Executes
single_propmat_agenda, see it for more detailsMethod
Executes an operator emulating
single_propmat_agenda, see it, and alsosingle_propmat_agendaOperator, for more detailsMethod
Set
single_propmat_agendato exclusively use provided external operator. Seesingle_propmat_agendaOperatorfor more details.Method
Computes the spectral radiance for a single frequency using clear-sky emission propagation.
Method
Composition method to extract a single spectral radiance from a vector.
Method
Executes
single_rad_space_agenda, see it for more detailsMethod
Executes an operator emulating
single_rad_space_agenda, see it, and alsosingle_rad_space_agendaOperator, for more detailsMethod
Set
single_rad_space_agendato a specific predefined optionMethod
Set
single_rad_space_agendato exclusively use provided external operator. Seesingle_rad_space_agendaOperatorfor more details.Method
Executes
single_rad_surface_agenda, see it for more detailsMethod
Executes an operator emulating
single_rad_surface_agenda, see it, and alsosingle_rad_surface_agendaOperator, for more detailsMethod
Set
single_rad_surface_agendato a specific predefined optionMethod
Set
single_rad_surface_agendato exclusively use provided external operator. Seesingle_rad_surface_agendaOperatorfor more details.Method
Computes the spectral flux from a field of paths.
Method
Computes the spectral flux. The input field must be a profile.
Method
Computes the spectral flux profile using pseudo-2D geometry
Method
Add absorption coefficients for HITRAN collision induced absorption (CIA).
Method
Calculates absorption matrix describing Faraday rotation.
Method
Add line-by-line absorption to the propagation matrix.
Method
Add line-by-line absorption to the propagation matrix.
Method
Adds all of the predefined models in
abs_speciesto the spectral_propmatMethod
Add line-by-line absorption to the propagation matrix.
Method
Calculate absorption cross sections per tag group for HITRAN xsec species.
Method
Initialize
spectral_propmat,spectral_nlte_srcvec, and their derivatives to zeroes.Method
Sets the
spectral_propmat_agendaautomatically from absorption data and species tag meta information.Method
Executes
spectral_propmat_agenda, see it for more detailsMethod
Executes an operator emulating
spectral_propmat_agenda, see it, and alsospectral_propmat_agendaOperator, for more detailsMethod
Set
spectral_propmat_agendato a specific predefined optionMethod
Set
spectral_propmat_agendato exclusively use provided external operator. Seespectral_propmat_agendaOperatorfor more details.Method
Fix for the wind field derivative.
Method
Same as
spectral_propmat_pathFromPath()but with adaptive path.Method
Adds the scattering part of the propagation matrix to the rest along the path.
Method
Gets the propagation matrix and non-LTE source term along the path.
Method
As
spectral_propmat_pathFromPath()but the output is split between the species in theMethod
Adds
scat_speciesresults for totally random oriented spectral calculations toMethod
Add simple air to
spectral_propmat_scat.Method
Initialize
spectral_propmat_scatto zeroes.Method
Initialize
spectral_propmat_scatand co to zeroes.Method
Executes
spectral_propmat_scat_agenda, see it for more detailsMethod
Executes an operator emulating
spectral_propmat_scat_agenda, see it, and alsospectral_propmat_scat_agendaOperator, for more detailsMethod
Set
spectral_propmat_scat_agendato a specific predefined optionMethod
Set
spectral_propmat_scat_agendato exclusively use provided external operator. Seespectral_propmat_scat_agendaOperatorfor more details.Method
Gets the propagation matrix for scattering along the path.
Method
Compute
spectral_propmat_scat_pathand co for a path.Method
Executes
spectral_propmat_scat_spectral_agenda, see it for more detailsMethod
Executes an operator emulating
spectral_propmat_scat_spectral_agenda, see it, and alsospectral_propmat_scat_spectral_agendaOperator, for more detailsMethod
Set
spectral_propmat_scat_spectral_agendato a specific predefined optionMethod
Set
spectral_propmat_scat_spectral_agendato exclusively use provided external operator. Seespectral_propmat_scat_spectral_agendaOperatorfor more details.Method
Helper to call
spectral_radApplyUnit()when you do not havespectral_rad_jac.Method
Applies a unit to
spectral_rad, returning a new fieldMethod
Helper method for calling
spectral_radApplyUnit().Method
Computes clearsky transmission of spectral radiances
Method
Computes clearsky emission of spectral radiances
Method
Wraps
single_radClearskyEmissionPropagation()for a vector of frequencies.Method
Computes clearsky emission of spectral radiances
Method
Computes clearsky emission of spectral radiances with solar Rayleigh scattering
Method
Computes clearsky transmission of spectral radiances
Method
Gets the spectral radiance from the path transmission.
Method
Sets default
spectral_radandspectral_rad_jacfor transmission.Method
Extract spectral radiance from the Disort field at the ray path point.
Method
Integrate Disort spectral radiance.
Method
Set the spectral radiance to the background values.
Method
Computes the spectral radiance by looping over frequencies for a single path.
Method
Gets the spectral radiance from the path.
Method
Get the spectral radiance from subsurface emission simulated using Disort
Method
Gets the spectral radiance from the path.
Method
Get the spectral radiance of a sun or of the cosmic background if the sun is not hit.
Method
Get the spectral radiance of a sun or of the cosmic background if no sun is hit.
Method
Set surface spectral radiance from Planck function of the surface temperature.
Method
Set surface spectral radiance to use sub-surface emission and Fresnel reflectance.
Method
Background spectral radiance is from a uniform cosmic background temperature.
Method
Computes the background radiation.
Method
Computes the spectral radiance field using
ray_path_observer_agenda.Method
Computes the spectral radiance field assuming planar geometric paths
Method
Computes the spectral radiance field assuming a profile and a pseudo-2D path.
Method
Adds the propagation variables to
spectral_rad_jac.Method
Adds sensor properties to the
spectral_rad_jac.Method
Set the radiation derivative to empty.
Method
Sets
spectral_rad_jacfrom the background values.Method
Executes
spectral_rad_observer_agenda, see it for more detailsMethod
Executes an operator emulating
spectral_rad_observer_agenda, see it, and alsospectral_rad_observer_agendaOperator, for more detailsMethod
Set
spectral_rad_observer_agendato a specific predefined optionMethod
Set
spectral_rad_observer_agendato exclusively use provided external operator. Seespectral_rad_observer_agendaOperatorfor more details.Method
Set up a 1D spectral radiance operator
Method
Add
sunstospectral_rad_srcvec_path.Method
Executes
spectral_rad_space_agenda, see it for more detailsMethod
Executes an operator emulating
spectral_rad_space_agenda, see it, and alsospectral_rad_space_agendaOperator, for more detailsMethod
Set
spectral_rad_space_agendato a specific predefined optionMethod
Set
spectral_rad_space_agendato exclusively use provided external operator. Seespectral_rad_space_agendaOperatorfor more details.Method
Adds the scattering part of the propagation matrix to the rest along the path.
Method
Gets the source term along the path.
Method
Executes
spectral_rad_surface_agenda, see it for more detailsMethod
Executes an operator emulating
spectral_rad_surface_agenda, see it, and alsospectral_rad_surface_agendaOperator, for more detailsMethod
Set
spectral_rad_surface_agendato a specific predefined optionMethod
Set
spectral_rad_surface_agendato exclusively use provided external operator. Seespectral_rad_surface_agendaOperatorfor more details.Method
Creates a
SpectralRadianceTransformOperatorfrom aSpectralRadianceUnitType.Method
Set the surface reflectance to the flat real Fresnel reflectance
Method
Set the surface reflectance to the flat real Fresnel reflectance
Method
Executes
spectral_surf_refl_agenda, see it for more detailsMethod
Executes an operator emulating
spectral_surf_refl_agenda, see it, and alsospectral_surf_refl_agendaOperator, for more detailsMethod
Set
spectral_surf_refl_agendato a specific predefined optionMethod
Set
spectral_surf_refl_agendato exclusively use provided external operator. Seespectral_surf_refl_agendaOperatorfor more details.Method
Sets
spectral_tramat_bkgto back ofspectral_tramat_cumulative_path.Method
Sets
spectral_tramat_bkgto front ofspectral_tramat_cumulative_path.Method
Sets
spectral_tramat_cumulative_pathby forward iteration ofspectral_tramat_pathMethod
Gets the transmission matrix in layers along the path.
Method
Sets
subsurf_fieldto the state of the model.Method
Extract a subsurface profile from a ray path.
Method
Set
sunto blackbody.Method
Extracts a sun spectrum from a field of such data.
Method
Find a path that hits the sun if possible
Method
Earth reference ellipsoids.
Method
Europa reference ellipsoids.
Method
Sets
surf_fieldto the state of the model.Method
Ganymede reference ellipsoids.
Method
Manual setting of the reference ellipsoid.
Method
Io reference ellipsoids.
Method
Jupiter reference ellipsoids.
Method
Mars reference ellipsoids.
Method
Moon reference ellipsoids.
Method
Initialize the surface field with the ellipsoid of a planet.
Method
Venus reference ellipsoids.
Method
Swap the workspace for andother.
Method
Calculate equivalent water pressure according to Murphy and Koop, 2005
Method
A custom zenith grid for
spectral_rad_fieldProfilePseudo2D()Static Method
Create variable from file.
Bands of absorption lines for line-by-line (LBL) calculations.
HITRAN Collision-Induced Absorption (CIA) Data.
Error corrected sudden data
Absorption lookup table for scalar gas absorption coefficients.
This contains predefined model data.
Tag groups for gas absorption.
Fitting model coefficients for cross section species.
A single altitude in the atmosphere.
An ascending list of
alt. Often related to a field or a profile.An atmospheric field in ARTS.
Atmospheric points along the propagation path.
An atmospheric point in ARTS.
An atmospheric profile in ARTS.
A helper map for setting the covariance matrix.
The number of Fourier modes for Disort.
The number of input Legendre polynimials for Disort.
The quadrature angles for Disort with accompying weights.
The quadrature size for Disort.
Contains the full settings of spectral Disort calculations.
An agenda for setting up Disort.
An wrapper agenda for calling
disort_settings_agenda.The spectral flux field from Disort.
The spectral radiance field from Disort.
A boolean calculations related to the
measurement_jacshould be ignored.A single frequency. Unit: Hz.
A frequency grid. Unit: Hz.
All
freq_gridalong the propagation path.The frequency wind shift Jacobian.
A list of
freq_wind_shift_jacfor a ray path.The gravity operator.
Work in progress …
A counter for the inversion iterate agenda.
A list of targets for the Jacobian Matrix calculations.
A single latitude.
An ascending list of
lat. Often related to a field or a profile.The degree of a Legendre polynimial.
A single longitude.
An ascending list of
lon. Often related to a field or a profile.A control parameter for stepping through layers in ray tracing.
Averaging kernel matrix.
Contribution function (or gain) matrix.
This is a helper
Agendaintended for use withininversion_iterate_agenda.The first order partial derivatives of the
measurement_vec.The partial derivatives of the
measurement_vec_error.A list of sensor elements.
The measurment vector for, e.g., a sensor.
The model measurment vector error for, e.g., a sensor.
Covariance matrix for observation uncertainties.
As
measurement_vec, but fitted to the model.Covariance matrix of a priori distribution.
A state vector of the model.
An apriori state vector of the model.
A per-line flux profile.
The line-of-sight of the observer of spectral radiance.
The position of an observer of spectral radiance.
A list path points making up a propagation path.
A list of
ray_pathintended to build up a field of observations.Gets the propagation path as it is obeserved.
A list path points making up the observers of a propagation path.
A list of paths to the suns from the ray path.
A single path point.
Gets the next past point along a propagation path.
The scattering species
Species selection.
Species selection when multiple species must be chosen.
A dispersion at a single
freqpoint.A dispersion Jacobian at a single
freqpoint.The
freqalong the path.A non-LTE source vector at a single
freqpoint.A non-LTE source vector Jacobian at a single
freqpoint.The propagation matrix Jacobian along the path for nonlte source.
The propagation matrix along the path for nonlte source vector.
A propagation matrix at a single
freqpoint.Computes the propagation matrix, the non-LTE source vector, the dispersion, and their derivatives.
A propagation matrix Jacobian at a single
freqpoint.The propagation matrix Jacobian along the path.
The propagation matrix along the path.
Single value version of
spectral_rad.Single value version of
spectral_rad_jac.Gets spectral radiance as seen of space for a single frequency.
Gets spectral radiance as seen of the surface for a single frequency.
The absorption vector of totally random orientation particles at a single point along a path using spectral representation
The absorption vector of totally random orientation particles along the propagation path using spectral representation
An altitude profile of spectral flux.
The part of the source vector that is due to non-LTE.
Partial derivative of the
spectral_nlte_srcvecwith regards tojac_targets.Additional non-LTE derivative along the propagation path
Additional non-LTE along the propagation path
The spectral phase matrix of totally random orientation particles at a single point along a path using spectral representation
The spectral phase matrix of totally random orientation particles along the propagation path using spectral representation
This contains the fully polarized propagation matrix for the current path point.
Computes the propagation matrix, the non-LTE source vector, and their derivatives.
Partial derivative of the
spectral_propmatwith regards tojac_targets.Propagation derivative matrices along the propagation path
Propagation matrices along the propagation path
This contains the propagation matrix for scattering for the current path point.
Computes the part of the propagation matrix that relates to scattering.
Propagation matrices along the propagation path for scattering
Gets the scattering propagation matrix, the scattering absorption vector, and the scattering spectral phase matrix.
A spectral radiance vector.
Spectral radiance from the background
Spectral radiance derivative from the background
A closed surface agenda.
The spectral radiance field.
Jacobian of
spectral_radwith respect tojac_targets.Spectral radiance derivative along the propagation path
Computes spectral radiance as seen from the input position and environment.
The spectral radiance operator.
Spectral radiance scattered into the propagation path
Gets spectral radiance as seen of space.
Source derivative vectors along the propagation path
Source vectors along the propagation path
Computes spectral radiance as seen of the surface.
The spectral radiance transform operator
Spectral surface reflectance.
An agenda to compute the surface reflectance.
Spectral surface reflectance jacobian.
Transmittance from the background
Cumulative transmission matrices along the propagation path
Transmission derivative matrices along the propagation path.
Transmission matrices along the propagation path.
The sub-surface field.
A profile of subsurface points. Supposed to be ordered from top to bottom.
A sun.
A path to a sun if it is visible.
A list of
Sun.The surface field.
The water equivalent pressure operator.
The workspace variables
A single zenith angle grid.
Operator
Return self==value.
Operator
__format__(self, arg: str, /) -> str
Operator
Return self>=value.
Operator
Helper for pickle.
Operator
Return self>value.
Operator
Return hash(self).
Operator
__init__(self, with_defaults: bool = True) -> None
Operator
Allows iter(self)
Operator
Return self<=value.
Operator
Return self<value.
Operator
Return self!=value.
Operator
__repr__(self) -> str
Operator
__str__(self) -> str
Constructors
- __init__(self) None
- __init__(self, arg: pyarts3.arts.CxxWorkspace) None
- __init__(self, with_defaults: bool = True) None
Methods
- Ignore(self, input: object | None = None) None
Ignore a workspace variable.
This method is handy for use in agendas in order to suppress warnings about unused input workspace variables. What it does is: Nothing! In other words, it just ignores the variable it is called on.
This method can ignore any workspace variable you want.
Author: Stefan Buehler
- Parameters:
input (Any) – Variable to be ignored. [IN]
- OEM(self, model_state_vec: pyarts3.arts.Vector | None = None, measurement_vec_fit: pyarts3.arts.Vector | None = None, measurement_jac: pyarts3.arts.Matrix | None = None, atm_field: pyarts3.arts.AtmField | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, measurement_gain_mat: pyarts3.arts.Matrix | None = None, oem_diagnostics: pyarts3.arts.Vector | None = None, lm_ga_history: pyarts3.arts.Vector | None = None, errors: pyarts3.arts.ArrayOfString | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, model_state_vec_apriori: pyarts3.arts.Vector | None = None, model_state_covmat: pyarts3.arts.CovarianceMatrix | None = None, measurement_vec: pyarts3.arts.Vector | None = None, measurement_vec_error_covmat: pyarts3.arts.CovarianceMatrix | None = None, inversion_iterate_agenda: pyarts3.arts.Agenda | None = None, method: pyarts3.arts.String | None = None, max_start_cost: pyarts3.arts.Numeric | None = None, model_state_covmat_normalization: pyarts3.arts.Vector | None = None, max_iter: pyarts3.arts.Index | None = None, stop_dx: pyarts3.arts.Numeric | None = None, lm_ga_settings: pyarts3.arts.Vector | None = None, clear_matrices: pyarts3.arts.Index | None = None, display_progress: pyarts3.arts.Index | None = None) None
Inversion by the so called optimal estimation method (OEM).
Work in progress …
The cost function to minimise, including a normalisation with length of
measurement_vec, is:\[\chi^2 = \chi^2_y + \chi^2_x\]where:
\[\chi^2_y = \frac{1}{m} \left(\vec{y}-\vec{y}_f\right)^\top \mathbf{S}_\epsilon^{-1} \left(\vec{y}-\vec{y}_f\right)\]\[\chi^2_x = \frac{1}{m} \left(\vec{x}-\vec{x}_a\right)^\top \mathbf{S}_a^{-1} \left(\vec{x}-\vec{x}_a\right)\]where:
Variable
ARTS parameter
Meaning
\(\vec{x}\)
The model state vector. All model states that are allowed to vary.
\(\vec{x}_a\)
The a priori model state vector.
\(\vec{y}\)
The measurement vector. This is the measurement that the OEM is trying to fit.
\(\vec{y}_f\)
The fitted measurement vector. The simulated measurement vector for the model state vector.
\(\mathbf{S}_\epsilon\)
The error covariance matrix of the measurement vector.
\(\mathbf{S}_a\)
The a priori covariance matrix of the model state vector.
The current implementation provides 3 methods for the minimization of the cost functional: Linear, Gauss-Newton and Levenberg-Marquardt. The Gauss-Newton minimizer attempts to find a minimum solution by fitting a quadratic function to the cost functional. The linear minimizer is a special case of the Gauss-Newton method, since for a linear forward model the exact solution of the minimization problem is obtained after the first step. The Levenberg-Marquardt method adaptively constrains the search region for the next iteration step by means of the so-called gamma-factor. This makes the method more suitable for strongly non-linear problems. If the gamma-factor is 0, Levenberg-Marquardt and Gauss-Newton method are identical. Each minimization method (li,gn,lm) has an indirect variant (li_cg,gn_cg,lm_cg), which uses the conjugate gradient solver for the linear system that has to be solved in each minimzation step. This of advantage for very large problems, that would otherwise require the computation of expensive matrix products.
Description of the special input arguments:
method:"li": A linear problem is assumed and a single iteration is performed."li_cg": A linear problem is assumed and solved using the CG solver."gn": Non-linear, with Gauss-Newton iteration scheme."gn_cg": Non-linear, with Gauss-Newton and conjugate gradient solver."lm": Non-linear, with Levenberg-Marquardt (LM) iteration scheme."lm_cg": Non-linear, with Levenberg-Marquardt (LM) iteration scheme and conjugate gradient solver.
max_start_cost:No inversion is done if the cost matching the a priori state is above this value. If set to a negative value, all values are accepted. This argument also controls if the start cost is calculated. If set to <= 0, the start cost in
oem_diagnosticsis set to NaN when using “li” and “gn”.x_norm:A normalisation vector for
model_state_vec. A normalisation ofmodel_state_veccan be needed due to limited numerical precision. If this vector is set to be empty no normalisation is done (defualt case). Otherwise, this must be a vector with same length asmodel_state_vec, just having values above zero. Elementwise division betweenmodel_state_vecandx_norm(x./x_norm) shall give a vector where all values are in the order of unity. Maybe the best way to setx_normis x_norm = sqrt( diag( Sx ) ).max_iter:Maximum number of iterations to perform. No effect for “li”.
stop_dx:n”Iteration stop criterion. The criterion used is the same as given in Rodgers' “Inverse Methods for Atmospheric Sounding”
lm_ga_settings:Settings controlling the gamma factor, part of the “LM” method. This is a vector of length 6, having the elements (0-based index):
Start value.
Fractional decrease after succesfull iteration.
Fractional increase after unsuccessful iteration.
Maximum allowed value. If the value is passed, the inversion is halted.
Lower treshold. If the threshold is passed, gamma is set to zero. If gamma must be increased from zero, gamma is set to this value.
Gamma limit. This is an additional stop criterion. Convergence is not considered until there has been one succesful iteration having a gamma <= this value.
The default setting triggers an error if “lm” is selected.
clear matrices:With this flag set to 1,
measurement_jacandmeasurement_gain_matare returned as empty matrices.display_progress:Controls if there is any screen output. The overall report level is ignored by this WSM.
Author: Patrick Eriksson
- Parameters:
model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[INOUT]measurement_vec_fit (Vector, optional) – As
measurement_vec, but fitted to the model. Seemeasurement_vec_fit, defaults toself.measurement_vec_fit[INOUT]measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[INOUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[INOUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[INOUT]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[INOUT]measurement_gain_mat (Matrix, optional) – Contribution function (or gain) matrix. See
measurement_gain_mat, defaults toself.measurement_gain_mat[OUT]oem_diagnostics (Vector) – Basic diagnostics of an OEM type inversion. Defaults to create and/or use
self.oem_diagnostics:Vector. [OUT]lm_ga_history (Vector) – The series of gamma values for a Marquardt-levenberg inversion. Defaults to create and/or use
self.lm_ga_history:Vector. [OUT]errors (ArrayOfString) – Errors encountered during OEM execution. Defaults to create and/or use
self.errors:ArrayOfString. [OUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]model_state_vec_apriori (Vector, optional) – An apriori state vector of the model. See
model_state_vec_apriori, defaults toself.model_state_vec_apriori[IN]model_state_covmat (CovarianceMatrix, optional) – Covariance matrix of a priori distribution. See
model_state_covmat, defaults toself.model_state_covmat[IN]measurement_vec (Vector, optional) – The measurment vector for, e.g., a sensor. See
measurement_vec, defaults toself.measurement_vec[IN]measurement_vec_error_covmat (CovarianceMatrix, optional) – Covariance matrix for observation uncertainties. See
measurement_vec_error_covmat, defaults toself.measurement_vec_error_covmat[IN]inversion_iterate_agenda (Agenda, optional) – Work in progress … See
inversion_iterate_agenda, defaults toself.inversion_iterate_agenda[IN]method (String) – Iteration method. For this and all options below, see further above. [IN]
max_start_cost (Numeric, optional) – Maximum allowed value of cost function at start. Defaults to
inf[IN]model_state_covmat_normalization (Vector, optional) – Normalisation of Sx. Defaults to
[][IN]max_iter (Index, optional) – Maximum number of iterations. Defaults to
10[IN]stop_dx (Numeric, optional) – Stop criterion for iterative inversions. Defaults to
0.01[IN]lm_ga_settings (Vector, optional) – Settings associated with the ga factor of the LM method. Defaults to
[][IN]clear_matrices (Index, optional) – An option to save memory. Defaults to
0[IN]display_progress (Index, optional) – Flag to control if inversion diagnostics shall be printed on the screen. Defaults to
0[IN]
- ReadCatalogData(self, abs_predef_data: pyarts3.arts.PredefinedModelData | None = None, abs_xfit_data: pyarts3.arts.ArrayOfXsecRecord | None = None, abs_cia_data: pyarts3.arts.ArrayOfCIARecord | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None, basename: pyarts3.arts.String | None = None, ignore_missing: pyarts3.arts.Index | None = None) None
Reads split catalog data from a folder structure similar to
arts-cat-dataWraps:
abs_bandsReadSpeciesSplitCatalog()with “lines/” added tobasenameabs_cia_dataReadSpeciesSplitCatalog()with “cia/” added tobasenameabs_xfit_dataReadSpeciesSplitCatalog()with “xsec/” added tobasenameabs_predef_dataReadSpeciesSplitCatalog()with “predef/” added tobasenameandname_missing= 1
Author: Richard Larsson
- Parameters:
abs_predef_data (PredefinedModelData, optional) – This contains predefined model data. See
abs_predef_data, defaults toself.abs_predef_data[OUT]abs_xfit_data (ArrayOfXsecRecord, optional) – Fitting model coefficients for cross section species. See
abs_xfit_data, defaults toself.abs_xfit_data[OUT]abs_cia_data (ArrayOfCIARecord, optional) – HITRAN Collision-Induced Absorption (CIA) Data. See
abs_cia_data, defaults toself.abs_cia_data[OUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[OUT]abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[IN]basename (String, optional) – Absolute or relative path to the data. Defaults to
""[IN]ignore_missing (Index, optional) – Ignore missing files instead of throwing an error. Defaults to
0[IN]
- ReadXML(self, output: object | None = None, filename: pyarts3.arts.String | None = None) None
Reads a workspace variable from an XML file.
This method can read variables of any group.
If the given filename does not exist, this method will also look for files with an added .xml, .xml.gz and .gz extension.
Note
ARTS groups, including those that are not workspace groups, generally have two methods called
fromxmlandreadxmlthat you can access directly from python. It is often more convenient and better to use these methods directly instead of using this workspace method. It exists mainly for completeness and for use in agendas.Author: Oliver Lemke
- ReadXMLIndexed(self, output: object | None = None, file_index: pyarts3.arts.Index | None = None, filename: pyarts3.arts.String | None = None, digits: pyarts3.arts.Index | None = None) None
As
ReadXML(), but reads indexed file names.The variable is read from a file with name:
<filename>.<file_index>.xml.
where <file_index> is the value of
file_index.This means that
filenameshall here not include the .xml extension.Note
ARTS groups, including those that are not workspace groups, generally have two methods called
fromxmlandreadxmlthat you can access directly from python. It is often more convenient and better to use these methods directly instead of using this workspace method. It exists mainly for completeness and for use in agendas.Author: Oliver Lemke
- Parameters:
output (Any) – Workspace variable to be read. Defaults to create and/or use
self.output:Any. [OUT]file_index (Index) – Index of the file to read. [IN]
filename (String) – File name. See above. [IN]
digits (Index, optional) – Equalize the widths of all numbers by padding with zeros as necessary. 0 means no padding (default). Defaults to
0[IN]
- RetrievalAddAtmosphere(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, target: pyarts3.arts.AtmKey | pyarts3.arts.SpeciesEnum | pyarts3.arts.SpeciesIsotope | pyarts3.arts.QuantumLevelIdentifier | None = None, d: pyarts3.arts.Numeric | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Sets an atmospheric target.
This method wraps
jac_targetsAddAtmosphere()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]target (AtmKey,SpeciesEnum,SpeciesIsotope,QuantumLevelIdentifier) – The target of interest. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddErrorPolyFit(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, t: pyarts3.arts.Vector | None = None, sensor_elem: pyarts3.arts.Index | None = None, polyorder: pyarts3.arts.Index | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Set a measurement error to polynomial fit.
This is a generic error that is simply added to
measurement_vecas if\[y = y_0 + \epsilon(p_0,\; p_1,\; \cdots,\; p_n),\]where \(y\) represents
measurement_vecand \(y_0\) is the measurement vector without any errors)Order 0 means constant: \(y = y_0 + a\)
Order 1 means linear: \(y = y_0 + a + b t\)
and so on. The derivatives that are added to the
model_state_vecare those with regards to a, b, etc..Note
The rule for the
sensor_elemGIN is a bit complex. Generally, methods such asmeasurement_sensorAddSimple()will simply add a single unique frequency grid to all the differentSensorObselthat they add to themeasurement_sensor. The GINsensor_elemis 0 for the first unique frequency grid, 1 for the second, and so on. SeeArrayOfSensorObselmember methods in python for help identifying and manipulating how many unique frequency grids are available inmeasurement_sensor.This method wraps
jac_targetsAddErrorPolyFit()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]t (Vector) – The grid of \(y\). As \(t\) above. [IN]
sensor_elem (Index) – The sensor element whose frequency grid to use. [IN]
polyorder (Index, optional) – The order of the polynomial fit. Maximum \(n\) above. Defaults to
0[IN]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddMagneticField(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, component: pyarts3.arts.String | None = None, d: pyarts3.arts.Numeric | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Set magnetic field derivative.
See
FieldComponentfor validcomponent.This method wraps
jac_targetsAddMagneticField()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]component (String) – The component to use [u, v, w]. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddOverlappingMagneticField(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Set magnetic field derivative for overlapping fields.
An overlapping field means that the derivative is computed but that the x-component of the jacobian is at the same position as another Jacobian target.
The reason for this method is that it allows representing the (signed) absolute magnetic field derivative as a combination of the three magnetic field components.
To call this method, you first have added 1 component of the magnetic field derivative, and then you call this method to add the second and third component.
This method wraps
jac_targetsAddOverlappingMagneticField()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddOverlappingWindField(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Set wind field derivative for overlapping fields.
An overlapping field means that the derivative is computed but that the x-component of the jacobian is at the same position as another Jacobian target.
The reason for this method is that it allows representing the (signed) absolute wind speed derivative as a combination of the three wind field components.
To call this method, you first have added 1 component of the wind field derivative, and then you call this method to add the second and third component.
This method wraps
jac_targetsAddOverlappingWindField()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddPressure(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, d: pyarts3.arts.Numeric | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Set pressure derivative.
This method wraps
jac_targetsAddPressure()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddSensorFrequencyPolyOffset(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, d: pyarts3.arts.Numeric | None = None, sensor_elem: pyarts3.arts.Index | None = None, polyorder: pyarts3.arts.Index | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Set sensor frequency derivative to use polynomial fitting offset
Order 0 means constant: \(f := f_0 + a\)
Order 1 means linear: \(f := f_0 + a + b f_0\)
and so on. The derivatives that are added to the
model_state_vecare those with regards to a, b, etc..Note
The rule for the
sensor_elemGIN is a bit complex. Generally, methods such asmeasurement_sensorAddSimple()will simply add a single unique frequency grid to all the differentSensorObselthat they add to themeasurement_sensor. The GINsensor_elemis 0 for the first unique frequency grid, 1 for the second, and so on. SeeArrayOfSensorObselmember methods in python for help identifying and manipulating how many unique frequency grids are available inmeasurement_sensor.This method wraps
jac_targetsAddSensorFrequencyPolyOffset()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]sensor_elem (Index) – The sensor element whose frequency grid to use. [IN]
polyorder (Index, optional) – The order of the polynomial fit. Defaults to
0[IN]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddSpeciesIsotopologueRatio(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, species: pyarts3.arts.SpeciesIsotope | None = None, d: pyarts3.arts.Numeric | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Set isotopologue ratio derivative
See
SpeciesIsotopefor validspeciesThis method wraps
jac_targetsAddSpeciesIsotopologueRatio()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]species (SpeciesIsotope) – The species isotopologue of interest. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddSpeciesVMR(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, species: pyarts3.arts.SpeciesEnum | None = None, d: pyarts3.arts.Numeric | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Set volume mixing ratio derivative.
See
SpeciesEnumfor validspeciesThis method wraps
jac_targetsAddSpeciesVMR()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]species (SpeciesEnum) – The species of interest. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddSubsurface(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, target: pyarts3.arts.SubsurfaceKey | pyarts3.arts.SubsurfacePropertyTag | None = None, d: pyarts3.arts.Numeric | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Sets a subsurface target
This method wraps
jac_targetsAddSubsurface()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]target (SubsurfaceKey,SubsurfacePropertyTag) – The target of interest. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddSurface(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, target: pyarts3.arts.SurfaceKey | pyarts3.arts.SurfacePropertyTag | None = None, d: pyarts3.arts.Numeric | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Sets a surface target
This method wraps
jac_targetsAddSurface()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]target (SurfaceKey,SurfacePropertyTag) – The target of interest. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddTemperature(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, d: pyarts3.arts.Numeric | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Set temperature derivative.
This method wraps
jac_targetsAddTemperature()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalAddWindField(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, component: pyarts3.arts.String | None = None, d: pyarts3.arts.Numeric | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Set wind field derivative.
Note that the derivatives from methods that takes the freqeuncy will return their derivatives as if these were frequency derivatives.
See
FieldComponentfor validcomponentThis method wraps
jac_targetsAddWindField()together with adding the covariance matrices, to thecovmat_diagonal_blocks, which are required to performOEM().The input covariance matrices must fit the size of the later computed model state represented by the
jac_targets. The covariance matrix inverseAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[INOUT]component (String) – The component to use [u, v, w]. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]matrix (BlockMatrix) – The covariance diagonal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagonal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- RetrievalFinalizeDiagonal(self, model_state_covmat: pyarts3.arts.CovarianceMatrix | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None) None
Finalize the retrieval setup.
See
jac_targetsFinalize()for more information.Author: Richard Larsson
- Parameters:
model_state_covmat (CovarianceMatrix, optional) – Covariance matrix of a priori distribution. See
model_state_covmat, defaults toself.model_state_covmat[OUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]
- RetrievalInit(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, model_state_covmat: pyarts3.arts.CovarianceMatrix | None = None, covmat_diagonal_blocks: pyarts3.arts.JacobianTargetsDiagonalCovarianceMatrixMap | None = None) None
Initialize the retrieval setup.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[OUT]model_state_covmat (CovarianceMatrix, optional) – Covariance matrix of a priori distribution. See
model_state_covmat, defaults toself.model_state_covmat[OUT]covmat_diagonal_blocks (JacobianTargetsDiagonalCovarianceMatrixMap, optional) – A helper map for setting the covariance matrix. See
covmat_diagonal_blocks, defaults toself.covmat_diagonal_blocks[OUT]
- SpectralFluxDisort(self, spectral_flux_field_up: pyarts3.arts.Matrix | None = None, spectral_flux_field_down: pyarts3.arts.Matrix | None = None, disort_spectral_flux_field: pyarts3.arts.DisortFlux | None = None) None
Integrate Disort spectral radiance.
Author: Richard Larsson
- Parameters:
spectral_flux_field_up (Matrix) – Upward spectral flux field. Defaults to create and/or use
self.spectral_flux_field_up:Matrix. [OUT]spectral_flux_field_down (Matrix) – Downward spectral flux field. Defaults to create and/or use
self.spectral_flux_field_down:Matrix. [OUT]disort_spectral_flux_field (DisortFlux, optional) – The spectral flux field from Disort. See
disort_spectral_flux_field, defaults toself.disort_spectral_flux_field[IN]
- Touch(self, input: object | None = None) None
As
Ignore()but for agenda output.This method is handy for use in agendas in order to suppress warnings about not-produced output workspace variables.
What it does, in case the variable is initialized already, is: Nothing! In case the variable is not yet initialized, it is default initialized.
Author: Oliver Lemke
- UpdateModelStates(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, atm_field: pyarts3.arts.AtmField | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, model_state_vec: pyarts3.arts.Vector | None = None) None
Update state of the model in preparation for a forward model run
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.abs_bandsFromModelState() 6 ws.surf_fieldFromModelState() 7 ws.subsurf_fieldFromModelState() 8 ws.atm_fieldFromModelState() 9 ws.measurement_sensorFromModelState()
Author: Richard Larsson
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[INOUT]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[INOUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[INOUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]
- WignerInit(self, fast_wigner_stored_symbols: pyarts3.arts.Index | None = None, largest_wigner_symbol_parameter: pyarts3.arts.Index | None = None, symbol_type: pyarts3.arts.Index | None = None) None
Initialize the Wigner tables
The default values take about 1 Gb memory.
The static data is kept in an external library and is therefore only available inside ARTS. Nevertheless, this must be set by the application because any default value might be too small or too large for the needs of any one application.
We rely on the Wigner library by Johansson and Forssén [11]. This method allows mimicking the initialization of that library.
Tip
If you are starved for memory, you can call
WignerUnload()after you are done with all Wigner calculations. This will free the memory.Author: Richard Larsson
- Parameters:
fast_wigner_stored_symbols (Index, optional) – Number of stored symbols possible before replacements. Defaults to
20000000[IN]largest_wigner_symbol_parameter (Index, optional) – Largest symbol used for initializing factorials (e.g., largest J or L). Defaults to
250[IN]symbol_type (Index, optional) – Type of symbol (3 or 6). Defaults to
6[IN]
- WignerUnload(self) None
Unloads the Wigner tables from static data (see
WignerInit())Author: Richard Larsson
- WriteBuiltinPartitionFunctionsXML(self, output_file_format: pyarts3.arts.String | None = None, dir: pyarts3.arts.String | None = None, Tlow: pyarts3.arts.Numeric | None = None, Tupp: pyarts3.arts.Numeric | None = None, N: pyarts3.arts.Index | None = None) None
Writes all the builtin partition functions to file.
All available partition functions are written to files in the select format in the select directory
The temperature will be linearly spaced between [Tlow, Tupp] with N values
See
FileTypefor validoutput_file_format.Author: Richard Larsson
- Parameters:
- WriteXML(self, output_file_format: pyarts3.arts.String | None = None, input: object | None = None, filename: pyarts3.arts.String | None = None, no_clobber: pyarts3.arts.Index | None = None) None
Writes a workspace variable to an XML file.
This method can write variables of any group.
If no_clobber is set to 1, an increasing number will be appended to the filename if the file already exists.
See
FileTypefor validoutput_file_format.Note
ARTS groups, including those that are not workspace groups, generally have a method called
savexmlthat you can access directly from python. It is often more convenient and better to use this method directly instead of using this workspace method. It exists mainly for completeness and for use in agendas.Author: Oliver Lemke
- WriteXMLIndexed(self, output_file_format: pyarts3.arts.String | None = None, file_index: pyarts3.arts.Index | None = None, input: object | None = None, filename: pyarts3.arts.String | None = None, digits: pyarts3.arts.Index | None = None) None
As
WriteXML(), but creates indexed file names.The variable is written to a file with name:
<filename>.<file_index>.xml.
where <file_index> is the value of
file_index.This means that
filenameshall here not include the .xml extension.See
FileTypefor validoutput_file_format.Note
ARTS groups, including those that are not workspace groups, generally have a method called
savexmlthat you can access directly from python. It is often more convenient and better to use this method directly instead of using this workspace method. It exists mainly for completeness and for use in agendas.Author: Patrick Eriksson, Oliver Lemke
- Parameters:
output_file_format (String, optional) – The format of the output. Defaults to
"ascii"[IN]file_index (Index) – Index number for files. [IN]
input (Any) – Workspace variable to be saved. [IN]
filename (String) – File name. See above. [IN]
digits (Index, optional) – Equalize the widths of all numbers by padding with zeros as necessary. 0 means no padding (default). Defaults to
0[IN]
- abs_bandsFromModelState(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, model_state_vec: pyarts3.arts.Vector | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets
abs_bandsto the state of the model.Author: Richard Larsson
Used by wrapper method
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[INOUT]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- abs_bandsKeepID(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, id: pyarts3.arts.QuantumIdentifier | None = None, line: pyarts3.arts.Index | None = None) None
Keeps first band of ID
If
lineis positive, also keep only the line of this indexAuthor: Richard Larsson
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[INOUT]id (QuantumIdentifier) – Band to keep. [IN]
line (Index, optional) – Line to keep (if positive). Defaults to
-1[IN]
- abs_bandsLineMixingAdaptation(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, temperatures: pyarts3.arts.AscendingGrid | None = None, band_key: pyarts3.arts.QuantumIdentifier | None = None, rosenkranz_fit_order: pyarts3.arts.Index | None = None, polynomial_fit_degree: pyarts3.arts.Index | None = None) None
Adapts select band to use ordered Line mixing coefficients.
This is an experimental feature and might not work.
The computations of line mixing are done on the grid of temperatures provided.
Author: Richard Larsson
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[INOUT]abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]temperatures (AscendingGrid) – The temperatures to use for the internal fitting. [IN]
band_key (QuantumIdentifier) – The band to adapt. [IN]
rosenkranz_fit_order (Index, optional) – The degree of Rosenkranz coefficients (1 for just fitting y, 2 for fitting also g and dv). Defaults to
1[IN]polynomial_fit_degree (Index, optional) – The highest order of the polynomial fit (2 means square, 3 means cubic, etc). Defaults to
3[IN]
- abs_bandsReadHITRAN(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, file: pyarts3.arts.String | None = None, frequency_range: pyarts3.arts.Vector2 | None = None, line_strength_option: pyarts3.arts.String | None = None, compute_zeeman_parameters: pyarts3.arts.Index | None = None) None
Reads HITRAN data from a file.
The HITRAN file is assumed sorted in frequency, with each line record filling up one line of text.
If the full 160-char line record is consumed without reaching the end of the line, qns’ and qns’’ are assumed appended with default HITRANonline format.
You may pass an inclusive frequency range to limit what is read. This will limit the data read to the range [fmin, fmax]. All data before fmin is limited to parsing just up until the frequency, and the database is returned if the fmax frequency is exceeded.
The optional parameter
einstein_coefficientis used to indicate if it is to be computed from the line strength, or simply read from the Hitran data.Warning
Several HITRAN lines has Einstein coefficients that will not reproduce the results of pure line strength simulations. If the option is set to read the Einstein coefficicent (“A”) instead of computing it (“S”) the program will throw an error if missing data is encountered.
Note
For the computed Einstein coefficients, if the upper degeneracy is missing, it will be set to either - (2J+1) or -1 if J is not a local quantum number. Note that this will also make the Einstein coefficient negative. This should not affect the simulation, but it is a warning that the data is not complete.
Author: Richard Larsson
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[OUT]file (String) – Filename. [IN]
frequency_range (Vector2, optional) – Frequency range selection. Defaults to
-inf inf[IN]line_strength_option (String, optional) – Whether the Hitran line strenght or the Hitran Einstein coefficient is used, the latter has historically been less reliable. Defaults to
"S"[IN]compute_zeeman_parameters (Index, optional) – Compute the Zeeman parameters from the HITRAN data (will not activate Zeeman calculations, this must be done manually afterwards). Defaults to
1[IN]
- abs_bandsReadSpeciesSplitARTSCAT(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None, basename: pyarts3.arts.String | None = None, ignore_missing: pyarts3.arts.Index | None = None, pure_species: pyarts3.arts.Index | None = None) None
Same as
abs_bandsReadSpeciesSplitCatalog()but for reading the old ARTSCAT format.One key difference is that ARTSCAT were often stored in a single file per
SpeciesEnumrather than perSpeciesIsotope, so the optional argumentpure_speciesis available and evaluates to true by default to useSpeciesEnum. Switch this off to use theSpeciesIsotopeinstead.Note that ARTSCAT does not support many of the features of the modern line catalog format. This reading routine is intended for use-as-is of the produced
abs_bands. Or after minor changes, like removing absorption lines outside of some frequency span.Author: Richard Larsson
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[OUT]abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[IN]basename (String) – Absolute or relative path to the directory. [IN]
ignore_missing (Index, optional) – Flag to ignore missing files instead of throwing an error. Defaults to
0[IN]pure_species (Index, optional) – Flag that when true uses
SpeciesEnuminstead ofSpeciesIsotopefor file names. Defaults to1[IN]
- abs_bandsReadSpeciesSplitCatalog(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None, basename: pyarts3.arts.String | None = None, ignore_missing: pyarts3.arts.Index | None = None) None
Reads all species in
abs_speciesfrom a basenamebasename follows the standard ARTS rules. For example if
abs_speciescontains onlyH2O-161, then a basename of"lbl"will read the file"lbl.H2O-161.xml", and a basename of"lbl/"will read the file"lbl/H2O-161.xml".ignore_missing is a boolean that indicates if the method should ignore missing files or not. If set to true, the method will ignore missing files and continue. If set to false, the method will throw an error if any file is missing.
Author: Richard Larsson
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[OUT]abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[IN]basename (String) – Absolute or relative path to the directory. [IN]
ignore_missing (Index, optional) – Ignore missing files instead of throwing an error. Defaults to
0[IN]
- abs_bandsReadSplit(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, dir: pyarts3.arts.String | None = None) None
Reads all xml-files in a given directory and puts them into
abs_bands.Note
The
dirpath has to be absolute or relative to the working path, the environment variables are not consideredAuthor: Richard Larsson
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[OUT]dir (String) – Absolute or relative path to the directory. [IN]
- abs_bandsSaveSplit(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, dir: pyarts3.arts.String | None = None) None
Saves all bands in
abs_bandsto a directoryThis will create the directory if it does not exist. It will also create subdirectories that are the short-form of the isotopologue names. The bands will be stored as H2O-161.xml, H2O-162.xml, O2-66.xml, and so on
The
dirpath has to be absolute or relative to the working path, the environment variables are not consideredAuthor: Richard Larsson
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]dir (String) – Absolute or relative path to the directory. [IN]
- abs_bandsSelectFrequencyByBand(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, fmin: pyarts3.arts.Numeric | None = None, fmax: pyarts3.arts.Numeric | None = None) None
Remove all bands whose lines all strictly falls outside a frequency range
Authors: Richard Larsson, Oliver Lemke
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[INOUT]fmin (Numeric, optional) – Minimum frequency to keep. Defaults to
-inf[IN]fmax (Numeric, optional) – Maximum frequency to keep. Defaults to
inf[IN]
- abs_bandsSelectFrequencyByLine(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, fmin: pyarts3.arts.Numeric | None = None, fmax: pyarts3.arts.Numeric | None = None) None
Remove all lines that strictly falls outside a frequency range
Also remove bands whose lines are all removed.
Authors: Richard Larsson, Oliver Lemke
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[INOUT]fmin (Numeric, optional) – Minimum frequency to keep. Defaults to
-inf[IN]fmax (Numeric, optional) – Maximum frequency to keep. Defaults to
inf[IN]
- abs_bandsSetNonLTE(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None) None
Set all bands to use non-LTE calculations.
Author: Richard Larsson
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[INOUT]
- abs_bandsSetZeeman(self, abs_bands: pyarts3.arts.AbsorptionBands | None = None, species: pyarts3.arts.SpeciesIsotope | None = None, fmin: pyarts3.arts.Numeric | None = None, fmax: pyarts3.arts.Numeric | None = None, on: pyarts3.arts.Index | None = None) None
Set the Zeeman splitting for lines within the frequency range
See
SpeciesIsotopefor validspeciesAuthor: Richard Larsson
- Parameters:
abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[INOUT]species (SpeciesIsotope) – Isotopologue of the species. [IN]
fmin (Numeric) – Minimum line frequency to set Zeeman splitting for. [IN]
fmax (Numeric) – Maximum line frequency to set Zeeman splitting for. [IN]
on (Index, optional) – On or off. Defaults to
1[IN]
- abs_cia_dataReadFromCIA(self, abs_cia_data: pyarts3.arts.ArrayOfCIARecord | None = None, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None, catalogpath: pyarts3.arts.String | None = None) None
Read data from a CIA data file for all CIA molecules defined in
abs_species.The units in the HITRAN file are:
Frequency: \(\textrm{cm}^{-1}\)
Binary absorption cross-section: \(\textrm{cm}^{5} \, \textrm{molec}^{-2}\)
Upon reading we convert this to the ARTS internal SI units of Hz and \(\textrm{m}^{5} \, \textrm{molec}^{-2}\).
Author: Oliver Lemke
- Parameters:
abs_cia_data (ArrayOfCIARecord, optional) – HITRAN Collision-Induced Absorption (CIA) Data. See
abs_cia_data, defaults toself.abs_cia_data[OUT]abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[IN]catalogpath (String) – Path to the CIA catalog directory. [IN]
- abs_cia_dataReadFromXML(self, abs_cia_data: pyarts3.arts.ArrayOfCIARecord | None = None, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None, filename: pyarts3.arts.String | None = None) None
Read data from a CIA XML file and check that all CIA tags defined in
abs_speciesare present in the file.The units of the data are described in
abs_cia_dataReadFromCIA().Author: Oliver Lemke
- Parameters:
abs_cia_data (ArrayOfCIARecord, optional) – HITRAN Collision-Induced Absorption (CIA) Data. See
abs_cia_data, defaults toself.abs_cia_data[OUT]abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[IN]filename (String, optional) – Name of the XML file. Defaults to
""[IN]
- abs_cia_dataReadSpeciesSplitCatalog(self, abs_cia_data: pyarts3.arts.ArrayOfCIARecord | None = None, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None, basename: pyarts3.arts.String | None = None, ignore_missing: pyarts3.arts.Index | None = None) None
Reads a species split CIA dataset.
The file names are expected to be of the form:
<basename><Spec1>-CIA-<Spec2>.xml
where <Spec1> and <Spec2> are the
SpeciesEnumnames of the two species involved in the CIA.Tip
A common and perhaps more convenient alternative to this method is
ReadCatalogData().If you have downloaded the ARTS catalog data -
arts-cat-data- and set the environment variableARTS_DATA_PATHto point to the location of this data, you can use that method to automagically read the data more easily than calling this method directly.Author: Richard Larsson
- Parameters:
abs_cia_data (ArrayOfCIARecord, optional) – HITRAN Collision-Induced Absorption (CIA) Data. See
abs_cia_data, defaults toself.abs_cia_data[OUT]abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[IN]basename (String) – The path to the split catalog files. [IN]
ignore_missing (Index, optional) – Flag to continue in case nothing is found [0 throws, 1 continues]. Defaults to
0[IN]
- abs_ecs_dataAddMakarov2020(self, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None) None
Sets the O2-66 microwave band data for ECS.
This is based on the work of Makarov et al. [18].
Author: Richard Larsson
- Parameters:
abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[INOUT]
- abs_ecs_dataAddMeanAir(self, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None, vmrs: pyarts3.arts.Vector | None = None, species: pyarts3.arts.ArrayOfSpeciesEnum | None = None) None
Sets ECS data for air from other data if available.
Author: Richard Larsson
- Parameters:
abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[INOUT]vmrs (Vector) – VMRs of air species. [IN]
species (ArrayOfSpeciesEnum) – Air species. [IN]
- abs_ecs_dataAddRodrigues1997(self, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None) None
Sets the CO2-626, CO2-628, and CO2-636 band data for ECS.
Sets N2 and O2 species.
This is based on the work of Rodrigues et al. [28].
Author: Richard Larsson
- Parameters:
abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[INOUT]
- abs_ecs_dataAddTran2011(self, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None) None
Sets the CO2-626, CO2-628, and CO2-636 band data for ECS.
Sets CO2 species.
This is based on the work of Tran et al. [35].
Author: Richard Larsson
- Parameters:
abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[INOUT]
- abs_ecs_dataInit(self, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None) None
Resets/initializes the ECS data.
Author: Richard Larsson
- Parameters:
abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[OUT]
- abs_lookup_dataCalc(self, abs_lookup_data: pyarts3.arts.AbsorptionLookupTables | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None, alt_grid: pyarts3.arts.AscendingGrid | None = None, atm_field: pyarts3.arts.AtmField | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, water_perturbation: pyarts3.arts.AscendingGrid | None = None, water_affected_species: pyarts3.arts.ArrayOfSpeciesEnum | None = None, temperature_perturbation: pyarts3.arts.AscendingGrid | None = None) None
Get
abs_lookup_datafrom available data.This method will use the
atm_fieldandabs_bandsto calculate theabs_lookup_data. The atmospheric field is first gridded usingatm_profileExtract().Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.atm_profileExtract() 6 ws.abs_lookup_dataInit() 7 ws.abs_lookup_dataPrecomputeAll()
Author: Richard Larsson
- Parameters:
abs_lookup_data (AbsorptionLookupTables, optional) – Absorption lookup table for scalar gas absorption coefficients. See
abs_lookup_data, defaults toself.abs_lookup_data[OUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[IN]alt_grid (AscendingGrid, optional) – An ascending list of
alt. Often related to a field or a profile. Seealt_grid, defaults toself.alt_grid[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]water_perturbation (AscendingGrid, optional) – Water vapor perturbation to use for the lookup table. Defaults to
pyarts3.arts.AscendingGrid()[IN]water_affected_species (ArrayOfSpeciesEnum, optional) – A list of absorption species that are affected by water vapor perturbations nonlinearly. Defaults to
[][IN]temperature_perturbation (AscendingGrid, optional) – Temperature perturbation to use for the lookup table. Defaults to
pyarts3.arts.AscendingGrid()[IN]
- abs_lookup_dataFromProfiles(self, abs_lookup_data: pyarts3.arts.AbsorptionLookupTables | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None, pressure_profile: pyarts3.arts.DescendingGrid | None = None, temperature_profile: pyarts3.arts.Vector | None = None, vmr_profiles: pyarts3.arts.SpeciesEnumVectors | None = None, temperature_perturbation: pyarts3.arts.AscendingGrid | None = None, water_perturbation: pyarts3.arts.AscendingGrid | None = None, water_affected_species: pyarts3.arts.ArrayOfSpeciesEnum | None = None, default_isotopologue_ratios: pyarts3.arts.String | None = None) None
Compute the lookup table for all species in
abs_bands.Wraps
abs_lookup_dataPrecomputeAll()after creating a simpleatm_pathfrom the input data.Unlike
abs_lookup_dataPrecomputeAll(), this method will initializeabs_lookup_dataAuthor: Richard Larsson
- Parameters:
abs_lookup_data (AbsorptionLookupTables, optional) – Absorption lookup table for scalar gas absorption coefficients. See
abs_lookup_data, defaults toself.abs_lookup_data[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[IN]pressure_profile (DescendingGrid) – Pressure profile [Pa]. [IN]
temperature_profile (Vector) – Temperature profile [K]. [IN]
vmr_profiles (SpeciesEnumVectors) – Volume mixing ratio profiles {SpeciesEnum: [VMR]}. [IN]
temperature_perturbation (AscendingGrid, optional) – Temperature perturbation to use for the lookup table. Defaults to
pyarts3.arts.AscendingGrid()[IN]water_perturbation (AscendingGrid, optional) – Water vapor perturbation to use for the lookup table. Defaults to
pyarts3.arts.AscendingGrid()[IN]water_affected_species (ArrayOfSpeciesEnum, optional) – A list of absorption species that are affected by water vapor perturbations nonlinearly. Defaults to
[][IN]default_isotopologue_ratios (String, optional) – Default isotopologue ratio option to initialize the
AtmPointwith. Defaults to"Builtin"[IN]
- abs_lookup_dataInit(self, abs_lookup_data: pyarts3.arts.AbsorptionLookupTables | None = None) None
Initialize an empty lookup table.
Author: Richard Larsson
Used by wrapper method
- Parameters:
abs_lookup_data (AbsorptionLookupTables, optional) – Absorption lookup table for scalar gas absorption coefficients. See
abs_lookup_data, defaults toself.abs_lookup_data[OUT]
- abs_lookup_dataPrecompute(self, abs_lookup_data: pyarts3.arts.AbsorptionLookupTables | None = None, atm_profile: pyarts3.arts.ArrayOfAtmPoint | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, temperature_perturbation: pyarts3.arts.AscendingGrid | None = None, water_perturbation: pyarts3.arts.AscendingGrid | None = None) None
Precompute the lookup table for a single species, adding it to the map.
Author: Richard Larsson
- Parameters:
abs_lookup_data (AbsorptionLookupTables, optional) – Absorption lookup table for scalar gas absorption coefficients. See
abs_lookup_data, defaults toself.abs_lookup_data[INOUT]atm_profile (ArrayOfAtmPoint, optional) – An atmospheric profile in ARTS. See
atm_profile, defaults toself.atm_profile[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[IN]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]temperature_perturbation (AscendingGrid, optional) – Temperature perturbation to use for the lookup table. Defaults to
pyarts3.arts.AscendingGrid()[IN]water_perturbation (AscendingGrid, optional) – Water vapor perturbation to use for the lookup table (makes the species nonlinear). Defaults to
pyarts3.arts.AscendingGrid()[IN]
- abs_lookup_dataPrecomputeAll(self, abs_lookup_data: pyarts3.arts.AbsorptionLookupTables | None = None, atm_profile: pyarts3.arts.ArrayOfAtmPoint | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None, temperature_perturbation: pyarts3.arts.AscendingGrid | None = None, water_perturbation: pyarts3.arts.AscendingGrid | None = None, water_affected_species: pyarts3.arts.ArrayOfSpeciesEnum | None = None) None
Compute the lookup table for all species in
abs_bands.Wraps
abs_lookup_dataPrecompute()for each species, passingwater_perturbationalong for those species that arewater_affected_species.Author: Richard Larsson
Used by wrapper method
- Parameters:
abs_lookup_data (AbsorptionLookupTables, optional) – Absorption lookup table for scalar gas absorption coefficients. See
abs_lookup_data, defaults toself.abs_lookup_data[INOUT]atm_profile (ArrayOfAtmPoint, optional) – An atmospheric profile in ARTS. See
atm_profile, defaults toself.atm_profile[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[IN]temperature_perturbation (AscendingGrid, optional) – Temperature perturbation to use for the lookup table. Defaults to
pyarts3.arts.AscendingGrid()[IN]water_perturbation (AscendingGrid, optional) – Water vapor perturbation to use for the lookup table. Defaults to
pyarts3.arts.AscendingGrid()[IN]water_affected_species (ArrayOfSpeciesEnum, optional) – A list of absorption species that are affected by water vapor perturbations nonlinearly. Defaults to
[][IN]
- abs_lookup_dataSimpleWide(self, abs_lookup_data: pyarts3.arts.AbsorptionLookupTables | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None, water_affected_species: pyarts3.arts.ArrayOfSpeciesEnum | None = None, pressure_range: pyarts3.arts.Vector2 | None = None, temperature_range: pyarts3.arts.Vector2 | None = None, water_vmr_range: pyarts3.arts.Vector2 | None = None, isoratio_option: pyarts3.arts.String | None = None, vmr_value: pyarts3.arts.Numeric | None = None, atmospheric_steps: pyarts3.arts.Index | None = None, temperature_perturbation_steps: pyarts3.arts.Index | None = None, water_vmr_perturbation_steps: pyarts3.arts.Index | None = None) None
Set up a simple wide lookup table for all species in
abs_bands.This method simply computes the profiles for Earth-like atmospheres (by defaults) and pass them into
abs_lookup_dataFromProfiles().The pressure range is set up logarithmically and all other ranges are set linearly.
Author: Richard Larsson
- Parameters:
abs_lookup_data (AbsorptionLookupTables, optional) – Absorption lookup table for scalar gas absorption coefficients. See
abs_lookup_data, defaults toself.abs_lookup_data[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[IN]water_affected_species (ArrayOfSpeciesEnum, optional) – A list of absorption species that are affected by water vapor perturbations nonlinearly. Defaults to
[][IN]pressure_range (Vector2, optional) – Pressure range to consider - in increasing order [Pa]. Defaults to
0.01 110000[IN]temperature_range (Vector2, optional) – Temperature range to consider - in increasing order [K]. Defaults to
150 350[IN]water_vmr_range (Vector2, optional) – Water VMR range to consider - in increasing order [vmr]. Defaults to
1e-04 0.15[IN]isoratio_option (String, optional) – Default isotopologue ratio option to initialize the
AtmPointwith. Defaults to"Builtin"[IN]vmr_value (Numeric, optional) – The VMR to use for the self-value broadening. Defaults to
1e-09[IN]atmospheric_steps (Index, optional) – Number of steps in the atmospheric profile. Defaults to
80[IN]temperature_perturbation_steps (Index, optional) – Number of steps in the temperature perturbation. Defaults to
15[IN]water_vmr_perturbation_steps (Index, optional) – Number of steps in the water vapor perturbation. Defaults to
15[IN]
- abs_predef_dataAddWaterMTCKD400(self, abs_predef_data: pyarts3.arts.PredefinedModelData | None = None, ref_temp: pyarts3.arts.Numeric | None = None, ref_press: pyarts3.arts.Numeric | None = None, ref_h2o_vmr: pyarts3.arts.Numeric | None = None, self_absco_ref: pyarts3.arts.Vector | None = None, for_absco_ref: pyarts3.arts.Vector | None = None, wavenumbers: pyarts3.arts.Vector | None = None, self_texp: pyarts3.arts.Vector | None = None) None
Sets the data for MT CKD 4.0 Water model
Note that the vectors must have the same length, and that wavenumbers must be growing at a constant rate. The minimum length is 4.
Note also that as this is predefined model data, the units of the values of the vectors must be as described by each vector.
This is based on the works cited here: https://hitran.org/mtckd/
Note
The method itself is implemented from scratch. Using any version of data after version 4.0 is supported by this method - all that changes are the values of the vectors.
Author: Richard Larsson
- Parameters:
abs_predef_data (PredefinedModelData, optional) – This contains predefined model data. See
abs_predef_data, defaults toself.abs_predef_data[INOUT]ref_temp (Numeric) – Reference temperature. [IN]
ref_press (Numeric) – Reference pressure. [IN]
ref_h2o_vmr (Numeric) – Reference volume mixing ratio of water. [IN]
self_absco_ref (Vector) – Self absorption [1/(cm-1 molecules/cm^2]. [IN]
for_absco_ref (Vector) – Foreign absorption [1/(cm-1 molecules/cm^2)]. [IN]
wavenumbers (Vector) – Wavenumbers [cm-1]. [IN]
self_texp (Vector) – Self temperature exponent [-]. [IN]
- abs_predef_dataInit(self, abs_predef_data: pyarts3.arts.PredefinedModelData | None = None) None
Initialize the predefined model data
Author: Richard Larsson
- Parameters:
abs_predef_data (PredefinedModelData, optional) – This contains predefined model data. See
abs_predef_data, defaults toself.abs_predef_data[OUT]
- abs_predef_dataReadSpeciesSplitCatalog(self, abs_predef_data: pyarts3.arts.PredefinedModelData | None = None, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None, basename: pyarts3.arts.String | None = None, name_missing: pyarts3.arts.Index | None = None, ignore_missing: pyarts3.arts.Index | None = None) None
Reads
abs_predef_datacatalog but only forabs_speciesThe file names are expected to be of the form:
<basename><Spec>-<Model>.xml
where <Spec> is the
SpeciesEnumnames of the species and <Model> is the model name. Seeabs_speciesSet()for more information on how to define a species with a predefined model.If
name_missingis true, missing models are set to named model, which is the most common form of a predefined model.Tip
A common and perhaps more convenient alternative to this method is
ReadCatalogData().If you have downloaded the ARTS catalog data -
arts-cat-data- and set the environment variableARTS_DATA_PATHto point to the location of this data, you can use that method to automagically read the data more easily than calling this method directly.Author: Richard Larsson
- Parameters:
abs_predef_data (PredefinedModelData, optional) – This contains predefined model data. See
abs_predef_data, defaults toself.abs_predef_data[OUT]abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[IN]basename (String) – The path to the split catalog files. [IN]
name_missing (Index, optional) – Flag to name models that are missing. Defaults to
1[IN]ignore_missing (Index, optional) – Flag to otherwise (if not name_missing is true) ignore missing models. Defaults to
0[IN]
- abs_speciesDefineAll(self, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None) None
Sets
abs_speciesto contain all species in ARTSAuthor: Richard Larsson
- Parameters:
abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[OUT]
- abs_speciesSet(self, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None, species: pyarts3.arts.ArrayOfString | None = None) None
Set
abs_speciesto the named species.The species that are defined by this method are used in various file reading routines to populate both atmosphere- and absorption-related data variables. They select what data is required,
A tag begins with a valid
SpeciesEnum. The rest of the tag is optional.There 3 single tags and 2 combinatory tags. These are named:
Joker. Example
"H2O". Selects all Normal Isotopologue of the providedSpeciesEnum.Normal Isotopologue. Example
"H2O-161". Selects a specific Normal Isotopologue.Predefined Model. Example
"H2O-PWR2022". Selects a specific Predefined Model. For more information on Predefined Models, seespectral_propmatAddPredefined().CIA. Example
"H2O-CIA-H2O". Selects collusion-induced absorption between the two species. Any twoSpeciesEnumin combination is valid. The reverse combination is also valid and unique.XFIT. Example
"H2O-XFIT". Selects using cross-section fits for the species.
Tip
We provide data to help make use of these tags in
arts-cat-data. Far from all use-cases are covered, but enough to help you get started. Seedownload_arts_cat_data()for help to download and set it up.Authors: Stefan Buehler, Richard Larsson
- Parameters:
abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[OUT]species (ArrayOfString) – Specify one String for each tag group that you want to create. Inside the String, separate the tags by commas (plus optional blanks). [IN]
Extra
Below follows a complete list of all single species tags that can be set using this method.
Isotopologue name
Type
Mass
\(g_i\)
H2OJoker
H2O-161Normal Isotopologue
18.010565
1
H2O-162Normal Isotopologue
19.01674
6
H2O-171Normal Isotopologue
19.01478
6
H2O-172Normal Isotopologue
20.020956
36
H2O-181Normal Isotopologue
20.014811
1
H2O-182Normal Isotopologue
21.020985
6
H2O-262Normal Isotopologue
20.022915
1
H2O-ForeignContCKDMT320Predefined Model
H2O-ForeignContCKDMT350Predefined Model
H2O-ForeignContCKDMT400Predefined Model
H2O-ForeignContStandardTypePredefined Model
H2O-MPM89Predefined Model
H2O-PWR2021Predefined Model
H2O-PWR2022Predefined Model
H2O-PWR98Predefined Model
H2O-SelfContCKDMT320Predefined Model
H2O-SelfContCKDMT350Predefined Model
H2O-SelfContCKDMT400Predefined Model
H2O-SelfContStandardTypePredefined Model
CO2Joker
CO2-626Normal Isotopologue
43.98983
1
CO2-627Normal Isotopologue
44.994045
6
CO2-628Normal Isotopologue
45.994076
1
CO2-636Normal Isotopologue
44.993185
2
CO2-637Normal Isotopologue
45.9974
12
CO2-638Normal Isotopologue
46.997431
2
CO2-727Normal Isotopologue
45.998262
1
CO2-737Normal Isotopologue
47.001618
2
CO2-827Normal Isotopologue
46.998291
6
CO2-828Normal Isotopologue
47.998322
1
CO2-837Normal Isotopologue
48.001646
12
CO2-838Normal Isotopologue
49.001675
2
CO2-CKDMT252Predefined Model
O3Joker
O3-666Normal Isotopologue
47.984745
1
O3-667Normal Isotopologue
48.98896
6
O3-668Normal Isotopologue
49.988991
1
O3-676Normal Isotopologue
48.98896
6
O3-686Normal Isotopologue
49.988991
1
N2OJoker
N2O-446Normal Isotopologue
44.001062
9
N2O-447Normal Isotopologue
45.005278
54
N2O-448Normal Isotopologue
46.005308
9
N2O-456Normal Isotopologue
44.998096
6
N2O-546Normal Isotopologue
44.998096
6
COJoker
CO-26Normal Isotopologue
27.994915
1
CO-27Normal Isotopologue
28.99913
6
CO-28Normal Isotopologue
29.999161
1
CO-36Normal Isotopologue
28.99827
2
CO-37Normal Isotopologue
30.002485
12
CO-38Normal Isotopologue
31.002516
2
CH4Joker
CH4-211Normal Isotopologue
16.0313
1
CH4-212Normal Isotopologue
17.037475
3
CH4-311Normal Isotopologue
17.034655
2
CH4-312Normal Isotopologue
18.04083
6
O2Joker
O2-66Normal Isotopologue
31.98983
1
O2-67Normal Isotopologue
32.994045
6
O2-68Normal Isotopologue
33.994076
1
O2-CIAfunCKDMT100Predefined Model
O2-MPM2020Predefined Model
O2-MPM89Predefined Model
O2-PWR2021Predefined Model
O2-PWR2022Predefined Model
O2-PWR98Predefined Model
O2-SelfContStandardTypePredefined Model
O2-TRE05Predefined Model
O2-v0v0CKDMT100Predefined Model
O2-v1v0CKDMT100Predefined Model
O2-visCKDMT252Predefined Model
NOJoker
NO-46Normal Isotopologue
29.997989
3
NO-48Normal Isotopologue
32.002234
3
NO-56Normal Isotopologue
30.995023
2
SO2Joker
SO2-626Normal Isotopologue
63.961901
1
SO2-628Normal Isotopologue
65.966146
1
SO2-636Normal Isotopologue
64.961286
4
SO2-646Normal Isotopologue
65.957695
1
NO2Joker
NO2-646Normal Isotopologue
45.992904
3
NO2-656Normal Isotopologue
46.989938
2
NH3Joker
NH3-4111Normal Isotopologue
17.026549
3
NH3-4112Normal Isotopologue
18
-1
NH3-5111Normal Isotopologue
18.023583
2
HNO3Joker
HNO3-146Normal Isotopologue
62.995644
6
HNO3-156Normal Isotopologue
63.99268
4
OHJoker
OH-61Normal Isotopologue
17.00274
2
OH-62Normal Isotopologue
18.008915
3
OH-81Normal Isotopologue
19.006986
2
HFJoker
HF-19Normal Isotopologue
20.006229
4
HF-29Normal Isotopologue
21.012404
6
HClJoker
HCl-15Normal Isotopologue
35.976678
8
HCl-17Normal Isotopologue
37.973729
8
HCl-25Normal Isotopologue
36.982853
12
HCl-27Normal Isotopologue
38.979904
12
HBrJoker
HBr-11Normal Isotopologue
81.924115
8
HBr-19Normal Isotopologue
79.92616
8
HBr-21Normal Isotopologue
82.930289
12
HBr-29Normal Isotopologue
80.932336
12
HIJoker
HI-17Normal Isotopologue
127.912297
12
HI-27Normal Isotopologue
128.918472
18
ClOJoker
ClO-56Normal Isotopologue
50.963768
4
ClO-76Normal Isotopologue
52.960819
4
OCSJoker
OCS-622Normal Isotopologue
59.966986
1
OCS-623Normal Isotopologue
60.966371
4
OCS-624Normal Isotopologue
61.96278
1
OCS-632Normal Isotopologue
60.970341
2
OCS-634Normal Isotopologue
62.966137
2
OCS-822Normal Isotopologue
61.971231
1
H2COJoker
H2CO-126Normal Isotopologue
30.010565
1
H2CO-128Normal Isotopologue
32.014811
1
H2CO-136Normal Isotopologue
31.01392
2
HDCOJoker
HDCO-26Normal Isotopologue
31
-1
D2COJoker
D2CO-26Normal Isotopologue
32
-1
HOClJoker
HOCl-165Normal Isotopologue
51.971593
8
HOCl-167Normal Isotopologue
53.968644
8
N2Joker
N2-44Normal Isotopologue
28.006148
1
N2-45Normal Isotopologue
29.003182
6
N2-CIAfunCKDMT252Predefined Model
N2-CIArotCKDMT252Predefined Model
N2-SelfContMPM93Predefined Model
N2-SelfContPWR2021Predefined Model
N2-SelfContStandardTypePredefined Model
HCNJoker
HCN-124Normal Isotopologue
27.010899
6
HCN-125Normal Isotopologue
28.007933
4
HCN-134Normal Isotopologue
28.014254
12
HCN-224Normal Isotopologue
28
-1
CH3ClJoker
CH3Cl-215Normal Isotopologue
49.992328
4
CH3Cl-217Normal Isotopologue
51.989379
4
H2O2Joker
H2O2-1661Normal Isotopologue
34.00548
1
C2H2Joker
C2H2-1221Normal Isotopologue
26.01565
1
C2H2-1222Normal Isotopologue
27.021825
6
C2H2-1231Normal Isotopologue
27.019005
8
C2H6Joker
C2H6-1221Normal Isotopologue
30.04695
1
C2H6-1231Normal Isotopologue
31.050305
2
PH3Joker
PH3-1111Normal Isotopologue
33.997238
2
COF2Joker
COF2-269Normal Isotopologue
65.991722
1
COF2-369Normal Isotopologue
66.995083
2
SF6Joker
SF6-29Normal Isotopologue
145.962492
1
H2SJoker
H2S-121Normal Isotopologue
33.987721
1
H2S-122Normal Isotopologue
35
-1
H2S-131Normal Isotopologue
34.987105
4
H2S-141Normal Isotopologue
35.983515
1
HCOOHJoker
HCOOH-126Normal Isotopologue
46.00548
4
HCOOH-136Normal Isotopologue
47
-1
DCOOHJoker
DCOOH-266Normal Isotopologue
47
-1
HCOODJoker
HCOOD-266Normal Isotopologue
47
-1
HO2Joker
HO2-166Normal Isotopologue
32.997655
2
OJoker
O-6Normal Isotopologue
15.994915
1
ClONO2Joker
ClONO2-5646Normal Isotopologue
96.956672
12
ClONO2-7646Normal Isotopologue
98.953723
12
NO+Joker
NO+-46Normal Isotopologue
29.997989
3
HOBrJoker
HOBr-161Normal Isotopologue
97.919027
8
HOBr-169Normal Isotopologue
95.921076
8
C2H4Joker
C2H4-221Normal Isotopologue
28.0313
1
C2H4-231Normal Isotopologue
29.034655
2
CH3OHJoker
CH3OH-2161Normal Isotopologue
32.026215
2
CH3BrJoker
CH3Br-211Normal Isotopologue
95.939764
4
CH3Br-219Normal Isotopologue
93.941811
4
CH3CNJoker
CH3CN-2124Normal Isotopologue
41.026549
3
CH3CN-2125Normal Isotopologue
42
-1
CH3CN-2134Normal Isotopologue
42
-1
CH3CN-3124Normal Isotopologue
42
-1
CH2DCNJoker
CH2DCN-224Normal Isotopologue
42
-1
CF4Joker
CF4-29Normal Isotopologue
87.993616
1
C4H2Joker
C4H2-2211Normal Isotopologue
50.01565
1
HC3NJoker
HC3N-12224Normal Isotopologue
51.010899
6
HC3N-12225Normal Isotopologue
52
-1
HC3N-12234Normal Isotopologue
52
-1
HC3N-12324Normal Isotopologue
52
-1
HC3N-13224Normal Isotopologue
52
-1
HC3N-22224Normal Isotopologue
52
-1
H2Joker
H2-11Normal Isotopologue
2.01565
1
H2-12Normal Isotopologue
3.021825
6
CSJoker
CS-22Normal Isotopologue
43.971036
1
CS-23Normal Isotopologue
44.970399
4
CS-24Normal Isotopologue
45.966787
1
CS-32Normal Isotopologue
44.974368
2
SO3Joker
SO3-26Normal Isotopologue
79.95682
1
C2N2Joker
C2N2-4224Normal Isotopologue
52.006148
1
COCl2Joker
COCl2-2655Normal Isotopologue
97.93262
1
COCl2-2657Normal Isotopologue
99.92967
16
SOJoker
SO-26Normal Isotopologue
47.966986
1
SO-28Normal Isotopologue
49.971231
1
SO-46Normal Isotopologue
49.962782
1
CS2Joker
CS2-222Normal Isotopologue
75.94414
1
CS2-223Normal Isotopologue
76.943256
4
CS2-224Normal Isotopologue
77.93994
1
CS2-232Normal Isotopologue
76.947495
2
CH3Joker
C3H4Joker
H2SO4Joker
H2SO4-126Normal Isotopologue
98
-1
HNCJoker
HNC-142Normal Isotopologue
27
-1
HNC-143Normal Isotopologue
28
-1
HNC-152Normal Isotopologue
28
-1
HNC-242Normal Isotopologue
28
-1
BrOJoker
BrO-16Normal Isotopologue
97
-1
BrO-96Normal Isotopologue
95
-1
OClOJoker
OClO-656Normal Isotopologue
67
-1
OClO-676Normal Isotopologue
69
-1
C3H8Joker
C3H8-21Normal Isotopologue
54
-1
HeJoker
He-4Normal Isotopologue
4
-1
Cl2O2Joker
Cl2O2-565Normal Isotopologue
102
-1
Cl2O2-765Normal Isotopologue
104
-1
HJoker
H-1Normal Isotopologue
1
-1
ArJoker
Ar-8Normal Isotopologue
39.948
-1
C2F6Joker
C3F8Joker
C4F10Joker
C5F12Joker
C6F14Joker
C8F18Joker
cC4F8Joker
CCl4Joker
CFC11Joker
CFC113Joker
CFC114Joker
CFC115Joker
CFC12Joker
CH2Cl2Joker
CH3CCl3Joker
CHCl3Joker
Halon1211Joker
Halon1301Joker
Halon2402Joker
HCFC141bJoker
HCFC142bJoker
HCFC22Joker
HFC125Joker
HFC134aJoker
HFC143aJoker
HFC152aJoker
HFC227eaJoker
HFC23Joker
HFC236faJoker
HFC245faJoker
HFC32Joker
HFC365mfcJoker
NF3Joker
NF3-4999Normal Isotopologue
70.998286
3
SO2F2Joker
HFC4310meeJoker
GeH4Joker
GeH4-011Normal Isotopologue
73.95555
1
GeH4-211Normal Isotopologue
75.95338
1
GeH4-311Normal Isotopologue
76.954764
10
GeH4-411Normal Isotopologue
77.952479
1
GeH4-611Normal Isotopologue
79.952703
1
CH3IJoker
CH3I-217Normal Isotopologue
141.927947
6
CH3FJoker
CH3F-219Normal Isotopologue
34.021878
2
AsH3Joker
C6H6Joker
liquidcloudJoker
liquidcloud-ELL07Predefined Model
icecloudJoker
rainJoker
free_electronsJoker
particlesJoker
unusedJoker
And in short:
H2O,H2O-161,H2O-162,H2O-171,H2O-172,H2O-181,H2O-182,H2O-262,H2O-ForeignContCKDMT320,H2O-ForeignContCKDMT350,H2O-ForeignContCKDMT400,H2O-ForeignContStandardType,H2O-MPM89,H2O-PWR2021,H2O-PWR2022,H2O-PWR98,H2O-SelfContCKDMT320,H2O-SelfContCKDMT350,H2O-SelfContCKDMT400,H2O-SelfContStandardType,CO2,CO2-626,CO2-627,CO2-628,CO2-636,CO2-637,CO2-638,CO2-727,CO2-737,CO2-827,CO2-828,CO2-837,CO2-838,CO2-CKDMT252,O3,O3-666,O3-667,O3-668,O3-676,O3-686,N2O,N2O-446,N2O-447,N2O-448,N2O-456,N2O-546,CO,CO-26,CO-27,CO-28,CO-36,CO-37,CO-38,CH4,CH4-211,CH4-212,CH4-311,CH4-312,O2,O2-66,O2-67,O2-68,O2-CIAfunCKDMT100,O2-MPM2020,O2-MPM89,O2-PWR2021,O2-PWR2022,O2-PWR98,O2-SelfContStandardType,O2-TRE05,O2-v0v0CKDMT100,O2-v1v0CKDMT100,O2-visCKDMT252,NO,NO-46,NO-48,NO-56,SO2,SO2-626,SO2-628,SO2-636,SO2-646,NO2,NO2-646,NO2-656,NH3,NH3-4111,NH3-4112,NH3-5111,HNO3,HNO3-146,HNO3-156,OH,OH-61,OH-62,OH-81,HF,HF-19,HF-29,HCl,HCl-15,HCl-17,HCl-25,HCl-27,HBr,HBr-11,HBr-19,HBr-21,HBr-29,HI,HI-17,HI-27,ClO,ClO-56,ClO-76,OCS,OCS-622,OCS-623,OCS-624,OCS-632,OCS-634,OCS-822,H2CO,H2CO-126,H2CO-128,H2CO-136,HDCO,HDCO-26,D2CO,D2CO-26,HOCl,HOCl-165,HOCl-167,N2,N2-44,N2-45,N2-CIAfunCKDMT252,N2-CIArotCKDMT252,N2-SelfContMPM93,N2-SelfContPWR2021,N2-SelfContStandardType,HCN,HCN-124,HCN-125,HCN-134,HCN-224,CH3Cl,CH3Cl-215,CH3Cl-217,H2O2,H2O2-1661,C2H2,C2H2-1221,C2H2-1222,C2H2-1231,C2H6,C2H6-1221,C2H6-1231,PH3,PH3-1111,COF2,COF2-269,COF2-369,SF6,SF6-29,H2S,H2S-121,H2S-122,H2S-131,H2S-141,HCOOH,HCOOH-126,HCOOH-136,DCOOH,DCOOH-266,HCOOD,HCOOD-266,HO2,HO2-166,O,O-6,ClONO2,ClONO2-5646,ClONO2-7646,NO+,NO+-46,HOBr,HOBr-161,HOBr-169,C2H4,C2H4-221,C2H4-231,CH3OH,CH3OH-2161,CH3Br,CH3Br-211,CH3Br-219,CH3CN,CH3CN-2124,CH3CN-2125,CH3CN-2134,CH3CN-3124,CH2DCN,CH2DCN-224,CF4,CF4-29,C4H2,C4H2-2211,HC3N,HC3N-12224,HC3N-12225,HC3N-12234,HC3N-12324,HC3N-13224,HC3N-22224,H2,H2-11,H2-12,CS,CS-22,CS-23,CS-24,CS-32,SO3,SO3-26,C2N2,C2N2-4224,COCl2,COCl2-2655,COCl2-2657,SO,SO-26,SO-28,SO-46,CS2,CS2-222,CS2-223,CS2-224,CS2-232,CH3,C3H4,H2SO4,H2SO4-126,HNC,HNC-142,HNC-143,HNC-152,HNC-242,BrO,BrO-16,BrO-96,OClO,OClO-656,OClO-676,C3H8,C3H8-21,He,He-4,Cl2O2,Cl2O2-565,Cl2O2-765,H,H-1,Ar,Ar-8,C2F6,C3F8,C4F10,C5F12,C6F14,C8F18,cC4F8,CCl4,CFC11,CFC113,CFC114,CFC115,CFC12,CH2Cl2,CH3CCl3,CHCl3,Halon1211,Halon1301,Halon2402,HCFC141b,HCFC142b,HCFC22,HFC125,HFC134a,HFC143a,HFC152a,HFC227ea,HFC23,HFC236fa,HFC245fa,HFC32,HFC365mfc,NF3,NF3-4999,SO2F2,HFC4310mee,GeH4,GeH4-011,GeH4-211,GeH4-311,GeH4-411,GeH4-611,CH3I,CH3I-217,CH3F,CH3F-219,AsH3,C6H6,liquidcloud,liquidcloud-ELL07,icecloud,rain,free_electrons,particles,unused,
- abs_xfit_dataReadSpeciesSplitCatalog(self, abs_xfit_data: pyarts3.arts.ArrayOfXsecRecord | None = None, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None, basename: pyarts3.arts.String | None = None, ignore_missing: pyarts3.arts.Index | None = None) None
Reads HITRAN Crosssection coefficients
Reads coefficient files for HITRAN Xsec species defined in
abs_species.Tip
A common and perhaps more convenient alternative to this method is
ReadCatalogData().If you have downloaded the ARTS catalog data -
arts-cat-data- and set the environment variableARTS_DATA_PATHto point to the location of this data, you can use that method to automagically read the data more easily than calling this method directly.Author: Oliver Lemke
- Parameters:
abs_xfit_data (ArrayOfXsecRecord, optional) – Fitting model coefficients for cross section species. See
abs_xfit_data, defaults toself.abs_xfit_data[OUT]abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[IN]basename (String) – Basepath to the files. [IN]
ignore_missing (Index, optional) – Ignore missing files (0: no, 1: yes). Defaults to
0[IN]
- atm_fieldAbsoluteMagneticField(self, atm_field: pyarts3.arts.AtmField | None = None) None
Set the magnetic field to use the magnitude field functional.
The input field must be a
GeodeticField3for all three parameters to call this method.The main purpose of this method is to retrieve the magnitude rather than the vector field.
Author: Richard Larsson
- atm_fieldAbsoluteWindField(self, atm_field: pyarts3.arts.AtmField | None = None) None
Set the wind field to use the magnitude field functional.
The input field must be a
GeodeticField3for all three parameters to call this method.The main purpose of this method is to retrieve the magnitude rather than the vector field.
Author: Richard Larsson
- atm_fieldAppendAuto(self, atm_field: pyarts3.arts.AtmField | None = None, basename: pyarts3.arts.String | None = None, extrapolation: pyarts3.arts.String | None = None, missing_is_zero: pyarts3.arts.Index | None = None, replace_existing: pyarts3.arts.Index | None = None, load_isot: pyarts3.arts.Index | None = None, load_nlte: pyarts3.arts.Index | None = None) None
Append data to the atmospheric field based on available absorption data.
It is recommended to use
atm_fieldRead()rather than this method directly.This method scans available data and calls (in order) the methods below if that data is available on the workspace. It is not possible to reproduce this method call by manually calling each method below because that would require defining the relevant data fields.
Wraps:
atm_fieldAppendLineSpeciesData()if the workspace containsabs_bandsatm_fieldAppendLineIsotopologueData()ifload_isotis true and if the workspace containsabs_bandsatm_fieldAppendLineLevelData()ifload_nlteis true and if the workspace containsabs_bandsatm_fieldAppendTagsSpeciesData()if the workspace containsabs_speciesatm_fieldAppendLookupTableSpeciesData()if the workspace containsabs_lookup_dataatm_fieldAppendCIASpeciesData()if the workspace containsabs_cia_dataatm_fieldAppendXsecSpeciesData()if the workspace containsabs_xfit_dataatm_fieldAppendPredefSpeciesData()if the workspace containsabs_predef_data
See these individually for more details.
Author: Richard Larsson
Used by wrapper method
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]basename (String) – The base name of the files. [IN]
extrapolation (String, optional) – The extrapolation to use. Defaults to
"Linear"[IN]missing_is_zero (Index, optional) – Whether or not to zero-out missing data. Defaults to
0[IN]replace_existing (Index, optional) – Whether or not to replace existing data. Defaults to
0[IN]load_isot (Index, optional) – Whether or not to load isotopologue data. Defaults to
0[IN]load_nlte (Index, optional) – Whether or not to load NLTE data. Defaults to
0[IN]
- atm_fieldAppendBaseData(self, atm_field: pyarts3.arts.AtmField | None = None, basename: pyarts3.arts.String | None = None, extrapolation: pyarts3.arts.String | None = None, deal_with_field_component: pyarts3.arts.String | None = None, replace_existing: pyarts3.arts.Index | None = None, allow_missing_pressure: pyarts3.arts.Index | None = None, allow_missing_temperature: pyarts3.arts.Index | None = None) None
Append base data to the atmospheric field
This will look at the valid
basenamefor files matching base data. The base data file names are of the form“<…>t.xml”
“<…>p.xml”
“<…>wind_u.xml”
“<…>wind_v.xml”
“<…>wind_w.xml”
“<…>mag_u.xml”
“<…>mag_v.xml”
“<…>mag_w.xml”
If any of these files are found, they are appended to the atmospheric field.
See
InterpolationExtrapolationfor validextrapolation.See
MissingFieldComponentErrorfor validdeal_with_field_component.The
replace_existingis used to determine if the data should be replaced if it already exists in the atmospheric field.The
allow_missing_pressureandallow_missing_temperatureare used to determine if the method should throw if the pressure or temperature is missing.Author: Richard Larsson
Used by wrapper method
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]basename (String) – The base name of the files. [IN]
extrapolation (String, optional) – The extrapolation to use. Defaults to
"Linear"[IN]deal_with_field_component (String, optional) – How to deal with the field component. Defaults to
"Throw"[IN]replace_existing (Index, optional) – Whether or not to replace existing data. Defaults to
1[IN]allow_missing_pressure (Index, optional) – Whether or not to allow missing pressure data. Defaults to
0[IN]allow_missing_temperature (Index, optional) – Whether or not to allow missing temperature data. Defaults to
0[IN]
- atm_fieldAppendCIASpeciesData(self, atm_field: pyarts3.arts.AtmField | None = None, abs_cia_data: pyarts3.arts.ArrayOfCIARecord | None = None, basename: pyarts3.arts.String | None = None, extrapolation: pyarts3.arts.String | None = None, missing_is_zero: pyarts3.arts.Index | None = None, replace_existing: pyarts3.arts.Index | None = None) None
Append species data to the atmospheric field based on collision-induced absorption data.
This will look at the valid
basenamefor files matching base data. The base data file names are of the short-name form: “species1.xml” “species2.xml” (e.g., “H2O.xml” “CO2.xml”). SeeSpeciesEnumfor valid short names.See
InterpolationExtrapolationfor validextrapolation.The
missing_is_zerosets missing data to zero.The
replace_existingis used to determine if the data should be replaced if it already exists in the atmospheric field.Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_cia_data (ArrayOfCIARecord, optional) – HITRAN Collision-Induced Absorption (CIA) Data. See
abs_cia_data, defaults toself.abs_cia_data[IN]basename (String) – The base name of the files. [IN]
extrapolation (String, optional) – The extrapolation to use. Defaults to
"Linear"[IN]missing_is_zero (Index, optional) – Whether or not to zero-out missing data. Defaults to
0[IN]replace_existing (Index, optional) – Whether or not to replace existing data. Defaults to
0[IN]
- atm_fieldAppendLineIsotopologueData(self, atm_field: pyarts3.arts.AtmField | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, basename: pyarts3.arts.String | None = None, extrapolation: pyarts3.arts.String | None = None, missing_is_zero: pyarts3.arts.Index | None = None, replace_existing: pyarts3.arts.Index | None = None) None
Append isotopologue ratio data to the atmospheric field based on line data.
This will look at the valid
basenamefor files matching base data. The base data file names are of the form: “species-n.xml” (e.g., “H2O-161.xml”). Seeabs_speciesSet()for valid isotopologue names.See
InterpolationExtrapolationfor validextrapolation.The
missing_is_zerosets missing data to zero.The
replace_existingis used to determine if the data should be replaced if it already exists in the atmospheric field.Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]basename (String) – The base name of the files. [IN]
extrapolation (String, optional) – The extrapolation to use. Defaults to
"Linear"[IN]missing_is_zero (Index, optional) – Whether or not to zero-out missing data. Defaults to
0[IN]replace_existing (Index, optional) – Whether or not to replace existing data. Defaults to
0[IN]
- atm_fieldAppendLineLevelData(self, atm_field: pyarts3.arts.AtmField | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, basename: pyarts3.arts.String | None = None, extrapolation: pyarts3.arts.String | None = None, missing_is_zero: pyarts3.arts.Index | None = None, replace_existing: pyarts3.arts.Index | None = None) None
Append NLTE data to the atmospheric field based on line data.
This will look at the valid
basenamefor files matching base data. The base data file names are of the form: “species-n QN1 N1 N1 QN2 N2 N2.xml” (e.g., “O2-66 J 1 1 N 0 0.xml”). Seeabs_speciesSet()for valid isotopologue names andQuantumLevelIdentifierfor constructing quantum numbers identifiers.See
InterpolationExtrapolationfor validextrapolation.The
missing_is_zerosets missing data to zero.The
replace_existingis used to determine if the data should be replaced if it already exists in the atmospheric field.Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]basename (String) – The base name of the files. [IN]
extrapolation (String, optional) – The extrapolation to use. Defaults to
"Linear"[IN]missing_is_zero (Index, optional) – Whether or not to zero-out missing data. Defaults to
0[IN]replace_existing (Index, optional) – Whether or not to replace existing data. Defaults to
0[IN]
- atm_fieldAppendLineSpeciesData(self, atm_field: pyarts3.arts.AtmField | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, basename: pyarts3.arts.String | None = None, extrapolation: pyarts3.arts.String | None = None, missing_is_zero: pyarts3.arts.Index | None = None, replace_existing: pyarts3.arts.Index | None = None) None
Append species data to the atmospheric field based on line data.
This will look at the valid
basenamefor files matching base data. The base data file names are of the short-name form: “species.xml” (e.g., “H2O.xml”). SeeSpeciesEnumfor valid short names.See
InterpolationExtrapolationfor validextrapolation.The
missing_is_zerosets missing data to zero.The
replace_existingis used to determine if the data should be replaced if it already exists in the atmospheric field.Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]basename (String) – The base name of the files. [IN]
extrapolation (String, optional) – The extrapolation to use. Defaults to
"Linear"[IN]missing_is_zero (Index, optional) – Whether or not to zero-out missing data. Defaults to
0[IN]replace_existing (Index, optional) – Whether or not to replace existing data. Defaults to
0[IN]
- atm_fieldAppendLookupTableSpeciesData(self, atm_field: pyarts3.arts.AtmField | None = None, abs_lookup_data: pyarts3.arts.AbsorptionLookupTables | None = None, basename: pyarts3.arts.String | None = None, extrapolation: pyarts3.arts.String | None = None, missing_is_zero: pyarts3.arts.Index | None = None, replace_existing: pyarts3.arts.Index | None = None) None
Append species data to the atmospheric field based on absorption lookup table data.
This will look at the valid
basenamefor files matching base data. The base data file names are of the short-name form: “species.xml” (e.g., “H2O.xml”). SeeSpeciesEnumfor valid short names.See
InterpolationExtrapolationfor validextrapolation.The
missing_is_zerosets missing data to zero.The
replace_existingis used to determine if the data should be replaced if it already exists in the atmospheric field.Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_lookup_data (AbsorptionLookupTables, optional) – Absorption lookup table for scalar gas absorption coefficients. See
abs_lookup_data, defaults toself.abs_lookup_data[IN]basename (String) – The base name of the files. [IN]
extrapolation (String, optional) – The extrapolation to use. Defaults to
"Linear"[IN]missing_is_zero (Index, optional) – Whether or not to zero-out missing data. Defaults to
0[IN]replace_existing (Index, optional) – Whether or not to replace existing data. Defaults to
0[IN]
- atm_fieldAppendPredefSpeciesData(self, atm_field: pyarts3.arts.AtmField | None = None, abs_predef_data: pyarts3.arts.PredefinedModelData | None = None, basename: pyarts3.arts.String | None = None, extrapolation: pyarts3.arts.String | None = None, missing_is_zero: pyarts3.arts.Index | None = None, replace_existing: pyarts3.arts.Index | None = None) None
Append species data to the atmospheric field based on absorption predefined model data.
This will look at the valid
basenamefor files matching base data. The base data file names are of the short-name form: “species-MODEL.xml” (e.g., “H2O-ForeignContCKDMT400.xml”). SeeSpeciesEnumfor valid short names. Will also append H2O VMR if available as some predefined models requires it.See
InterpolationExtrapolationfor validextrapolation.The
missing_is_zerosets missing data to zero.The
replace_existingis used to determine if the data should be replaced if it already exists in the atmospheric field.Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_predef_data (PredefinedModelData, optional) – This contains predefined model data. See
abs_predef_data, defaults toself.abs_predef_data[IN]basename (String) – The base name of the files. [IN]
extrapolation (String, optional) – The extrapolation to use. Defaults to
"Linear"[IN]missing_is_zero (Index, optional) – Whether or not to zero-out missing data. Defaults to
0[IN]replace_existing (Index, optional) – Whether or not to replace existing data. Defaults to
0[IN]
- atm_fieldAppendTagsSpeciesData(self, atm_field: pyarts3.arts.AtmField | None = None, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None, basename: pyarts3.arts.String | None = None, extrapolation: pyarts3.arts.String | None = None, missing_is_zero: pyarts3.arts.Index | None = None, replace_existing: pyarts3.arts.Index | None = None) None
Append species data to the atmospheric field based on
abs_species.This will look at the valid
basenamefor files matching base data. The base data file names are of the short-name form: “species.xml” (e.g., “H2O.xml”). SeeSpeciesEnumfor valid short names.See
InterpolationExtrapolationfor validextrapolation.The
missing_is_zerosets missing data to zero.The
replace_existingis used to determine if the data should be replaced if it already exists in the atmospheric field.Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[IN]basename (String) – The base name of the files. [IN]
extrapolation (String, optional) – The extrapolation to use. Defaults to
"Linear"[IN]missing_is_zero (Index, optional) – Whether or not to zero-out missing data. Defaults to
0[IN]replace_existing (Index, optional) – Whether or not to replace existing data. Defaults to
0[IN]
- atm_fieldAppendXsecSpeciesData(self, atm_field: pyarts3.arts.AtmField | None = None, abs_xfit_data: pyarts3.arts.ArrayOfXsecRecord | None = None, basename: pyarts3.arts.String | None = None, extrapolation: pyarts3.arts.String | None = None, missing_is_zero: pyarts3.arts.Index | None = None, replace_existing: pyarts3.arts.Index | None = None) None
Append species data to the atmospheric field based on absorption cross-section fit data.
This will look at the valid
basenamefor files matching base data. The base data file names are of the short-name form: “species.xml” (e.g., “H2O.xml”). SeeSpeciesEnumfor valid short names.See
InterpolationExtrapolationfor validextrapolation.The
missing_is_zerosets missing data to zero.The
replace_existingis used to determine if the data should be replaced if it already exists in the atmospheric field.Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_xfit_data (ArrayOfXsecRecord, optional) – Fitting model coefficients for cross section species. See
abs_xfit_data, defaults toself.abs_xfit_data[IN]basename (String) – The base name of the files. [IN]
extrapolation (String, optional) – The extrapolation to use. Defaults to
"Linear"[IN]missing_is_zero (Index, optional) – Whether or not to zero-out missing data. Defaults to
0[IN]replace_existing (Index, optional) – Whether or not to replace existing data. Defaults to
0[IN]
- atm_fieldFitNonLTE(self, atm_field: pyarts3.arts.AtmField | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, pol: pyarts3.arts.Stokvec | None = None, levels: pyarts3.arts.ArrayOfQuantumLevelIdentifier | None = None, key: pyarts3.arts.AtmKey | None = None, iteration_limit: pyarts3.arts.Index | None = None, dzen: pyarts3.arts.Numeric | None = None, convergence_limit: pyarts3.arts.Numeric | None = None, consider_limb: pyarts3.arts.Index | None = None, collision_data: pyarts3.arts.QuantumIdentifierGriddedField1Map | None = None, azi: pyarts3.arts.Numeric | None = None, altitude_extrapolation: pyarts3.arts.InterpolationExtrapolation | None = None) None
Fits non-LTE atmospheric field values
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.atm_profileFromGrid() 6 ws.atm_profileFitNonLTE() 7 ws.atm_fieldFromProfile()
Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]pol (Stokvec, optional) – The polarization selection vector (use the default unless you know what you are doing). Defaults to
1 0 0 0[IN]levels (ArrayOfQuantumLevelIdentifier) – The order of the energy levels. [IN]
key (AtmKey, optional) – Key to find the
GeodeticField3in the atmospheric field. Defaults tot[IN]iteration_limit (Index, optional) – Maximum number of iterations. Defaults to
100[IN]dzen (Numeric, optional) – The zenith angle limit for the internal call to
zen_gridProfilePseudo2D(). Defaults to5[IN]convergence_limit (Numeric, optional) – Convergence criterion for the energy level distribution. Defaults to
1e-06[IN]consider_limb (Index, optional) – Whether to add extra limb points in
zen_gridProfilePseudo2D(). Defaults to1[IN]collision_data (QuantumIdentifierGriddedField1Map) – Collision data for the transitions - for \(C_{ij}\) and \(C_{ji}\). [IN]
azi (Numeric, optional) – The azimuth of the radiation. Defaults to
0[IN]altitude_extrapolation (InterpolationExtrapolation, optional) – Extrapolation method along the altitude grid. Defaults to
Linear[IN]
- atm_fieldFromModelState(self, atm_field: pyarts3.arts.AtmField | None = None, model_state_vec: pyarts3.arts.Vector | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets
atm_fieldto the state of the model.Author: Richard Larsson
Used by wrapper method
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- atm_fieldFromProfile(self, atm_field: pyarts3.arts.AtmField | None = None, atm_profile: pyarts3.arts.ArrayOfAtmPoint | None = None, alt_grid: pyarts3.arts.AscendingGrid | None = None, altitude_extrapolation: pyarts3.arts.InterpolationExtrapolation | None = None) None
Sets the atmospheric field to be the 1D atmospheric profile.
The top of the atmosphere is the last value of the altitude grid.
All atmospheric points in the profile must contain the same set of parameters.
Author: Richard Larsson
Used by wrapper method
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[OUT]atm_profile (ArrayOfAtmPoint, optional) – An atmospheric profile in ARTS. See
atm_profile, defaults toself.atm_profile[IN]alt_grid (AscendingGrid, optional) – An ascending list of
alt. Often related to a field or a profile. Seealt_grid, defaults toself.alt_grid[IN]altitude_extrapolation (InterpolationExtrapolation, optional) – Extrapolation method along the altitude grid. Defaults to
Linear[IN]
- atm_fieldHydrostaticPressure(self, atm_field: pyarts3.arts.AtmField | None = None, gravity_operator: pyarts3.arts.NumericTernaryOperator | None = None, alt_grid: pyarts3.arts.AscendingGrid | None = None, p0: pyarts3.arts.GeodeticField2 | pyarts3.arts.Numeric | None = None, fixed_specific_gas_constant: pyarts3.arts.Numeric | None = None, fixed_atmospheric_temperature: pyarts3.arts.Numeric | None = None, hydrostatic_option: pyarts3.arts.String | None = None) None
Add the hydrostatic pressure to the atmospheric field
The field must already be able to compute temperature as a function of altitude, latitude, and longitude.
If a positive
fixed_specific_gas_constantis not provided, the field must also consist of correct volume mixing ratios so that the mass of an average molecule can be computed.The first altitude in
alt_gridis used as the altitude of thep0grid. The extrapolation outside of this range simply uses the formalism of the selecthydrostatic_option.Note
The gradient changes only at the grid points of the
alt_grid. Please make it dense enough to avoid missing features. A recommendation is to extract thealt_griddirectly from the temperature field.Also be aware that missing VMRs for important species, e.g., \(\textrm{N}_2\) or \(\textrm{O}_2\), will lead to incorrect results. The mean molecular mass need these VMRs, so if the VMRs are missing, the pressure will not be correct either.
Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]gravity_operator (NumericTernaryOperator, optional) – The gravity operator. See
gravity_operator, defaults toself.gravity_operator[IN]alt_grid (AscendingGrid, optional) – An ascending list of
alt. Often related to a field or a profile. Seealt_grid, defaults toself.alt_grid[IN]p0 (GeodeticField2,Numeric) – Lowest altitude pressure field. \(P_0\) above. [IN]
fixed_specific_gas_constant (Numeric, optional) – Specific gas constant if larger than 0. Defaults to
-1[IN]fixed_atmospheric_temperature (Numeric, optional) – Constant atmospheric temprature if larger than 0. Defaults to
-1[IN]hydrostatic_option (String, optional) – Computational option for levels. See
HydrostaticPressureOptionfor valid options. Defaults to"HydrostaticEquation"[IN]
- atm_fieldIGRF(self, atm_field: pyarts3.arts.AtmField | None = None, time: pyarts3.arts.Time | None = None) None
Use IGRF to compute the magnetic field at each point.
The IGRF model is a model of the Earth’s magnetic field. It is based on spherical harmonics and is only valid for a limited time period.
The IGRF model is available via Alken et al. [1].
Note
The IGRF model is added as a functional object to the atmospheric field. If you need to retrieve the magnetic field, you must convert it to another type, use
atm_fieldSchmidthFieldFromIGRF(), which have been designed to support retrievals of the magnetic field via Legendre coefficients, or useatm_fieldAbsoluteMagneticField(), which allow returning the magnitude of the magnetic field.Author: Richard Larsson
- atm_fieldInit(self, atm_field: pyarts3.arts.AtmField | None = None, toa: pyarts3.arts.Numeric | None = None, default_isotopologue: pyarts3.arts.String | None = None) None
Initialize the atmospheric field with some altitude and isotopologue ratios
See
IsoRatioOptionfor validdefault_isotopologue.Author: Richard Larsson
Used by wrapper method
- atm_fieldInitializeNonLTE(self, atm_field: pyarts3.arts.AtmField | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, normalization: pyarts3.arts.Numeric | None = None) None
Initialize the non-LTE atmospheric field from the LTE temperature field.
Note that the bands have to be 1-line long to work.
This is because of how non-LTE is implemented in ARTS.
Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]normalization (Numeric, optional) – Normalization factor for the non-LTE field - all species of same isotopologue will be summed to this value (non-positive means no normalization). Defaults to
0[IN]
- atm_fieldRead(self, atm_field: pyarts3.arts.AtmField | None = None, toa: pyarts3.arts.Numeric | None = None, missing_is_zero: pyarts3.arts.Index | None = None, load_nlte: pyarts3.arts.Index | None = None, load_isot: pyarts3.arts.Index | None = None, extrapolation: pyarts3.arts.String | None = None, default_isotopologue: pyarts3.arts.String | None = None, deal_with_field_component: pyarts3.arts.String | None = None, basename: pyarts3.arts.String | None = None, allow_missing_temperature: pyarts3.arts.Index | None = None, allow_missing_pressure: pyarts3.arts.Index | None = None) None
Read atmospheric data files from a directory
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.atm_fieldInit() 6 ws.atm_fieldAppendBaseData() 7 ws.atm_fieldAppendAuto()
Author: Richard Larsson
- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[OUT]toa (Numeric) – Top of atmosphere altitude [m]. [IN]
missing_is_zero (Index, optional) – Whether or not to zero-out missing data. Defaults to
0[IN]load_nlte (Index, optional) – Whether or not to load NLTE data. Defaults to
0[IN]load_isot (Index, optional) – Whether or not to load isotopologue data. Defaults to
0[IN]extrapolation (String, optional) – The extrapolation to use. Defaults to
"Linear"[IN]default_isotopologue (String, optional) – Default option for the isotopologue ratios. Defaults to
"Builtin"[IN]deal_with_field_component (String, optional) – How to deal with the field component. Defaults to
"Throw"[IN]basename (String) – The base name of the files. [IN]
allow_missing_temperature (Index, optional) – Whether or not to allow missing temperature data. Defaults to
0[IN]allow_missing_pressure (Index, optional) – Whether or not to allow missing pressure data. Defaults to
0[IN]
- atm_fieldSchmidthFieldFromIGRF(self, atm_field: pyarts3.arts.AtmField | None = None, time: pyarts3.arts.Time | None = None) None
For forward calculations, this should be similar to
atm_fieldIGRF().What it does different is that it is 1) not a direct computations matching the IGRF field, instead averaging the Legendre coefficient matrices.
What it does very different is that it supports retrievals of the magnetic field Legendre coefficients.
This is very much a WIP and not well tested.
The IGRF model is available via Alken et al. [1].
Author: Richard Larsson
- atm_pathFromPath(self, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None) None
Gets the atmospheric points along the path.
Author: Richard Larsson
Used by wrapper methods
- Parameters:
atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]
- atm_pathFromProfile(self, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None, atm_profile: pyarts3.arts.ArrayOfAtmPoint | None = None) None
Set
atm_path = atm_profile.This is purely compositional and it is better to use pure python code if need this functionality in your own control-flow.
Author: Richard Larsson
- Parameters:
atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[OUT]atm_profile (ArrayOfAtmPoint, optional) – An atmospheric profile in ARTS. See
atm_profile, defaults toself.atm_profile[IN]
- atm_pointInit(self, atm_point: pyarts3.arts.AtmPoint | None = None, default_isotopologue: pyarts3.arts.String | None = None) None
Initialize an atmospheric point with some isotopologue ratios
See
IsoRatioOptionfor validdefault_isotopologue.Author: Richard Larsson
- atm_profileExtract(self, atm_profile: pyarts3.arts.ArrayOfAtmPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, alt_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None) None
Extract an atmospheric profile from the atmospheric field.
Author: Richard Larsson
Used by wrapper method
- Parameters:
atm_profile (ArrayOfAtmPoint, optional) – An atmospheric profile in ARTS. See
atm_profile, defaults toself.atm_profile[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]alt_grid (AscendingGrid, optional) – An ascending list of
alt. Often related to a field or a profile. Seealt_grid, defaults toself.alt_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]
- atm_profileFitNonLTE(self, atm_profile: pyarts3.arts.ArrayOfAtmPoint | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, alt_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, collision_data: pyarts3.arts.QuantumIdentifierGriddedField1Map | None = None, levels: pyarts3.arts.ArrayOfQuantumLevelIdentifier | None = None, pol: pyarts3.arts.Stokvec | None = None, azi: pyarts3.arts.Numeric | None = None, dzen: pyarts3.arts.Numeric | None = None, convergence_limit: pyarts3.arts.Numeric | None = None, iteration_limit: pyarts3.arts.Index | None = None, consider_limb: pyarts3.arts.Index | None = None) None
Fits non-LTE distributions to the level data.
The spectral flux is computed from the pseudo-2D assumption.
This method fits non-LTE distributions to the level data in the atmospheric field. It only works for absorption band data that is separated by single-lines-per-band, and will produce nonsense for overlapping line data. If the lines overlap, the method will keep introducing more-and-more energy into the system, meaning that the method will not converge or turn to some extreme stable state.
The statistical equilibrium equation is given by finding valid set of energy level distribution \(n\) such that for all valid energy level combination of upper levels \(i\) and lower levels \(j\) the rate of change is zero for some \(n\) that satisfies the equation
\[\frac{d n_i}{dt} = \sum_{j > i} \left[ n_j A_{ji} - \left( n_i B_{ij} - n_j B_{ji} \right) J_{ij} \right] - \sum_{j < i} \left[ n_i A_{ij} - \left( n_j B_{ji} - n_i B_{ij} \right) J_{ij} \right] + \sum_{j} \left[ n_j C_{ji} - n_i C_{ij} \right],\]where \(A_{ij}\) is the spontaneous emission rate, \(B_{ij}\) is the stimulated emission rate, \(B_{ij}\) is the photon absorption rate, \(J_{ij}\) is the line-integrated flux, and \(C_{ij}\) is the collisional rate.
Generally, you need \(n\) to compute \(J_{ij}\), making the problem non-linear. Thus an iterative process is used to find the solution. The iteration is considered converged when the relative change in the energy level distribution is below the convergence criterion. Alternatively, the iteration is halted if the iteration count limit is breached.
The method used here is based on Yamada, T. et al. [38]
Author: Richard Larsson
Used by wrapper method
- Parameters:
atm_profile (ArrayOfAtmPoint, optional) – An atmospheric profile in ARTS. See
atm_profile, defaults toself.atm_profile[INOUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]alt_grid (AscendingGrid, optional) – An ascending list of
alt. Often related to a field or a profile. Seealt_grid, defaults toself.alt_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]collision_data (QuantumIdentifierGriddedField1Map) – Collision data for the transitions - for \(C_{ij}\) and \(C_{ji}\). [IN]
levels (ArrayOfQuantumLevelIdentifier) – The order of the energy levels. [IN]
pol (Stokvec, optional) – The polarization selection vector (use the default unless you know what you are doing). Defaults to
1 0 0 0[IN]azi (Numeric, optional) – The azimuth of the radiation. Defaults to
0[IN]dzen (Numeric, optional) – The zenith angle limit for the internal call to
zen_gridProfilePseudo2D(). Defaults to5[IN]convergence_limit (Numeric, optional) – Convergence criterion for the energy level distribution. Defaults to
1e-06[IN]iteration_limit (Index, optional) – Maximum number of iterations. Defaults to
100[IN]consider_limb (Index, optional) – Whether to add extra limb points in
zen_gridProfilePseudo2D(). Defaults to1[IN]
- atm_profileFromGrid(self, atm_profile: pyarts3.arts.ArrayOfAtmPoint | None = None, alt_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, atm_field: pyarts3.arts.AtmField | None = None, key: pyarts3.arts.AtmKey | None = None) None
Extract an atmospheric profile and its grids.
The key is used to find a
GeodeticField3in the atmospheric field. Its grids must form a profile. The profile is extracted and returned. The grids are returned as well.Author: Richard Larsson
Used by wrapper method
- Parameters:
atm_profile (ArrayOfAtmPoint, optional) – An atmospheric profile in ARTS. See
atm_profile, defaults toself.atm_profile[OUT]alt_grid (AscendingGrid, optional) – An ascending list of
alt. Often related to a field or a profile. Seealt_grid, defaults toself.alt_grid[OUT]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[OUT]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]key (AtmKey, optional) – Key to find the
GeodeticField3in the atmospheric field. Defaults tot[IN]
- disort_settingsCosmicMicrowaveBackgroundRadiation(self, disort_settings: pyarts3.arts.DisortSettings | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None) None
Space radiation into Disort is isotropic cosmic background radiation.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]
- disort_settingsDownwellingObserver(self, disort_settings: pyarts3.arts.DisortSettings | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, spectral_rad_observer_agenda: pyarts3.arts.Agenda | None = None, pol: pyarts3.arts.Stokvec | None = None) None
Set the downwelling boundary condition using the observer agenda.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]spectral_rad_observer_agenda (Agenda, optional) – Computes spectral radiance as seen from the input position and environment. See
spectral_rad_observer_agenda, defaults toself.spectral_rad_observer_agenda[IN]pol (Stokvec, optional) – The polarization state to select. The dot-product of this and
spectral_radis used. Defaults to1 0 0 0[IN]
- disort_settingsInit(self, disort_settings: pyarts3.arts.DisortSettings | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None) None
Perform Disort calculations for spectral flux.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]
- disort_settingsLayerNonThermalEmissionLinearInTau(self, disort_settings: pyarts3.arts.DisortSettings | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None, spectral_propmat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, spectral_nlte_srcvec_path: pyarts3.arts.ArrayOfStokvecVector | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None) None
Same as
disort_settingsLayerThermalEmissionLinearInTau()but considers non-LTEThis is WIP and should not be used.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]spectral_propmat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path. See
spectral_propmat_path, defaults toself.spectral_propmat_path[IN]spectral_nlte_srcvec_path (ArrayOfStokvecVector, optional) – Additional non-LTE along the propagation path. See
spectral_nlte_srcvec_path, defaults toself.spectral_nlte_srcvec_path[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]
- disort_settingsLayerThermalEmissionLinearInTau(self, disort_settings: pyarts3.arts.DisortSettings | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None) None
Use a source function that changes linearly in optical thickness.
Note that you must have set the optical thickness before calling this.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]
- disort_settingsLegendreCoefficientsFromPath(self, disort_settings: pyarts3.arts.DisortSettings | None = None, spectral_phamat_spectral_path: pyarts3.arts.ArrayOfSpecmatMatrix | None = None) None
Sets the legendre coefficients from the path-variable.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]spectral_phamat_spectral_path (ArrayOfSpecmatMatrix, optional) – The spectral phase matrix of totally random orientation particles along the propagation path using spectral representation. See
spectral_phamat_spectral_path, defaults toself.spectral_phamat_spectral_path[IN]
- disort_settingsNoFractionalScattering(self, disort_settings: pyarts3.arts.DisortSettings | None = None) None
Turns off fractional scattering in Disort calculations.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]
- disort_settingsNoLayerThermalEmission(self, disort_settings: pyarts3.arts.DisortSettings | None = None) None
Turns off source radiation in Disort calculations.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]
- disort_settingsNoLegendre(self, disort_settings: pyarts3.arts.DisortSettings | None = None) None
Turns off Legendre coefficients in Disort calculations.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]
- disort_settingsNoSingleScatteringAlbedo(self, disort_settings: pyarts3.arts.DisortSettings | None = None) None
Turns off single albedo scattering in Disort calculations.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]
- disort_settingsNoSpaceEmission(self, disort_settings: pyarts3.arts.DisortSettings | None = None) None
Turns off boundary condition from space for Disort calculations.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]
- disort_settingsNoSun(self, disort_settings: pyarts3.arts.DisortSettings | None = None) None
Turns off solar radiation in Disort calculations.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]
- disort_settingsNoSurfaceEmission(self, disort_settings: pyarts3.arts.DisortSettings | None = None) None
Turns off surface boundary condition for Disort calculations.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]
- disort_settingsNoSurfaceScattering(self, disort_settings: pyarts3.arts.DisortSettings | None = None) None
Turns off BDRF in Disort calculations.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]
- disort_settingsOpticalThicknessFromPath(self, disort_settings: pyarts3.arts.DisortSettings | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, spectral_propmat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, min_optical_depth: pyarts3.arts.Numeric | None = None) None
Get optical thickness from path.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]spectral_propmat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path. See
spectral_propmat_path, defaults toself.spectral_propmat_path[IN]min_optical_depth (Numeric, optional) – The minimum increase in optical thickness per level. The DISORT algorithm employed is numerically unstable if the change between levels is too small. Defaults to
1e-11[IN]
- disort_settingsSetSun(self, disort_settings: pyarts3.arts.DisortSettings | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, sun: pyarts3.arts.Sun | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None) None
Uses Set the FOV to the sun input for Disort calculations.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]sun (Sun, optional) – A sun. See
sun, defaults toself.sun[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]
- disort_settingsSingleScatteringAlbedoFromPath(self, disort_settings: pyarts3.arts.DisortSettings | None = None, spectral_propmat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, spectral_propmat_scat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, spectral_absvec_scat_path: pyarts3.arts.ArrayOfStokvecVector | None = None) None
Sets the single scattering albedo from the path-variable.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]spectral_propmat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path. See
spectral_propmat_path, defaults toself.spectral_propmat_path[IN]spectral_propmat_scat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path for scattering. See
spectral_propmat_scat_path, defaults toself.spectral_propmat_scat_path[IN]spectral_absvec_scat_path (ArrayOfStokvecVector, optional) – The absorption vector of totally random orientation particles along the propagation path using spectral representation. See
spectral_absvec_scat_path, defaults toself.spectral_absvec_scat_path[IN]
- disort_settingsSubsurfaceEmissionByTemperature(self, disort_settings: pyarts3.arts.DisortSettings | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, subsurf_profile: pyarts3.arts.ArrayOfSubsurfacePoint | None = None) None
Subsurface boundary emission into Disort is based on temperature.
Sets both upper and lower bounds.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]subsurf_profile (ArrayOfSubsurfacePoint, optional) – A profile of subsurface points. Supposed to be ordered from top to bottom. See
subsurf_profile, defaults toself.subsurf_profile[IN]
- disort_settingsSubsurfaceLayerThermalEmissionLinearInTau(self, disort_settings: pyarts3.arts.DisortSettings | None = None, subsurf_profile: pyarts3.arts.ArrayOfSubsurfacePoint | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None) None
Use a source function that changes linearly in optical thickness.
Note that you must have set the optical thickness before calling this.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]subsurf_profile (ArrayOfSubsurfacePoint, optional) – A profile of subsurface points. Supposed to be ordered from top to bottom. See
subsurf_profile, defaults toself.subsurf_profile[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]
- disort_settingsSubsurfaceScalarAbsorption(self, disort_settings: pyarts3.arts.DisortSettings | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, subsurf_profile: pyarts3.arts.ArrayOfSubsurfacePoint | None = None, min_optical_depth: pyarts3.arts.Numeric | None = None) None
Get optical thickness from subsurface path.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]subsurf_profile (ArrayOfSubsurfacePoint, optional) – A profile of subsurface points. Supposed to be ordered from top to bottom. See
subsurf_profile, defaults toself.subsurf_profile[IN]min_optical_depth (Numeric, optional) – The minimum increase in optical thickness per level. The DISORT algorithm employed is numerically unstable if the change between levels is too small. Defaults to
1e-11[IN]
- disort_settingsSubsurfaceScalarSingleScatteringAlbedo(self, disort_settings: pyarts3.arts.DisortSettings | None = None, subsurf_profile: pyarts3.arts.ArrayOfSubsurfacePoint | None = None) None
Turns off single albedo scattering in Disort calculations.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]subsurf_profile (ArrayOfSubsurfacePoint, optional) – A profile of subsurface points. Supposed to be ordered from top to bottom. See
subsurf_profile, defaults toself.subsurf_profile[IN]
- disort_settingsSurfaceEmissionByTemperature(self, disort_settings: pyarts3.arts.DisortSettings | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None) None
Surface radiation into Disort is isotropic from surface temperature.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]
- disort_settingsSurfaceLambertian(self, disort_settings: pyarts3.arts.DisortSettings | None = None, value: pyarts3.arts.Numeric | pyarts3.arts.Vector | None = None) None
Sets the surface to Lambertian.
Author: Richard Larsson
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[INOUT]value (Numeric,Vector) – The value of the BDRF in all directions (Numeric for constant, Vector for spectral). [IN]
- disort_settings_agendaExecute(self, disort_settings: pyarts3.arts.DisortSettings | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
disort_settings_agenda, see it for more detailsAuthor:
Automatically GeneratedUsed by wrapper methods
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- disort_settings_agendaExecuteOperator(self, disort_settings: pyarts3.arts.DisortSettings | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda_operator: pyarts3.arts.disort_settings_agendaOperator | None = None) None
Executes an operator emulating
disort_settings_agenda, see it, and alsodisort_settings_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_settings_agenda_operator (disort_settings_agendaOperator) – Operator for
disort_settings_agenda. [IN]
- disort_settings_agendaSetOperator(self, disort_settings_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.disort_settings_agendaOperator | None = None) None
Set
disort_settings_agendato exclusively use provided external operator. Seedisort_settings_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[OUT]f (disort_settings_agendaOperator) – Operator for
disort_settings_agenda. [IN]
- disort_settings_agendaSetup(self, disort_settings_agenda: pyarts3.arts.Agenda | None = None, layer_emission_setting: pyarts3.arts.String | None = None, scattering_setting: pyarts3.arts.String | None = None, space_setting: pyarts3.arts.String | None = None, sun_setting: pyarts3.arts.String | None = None, surf_setting: pyarts3.arts.String | None = None, surf_lambertian_value: pyarts3.arts.Vector | None = None, min_optical_depth: pyarts3.arts.Numeric | None = None) None
Setup for Disort standard calculations.
This method allows setting up
disort_settings_agendaby named options. A description of the options is given below.Author: Richard Larsson
- Parameters:
disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[OUT]layer_emission_setting (String, optional) – Layer emission settings. Defaults to
"LinearInTau"[IN]scattering_setting (String, optional) – Scattering settings. Defaults to
"None"[IN]space_setting (String, optional) – Space settings. Defaults to
"CosmicMicrowaveBackgroundRadiation"[IN]sun_setting (String, optional) – Sun settings. Defaults to
"None"[IN]surf_setting (String, optional) – Surface settings. Defaults to
"Thermal"[IN]surf_lambertian_value (Vector, optional) – Surface lambertian value (must be the size of the frequency grid; used only when surface is set to a Lambertian variant). Defaults to
[][IN]min_optical_depth (Numeric, optional) – The minimum increase in optical thickness per level. The DISORT algorithm employed is numerically unstable if the change between levels is too small. Defaults to
1e-11[IN]
Extra
There are 96 possible combinations for calling the
disort_settings_agendaSetupmethod.Below, these are all listed with the generated agenda-call order for each combination in full.
Before that, a concise overview of what each option do is available by the types in this table:
Input variable
pyarts class
layer_emission_settingscattering_settingspace_settingsun_settingsurf_setting
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="None", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTau", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="None", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="None", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="None", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="None", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="None", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendamin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="None", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Thermal", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="ThermalLambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
disort_settings_agendaSetup(layer_emission_setting="LinearInTauNonLTE", scattering_setting="ScatteringSpecies", space_setting="CosmicMicrowaveBackgroundRadiation", sun_setting="Sun", surf_setting="Lambertian", surf_lambertian_value=lambertian_reflection, min_optical_depth=min_optical_depth)Shares the global
atm_fieldShares the global
spectral_propmat_agendaShares the global
spectral_propmat_scat_spectral_agendaShares the global
sunShares the global
surf_fieldmin_optical_depth = min_optical_depth
value = lambertian_reflection
- disort_settings_agendaSubsurfaceSetup(self, disort_settings_agenda: pyarts3.arts.Agenda | None = None, sun_setting: pyarts3.arts.String | None = None, min_optical_depth: pyarts3.arts.Numeric | None = None, fading_bottom: pyarts3.arts.Index | None = None) None
Setup for Disort subsurface calculations.
This method allows setting up
disort_settings_agendaby named options. A description of the options is given below.Author: Richard Larsson
- Parameters:
disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[OUT]sun_setting (String, optional) – Sun settings. Defaults to
"None"[IN]min_optical_depth (Numeric, optional) – The minimum increase in optical thickness per level. The DISORT algorithm employed is numerically unstable if the change between levels is too small. Defaults to
1e-11[IN]fading_bottom (Index, optional) – If true, the bottom layer has no input from below (i.e., no emission or transmission from below). Defaults to
1[IN]
- disort_settings_downwelling_wrapper_agendaExecute(self, disort_settings: pyarts3.arts.DisortSettings | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None, disort_settings_downwelling_wrapper_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
disort_settings_downwelling_wrapper_agenda, see it for more detailsAuthor:
Automatically GeneratedUsed by wrapper method
- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]disort_settings_downwelling_wrapper_agenda (Agenda, optional) – An wrapper agenda for calling
disort_settings_agenda. Seedisort_settings_downwelling_wrapper_agenda, defaults toself.disort_settings_downwelling_wrapper_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- disort_settings_downwelling_wrapper_agendaExecuteOperator(self, disort_settings: pyarts3.arts.DisortSettings | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None, disort_settings_downwelling_wrapper_agenda_operator: pyarts3.arts.disort_settings_downwelling_wrapper_agendaOperator | None = None) None
Executes an operator emulating
disort_settings_downwelling_wrapper_agenda, see it, and alsodisort_settings_downwelling_wrapper_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]disort_settings_downwelling_wrapper_agenda_operator (disort_settings_downwelling_wrapper_agendaOperator) – Operator for
disort_settings_downwelling_wrapper_agenda. [IN]
- disort_settings_downwelling_wrapper_agendaSet(self, disort_settings_downwelling_wrapper_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
disort_settings_downwelling_wrapper_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
disort_settings_downwelling_wrapper_agenda (Agenda, optional) – An wrapper agenda for calling
disort_settings_agenda. Seedisort_settings_downwelling_wrapper_agenda, defaults toself.disort_settings_downwelling_wrapper_agenda[OUT]option (String, optional) – Choice of generated agenda. Defaults to
"Standard"[IN]
Valid options
These are the valid options for the
disort_settings_downwelling_wrapper_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
disort_settings_downwelling_wrapper_agendaSet(option="Standard")Shares the global
spectral_rad_observer_agendapol = [1, 0, 0, 0]
- disort_settings_downwelling_wrapper_agendaSetOperator(self, disort_settings_downwelling_wrapper_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.disort_settings_downwelling_wrapper_agendaOperator | None = None) None
Set
disort_settings_downwelling_wrapper_agendato exclusively use provided external operator. Seedisort_settings_downwelling_wrapper_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
disort_settings_downwelling_wrapper_agenda (Agenda, optional) – An wrapper agenda for calling
disort_settings_agenda. Seedisort_settings_downwelling_wrapper_agenda, defaults toself.disort_settings_downwelling_wrapper_agenda[OUT]f (disort_settings_downwelling_wrapper_agendaOperator) – Operator for
disort_settings_downwelling_wrapper_agenda. [IN]
- disort_spectral_flux_fieldCalc(self, disort_spectral_flux_field: pyarts3.arts.DisortFlux | None = None, disort_settings: pyarts3.arts.DisortSettings | None = None) None
Perform Disort calculations for spectral flux.
Author: Richard Larsson
Used by wrapper method
- Parameters:
disort_spectral_flux_field (DisortFlux, optional) – The spectral flux field from Disort. See
disort_spectral_flux_field, defaults toself.disort_spectral_flux_field[OUT]disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[IN]
- disort_spectral_flux_fieldFromAgenda(self, disort_spectral_flux_field: pyarts3.arts.DisortFlux | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None) None
Use Disort for clearsky calculations of spectral flux field.
The agenda is used to setup Disort, i.e., to compute the
disort_settingsthat governs how the solver is run.Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.disort_settings_agendaExecute() 6 ws.disort_spectral_flux_fieldCalc()
Authors: Richard Larsson,
Automatically GeneratedUsed by wrapper method
- Parameters:
disort_spectral_flux_field (DisortFlux, optional) – The spectral flux field from Disort. See
disort_spectral_flux_field, defaults toself.disort_spectral_flux_field[OUT]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]
- disort_spectral_flux_fieldProfile(self, disort_spectral_flux_field: pyarts3.arts.DisortFlux | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, max_stepsize: pyarts3.arts.Numeric | None = None, surf_field: pyarts3.arts.SurfaceField | None = None) None
Extract a 1D path through the atmosphere and calculate spectral flux using Disort.
This wrapper helps setting up a downlooking ray path through the atmosphere to form the basis for the agenda to setup the Disort calculations.
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.ray_pathGeometricDownlooking() 6 ws.disort_spectral_flux_fieldFromAgenda()
Authors: Richard Larsson,
Automatically Generated- Parameters:
disort_spectral_flux_field (DisortFlux, optional) – The spectral flux field from Disort. See
disort_spectral_flux_field, defaults toself.disort_spectral_flux_field[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]
- disort_spectral_rad_fieldApplyUnit(self, disort_spectral_rad_field: pyarts3.arts.DisortRadiance | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, spectral_rad_transform_operator: pyarts3.arts.SpectralRadianceTransformOperator | None = None) None
Convert units of the Disort spectral radiance field.
Author: Richard Larsson
- Parameters:
disort_spectral_rad_field (DisortRadiance, optional) – The spectral radiance field from Disort. See
disort_spectral_rad_field, defaults toself.disort_spectral_rad_field[INOUT]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]spectral_rad_transform_operator (SpectralRadianceTransformOperator, optional) – The spectral radiance transform operator. See
spectral_rad_transform_operator, defaults toself.spectral_rad_transform_operator[IN]
- disort_spectral_rad_fieldCalc(self, disort_spectral_rad_field: pyarts3.arts.DisortRadiance | None = None, disort_quadrature: pyarts3.arts.ZenGriddedField1 | None = None, disort_settings: pyarts3.arts.DisortSettings | None = None, azi_grid: pyarts3.arts.AziGrid | None = None) None
Perform Disort calculations for spectral radiance.
Author: Richard Larsson
Used by wrapper methods
- Parameters:
disort_spectral_rad_field (DisortRadiance, optional) – The spectral radiance field from Disort. See
disort_spectral_rad_field, defaults toself.disort_spectral_rad_field[OUT]disort_quadrature (ZenGriddedField1, optional) – The quadrature angles for Disort with accompying weights. See
disort_quadrature, defaults toself.disort_quadrature[OUT]disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[IN]azi_grid (AziGrid, optional) – The azimuthal angles. Defaults to
0[IN]
- disort_spectral_rad_fieldCalcCdisort(self, disort_spectral_rad_field: pyarts3.arts.DisortRadiance | None = None, disort_quadrature: pyarts3.arts.ZenGriddedField1 | None = None, disort_settings: pyarts3.arts.DisortSettings | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None, freq_grid_path: pyarts3.arts.ArrayOfAscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, azi_grid: pyarts3.arts.AziGrid | None = None) None
Perform CDisort calculations for spectral radiance.
CDisort is only included for testing and comparisons with our own disort implementation.
Author: Oliver Lemke
Used by wrapper method
- Parameters:
disort_spectral_rad_field (DisortRadiance, optional) – The spectral radiance field from Disort. See
disort_spectral_rad_field, defaults toself.disort_spectral_rad_field[OUT]disort_quadrature (ZenGriddedField1, optional) – The quadrature angles for Disort with accompying weights. See
disort_quadrature, defaults toself.disort_quadrature[OUT]disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[IN]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]freq_grid_path (ArrayOfAscendingGrid, optional) – All
freq_gridalong the propagation path. Seefreq_grid_path, defaults toself.freq_grid_path[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]azi_grid (AziGrid, optional) – The azimuthal angles. Defaults to
0[IN]
- disort_spectral_rad_fieldDepthProfile(self, disort_spectral_rad_field: pyarts3.arts.DisortRadiance | None = None, disort_quadrature: pyarts3.arts.ZenGriddedField1 | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, depth_profile: pyarts3.arts.DescendingGrid | None = None, azi_grid: pyarts3.arts.AziGrid | None = None) None
Sets a ray path from a point and depth profile and calculates spectral radiance using Disort.
This wrapper helps setting up a downlooking ray path to form the basis for the agenda to setup the Disort calculations.
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.ray_pathFromPointAndDepth() 6 ws.disort_spectral_rad_fieldFromAgenda()
Authors: Richard Larsson,
Automatically Generated- Parameters:
disort_spectral_rad_field (DisortRadiance, optional) – The spectral radiance field from Disort. See
disort_spectral_rad_field, defaults toself.disort_spectral_rad_field[OUT]disort_quadrature (ZenGriddedField1, optional) – The quadrature angles for Disort with accompying weights. See
disort_quadrature, defaults toself.disort_quadrature[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]depth_profile (DescendingGrid) – List of depths. [IN]
azi_grid (AziGrid, optional) – The azimuthal angles. Defaults to
0[IN]
- disort_spectral_rad_fieldFromAgenda(self, disort_spectral_rad_field: pyarts3.arts.DisortRadiance | None = None, disort_quadrature: pyarts3.arts.ZenGriddedField1 | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, azi_grid: pyarts3.arts.AziGrid | None = None) None
Use Disort for clearsky calculations of spectral radiance field.
The agenda is used to setup Disort, i.e., to compute the
disort_settingsthat governs how the solver is run.Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.disort_settings_agendaExecute() 6 ws.disort_spectral_rad_fieldCalc()
Authors: Richard Larsson,
Automatically GeneratedUsed by wrapper methods
- Parameters:
disort_spectral_rad_field (DisortRadiance, optional) – The spectral radiance field from Disort. See
disort_spectral_rad_field, defaults toself.disort_spectral_rad_field[OUT]disort_quadrature (ZenGriddedField1, optional) – The quadrature angles for Disort with accompying weights. See
disort_quadrature, defaults toself.disort_quadrature[OUT]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]azi_grid (AziGrid, optional) – The azimuthal angles. Defaults to
0[IN]
- disort_spectral_rad_fieldFromAgendaCdisort(self, disort_spectral_rad_field: pyarts3.arts.DisortRadiance | None = None, disort_quadrature: pyarts3.arts.ZenGriddedField1 | None = None, atm_field: pyarts3.arts.AtmField | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, azi_grid: pyarts3.arts.AziGrid | None = None) None
Use the disort settings agenda to calculate spectral radiance
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.disort_settings_agendaExecute() 6 ws.atm_pathFromPath() 7 ws.freq_grid_pathFromPath() 8 ws.disort_spectral_rad_fieldCalcCdisort()
Authors: Oliver Lemke, Richard Larsson,
Automatically GeneratedUsed by wrapper method
- Parameters:
disort_spectral_rad_field (DisortRadiance, optional) – The spectral radiance field from Disort. See
disort_spectral_rad_field, defaults toself.disort_spectral_rad_field[OUT]disort_quadrature (ZenGriddedField1, optional) – The quadrature angles for Disort with accompying weights. See
disort_quadrature, defaults toself.disort_quadrature[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]azi_grid (AziGrid, optional) – The azimuthal angles. Defaults to
0[IN]
- disort_spectral_rad_fieldProfile(self, disort_spectral_rad_field: pyarts3.arts.DisortRadiance | None = None, disort_quadrature: pyarts3.arts.ZenGriddedField1 | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, max_stepsize: pyarts3.arts.Numeric | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, azi_grid: pyarts3.arts.AziGrid | None = None) None
Extract a 1D path through the atmosphere and calculate spectral radiance using Disort.
This wrapper helps setting up a downlooking ray path through the atmosphere to form the basis for the agenda to setup the Disort calculations.
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.ray_pathGeometricDownlooking() 6 ws.disort_spectral_rad_fieldFromAgenda()
Authors: Richard Larsson,
Automatically Generated- Parameters:
disort_spectral_rad_field (DisortRadiance, optional) – The spectral radiance field from Disort. See
disort_spectral_rad_field, defaults toself.disort_spectral_rad_field[OUT]disort_quadrature (ZenGriddedField1, optional) – The quadrature angles for Disort with accompying weights. See
disort_quadrature, defaults toself.disort_quadrature[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]azi_grid (AziGrid, optional) – The azimuthal angles. Defaults to
0[IN]
- disort_spectral_rad_fieldProfileCdisort(self, disort_spectral_rad_field: pyarts3.arts.DisortRadiance | None = None, disort_quadrature: pyarts3.arts.ZenGriddedField1 | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, max_stepsize: pyarts3.arts.Numeric | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, azi_grid: pyarts3.arts.AziGrid | None = None) None
Extract a 1D path through the atmospheric field and calculate spectral radiance using Disort
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.ray_pathGeometricDownlooking() 6 ws.disort_spectral_rad_fieldFromAgendaCdisort()
Authors: Oliver Lemke, Richard Larsson,
Automatically Generated- Parameters:
disort_spectral_rad_field (DisortRadiance, optional) – The spectral radiance field from Disort. See
disort_spectral_rad_field, defaults toself.disort_spectral_rad_field[OUT]disort_quadrature (ZenGriddedField1, optional) – The quadrature angles for Disort with accompying weights. See
disort_quadrature, defaults toself.disort_quadrature[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]azi_grid (AziGrid, optional) – The azimuthal angles. Defaults to
0[IN]
- flux_profileIntegrate(self, flux_profile: pyarts3.arts.Vector | None = None, spectral_flux_profile: pyarts3.arts.Matrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None) None
Computes the spectral flux
Author: Richard Larsson
- Parameters:
flux_profile (Vector) – The spectral flux profile. Defaults to create and/or use
self.flux_profile:Vector. [OUT]spectral_flux_profile (Matrix, optional) – An altitude profile of spectral flux. See
spectral_flux_profile, defaults toself.spectral_flux_profile[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]
- freqWindShift(self, freq: pyarts3.arts.Numeric | None = None, freq_wind_shift_jac: pyarts3.arts.Vector3 | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None) None
Same as
freq_gridWindShift()but for single frequency values.Author: Richard Larsson
- Parameters:
freq (Numeric, optional) – A single frequency. Unit: Hz. See
freq, defaults toself.freq[INOUT]freq_wind_shift_jac (Vector3, optional) – The frequency wind shift Jacobian. See
freq_wind_shift_jac, defaults toself.freq_wind_shift_jac[OUT]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]
- freq_gridFitNonLTE(self, freq_grid: pyarts3.arts.AscendingGrid | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, df: pyarts3.arts.Numeric | None = None, nf: pyarts3.arts.Index | None = None) None
Frequency grid useful for
atm_profileFitNonLTE().This method creates a frequency grid around the line-center of each absorption line in the
abs_bandsvariable.Note
For all sorted absorption line centers \(f_i\), the following should be true:
\[f_{i -1} + \delta f < f_i < f_{i + 1} - \delta f\]That is, the frequency ranges are not allowed to overlap.
Author: Richard Larsson
- Parameters:
freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[OUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]df (Numeric) – Frequency grid around the line-center. The range will cover \(f_i\) pm left(1-delta fright)forall i` of each absorption line \(i\), where this variable is \(\delta f\). [IN]
nf (Index, optional) – Number of frequency points per line. The step between frequency grid points will be \(2\frac{\delta f}{N - 1}\), where this is \(N\). Defaults to
401[IN]
- freq_gridFromSingleFrequency(self, freq_grid: pyarts3.arts.AscendingGrid | None = None, freq: pyarts3.arts.Numeric | None = None) None
Composition method, creates a frequency grid from a single frequency.
Author: Richard Larsson
- Parameters:
freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[OUT]freq (Numeric, optional) – A single frequency. Unit: Hz. See
freq, defaults toself.freq[IN]
- freq_gridWindShift(self, freq_grid: pyarts3.arts.AscendingGrid | None = None, freq_wind_shift_jac: pyarts3.arts.Vector3 | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None) None
Applies wind shift to the
freq_gridfor the local frequency grid.Also sets
freq_wind_shift_jac.If the wind is 0 or nan, the
freq_gridremains unchanged.Author: Richard Larsson
- Parameters:
freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[INOUT]freq_wind_shift_jac (Vector3, optional) – The frequency wind shift Jacobian. See
freq_wind_shift_jac, defaults toself.freq_wind_shift_jac[OUT]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]
- freq_grid_pathFromPath(self, freq_grid_path: pyarts3.arts.ArrayOfAscendingGrid | None = None, freq_wind_shift_jac_path: pyarts3.arts.ArrayOfVector3 | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None) None
Gets the frequency grids along the path.
The derivative transformation for wind parameters is also returned.
See
spectral_propmat_jacWindFix()for use of the wind shift data.Author: Richard Larsson
Used by wrapper methods
- Parameters:
freq_grid_path (ArrayOfAscendingGrid, optional) – All
freq_gridalong the propagation path. Seefreq_grid_path, defaults toself.freq_grid_path[OUT]freq_wind_shift_jac_path (ArrayOfVector3, optional) – A list of
freq_wind_shift_jacfor a ray path. Seefreq_wind_shift_jac_path, defaults toself.freq_wind_shift_jac_path[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]
- gravity_operatorCentralMass(self, gravity_operator: pyarts3.arts.NumericTernaryOperator | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, mass: pyarts3.arts.Numeric | None = None) None
Sets a gravity operator from the gravitational constant and the mass of the planet
Gets the ellispoid from
surf_fieldAuthor: Richard Larsson
- Parameters:
gravity_operator (NumericTernaryOperator, optional) – The gravity operator. See
gravity_operator, defaults toself.gravity_operator[OUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]mass (Numeric) – Gravitation constant so that the gravity at radius \(r\) is \(GM / r^2\). [IN]
- init(self, arg: str, /) None
- init(self, name: str, typename: str) None
Overloaded function.
init(self, arg: str, /) -> Noneinit(self, name: str, typename: str) -> None
Initiate the variable to the named type.
- inversion_iterate_agendaExecute(self, atm_field: pyarts3.arts.AtmField | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, measurement_vec_fit: pyarts3.arts.Vector | None = None, measurement_jac: pyarts3.arts.Matrix | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, model_state_vec: pyarts3.arts.Vector | None = None, do_jac: pyarts3.arts.Index | None = None, inversion_iterate_agenda_counter: pyarts3.arts.Index | None = None, inversion_iterate_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
inversion_iterate_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[INOUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[INOUT]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[INOUT]measurement_vec_fit (Vector, optional) – As
measurement_vec, but fitted to the model. Seemeasurement_vec_fit, defaults toself.measurement_vec_fit[OUT]measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[OUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]do_jac (Index, optional) – A boolean calculations related to the
measurement_jacshould be ignored. Seedo_jac, defaults toself.do_jac[IN]inversion_iterate_agenda_counter (Index, optional) – A counter for the inversion iterate agenda. See
inversion_iterate_agenda_counter, defaults toself.inversion_iterate_agenda_counter[IN]inversion_iterate_agenda (Agenda, optional) – Work in progress … See
inversion_iterate_agenda, defaults toself.inversion_iterate_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- inversion_iterate_agendaExecuteOperator(self, atm_field: pyarts3.arts.AtmField | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, measurement_vec_fit: pyarts3.arts.Vector | None = None, measurement_jac: pyarts3.arts.Matrix | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, model_state_vec: pyarts3.arts.Vector | None = None, do_jac: pyarts3.arts.Index | None = None, inversion_iterate_agenda_counter: pyarts3.arts.Index | None = None, inversion_iterate_agenda_operator: pyarts3.arts.inversion_iterate_agendaOperator | None = None) None
Executes an operator emulating
inversion_iterate_agenda, see it, and alsoinversion_iterate_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[INOUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[INOUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[INOUT]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[INOUT]measurement_vec_fit (Vector, optional) – As
measurement_vec, but fitted to the model. Seemeasurement_vec_fit, defaults toself.measurement_vec_fit[OUT]measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[OUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]do_jac (Index, optional) – A boolean calculations related to the
measurement_jacshould be ignored. Seedo_jac, defaults toself.do_jac[IN]inversion_iterate_agenda_counter (Index, optional) – A counter for the inversion iterate agenda. See
inversion_iterate_agenda_counter, defaults toself.inversion_iterate_agenda_counter[IN]inversion_iterate_agenda_operator (inversion_iterate_agendaOperator) – Operator for
inversion_iterate_agenda. [IN]
- inversion_iterate_agendaSet(self, inversion_iterate_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
inversion_iterate_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
inversion_iterate_agenda (Agenda, optional) – Work in progress … See
inversion_iterate_agenda, defaults toself.inversion_iterate_agenda[OUT]option (String, optional) – Choice of generated agenda. Defaults to
"Full"[IN]
Valid options
These are the valid options for the
inversion_iterate_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
inversion_iterate_agendaSet(option="Full")Shares the global
measurement_inversion_agendaIgnore(), using: input =inversion_iterate_agenda_counter
- inversion_iterate_agendaSetOperator(self, inversion_iterate_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.inversion_iterate_agendaOperator | None = None) None
Set
inversion_iterate_agendato exclusively use provided external operator. Seeinversion_iterate_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
inversion_iterate_agenda (Agenda, optional) – Work in progress … See
inversion_iterate_agenda, defaults toself.inversion_iterate_agenda[OUT]f (inversion_iterate_agendaOperator) – Operator for
inversion_iterate_agenda. [IN]
- jac_targetsAddAtmosphere(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, target: pyarts3.arts.AtmKey | pyarts3.arts.SpeciesEnum | pyarts3.arts.SpeciesIsotope | pyarts3.arts.QuantumLevelIdentifier | None = None, d: pyarts3.arts.Numeric | None = None) None
Sets an atmospheric target.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]target (AtmKey,SpeciesEnum,SpeciesIsotope,QuantumLevelIdentifier) – The target of interest. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]
- jac_targetsAddErrorPolyFit(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, t: pyarts3.arts.Vector | None = None, sensor_elem: pyarts3.arts.Index | None = None, polyorder: pyarts3.arts.Index | None = None) None
Set a measurement error to polynomial fit.
This is a generic error that is simply added to
measurement_vecas if\[y = y_0 + \epsilon(p_0,\; p_1,\; \cdots,\; p_n),\]where \(y\) represents
measurement_vecand \(y_0\) is the measurement vector without any errors)Order 0 means constant: \(y = y_0 + a\)
Order 1 means linear: \(y = y_0 + a + b t\)
and so on. The derivatives that are added to the
model_state_vecare those with regards to a, b, etc..Note
The rule for the
sensor_elemGIN is a bit complex. Generally, methods such asmeasurement_sensorAddSimple()will simply add a single unique frequency grid to all the differentSensorObselthat they add to themeasurement_sensor. The GINsensor_elemis 0 for the first unique frequency grid, 1 for the second, and so on. SeeArrayOfSensorObselmember methods in python for help identifying and manipulating how many unique frequency grids are available inmeasurement_sensor.Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]t (Vector) – The grid of \(y\). As \(t\) above. [IN]
sensor_elem (Index) – The sensor element whose frequency grid to use. [IN]
polyorder (Index, optional) – The order of the polynomial fit. Maximum \(n\) above. Defaults to
0[IN]
- jac_targetsAddMagneticField(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, component: pyarts3.arts.String | None = None, d: pyarts3.arts.Numeric | None = None) None
Set magnetic field derivative.
See
FieldComponentfor validcomponent.Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]component (String) – The component to use [u, v, w]. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]
- jac_targetsAddOverlappingMagneticField(self, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Set magnetic field derivative for overlapping fields.
An overlapping field means that the derivative is computed but that the x-component of the jacobian is at the same position as another Jacobian target.
The reason for this method is that it allows representing the (signed) absolute magnetic field derivative as a combination of the three magnetic field components.
To call this method, you first have added 1 component of the magnetic field derivative, and then you call this method to add the second and third component.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]
- jac_targetsAddOverlappingWindField(self, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Set wind field derivative for overlapping fields.
An overlapping field means that the derivative is computed but that the x-component of the jacobian is at the same position as another Jacobian target.
The reason for this method is that it allows representing the (signed) absolute wind speed derivative as a combination of the three wind field components.
To call this method, you first have added 1 component of the wind field derivative, and then you call this method to add the second and third component.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]
- jac_targetsAddPressure(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, d: pyarts3.arts.Numeric | None = None) None
Set pressure derivative.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]
- jac_targetsAddSensorFrequencyPolyOffset(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, d: pyarts3.arts.Numeric | None = None, sensor_elem: pyarts3.arts.Index | None = None, polyorder: pyarts3.arts.Index | None = None) None
Set sensor frequency derivative to use polynomial fitting offset
Order 0 means constant: \(f := f_0 + a\)
Order 1 means linear: \(f := f_0 + a + b f_0\)
and so on. The derivatives that are added to the
model_state_vecare those with regards to a, b, etc..Note
The rule for the
sensor_elemGIN is a bit complex. Generally, methods such asmeasurement_sensorAddSimple()will simply add a single unique frequency grid to all the differentSensorObselthat they add to themeasurement_sensor. The GINsensor_elemis 0 for the first unique frequency grid, 1 for the second, and so on. SeeArrayOfSensorObselmember methods in python for help identifying and manipulating how many unique frequency grids are available inmeasurement_sensor.Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]sensor_elem (Index) – The sensor element whose frequency grid to use. [IN]
polyorder (Index, optional) – The order of the polynomial fit. Defaults to
0[IN]
- jac_targetsAddSpeciesIsotopologueRatio(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, species: pyarts3.arts.SpeciesIsotope | None = None, d: pyarts3.arts.Numeric | None = None) None
Set isotopologue ratio derivative
See
SpeciesIsotopefor validspeciesAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]species (SpeciesIsotope) – The species isotopologue of interest. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]
- jac_targetsAddSpeciesVMR(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, species: pyarts3.arts.SpeciesEnum | None = None, d: pyarts3.arts.Numeric | None = None) None
Set volume mixing ratio derivative.
See
SpeciesEnumfor validspeciesAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]species (SpeciesEnum) – The species of interest. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]
- jac_targetsAddSubsurface(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, target: pyarts3.arts.SubsurfaceKey | pyarts3.arts.SubsurfacePropertyTag | None = None, d: pyarts3.arts.Numeric | None = None) None
Sets a subsurface target
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]target (SubsurfaceKey,SubsurfacePropertyTag) – The target of interest. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]
- jac_targetsAddSurface(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, target: pyarts3.arts.SurfaceKey | pyarts3.arts.SurfacePropertyTag | None = None, d: pyarts3.arts.Numeric | None = None) None
Sets a surface target
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]target (SurfaceKey,SurfacePropertyTag) – The target of interest. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]
- jac_targetsAddTemperature(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, d: pyarts3.arts.Numeric | None = None) None
Set temperature derivative.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]
- jac_targetsAddWindField(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, component: pyarts3.arts.String | None = None, d: pyarts3.arts.Numeric | None = None) None
Set wind field derivative.
Note that the derivatives from methods that takes the freqeuncy will return their derivatives as if these were frequency derivatives.
See
FieldComponentfor validcomponentAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]component (String) – The component to use [u, v, w]. [IN]
d (Numeric, optional) – The perturbation used in methods that cannot compute derivatives analytically. Defaults to
0.1[IN]
- jac_targetsConditionalClear(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, do_jac: pyarts3.arts.Index | None = None) None
Clears
jac_targetsifdo_jacevaluates false.Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]do_jac (Index, optional) – A boolean calculations related to the
measurement_jacshould be ignored. Seedo_jac, defaults toself.do_jac[IN]
- jac_targetsFinalize(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None) None
Finalize
jac_targets.The finalization computes the size of the required
model_state_vec. It is thus necessary if anyOEM()or other functionality that requires the building of an actual Jacobian matrix.Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]
- jac_targetsInit(self, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Initialize or reset the
jac_targets.Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[OUT]
- jac_targetsOff(self, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Turns off
jac_targetsAuthor: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[OUT]
- jac_targetsToggleLogRelAtmTarget(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, atm_field: pyarts3.arts.AtmField | None = None, key: pyarts3.arts.AtmKey | pyarts3.arts.SpeciesEnum | pyarts3.arts.SpeciesIsotope | pyarts3.arts.QuantumLevelIdentifier | pyarts3.arts.ScatteringSpeciesProperty | None = None) None
Toggles logarithmic/relative or absolute retrievals.
This means to take the logarithm of the relative value.
If the target is in logarithmic/relative mode, it becomes absolute. If the target is not in logarithmic/relative mode, it becomes logarithmic/relative.
Overwrites all other functional toggles.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]key (AtmKey,SpeciesEnum,SpeciesIsotope,QuantumLevelIdentifier,ScatteringSpeciesProperty) – Key to toggle. [IN]
- jac_targetsToggleLogRelSubsurfaceTarget(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, key: pyarts3.arts.SubsurfaceKey | None = None) None
Toggles logarithmic/relative or absolute retrievals.
This means to take the logarithm of the relative value.
If the target is in logarithmic/relative mode, it becomes absolute. If the target is not in logarithmic/relative mode, it becomes logarithmic/relative.
Overwrites all other functional toggles.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]key (SubsurfaceKey) – Key to toggle. [IN]
- jac_targetsToggleLogRelSurfaceTarget(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, key: pyarts3.arts.SurfaceKey | pyarts3.arts.SurfacePropertyTag | None = None) None
Toggles logarithmic/relative or absolute retrievals.
This means to take the logarithm of the relative value.
If the target is in logarithmic/relative mode, it becomes absolute. If the target is not in logarithmic/relative mode, it becomes logarithmic/relative.
Overwrites all other functional toggles.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]key (SurfaceKey,SurfacePropertyTag) – Key to toggle. [IN]
- jac_targetsToggleLogarithmicAtmTarget(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, atm_field: pyarts3.arts.AtmField | None = None, key: pyarts3.arts.AtmKey | pyarts3.arts.SpeciesEnum | pyarts3.arts.SpeciesIsotope | pyarts3.arts.QuantumLevelIdentifier | pyarts3.arts.ScatteringSpeciesProperty | None = None) None
Toggles logarithmic or absolute retrievals.
If the target is in logarithmic mode, it becomes absolute. If the target is not in logarithmic mode, it becomes logarithmic.
Overwrites all other functional toggles.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]key (AtmKey,SpeciesEnum,SpeciesIsotope,QuantumLevelIdentifier,ScatteringSpeciesProperty) – Key to toggle. [IN]
- jac_targetsToggleLogarithmicSubsurfaceTarget(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, key: pyarts3.arts.SubsurfaceKey | None = None) None
Toggles logarithmic or absolute retrievals.
If the target is in logarithmic mode, it becomes absolute. If the target is not in logarithmic mode, it becomes logarithmic.
Overwrites all other functional toggles.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]key (SubsurfaceKey) – Key to toggle. [IN]
- jac_targetsToggleLogarithmicSurfaceTarget(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, key: pyarts3.arts.SurfaceKey | pyarts3.arts.SurfacePropertyTag | None = None) None
Toggles logarithmic or absolute retrievals.
If the target is in logarithmic mode, it becomes absolute. If the target is not in logarithmic mode, it becomes logarithmic.
Overwrites all other functional toggles.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]key (SurfaceKey,SurfacePropertyTag) – Key to toggle. [IN]
- jac_targetsToggleRelativeAtmTarget(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, atm_field: pyarts3.arts.AtmField | None = None, key: pyarts3.arts.AtmKey | pyarts3.arts.SpeciesEnum | pyarts3.arts.SpeciesIsotope | pyarts3.arts.QuantumLevelIdentifier | pyarts3.arts.ScatteringSpeciesProperty | None = None) None
Toggles relative or absolute retrievals.
If the target is in relative mode, it becomes absolute. If the target is not in relative mode, it becomes relative.
Overwrites all other functional toggles.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]key (AtmKey,SpeciesEnum,SpeciesIsotope,QuantumLevelIdentifier,ScatteringSpeciesProperty) – Key to toggle. [IN]
- jac_targetsToggleRelativeHumidityAtmTarget(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, atm_field: pyarts3.arts.AtmField | None = None, water_equivalent_pressure_operator: pyarts3.arts.NumericUnaryOperator | None = None, key: pyarts3.arts.AtmKey | pyarts3.arts.SpeciesEnum | pyarts3.arts.SpeciesIsotope | pyarts3.arts.QuantumLevelIdentifier | pyarts3.arts.ScatteringSpeciesProperty | None = None, nonnegative: pyarts3.arts.Index | None = None) None
Toggles relative humidity or absolute retrievals.
If the target is in relative humidity mode, it becomes absolute. If the target is not in relative humidity mode, it becomes relative humidity.
Overwrites all other functional toggles.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]water_equivalent_pressure_operator (NumericUnaryOperator, optional) – The water equivalent pressure operator. See
water_equivalent_pressure_operator, defaults toself.water_equivalent_pressure_operator[IN]key (AtmKey,SpeciesEnum,SpeciesIsotope,QuantumLevelIdentifier,ScatteringSpeciesProperty) – Key to toggle. [IN]
nonnegative (Index, optional) – Whether or not to zero-out negative values. Defaults to
1[IN]
- jac_targetsToggleRelativeSubsurfaceTarget(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, key: pyarts3.arts.SubsurfaceKey | None = None) None
Toggles relative or absolute retrievals.
If the target is in relative mode, it becomes absolute. If the target is not in relative mode, it becomes relative.
Overwrites all other functional toggles.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]key (SubsurfaceKey) – Key to toggle. [IN]
- jac_targetsToggleRelativeSurfaceTarget(self, jac_targets: pyarts3.arts.JacobianTargets | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, key: pyarts3.arts.SurfaceKey | pyarts3.arts.SurfacePropertyTag | None = None) None
Toggles relative or absolute retrievals.
If the target is in relative mode, it becomes absolute. If the target is not in relative mode, it becomes relative.
Overwrites all other functional toggles.
Author: Richard Larsson
- Parameters:
jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]key (SurfaceKey,SurfacePropertyTag) – Key to toggle. [IN]
- legendre_degreeFromDisortSettings(self, legendre_degree: pyarts3.arts.Index | None = None, disort_settings: pyarts3.arts.DisortSettings | None = None) None
Sets
legendre_degreetodisort_settingslegendre_polynomial_dimensionMethod is purely for convenience and composition.
Author: Richard Larsson
- Parameters:
legendre_degree (Index, optional) – The degree of a Legendre polynimial. See
legendre_degree, defaults toself.legendre_degree[OUT]disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[IN]
- measurement_averaging_kernelCalc(self, measurement_averaging_kernel: pyarts3.arts.Matrix | None = None, measurement_gain_mat: pyarts3.arts.Matrix | None = None, measurement_jac: pyarts3.arts.Matrix | None = None) None
Calculate the averaging kernel matrix.
This is done by describing the sensitivity of the
OEM()retrieval with respect to the true state of the system. A prerequisite for the calculation of the averaging kernel matrix is a successfulOEM()calculation in which themeasurement_jacand the gain matrixmeasurement_gain_mathave been calculated.Author: Simon Pfreundschuh
- Parameters:
measurement_averaging_kernel (Matrix, optional) – Averaging kernel matrix. See
measurement_averaging_kernel, defaults toself.measurement_averaging_kernel[OUT]measurement_gain_mat (Matrix, optional) – Contribution function (or gain) matrix. See
measurement_gain_mat, defaults toself.measurement_gain_mat[IN]measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[IN]
- measurement_inversion_agendaExecute(self, measurement_vec_fit: pyarts3.arts.Vector | None = None, measurement_jac: pyarts3.arts.Matrix | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, do_jac: pyarts3.arts.Index | None = None, measurement_inversion_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
measurement_inversion_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
measurement_vec_fit (Vector, optional) – As
measurement_vec, but fitted to the model. Seemeasurement_vec_fit, defaults toself.measurement_vec_fit[OUT]measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[OUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]do_jac (Index, optional) – A boolean calculations related to the
measurement_jacshould be ignored. Seedo_jac, defaults toself.do_jac[IN]measurement_inversion_agenda (Agenda, optional) – This is a helper
Agendaintended for use withininversion_iterate_agenda. Seemeasurement_inversion_agenda, defaults toself.measurement_inversion_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- measurement_inversion_agendaExecuteOperator(self, measurement_vec_fit: pyarts3.arts.Vector | None = None, measurement_jac: pyarts3.arts.Matrix | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, do_jac: pyarts3.arts.Index | None = None, measurement_inversion_agenda_operator: pyarts3.arts.measurement_inversion_agendaOperator | None = None) None
Executes an operator emulating
measurement_inversion_agenda, see it, and alsomeasurement_inversion_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
measurement_vec_fit (Vector, optional) – As
measurement_vec, but fitted to the model. Seemeasurement_vec_fit, defaults toself.measurement_vec_fit[OUT]measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[OUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]do_jac (Index, optional) – A boolean calculations related to the
measurement_jacshould be ignored. Seedo_jac, defaults toself.do_jac[IN]measurement_inversion_agenda_operator (measurement_inversion_agendaOperator) – Operator for
measurement_inversion_agenda. [IN]
- measurement_inversion_agendaSet(self, measurement_inversion_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
measurement_inversion_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
measurement_inversion_agenda (Agenda, optional) – This is a helper
Agendaintended for use withininversion_iterate_agenda. Seemeasurement_inversion_agenda, defaults toself.measurement_inversion_agenda[OUT]option (String, optional) – Choice of generated agenda. Defaults to
"Standard"[IN]
Valid options
These are the valid options for the
measurement_inversion_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
measurement_inversion_agendaSet(option="Standard")Shares the global
abs_bandsShares the global
atm_fieldShares the global
measurement_sensorShares the global
model_state_vecShares the global
spectral_rad_observer_agendaShares the global
spectral_rad_transform_operatorShares the global
subsurf_fieldShares the global
surf_fieldCopies the global
jac_targets
- measurement_inversion_agendaSetOperator(self, measurement_inversion_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.measurement_inversion_agendaOperator | None = None) None
Set
measurement_inversion_agendato exclusively use provided external operator. Seemeasurement_inversion_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
measurement_inversion_agenda (Agenda, optional) – This is a helper
Agendaintended for use withininversion_iterate_agenda. Seemeasurement_inversion_agenda, defaults toself.measurement_inversion_agenda[OUT]f (measurement_inversion_agendaOperator) – Operator for
measurement_inversion_agenda. [IN]
- measurement_jacAtmosphereTransformation(self, measurement_jac: pyarts3.arts.Matrix | None = None, model_state_vec: pyarts3.arts.Vector | None = None, atm_field: pyarts3.arts.AtmField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Applies transformations to the atmospheric state Jacobian
Author: Richard Larsson
Used by wrapper method
- Parameters:
measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[INOUT]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- measurement_jacBandTransformation(self, measurement_jac: pyarts3.arts.Matrix | None = None, model_state_vec: pyarts3.arts.Vector | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Applies transformations to the line-by-line state Jacobian
Author: Richard Larsson
Used by wrapper method
- Parameters:
measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[INOUT]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- measurement_jacSensorTransformation(self, measurement_jac: pyarts3.arts.Matrix | None = None, model_state_vec: pyarts3.arts.Vector | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Applies transformations to the measurement sensor state Jacobian
Author: Richard Larsson
Used by wrapper method
- Parameters:
measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[INOUT]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- measurement_jacSubsurfaceTransformation(self, measurement_jac: pyarts3.arts.Matrix | None = None, model_state_vec: pyarts3.arts.Vector | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Applies transformations to the subsurface state Jacobian
Author: Richard Larsson
Used by wrapper method
- Parameters:
measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[INOUT]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- measurement_jacSurfaceTransformation(self, measurement_jac: pyarts3.arts.Matrix | None = None, model_state_vec: pyarts3.arts.Vector | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Applies transformations to the surface state Jacobian
Author: Richard Larsson
Used by wrapper method
- Parameters:
measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[INOUT]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- measurement_jacTransformations(self, measurement_jac: pyarts3.arts.Matrix | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, atm_field: pyarts3.arts.AtmField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, model_state_vec: pyarts3.arts.Vector | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None) None
Apply all transformations to the Jacobian related to states in
model_state_vecFromData()Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.measurement_jacAtmosphereTransformation() 6 ws.measurement_jacSurfaceTransformation() 7 ws.measurement_jacSubsurfaceTransformation() 8 ws.measurement_jacBandTransformation() 9 ws.measurement_jacSensorTransformation()
Author: Richard Larsson
- Parameters:
measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[INOUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]
- measurement_sensorAddGaussianZenith(self, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, pos: pyarts3.arts.Vector3 | None = None, los: pyarts3.arts.Vector2 | None = None, pol: pyarts3.arts.Stokvec | None = None, dzen_grid: pyarts3.arts.AscendingGrid | None = None, std_zen: pyarts3.arts.Numeric | None = None) None
Add a sensor to
measurement_sensorthat has a Gaussian zenith response.Author: Richard Larsson
- Parameters:
measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]pos (Vector3) – A position [alt, lat, lon]. [IN]
los (Vector2) – A line of sight [zenith, azimuth]. [IN]
pol (Stokvec, optional) – The polarization whos dot-product with the spectral radiance becomes the measurement. Defaults to
1 0 0 0[IN]dzen_grid (AscendingGrid) – The delta zenith grid for the Gaussian response. [IN]
std_zen (Numeric) – The standard deviation for the Gaussian response. [IN]
- measurement_sensorAddRawSensor(self, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, pos: pyarts3.arts.Vector3 | None = None, los: pyarts3.arts.Vector2 | None = None, raw_sensor_perturbation: pyarts3.arts.StokvecSortedGriddedField1 | pyarts3.arts.StokvecSortedGriddedField2 | pyarts3.arts.StokvecSortedGriddedField3 | pyarts3.arts.StokvecSortedGriddedField4 | pyarts3.arts.StokvecSortedGriddedField5 | pyarts3.arts.StokvecSortedGriddedField6 | pyarts3.arts.SortedGriddedField1 | pyarts3.arts.SortedGriddedField2 | pyarts3.arts.SortedGriddedField3 | pyarts3.arts.SortedGriddedField4 | pyarts3.arts.SortedGriddedField5 | pyarts3.arts.SortedGriddedField6 | None = None, normalize: pyarts3.arts.Index | None = None) None
Adds sensor elements from a raw perturbation of the sensor
The perturbation is a gridded field of up to 6-dimensions. The input frequency grid determines how many elements are added to the sensor. The cartesian perturbation is added to the sensor’s position, line of sight, and frequency grid.
The order of the dimensions are:
Frequency (
"dfreq")Zenith angle (
"dzen")Azimuth angle (
"dazi")Altitude (
"dalt")Latitude (
"dlat")Longitude (
"dlon")
The quoted strings must be used as the grid names of the gridded field.
Note
It is OK to have fewer than 6 dimensions, the missing dimensions will be assumed to have a size of 1. Since the data is exhaustive, the missing dimensions will not affect the output. What does matter is that the order of the dimensions do not change from the one above.
Author: Richard Larsson
- Parameters:
measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]pos (Vector3) – A position [alt, lat, lon]. [IN]
los (Vector2) – A line of sight [zenith, azimuth]. [IN]
raw_sensor_perturbation (StokvecSortedGriddedField1,StokvecSortedGriddedField2,StokvecSortedGriddedField3,StokvecSortedGriddedField4,StokvecSortedGriddedField5,StokvecSortedGriddedField6,SortedGriddedField1,SortedGriddedField2,SortedGriddedField3,SortedGriddedField4,SortedGriddedField5,SortedGriddedField6) – The sensor perturbation grid. [IN]
normalize (Index, optional) – Whether or not to normalize the perturbation to 1.0 for each element. Defaults to
0[IN]
- measurement_sensorAddSimple(self, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, pos: pyarts3.arts.Vector3 | None = None, los: pyarts3.arts.Vector2 | None = None, pol: pyarts3.arts.Stokvec | None = None) None
Adds a sensor with a dirac channel opening around the frequency grid.
All elements share position, line-of-sight, and frequency grid.
Author: Richard Larsson
Used by wrapper method
- Parameters:
measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]pos (Vector3) – A position [alt, lat, lon]. [IN]
los (Vector2) – A line of sight [zenith, azimuth]. [IN]
pol (Stokvec, optional) – The polarization whos dot-product with the spectral radiance becomes the measurement. Defaults to
1 0 0 0[IN]
- measurement_sensorAddSimpleGaussian(self, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, std: pyarts3.arts.Numeric | None = None, pos: pyarts3.arts.Vector3 | None = None, los: pyarts3.arts.Vector2 | None = None, pol: pyarts3.arts.Stokvec | None = None) None
Adds a sensor with a Gaussian channel opening around the frequency grid.
All elements share position, line-of-sight, and frequency grid.
Note that this means you only get “half” a Gaussian channel for the outermost channels.
The I component’s distribution is normalized to 1 or 0 by itself, while the Q, U, and V components’ hypotenuse are normalized to 1 or 0 together.
Author: Richard Larsson
Used by wrapper method
- Parameters:
measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]std (Numeric) – The standard deviations of the channels. [IN]
pos (Vector3) – A position [alt, lat, lon]. [IN]
los (Vector2) – A line of sight [zenith, azimuth]. [IN]
pol (Stokvec, optional) – The polarization whos dot-product with the spectral radiance becomes the measurement. Defaults to
1 0 0 0[IN]
- measurement_sensorAddVectorGaussian(self, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, std: pyarts3.arts.Vector | None = None, pos: pyarts3.arts.Vector3 | None = None, los: pyarts3.arts.Vector2 | None = None, pol: pyarts3.arts.Stokvec | None = None) None
Adds a sensor with a Gaussian channel opening around the frequency grid.
All elements share position, line-of-sight, and frequency grid.
Note that this means you only get “half” a Gaussian channel for the outermost channels.
The I component’s distribution is normalized to 1 or 0 by itself, while the Q, U, and V components’ hypotenuse are normalized to 1 or 0 together.
Author: Richard Larsson
Used by wrapper method
- Parameters:
measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]std (Vector) – The standard deviations of the channels. [IN]
pos (Vector3) – A position [alt, lat, lon]. [IN]
los (Vector2) – A line of sight [zenith, azimuth]. [IN]
pol (Stokvec, optional) – The polarization whos dot-product with the spectral radiance becomes the measurement. Defaults to
1 0 0 0[IN]
- measurement_sensorFromModelState(self, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, model_state_vec: pyarts3.arts.Vector | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Update
measurement_sensorfrommodel_state_vec.Author: Richard Larsson
Used by wrapper method
- Parameters:
measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[INOUT]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- measurement_sensorInit(self, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None) None
Initialize
measurement_sensorto empty.Author: Richard Larsson
Used by wrapper methods
- Parameters:
measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[OUT]
- measurement_sensorSimple(self, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, pos: pyarts3.arts.Vector3 | None = None, pol: pyarts3.arts.Stokvec | None = None, los: pyarts3.arts.Vector2 | None = None) None
Creates a single simple Dirac-opening sensor
This means that the sensor has no bandwidth per channel, i.e., only one frequency point is used to simulate the spectral radiance before being averaged into a channel.
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.measurement_sensorInit() 6 ws.measurement_sensorAddSimple()
Author: Richard Larsson
- Parameters:
measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]pos (Vector3) – A position [alt, lat, lon]. [IN]
pol (Stokvec, optional) – The polarization whos dot-product with the spectral radiance becomes the measurement. Defaults to
1 0 0 0[IN]los (Vector2) – A line of sight [zenith, azimuth]. [IN]
- measurement_sensorSimpleGaussian(self, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, std: pyarts3.arts.Numeric | None = None, pos: pyarts3.arts.Vector3 | None = None, pol: pyarts3.arts.Stokvec | None = None, los: pyarts3.arts.Vector2 | None = None) None
Creates a single simple Gaussian-opening sensor.
This means that the sensor has a Gaussian bandwidth per channel. That is, multiple frequency points are used to simulate the spectral radiance before being averaged into a channel. The bandwidth of each channel is the same.
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.measurement_sensorInit() 6 ws.measurement_sensorAddSimpleGaussian()
Author: Richard Larsson
- Parameters:
measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]std (Numeric) – The standard deviations of the channels. [IN]
pos (Vector3) – A position [alt, lat, lon]. [IN]
pol (Stokvec, optional) – The polarization whos dot-product with the spectral radiance becomes the measurement. Defaults to
1 0 0 0[IN]los (Vector2) – A line of sight [zenith, azimuth]. [IN]
- measurement_sensorVectorGaussian(self, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, std: pyarts3.arts.Vector | None = None, pos: pyarts3.arts.Vector3 | None = None, pol: pyarts3.arts.Stokvec | None = None, los: pyarts3.arts.Vector2 | None = None) None
Creates a single simple Gaussian-opening sensor.
This means that the sensor has a Gaussian bandwidth per channel. That is, multiple frequency points are used to simulate the spectral radiance before being averaged into a channel. The bandwidth of each channel is independent.
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.measurement_sensorInit() 6 ws.measurement_sensorAddVectorGaussian()
Author: Richard Larsson
- Parameters:
measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]std (Vector) – The standard deviations of the channels. [IN]
pos (Vector3) – A position [alt, lat, lon]. [IN]
pol (Stokvec, optional) – The polarization whos dot-product with the spectral radiance becomes the measurement. Defaults to
1 0 0 0[IN]los (Vector2) – A line of sight [zenith, azimuth]. [IN]
- measurement_vecConditionalAddError(self, measurement_vec: pyarts3.arts.Vector | None = None, measurement_jac: pyarts3.arts.Matrix | None = None, measurement_vec_error: pyarts3.arts.Vector | None = None, measurement_jac_error: pyarts3.arts.Matrix | None = None, do_jac: pyarts3.arts.Index | None = None) None
Add the measurement error to the measurement. Conditionally, also to the Jacobian.
Author: Richard Larsson
- Parameters:
measurement_vec (Vector, optional) – The measurment vector for, e.g., a sensor. See
measurement_vec, defaults toself.measurement_vec[INOUT]measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[INOUT]measurement_vec_error (Vector, optional) – The model measurment vector error for, e.g., a sensor. See
measurement_vec_error, defaults toself.measurement_vec_error[IN]measurement_jac_error (Matrix, optional) – The partial derivatives of the
measurement_vec_error. Seemeasurement_jac_error, defaults toself.measurement_jac_error[IN]do_jac (Index, optional) – A boolean calculations related to the
measurement_jacshould be ignored. Seedo_jac, defaults toself.do_jac[IN]
- measurement_vecFromOperatorPath(self, measurement_vec: pyarts3.arts.Vector | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, spectral_rad_operator: pyarts3.arts.SpectralRadianceOperator | None = None, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None) None
Sets measurement vector by looping over all sensor elements
The core calculations happens inside the
spectral_rad_operator.Author: Richard Larsson
- Parameters:
measurement_vec (Vector, optional) – The measurment vector for, e.g., a sensor. See
measurement_vec, defaults toself.measurement_vec[OUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]spectral_rad_operator (SpectralRadianceOperator, optional) – The spectral radiance operator. See
spectral_rad_operator, defaults toself.spectral_rad_operator[IN]ray_path_observer_agenda (Agenda, optional) – Gets the propagation path as it is obeserved. See
ray_path_observer_agenda, defaults toself.ray_path_observer_agenda[IN]
- measurement_vecFromSensor(self, measurement_vec: pyarts3.arts.Vector | None = None, measurement_jac: pyarts3.arts.Matrix | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, spectral_rad_transform_operator: pyarts3.arts.SpectralRadianceTransformOperator | None = None, spectral_rad_observer_agenda: pyarts3.arts.Agenda | None = None) None
Sets measurement vector by looping over all sensor elements
The core calculations happens inside the
spectral_rad_observer_agenda.Author: Richard Larsson
- Parameters:
measurement_vec (Vector, optional) – The measurment vector for, e.g., a sensor. See
measurement_vec, defaults toself.measurement_vec[OUT]measurement_jac (Matrix, optional) – The first order partial derivatives of the
measurement_vec. Seemeasurement_jac, defaults toself.measurement_jac[OUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]spectral_rad_transform_operator (SpectralRadianceTransformOperator, optional) – The spectral radiance transform operator. See
spectral_rad_transform_operator, defaults toself.spectral_rad_transform_operator[IN]spectral_rad_observer_agenda (Agenda, optional) – Computes spectral radiance as seen from the input position and environment. See
spectral_rad_observer_agenda, defaults toself.spectral_rad_observer_agenda[IN]
- measurement_vec_errorFromModelState(self, measurement_vec_error: pyarts3.arts.Vector | None = None, measurement_jac_error: pyarts3.arts.Matrix | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, model_state_vec: pyarts3.arts.Vector | None = None) None
Set the error and its Jacobian from the state of the model.
Author: Richard Larsson
- Parameters:
measurement_vec_error (Vector, optional) – The model measurment vector error for, e.g., a sensor. See
measurement_vec_error, defaults toself.measurement_vec_error[OUT]measurement_jac_error (Matrix, optional) – The partial derivatives of the
measurement_vec_error. Seemeasurement_jac_error, defaults toself.measurement_jac_error[OUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]
- measurement_vec_error_covmatConstant(self, measurement_vec_error_covmat: pyarts3.arts.CovarianceMatrix | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, value: pyarts3.arts.Numeric | None = None) None
Sets a constant measurement vector error covariance matrix.
Author: Richard Larsson
- Parameters:
measurement_vec_error_covmat (CovarianceMatrix, optional) – Covariance matrix for observation uncertainties. See
measurement_vec_error_covmat, defaults toself.measurement_vec_error_covmat[OUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]value (Numeric) – The value of the covariance matrix diagonal. [IN]
- measurement_vec_error_covmat_observation_systemCalc(self, measurement_vec_error_covmat_observation_system: pyarts3.arts.Matrix | None = None, measurement_gain_mat: pyarts3.arts.Matrix | None = None, measurement_vec_error_covmat: pyarts3.arts.CovarianceMatrix | None = None) None
Calculates the covariance matrix describing the error due to uncertainties in the observation system.
The uncertainties of the observation system are described by
measurement_vec_error_covmat, which must be set by the user to include the relevant contributions from the measurement and the forward model.Prerequisite for the calculation of
measurement_vec_error_covmat_observation_systemis a successfulOEM()computation where also the gain matrix has been computed.Author: Simon Pfreundschuh
- Parameters:
measurement_vec_error_covmat_observation_system (Matrix) – Covariance matrix describing the retrieval error due to uncertainties of the observation system. Defaults to create and/or use
self.measurement_vec_error_covmat_observation_system:Matrix. [OUT]measurement_gain_mat (Matrix, optional) – Contribution function (or gain) matrix. See
measurement_gain_mat, defaults toself.measurement_gain_mat[IN]measurement_vec_error_covmat (CovarianceMatrix, optional) – Covariance matrix for observation uncertainties. See
measurement_vec_error_covmat, defaults toself.measurement_vec_error_covmat[IN]
- measurement_vec_fitFromMeasurement(self, measurement_vec_fit: pyarts3.arts.Vector | None = None, measurement_vec: pyarts3.arts.Vector | None = None) None
Sets the fitted measurement vector to the current measurement vector.
Author: Richard Larsson
- Parameters:
measurement_vec_fit (Vector, optional) – As
measurement_vec, but fitted to the model. Seemeasurement_vec_fit, defaults toself.measurement_vec_fit[OUT]measurement_vec (Vector, optional) – The measurment vector for, e.g., a sensor. See
measurement_vec, defaults toself.measurement_vec[IN]
- model_state_covmatAddSpeciesVMR(self, model_state_covmat: pyarts3.arts.CovarianceMatrix | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, species: pyarts3.arts.SpeciesEnum | None = None, matrix: pyarts3.arts.BlockMatrix | None = None, inverse: pyarts3.arts.BlockMatrix | None = None) None
Set a species model state covariance matrix element.
Author: Richard Larsson
- Parameters:
model_state_covmat (CovarianceMatrix, optional) – Covariance matrix of a priori distribution. See
model_state_covmat, defaults toself.model_state_covmat[INOUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]species (SpeciesEnum) – The species to set the covariance matrix for. [IN]
matrix (BlockMatrix) – The covariance diagoinal block matrix. [IN]
inverse (BlockMatrix, optional) – The inverse covariance diagoinal block matrix. Defaults to
pyarts3.arts.BlockMatrix()[IN]
- model_state_covmatInit(self, model_state_covmat: pyarts3.arts.CovarianceMatrix | None = None) None
Initialises the model state covariance matrix to the identity matrix.
Author: Richard Larsson
- Parameters:
model_state_covmat (CovarianceMatrix, optional) – Covariance matrix of a priori distribution. See
model_state_covmat, defaults toself.model_state_covmat[OUT]
- model_state_covmat_smoothing_errorCalc(self, model_state_covmat_smoothing_error: pyarts3.arts.Matrix | None = None, measurement_averaging_kernel: pyarts3.arts.Matrix | None = None, model_state_covmat: pyarts3.arts.CovarianceMatrix | None = None) None
Calculates the covariance matrix describing the error due to smoothing.
The calculation of
model_state_covmat_smoothing_erroralso requires the averaging kernel matrixmeasurement_averaging_kernelto be computed after a successful OEM calculation.Author: Simon Pfreundschuh
- Parameters:
model_state_covmat_smoothing_error (Matrix) – Covariance matrix describing the retrieval error due to smoothing. Defaults to create and/or use
self.model_state_covmat_smoothing_error:Matrix. [OUT]measurement_averaging_kernel (Matrix, optional) – Averaging kernel matrix. See
measurement_averaging_kernel, defaults toself.measurement_averaging_kernel[IN]model_state_covmat (CovarianceMatrix, optional) – Covariance matrix of a priori distribution. See
model_state_covmat, defaults toself.model_state_covmat[IN]
- model_state_vecFromAtmosphere(self, model_state_vec: pyarts3.arts.Vector | None = None, atm_field: pyarts3.arts.AtmField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets
model_state_vec’s atmospheric part.Author: Richard Larsson
Used by wrapper method
- Parameters:
model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[INOUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- model_state_vecFromBands(self, model_state_vec: pyarts3.arts.Vector | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets
model_state_vec’s absorption line part.Author: Richard Larsson
Used by wrapper method
- Parameters:
model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[INOUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- model_state_vecFromData(self, model_state_vec: pyarts3.arts.Vector | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, atm_field: pyarts3.arts.AtmField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None) None
Get
model_state_vecfrom available dataWrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.model_state_vecInit() 6 ws.model_state_vecFromAtmosphere() 7 ws.model_state_vecFromSurface() 8 ws.model_state_vecFromSubsurface() 9 ws.model_state_vecFromBands() 10 ws.model_state_vecFromSensor()
Author: Richard Larsson
Used by wrapper method
- Parameters:
model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[OUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]
- model_state_vecFromSensor(self, model_state_vec: pyarts3.arts.Vector | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets
model_state_vec’s sensor part.Author: Richard Larsson
Used by wrapper method
- Parameters:
model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[INOUT]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- model_state_vecFromSubsurface(self, model_state_vec: pyarts3.arts.Vector | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets
model_state_vec’s subsurface part.Author: Richard Larsson
Used by wrapper method
- Parameters:
model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[INOUT]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- model_state_vecFromSurface(self, model_state_vec: pyarts3.arts.Vector | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets
model_state_vec’s surface part.Author: Richard Larsson
Used by wrapper method
- Parameters:
model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- model_state_vecInit(self, model_state_vec: pyarts3.arts.Vector | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets
model_state_vecto the sizejac_targetsdemand.Author: Richard Larsson
Used by wrapper method
- Parameters:
model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[OUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- model_state_vecPerturbations(self, model_state_vec: pyarts3.arts.Vector | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets
model_state_vecto the sizejac_targetsdemand.Then fills it with the perturbations from the
jac_targets.Author: Richard Larsson
- Parameters:
model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[OUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- model_state_vec_aprioriFromData(self, model_state_vec_apriori: pyarts3.arts.Vector | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, atm_field: pyarts3.arts.AtmField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None) None
Get
model_state_vec_apriorifrom available dataWrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.model_state_vecFromData() 6 ws.model_state_vec_aprioriFromState()
Author: Richard Larsson
- Parameters:
model_state_vec_apriori (Vector, optional) – An apriori state vector of the model. See
model_state_vec_apriori, defaults toself.model_state_vec_apriori[OUT]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]
- model_state_vec_aprioriFromState(self, model_state_vec_apriori: pyarts3.arts.Vector | None = None, model_state_vec: pyarts3.arts.Vector | None = None) None
Sets the a priori state of the model state vector to the current state.
Author: Richard Larsson
Used by wrapper method
- Parameters:
model_state_vec_apriori (Vector, optional) – An apriori state vector of the model. See
model_state_vec_apriori, defaults toself.model_state_vec_apriori[OUT]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]
- nlte_line_flux_profileIntegrate(self, nlte_line_flux_profile: pyarts3.arts.QuantumIdentifierVectorMap | None = None, spectral_flux_profile: pyarts3.arts.Matrix | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, atm_profile: pyarts3.arts.ArrayOfAtmPoint | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None) None
Integrate the spectral flux profile to get the line non-LTE flux
Author: Richard Larsson
- Parameters:
nlte_line_flux_profile (QuantumIdentifierVectorMap, optional) – A per-line flux profile. See
nlte_line_flux_profile, defaults toself.nlte_line_flux_profile[OUT]spectral_flux_profile (Matrix, optional) – An altitude profile of spectral flux. See
spectral_flux_profile, defaults toself.spectral_flux_profile[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]atm_profile (ArrayOfAtmPoint, optional) – An atmospheric profile in ARTS. See
atm_profile, defaults toself.atm_profile[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]
- ray_pathAddGeometricGridCrossings(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, atm_key: pyarts3.arts.AtmKey | None = None) None
Fill the path with with points that crosses the grid of the atmspheric field.
The atmospheric field parameter must be gridded. Only grids with size() > 1 are considered.
Points are added where the ray path crosses any of the three grids in pure geometrical manner.
Author: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[INOUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]atm_key (AtmKey, optional) – The atmospheric field key for which the grid is expected if adding grid crossings is desired. Defaults to
t[IN]
- ray_pathAddLimbPoint(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None) None
Add the limb point to the ray path
Author: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]
- ray_pathFillGeometricHalfStep(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, max_stepsize: pyarts3.arts.Numeric | None = None) None
Fill the path with geometric step points.
If two path points are more than
max_stepsizeapart, additional points are added at half the distance between these two points.This process is repeated until there are no more neighboring points for which the premise is true.
Author: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]
- ray_pathFillGeometricStepwise(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, max_stepsize: pyarts3.arts.Numeric | None = None) None
Fill the path with geometric step points.
If two path points are more than
max_stepsizeapart, additional points are added by propagating one of the points towards the other with a step length ofmax_stepsize.This process is repeated until there are no more neighboring points for which the premise is true.
Author: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]
- ray_pathFixUpdownAzimuth(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None) None
Fix azimuth angle errors that can occur for 180 and 0 degrees zenith.
These only matter for polarized radiative transfer.
Author: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[INOUT]
- ray_pathFromPointAndDepth(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, depth_profile: pyarts3.arts.DescendingGrid | None = None) None
Create a depth profile ray path from a point.
Author: Richard Larsson
Used by wrapper methods
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]depth_profile (DescendingGrid) – List of depths. [IN]
- ray_pathGeometric(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, max_stepsize: pyarts3.arts.Numeric | None = None, pos: pyarts3.arts.Vector3 | None = None, los: pyarts3.arts.Vector2 | None = None, surf_search_accuracy: pyarts3.arts.Numeric | None = None, as_observer: pyarts3.arts.Index | None = None, add_limb: pyarts3.arts.Index | None = None, remove_non_atm: pyarts3.arts.Index | None = None, fix_updown_azi: pyarts3.arts.Index | None = None, surf_safe_search: pyarts3.arts.Index | None = None) None
Get a geometric radiation path
The path is defined by the origo and the line of sight.
The
posis either at the end or at the beginning of the path depending on theas_observerflag. A value that evaluates to true means that it is at the end of the path. Ifas_observeris true, thelosis therefore looking backwards along the path. Basically,as_observertrue means thatposandlosbehaves as sensor pos and los.The
max_stepsizeis the maximum step length in meters. The path is first created between the two extremes of either space and/or surface. Afterwards, there are additional points added everymax_stepsizemeters between these points until no more fits (the last step is shorter or exactlymax_stepsize).Upon closing the method, the following options are available to modify the output:
If
add_limbis true, the limb point is added to the path at the end. It is computed using bisections to ensure that the zenith angle of the tangent point is as close to 90 degrees as it can numerically be.If
remove_non_atmis true, all points that are not in the atmosphere are removed. It is recommended to remove these points as multiple methods will either perform poorly or not at all with these points present.If
fix_updown_aziis true, the azimuthal angle of the path is fixed to the initial azimuthal angle of the path. Because calculations of the azimuth angle makes use of IEEE atan2, some paths may produce bad angles if this is turned off.Author: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]pos (Vector3) – The origo of the radiation path. [IN]
los (Vector2) – The line of sight of the radiation path. [IN]
surf_search_accuracy (Numeric, optional) – The accuracy within which the surface intersection is counted as a hit. Defaults to
0.1[IN]as_observer (Index, optional) – Whether or not the path is as seen by the sensor or by the radiation (see text). Defaults to
1[IN]add_limb (Index, optional) – Wheter or not to add the limb point. Defaults to
0[IN]remove_non_atm (Index, optional) – Wheter or not to keep only atmospheric points. Defaults to
1[IN]fix_updown_azi (Index, optional) – Whether or not to attempt fix a potential issue with the path azimuthal angle. Defaults to
1[IN]surf_safe_search (Index, optional) – Whether or not to search for the surface intersection in a safer but slower manner. Defaults to
1[IN]
- ray_pathGeometricDownlooking(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, max_stepsize: pyarts3.arts.Numeric | None = None) None
Wraps
ray_pathGeometric()for straight downlooking paths from the top-of-the-atmosphere altitudeAuthor: Richard Larsson
Used by wrapper methods
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]
- ray_pathGeometricUplooking(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, max_stepsize: pyarts3.arts.Numeric | None = None) None
Wraps
ray_pathGeometric()for straight uplooking paths from the surface altitude at the positionAuthor: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]
- ray_pathInit(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, pos: pyarts3.arts.Vector3 | None = None, los: pyarts3.arts.Vector2 | None = None, as_sensor: pyarts3.arts.Index | None = None) None
Initialize the ray path with a single point.
Author: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]pos (Vector3) – The start position. [IN]
los (Vector2) – The start line-of-sight. [IN]
as_sensor (Index, optional) – Whether or not the position is the sensor position or the observer position. Defaults to
1[IN]
- ray_pathRemoveNearby(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, min_distance: pyarts3.arts.Numeric | None = None, first: pyarts3.arts.Index | None = None) None
Remove points that are too close to each other.
Author: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[INOUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]min_distance (Numeric) – The minimum distance between points. [IN]
first (Index, optional) – Whether to remove the first or second point. Defaults to
0[IN]
- ray_pathRemoveNonAtm(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None) None
Remove non-atmospheric points to the ray path
Author: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[INOUT]
- ray_pathRemoveNonGeometricGridCrossings(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, atm_key: pyarts3.arts.AtmKey | None = None) None
Remove all non-geometric grid crossings from the ray path.
The atmospheric field parameter must be gridded. All points overlapping with any of the three grids are kept.
Author: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[INOUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]atm_key (AtmKey) – The atmospheric key. [IN]
- ray_pathSetGeometricExtremes(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, surf_search_accuracy: pyarts3.arts.Numeric | None = None, surf_safe_search: pyarts3.arts.Index | None = None) None
Add the geometric extremes to the ray path.
Author: Richard Larsson
- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[INOUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]surf_search_accuracy (Numeric, optional) – The accuracy within which the surface intersection is counted as a hit. Defaults to
0.1[IN]surf_safe_search (Index, optional) – Whether or not to search for the surface intersection in a safer but slower manner. Defaults to
1[IN]
- ray_path_fieldFluxProfile(self, ray_path_field: pyarts3.arts.ArrayOfArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None, azi: pyarts3.arts.Numeric | None = None, dzen: pyarts3.arts.Numeric | None = None, atm_key: pyarts3.arts.AtmKey | None = None) None
Adds observers that covers all zenith angles for each altitude point.
By default, up-looking from surface, downlooking from top of atmosphere and limb looking just hitting the surface and just missing the surface are added.
In addition to these, all up-looking ppoints will have additional observers for max
dzenresolution and all downlooking points will have additional observers for maxdzenresolution.Additional work is requires if proper coverage of the limb is required
Author: Richard Larsson
- Parameters:
ray_path_field (ArrayOfArrayOfPropagationPathPoint, optional) – A list of
ray_pathintended to build up a field of observations. Seeray_path_field, defaults toself.ray_path_field[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]ray_path_observer_agenda (Agenda, optional) – Gets the propagation path as it is obeserved. See
ray_path_observer_agenda, defaults toself.ray_path_observer_agenda[IN]azi (Numeric, optional) – Azimuth angle for the observer. Defaults to
0[IN]dzen (Numeric, optional) – The minimum step coverage in zenith angles. Defaults to
180[IN]atm_key (AtmKey, optional) – The altitude profile key in the atmosphere. Defaults to
t[IN]
- ray_path_fieldFromObserverAgenda(self, ray_path_field: pyarts3.arts.ArrayOfArrayOfPropagationPathPoint | None = None, ray_path_observers: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None) None
Create a ray path field from a set of observers.
Author: Richard Larsson
- Parameters:
ray_path_field (ArrayOfArrayOfPropagationPathPoint, optional) – A list of
ray_pathintended to build up a field of observations. Seeray_path_field, defaults toself.ray_path_field[OUT]ray_path_observers (ArrayOfPropagationPathPoint, optional) – A list path points making up the observers of a propagation path. See
ray_path_observers, defaults toself.ray_path_observers[IN]ray_path_observer_agenda (Agenda, optional) – Gets the propagation path as it is obeserved. See
ray_path_observer_agenda, defaults toself.ray_path_observer_agenda[IN]
- ray_path_observer_agendaExecute(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, obs_pos: pyarts3.arts.Vector3 | None = None, obs_los: pyarts3.arts.Vector2 | None = None, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
ray_path_observer_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]obs_pos (Vector3, optional) – The position of an observer of spectral radiance. See
obs_pos, defaults toself.obs_pos[IN]obs_los (Vector2, optional) – The line-of-sight of the observer of spectral radiance. See
obs_los, defaults toself.obs_los[IN]ray_path_observer_agenda (Agenda, optional) – Gets the propagation path as it is obeserved. See
ray_path_observer_agenda, defaults toself.ray_path_observer_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- ray_path_observer_agendaExecuteOperator(self, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, obs_pos: pyarts3.arts.Vector3 | None = None, obs_los: pyarts3.arts.Vector2 | None = None, ray_path_observer_agenda_operator: pyarts3.arts.ray_path_observer_agendaOperator | None = None) None
Executes an operator emulating
ray_path_observer_agenda, see it, and alsoray_path_observer_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]obs_pos (Vector3, optional) – The position of an observer of spectral radiance. See
obs_pos, defaults toself.obs_pos[IN]obs_los (Vector2, optional) – The line-of-sight of the observer of spectral radiance. See
obs_los, defaults toself.obs_los[IN]ray_path_observer_agenda_operator (ray_path_observer_agendaOperator) – Operator for
ray_path_observer_agenda. [IN]
- ray_path_observer_agendaSetGeometric(self, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None, max_step_option: pyarts3.arts.String | None = None, surf_search_accuracy: pyarts3.arts.Numeric | None = None, remove_nearby: pyarts3.arts.Numeric | None = None, atm_key: pyarts3.arts.AtmKey | None = None, surf_safe_search: pyarts3.arts.Index | None = None, remove_nearby_first: pyarts3.arts.Index | None = None, add_crossings: pyarts3.arts.Index | None = None, remove_non_crossings: pyarts3.arts.Index | None = None, fix_updown_azi: pyarts3.arts.Index | None = None, add_limb: pyarts3.arts.Index | None = None, remove_non_atm: pyarts3.arts.Index | None = None) None
Set
ray_path_observer_agendafrom programmable geometric settings.The default settings essentially call the default settings for
ray_pathGeometric().Options:
max_step_option: Choose the maximum distance between two points. Setmax_stepsizefor the distance.surf_search_accuracyandsurf_safe_search: The accuracy to search for surface intersections and whether or not to do it at all.remove_nearbyandremove_nearby_first: The minimum distance between points, ignored if 0 or less. The second option tells which point to remove if they are too close.atm_keyandadd_crossingsandremove_non_crossings: The atmospheric field key for which the grid is expected if adding grid crossings is desired. The other two options tell whether to add all grid points or remove non-crossings. The removal happens after the filling of the path.fix_updown_azi: Fix the azimuth angle when looking at 0 or 180 degrees.add_limb: Add the limb point.remove_non_atm: Remove points in space or in the subsurface.
Author: Richard Larsson
- Parameters:
ray_path_observer_agenda (Agenda, optional) – Gets the propagation path as it is obeserved. See
ray_path_observer_agenda, defaults toself.ray_path_observer_agenda[OUT]max_step_option (String, optional) – Option for max stepping. See
ray_path_observer_agendaSetGeometricMaxStep. Defaults to"step"[IN]surf_search_accuracy (Numeric, optional) – The accuracy to search for surface intersections. Defaults to
0.1[IN]remove_nearby (Numeric, optional) – The minimum distance between points, ignroed if 0 or less. Defaults to
0[IN]atm_key (AtmKey, optional) – The atmospheric field key for which the grid is expected if adding grid crossings is desired. Defaults to
t[IN]surf_safe_search (Index, optional) – Whether or not to search for the surface intersection in a safer but slower manner. Defaults to
1[IN]remove_nearby_first (Index, optional) – Which point (first or second) to remove if they are too close. Defaults to
1[IN]add_crossings (Index, optional) – Add all grid crossings. Defaults to
0[IN]remove_non_crossings (Index, optional) – Remove non-crossings. Defaults to
0[IN]fix_updown_azi (Index, optional) – Fix the azimuth angle when looking at 0 or 180 degrees. Defaults to
1[IN]add_limb (Index, optional) – Add the limb point. Defaults to
0[IN]remove_non_atm (Index, optional) – Remove non-atmospheric points. Defaults to
1[IN]
- ray_path_observer_agendaSetOperator(self, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.ray_path_observer_agendaOperator | None = None) None
Set
ray_path_observer_agendato exclusively use provided external operator. Seeray_path_observer_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
ray_path_observer_agenda (Agenda, optional) – Gets the propagation path as it is obeserved. See
ray_path_observer_agenda, defaults toself.ray_path_observer_agenda[OUT]f (ray_path_observer_agendaOperator) – Operator for
ray_path_observer_agenda. [IN]
- ray_path_observersFieldProfilePseudo2D(self, ray_path_observers: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, azi: pyarts3.arts.Numeric | None = None, nup: pyarts3.arts.Index | None = None, nlimb: pyarts3.arts.Index | None = None, ndown: pyarts3.arts.Index | None = None) None
Get a list of observer positions and line of sights to represent observing all angles of a profile.
Three observer types are added:
Downward looking. At the top-of-atmosphere, cover [zen+e, 180] degrees zenith.
Limb looking. At top of the atmosphere, cover [90, zen-e] degrees zenith.
Upward looking. At the surface, cover [0, 90] degrees zenith.
Here zen is the surface tangent zenith angle from the top of the atmosphere. e indicates the smallest possible numerical offset from that angle in the signed direction.
Note
Each position has their zenith angle coverage linearly separated in degrees. To avoid the top-of-atmosphere limb singularity and bottom of atmosphere limb overlap, the limb zentih angle grid is divided into nlimb+1 segments. The 90 degree angle is then discarded.
See also
pyarts3.plots.ArrayOfPropagationPathPoint.plot()for a visualization of the geometry.Author: Richard Larsson
- Parameters:
ray_path_observers (ArrayOfPropagationPathPoint, optional) – A list path points making up the observers of a propagation path. See
ray_path_observers, defaults toself.ray_path_observers[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]ray_path_observer_agenda (Agenda, optional) – Gets the propagation path as it is obeserved. See
ray_path_observer_agenda, defaults toself.ray_path_observer_agenda[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]azi (Numeric, optional) – Azimuth angle for the observer. Defaults to
0[IN]nup (Index) – Number of upward looking observers (min 2). [IN]
nlimb (Index) – Number of limb looking observers (min 2). [IN]
ndown (Index) – Number of downward looking observers (min 2). [IN]
- ray_path_observersFluxProfile(self, ray_path_observers: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, azi: pyarts3.arts.Numeric | None = None, n: pyarts3.arts.Index | None = None, atm_key: pyarts3.arts.AtmKey | None = None) None
Add \(n\) observers per altitude point.
The number \(n\) must be uneven and larger than 2.
Author: Richard Larsson
- Parameters:
ray_path_observers (ArrayOfPropagationPathPoint, optional) – A list path points making up the observers of a propagation path. See
ray_path_observers, defaults toself.ray_path_observers[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]azi (Numeric, optional) – Azimuth angle for the observer. Defaults to
0[IN]n (Index) – Number of limb looking observers (min 2). \(n\) above. [IN]
atm_key (AtmKey, optional) – The altitude profile key in the atmosphere. Defaults to
t[IN]
- ray_path_suns_pathFromPathObserver(self, ray_path_suns_path: pyarts3.arts.ArrayOfArrayOfArrayOfPropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, suns: pyarts3.arts.ArrayOfSun | None = None, angle_cut: pyarts3.arts.Numeric | None = None, refinement: pyarts3.arts.Index | None = None, just_hit: pyarts3.arts.Index | None = None) None
Wraps
sun_pathFromObserverAgenda()for all paths to all suns.Author: Richard Larsson
- Parameters:
ray_path_suns_path (ArrayOfArrayOfArrayOfPropagationPathPoint, optional) – A list of paths to the suns from the ray path. See
ray_path_suns_path, defaults toself.ray_path_suns_path[OUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]ray_path_observer_agenda (Agenda, optional) – Gets the propagation path as it is obeserved. See
ray_path_observer_agenda, defaults toself.ray_path_observer_agenda[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]suns (ArrayOfSun, optional) – A list of
Sun. Seesuns, defaults toself.suns[IN]angle_cut (Numeric, optional) – The angle delta-cutoff in the iterative solver [0.0, …]. Defaults to
0[IN]refinement (Index, optional) – The refinement of the search algorithm (twice the power of this is the resultion). Defaults to
1[IN]just_hit (Index, optional) – Whether or not it is enough to just hit the sun or if better accuracy is needed. Defaults to
0[IN]
- ray_path_zeeman_magnetic_fieldFromPath(self, ray_path_zeeman_magnetic_field: pyarts3.arts.ArrayOfVector3 | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None) None
Sets a path of Zeeman effect magnetic field properties.
This will return a list of magnetic field properties along the path. The magnetic properties in Zeeman coordinates are the absolute strength [H], the angle between the magnetic field and the line of sight [theta], and the the rotation of the magnetic field in the plane perpendicular to the line of sight [eta].
This is mostly a convenience method to allow diagnostic plotting of the magnetic field along the path.
Author: Richard Larsson
- Parameters:
ray_path_zeeman_magnetic_field (ArrayOfVector3) – Along-the-path [H, theta, eta]. Defaults to create and/or use
self.ray_path_zeeman_magnetic_field:ArrayOfVector3. [OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]
- ray_pointBackground(self, ray_point: pyarts3.arts.PropagationPathPoint | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None) None
Sets
ray_pointto the expected background point ofray_pathAuthor: Richard Larsson
Used by wrapper methods
- Parameters:
ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]
- ray_pointForeground(self, ray_point: pyarts3.arts.PropagationPathPoint | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None) None
Sets
ray_pointto the expected foreground point ofray_pathAuthor: Richard Larsson
Used by wrapper method
- Parameters:
ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]
- ray_pointHighestFromPath(self, ray_point: pyarts3.arts.PropagationPathPoint | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None) None
Sets
ray_pointto the highest altitude point ofray_path.Author: Richard Larsson
- Parameters:
ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]
- ray_pointLowestFromPath(self, ray_point: pyarts3.arts.PropagationPathPoint | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None) None
Sets
ray_pointto the lowest altitude point ofray_path.Author: Richard Larsson
- Parameters:
ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]
- ray_pointPastGeometric(self, ray_point: pyarts3.arts.PropagationPathPoint | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, max_stepsize: pyarts3.arts.Numeric | None = None, surf_search_accuracy: pyarts3.arts.Numeric | None = None, surf_safe_search: pyarts3.arts.Index | None = None) None
Gets the previous geometric point along
ray_pathAuthor: Richard Larsson
- Parameters:
ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]surf_search_accuracy (Numeric, optional) – The accuracy within which the surface intersection is counted as a hit. Defaults to
0.1[IN]surf_safe_search (Index, optional) – Whether or not to search for the surface intersection in a safer but slower manner. Defaults to
1[IN]
- ray_pointPastRefractive(self, ray_point: pyarts3.arts.PropagationPathPoint | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, max_stepsize: pyarts3.arts.Numeric | None = None, single_dispersion: pyarts3.arts.Numeric | None = None, surf_search_accuracy: pyarts3.arts.Numeric | None = None, surf_safe_search: pyarts3.arts.Index | None = None) None
Gets the previous refractive point along
ray_pathThis basically wraps
ray_pointPastGeometric()but sets the zenith angle to the refracted zenith angle, i.e.,\[\theta_{refracted} = \arcsin\left(\frac{n_{current}}{n_{next}}\sin(\theta_{current})\right)\]Author: Richard Larsson
- Parameters:
ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]single_dispersion (Numeric, optional) – A dispersion at a single
freqpoint. Seesingle_dispersion, defaults toself.single_dispersion[IN]surf_search_accuracy (Numeric, optional) – The accuracy within which the surface intersection is counted as a hit. Defaults to
0.1[IN]surf_safe_search (Index, optional) – Whether or not to search for the surface intersection in a safer but slower manner. Defaults to
1[IN]
- ray_point_back_propagation_agendaExecute(self, ray_point: pyarts3.arts.PropagationPathPoint | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, single_dispersion: pyarts3.arts.Numeric | None = None, single_propmat: pyarts3.arts.Propmat | None = None, max_stepsize: pyarts3.arts.Numeric | None = None, ray_point_back_propagation_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
ray_point_back_propagation_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]single_dispersion (Numeric, optional) – A dispersion at a single
freqpoint. Seesingle_dispersion, defaults toself.single_dispersion[IN]single_propmat (Propmat, optional) – A propagation matrix at a single
freqpoint. Seesingle_propmat, defaults toself.single_propmat[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]ray_point_back_propagation_agenda (Agenda, optional) – Gets the next past point along a propagation path. See
ray_point_back_propagation_agenda, defaults toself.ray_point_back_propagation_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- ray_point_back_propagation_agendaExecuteOperator(self, ray_point: pyarts3.arts.PropagationPathPoint | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, single_dispersion: pyarts3.arts.Numeric | None = None, single_propmat: pyarts3.arts.Propmat | None = None, max_stepsize: pyarts3.arts.Numeric | None = None, ray_point_back_propagation_agenda_operator: pyarts3.arts.ray_point_back_propagation_agendaOperator | None = None) None
Executes an operator emulating
ray_point_back_propagation_agenda, see it, and alsoray_point_back_propagation_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]single_dispersion (Numeric, optional) – A dispersion at a single
freqpoint. Seesingle_dispersion, defaults toself.single_dispersion[IN]single_propmat (Propmat, optional) – A propagation matrix at a single
freqpoint. Seesingle_propmat, defaults toself.single_propmat[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]ray_point_back_propagation_agenda_operator (ray_point_back_propagation_agendaOperator) – Operator for
ray_point_back_propagation_agenda. [IN]
- ray_point_back_propagation_agendaSet(self, ray_point_back_propagation_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
ray_point_back_propagation_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
ray_point_back_propagation_agenda (Agenda, optional) – Gets the next past point along a propagation path. See
ray_point_back_propagation_agenda, defaults toself.ray_point_back_propagation_agenda[OUT]option (String, optional) – Choice of generated agenda. Defaults to
"GeometricStepwise"[IN]
Valid options
These are the valid options for the
ray_point_back_propagation_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
ray_point_back_propagation_agendaSet(option="GeometricStepwise")Shares the global
atm_fieldShares the global
surf_fieldsurf_search_accuracy = 0.1
surf_safe_search = 1
Ignore(), using: input =single_dispersionIgnore(), using: input =single_propmat
ray_point_back_propagation_agendaSet(option="RefractiveStepwise")Shares the global
atm_fieldShares the global
surf_fieldsurf_search_accuracy = 0.1
surf_safe_search = 1
Ignore(), using: input =single_propmat
- ray_point_back_propagation_agendaSetOperator(self, ray_point_back_propagation_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.ray_point_back_propagation_agendaOperator | None = None) None
Set
ray_point_back_propagation_agendato exclusively use provided external operator. Seeray_point_back_propagation_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
ray_point_back_propagation_agenda (Agenda, optional) – Gets the next past point along a propagation path. See
ray_point_back_propagation_agenda, defaults toself.ray_point_back_propagation_agenda[OUT]f (ray_point_back_propagation_agendaOperator) – Operator for
ray_point_back_propagation_agenda. [IN]
- readxml(self, file: str) str
Read variable from file.
- Parameters:
file (str) – A file that can be read.
- Raises:
RuntimeError – For any failure to read.
- Returns:
file – The file path found (may differ from input due to environment variables).
- Return type:
- savexml(self, file: str, type: str = 'ascii', clobber: bool = True) str
Saves variable to file.
- Parameters:
file (str) – The path to which the file is written. Note that several of the options might modify the name or write more files.
type (str, optional) – Type of file to save. See
FileTypefor options. Defaults is “ascii”.clobber (bool, optional) – Overwrite existing files or add new file with modified name? Defaults is True.
- Raises:
RuntimeError – For any failure to write.
- Returns:
file – The file saved. May differ from input.
- Return type:
- scat_speciesInit(self, scat_species: pyarts3.arts.ArrayOfScatteringSpecies | None = None) None
Initialize scattering species.
Author: Richard Larsson
- Parameters:
scat_species (ArrayOfScatteringSpecies, optional) – The scattering species. See
scat_species, defaults toself.scat_species[OUT]
- single_propmatAddVoigtLTE(self, single_propmat: pyarts3.arts.Propmat | None = None, single_propmat_jac: pyarts3.arts.PropmatVector | None = None, single_dispersion: pyarts3.arts.Numeric | None = None, single_dispersion_jac: pyarts3.arts.Vector | None = None, freq: pyarts3.arts.Numeric | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, no_negative_absorption: pyarts3.arts.Index | None = None) None
Add line-by-line absorption to the propagation matrix.
See Line-by-line Absorption for details.
This is only for LTE lines in Voigt.
Author: Richard Larsson
- Parameters:
single_propmat (Propmat, optional) – A propagation matrix at a single
freqpoint. Seesingle_propmat, defaults toself.single_propmat[INOUT]single_propmat_jac (PropmatVector, optional) – A propagation matrix Jacobian at a single
freqpoint. Seesingle_propmat_jac, defaults toself.single_propmat_jac[INOUT]single_dispersion (Numeric, optional) – A dispersion at a single
freqpoint. Seesingle_dispersion, defaults toself.single_dispersion[INOUT]single_dispersion_jac (Vector, optional) – A dispersion Jacobian at a single
freqpoint. Seesingle_dispersion_jac, defaults toself.single_dispersion_jac[INOUT]freq (Numeric, optional) – A single frequency. Unit: Hz. See
freq, defaults toself.freq[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]no_negative_absorption (Index, optional) – Turn off to allow individual absorbers to have negative absorption. Defaults to
1[IN]
- single_propmatInit(self, single_propmat: pyarts3.arts.Propmat | None = None, single_propmat_jac: pyarts3.arts.PropmatVector | None = None, single_nlte_srcvec: pyarts3.arts.Stokvec | None = None, single_nlte_srcvec_jac: pyarts3.arts.StokvecVector | None = None, single_dispersion: pyarts3.arts.Numeric | None = None, single_dispersion_jac: pyarts3.arts.Vector | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Initialize single-point propagation matrix fields.
Author: Richard Larsson
- Parameters:
single_propmat (Propmat, optional) – A propagation matrix at a single
freqpoint. Seesingle_propmat, defaults toself.single_propmat[OUT]single_propmat_jac (PropmatVector, optional) – A propagation matrix Jacobian at a single
freqpoint. Seesingle_propmat_jac, defaults toself.single_propmat_jac[OUT]single_nlte_srcvec (Stokvec, optional) – A non-LTE source vector at a single
freqpoint. Seesingle_nlte_srcvec, defaults toself.single_nlte_srcvec[OUT]single_nlte_srcvec_jac (StokvecVector, optional) – A non-LTE source vector Jacobian at a single
freqpoint. Seesingle_nlte_srcvec_jac, defaults toself.single_nlte_srcvec_jac[OUT]single_dispersion (Numeric, optional) – A dispersion at a single
freqpoint. Seesingle_dispersion, defaults toself.single_dispersion[OUT]single_dispersion_jac (Vector, optional) – A dispersion Jacobian at a single
freqpoint. Seesingle_dispersion_jac, defaults toself.single_dispersion_jac[OUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- single_propmat_agendaExecute(self, single_propmat: pyarts3.arts.Propmat | None = None, single_nlte_srcvec: pyarts3.arts.Stokvec | None = None, single_dispersion: pyarts3.arts.Numeric | None = None, single_propmat_jac: pyarts3.arts.PropmatVector | None = None, single_nlte_srcvec_jac: pyarts3.arts.StokvecVector | None = None, single_dispersion_jac: pyarts3.arts.Vector | None = None, freq: pyarts3.arts.Numeric | None = None, freq_wind_shift_jac: pyarts3.arts.Vector3 | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, single_propmat_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
single_propmat_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
single_propmat (Propmat, optional) – A propagation matrix at a single
freqpoint. Seesingle_propmat, defaults toself.single_propmat[OUT]single_nlte_srcvec (Stokvec, optional) – A non-LTE source vector at a single
freqpoint. Seesingle_nlte_srcvec, defaults toself.single_nlte_srcvec[OUT]single_dispersion (Numeric, optional) – A dispersion at a single
freqpoint. Seesingle_dispersion, defaults toself.single_dispersion[OUT]single_propmat_jac (PropmatVector, optional) – A propagation matrix Jacobian at a single
freqpoint. Seesingle_propmat_jac, defaults toself.single_propmat_jac[OUT]single_nlte_srcvec_jac (StokvecVector, optional) – A non-LTE source vector Jacobian at a single
freqpoint. Seesingle_nlte_srcvec_jac, defaults toself.single_nlte_srcvec_jac[OUT]single_dispersion_jac (Vector, optional) – A dispersion Jacobian at a single
freqpoint. Seesingle_dispersion_jac, defaults toself.single_dispersion_jac[OUT]freq (Numeric, optional) – A single frequency. Unit: Hz. See
freq, defaults toself.freq[IN]freq_wind_shift_jac (Vector3, optional) – The frequency wind shift Jacobian. See
freq_wind_shift_jac, defaults toself.freq_wind_shift_jac[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]single_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, the dispersion, and their derivatives. See
single_propmat_agenda, defaults toself.single_propmat_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- single_propmat_agendaExecuteOperator(self, single_propmat: pyarts3.arts.Propmat | None = None, single_nlte_srcvec: pyarts3.arts.Stokvec | None = None, single_dispersion: pyarts3.arts.Numeric | None = None, single_propmat_jac: pyarts3.arts.PropmatVector | None = None, single_nlte_srcvec_jac: pyarts3.arts.StokvecVector | None = None, single_dispersion_jac: pyarts3.arts.Vector | None = None, freq: pyarts3.arts.Numeric | None = None, freq_wind_shift_jac: pyarts3.arts.Vector3 | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, single_propmat_agenda_operator: pyarts3.arts.single_propmat_agendaOperator | None = None) None
Executes an operator emulating
single_propmat_agenda, see it, and alsosingle_propmat_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
single_propmat (Propmat, optional) – A propagation matrix at a single
freqpoint. Seesingle_propmat, defaults toself.single_propmat[OUT]single_nlte_srcvec (Stokvec, optional) – A non-LTE source vector at a single
freqpoint. Seesingle_nlte_srcvec, defaults toself.single_nlte_srcvec[OUT]single_dispersion (Numeric, optional) – A dispersion at a single
freqpoint. Seesingle_dispersion, defaults toself.single_dispersion[OUT]single_propmat_jac (PropmatVector, optional) – A propagation matrix Jacobian at a single
freqpoint. Seesingle_propmat_jac, defaults toself.single_propmat_jac[OUT]single_nlte_srcvec_jac (StokvecVector, optional) – A non-LTE source vector Jacobian at a single
freqpoint. Seesingle_nlte_srcvec_jac, defaults toself.single_nlte_srcvec_jac[OUT]single_dispersion_jac (Vector, optional) – A dispersion Jacobian at a single
freqpoint. Seesingle_dispersion_jac, defaults toself.single_dispersion_jac[OUT]freq (Numeric, optional) – A single frequency. Unit: Hz. See
freq, defaults toself.freq[IN]freq_wind_shift_jac (Vector3, optional) – The frequency wind shift Jacobian. See
freq_wind_shift_jac, defaults toself.freq_wind_shift_jac[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]single_propmat_agenda_operator (single_propmat_agendaOperator) – Operator for
single_propmat_agenda. [IN]
- single_propmat_agendaSetOperator(self, single_propmat_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.single_propmat_agendaOperator | None = None) None
Set
single_propmat_agendato exclusively use provided external operator. Seesingle_propmat_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
single_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, the dispersion, and their derivatives. See
single_propmat_agenda, defaults toself.single_propmat_agenda[OUT]f (single_propmat_agendaOperator) – Operator for
single_propmat_agenda. [IN]
- single_radClearskyEmissionPropagation(self, single_rad: pyarts3.arts.Stokvec | None = None, single_rad_jac: pyarts3.arts.StokvecVector | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, freq: pyarts3.arts.Numeric | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, single_rad_space_agenda: pyarts3.arts.Agenda | None = None, single_rad_surface_agenda: pyarts3.arts.Agenda | None = None, single_propmat_agenda: pyarts3.arts.Agenda | None = None, ray_point_back_propagation_agenda: pyarts3.arts.Agenda | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, obs_pos: pyarts3.arts.Vector3 | None = None, obs_los: pyarts3.arts.Vector2 | None = None, max_stepsize: pyarts3.arts.Numeric | None = None, polarization: pyarts3.arts.Propmat | None = None, max_tau: pyarts3.arts.Numeric | None = None, cutoff_tau: pyarts3.arts.Numeric | None = None, hse_derivative: pyarts3.arts.Index | None = None, N: pyarts3.arts.Index | None = None) None
Computes the spectral radiance for a single frequency using clear-sky emission propagation.
The path is built based on current optical properties and the radiative transfer equation is solved along the path. This means that the path is not precomputed but built on-the-fly, allowing per-frequency refraction.
Author: Richard Larsson
- Parameters:
single_rad (Stokvec, optional) – Single value version of
spectral_rad. Seesingle_rad, defaults toself.single_rad[OUT]single_rad_jac (StokvecVector, optional) – Single value version of
spectral_rad_jac. Seesingle_rad_jac, defaults toself.single_rad_jac[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]freq (Numeric, optional) – A single frequency. Unit: Hz. See
freq, defaults toself.freq[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]single_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space for a single frequency. See
single_rad_space_agenda, defaults toself.single_rad_space_agenda[IN]single_rad_surface_agenda (Agenda, optional) – Gets spectral radiance as seen of the surface for a single frequency. See
single_rad_surface_agenda, defaults toself.single_rad_surface_agenda[IN]single_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, the dispersion, and their derivatives. See
single_propmat_agenda, defaults toself.single_propmat_agenda[IN]ray_point_back_propagation_agenda (Agenda, optional) – Gets the next past point along a propagation path. See
ray_point_back_propagation_agenda, defaults toself.ray_point_back_propagation_agenda[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]obs_pos (Vector3, optional) – The position of an observer of spectral radiance. See
obs_pos, defaults toself.obs_pos[IN]obs_los (Vector2, optional) – The line-of-sight of the observer of spectral radiance. See
obs_los, defaults toself.obs_los[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]polarization (Propmat, optional) – Delta of the dispersion in polarizized form. The dot-product of this and the propagation matrix is added to the internal
single_dispersionvariable. Defaults to0 0 0 0 0 0 0[IN]max_tau (Numeric, optional) – The maximum optical thickness per step, min of local
PropmatA divided bymax_tauandmax_stepsizeis passed toray_point_back_propagation_agendaExecute(). Note that this is an approximation that will fail for highly non-linear absorption profiles. As implemented, it takes too long steps if going from low to high absorption, and too short steps when going from high to low absorption. See it as an approximation. Defaults to0.01[IN]cutoff_tau (Numeric, optional) – Cutoff optical thickness for terminating the integration, computed as total
PropmatA times distance. If exceeded, the atmosphere is considered opaque and the temperature at that coordinate is used for the background radiation. If not exceeded, the actual background is considered. Note that errors will be large if exp(-cutoff_tau) is not small. Defaults to14[IN]hse_derivative (Index, optional) – Flag to compute the hypsometric distance derivatives. Defaults to
0[IN]N (Index, optional) – Number of points to reserve in the ray path. Defaults to
1[IN]
- single_radFromVector(self, single_rad: pyarts3.arts.Stokvec | None = None, single_rad_jac: pyarts3.arts.StokvecVector | None = None, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, index: pyarts3.arts.Index | None = None) None
Composition method to extract a single spectral radiance from a vector.
Author: Richard Larsson
- Parameters:
single_rad (Stokvec, optional) – Single value version of
spectral_rad. Seesingle_rad, defaults toself.single_rad[OUT]single_rad_jac (StokvecVector, optional) – Single value version of
spectral_rad_jac. Seesingle_rad_jac, defaults toself.single_rad_jac[OUT]spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[IN]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[IN]index (Index, optional) – Index into the first dimension of the spectral radiance. Defaults to
0[IN]
- single_rad_space_agendaExecute(self, single_rad: pyarts3.arts.Stokvec | None = None, single_rad_jac: pyarts3.arts.StokvecVector | None = None, freq: pyarts3.arts.Numeric | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, single_rad_space_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
single_rad_space_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
single_rad (Stokvec, optional) – Single value version of
spectral_rad. Seesingle_rad, defaults toself.single_rad[OUT]single_rad_jac (StokvecVector, optional) – Single value version of
spectral_rad_jac. Seesingle_rad_jac, defaults toself.single_rad_jac[OUT]freq (Numeric, optional) – A single frequency. Unit: Hz. See
freq, defaults toself.freq[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]single_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space for a single frequency. See
single_rad_space_agenda, defaults toself.single_rad_space_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- single_rad_space_agendaExecuteOperator(self, single_rad: pyarts3.arts.Stokvec | None = None, single_rad_jac: pyarts3.arts.StokvecVector | None = None, freq: pyarts3.arts.Numeric | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, single_rad_space_agenda_operator: pyarts3.arts.single_rad_space_agendaOperator | None = None) None
Executes an operator emulating
single_rad_space_agenda, see it, and alsosingle_rad_space_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
single_rad (Stokvec, optional) – Single value version of
spectral_rad. Seesingle_rad, defaults toself.single_rad[OUT]single_rad_jac (StokvecVector, optional) – Single value version of
spectral_rad_jac. Seesingle_rad_jac, defaults toself.single_rad_jac[OUT]freq (Numeric, optional) – A single frequency. Unit: Hz. See
freq, defaults toself.freq[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]single_rad_space_agenda_operator (single_rad_space_agendaOperator) – Operator for
single_rad_space_agenda. [IN]
- single_rad_space_agendaSet(self, single_rad_space_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
single_rad_space_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
single_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space for a single frequency. See
single_rad_space_agenda, defaults toself.single_rad_space_agenda[OUT]option (String, optional) – Choice of generated agenda. Defaults to
"WrapGrid"[IN]
Valid options
These are the valid options for the
single_rad_space_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
single_rad_space_agendaSet(option="WrapGrid")Shares the global
spectral_rad_space_agendaindex = 0
- single_rad_space_agendaSetOperator(self, single_rad_space_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.single_rad_space_agendaOperator | None = None) None
Set
single_rad_space_agendato exclusively use provided external operator. Seesingle_rad_space_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
single_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space for a single frequency. See
single_rad_space_agenda, defaults toself.single_rad_space_agenda[OUT]f (single_rad_space_agendaOperator) – Operator for
single_rad_space_agenda. [IN]
- single_rad_surface_agendaExecute(self, single_rad: pyarts3.arts.Stokvec | None = None, single_rad_jac: pyarts3.arts.StokvecVector | None = None, freq: pyarts3.arts.Numeric | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, single_rad_surface_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
single_rad_surface_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
single_rad (Stokvec, optional) – Single value version of
spectral_rad. Seesingle_rad, defaults toself.single_rad[OUT]single_rad_jac (StokvecVector, optional) – Single value version of
spectral_rad_jac. Seesingle_rad_jac, defaults toself.single_rad_jac[OUT]freq (Numeric, optional) – A single frequency. Unit: Hz. See
freq, defaults toself.freq[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]single_rad_surface_agenda (Agenda, optional) – Gets spectral radiance as seen of the surface for a single frequency. See
single_rad_surface_agenda, defaults toself.single_rad_surface_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- single_rad_surface_agendaExecuteOperator(self, single_rad: pyarts3.arts.Stokvec | None = None, single_rad_jac: pyarts3.arts.StokvecVector | None = None, freq: pyarts3.arts.Numeric | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, single_rad_surface_agenda_operator: pyarts3.arts.single_rad_surface_agendaOperator | None = None) None
Executes an operator emulating
single_rad_surface_agenda, see it, and alsosingle_rad_surface_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
single_rad (Stokvec, optional) – Single value version of
spectral_rad. Seesingle_rad, defaults toself.single_rad[OUT]single_rad_jac (StokvecVector, optional) – Single value version of
spectral_rad_jac. Seesingle_rad_jac, defaults toself.single_rad_jac[OUT]freq (Numeric, optional) – A single frequency. Unit: Hz. See
freq, defaults toself.freq[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]single_rad_surface_agenda_operator (single_rad_surface_agendaOperator) – Operator for
single_rad_surface_agenda. [IN]
- single_rad_surface_agendaSet(self, single_rad_surface_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
single_rad_surface_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
single_rad_surface_agenda (Agenda, optional) – Gets spectral radiance as seen of the surface for a single frequency. See
single_rad_surface_agenda, defaults toself.single_rad_surface_agenda[OUT]option (String, optional) – Choice of generated agenda. Defaults to
"WrapGrid"[IN]
Valid options
These are the valid options for the
single_rad_surface_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
single_rad_surface_agendaSet(option="WrapGrid")Shares the global
spectral_rad_surface_agendaindex = 0
- single_rad_surface_agendaSetOperator(self, single_rad_surface_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.single_rad_surface_agendaOperator | None = None) None
Set
single_rad_surface_agendato exclusively use provided external operator. Seesingle_rad_surface_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
single_rad_surface_agenda (Agenda, optional) – Gets spectral radiance as seen of the surface for a single frequency. See
single_rad_surface_agenda, defaults toself.single_rad_surface_agenda[OUT]f (single_rad_surface_agendaOperator) – Operator for
single_rad_surface_agenda. [IN]
- spectral_flux_profileFromPathField(self, spectral_flux_profile: pyarts3.arts.Matrix | None = None, ray_path_field: pyarts3.arts.ArrayOfArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_space_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_surface_agenda: pyarts3.arts.Agenda | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, alt_grid: pyarts3.arts.AscendingGrid | None = None) None
Computes the spectral flux from a field of paths.
Author: Richard Larsson
- Parameters:
spectral_flux_profile (Matrix, optional) – An altitude profile of spectral flux. See
spectral_flux_profile, defaults toself.spectral_flux_profile[OUT]ray_path_field (ArrayOfArrayOfPropagationPathPoint, optional) – A list of
ray_pathintended to build up a field of observations. Seeray_path_field, defaults toself.ray_path_field[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]spectral_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space. See
spectral_rad_space_agenda, defaults toself.spectral_rad_space_agenda[IN]spectral_rad_surface_agenda (Agenda, optional) – Computes spectral radiance as seen of the surface. See
spectral_rad_surface_agenda, defaults toself.spectral_rad_surface_agenda[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]alt_grid (AscendingGrid, optional) – An ascending list of
alt. Often related to a field or a profile. Seealt_grid, defaults toself.alt_grid[IN]
- spectral_flux_profileFromSpectralRadianceField(self, spectral_flux_profile: pyarts3.arts.Matrix | None = None, spectral_rad_field: pyarts3.arts.GriddedSpectralField6 | None = None, pol: pyarts3.arts.Stokvec | None = None) None
Computes the spectral flux. The input field must be a profile.
Author: Richard Larsson
Used by wrapper method
- Parameters:
spectral_flux_profile (Matrix, optional) – An altitude profile of spectral flux. See
spectral_flux_profile, defaults toself.spectral_flux_profile[OUT]spectral_rad_field (GriddedSpectralField6, optional) – The spectral radiance field. See
spectral_rad_field, defaults toself.spectral_rad_field[IN]pol (Stokvec, optional) – Polarization vector for the spectral flux profile. Defaults to
1 0 0 0[IN]
- spectral_flux_profilePseudo2D(self, spectral_flux_profile: pyarts3.arts.Matrix | None = None, alt_grid: pyarts3.arts.AscendingGrid | None = None, atm_profile: pyarts3.arts.ArrayOfAtmPoint | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, pol: pyarts3.arts.Stokvec | None = None, dzen: pyarts3.arts.Numeric | None = None, consider_limb: pyarts3.arts.Index | None = None, azi: pyarts3.arts.Numeric | None = None) None
Computes the spectral flux profile using pseudo-2D geometry
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.zen_gridProfilePseudo2D() 6 ws.spectral_rad_fieldProfilePseudo2D() 7 ws.spectral_flux_profileFromSpectralRadianceField()
Author: Richard Larsson
- Parameters:
spectral_flux_profile (Matrix, optional) – An altitude profile of spectral flux. See
spectral_flux_profile, defaults toself.spectral_flux_profile[OUT]alt_grid (AscendingGrid, optional) – An ascending list of
alt. Often related to a field or a profile. Seealt_grid, defaults toself.alt_grid[IN]atm_profile (ArrayOfAtmPoint, optional) – An atmospheric profile in ARTS. See
atm_profile, defaults toself.atm_profile[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]pol (Stokvec, optional) – Polarization vector for the spectral flux profile. Defaults to
1 0 0 0[IN]dzen (Numeric, optional) – The zenith grid max step size. Defaults to
1[IN]consider_limb (Index, optional) – Whether or not special care is given to the limb. Defaults to
1[IN]azi (Numeric, optional) – The azimuth. Defaults to
0[IN]
- spectral_propmatAddCIA(self, spectral_propmat: pyarts3.arts.PropmatVector | None = None, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, abs_cia_data: pyarts3.arts.ArrayOfCIARecord | None = None, T_extrapolfac: pyarts3.arts.Numeric | None = None, ignore_errors: pyarts3.arts.Index | None = None) None
Add absorption coefficients for HITRAN collision induced absorption (CIA).
This interpolates the cross sections from
abs_cia_data. If too few temperature grid-points are available, its polynomial order of interpolation decreases to the maximum allowed. Otherwise, both frequency and temperature are interpolated using third order polynomials.Given that the interpolation is \(\vec{x}_{ij} = f\left(T, \vec{f}\right)\), where the
atm_pointtemperature is \(T\) and \(f\) is thefreq_grid, \(i\) is an index into theabs_cia_dataand \(j\) is an index into the underlyingCIARecorddata structure, the absorption coefficient from CIA is given by\[vec{\alpha}_\mathbf{CIA} = \sum_i n_{i,0} n_{i,1} \sum_j vec{x}_{ij}\]where \(n_{i,0}\) and \(n_{i,1}\) are number densities of the two species involved in the CIA.
The input
T_extrapolfacsets a limit on the interpolation along the temperature grid of the data. If the temperature grid is \([T_0, T_1, \cdots, T_{n-1}, T_n]\), then this method throws an error if\[T < T_0 - \Delta T_e \left(T_1 - T_0\right)\]or
\[T > T_n + \Delta T_e \left(T_n - T_{n-1}\right)\]where \(\Delta T_e\) is the extrapolation factor given by
T_extrapolfac. If this happens to you and you believe you can use the computations anyways, setT_extrapolfacto a very large or infinite value.The frequnecy grid interpolation is limited to within the range of the available data. Any point in
freq_gridoutside this range will simply be ignored. The frequency interpolation can thus not fail.Note
ignore_errorscan be set to 1 to suppress runtime errors, but any error will result in NaN values in the output. This is useful if you want to debug your results, but not if you want to use them.Author: Stefan Buehler, Oliver Lemke
- Parameters:
spectral_propmat (PropmatVector, optional) – This contains the fully polarized propagation matrix for the current path point. See
spectral_propmat, defaults toself.spectral_propmat[INOUT]spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the
spectral_propmatwith regards tojac_targets. Seespectral_propmat_jac, defaults toself.spectral_propmat_jac[INOUT]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]abs_cia_data (ArrayOfCIARecord, optional) – HITRAN Collision-Induced Absorption (CIA) Data. See
abs_cia_data, defaults toself.abs_cia_data[IN]T_extrapolfac (Numeric, optional) – Temperature extrapolation factor (relative to grid spacing). \(\Delta T_e\) in text above. Defaults to
0.5[IN]ignore_errors (Index, optional) – Set to 1 to suppress runtime errors (and return NAN values instead). Defaults to
0[IN]
- spectral_propmatAddFaraday(self, spectral_propmat: pyarts3.arts.PropmatVector | None = None, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None) None
Calculates absorption matrix describing Faraday rotation.
Faraday rotation is a change of polarization state of an electromagnetic wave propagating through charged matter by interaction with a magnetic field. Hence, this method requires that the magnetic field is non-zero and that the electron density is held by
atm_point(SpeciesEnum:free_electrons).Faraday rotation affects Stokes parameters 2 and 3 (but not intensity!).
Like all
spectral_propmat-modifying methods, the method is additive, i.e., does not overwrite the propagation matrixspectral_propmat, but adds further contributions.Author: Patrick Eriksson
- Parameters:
spectral_propmat (PropmatVector, optional) – This contains the fully polarized propagation matrix for the current path point. See
spectral_propmat, defaults toself.spectral_propmat[INOUT]spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the
spectral_propmatwith regards tojac_targets. Seespectral_propmat_jac, defaults toself.spectral_propmat_jac[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]
- spectral_propmatAddLines(self, spectral_propmat: pyarts3.arts.PropmatVector | None = None, spectral_nlte_srcvec: pyarts3.arts.StokvecVector | None = None, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, spectral_nlte_srcvec_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, abs_ecs_data: pyarts3.arts.LinemixingEcsData | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, no_negative_absorption: pyarts3.arts.Index | None = None) None
Add line-by-line absorption to the propagation matrix.
See Line-by-line Absorption for details.
Author: Richard Larsson
- Parameters:
spectral_propmat (PropmatVector, optional) – This contains the fully polarized propagation matrix for the current path point. See
spectral_propmat, defaults toself.spectral_propmat[INOUT]spectral_nlte_srcvec (StokvecVector, optional) – The part of the source vector that is due to non-LTE. See
spectral_nlte_srcvec, defaults toself.spectral_nlte_srcvec[INOUT]spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the
spectral_propmatwith regards tojac_targets. Seespectral_propmat_jac, defaults toself.spectral_propmat_jac[INOUT]spectral_nlte_srcvec_jac (StokvecMatrix, optional) – Partial derivative of the
spectral_nlte_srcvecwith regards tojac_targets. Seespectral_nlte_srcvec_jac, defaults toself.spectral_nlte_srcvec_jac[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]abs_ecs_data (LinemixingEcsData, optional) – Error corrected sudden data. See
abs_ecs_data, defaults toself.abs_ecs_data[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]no_negative_absorption (Index, optional) – Turn off to allow individual absorbers to have negative absorption. Defaults to
1[IN]
- spectral_propmatAddLookup(self, spectral_propmat: pyarts3.arts.PropmatVector | None = None, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, abs_lookup_data: pyarts3.arts.AbsorptionLookupTables | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, no_negative_absorption: pyarts3.arts.Index | None = None, p_interp_order: pyarts3.arts.Index | None = None, t_interp_order: pyarts3.arts.Index | None = None, water_interp_order: pyarts3.arts.Index | None = None, f_interp_order: pyarts3.arts.Index | None = None, extpolfac: pyarts3.arts.Numeric | None = None) None
Add line-by-line absorption to the propagation matrix.
See Lookup-table Absorption for details.
Author: Richard Larsson
- Parameters:
spectral_propmat (PropmatVector, optional) – This contains the fully polarized propagation matrix for the current path point. See
spectral_propmat, defaults toself.spectral_propmat[INOUT]spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the
spectral_propmatwith regards tojac_targets. Seespectral_propmat_jac, defaults toself.spectral_propmat_jac[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]abs_lookup_data (AbsorptionLookupTables, optional) – Absorption lookup table for scalar gas absorption coefficients. See
abs_lookup_data, defaults toself.abs_lookup_data[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]no_negative_absorption (Index, optional) – Turn off to allow individual absorbers to have negative absorption. Defaults to
1[IN]p_interp_order (Index, optional) – Interpolation order for pressure. Defaults to
7[IN]t_interp_order (Index, optional) – Interpolation order for temperature. Defaults to
7[IN]water_interp_order (Index, optional) – Interpolation order for water vapor. Defaults to
7[IN]f_interp_order (Index, optional) – Interpolation order for frequency. Defaults to
7[IN]extpolfac (Numeric, optional) – Extrapolation factor. Defaults to
0.5[IN]
- spectral_propmatAddPredefined(self, spectral_propmat: pyarts3.arts.PropmatVector | None = None, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, abs_predef_data: pyarts3.arts.PredefinedModelData | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_point: pyarts3.arts.AtmPoint | None = None) None
Adds all of the predefined models in
abs_speciesto the spectral_propmatOnly supports temperature and wind speed derivatives
Available models
Model name
Description and limitations
Reference(s)
H2O-ForeignContCKDMT320Foreign continua.
Use water cutoff of 25 cm-1 andH2O-SelfContCKDMT320.[2]
H2O-ForeignContCKDMT350MT CKD 3.5 foreign continua.
Use water cutoff of 25 cm-1 andH2O-SelfContCKDMT350.[2]
H2O-ForeignContCKDMT400MT CKD 4 foreign continua.
Use water cutoff of 25 cm-1 andH2O-SelfContCKDMT350.
Requires an external data source.H2O-ForeignContStandardTypeWater microwave continua for foreign species.
Rosenkranz [30]
H2O-MPM89Microwave water absorption model.
Liebe [16]
H2O-PWR2021Microwave water absorption model
developed by P.W. Rosenkranz.Rosenkranz [31].
H2O-PWR2022Microwave water absorption model
developed by P.W. Rosenkranz.Rosenkranz [31].
H2O-PWR98Microwave water absorption model.
Rosenkranz [30]
H2O-SelfContCKDMT320Self continua.
Use water cutoff of 25 cm-1 andH2O-ForeignContCKDMT320.[2]
H2O-SelfContCKDMT350MT CKD 3.5 self continua.
Use water cutoff of 25 cm-1 andH2O-ForeignContCKDMT350.[2]
H2O-SelfContCKDMT400MT CKD 4 self continua.
Use water cutoff of 25 cm-1 andH2O-SelfContCKDMT350.
Requires an external data source.H2O-SelfContStandardTypeWater microwave continua for self.
Rosenkranz [30]
CO2-CKDMT252MT CKD absorption for CO2 version 2.52.
[2]
O2-CIAfunCKDMT100CIA for oxygen from MT CKD.
O2-MPM202060 GHz and 118 GHz lines only.
Do not include the v 0 0 oxygen band manually.Makarov et al. [18]
O2-MPM89Oxygen microwave absorption model.
Liebe et al. [15]
O2-PWR2021Oxygen microwave absorption model
developed by P.W. Rosenkranz.Rosenkranz [30]
O2-PWR2022Oxygen microwave absorption model
developed by P.W. Rosenkranz.Rosenkranz [30]
O2-PWR98Oxygen microwave absorption model.
Rosenkranz [29] and Liebe et al. [17] and
M.J. Schwartz, Ph.D. thesis, M.I.T. (1997) and
ROTHMAN et al. [32].O2-SelfContStandardTypeMicrowave continua term.
O2-TRE05Oxygen microwave absorption model.
O2-v0v0CKDMT100CKD_MT 1.00 implementation of oxygen
collision-induced fundamental model.O2-v1v0CKDMT100MT CKD.
O2-visCKDMT252MT CKD.
N2-CIAfunCKDMT252MT CKD.
N2-CIArotCKDMT252MT CKD.
N2-SelfContMPM93Microwave nitrogen absorption continua
from MPM93 model.Liebe et al. [15]
N2-SelfContPWR2021Microwave nitrogen absorption continua
developed by P.W. Rosenkranz.
This includes O2-N2 and O2-O2 CIA (only applicable to Earth).Rosenkranz [30]
N2-SelfContStandardTypeMicrowave nitrogen absorption continua.
Rosenkranz [29]
liquidcloud-ELL07Water droplet absorption.
Ellison [8]
Author: Richard Larsson
- Parameters:
spectral_propmat (PropmatVector, optional) – This contains the fully polarized propagation matrix for the current path point. See
spectral_propmat, defaults toself.spectral_propmat[INOUT]spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the
spectral_propmatwith regards tojac_targets. Seespectral_propmat_jac, defaults toself.spectral_propmat_jac[INOUT]abs_predef_data (PredefinedModelData, optional) – This contains predefined model data. See
abs_predef_data, defaults toself.abs_predef_data[IN]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]
- spectral_propmatAddVoigtLTE(self, spectral_propmat: pyarts3.arts.PropmatVector | None = None, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, dispersion: pyarts3.arts.Vector | None = None, dispersion_jacobian: pyarts3.arts.Matrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, no_negative_absorption: pyarts3.arts.Index | None = None) None
Add line-by-line absorption to the propagation matrix.
See Line-by-line Absorption for details.
This is only for LTE lines in Voigt.
Author: Richard Larsson
- Parameters:
spectral_propmat (PropmatVector, optional) – This contains the fully polarized propagation matrix for the current path point. See
spectral_propmat, defaults toself.spectral_propmat[INOUT]spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the
spectral_propmatwith regards tojac_targets. Seespectral_propmat_jac, defaults toself.spectral_propmat_jac[INOUT]dispersion (Vector) – Dispersion vector - only the main component (i.e., -imag(A) of the
Propmat). Defaults to create and/or useself.dispersion:Vector. [OUT]dispersion_jacobian (Matrix) – Dispersion Jacobian matrix - only the main component (i.e., -imag(A) of the
Propmat). Defaults to create and/or useself.dispersion_jacobian:Matrix. [OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]no_negative_absorption (Index, optional) – Turn off to allow individual absorbers to have negative absorption. Defaults to
1[IN]
- spectral_propmatAddXsecFit(self, spectral_propmat: pyarts3.arts.PropmatVector | None = None, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, abs_xfit_data: pyarts3.arts.ArrayOfXsecRecord | None = None, force_p: pyarts3.arts.Numeric | None = None, force_t: pyarts3.arts.Numeric | None = None) None
Calculate absorption cross sections per tag group for HITRAN xsec species.
This broadens the cross section data from
abs_xfit_dataand interpolates it onto the currentfreq_grid.Author: Oliver Lemke
- Parameters:
spectral_propmat (PropmatVector, optional) – This contains the fully polarized propagation matrix for the current path point. See
spectral_propmat, defaults toself.spectral_propmat[INOUT]spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the
spectral_propmatwith regards tojac_targets. Seespectral_propmat_jac, defaults toself.spectral_propmat_jac[INOUT]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]abs_xfit_data (ArrayOfXsecRecord, optional) – Fitting model coefficients for cross section species. See
abs_xfit_data, defaults toself.abs_xfit_data[IN]force_p (Numeric, optional) – Positive value forces constant pressure [Pa]. Defaults to
-1[IN]force_t (Numeric, optional) – Positive value forces constant temperature [K]. Defaults to
-1[IN]
- spectral_propmatInit(self, spectral_propmat: pyarts3.arts.PropmatVector | None = None, spectral_nlte_srcvec: pyarts3.arts.StokvecVector | None = None, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, spectral_nlte_srcvec_jac: pyarts3.arts.StokvecMatrix | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None) None
Initialize
spectral_propmat,spectral_nlte_srcvec, and their derivatives to zeroes.This method must be used inside
spectral_propmat_agendaand then be called first.Authors: Oliver Lemke, Richard Larsson
- Parameters:
spectral_propmat (PropmatVector, optional) – This contains the fully polarized propagation matrix for the current path point. See
spectral_propmat, defaults toself.spectral_propmat[OUT]spectral_nlte_srcvec (StokvecVector, optional) – The part of the source vector that is due to non-LTE. See
spectral_nlte_srcvec, defaults toself.spectral_nlte_srcvec[OUT]spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the
spectral_propmatwith regards tojac_targets. Seespectral_propmat_jac, defaults toself.spectral_propmat_jac[OUT]spectral_nlte_srcvec_jac (StokvecMatrix, optional) – Partial derivative of the
spectral_nlte_srcvecwith regards tojac_targets. Seespectral_nlte_srcvec_jac, defaults toself.spectral_nlte_srcvec_jac[OUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]
- spectral_propmat_agendaAuto(self, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, abs_species: pyarts3.arts.ArrayOfSpeciesTag | None = None, abs_bands: pyarts3.arts.AbsorptionBands | None = None, use_abs_lookup_data: pyarts3.arts.Index | None = None, T_extrapolfac: pyarts3.arts.Numeric | None = None, ignore_errors: pyarts3.arts.Index | None = None, no_negative_absorption: pyarts3.arts.Index | None = None, force_p: pyarts3.arts.Numeric | None = None, force_t: pyarts3.arts.Numeric | None = None, p_interp_order: pyarts3.arts.Index | None = None, t_interp_order: pyarts3.arts.Index | None = None, water_interp_order: pyarts3.arts.Index | None = None, f_interp_order: pyarts3.arts.Index | None = None, extpolfac: pyarts3.arts.Numeric | None = None) None
Sets the
spectral_propmat_agendaautomatically from absorption data and species tag meta information.The following methods are considered for addition to the agenda:
If
use_abs_lookup_dataevaluates to true, lookup table calculations, viaspectral_propmatAddLookup(), are used instead ofspectral_propmatAddLines().Note that the signature of this method changes depending on the input methods. This is important because several generic input parameters are used in the methods. Please see the individual methods for more information.
Author: Richard Larsson
- Parameters:
spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[OUT]abs_species (ArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See
abs_species, defaults toself.abs_species[IN]abs_bands (AbsorptionBands, optional) – Bands of absorption lines for line-by-line (LBL) calculations. See
abs_bands, defaults toself.abs_bands[IN]use_abs_lookup_data (Index, optional) – Whether or not to use the lookup table instead of pure line-by-line calculations. Defaults to
0[IN]T_extrapolfac (Numeric, optional) – See
spectral_propmatAddCIA(). Defaults to0.5[IN]ignore_errors (Index, optional) – See
spectral_propmatAddCIA(). Defaults to0[IN]no_negative_absorption (Index, optional) – See
spectral_propmatAddLines(),spectral_propmatAddLookup(). Defaults to1[IN]force_p (Numeric, optional) – See
spectral_propmatAddXsecFit(). Defaults to-1[IN]force_t (Numeric, optional) – See
spectral_propmatAddXsecFit(). Defaults to-1[IN]p_interp_order (Index, optional) – See
spectral_propmatAddLookup(). Defaults to7[IN]t_interp_order (Index, optional) – See
spectral_propmatAddLookup(). Defaults to7[IN]water_interp_order (Index, optional) – See
spectral_propmatAddLookup(). Defaults to7[IN]f_interp_order (Index, optional) – See
spectral_propmatAddLookup(). Defaults to7[IN]extpolfac (Numeric, optional) – See
spectral_propmatAddLookup(). Defaults to0.5[IN]
- spectral_propmat_agendaExecute(self, spectral_propmat: pyarts3.arts.PropmatVector | None = None, spectral_nlte_srcvec: pyarts3.arts.StokvecVector | None = None, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, spectral_nlte_srcvec_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, freq_wind_shift_jac: pyarts3.arts.Vector3 | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
spectral_propmat_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
spectral_propmat (PropmatVector, optional) – This contains the fully polarized propagation matrix for the current path point. See
spectral_propmat, defaults toself.spectral_propmat[OUT]spectral_nlte_srcvec (StokvecVector, optional) – The part of the source vector that is due to non-LTE. See
spectral_nlte_srcvec, defaults toself.spectral_nlte_srcvec[OUT]spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the
spectral_propmatwith regards tojac_targets. Seespectral_propmat_jac, defaults toself.spectral_propmat_jac[OUT]spectral_nlte_srcvec_jac (StokvecMatrix, optional) – Partial derivative of the
spectral_nlte_srcvecwith regards tojac_targets. Seespectral_nlte_srcvec_jac, defaults toself.spectral_nlte_srcvec_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]freq_wind_shift_jac (Vector3, optional) – The frequency wind shift Jacobian. See
freq_wind_shift_jac, defaults toself.freq_wind_shift_jac[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- spectral_propmat_agendaExecuteOperator(self, spectral_propmat: pyarts3.arts.PropmatVector | None = None, spectral_nlte_srcvec: pyarts3.arts.StokvecVector | None = None, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, spectral_nlte_srcvec_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, freq_wind_shift_jac: pyarts3.arts.Vector3 | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, spectral_propmat_agenda_operator: pyarts3.arts.spectral_propmat_agendaOperator | None = None) None
Executes an operator emulating
spectral_propmat_agenda, see it, and alsospectral_propmat_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
spectral_propmat (PropmatVector, optional) – This contains the fully polarized propagation matrix for the current path point. See
spectral_propmat, defaults toself.spectral_propmat[OUT]spectral_nlte_srcvec (StokvecVector, optional) – The part of the source vector that is due to non-LTE. See
spectral_nlte_srcvec, defaults toself.spectral_nlte_srcvec[OUT]spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the
spectral_propmatwith regards tojac_targets. Seespectral_propmat_jac, defaults toself.spectral_propmat_jac[OUT]spectral_nlte_srcvec_jac (StokvecMatrix, optional) – Partial derivative of the
spectral_nlte_srcvecwith regards tojac_targets. Seespectral_nlte_srcvec_jac, defaults toself.spectral_nlte_srcvec_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]freq_wind_shift_jac (Vector3, optional) – The frequency wind shift Jacobian. See
freq_wind_shift_jac, defaults toself.freq_wind_shift_jac[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]select_species (SpeciesEnum, optional) – Species selection. See
select_species, defaults toself.select_species[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]spectral_propmat_agenda_operator (spectral_propmat_agendaOperator) – Operator for
spectral_propmat_agenda. [IN]
- spectral_propmat_agendaSet(self, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
spectral_propmat_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[OUT]option (String) – Choice of generated agenda. [IN]
Valid options
These are the valid options for the
spectral_propmat_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
spectral_propmat_agendaSet(option="Empty")Ignore(), using: input =freq_wind_shift_jacIgnore(), using: input =select_species
- spectral_propmat_agendaSetOperator(self, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.spectral_propmat_agendaOperator | None = None) None
Set
spectral_propmat_agendato exclusively use provided external operator. Seespectral_propmat_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[OUT]f (spectral_propmat_agendaOperator) – Operator for
spectral_propmat_agenda. [IN]
- spectral_propmat_jacWindFix(self, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, spectral_nlte_srcvec_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, freq_wind_shift_jac: pyarts3.arts.Vector3 | None = None) None
Fix for the wind field derivative.
The
spectral_propmat_agendawill set the wind derivatives to those of the frequency derivative if this method is not used. This will cause the wind field to be treated as a frequency derivative, meaning noOEM()or other functionality that requires the Jacobian matrix to be calculated will work.Author: Richard Larsson
- Parameters:
spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the
spectral_propmatwith regards tojac_targets. Seespectral_propmat_jac, defaults toself.spectral_propmat_jac[INOUT]spectral_nlte_srcvec_jac (StokvecMatrix, optional) – Partial derivative of the
spectral_nlte_srcvecwith regards tojac_targets. Seespectral_nlte_srcvec_jac, defaults toself.spectral_nlte_srcvec_jac[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]freq_wind_shift_jac (Vector3, optional) – The frequency wind shift Jacobian. See
freq_wind_shift_jac, defaults toself.freq_wind_shift_jac[IN]
- spectral_propmat_pathAdaptiveHalfPath(self, spectral_propmat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, spectral_nlte_srcvec_path: pyarts3.arts.ArrayOfStokvecVector | None = None, spectral_propmat_jac_path: pyarts3.arts.ArrayOfPropmatMatrix | None = None, spectral_nlte_srcvec_jac_path: pyarts3.arts.ArrayOfStokvecMatrix | None = None, freq_grid_path: pyarts3.arts.ArrayOfAscendingGrid | None = None, freq_wind_shift_jac_path: pyarts3.arts.ArrayOfVector3 | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, max_stepsize: pyarts3.arts.Numeric | None = None, max_tau: pyarts3.arts.Numeric | None = None, cutoff_tau: pyarts3.arts.Numeric | None = None) None
Same as
spectral_propmat_pathFromPath()but with adaptive path.The path is filled with extra points if a single frequency point has an optical thickness larger than
max_tauin a single step. The step size is halved until the optical thickness is below the limit, and additional points are added to the path parameters.As a bailout, the step size is not allowed to be smaller than
max_stepsize, albeit at least 3 points are added if any point is added.Note that the input
Author: Richard Larsson
- Parameters:
spectral_propmat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path. See
spectral_propmat_path, defaults toself.spectral_propmat_path[OUT]spectral_nlte_srcvec_path (ArrayOfStokvecVector, optional) – Additional non-LTE along the propagation path. See
spectral_nlte_srcvec_path, defaults toself.spectral_nlte_srcvec_path[OUT]spectral_propmat_jac_path (ArrayOfPropmatMatrix, optional) – Propagation derivative matrices along the propagation path. See
spectral_propmat_jac_path, defaults toself.spectral_propmat_jac_path[OUT]spectral_nlte_srcvec_jac_path (ArrayOfStokvecMatrix, optional) – Additional non-LTE derivative along the propagation path. See
spectral_nlte_srcvec_jac_path, defaults toself.spectral_nlte_srcvec_jac_path[OUT]freq_grid_path (ArrayOfAscendingGrid, optional) – All
freq_gridalong the propagation path. Seefreq_grid_path, defaults toself.freq_grid_path[INOUT]freq_wind_shift_jac_path (ArrayOfVector3, optional) – A list of
freq_wind_shift_jacfor a ray path. Seefreq_wind_shift_jac_path, defaults toself.freq_wind_shift_jac_path[INOUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[INOUT]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[INOUT]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]max_tau (Numeric, optional) – Maximum allowed optical thickness per step. Defaults to
0.1[IN]cutoff_tau (Numeric, optional) – Cutoff optical thickness for stopping the adaptive stepping. Defaults to
3[IN]
- spectral_propmat_pathAddScattering(self, spectral_propmat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, spectral_propmat_scat_path: pyarts3.arts.ArrayOfPropmatVector | None = None) None
Adds the scattering part of the propagation matrix to the rest along the path.
The calculations are in parallel if the program is not in parallel already.
Author: Richard Larsson
Used by wrapper method
- Parameters:
spectral_propmat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path. See
spectral_propmat_path, defaults toself.spectral_propmat_path[INOUT]spectral_propmat_scat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path for scattering. See
spectral_propmat_scat_path, defaults toself.spectral_propmat_scat_path[IN]
- spectral_propmat_pathFromPath(self, spectral_propmat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, spectral_nlte_srcvec_path: pyarts3.arts.ArrayOfStokvecVector | None = None, spectral_propmat_jac_path: pyarts3.arts.ArrayOfPropmatMatrix | None = None, spectral_nlte_srcvec_jac_path: pyarts3.arts.ArrayOfStokvecMatrix | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, freq_grid_path: pyarts3.arts.ArrayOfAscendingGrid | None = None, freq_wind_shift_jac_path: pyarts3.arts.ArrayOfVector3 | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None) None
Gets the propagation matrix and non-LTE source term along the path.
The calculations are in parallel if the program is not in parallel already.
Also outputs the
freq_grid_pathas a side effect (of wind).Author: Richard Larsson
Used by wrapper methods
- Parameters:
spectral_propmat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path. See
spectral_propmat_path, defaults toself.spectral_propmat_path[OUT]spectral_nlte_srcvec_path (ArrayOfStokvecVector, optional) – Additional non-LTE along the propagation path. See
spectral_nlte_srcvec_path, defaults toself.spectral_nlte_srcvec_path[OUT]spectral_propmat_jac_path (ArrayOfPropmatMatrix, optional) – Propagation derivative matrices along the propagation path. See
spectral_propmat_jac_path, defaults toself.spectral_propmat_jac_path[OUT]spectral_nlte_srcvec_jac_path (ArrayOfStokvecMatrix, optional) – Additional non-LTE derivative along the propagation path. See
spectral_nlte_srcvec_jac_path, defaults toself.spectral_nlte_srcvec_jac_path[OUT]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]freq_grid_path (ArrayOfAscendingGrid, optional) – All
freq_gridalong the propagation path. Seefreq_grid_path, defaults toself.freq_grid_path[IN]freq_wind_shift_jac_path (ArrayOfVector3, optional) – A list of
freq_wind_shift_jacfor a ray path. Seefreq_wind_shift_jac_path, defaults toself.freq_wind_shift_jac_path[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]
- spectral_propmat_path_species_splitFromPath(self, spectral_propmat_path_species_split: pyarts3.arts.ArrayOfArrayOfPropmatVector | None = None, spectral_nlte_srcvec_path_species_split: pyarts3.arts.ArrayOfArrayOfStokvecVector | None = None, spectral_propmat_jac_path_species_split: pyarts3.arts.ArrayOfArrayOfPropmatMatrix | None = None, spectral_nlte_srcvec_jac_path_species_split: pyarts3.arts.ArrayOfArrayOfStokvecMatrix | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, freq_grid_path: pyarts3.arts.ArrayOfAscendingGrid | None = None, freq_wind_shift_jac_path: pyarts3.arts.ArrayOfVector3 | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None, select_species_list: pyarts3.arts.ArrayOfSpeciesEnum | None = None) None
As
spectral_propmat_pathFromPath()but the output is split between the species in theselect_species_list.The outer dimension of the output arrays are the size of the species selection list. The inner dimensions are as per
spectral_propmat_pathFromPath().Author: Richard Larsson
- Parameters:
spectral_propmat_path_species_split (ArrayOfArrayOfPropmatVector) – Propagation matrix for selected species. Defaults to create and/or use
self.spectral_propmat_path_species_split:ArrayOfArrayOfPropmatVector. [OUT]spectral_nlte_srcvec_path_species_split (ArrayOfArrayOfStokvecVector) – Non-LTE source vector for selected species. Defaults to create and/or use
self.spectral_nlte_srcvec_path_species_split:ArrayOfArrayOfStokvecVector. [OUT]spectral_propmat_jac_path_species_split (ArrayOfArrayOfPropmatMatrix) – Jacobian of propagation matrix for selected species. Defaults to create and/or use
self.spectral_propmat_jac_path_species_split:ArrayOfArrayOfPropmatMatrix. [OUT]spectral_nlte_srcvec_jac_path_species_split (ArrayOfArrayOfStokvecMatrix) – Jacobian of non-LTE source vector for selected species. Defaults to create and/or use
self.spectral_nlte_srcvec_jac_path_species_split:ArrayOfArrayOfStokvecMatrix. [OUT]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]freq_grid_path (ArrayOfAscendingGrid, optional) – All
freq_gridalong the propagation path. Seefreq_grid_path, defaults toself.freq_grid_path[IN]freq_wind_shift_jac_path (ArrayOfVector3, optional) – A list of
freq_wind_shift_jacfor a ray path. Seefreq_wind_shift_jac_path, defaults toself.freq_wind_shift_jac_path[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]select_species_list (ArrayOfSpeciesEnum, optional) – Species selection when multiple species must be chosen. See
select_species_list, defaults toself.select_species_list[IN]
- spectral_propmat_scatAddSpectralScatteringSpeciesTRO(self, spectral_propmat_scat: pyarts3.arts.PropmatVector | None = None, spectral_absvec_scat: pyarts3.arts.StokvecVector | None = None, spectral_phamat_spectral: pyarts3.arts.SpecmatMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, scat_species: pyarts3.arts.ArrayOfScatteringSpecies | None = None) None
Adds
scat_speciesresults for totally random oriented spectral calculations tospectral_propmat_scatand co.Author: Richard Larsson
- Parameters:
spectral_propmat_scat (PropmatVector, optional) – This contains the propagation matrix for scattering for the current path point. See
spectral_propmat_scat, defaults toself.spectral_propmat_scat[INOUT]spectral_absvec_scat (StokvecVector, optional) – The absorption vector of totally random orientation particles at a single point along a path using spectral representation. See
spectral_absvec_scat, defaults toself.spectral_absvec_scat[INOUT]spectral_phamat_spectral (SpecmatMatrix, optional) – The spectral phase matrix of totally random orientation particles at a single point along a path using spectral representation. See
spectral_phamat_spectral, defaults toself.spectral_phamat_spectral[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]scat_species (ArrayOfScatteringSpecies, optional) – The scattering species. See
scat_species, defaults toself.scat_species[IN]
- spectral_propmat_scatAirSimple(self, spectral_propmat_scat: pyarts3.arts.PropmatVector | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_point: pyarts3.arts.AtmPoint | None = None) None
Add simple air to
spectral_propmat_scat.Authors: Jon Petersen, Richard Larsson
- Parameters:
spectral_propmat_scat (PropmatVector, optional) – This contains the propagation matrix for scattering for the current path point. See
spectral_propmat_scat, defaults toself.spectral_propmat_scat[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]
- spectral_propmat_scatInit(self, spectral_propmat_scat: pyarts3.arts.PropmatVector | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None) None
Initialize
spectral_propmat_scatto zeroes.This method must be used inside
spectral_propmat_scat_agendaand then be called first.Author: Richard Larsson
- Parameters:
spectral_propmat_scat (PropmatVector, optional) – This contains the propagation matrix for scattering for the current path point. See
spectral_propmat_scat, defaults toself.spectral_propmat_scat[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]
- spectral_propmat_scatSpectralInit(self, spectral_propmat_scat: pyarts3.arts.PropmatVector | None = None, spectral_absvec_scat: pyarts3.arts.StokvecVector | None = None, spectral_phamat_spectral: pyarts3.arts.SpecmatMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, legendre_degree: pyarts3.arts.Index | None = None) None
Initialize
spectral_propmat_scatand co to zeroes.This method must be used inside
spectral_propmat_scat_spectral_agendaand then be called first.Author: Richard Larsson
- Parameters:
spectral_propmat_scat (PropmatVector, optional) – This contains the propagation matrix for scattering for the current path point. See
spectral_propmat_scat, defaults toself.spectral_propmat_scat[OUT]spectral_absvec_scat (StokvecVector, optional) – The absorption vector of totally random orientation particles at a single point along a path using spectral representation. See
spectral_absvec_scat, defaults toself.spectral_absvec_scat[OUT]spectral_phamat_spectral (SpecmatMatrix, optional) – The spectral phase matrix of totally random orientation particles at a single point along a path using spectral representation. See
spectral_phamat_spectral, defaults toself.spectral_phamat_spectral[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]legendre_degree (Index, optional) – The degree of a Legendre polynimial. See
legendre_degree, defaults toself.legendre_degree[IN]
- spectral_propmat_scat_agendaExecute(self, spectral_propmat_scat: pyarts3.arts.PropmatVector | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, spectral_propmat_scat_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
spectral_propmat_scat_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
spectral_propmat_scat (PropmatVector, optional) – This contains the propagation matrix for scattering for the current path point. See
spectral_propmat_scat, defaults toself.spectral_propmat_scat[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]spectral_propmat_scat_agenda (Agenda, optional) – Computes the part of the propagation matrix that relates to scattering. See
spectral_propmat_scat_agenda, defaults toself.spectral_propmat_scat_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- spectral_propmat_scat_agendaExecuteOperator(self, spectral_propmat_scat: pyarts3.arts.PropmatVector | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, spectral_propmat_scat_agenda_operator: pyarts3.arts.spectral_propmat_scat_agendaOperator | None = None) None
Executes an operator emulating
spectral_propmat_scat_agenda, see it, and alsospectral_propmat_scat_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
spectral_propmat_scat (PropmatVector, optional) – This contains the propagation matrix for scattering for the current path point. See
spectral_propmat_scat, defaults toself.spectral_propmat_scat[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]spectral_propmat_scat_agenda_operator (spectral_propmat_scat_agendaOperator) – Operator for
spectral_propmat_scat_agenda. [IN]
- spectral_propmat_scat_agendaSet(self, spectral_propmat_scat_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
spectral_propmat_scat_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
spectral_propmat_scat_agenda (Agenda, optional) – Computes the part of the propagation matrix that relates to scattering. See
spectral_propmat_scat_agenda, defaults toself.spectral_propmat_scat_agenda[OUT]option (String, optional) – Choice of generated agenda. Defaults to
"AirSimple"[IN]
Valid options
These are the valid options for the
spectral_propmat_scat_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
spectral_propmat_scat_agendaSet(option="AirSimple")
- spectral_propmat_scat_agendaSetOperator(self, spectral_propmat_scat_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.spectral_propmat_scat_agendaOperator | None = None) None
Set
spectral_propmat_scat_agendato exclusively use provided external operator. Seespectral_propmat_scat_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
spectral_propmat_scat_agenda (Agenda, optional) – Computes the part of the propagation matrix that relates to scattering. See
spectral_propmat_scat_agenda, defaults toself.spectral_propmat_scat_agenda[OUT]f (spectral_propmat_scat_agendaOperator) – Operator for
spectral_propmat_scat_agenda. [IN]
- spectral_propmat_scat_pathFromPath(self, spectral_propmat_scat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, spectral_propmat_scat_agenda: pyarts3.arts.Agenda | None = None, freq_grid_path: pyarts3.arts.ArrayOfAscendingGrid | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None) None
Gets the propagation matrix for scattering along the path.
The calculations are in parallel if the program is not in parallel already.
Author: Richard Larsson
Used by wrapper method
- Parameters:
spectral_propmat_scat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path for scattering. See
spectral_propmat_scat_path, defaults toself.spectral_propmat_scat_path[OUT]spectral_propmat_scat_agenda (Agenda, optional) – Computes the part of the propagation matrix that relates to scattering. See
spectral_propmat_scat_agenda, defaults toself.spectral_propmat_scat_agenda[IN]freq_grid_path (ArrayOfAscendingGrid, optional) – All
freq_gridalong the propagation path. Seefreq_grid_path, defaults toself.freq_grid_path[IN]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]
- spectral_propmat_scat_pathFromSpectralAgenda(self, spectral_propmat_scat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, spectral_absvec_scat_path: pyarts3.arts.ArrayOfStokvecVector | None = None, spectral_phamat_spectral_path: pyarts3.arts.ArrayOfSpecmatMatrix | None = None, freq_grid_path: pyarts3.arts.ArrayOfAscendingGrid | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None, legendre_degree: pyarts3.arts.Index | None = None, spectral_propmat_scat_spectral_agenda: pyarts3.arts.Agenda | None = None) None
Compute
spectral_propmat_scat_pathand co for a path.Author: Richard Larsson
- Parameters:
spectral_propmat_scat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path for scattering. See
spectral_propmat_scat_path, defaults toself.spectral_propmat_scat_path[OUT]spectral_absvec_scat_path (ArrayOfStokvecVector, optional) – The absorption vector of totally random orientation particles along the propagation path using spectral representation. See
spectral_absvec_scat_path, defaults toself.spectral_absvec_scat_path[OUT]spectral_phamat_spectral_path (ArrayOfSpecmatMatrix, optional) – The spectral phase matrix of totally random orientation particles along the propagation path using spectral representation. See
spectral_phamat_spectral_path, defaults toself.spectral_phamat_spectral_path[OUT]freq_grid_path (ArrayOfAscendingGrid, optional) – All
freq_gridalong the propagation path. Seefreq_grid_path, defaults toself.freq_grid_path[IN]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]legendre_degree (Index, optional) – The degree of a Legendre polynimial. See
legendre_degree, defaults toself.legendre_degree[IN]spectral_propmat_scat_spectral_agenda (Agenda, optional) – Gets the scattering propagation matrix, the scattering absorption vector, and the scattering spectral phase matrix. See
spectral_propmat_scat_spectral_agenda, defaults toself.spectral_propmat_scat_spectral_agenda[IN]
- spectral_propmat_scat_spectral_agendaExecute(self, spectral_propmat_scat: pyarts3.arts.PropmatVector | None = None, spectral_absvec_scat: pyarts3.arts.StokvecVector | None = None, spectral_phamat_spectral: pyarts3.arts.SpecmatMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, legendre_degree: pyarts3.arts.Index | None = None, spectral_propmat_scat_spectral_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
spectral_propmat_scat_spectral_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
spectral_propmat_scat (PropmatVector, optional) – This contains the propagation matrix for scattering for the current path point. See
spectral_propmat_scat, defaults toself.spectral_propmat_scat[OUT]spectral_absvec_scat (StokvecVector, optional) – The absorption vector of totally random orientation particles at a single point along a path using spectral representation. See
spectral_absvec_scat, defaults toself.spectral_absvec_scat[OUT]spectral_phamat_spectral (SpecmatMatrix, optional) – The spectral phase matrix of totally random orientation particles at a single point along a path using spectral representation. See
spectral_phamat_spectral, defaults toself.spectral_phamat_spectral[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]legendre_degree (Index, optional) – The degree of a Legendre polynimial. See
legendre_degree, defaults toself.legendre_degree[IN]spectral_propmat_scat_spectral_agenda (Agenda, optional) – Gets the scattering propagation matrix, the scattering absorption vector, and the scattering spectral phase matrix. See
spectral_propmat_scat_spectral_agenda, defaults toself.spectral_propmat_scat_spectral_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- spectral_propmat_scat_spectral_agendaExecuteOperator(self, spectral_propmat_scat: pyarts3.arts.PropmatVector | None = None, spectral_absvec_scat: pyarts3.arts.StokvecVector | None = None, spectral_phamat_spectral: pyarts3.arts.SpecmatMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, legendre_degree: pyarts3.arts.Index | None = None, spectral_propmat_scat_spectral_agenda_operator: pyarts3.arts.spectral_propmat_scat_spectral_agendaOperator | None = None) None
Executes an operator emulating
spectral_propmat_scat_spectral_agenda, see it, and alsospectral_propmat_scat_spectral_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
spectral_propmat_scat (PropmatVector, optional) – This contains the propagation matrix for scattering for the current path point. See
spectral_propmat_scat, defaults toself.spectral_propmat_scat[OUT]spectral_absvec_scat (StokvecVector, optional) – The absorption vector of totally random orientation particles at a single point along a path using spectral representation. See
spectral_absvec_scat, defaults toself.spectral_absvec_scat[OUT]spectral_phamat_spectral (SpecmatMatrix, optional) – The spectral phase matrix of totally random orientation particles at a single point along a path using spectral representation. See
spectral_phamat_spectral, defaults toself.spectral_phamat_spectral[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See
atm_point, defaults toself.atm_point[IN]legendre_degree (Index, optional) – The degree of a Legendre polynimial. See
legendre_degree, defaults toself.legendre_degree[IN]spectral_propmat_scat_spectral_agenda_operator (spectral_propmat_scat_spectral_agendaOperator) – Operator for
spectral_propmat_scat_spectral_agenda. [IN]
- spectral_propmat_scat_spectral_agendaSet(self, spectral_propmat_scat_spectral_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
spectral_propmat_scat_spectral_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
spectral_propmat_scat_spectral_agenda (Agenda, optional) – Gets the scattering propagation matrix, the scattering absorption vector, and the scattering spectral phase matrix. See
spectral_propmat_scat_spectral_agenda, defaults toself.spectral_propmat_scat_spectral_agenda[OUT]option (String, optional) – Choice of generated agenda. Defaults to
"FromSpeciesTRO"[IN]
Valid options
These are the valid options for the
spectral_propmat_scat_spectral_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
spectral_propmat_scat_spectral_agendaSet(option="FromSpeciesTRO")
- spectral_propmat_scat_spectral_agendaSetOperator(self, spectral_propmat_scat_spectral_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.spectral_propmat_scat_spectral_agendaOperator | None = None) None
Set
spectral_propmat_scat_spectral_agendato exclusively use provided external operator. Seespectral_propmat_scat_spectral_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
spectral_propmat_scat_spectral_agenda (Agenda, optional) – Gets the scattering propagation matrix, the scattering absorption vector, and the scattering spectral phase matrix. See
spectral_propmat_scat_spectral_agenda, defaults toself.spectral_propmat_scat_spectral_agenda[OUT]f (spectral_propmat_scat_spectral_agendaOperator) – Operator for
spectral_propmat_scat_spectral_agenda. [IN]
- spectral_radApplyForwardUnit(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, spectral_rad_transform_operator: pyarts3.arts.SpectralRadianceTransformOperator | None = None) None
Helper to call
spectral_radApplyUnit()when you do not havespectral_rad_jac.Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]spectral_rad_transform_operator (SpectralRadianceTransformOperator, optional) – The spectral radiance transform operator. See
spectral_rad_transform_operator, defaults toself.spectral_rad_transform_operator[IN]
- spectral_radApplyUnit(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, spectral_rad_transform_operator: pyarts3.arts.SpectralRadianceTransformOperator | None = None) None
Applies a unit to
spectral_rad, returning a new fieldSee
SpectralRadianceUnitTypefor valid use cases and limitations.This effectively wraps the local creation of a
SpectralRadianceTransformOperatorcall.Warning
This is a destructive method. Any use of it means that it is undefined behavior to use
spectral_radorspectral_rad_jacin future methods.Author: Richard Larsson
Used by wrapper method
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[INOUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]spectral_rad_transform_operator (SpectralRadianceTransformOperator, optional) – The spectral radiance transform operator. See
spectral_rad_transform_operator, defaults toself.spectral_rad_transform_operator[IN]
- spectral_radApplyUnitFromSpectralRadiance(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, spectral_rad_transform_operator: pyarts3.arts.SpectralRadianceTransformOperator | None = None) None
Helper method for calling
spectral_radApplyUnit().It is common that
ray_pathis defined but notray_point. This method simply is a convenience wrapper for that use case.Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.ray_pointForeground() 6 ws.spectral_radApplyUnit()
Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[INOUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[INOUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]spectral_rad_transform_operator (SpectralRadianceTransformOperator, optional) – The spectral radiance transform operator. See
spectral_rad_transform_operator, defaults toself.spectral_rad_transform_operator[IN]
- spectral_radClearskyBackgroundTransmission(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, atm_field: pyarts3.arts.AtmField | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_bkg: pyarts3.arts.StokvecVector | None = None, spectral_rad_bkg_jac: pyarts3.arts.StokvecMatrix | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, hse_derivative: pyarts3.arts.Index | None = None) None
Computes clearsky transmission of spectral radiances
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.ray_pointBackground() 6 ws.atm_pathFromPath() 7 ws.freq_grid_pathFromPath() 8 ws.spectral_propmat_pathFromPath() 9 ws.spectral_tramat_pathFromPath() 10 ws.spectral_tramat_cumulative_pathFromPath() 11 ws.spectral_tramat_bkgFromPathPropagationBack() 12 ws.spectral_radCumulativeTransmission() 13 ws.spectral_rad_jacFromBackground() 14 ws.spectral_rad_jacAddPathPropagation()
Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]spectral_rad_bkg (StokvecVector, optional) – Spectral radiance from the background. See
spectral_rad_bkg, defaults toself.spectral_rad_bkg[IN]spectral_rad_bkg_jac (StokvecMatrix, optional) – Spectral radiance derivative from the background. See
spectral_rad_bkg_jac, defaults toself.spectral_rad_bkg_jac[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]hse_derivative (Index, optional) – Flag to compute the hypsometric distance derivatives. Defaults to
0[IN]
- spectral_radClearskyEmission(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, atm_field: pyarts3.arts.AtmField | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_space_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_surface_agenda: pyarts3.arts.Agenda | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, hse_derivative: pyarts3.arts.Index | None = None) None
Computes clearsky emission of spectral radiances
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.ray_pointBackground() 6 ws.spectral_rad_bkgAgendasAtEndOfPath() 7 ws.atm_pathFromPath() 8 ws.freq_grid_pathFromPath() 9 ws.spectral_propmat_pathFromPath() 10 ws.spectral_tramat_pathFromPath() 11 ws.spectral_tramat_cumulative_pathFromPath() 12 ws.spectral_rad_srcvec_pathFromPropmat() 13 ws.spectral_tramat_bkgFromPathPropagationBack() 14 ws.spectral_radStepByStepEmission() 15 ws.spectral_rad_jacFromBackground() 16 ws.spectral_rad_jacAddPathPropagation()
Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]spectral_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space. See
spectral_rad_space_agenda, defaults toself.spectral_rad_space_agenda[IN]spectral_rad_surface_agenda (Agenda, optional) – Computes spectral radiance as seen of the surface. See
spectral_rad_surface_agenda, defaults toself.spectral_rad_surface_agenda[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]hse_derivative (Index, optional) – Flag to compute the hypsometric distance derivatives. Defaults to
0[IN]
- spectral_radClearskyEmissionFrequencyDependentPropagation(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, spectral_ray_path: pyarts3.arts.ArrayOfArrayOfPropagationPathPoint | None = None, atm_field: pyarts3.arts.AtmField | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, single_rad_space_agenda: pyarts3.arts.Agenda | None = None, single_rad_surface_agenda: pyarts3.arts.Agenda | None = None, single_propmat_agenda: pyarts3.arts.Agenda | None = None, ray_point_back_propagation_agenda: pyarts3.arts.Agenda | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, obs_pos: pyarts3.arts.Vector3 | None = None, obs_los: pyarts3.arts.Vector2 | None = None, max_stepsize: pyarts3.arts.Numeric | None = None, polarization: pyarts3.arts.Propmat | None = None, max_tau: pyarts3.arts.Numeric | None = None, cutoff_tau: pyarts3.arts.Numeric | None = None, hse_derivative: pyarts3.arts.Index | None = None, N: pyarts3.arts.Index | None = None) None
Wraps
single_radClearskyEmissionPropagation()for a vector of frequencies.Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]spectral_ray_path (ArrayOfArrayOfPropagationPathPoint) – The ray paths for each frequency. Defaults to create and/or use
self.spectral_ray_path:ArrayOfArrayOfPropagationPathPoint. [OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]single_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space for a single frequency. See
single_rad_space_agenda, defaults toself.single_rad_space_agenda[IN]single_rad_surface_agenda (Agenda, optional) – Gets spectral radiance as seen of the surface for a single frequency. See
single_rad_surface_agenda, defaults toself.single_rad_surface_agenda[IN]single_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, the dispersion, and their derivatives. See
single_propmat_agenda, defaults toself.single_propmat_agenda[IN]ray_point_back_propagation_agenda (Agenda, optional) – Gets the next past point along a propagation path. See
ray_point_back_propagation_agenda, defaults toself.ray_point_back_propagation_agenda[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]obs_pos (Vector3, optional) – The position of an observer of spectral radiance. See
obs_pos, defaults toself.obs_pos[IN]obs_los (Vector2, optional) – The line-of-sight of the observer of spectral radiance. See
obs_los, defaults toself.obs_los[IN]max_stepsize (Numeric, optional) – A control parameter for stepping through layers in ray tracing. See
max_stepsize, defaults toself.max_stepsize[IN]polarization (Propmat, optional) – Delta of the dispersion in polarizized form. The dot-product of this and the propagation matrix is added to the internal
single_dispersionvariable. Defaults to0 0 0 0 0 0 0[IN]max_tau (Numeric, optional) – The maximum optical thickness per step, min of local
PropmatA divided bymax_tauandmax_stepsizeis passed toray_point_back_propagation_agendaExecute(). Note that this is an approximation that will fail for highly non-linear absorption profiles. As implemented, it takes too long steps if going from low to high absorption, and too short steps when going from high to low absorption. See it as an approximation. Defaults to0.01[IN]cutoff_tau (Numeric, optional) – Cutoff optical thickness for terminating the integration, computed as total
PropmatA times distance. If exceeded, the atmosphere is considered opaque and the temperature at that coordinate is used for the background radiation. If not exceeded, the actual background is considered. Note that errors will be large if exp(-cutoff_tau) is not small. Defaults to14[IN]hse_derivative (Index, optional) – Flag to compute the hypsometric distance derivatives. Defaults to
0[IN]N (Index, optional) – Number of points to reserve in the ray path. Defaults to
1[IN]
- spectral_radClearskyEmissionParFreq(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, atm_field: pyarts3.arts.AtmField | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_space_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_surface_agenda: pyarts3.arts.Agenda | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, hse_derivative: pyarts3.arts.Index | None = None) None
Computes clearsky emission of spectral radiances
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.ray_pointBackground() 6 ws.spectral_rad_bkgAgendasAtEndOfPath() 7 ws.atm_pathFromPath() 8 ws.freq_grid_pathFromPath() 9 ws.spectral_propmat_pathFromPath() 10 ws.spectral_radSetToBackground() 11 ws.spectral_radSinglePathEmissionFrequencyLoop()
Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]spectral_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space. See
spectral_rad_space_agenda, defaults toself.spectral_rad_space_agenda[IN]spectral_rad_surface_agenda (Agenda, optional) – Computes spectral radiance as seen of the surface. See
spectral_rad_surface_agenda, defaults toself.spectral_rad_surface_agenda[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]hse_derivative (Index, optional) – Flag to compute the hypsometric distance derivatives. Defaults to
0[IN]
- spectral_radClearskyRayleighScattering(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, atm_field: pyarts3.arts.AtmField | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, ray_path_suns_path: pyarts3.arts.ArrayOfArrayOfArrayOfPropagationPathPoint | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, spectral_propmat_scat_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_space_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_surface_agenda: pyarts3.arts.Agenda | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, suns: pyarts3.arts.ArrayOfSun | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, hse_derivative: pyarts3.arts.Index | None = None, depolarization_factor: pyarts3.arts.Numeric | None = None) None
Computes clearsky emission of spectral radiances with solar Rayleigh scattering
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.ray_pointBackground() 6 ws.spectral_rad_bkgAgendasAtEndOfPath() 7 ws.atm_pathFromPath() 8 ws.freq_grid_pathFromPath() 9 ws.spectral_propmat_pathFromPath() 10 ws.spectral_propmat_scat_pathFromPath() 11 ws.spectral_propmat_pathAddScattering() 12 ws.spectral_tramat_pathFromPath() 13 ws.spectral_tramat_cumulative_pathFromPath() 14 ws.spectral_rad_srcvec_pathFromPropmat() 15 ws.spectral_rad_scat_pathSunsFirstOrderRayleigh() 16 ws.spectral_rad_srcvec_pathAddScattering() 17 ws.spectral_tramat_bkgFromPathPropagationBack() 18 ws.spectral_radStepByStepEmission() 19 ws.spectral_rad_jacFromBackground() 20 ws.spectral_rad_jacAddPathPropagation()
Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]ray_path_suns_path (ArrayOfArrayOfArrayOfPropagationPathPoint, optional) – A list of paths to the suns from the ray path. See
ray_path_suns_path, defaults toself.ray_path_suns_path[IN]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]spectral_propmat_scat_agenda (Agenda, optional) – Computes the part of the propagation matrix that relates to scattering. See
spectral_propmat_scat_agenda, defaults toself.spectral_propmat_scat_agenda[IN]spectral_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space. See
spectral_rad_space_agenda, defaults toself.spectral_rad_space_agenda[IN]spectral_rad_surface_agenda (Agenda, optional) – Computes spectral radiance as seen of the surface. See
spectral_rad_surface_agenda, defaults toself.spectral_rad_surface_agenda[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]suns (ArrayOfSun, optional) – A list of
Sun. Seesuns, defaults toself.suns[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]hse_derivative (Index, optional) – Flag to compute the hypsometric distance derivatives. Defaults to
0[IN]depolarization_factor (Numeric, optional) – The depolarization factor to use. Defaults to
0[IN]
- spectral_radClearskyTransmission(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, atm_field: pyarts3.arts.AtmField | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_space_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_surface_agenda: pyarts3.arts.Agenda | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, hse_derivative: pyarts3.arts.Index | None = None) None
Computes clearsky transmission of spectral radiances
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.ray_pointBackground() 6 ws.spectral_rad_bkgAgendasAtEndOfPath() 7 ws.atm_pathFromPath() 8 ws.freq_grid_pathFromPath() 9 ws.spectral_propmat_pathFromPath() 10 ws.spectral_tramat_pathFromPath() 11 ws.spectral_tramat_cumulative_pathFromPath() 12 ws.spectral_tramat_bkgFromPathPropagationBack() 13 ws.spectral_radCumulativeTransmission() 14 ws.spectral_rad_jacFromBackground() 15 ws.spectral_rad_jacAddPathPropagation()
Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]spectral_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space. See
spectral_rad_space_agenda, defaults toself.spectral_rad_space_agenda[IN]spectral_rad_surface_agenda (Agenda, optional) – Computes spectral radiance as seen of the surface. See
spectral_rad_surface_agenda, defaults toself.spectral_rad_surface_agenda[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]hse_derivative (Index, optional) – Flag to compute the hypsometric distance derivatives. Defaults to
0[IN]
- spectral_radCumulativeTransmission(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac_path: pyarts3.arts.ArrayOfStokvecMatrix | None = None, spectral_tramat_path: pyarts3.arts.ArrayOfMuelmatVector | None = None, spectral_tramat_cumulative_path: pyarts3.arts.ArrayOfMuelmatVector | None = None, spectral_tramat_jac_path: pyarts3.arts.ArrayOfMuelmatTensor3 | None = None, spectral_rad_bkg: pyarts3.arts.StokvecVector | None = None) None
Gets the spectral radiance from the path transmission.
Also get the Jacobian of the spectral radiance with regards to the path parameters.
Author: Richard Larsson
Used by wrapper methods
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac_path (ArrayOfStokvecMatrix, optional) – Spectral radiance derivative along the propagation path. See
spectral_rad_jac_path, defaults toself.spectral_rad_jac_path[OUT]spectral_tramat_path (ArrayOfMuelmatVector, optional) – Transmission matrices along the propagation path. See
spectral_tramat_path, defaults toself.spectral_tramat_path[IN]spectral_tramat_cumulative_path (ArrayOfMuelmatVector, optional) – Cumulative transmission matrices along the propagation path. See
spectral_tramat_cumulative_path, defaults toself.spectral_tramat_cumulative_path[IN]spectral_tramat_jac_path (ArrayOfMuelmatTensor3, optional) – Transmission derivative matrices along the propagation path. See
spectral_tramat_jac_path, defaults toself.spectral_tramat_jac_path[IN]spectral_rad_bkg (StokvecVector, optional) – Spectral radiance from the background. See
spectral_rad_bkg, defaults toself.spectral_rad_bkg[IN]
- spectral_radDefaultTransmission(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets default
spectral_radandspectral_rad_jacfor transmission.The Jacobian variable is all 0s, the background is [1 0 0 0] everywhere
Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- spectral_radFromDisort(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, disort_spectral_rad_field: pyarts3.arts.DisortRadiance | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None) None
Extract spectral radiance from the Disort field at the ray path point.
Author: Richard Larsson
Used by wrapper method
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]disort_spectral_rad_field (DisortRadiance, optional) – The spectral radiance field from Disort. See
disort_spectral_rad_field, defaults toself.disort_spectral_rad_field[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]
- spectral_radIntegrateDisort(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, disort_spectral_rad_field: pyarts3.arts.DisortRadiance | None = None, disort_quadrature: pyarts3.arts.ZenGriddedField1 | None = None) None
Integrate Disort spectral radiance.
Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]disort_spectral_rad_field (DisortRadiance, optional) – The spectral radiance field from Disort. See
disort_spectral_rad_field, defaults toself.disort_spectral_rad_field[IN]disort_quadrature (ZenGriddedField1, optional) – The quadrature angles for Disort with accompying weights. See
disort_quadrature, defaults toself.disort_quadrature[IN]
- spectral_radSetToBackground(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, spectral_rad_bkg: pyarts3.arts.StokvecVector | None = None, spectral_rad_bkg_jac: pyarts3.arts.StokvecMatrix | None = None) None
Set the spectral radiance to the background values.
Note
This method is compositional and useful inside other agendas or meta-methods.
Author: Richard Larsson
Used by wrapper method
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]spectral_rad_bkg (StokvecVector, optional) – Spectral radiance from the background. See
spectral_rad_bkg, defaults toself.spectral_rad_bkg[IN]spectral_rad_bkg_jac (StokvecMatrix, optional) – Spectral radiance derivative from the background. See
spectral_rad_bkg_jac, defaults toself.spectral_rad_bkg_jac[IN]
- spectral_radSinglePathEmissionFrequencyLoop(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, freq_grid_path: pyarts3.arts.ArrayOfAscendingGrid | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None, spectral_propmat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, spectral_nlte_srcvec_path: pyarts3.arts.ArrayOfStokvecVector | None = None, spectral_propmat_jac_path: pyarts3.arts.ArrayOfPropmatMatrix | None = None, spectral_nlte_srcvec_jac_path: pyarts3.arts.ArrayOfStokvecMatrix | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, atm_field: pyarts3.arts.AtmField | None = None, hse_derivative: pyarts3.arts.Index | None = None) None
Computes the spectral radiance by looping over frequencies for a single path.
Author: Richard Larsson
Used by wrapper method
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[INOUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[INOUT]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]freq_grid_path (ArrayOfAscendingGrid, optional) – All
freq_gridalong the propagation path. Seefreq_grid_path, defaults toself.freq_grid_path[IN]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]spectral_propmat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path. See
spectral_propmat_path, defaults toself.spectral_propmat_path[IN]spectral_nlte_srcvec_path (ArrayOfStokvecVector, optional) – Additional non-LTE along the propagation path. See
spectral_nlte_srcvec_path, defaults toself.spectral_nlte_srcvec_path[IN]spectral_propmat_jac_path (ArrayOfPropmatMatrix, optional) – Propagation derivative matrices along the propagation path. See
spectral_propmat_jac_path, defaults toself.spectral_propmat_jac_path[IN]spectral_nlte_srcvec_jac_path (ArrayOfStokvecMatrix, optional) – Additional non-LTE derivative along the propagation path. See
spectral_nlte_srcvec_jac_path, defaults toself.spectral_nlte_srcvec_jac_path[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]hse_derivative (Index, optional) – Flag to compute the hypsometric distance derivatives. Defaults to
0[IN]
- spectral_radStepByStepEmission(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac_path: pyarts3.arts.ArrayOfStokvecMatrix | None = None, spectral_tramat_path: pyarts3.arts.ArrayOfMuelmatVector | None = None, spectral_tramat_cumulative_path: pyarts3.arts.ArrayOfMuelmatVector | None = None, spectral_tramat_jac_path: pyarts3.arts.ArrayOfMuelmatTensor3 | None = None, spectral_rad_srcvec_path: pyarts3.arts.ArrayOfStokvecVector | None = None, spectral_rad_srcvec_jac_path: pyarts3.arts.ArrayOfStokvecMatrix | None = None, spectral_rad_bkg: pyarts3.arts.StokvecVector | None = None) None
Gets the spectral radiance from the path.
This uses a step-by-step solver to propagate background radiation along the path.
Author: Richard Larsson
Used by wrapper methods
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac_path (ArrayOfStokvecMatrix, optional) – Spectral radiance derivative along the propagation path. See
spectral_rad_jac_path, defaults toself.spectral_rad_jac_path[OUT]spectral_tramat_path (ArrayOfMuelmatVector, optional) – Transmission matrices along the propagation path. See
spectral_tramat_path, defaults toself.spectral_tramat_path[IN]spectral_tramat_cumulative_path (ArrayOfMuelmatVector, optional) – Cumulative transmission matrices along the propagation path. See
spectral_tramat_cumulative_path, defaults toself.spectral_tramat_cumulative_path[IN]spectral_tramat_jac_path (ArrayOfMuelmatTensor3, optional) – Transmission derivative matrices along the propagation path. See
spectral_tramat_jac_path, defaults toself.spectral_tramat_jac_path[IN]spectral_rad_srcvec_path (ArrayOfStokvecVector, optional) – Source vectors along the propagation path. See
spectral_rad_srcvec_path, defaults toself.spectral_rad_srcvec_path[IN]spectral_rad_srcvec_jac_path (ArrayOfStokvecMatrix, optional) – Source derivative vectors along the propagation path. See
spectral_rad_srcvec_jac_path, defaults toself.spectral_rad_srcvec_jac_path[IN]spectral_rad_bkg (StokvecVector, optional) – Spectral radiance from the background. See
spectral_rad_bkg, defaults toself.spectral_rad_bkg[IN]
- spectral_radSubsurfaceDisortEmission(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, disort_settings: pyarts3.arts.DisortSettings | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, disort_spectral_rad_field: pyarts3.arts.DisortRadiance | None = None, disort_quadrature: pyarts3.arts.ZenGriddedField1 | None = None, atm_field: pyarts3.arts.AtmField | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None, disort_settings_downwelling_wrapper_agenda: pyarts3.arts.Agenda | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, depth_profile: pyarts3.arts.DescendingGrid | None = None, azi_grid: pyarts3.arts.AziGrid | None = None) None
Get the spectral radiance from subsurface emission simulated using Disort
Wrapper calling Methods (in order):
Equivalent (mostly) Python code:
1ws = pyarts.Workspace() 2 3# ... 4 5 ws.ray_pathFromPointAndDepth() 6 ws.disort_settings_downwelling_wrapper_agendaExecute() 7 ws.disort_spectral_rad_fieldCalc() 8 ws.spectral_radFromDisort()
Authors: Richard Larsson,
Automatically Generated- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]disort_settings (DisortSettings, optional) – Contains the full settings of spectral Disort calculations. See
disort_settings, defaults toself.disort_settings[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]disort_spectral_rad_field (DisortRadiance, optional) – The spectral radiance field from Disort. See
disort_spectral_rad_field, defaults toself.disort_spectral_rad_field[OUT]disort_quadrature (ZenGriddedField1, optional) – The quadrature angles for Disort with accompying weights. See
disort_quadrature, defaults toself.disort_quadrature[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]disort_settings_downwelling_wrapper_agenda (Agenda, optional) – An wrapper agenda for calling
disort_settings_agenda. Seedisort_settings_downwelling_wrapper_agenda, defaults toself.disort_settings_downwelling_wrapper_agenda[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]depth_profile (DescendingGrid) – List of depths. [IN]
azi_grid (AziGrid, optional) – The azimuthal angles. Defaults to
0[IN]
- spectral_radSubsurfaceDisortEmissionWithJacobian(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, disort_quadrature_dimension: pyarts3.arts.Index | None = None, disort_fourier_mode_dimension: pyarts3.arts.Index | None = None, disort_legendre_polynomial_dimension: pyarts3.arts.Index | None = None, disort_settings_agenda: pyarts3.arts.Agenda | None = None, disort_settings_downwelling_wrapper_agenda: pyarts3.arts.Agenda | None = None, depth_profile: pyarts3.arts.DescendingGrid | None = None) None
Gets the spectral radiance from the path.
The Jacobian is computed by perturbations. Sensor and absorption data are not considered as part of the perturbations.
The method wraps calling
spectral_radSubsurfaceDisortEmission()by perturbingmodel_state_vecfor Jacobian calculations usingmodel_state_vecPerturbations().Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]disort_quadrature_dimension (Index, optional) – The quadrature size for Disort. See
disort_quadrature_dimension, defaults toself.disort_quadrature_dimension[IN]disort_fourier_mode_dimension (Index, optional) – The number of Fourier modes for Disort. See
disort_fourier_mode_dimension, defaults toself.disort_fourier_mode_dimension[IN]disort_legendre_polynomial_dimension (Index, optional) – The number of input Legendre polynimials for Disort. See
disort_legendre_polynomial_dimension, defaults toself.disort_legendre_polynomial_dimension[IN]disort_settings_agenda (Agenda, optional) – An agenda for setting up Disort. See
disort_settings_agenda, defaults toself.disort_settings_agenda[IN]disort_settings_downwelling_wrapper_agenda (Agenda, optional) – An wrapper agenda for calling
disort_settings_agenda. Seedisort_settings_downwelling_wrapper_agenda, defaults toself.disort_settings_downwelling_wrapper_agenda[IN]depth_profile (DescendingGrid) – List of depths. [IN]
- spectral_radSunOrCosmicBackground(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, sun_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, sun: pyarts3.arts.Sun | None = None, surf_field: pyarts3.arts.SurfaceField | None = None) None
Get the spectral radiance of a sun or of the cosmic background if the sun is not hit.
Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]sun_path (ArrayOfPropagationPathPoint, optional) – A path to a sun if it is visible. See
sun_path, defaults toself.sun_path[IN]sun (Sun, optional) – A sun. See
sun, defaults toself.sun[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]
- spectral_radSunsOrCosmicBackground(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, suns: pyarts3.arts.ArrayOfSun | None = None, surf_field: pyarts3.arts.SurfaceField | None = None) None
Get the spectral radiance of a sun or of the cosmic background if no sun is hit.
Note
Only the first sun is used if multiple suns are defined, so it is advantageous to have sorted
sunsby distance before running this code. If you only have one sun, this is of course not an issue but you could consider usingspectral_radSunOrCosmicBackground()instead.Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]suns (ArrayOfSun, optional) – A list of
Sun. Seesuns, defaults toself.suns[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]
- spectral_radSurfaceBlackbody(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None) None
Set surface spectral radiance from Planck function of the surface temperature.
\[\begin{split}\vec{I} = \left[ \begin{array}{c} \frac{2h\vec{\nu}^3}{c^2} \frac{1}{e^{\frac{h\vec{\nu}}{kT_s}} - 1} \\ 0 \\ 0 \\ 0 \end{array}\right],\end{split}\]where \(T_s\) is the surface temperature extracted at the input
ray_point. \(\nu\) is the frequency grid.Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]
- spectral_radSurfaceReflectance(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, spectral_rad_observer_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_closed_surface_agenda: pyarts3.arts.Agenda | None = None, spectral_surf_refl_agenda: pyarts3.arts.Agenda | None = None) None
Set surface spectral radiance to use sub-surface emission and Fresnel reflectance.
The input path point must be close to the surface.
The
spectral_rad_closed_surface_agendashould produce the surface emission, though pure surface emission is fine.The surface field must contain the surface refractive index. The refractive index lives under the
SurfacePropertyTagkey “scalar refractive index”.Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]spectral_rad_observer_agenda (Agenda, optional) – Computes spectral radiance as seen from the input position and environment. See
spectral_rad_observer_agenda, defaults toself.spectral_rad_observer_agenda[IN]spectral_rad_closed_surface_agenda (Agenda, optional) – A closed surface agenda. See
spectral_rad_closed_surface_agenda, defaults toself.spectral_rad_closed_surface_agenda[IN]spectral_surf_refl_agenda (Agenda, optional) – An agenda to compute the surface reflectance. See
spectral_surf_refl_agenda, defaults toself.spectral_surf_refl_agenda[IN]
- spectral_radUniformCosmicBackground(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None) None
Background spectral radiance is from a uniform cosmic background temperature.
\[\begin{split}\vec{I} = \left[ \begin{array}{c} \frac{2h\vec{\nu}^3}{c^2} \frac{1}{e^{\frac{h\vec{\nu}}{kT_c}} - 1} \\ 0 \\ 0 \\ 0 \end{array}\right],\end{split}\]where \(T_c\) is the cosmic microwave background temperature. \(\nu\) is the frequency grid.
Author: Richard Larsson
- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]
- spectral_rad_bkgAgendasAtEndOfPath(self, spectral_rad_bkg: pyarts3.arts.StokvecVector | None = None, spectral_rad_bkg_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, spectral_rad_space_agenda: pyarts3.arts.Agenda | None = None, spectral_rad_surface_agenda: pyarts3.arts.Agenda | None = None) None
Computes the background radiation.
This method checks the back of the ray path and calls
spectral_rad_space_agendaandspectral_rad_surface_agendaas needed.If the back of the path is still in the atmosphere, an error is raised. As is it if the background position is unknown.
Tip
To access subsurface emission, the
spectral_rad_surface_agendamust be able to handle subsurface emission. It will likely need the surface emission agenda as well, but that would be circular. Therefore, please consider usingspectral_rad_closed_surface_agendato compute the surface emission without invoking recursion.Author: Richard Larsson
Used by wrapper methods
- Parameters:
spectral_rad_bkg (StokvecVector, optional) – Spectral radiance from the background. See
spectral_rad_bkg, defaults toself.spectral_rad_bkg[OUT]spectral_rad_bkg_jac (StokvecMatrix, optional) – Spectral radiance derivative from the background. See
spectral_rad_bkg_jac, defaults toself.spectral_rad_bkg_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]spectral_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space. See
spectral_rad_space_agenda, defaults toself.spectral_rad_space_agenda[IN]spectral_rad_surface_agenda (Agenda, optional) – Computes spectral radiance as seen of the surface. See
spectral_rad_surface_agenda, defaults toself.spectral_rad_surface_agenda[IN]
- spectral_rad_fieldFromOperatorPath(self, spectral_rad_field: pyarts3.arts.GriddedSpectralField6 | None = None, spectral_rad_operator: pyarts3.arts.SpectralRadianceOperator | None = None, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, zen_grid: pyarts3.arts.ZenGrid | None = None, azi_grid: pyarts3.arts.AziGrid | None = None) None
Computes the spectral radiance field using
ray_path_observer_agenda.Each point is in computed individually, so there will be zenith x azimuth x altitude x latitude x longitude x frequency number of calculations. The positional arguments are taken from
spectral_rad_operator.If the code is not already in parallel operation mode when this method is called, the first 5 dimensions are computed in parallel.
Author: Richard Larsson
- Parameters:
spectral_rad_field (GriddedSpectralField6, optional) – The spectral radiance field. See
spectral_rad_field, defaults toself.spectral_rad_field[OUT]spectral_rad_operator (SpectralRadianceOperator, optional) – The spectral radiance operator. See
spectral_rad_operator, defaults toself.spectral_rad_operator[IN]ray_path_observer_agenda (Agenda, optional) – Gets the propagation path as it is obeserved. See
ray_path_observer_agenda, defaults toself.ray_path_observer_agenda[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]zen_grid (ZenGrid, optional) – A single zenith angle grid. See
zen_grid, defaults toself.zen_grid[IN]azi_grid (AziGrid) – The azimuth grid. [IN]
- spectral_rad_fieldFromOperatorPlanarGeometric(self, spectral_rad_field: pyarts3.arts.GriddedSpectralField6 | None = None, spectral_rad_operator: pyarts3.arts.SpectralRadianceOperator | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, zen_grid: pyarts3.arts.ZenGrid | None = None, azi_grid: pyarts3.arts.AziGrid | None = None) None
Computes the spectral radiance field assuming planar geometric paths
A planar geometric path is just defined by a 1D atmospheric profile. If the
spectral_rad_operatorcontains more than one latitude and/or longitude point, their altitude profiles are treated independently.Limitations:
The zenith grid is not allowed to contain the value 90 degrees.
Author: Richard Larsson
- Parameters:
spectral_rad_field (GriddedSpectralField6, optional) – The spectral radiance field. See
spectral_rad_field, defaults toself.spectral_rad_field[OUT]spectral_rad_operator (SpectralRadianceOperator, optional) – The spectral radiance operator. See
spectral_rad_operator, defaults toself.spectral_rad_operator[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]zen_grid (ZenGrid, optional) – A single zenith angle grid. See
zen_grid, defaults toself.zen_grid[IN]azi_grid (AziGrid) – The azimuth grid. [IN]
- spectral_rad_fieldProfilePseudo2D(self, spectral_rad_field: pyarts3.arts.GriddedSpectralField6 | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, atm_profile: pyarts3.arts.ArrayOfAtmPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, zen_grid: pyarts3.arts.ZenGrid | None = None, alt_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, azi: pyarts3.arts.Numeric | None = None) None
Computes the spectral radiance field assuming a profile and a pseudo-2D path.
A profile is defined as having space blackbody emission from the top and surface temperature blackbody emissision from the surface.
Limb paths are only considered when the zenith angle misses the next lower level using the same mechanism as in
zen_gridProfilePseudo2D().Author: Richard Larsson
Used by wrapper method
- Parameters:
spectral_rad_field (GriddedSpectralField6, optional) – The spectral radiance field. See
spectral_rad_field, defaults toself.spectral_rad_field[OUT]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]atm_profile (ArrayOfAtmPoint, optional) – An atmospheric profile in ARTS. See
atm_profile, defaults toself.atm_profile[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]zen_grid (ZenGrid, optional) – A single zenith angle grid. See
zen_grid, defaults toself.zen_grid[IN]alt_grid (AscendingGrid, optional) – An ascending list of
alt. Often related to a field or a profile. Seealt_grid, defaults toself.alt_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]azi (Numeric, optional) – The azimuth. Defaults to
0[IN]
- spectral_rad_jacAddPathPropagation(self, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, spectral_rad_jac_path: pyarts3.arts.ArrayOfStokvecMatrix | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, atm_field: pyarts3.arts.AtmField | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None) None
Adds the propagation variables to
spectral_rad_jac.Author: Richard Larsson
Used by wrapper methods
- Parameters:
spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[INOUT]spectral_rad_jac_path (ArrayOfStokvecMatrix, optional) – Spectral radiance derivative along the propagation path. See
spectral_rad_jac_path, defaults toself.spectral_rad_jac_path[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]
- spectral_rad_jacAddSensorJacobianPerturbations(self, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, spectral_rad: pyarts3.arts.StokvecVector | None = None, measurement_sensor: pyarts3.arts.ArrayOfSensorObsel | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, obs_pos: pyarts3.arts.Vector3 | None = None, obs_los: pyarts3.arts.Vector2 | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, spectral_rad_observer_agenda: pyarts3.arts.Agenda | None = None) None
Adds sensor properties to the
spectral_rad_jac.This is done via perturbation based on the input delta values to the sensor Jacobian targets and a callback to
spectral_rad_observer_agendawith a modifiedjac_targets, making it safe to use this method insidespectral_rad_observer_agenda.Author: Richard Larsson
- Parameters:
spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[INOUT]spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[IN]measurement_sensor (ArrayOfSensorObsel, optional) – A list of sensor elements. See
measurement_sensor, defaults toself.measurement_sensor[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]obs_pos (Vector3, optional) – The position of an observer of spectral radiance. See
obs_pos, defaults toself.obs_pos[IN]obs_los (Vector2, optional) – The line-of-sight of the observer of spectral radiance. See
obs_los, defaults toself.obs_los[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]spectral_rad_observer_agenda (Agenda, optional) – Computes spectral radiance as seen from the input position and environment. See
spectral_rad_observer_agenda, defaults toself.spectral_rad_observer_agenda[IN]
- spectral_rad_jacEmpty(self, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Set the radiation derivative to empty.
Size : (
jac_targets,freq_grid)Author: Richard Larsson
- Parameters:
spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- spectral_rad_jacFromBackground(self, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, spectral_rad_bkg_jac: pyarts3.arts.StokvecMatrix | None = None, spectral_tramat_bkg: pyarts3.arts.MuelmatVector | None = None) None
Sets
spectral_rad_jacfrom the background values.Author: Richard Larsson
Used by wrapper methods
- Parameters:
spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]spectral_rad_bkg_jac (StokvecMatrix, optional) – Spectral radiance derivative from the background. See
spectral_rad_bkg_jac, defaults toself.spectral_rad_bkg_jac[IN]spectral_tramat_bkg (MuelmatVector, optional) – Transmittance from the background. See
spectral_tramat_bkg, defaults toself.spectral_tramat_bkg[IN]
- spectral_rad_observer_agendaExecute(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, obs_pos: pyarts3.arts.Vector3 | None = None, obs_los: pyarts3.arts.Vector2 | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, spectral_rad_observer_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
spectral_rad_observer_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]obs_pos (Vector3, optional) – The position of an observer of spectral radiance. See
obs_pos, defaults toself.obs_pos[IN]obs_los (Vector2, optional) – The line-of-sight of the observer of spectral radiance. See
obs_los, defaults toself.obs_los[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]spectral_rad_observer_agenda (Agenda, optional) – Computes spectral radiance as seen from the input position and environment. See
spectral_rad_observer_agenda, defaults toself.spectral_rad_observer_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- spectral_rad_observer_agendaExecuteOperator(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, obs_pos: pyarts3.arts.Vector3 | None = None, obs_los: pyarts3.arts.Vector2 | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, spectral_rad_observer_agenda_operator: pyarts3.arts.spectral_rad_observer_agendaOperator | None = None) None
Executes an operator emulating
spectral_rad_observer_agenda, see it, and alsospectral_rad_observer_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]obs_pos (Vector3, optional) – The position of an observer of spectral radiance. See
obs_pos, defaults toself.obs_pos[IN]obs_los (Vector2, optional) – The line-of-sight of the observer of spectral radiance. See
obs_los, defaults toself.obs_los[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]spectral_rad_observer_agenda_operator (spectral_rad_observer_agendaOperator) – Operator for
spectral_rad_observer_agenda. [IN]
- spectral_rad_observer_agendaSet(self, spectral_rad_observer_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
spectral_rad_observer_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
spectral_rad_observer_agenda (Agenda, optional) – Computes spectral radiance as seen from the input position and environment. See
spectral_rad_observer_agenda, defaults toself.spectral_rad_observer_agenda[OUT]option (String, optional) – Choice of generated agenda. Defaults to
"Emission"[IN]
Valid options
These are the valid options for the
spectral_rad_observer_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
spectral_rad_observer_agendaSet(option="Emission")Shares the global
measurement_sensorShares the global
ray_path_observer_agendaShares the global
spectral_propmat_agendaShares the global
spectral_rad_observer_agendaShares the global
spectral_rad_space_agendaShares the global
spectral_rad_surface_agendahse_derivative = 0
spectral_rad_observer_agendaSet(option="EmissionAdaptiveHalfsteps")Shares the global
max_stepsizeShares the global
measurement_sensorShares the global
ray_path_observer_agendaShares the global
spectral_propmat_agendaShares the global
spectral_rad_observer_agendaShares the global
spectral_rad_space_agendaShares the global
spectral_rad_surface_agendamax_tau = 0.1
cutoff_tau = 3
hse_derivative = 0
spectral_rad_observer_agendaSet(option="EmissionNoSensor")Shares the global
ray_path_observer_agendaShares the global
spectral_propmat_agendaShares the global
spectral_rad_space_agendaShares the global
spectral_rad_surface_agendahse_derivative = 0
- spectral_rad_observer_agendaSetOperator(self, spectral_rad_observer_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.spectral_rad_observer_agendaOperator | None = None) None
Set
spectral_rad_observer_agendato exclusively use provided external operator. Seespectral_rad_observer_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
spectral_rad_observer_agenda (Agenda, optional) – Computes spectral radiance as seen from the input position and environment. See
spectral_rad_observer_agenda, defaults toself.spectral_rad_observer_agenda[OUT]f (spectral_rad_observer_agendaOperator) – Operator for
spectral_rad_observer_agenda. [IN]
- spectral_rad_operatorClearsky1D(self, spectral_rad_operator: pyarts3.arts.SpectralRadianceOperator | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, alt_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, cia_extrapolation: pyarts3.arts.Numeric | None = None, cia_robust: pyarts3.arts.Index | None = None) None
Set up a 1D spectral radiance operator
The operator is set up to compute the spectral radiance at any point as seen from a 1D atmospheric profile.
This method will share line-by-line,cross-section, collision-induced absorption, and predefined model data with the workspace (if they exist already when this method is called).
Author: Richard Larsson
- Parameters:
spectral_rad_operator (SpectralRadianceOperator, optional) – The spectral radiance operator. See
spectral_rad_operator, defaults toself.spectral_rad_operator[OUT]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]alt_grid (AscendingGrid, optional) – An ascending list of
alt. Often related to a field or a profile. Seealt_grid, defaults toself.alt_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]cia_extrapolation (Numeric, optional) – The extrapolation distance for cia. Defaults to
0[IN]cia_robust (Index, optional) – The robustness of the cia extrapolation. Defaults to
0[IN]
- spectral_rad_scat_pathSunsFirstOrderRayleigh(self, spectral_rad_scat_path: pyarts3.arts.ArrayOfStokvecVector | None = None, spectral_propmat_scat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, ray_path_suns_path: pyarts3.arts.ArrayOfArrayOfArrayOfPropagationPathPoint | None = None, suns: pyarts3.arts.ArrayOfSun | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_field: pyarts3.arts.AtmField | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, spectral_propmat_agenda: pyarts3.arts.Agenda | None = None, depolarization_factor: pyarts3.arts.Numeric | None = None, hse_derivative: pyarts3.arts.Index | None = None) None
Add
sunstospectral_rad_srcvec_path.Author: Richard Larsson
Used by wrapper method
- Parameters:
spectral_rad_scat_path (ArrayOfStokvecVector, optional) – Spectral radiance scattered into the propagation path. See
spectral_rad_scat_path, defaults toself.spectral_rad_scat_path[OUT]spectral_propmat_scat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path for scattering. See
spectral_propmat_scat_path, defaults toself.spectral_propmat_scat_path[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]ray_path_suns_path (ArrayOfArrayOfArrayOfPropagationPathPoint, optional) – A list of paths to the suns from the ray path. See
ray_path_suns_path, defaults toself.ray_path_suns_path[IN]suns (ArrayOfSun, optional) – A list of
Sun. Seesuns, defaults toself.suns[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]atm_field (AtmField, optional) – An atmospheric field in ARTS. See
atm_field, defaults toself.atm_field[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]spectral_propmat_agenda (Agenda, optional) – Computes the propagation matrix, the non-LTE source vector, and their derivatives. See
spectral_propmat_agenda, defaults toself.spectral_propmat_agenda[IN]depolarization_factor (Numeric, optional) – The depolarization factor to use. Defaults to
0[IN]hse_derivative (Index, optional) – Flag to compute the hypsometric distance derivatives. Defaults to
0[IN]
- spectral_rad_space_agendaExecute(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, spectral_rad_space_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
spectral_rad_space_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]spectral_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space. See
spectral_rad_space_agenda, defaults toself.spectral_rad_space_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- spectral_rad_space_agendaExecuteOperator(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, spectral_rad_space_agenda_operator: pyarts3.arts.spectral_rad_space_agendaOperator | None = None) None
Executes an operator emulating
spectral_rad_space_agenda, see it, and alsospectral_rad_space_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]spectral_rad_space_agenda_operator (spectral_rad_space_agendaOperator) – Operator for
spectral_rad_space_agenda. [IN]
- spectral_rad_space_agendaSet(self, spectral_rad_space_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
spectral_rad_space_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
spectral_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space. See
spectral_rad_space_agenda, defaults toself.spectral_rad_space_agenda[OUT]option (String, optional) – Choice of generated agenda. Defaults to
"UniformCosmicBackground"[IN]
Valid options
These are the valid options for the
spectral_rad_space_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
spectral_rad_space_agendaSet(option="UniformCosmicBackground")
spectral_rad_space_agendaSet(option="SunOrCosmicBackground")Shares the global
sunsShares the global
surf_field
spectral_rad_space_agendaSet(option="Transmission")
- spectral_rad_space_agendaSetOperator(self, spectral_rad_space_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.spectral_rad_space_agendaOperator | None = None) None
Set
spectral_rad_space_agendato exclusively use provided external operator. Seespectral_rad_space_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
spectral_rad_space_agenda (Agenda, optional) – Gets spectral radiance as seen of space. See
spectral_rad_space_agenda, defaults toself.spectral_rad_space_agenda[OUT]f (spectral_rad_space_agendaOperator) – Operator for
spectral_rad_space_agenda. [IN]
- spectral_rad_srcvec_pathAddScattering(self, spectral_rad_srcvec_path: pyarts3.arts.ArrayOfStokvecVector | None = None, spectral_rad_scat_path: pyarts3.arts.ArrayOfStokvecVector | None = None, spectral_propmat_path: pyarts3.arts.ArrayOfPropmatVector | None = None) None
Adds the scattering part of the propagation matrix to the rest along the path.
The calculations are in parallel if the program is not in parallel already.
Author: Richard Larsson
Used by wrapper method
- Parameters:
spectral_rad_srcvec_path (ArrayOfStokvecVector, optional) – Source vectors along the propagation path. See
spectral_rad_srcvec_path, defaults toself.spectral_rad_srcvec_path[INOUT]spectral_rad_scat_path (ArrayOfStokvecVector, optional) – Spectral radiance scattered into the propagation path. See
spectral_rad_scat_path, defaults toself.spectral_rad_scat_path[IN]spectral_propmat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path. See
spectral_propmat_path, defaults toself.spectral_propmat_path[IN]
- spectral_rad_srcvec_pathFromPropmat(self, spectral_rad_srcvec_path: pyarts3.arts.ArrayOfStokvecVector | None = None, spectral_rad_srcvec_jac_path: pyarts3.arts.ArrayOfStokvecMatrix | None = None, spectral_propmat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, spectral_nlte_srcvec_path: pyarts3.arts.ArrayOfStokvecVector | None = None, spectral_propmat_jac_path: pyarts3.arts.ArrayOfPropmatMatrix | None = None, spectral_nlte_srcvec_jac_path: pyarts3.arts.ArrayOfStokvecMatrix | None = None, freq_grid_path: pyarts3.arts.ArrayOfAscendingGrid | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Gets the source term along the path.
Per
Stokvecelement (single frequency, single temperature, single derivative target), the source term is computed as:\[\vec{J} = B(T, f) + \mathbf{K}^{-1} \vec{S}\]and the Jacobian is computed as:
\[\frac{\partial \vec{J}}{\partial x} = \frac{\partial B(T, f)}{\partial x} - \mathbf{K}^{-1} \left( \frac{\partial \mathbf{K}}{\partial x} \mathbf{K}^{-1} - \frac{\partial \vec{S}}{\partial x} \right)\]where:
Variable
Extracted from ARTS parameter
Meaning
\(\vec{J}\)
The spectral radiance source term along the path.
\(B(T, f)\)
None- this is computed locallyThe Planck function at the temperature and frequency.
\(\mathbf{K}\)
The propagation matrix along the path.
\(\vec{S}\)
The non-LTE source vector along the path.
\(\frac{\partial \vec{J}}{\partial x}\)
The Jacobian of the spectral radiance source term with respect to the
jac_targets.\(\frac{\partial B(T, f)}{\partial x}\)
None- this is computed locallyThe Jacobian of the Planck function with respect to the
jac_targets. Only tempertature is supported.\(\frac{\partial \mathbf{K}}{\partial x}\)
The Jacobian of the propagation matrix with respect to the
jac_targets.\(\frac{\partial \vec{S}}{\partial x}\)
The Jacobian of the non-LTE source vector with respect to the
jac_targets.\(x\)
The targets for the Jacobian computation.
\(T\)
The temperature at the atmospheric point along the path.
\(f\)
The frequency grid at the atmospheric point along the path.
The output dimensions are:
spectral_rad_srcvec_jac_path:ray_pathxfreq_gridxjac_targets(target count)
Author: Richard Larsson
Used by wrapper methods
- Parameters:
spectral_rad_srcvec_path (ArrayOfStokvecVector, optional) – Source vectors along the propagation path. See
spectral_rad_srcvec_path, defaults toself.spectral_rad_srcvec_path[OUT]spectral_rad_srcvec_jac_path (ArrayOfStokvecMatrix, optional) – Source derivative vectors along the propagation path. See
spectral_rad_srcvec_jac_path, defaults toself.spectral_rad_srcvec_jac_path[OUT]spectral_propmat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path. See
spectral_propmat_path, defaults toself.spectral_propmat_path[IN]spectral_nlte_srcvec_path (ArrayOfStokvecVector, optional) – Additional non-LTE along the propagation path. See
spectral_nlte_srcvec_path, defaults toself.spectral_nlte_srcvec_path[IN]spectral_propmat_jac_path (ArrayOfPropmatMatrix, optional) – Propagation derivative matrices along the propagation path. See
spectral_propmat_jac_path, defaults toself.spectral_propmat_jac_path[IN]spectral_nlte_srcvec_jac_path (ArrayOfStokvecMatrix, optional) – Additional non-LTE derivative along the propagation path. See
spectral_nlte_srcvec_jac_path, defaults toself.spectral_nlte_srcvec_jac_path[IN]freq_grid_path (ArrayOfAscendingGrid, optional) – All
freq_gridalong the propagation path. Seefreq_grid_path, defaults toself.freq_grid_path[IN]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- spectral_rad_surface_agendaExecute(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, spectral_rad_surface_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
spectral_rad_surface_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]spectral_rad_surface_agenda (Agenda, optional) – Computes spectral radiance as seen of the surface. See
spectral_rad_surface_agenda, defaults toself.spectral_rad_surface_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- spectral_rad_surface_agendaExecuteOperator(self, spectral_rad: pyarts3.arts.StokvecVector | None = None, spectral_rad_jac: pyarts3.arts.StokvecMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, spectral_rad_surface_agenda_operator: pyarts3.arts.spectral_rad_surface_agendaOperator | None = None) None
Executes an operator emulating
spectral_rad_surface_agenda, see it, and alsospectral_rad_surface_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
spectral_rad (StokvecVector, optional) – A spectral radiance vector. See
spectral_rad, defaults toself.spectral_rad[OUT]spectral_rad_jac (StokvecMatrix, optional) – Jacobian of
spectral_radwith respect tojac_targets. Seespectral_rad_jac, defaults toself.spectral_rad_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]spectral_rad_surface_agenda_operator (spectral_rad_surface_agendaOperator) – Operator for
spectral_rad_surface_agenda. [IN]
- spectral_rad_surface_agendaSet(self, spectral_rad_surface_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
spectral_rad_surface_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
spectral_rad_surface_agenda (Agenda, optional) – Computes spectral radiance as seen of the surface. See
spectral_rad_surface_agenda, defaults toself.spectral_rad_surface_agenda[OUT]option (String, optional) – Choice of generated agenda. Defaults to
"Blackbody"[IN]
Valid options
These are the valid options for the
spectral_rad_surface_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
spectral_rad_surface_agendaSet(option="Blackbody")Ignore(), using: input =subsurf_field
spectral_rad_surface_agendaSet(option="Transmission")Ignore(), using: input =surf_fieldIgnore(), using: input =subsurf_field
spectral_rad_surface_agendaSet(option="SurfaceReflectance")Shares the global
atm_fieldShares the global
spectral_rad_closed_surface_agendaShares the global
spectral_rad_observer_agendaShares the global
spectral_surf_refl_agenda
- spectral_rad_surface_agendaSetOperator(self, spectral_rad_surface_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.spectral_rad_surface_agendaOperator | None = None) None
Set
spectral_rad_surface_agendato exclusively use provided external operator. Seespectral_rad_surface_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
spectral_rad_surface_agenda (Agenda, optional) – Computes spectral radiance as seen of the surface. See
spectral_rad_surface_agenda, defaults toself.spectral_rad_surface_agenda[OUT]f (spectral_rad_surface_agendaOperator) – Operator for
spectral_rad_surface_agenda. [IN]
- spectral_rad_transform_operatorSet(self, spectral_rad_transform_operator: pyarts3.arts.SpectralRadianceTransformOperator | None = None, option: pyarts3.arts.SpectralRadianceUnitType | None = None) None
Creates a
SpectralRadianceTransformOperatorfrom aSpectralRadianceUnitType.Author: Richard Larsson
- Parameters:
spectral_rad_transform_operator (SpectralRadianceTransformOperator, optional) – The spectral radiance transform operator. See
spectral_rad_transform_operator, defaults toself.spectral_rad_transform_operator[OUT]option (SpectralRadianceUnitType) – The type of the spectral radiance transform operator to create. See
SpectralRadianceUnitTypefor valid values and what they do. [IN]
- spectral_surf_reflFlatRealFresnel(self, spectral_surf_refl: pyarts3.arts.MuelmatVector | None = None, spectral_surf_refl_jac: pyarts3.arts.MuelmatMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Set the surface reflectance to the flat real Fresnel reflectance
\[\begin{split}\begin{array}{lcr} \theta_2 &=& \arcsin\left(\frac{\Re{n_1}}{\Re{n_2}}\sin{\theta_1}\right)\\[5pt] R_v &=& \frac{n_2\cos\left(\theta_1\right) - n_1\cos\left(\theta_2\right)} {n_2\cos\left(\theta_1\right) + n_1\cos\left(\theta_2\right)}\\[5pt] R_h &=& \frac{n_1\cos\left(\theta_1\right) - n_2\cos\left(\theta_2\right)} {n_1\cos\left(\theta_1\right) + n_2\cos\left(\theta_2\right)}, \end{array}\end{split}\]where \(\theta_1\) is the angle of incidence, \(\theta_2\) is the angle of refraction, and \(n_1\) and \(n_2\) are the refractive indices of the two media.
We get \(n_1\) and \(\theta_1\) from the
ray_pointand extracts \(n_2\) from thesurf_fieldparameter"scalar refractive index".The reflectance matrix is
\[\begin{split}\mathbf{R} = \frac{1}{2}\left[ \begin{array}{cccc} R_v\overline{R_v} + R_h\overline{R_h} & R_v\overline{R_v} - R_h\overline{R_h} & 0 & 0 \\ R_v\overline{R_v} - R_h\overline{R_h} & R_v\overline{R_v} + R_h\overline{R_h} & 0 & 0 \\ 0 & 0 & \Re\left(R_h\overline{R_v} + R_v\overline{R_h}\right) & \Im\left(R_h\overline{R_v} - R_v\overline{R_h}\right) \\ 0 & 0 & \Im\left(R_v\overline{R_h} - R_h\overline{R_v}\right) & \Re\left(R_h\overline{R_v} + R_v\overline{R_h}\right) \\ \end{array}\right]\end{split}\]Author: Richard Larsson
- Parameters:
spectral_surf_refl (MuelmatVector, optional) – Spectral surface reflectance. See
spectral_surf_refl, defaults toself.spectral_surf_refl[OUT]spectral_surf_refl_jac (MuelmatMatrix, optional) – Spectral surface reflectance jacobian. See
spectral_surf_refl_jac, defaults toself.spectral_surf_refl_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- spectral_surf_reflFlatScalar(self, spectral_surf_refl: pyarts3.arts.MuelmatVector | None = None, spectral_surf_refl_jac: pyarts3.arts.MuelmatMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Set the surface reflectance to the flat real Fresnel reflectance
We get \(r\) from the
surf_fieldparameter"flat scalar reflectance".The reflectance matrix is
\[\begin{split}\mathbf{R} = \left[ \begin{array}{cccc} r&0&0&0\\ 0&r&0&0\\ 0&0&r&0\\ 0&0&0&r\\ \end{array}\right]\end{split}\]Author: Richard Larsson
- Parameters:
spectral_surf_refl (MuelmatVector, optional) – Spectral surface reflectance. See
spectral_surf_refl, defaults toself.spectral_surf_refl[OUT]spectral_surf_refl_jac (MuelmatMatrix, optional) – Spectral surface reflectance jacobian. See
spectral_surf_refl_jac, defaults toself.spectral_surf_refl_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- spectral_surf_refl_agendaExecute(self, spectral_surf_refl: pyarts3.arts.MuelmatVector | None = None, spectral_surf_refl_jac: pyarts3.arts.MuelmatMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, spectral_surf_refl_agenda: pyarts3.arts.Agenda | None = None) pyarts3.arts.CxxWorkspace
Executes
spectral_surf_refl_agenda, see it for more detailsAuthor:
Automatically Generated- Parameters:
spectral_surf_refl (MuelmatVector, optional) – Spectral surface reflectance. See
spectral_surf_refl, defaults toself.spectral_surf_refl[OUT]spectral_surf_refl_jac (MuelmatMatrix, optional) – Spectral surface reflectance jacobian. See
spectral_surf_refl_jac, defaults toself.spectral_surf_refl_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]spectral_surf_refl_agenda (Agenda, optional) – An agenda to compute the surface reflectance. See
spectral_surf_refl_agenda, defaults toself.spectral_surf_refl_agenda[IN]
- Returns:
opt – The internal workspace, cleaned from all input/output.
- Return type:
- spectral_surf_refl_agendaExecuteOperator(self, spectral_surf_refl: pyarts3.arts.MuelmatVector | None = None, spectral_surf_refl_jac: pyarts3.arts.MuelmatMatrix | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, ray_point: pyarts3.arts.PropagationPathPoint | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, spectral_surf_refl_agenda_operator: pyarts3.arts.spectral_surf_refl_agendaOperator | None = None) None
Executes an operator emulating
spectral_surf_refl_agenda, see it, and alsospectral_surf_refl_agendaOperator, for more detailsAuthor:
Automatically Generated- Parameters:
spectral_surf_refl (MuelmatVector, optional) – Spectral surface reflectance. See
spectral_surf_refl, defaults toself.spectral_surf_refl[OUT]spectral_surf_refl_jac (MuelmatMatrix, optional) – Spectral surface reflectance jacobian. See
spectral_surf_refl_jac, defaults toself.spectral_surf_refl_jac[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]ray_point (PropagationPathPoint, optional) – A single path point. See
ray_point, defaults toself.ray_point[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]spectral_surf_refl_agenda_operator (spectral_surf_refl_agendaOperator) – Operator for
spectral_surf_refl_agenda. [IN]
- spectral_surf_refl_agendaSet(self, spectral_surf_refl_agenda: pyarts3.arts.Agenda | None = None, option: pyarts3.arts.String | None = None) None
Set
spectral_surf_refl_agendato a specific predefined optionAuthor:
Automatically Generated- Parameters:
spectral_surf_refl_agenda (Agenda, optional) – An agenda to compute the surface reflectance. See
spectral_surf_refl_agenda, defaults toself.spectral_surf_refl_agenda[OUT]option (String) – Choice of generated agenda. [IN]
Valid options
These are the valid options for the
spectral_surf_refl_agendaSetmethod. The listed method calls describe the order of the agenda calls for eachoption.
spectral_surf_refl_agendaSet(option="FlatScalar")
spectral_surf_refl_agendaSet(option="FlatRealFresnel")
- spectral_surf_refl_agendaSetOperator(self, spectral_surf_refl_agenda: pyarts3.arts.Agenda | None = None, f: pyarts3.arts.spectral_surf_refl_agendaOperator | None = None) None
Set
spectral_surf_refl_agendato exclusively use provided external operator. Seespectral_surf_refl_agendaOperatorfor more details.Author:
Automatically Generated- Parameters:
spectral_surf_refl_agenda (Agenda, optional) – An agenda to compute the surface reflectance. See
spectral_surf_refl_agenda, defaults toself.spectral_surf_refl_agenda[OUT]f (spectral_surf_refl_agendaOperator) – Operator for
spectral_surf_refl_agenda. [IN]
- spectral_tramat_bkgFromPathPropagationBack(self, spectral_tramat_bkg: pyarts3.arts.MuelmatVector | None = None, spectral_tramat_cumulative_path: pyarts3.arts.ArrayOfMuelmatVector | None = None) None
Sets
spectral_tramat_bkgto back ofspectral_tramat_cumulative_path.This is purely compositional and it is better to use pure python code if need this functionality in your own control-flow.
Author: Richard Larsson
Used by wrapper methods
- Parameters:
spectral_tramat_bkg (MuelmatVector, optional) – Transmittance from the background. See
spectral_tramat_bkg, defaults toself.spectral_tramat_bkg[OUT]spectral_tramat_cumulative_path (ArrayOfMuelmatVector, optional) – Cumulative transmission matrices along the propagation path. See
spectral_tramat_cumulative_path, defaults toself.spectral_tramat_cumulative_path[IN]
- spectral_tramat_bkgFromPathPropagationFront(self, spectral_tramat_bkg: pyarts3.arts.MuelmatVector | None = None, spectral_tramat_cumulative_path: pyarts3.arts.ArrayOfMuelmatVector | None = None) None
Sets
spectral_tramat_bkgto front ofspectral_tramat_cumulative_path.This is purely compositional and it is better to use pure python code if need this functionality in your own control-flow.
Author: Richard Larsson
- Parameters:
spectral_tramat_bkg (MuelmatVector, optional) – Transmittance from the background. See
spectral_tramat_bkg, defaults toself.spectral_tramat_bkg[OUT]spectral_tramat_cumulative_path (ArrayOfMuelmatVector, optional) – Cumulative transmission matrices along the propagation path. See
spectral_tramat_cumulative_path, defaults toself.spectral_tramat_cumulative_path[IN]
- spectral_tramat_cumulative_pathFromPath(self, spectral_tramat_cumulative_path: pyarts3.arts.ArrayOfMuelmatVector | None = None, spectral_tramat_path: pyarts3.arts.ArrayOfMuelmatVector | None = None) None
Sets
spectral_tramat_cumulative_pathby forward iteration ofspectral_tramat_pathAuthor: Richard Larsson
Used by wrapper methods
- Parameters:
spectral_tramat_cumulative_path (ArrayOfMuelmatVector, optional) – Cumulative transmission matrices along the propagation path. See
spectral_tramat_cumulative_path, defaults toself.spectral_tramat_cumulative_path[OUT]spectral_tramat_path (ArrayOfMuelmatVector, optional) – Transmission matrices along the propagation path. See
spectral_tramat_path, defaults toself.spectral_tramat_path[IN]
- spectral_tramat_pathFromPath(self, spectral_tramat_path: pyarts3.arts.ArrayOfMuelmatVector | None = None, spectral_tramat_jac_path: pyarts3.arts.ArrayOfMuelmatTensor3 | None = None, spectral_propmat_path: pyarts3.arts.ArrayOfPropmatVector | None = None, spectral_propmat_jac_path: pyarts3.arts.ArrayOfPropmatMatrix | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, atm_path: pyarts3.arts.ArrayOfAtmPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, hse_derivative: pyarts3.arts.Index | None = None) None
Gets the transmission matrix in layers along the path.
The assumption is that each path variable forms a layer from the ray path. So there is a reduction in size by one. A demand therefore is that there are at least 2 points in the path.
The derivatives first dimensions are also 2, the first for the derivative wrt the level before and one for the level after.
Author: Richard Larsson
Used by wrapper methods
- Parameters:
spectral_tramat_path (ArrayOfMuelmatVector, optional) – Transmission matrices along the propagation path. See
spectral_tramat_path, defaults toself.spectral_tramat_path[OUT]spectral_tramat_jac_path (ArrayOfMuelmatTensor3, optional) – Transmission derivative matrices along the propagation path. See
spectral_tramat_jac_path, defaults toself.spectral_tramat_jac_path[OUT]spectral_propmat_path (ArrayOfPropmatVector, optional) – Propagation matrices along the propagation path. See
spectral_propmat_path, defaults toself.spectral_propmat_path[IN]spectral_propmat_jac_path (ArrayOfPropmatMatrix, optional) – Propagation derivative matrices along the propagation path. See
spectral_propmat_jac_path, defaults toself.spectral_propmat_jac_path[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]atm_path (ArrayOfAtmPoint, optional) – Atmospheric points along the propagation path. See
atm_path, defaults toself.atm_path[IN]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]hse_derivative (Index, optional) – Flag to compute the hypsometric distance derivatives. Defaults to
0[IN]
- subsurf_fieldFromModelState(self, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, model_state_vec: pyarts3.arts.Vector | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets
subsurf_fieldto the state of the model.Author: Richard Larsson
Used by wrapper method
- Parameters:
subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[INOUT]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- subsurf_profileFromPath(self, subsurf_profile: pyarts3.arts.ArrayOfSubsurfacePoint | None = None, subsurf_field: pyarts3.arts.SubsurfaceField | None = None, ray_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None) None
Extract a subsurface profile from a ray path.
Author: Richard Larsson
- Parameters:
subsurf_profile (ArrayOfSubsurfacePoint, optional) – A profile of subsurface points. Supposed to be ordered from top to bottom. See
subsurf_profile, defaults toself.subsurf_profile[OUT]subsurf_field (SubsurfaceField, optional) – The sub-surface field. See
subsurf_field, defaults toself.subsurf_field[IN]ray_path (ArrayOfPropagationPathPoint, optional) – A list path points making up a propagation path. See
ray_path, defaults toself.ray_path[IN]
- sunBlackbody(self, sun: pyarts3.arts.Sun | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, radius: pyarts3.arts.Numeric | None = None, distance: pyarts3.arts.Numeric | None = None, temperature: pyarts3.arts.Numeric | None = None) None
Set
sunto blackbody.Note
For a Sol-like sun there are huge differences in the UV-range between the actual sun spectrum and the blackbody spectrum with the effective temperature of the sun. The blackbody sun strongly overestimates the UV radiation.
Authors: Jon Petersen, Richard Larsson
- Parameters:
sun (Sun, optional) – A sun. See
sun, defaults toself.sun[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]radius (Numeric, optional) – The radius of the sun in meter. Default is the radius of our sun. . Defaults to
696324200[IN]distance (Numeric, optional) – The average distance between the sun and the planet in meter. Default value is set to 1 a.u. . Defaults to
149597870700[IN]temperature (Numeric, optional) – The effective temperature of the suns photosphere in Kelvin. Default is the temperature of our sun - 5772 Kelvin . Defaults to
5772[IN]
- sunFromGrid(self, sun: pyarts3.arts.Sun | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, sun_spectrum_raw: pyarts3.arts.GriddedField2 | None = None, radius: pyarts3.arts.Numeric | None = None, distance: pyarts3.arts.Numeric | None = None, temperature: pyarts3.arts.Numeric | None = None, description: pyarts3.arts.String | None = None) None
Extracts a sun spectrum from a field of such data.
The method allows to obtain the sun spectrum by interpolation from a field of such data. The sun spectrum is expected to be stored as the irradiance at the suns photosphere.
Unit:
GriddedField2: [W m-2 Hz-1]
Vector
freq_grid[Hz]Vector
stokes_dim[1]
Dimensions: [
freq_grid, stokes_dim]This method performs an interpolation onto the
freq_grid. The point offreq_gridthat are outside the data frequency grid are initialized according to planck’s law of the temperature variable. Hence, a temperature of 0 means 0s the edges of thefreq_grid.Authors: Jon Petersen, Richard Larsson
- Parameters:
sun (Sun, optional) – A sun. See
sun, defaults toself.sun[OUT]freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See
freq_grid, defaults toself.freq_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]sun_spectrum_raw (GriddedField2) – A raw spectrum. [IN]
radius (Numeric, optional) – The radius of the sun in meter. Default is the radius of our sun. . Defaults to
696324200[IN]distance (Numeric, optional) – The average distance between the sun and the planet in meter. Default value is set to 1 a.u. . Defaults to
149597870700[IN]temperature (Numeric, optional) – The effective temperature of the suns photosphere in Kelvin. Default is the temperature of our sun - 5772 Kelvin . Defaults to
5772[IN]description (String, optional) – A description of the sun. Defaults to
"A sun"[IN]
- sun_pathFromObserverAgenda(self, sun_path: pyarts3.arts.ArrayOfPropagationPathPoint | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, ray_path_observer_agenda: pyarts3.arts.Agenda | None = None, sun: pyarts3.arts.Sun | None = None, pos: pyarts3.arts.Vector3 | None = None, angle_cut: pyarts3.arts.Numeric | None = None, refinement: pyarts3.arts.Index | None = None, just_hit: pyarts3.arts.Index | None = None) None
Find a path that hits the sun if possible
The algorithm finds the pair of angles with the least error in regards to angular zenith and azimuth offset from the sun. It uses this pair of angles to compute said path. The algorithm is iterative. It first finds the geometric pair of angles pointing at the sun. It then computes the path, using the space-facing path point’s pointing offset relative to the sun to change the angles in the four directions (up, left, right, down) until it finds a better solution. If no better solution is found, the algorithm it refines the angular search to half for every level of refinement above 1, it then stops.
Note that special care is taken to eliminate surface intersections so that part of the sun may still be hit if it is above the horizon. If the sun is entirerly below the horizon, the path will point close to the horizon.
The two control parameters are the
angle_cutandjust_hit. Theangle_cutis the limit in degrees to which the algorithm should search for a better solution. Thejust_hitis a flag that just returns the first time a path hits the sun.Author: Richard Larsson
- Parameters:
sun_path (ArrayOfPropagationPathPoint, optional) – A path to a sun if it is visible. See
sun_path, defaults toself.sun_path[OUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]ray_path_observer_agenda (Agenda, optional) – Gets the propagation path as it is obeserved. See
ray_path_observer_agenda, defaults toself.ray_path_observer_agenda[IN]sun (Sun, optional) – A sun. See
sun, defaults toself.sun[IN]pos (Vector3) – An observer position [alt, lat, lon]. [IN]
angle_cut (Numeric, optional) – The angle delta-cutoff in the iterative solver [0.0, …]. Defaults to
0[IN]refinement (Index, optional) – The refinement of the search algorithm (twice the power of this is the resultion). Defaults to
1[IN]just_hit (Index, optional) – Whether or not it is enough to just hit the sun or if better accuracy is needed. Defaults to
0[IN]
- surf_fieldEarth(self, surf_field: pyarts3.arts.SurfaceField | None = None, model: pyarts3.arts.String | None = None, surf_elevation: pyarts3.arts.Numeric | None = None) None
Earth reference ellipsoids.
The reference ellipsoid is set to model the Earth.
See
EarthEllipsoidfor validmodelAuthor: Patrick Eriksson
- Parameters:
surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[OUT]model (String, optional) – Model ellipsoid to use. Options listed above. Defaults to
"Sphere"[IN]surf_elevation (Numeric, optional) – Surface elevation over the full field. Defaults to
0[IN]
- surf_fieldEuropa(self, surf_field: pyarts3.arts.SurfaceField | None = None, model: pyarts3.arts.String | None = None, surf_elevation: pyarts3.arts.Numeric | None = None) None
Europa reference ellipsoids.
The reference ellipsoid is set to model the Europa.
See
EuropaEllipsoidfor validmodel.Author: Richard Larsson
- Parameters:
surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[OUT]model (String, optional) – Model ellipsoid to use. Options listed above. Defaults to
"Sphere"[IN]surf_elevation (Numeric, optional) – Surface elevation over the full field. Defaults to
0[IN]
- surf_fieldFromModelState(self, surf_field: pyarts3.arts.SurfaceField | None = None, model_state_vec: pyarts3.arts.Vector | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None) None
Sets
surf_fieldto the state of the model.Author: Richard Larsson
Used by wrapper method
- Parameters:
surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[INOUT]model_state_vec (Vector, optional) – A state vector of the model. See
model_state_vec, defaults toself.model_state_vec[IN]jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See
jac_targets, defaults toself.jac_targets[IN]
- surf_fieldGanymede(self, surf_field: pyarts3.arts.SurfaceField | None = None, model: pyarts3.arts.String | None = None, surf_elevation: pyarts3.arts.Numeric | None = None) None
Ganymede reference ellipsoids.
See
GanymedeEllipsoidfor validmodel.Author: Takayoshi Yamada
- Parameters:
surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[OUT]model (String, optional) – Model ellipsoid to use. Options listed above. Defaults to
"Sphere"[IN]surf_elevation (Numeric, optional) – Surface elevation over the full field. Defaults to
0[IN]
- surf_fieldInit(self, surf_field: pyarts3.arts.SurfaceField | None = None, a: pyarts3.arts.Numeric | None = None, b: pyarts3.arts.Numeric | None = None, surf_elevation: pyarts3.arts.Numeric | None = None) None
Manual setting of the reference ellipsoid.
The two values of the reference ellipsoid are set manually. The two arguments correspond directly to first and second element of reference ellipsoid.
Author: Patrick Eriksson
- Parameters:
surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[OUT]a (Numeric) – Average or equatorial radius. [IN]
b (Numeric) – Average or polar radius. [IN]
surf_elevation (Numeric, optional) – Surface elevation over the full field. Defaults to
0[IN]
- surf_fieldIo(self, surf_field: pyarts3.arts.SurfaceField | None = None, model: pyarts3.arts.String | None = None, surf_elevation: pyarts3.arts.Numeric | None = None) None
Io reference ellipsoids.
The reference ellipsoid is set to model the Io.
See
IoEllipsoidfor validmodel.Author: Richard Larsson
- Parameters:
surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[OUT]model (String, optional) – Model ellipsoid to use. Options listed above. Defaults to
"Sphere"[IN]surf_elevation (Numeric, optional) – Surface elevation over the full field. Defaults to
0[IN]
- surf_fieldJupiter(self, surf_field: pyarts3.arts.SurfaceField | None = None, model: pyarts3.arts.String | None = None, surf_elevation: pyarts3.arts.Numeric | None = None) None
Jupiter reference ellipsoids.
The reference ellipsoid is set to model the Jupiter.
See
JupiterEllipsoidfor validmodel.Author: Patrick Eriksson
- Parameters:
surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[OUT]model (String, optional) – Model ellipsoid to use. Options listed above. Defaults to
"Sphere"[IN]surf_elevation (Numeric, optional) – Surface elevation over the full field. Defaults to
0[IN]
- surf_fieldMars(self, surf_field: pyarts3.arts.SurfaceField | None = None, model: pyarts3.arts.String | None = None, surf_elevation: pyarts3.arts.Numeric | None = None) None
Mars reference ellipsoids.
The reference ellipsoid is set to model the Mars.
See
MarsEllipsoidfor validmodel.Author: Patrick Eriksson
- Parameters:
surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[OUT]model (String, optional) – Model ellipsoid to use. Options listed above. Defaults to
"Sphere"[IN]surf_elevation (Numeric, optional) – Surface elevation over the full field. Defaults to
0[IN]
- surf_fieldMoon(self, surf_field: pyarts3.arts.SurfaceField | None = None, model: pyarts3.arts.String | None = None, surf_elevation: pyarts3.arts.Numeric | None = None) None
Moon reference ellipsoids.
The reference ellipsoid is set to model the Moon.
See
MoonEllipsoidfor validmodel.Author: Patrick Eriksson
- Parameters:
surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[OUT]model (String, optional) – Model ellipsoid to use. Options listed above. Defaults to
"Sphere"[IN]surf_elevation (Numeric, optional) – Surface elevation over the full field. Defaults to
0[IN]
- surf_fieldPlanet(self, surf_field: pyarts3.arts.SurfaceField | None = None, option: pyarts3.arts.String | None = None, surf_elevation: pyarts3.arts.Numeric | None = None) None
Initialize the surface field with the ellipsoid of a planet.
See
PlanetOrMoonTypefor validoption.Author: Richard Larsson
- Parameters:
surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[OUT]option (String) – Choice of planet or moon. [IN]
surf_elevation (Numeric, optional) – Surface elevation over the full field. Defaults to
0[IN]
- surf_fieldVenus(self, surf_field: pyarts3.arts.SurfaceField | None = None, model: pyarts3.arts.String | None = None, surf_elevation: pyarts3.arts.Numeric | None = None) None
Venus reference ellipsoids.
The reference ellipsoid is set to model the Venus.
See
VenusEllipsoidfor validmodel.Author: Patrick Eriksson
- Parameters:
surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[OUT]model (String, optional) – Model ellipsoid to use. Options listed above. Defaults to
"Sphere"[IN]surf_elevation (Numeric, optional) – Surface elevation over the full field. Defaults to
0[IN]
- swap(self, other: pyarts3.arts.CxxWorkspace) None
Swap the workspace for andother.
- water_equivalent_pressure_operatorMK05(self, water_equivalent_pressure_operator: pyarts3.arts.NumericUnaryOperator | None = None, only_liquid: pyarts3.arts.Index | None = None) None
Calculate equivalent water pressure according to Murphy and Koop, 2005
Default is setting the saturation pressure to the one with respect to water at temperatures >= 0C, and to the one with respect to ice for <0C. The GIN
only_liquidallows you to apply the liquid value at all temperatures.The saturation pressure with respect to liquid and ice water is calculated according to Eq. 10 and 7, respectively, of: Murphy, D. M., & Koop, T. (2005). Review of the vapour pressures of ice and supercooled water for atmospheric applications. Quarterly Journal of the Royal Meteorological Society, 131(608), 1539-1565.
Authors: Patrick Eriksson, Richard Larsson
- Parameters:
water_equivalent_pressure_operator (NumericUnaryOperator, optional) – The water equivalent pressure operator. See
water_equivalent_pressure_operator, defaults toself.water_equivalent_pressure_operator[OUT]only_liquid (Index, optional) – Set to 1 to use liquid saturation pressure at all temperatures. Defaults to
0[IN]
- zen_gridProfilePseudo2D(self, zen_grid: pyarts3.arts.ZenGrid | None = None, surf_field: pyarts3.arts.SurfaceField | None = None, alt_grid: pyarts3.arts.AscendingGrid | None = None, lat: pyarts3.arts.Numeric | None = None, lon: pyarts3.arts.Numeric | None = None, dzen: pyarts3.arts.Numeric | None = None, azi: pyarts3.arts.Numeric | None = None, consider_limb: pyarts3.arts.Index | None = None) None
A custom zenith grid for
spectral_rad_fieldProfilePseudo2D()Author: Richard Larsson
Used by wrapper method
- Parameters:
zen_grid (ZenGrid, optional) – A single zenith angle grid. See
zen_grid, defaults toself.zen_grid[OUT]surf_field (SurfaceField, optional) – The surface field. See
surf_field, defaults toself.surf_field[IN]alt_grid (AscendingGrid, optional) – An ascending list of
alt. Often related to a field or a profile. Seealt_grid, defaults toself.alt_grid[IN]lat (Numeric, optional) – A single latitude. See
lat, defaults toself.lat[IN]lon (Numeric, optional) – A single longitude. See
lon, defaults toself.lon[IN]dzen (Numeric, optional) – The zenith grid max step size. Defaults to
1[IN]azi (Numeric, optional) – The azimuth. Defaults to
0[IN]consider_limb (Index, optional) – Whether or not special care is given to the limb. Defaults to
1[IN]
Static Methods
- fromxml(file: str) pyarts3.arts.CxxWorkspace
Create variable from file.
- Parameters:
file (str) – A file that can be read
- Raises:
RuntimeError – For any failure to read.
- Returns:
artstype – The variable created from the file.
- Return type:
T
Attributes
- abs_bands: AbsorptionBands
Bands of absorption lines for line-by-line (LBL) calculations.
See methods that consume this variable for more details on its content.
Also see Line-by-line Absorption for more information on LBL calculations.
Input to workspace methods
Modified by workspace methods
Output from workspace methods
Modified by workspace agenda
Related workspace variables
- abs_cia_data: ArrayOfCIARecord
HITRAN Collision-Induced Absorption (CIA) Data.
This variable holds HITRAN CIA data (binary absorption cross-sections). The data itself is described in Richard et al. [26].
The binary absorption cross-sections have to be multiplied with the densities of both molecules to get a scalar absorption coefficient.
Dimensions:
The length of this array should be equal to the number of pairs of molecules that have CIA data available. Some methods that split the data might not work as intended otherwise.
See also Collision-induced Absorption for more information on CIA calculations.
Input to workspace methods
Output from workspace methods
Related workspace variables
- abs_ecs_data: LinemixingEcsData
Error corrected sudden data
Dimensions: [num Isotopologues] [num Species]
Used in line-by-line calculations requiring ECS data.
Default value
pyarts3.arts.LinemixingEcsData()Input to workspace methods
Modified by workspace methods
Output from workspace method
Related workspace variables
- abs_lookup_data: AbsorptionLookupTables
Absorption lookup table for scalar gas absorption coefficients.
Precomputing this table replaces the need for the calculation of scalar gas line-by-line absorption.
See Lookup-table Absorption for more information on lookup table calculations.
Input to workspace methods
Modified by workspace methods
Output from workspace methods
Related workspace variables
- abs_predef_data: PredefinedModelData
This contains predefined model data.
Can currently only contain data for new MT CKD models of water.
See Predefined Absorption Models for more information on predefined model calculations.
Input to workspace methods
Modified by workspace method
Output from workspace methods
Related workspace variables
- abs_species: ArrayOfSpeciesTag
Tag groups for gas absorption.
This allows the user to set up groups of species tags that are used to load the correct data.
It is only used to let data-reading methods know which species they should read from the available input files.
Input to workspace methods
Output from workspace methods
Related workspace variables
- abs_xfit_data: ArrayOfXsecRecord
Fitting model coefficients for cross section species.
Dimensions: [ n_species ]
XsecRecord:
species: Name of species
version: Fit model version
fitcoeffs:
Fit model coefficients as an
ArrayOfGriddedField2Dimensions: [ n_bands ]
GriddedField2: [ n_band_frequencies, n_coeffs ]
The fit model:
z = p00 + p10*x + p01*y + p20*x^2
z = Xsec [m^2]
x = T / T0
y = P / P0
T0 = 1 [K]
P0 = 1 [Pa]
fitcoeffs(:, 0) p00 [m^2]
fitcoeffs(:, 1) p10 [m^2]
fitcoeffs(:, 2) p01 [m^2]
fitcoeffs(:, 3) p20 [m^2]
fitminpressures:
Minimum pressure available in source xsec data to generate the fit coefficients.
Dimensions: [ n_bands ]
fitmaxpressures:
Maximum pressure available in source xsec data to generate the fit coefficients.
Dimensions: [ n_bands ]
fitmintemperatures:
Minimum temperature available in source xsec data to generate the fit coefficients.
Dimensions: [ n_bands ]
fitmintemperatures:
Maximum temperature available in source xsec data to generate the fit coefficients.
Dimensions: [ n_bands ]
fitminpressures, fitmaxpressures, fitmintemperatures and fitmaxtemperatures are not used to apply the model and solely serve for informational purposes.
See also Polynomial Cross-section Absorption for more information on these calculations.
Input to workspace methods
Output from workspace methods
Related workspace variables
- alt: Numeric
A single altitude in the atmosphere.
Unit: m
Default value
0Related workspace variable
- alt_grid: AscendingGrid
An ascending list of
alt. Often related to a field or a profile.Unit: m
Note
There is no global grid system in ARTS, so beware of the local nature of all grids.
Input to workspace methods
Output from workspace method
Related workspace variables
- atm_field: AtmField
An atmospheric field in ARTS.
The atmospheric field defines the altitude of the top-of-the-atmosphere, as well as the variables that are required for the radiative transfer calculations along a path through the atmosphere. The field can be accessed at any altitude, latitude, longitude path that is within the atmosphere to access the relevant atmospheric point data (
atm_point).Note that constraints on the various field parameters may be imposed by extrapolation limitations on the field parameter itself, causing some or large swaths of the atmosphere to be inaccessible.
The atmospheric field may, but does not have to, consist of the following:
Temperature - Atmospheric temperatures in Kelvin
Pressure - Atmospheric pressure in Pascal
Wind - Atmospheric wind field in meters per second
Magnetic Field - Magnetic field in Tesla
Species content - Usually the volume-mixing ratio of various species, with some exceptions. See
SpeciesEnumfor more details.Isotopologue ratios - The isotopologue ratios of various species. See
SpeciesIsotopefor more details.Non-local thermodynamics ratios - Unitless [pure-style] OR Kelvin [vibrational-style] ratios replacing the Boltzman distribution used in the LTE calculations.
Scattering species content - See user guide for more information. This is custom data to aid scattering calculations.
For more information, see The atmosphere.
Input to workspace methods
Modified by workspace methods
Output from workspace methods
Input to workspace agendas
Modified by workspace agenda
Related workspace variables
- atm_path: ArrayOfAtmPoint
Atmospheric points along the propagation path.
See
atm_pointfor information about atmospheric pointsDimension: [ ppath.np ]
Usage: Output of radiative transfer methods.
Input to workspace methods
Modified by workspace method
Output from workspace methods
Related workspace variables
- atm_point: AtmPoint
An atmospheric point in ARTS.
The atmospheric point consists of all the relevant atmospheric field data at a discrete point in the atmosphere. It is often extracted from an
AtmFieldat a single altitude-latitude-longitude but may of course be generated manually.See
atm_fieldfor the data that may be available in the atmospheric point.For more information, see The atmosphere.
Input to workspace methods
Output from workspace method
Input to workspace agendas
Related workspace variables
- atm_profile: ArrayOfAtmPoint
An atmospheric profile in ARTS.
This exists to interface between the fully 3D atmospheric field native to ARTS and various 1D and 2D solvers that make use of profiles for fixed geometries.
The atmospheric profile consists of all the relevant atmospheric field data at a discrete profile in the atmosphere. It is often extracted from an
AtmFieldat a single latitude-longitude coordinate but may of course be generated manually.See
atm_fieldfor the data that may be available in the atmospheric point.The size of the profile is the same as
alt_grid.For more information, see The atmosphere.
Input to workspace methods
Modified by workspace method
Output from workspace methods
Related workspace variables
- covmat_diagonal_blocks: JacobianTargetsDiagonalCovarianceMatrixMap
A helper map for setting the covariance matrix.
Input to workspace method
Modified by workspace methods
Output from workspace method
Related workspace variables
- disort_fourier_mode_dimension: Index
The number of Fourier modes for Disort.
Input to workspace methods
Input to workspace agendas
Related workspace variables
- disort_legendre_polynomial_dimension: Index
The number of input Legendre polynimials for Disort.
Input to workspace methods
Input to workspace agendas
Related workspace variables
- disort_quadrature: ZenGriddedField1
The quadrature angles for Disort with accompying weights.
Size is
disort_quadrature_dimensionor zenith angle grid ofdisort_spectral_rad_field.Input to workspace method
Output from workspace methods
Related workspace variables
- disort_quadrature_dimension: Index
The quadrature size for Disort.
Input to workspace methods
Input to workspace agendas
Related workspace variables
- disort_settings: DisortSettings
Contains the full settings of spectral Disort calculations.
Input to workspace methods
Modified by workspace methods
Output from workspace methods
Output from workspace agendas
Related workspace variables
- disort_settings_agenda: Agenda
An agenda for setting up Disort.
See
disort_settings_agendaSetup()for prepared agenda settings.The only intent of this Agenda is to simplify the setup of Disort for different scenarios. The output of this Agenda is just that setting.
Execution and customization
You can execute
disort_settings_agendadirectly from the workspace by callingdisort_settings_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
disort_settings_agendaOperator. See it,disort_settings_agendaSetOperator(), anddisort_settings_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Agenda output
Agenda input
Input to workspace methods
Output from workspace methods
Input to workspace agenda
Related workspace variables
- disort_settings_downwelling_wrapper_agenda: Agenda
An wrapper agenda for calling
disort_settings_agenda.This agenda wraps the
disort_settings_agendato provide a simpler interface for the common case of calculating downwelling radiation. The idea is that a call todisort_settings_agendais made, and then a follow-up calculation of the down-welling radiation is done to set the boundary condition at the top of the tau-range covered by the ray path.One use-case is to use this agenda to give downwelling atmospheric radiation as a boundary condition to subsurface radiance calculation.
Execution and customization
See
disort_settings_downwelling_wrapper_agendaSet()for builtin options that selects execution options.You can execute
disort_settings_downwelling_wrapper_agendadirectly from the workspace by callingdisort_settings_downwelling_wrapper_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
disort_settings_downwelling_wrapper_agendaOperator. See it,disort_settings_downwelling_wrapper_agendaSetOperator(), anddisort_settings_downwelling_wrapper_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Agenda output
Agenda input
Default value
Shares the global
spectral_rad_observer_agendapol = [1, 0, 0, 0]
Input to workspace methods
Output from workspace methods
Related workspace variables
- disort_spectral_flux_field: DisortFlux
The spectral flux field from Disort.
Input to workspace method
Output from workspace methods
Related workspace variables
- disort_spectral_rad_field: DisortRadiance
The spectral radiance field from Disort.
Input to workspace methods
Modified by workspace method
Output from workspace methods
Related workspace variables
- do_jac: Index
A boolean calculations related to the
measurement_jacshould be ignored.This variable is limited to very few methods related to the inversion process for
OEM(). Note that deep code of ARTS will ignore this variable, so it is not a global switch. Instead, it is used as a switch to clear thejac_targetsvariable, which is used to determine the size of themeasurement_jac. It is important to be careful with this, as it will mess with the size of themeasurement_jacand could thus lead to runtime errors being thrown in places where unexpected sizes are encountered.Default value
1Input to workspace methods
Input to workspace agendas
Related workspace variables
- freq: Numeric
A single frequency. Unit: Hz.
Input to workspace methods
Modified by workspace method
Input to workspace agendas
Related workspace variables
- freq_grid: AscendingGrid
A frequency grid. Unit: Hz.
Note
There is no global grid system in ARTS, so beware of the local nature of all grids.
Input to workspace methods
Modified by workspace method
Output from workspace methods
Input to workspace agendas
Related workspace variables
- freq_grid_path: ArrayOfAscendingGrid
All
freq_gridalong the propagation path.Input to workspace methods
Modified by workspace method
Output from workspace method
Related workspace variables
- freq_wind_shift_jac: Vector3
The frequency wind shift Jacobian.
Used because all methods inside
spectral_propmat_agendawork on the frequency grid, not on the actual wind speed for the sake of wind shift Jacobian calculations.The order is
\[\begin{split}\left[ \begin{array}{c} \frac{\partial f}{\partial u} \\ \frac{\partial f}{\partial v} \\ \frac{\partial f}{\partial w} \end{array} \right]\end{split}\]Default value
0 0 0Input to workspace methods
Output from workspace methods
Input to workspace agendas
Related workspace variables
- freq_wind_shift_jac_path: ArrayOfVector3
A list of
freq_wind_shift_jacfor a ray path.Input to workspace methods
Modified by workspace method
Output from workspace method
Related workspace variables
- gravity_operator: NumericTernaryOperator
The gravity operator.
Usage: gravity =
gravity_operator(alt,lat,lon).Parameters
- altNumeric
Altitude in meters.
- latNumeric
Latitude in degrees.
- lonNumeric
Longitude in degrees.
Returns
- gravityNumeric
The gravity in \(\textrm{m/s}^2\).
Input to workspace method
Output from workspace method
- inversion_iterate_agenda: Agenda
Work in progress …
See
OEM().Note
The output
measurement_jacsize may depend on thedo_jacinput.Execution and customization
See
inversion_iterate_agendaSet()for builtin options that selects execution options.You can execute
inversion_iterate_agendadirectly from the workspace by callinginversion_iterate_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
inversion_iterate_agendaOperator. See it,inversion_iterate_agendaSetOperator(), andinversion_iterate_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Constraints
On output, the measurement vector and Jacobian must match expected size.
On output, the model state vector and Jacobian must match expected size.
Agenda output
Agenda input
Default value
Shares the global
measurement_inversion_agendaIgnore(), using: input =inversion_iterate_agenda_counter
Input to workspace methods
Output from workspace methods
Related workspace variable
- inversion_iterate_agenda_counter: Index
A counter for the inversion iterate agenda.
Default value
0Input to workspace methods
Input to workspace agenda
- jac_targets: JacobianTargets
A list of targets for the Jacobian Matrix calculations.
See
JacobianTargetTypefor more information. The targets are sorted by their type. A target must have information about its position in the target count, as well as the number of parameters it contributes to themodel_state_vec. It must know these things because it is able to map data between themodel_state_vecand the actual model field, e.g., theatm_field, thesurf_field, thesubsurf_field, theabs_bands, themeasurement_sensor, etc.Default value
pyarts3.arts.JacobianTargets()Input to workspace methods
Modified by workspace methods
Output from workspace methods
Input to workspace agendas
Related workspace variables
- lat: Numeric
A single latitude.
Units: degrees
Default value
0Input to workspace methods
Output from workspace method
Related workspace variables
- lat_grid: LatGrid
An ascending list of
lat. Often related to a field or a profile.Units: degrees
Note
There is no global grid system in ARTS, so beware of the local nature of all grids.
Related workspace variables
- legendre_degree: Index
The degree of a Legendre polynimial.
Input to workspace methods
Output from workspace method
Input to workspace agenda
- lon: Numeric
A single longitude.
Units: degrees
Default value
0Input to workspace methods
Output from workspace method
Related workspace variable
- lon_grid: LonGrid
An ascending list of
lon. Often related to a field or a profile.Units: degrees
Note
There is no global grid system in ARTS, so beware of the local nature of all grids.
Related workspace variables
- max_stepsize: Numeric
A control parameter for stepping through layers in ray tracing.
Default value
1000Input to workspace methods
Input to workspace agenda
- measurement_averaging_kernel: Matrix
Averaging kernel matrix.
This matrix is the partial derivative of the retrieved state vector with respect to the
measurement_vec.Usage: Used and set by inversion methods.
Input to workspace method
Output from workspace method
- measurement_gain_mat: Matrix
Contribution function (or gain) matrix.
This matrix is the partial derivative of the retrieved state vector with respect to the
measurement_vec.Usage: Used and set by inversion methods.
Input to workspace methods
Output from workspace method
Related workspace variables
- measurement_inversion_agenda: Agenda
This is a helper
Agendaintended for use withininversion_iterate_agenda.It outputs the
measurement_vec_fitandmeasurement_jacfor the current iteration of the inversion. Themeasurement_vec_fitis the fitted measurement vector, i.e., the measurement vector that is expected to be observed given the currentatm_field,abs_bands,measurement_sensor, andsurf_field. It does not take these as explicit input but via the Workspace mechanism. Within theinversion_iterate_agenda, these will be the local variables.What is special about this Agenda is that it enforces that the
measurement_jacis empty on output ifdo_jacevaluates false. Do not use this Agenda if you do not mind having a non-emptymeasurement_jacon output even ifdo_jacevaluates false. Also do not use this Agenda if you wish to squeeze out performance, it does a lot of unnecessary checks and operations that are not always needed.Execution and customization
See
measurement_inversion_agendaSet()for builtin options that selects execution options.You can execute
measurement_inversion_agendadirectly from the workspace by callingmeasurement_inversion_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
measurement_inversion_agendaOperator. See it,measurement_inversion_agendaSetOperator(), andmeasurement_inversion_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Constraint
When
do_jacevaluates as true, themeasurement_jacmust be non-empty.
Agenda output
Agenda input
Default value
Shares the global
abs_bandsShares the global
atm_fieldShares the global
measurement_sensorShares the global
model_state_vecShares the global
spectral_rad_observer_agendaShares the global
spectral_rad_transform_operatorShares the global
subsurf_fieldShares the global
surf_fieldCopies the global
jac_targets
Input to workspace method
Output from workspace methods
- measurement_jac: Matrix
The first order partial derivatives of the
measurement_vec.This variable represents the matrix
\[\mathbf{J} = \frac{\partial \vec{y}} {\partial \vec{x}},\]where \(\vec{y}\) is the
measurement_vecand \(\vec{x}\) is themodel_state_vec. The size of this variable should thus be the size ofmeasurement_vectimes the size ofmodel_state_vec. Please refer to those variables for more information.Input to workspace method
Modified by workspace methods
Output from workspace methods
Output from workspace agendas
Related workspace variables
- measurement_jac_error: Matrix
The partial derivatives of the
measurement_vec_error.This is otherwise the same as
measurement_jac. See it for more details.Input to workspace method
Output from workspace method
Related workspace variables
- measurement_sensor: ArrayOfSensorObsel
A list of sensor elements.
Size is number of elements of the sensor.
Input to workspace methods
Modified by workspace methods
Output from workspace methods
Modified by workspace agenda
- measurement_vec: Vector
The measurment vector for, e.g., a sensor.
This must often be the same size as
measurement_sensor.The notation in ARTS, for the purpose of
OEM(), is that\[\vec{y} = \mathbf{F}\left(\vec{x}\right) + \vec{y}_\epsilon\left(\vec{x}\right) + \epsilon\]where \(\mathbf{F}\) is the forward model function of the physics of the simulation space, \(\vec{x}\) is the
model_state_vec, \(\vec{y}_\epsilon\) is themeasurement_vec_error, and \(\epsilon\) are any additional errors, such as random noise.Throughout ARTS,
measurement_vechave different contextual meanings. These are:\(\vec{y}\) - i.e., measured data.
\(\vec{y} - \epsilon\) - e.g., the best fit to measured data,
measurement_vec_fit.\(\mathbf{F}\left(\vec{x}\right)\) - i.e., the physical model of the measurement.
Input to workspace methods
Modified by workspace method
Output from workspace methods
Related workspace variables
- measurement_vec_error: Vector
The model measurment vector error for, e.g., a sensor.
This must often be the same size as
measurement_sensor.See
measurement_vecfor more details. In that notation, this is \(\vec{y}_\epsilon\).Input to workspace method
Output from workspace method
Related workspace variables
- measurement_vec_error_covmat: CovarianceMatrix
Covariance matrix for observation uncertainties.
Input to workspace methods
Output from workspace method
Related workspace variables
- measurement_vec_fit: Vector
As
measurement_vec, but fitted to the model.This must often be the same size as
measurement_sensor.See
measurement_vecfor more details. In that notation, and in the notation ofOEM(), \(\vec{y}_f \approx \vec{y} - \epsilon\). Or at least this should be the case depending on how good of a fit of \(\vec{x}\) has been produced and if the measurement can be understood properly.Tip
It is often useful to present \(\vec{y} - \vec{y}_\epsilon\) and \(\vec{y}_f - \vec{y}_\epsilon\) instead of \(\vec{y}_f\) and \(\vec{y}\) directly. This removes the known measurement error from both the data and the fit, showing the physical signal from the target rather than known sensor noise.
Default value
[]Modified by workspace method
Output from workspace methods
Output from workspace agendas
Related workspace variables
- model_state_covmat: CovarianceMatrix
Covariance matrix of a priori distribution.
Input to workspace methods
Modified by workspace method
Output from workspace methods
Related workspace variables
- model_state_vec: Vector
A state vector of the model.
This represents the chosen state of the model. In the notation of
measurement_vecandOEM(), \(\vec{x}\) is themodel_state_vec.To choose the state of the model, you must setup
jac_targetsto include the state parameters you want to be able to change.Default value
[]Input to workspace methods
Modified by workspace methods
Output from workspace methods
Input to workspace agenda
Related workspace variables
- model_state_vec_apriori: Vector
An apriori state vector of the model.
See
model_state_vecfor more details. This is the state vector that is assumed to be the a priori state of the model. In normal circumstances, this is the state vector that is used to start the inversion process. InOEM(), this is \(\vec{x}_a\).Input to workspace method
Output from workspace methods
Related workspace variables
- nlte_line_flux_profile: QuantumIdentifierVectorMap
A per-line flux profile.
Output from workspace method
Related workspace variables
- obs_los: Vector2
The line-of-sight of the observer of spectral radiance.
Most likely only makes sense in combination with
obs_pos.Input to workspace methods
Input to workspace agendas
Related workspace variables
- obs_pos: Vector3
The position of an observer of spectral radiance.
Most likely only makes sense in combination with
obs_los.Input to workspace methods
Input to workspace agendas
Related workspace variables
- ray_path: ArrayOfPropagationPathPoint
A list path points making up a propagation path.
Input to workspace methods
Modified by workspace methods
Output from workspace methods
Input to workspace agendas
Output from workspace agendas
Related workspace variables
- ray_path_field: ArrayOfArrayOfPropagationPathPoint
A list of
ray_pathintended to build up a field of observations.This is used by some methods to set up representative fields to help speed up computations.
Input to workspace method
Output from workspace methods
Related workspace variables
- ray_path_observer_agenda: Agenda
Gets the propagation path as it is obeserved.
The intent of this agenda is to provide a propagation path as seen from the observer position and line of sight.
Tip
The perhaps easiest way to set this agenda up is to use the
ray_path_observer_agendaSetGeometric()method.Execution and customization
You can execute
ray_path_observer_agendadirectly from the workspace by callingray_path_observer_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
ray_path_observer_agendaOperator. See it,ray_path_observer_agendaSetOperator(), andray_path_observer_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Agenda output
Agenda input
Input to workspace methods
Output from workspace methods
Related workspace variables
- ray_path_observers: ArrayOfPropagationPathPoint
A list path points making up the observers of a propagation path.
These can be used directly for
obs_posandobs_losInput to workspace method
Output from workspace methods
Related workspace variables
- ray_path_suns_path: ArrayOfArrayOfArrayOfPropagationPathPoint
A list of paths to the suns from the ray path.
Dimensions:
ray_pathxsunsxsun_pathInput to workspace methods
Output from workspace method
Related workspace variables
- ray_point: PropagationPathPoint
A single path point.
This consists of
The altitude in meters as a
Numeric.The latitude in degrees as a
Numeric.The longitude in degrees as a
Numeric.The zenith angle in degrees as a
Numeric.The azimuth angle in degrees as a
Numeric.The
PathPositionTypeof the path if it moves forward along its line of sight.The
PathPositionTypeof the of the path at its current position.Bulk refractive index at the path point as a
Numeric.Group refractive index at the path point as a
Numeric.
Input to workspace methods
Output from workspace methods
Input to workspace agendas
Output from workspace agenda
Related workspace variables
- ray_point_back_propagation_agenda: Agenda
Gets the next past point along a propagation path.
ray_pathmust have a point already. This point is propagated backwards.It is up to internal methods if they respect
single_dispersionor not.It is up to internal methods if they respect
max_stepsizeor not.A special exception may be made for a 1-size
ray_paththat is in space or at the surface, where the next point may be the same point as the input.The end of the path is reached when the last point in
ray_pathis atPathPositionTypespaceorsurface.Execution and customization
See
ray_point_back_propagation_agendaSet()for builtin options that selects execution options.You can execute
ray_point_back_propagation_agendadirectly from the workspace by callingray_point_back_propagation_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
ray_point_back_propagation_agendaOperator. See it,ray_point_back_propagation_agendaSetOperator(), andray_point_back_propagation_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Agenda output
Agenda input
Default value
Shares the global
atm_fieldShares the global
surf_fieldsurf_search_accuracy = 0.1
surf_safe_search = 1
Ignore(), using: input =single_dispersionIgnore(), using: input =single_propmat
Input to workspace methods
Output from workspace methods
Related workspace variables
- scat_species: ArrayOfScatteringSpecies
The scattering species
Input to workspace method
Output from workspace method
Related workspace variables
- select_species: SpeciesEnum
Species selection.
When Bath is selected, all species are used. Otherwise, this variable should control so that only the selected species is used.
Default value
AIRInput to workspace methods
Input to workspace agendas
Related workspace variable
- select_species_list: ArrayOfSpeciesEnum
Species selection when multiple species must be chosen.
Input to workspace method
- single_dispersion: Numeric
A dispersion at a single
freqpoint.Input to workspace methods
Modified by workspace method
Output from workspace methods
Input to workspace agenda
Output from workspace agenda
Related workspace variables
- single_dispersion_jac: Vector
A dispersion Jacobian at a single
freqpoint.Modified by workspace method
Output from workspace methods
Output from workspace agenda
Related workspace variables
- single_nlte_srcvec: Stokvec
A non-LTE source vector at a single
freqpoint.See
spectral_propmatfor more information.Output from workspace methods
Output from workspace agenda
Related workspace variables
- single_nlte_srcvec_jac: StokvecVector
A non-LTE source vector Jacobian at a single
freqpoint.See
spectral_propmat_jacfor more information.Size is number of Jacobian targets.
Output from workspace methods
Output from workspace agenda
Related workspace variables
- single_nlte_srcvec_jac_path: StokvecMatrix
The propagation matrix Jacobian along the path for nonlte source.
Dimensions: [
ray_pathx jac_targets.target_size() ]Related workspace variables
- single_nlte_srcvec_path: StokvecVector
The propagation matrix along the path for nonlte source vector.
Dimensions: [
ray_path]Related workspace variables
- single_propmat: Propmat
A propagation matrix at a single
freqpoint.See
spectral_propmatfor more information.Input to workspace methods
Modified by workspace method
Output from workspace methods
Input to workspace agenda
Output from workspace agenda
Related workspace variables
- single_propmat_agenda: Agenda
Computes the propagation matrix, the non-LTE source vector, the dispersion, and their derivatives.
The intent of this agenda is to be the workhorse for the propagation matrix calculations that are happening deep in your ARTS method calls. The methods in question here only compute a single frequency point at a time.
If you do not need single-frequency-point calculations, consider using
spectral_propmat_agendainstead as it will likely be more efficient.Execution and customization
You can execute
single_propmat_agendadirectly from the workspace by callingsingle_propmat_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
single_propmat_agendaOperator. See it,single_propmat_agendaSetOperator(), andsingle_propmat_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Agenda output
Agenda input
Input to workspace methods
Output from workspace method
Related workspace variables
- single_propmat_jac: PropmatVector
A propagation matrix Jacobian at a single
freqpoint.See
spectral_propmat_jacfor more information.Size is number of Jacobian targets.
Modified by workspace method
Output from workspace methods
Output from workspace agenda
Related workspace variables
- single_propmat_jac_path: PropmatMatrix
The propagation matrix Jacobian along the path.
Dimensions: [
ray_pathx jac_targets.target_size() ]Related workspace variables
- single_propmat_path: PropmatVector
The propagation matrix along the path.
Dimensions: [
ray_path]Related workspace variables
- single_rad: Stokvec
Single value version of
spectral_rad.Output from workspace methods
Output from workspace agendas
Related workspace variables
- single_rad_jac: StokvecVector
Single value version of
spectral_rad_jac.Output from workspace methods
Output from workspace agendas
Related workspace variables
- single_rad_space_agenda: Agenda
Gets spectral radiance as seen of space for a single frequency.
Otherwise same as
spectral_rad_space_agenda.Execution and customization
See
single_rad_space_agendaSet()for builtin options that selects execution options.You can execute
single_rad_space_agendadirectly from the workspace by callingsingle_rad_space_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
single_rad_space_agendaOperator. See it,single_rad_space_agendaSetOperator(), andsingle_rad_space_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Agenda output
Agenda input
Default value
Shares the global
spectral_rad_space_agendaindex = 0
Input to workspace methods
Output from workspace methods
Related workspace variables
- single_rad_surface_agenda: Agenda
Gets spectral radiance as seen of the surface for a single frequency.
Otherwise same as
spectral_rad_surface_agenda.Execution and customization
See
single_rad_surface_agendaSet()for builtin options that selects execution options.You can execute
single_rad_surface_agendadirectly from the workspace by callingsingle_rad_surface_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
single_rad_surface_agendaOperator. See it,single_rad_surface_agendaSetOperator(), andsingle_rad_surface_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Agenda output
Agenda input
Default value
Shares the global
spectral_rad_surface_agendaindex = 0
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_absvec_scat: StokvecVector
The absorption vector of totally random orientation particles at a single point along a path using spectral representation
Modified by workspace method
Output from workspace methods
Output from workspace agenda
Related workspace variables
- spectral_absvec_scat_path: ArrayOfStokvecVector
The absorption vector of totally random orientation particles along the propagation path using spectral representation
Input to workspace method
Output from workspace method
Related workspace variables
- spectral_flux_profile: Matrix
An altitude profile of spectral flux.
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_nlte_srcvec: StokvecVector
The part of the source vector that is due to non-LTE.
This is closely related to
spectral_propmat.Gven the level source term:
\[\vec{J} = \mathbf{K}^{-1} \left(\vec{\alpha}B + \vec{J}_n + \cdots\right),\]this variable holds \(\vec{J}_n\). Here, \(\vec{\alpha}\) is the first column of \(\mathbf{K}\), which is from the
spectral_propmatvariable. \(B\) is the Planck function. The ellipsis denotes other terms that can come from more sources, such as scattering and/or transmitting equipment.The unit is in
spectral_radper meter.Modified by workspace method
Output from workspace methods
Output from workspace agenda
Related workspace variables
- spectral_nlte_srcvec_jac: StokvecMatrix
Partial derivative of the
spectral_nlte_srcvecwith regards tojac_targets.The units are
spectral_rad_jacper meter.Modified by workspace methods
Output from workspace methods
Output from workspace agenda
Related workspace variables
- spectral_nlte_srcvec_jac_path: ArrayOfStokvecMatrix
Additional non-LTE derivative along the propagation path
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_nlte_srcvec_path: ArrayOfStokvecVector
Additional non-LTE along the propagation path
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_phamat_spectral: SpecmatMatrix
The spectral phase matrix of totally random orientation particles at a single point along a path using spectral representation
Modified by workspace method
Output from workspace methods
Output from workspace agenda
Related workspace variables
- spectral_phamat_spectral_path: ArrayOfSpecmatMatrix
The spectral phase matrix of totally random orientation particles along the propagation path using spectral representation
Input to workspace method
Output from workspace method
Related workspace variables
- spectral_propmat: PropmatVector
This contains the fully polarized propagation matrix for the current path point.
The propagation matrix can be used to computed the transmission matrix as:
\[\mathbf{T} = \exp\left(-\mathbf{K} r\right),\]where \(\mathbf{K}\) is the propagation matrix, and \(r\) is some distance over which it is considered constant.
The unit is [1 / m].
Dimension:
freq_grid.Modified by workspace methods
Output from workspace methods
Output from workspace agenda
Related workspace variables
- spectral_propmat_agenda: Agenda
Computes the propagation matrix, the non-LTE source vector, and their derivatives.
The intent of this agenda is to be the workhorse for the propagation matrix calculations that are happening deep in your ARTS method calls.
Tip
Use
spectral_propmat_agendaAuto()after having defined your absorption data to create this agenda. It covers most use-cases.Execution and customization
See
spectral_propmat_agendaSet()for builtin options that selects execution options.You can execute
spectral_propmat_agendadirectly from the workspace by callingspectral_propmat_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
spectral_propmat_agendaOperator. See it,spectral_propmat_agendaSetOperator(), andspectral_propmat_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Constraints
On output,
spectral_propmathas the size offreq_grid.On output,
spectral_nlte_srcvechas the size offreq_grid.On output,
spectral_propmat_jachas the shape of the target-count ofjac_targetstimes the size offreq_grid.On output,
spectral_nlte_srcvec_jachas the shape of the target-count ofjac_targetstimes the size offreq_grid.
Agenda output
Agenda input
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_propmat_jac: PropmatMatrix
Partial derivative of the
spectral_propmatwith regards tojac_targets.The units depend on what is set in
jac_targets[1 / m / jacobian target’s unit].Modified by workspace methods
Output from workspace methods
Output from workspace agenda
Related workspace variables
- spectral_propmat_jac_path: ArrayOfPropmatMatrix
Propagation derivative matrices along the propagation path
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_propmat_path: ArrayOfPropmatVector
Propagation matrices along the propagation path
Input to workspace methods
Modified by workspace method
Output from workspace methods
Related workspace variables
- spectral_propmat_scat: PropmatVector
This contains the propagation matrix for scattering for the current path point.
This needs to be used when scattering into the line of sight is considered. And it needs then to also be added to the
spectral_propmat, which you should see for more information.The unit is [1 / m].
Dimension:
freq_grid.Modified by workspace methods
Output from workspace methods
Output from workspace agendas
Related workspace variables
- spectral_propmat_scat_agenda: Agenda
Computes the part of the propagation matrix that relates to scattering.
Execution and customization
See
spectral_propmat_scat_agendaSet()for builtin options that selects execution options.You can execute
spectral_propmat_scat_agendadirectly from the workspace by callingspectral_propmat_scat_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
spectral_propmat_scat_agendaOperator. See it,spectral_propmat_scat_agendaSetOperator(), andspectral_propmat_scat_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Constraint
On output,
spectral_propmat_scathas the size offreq_grid.
Agenda output
Agenda input
Default value
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_propmat_scat_path: ArrayOfPropmatVector
Propagation matrices along the propagation path for scattering
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_propmat_scat_spectral_agenda: Agenda
Gets the scattering propagation matrix, the scattering absorption vector, and the scattering spectral phase matrix.
Execution and customization
See
spectral_propmat_scat_spectral_agendaSet()for builtin options that selects execution options.You can execute
spectral_propmat_scat_spectral_agendadirectly from the workspace by callingspectral_propmat_scat_spectral_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
spectral_propmat_scat_spectral_agendaOperator. See it,spectral_propmat_scat_spectral_agendaSetOperator(), andspectral_propmat_scat_spectral_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Constraints
On output,
spectral_propmat_scathas the size offreq_grid.On output,
spectral_absvec_scathas the size offreq_grid.On output,
spectral_phamat_spectralhas the shape of <legendre_degree+ 1> times the size offreq_grid.
Agenda output
Agenda input
Default value
Shares the global
scat_species
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_rad: StokvecVector
A spectral radiance vector.
This is the representation of the spectral radiances at discrete frequencies for a discrete viewing direction.
The unit of spectral radiance is [W / m \(^2\) sr Hz].
Note that there are conversion routines that changes this unit, e.g.,
spectral_radApplyUnit(). After conversion, the use ofspectral_radin any method no marked as safe for different units, will lead to undefined behavior with possibly bad values being computed.The size of this variable should be the size of the local
freq_grid.Input to workspace methods
Modified by workspace methods
Output from workspace methods
Output from workspace agendas
Related workspace variables
- spectral_rad_bkg: StokvecVector
Spectral radiance from the background
Shape:
freq_gridInput to workspace methods
Output from workspace method
Related workspace variables
- spectral_rad_bkg_jac: StokvecMatrix
Spectral radiance derivative from the background
Shape:
model_state_vecxfreq_gridInput to workspace methods
Output from workspace method
Related workspace variables
- spectral_rad_closed_surface_agenda: Agenda
A closed surface agenda.
It behave exactly like
spectral_rad_surface_agenda. It exists to allow chaining surface agendas. The idea is that the mainspectral_rad_surface_agendavariable is the first interface and can chain into another surface agenda - this one.Thus this agenda must be “closed”. It cannot call another
spectral_rad_surface_agenda, whereasspectral_rad_surface_agendacan call this agenda. Imagine a chain where thespectral_rad_surface_agendagets the reflectance from a land surface model and calls thespectral_rad_observer_agendato compute the downwelling radiation at the surface. It can in turn callspectral_rad_closed_surface_agendato get the upwelling radiation from the surface that is being emitted. That’s the type of use case this agenda is made for and why it exists!Agenda output
Agenda input
Default value
Ignore(), using: input =subsurf_field
Input to workspace method
Related workspace variables
- spectral_rad_field: GriddedSpectralField6
The spectral radiance field.
spectral_radbut for a field.Dimensions are
alt_gridtimeslat_gridtimeslon_gridtimeszen_gridtimesazi_gridtimesfreq_grid.Input to workspace method
Output from workspace methods
Related workspace variables
- spectral_rad_jac: StokvecMatrix
Jacobian of
spectral_radwith respect tojac_targets.The size of this variable should be the local
jac_targetsas rows times the size of the localspectral_radas columns.Input to workspace method
Modified by workspace methods
Output from workspace methods
Output from workspace agendas
Related workspace variables
- spectral_rad_jac_path: ArrayOfStokvecMatrix
Spectral radiance derivative along the propagation path
Input to workspace method
Output from workspace methods
Related workspace variables
- spectral_rad_observer_agenda: Agenda
Computes spectral radiance as seen from the input position and environment.
The intent of this agenda is to provide the spectral radiance as seen from the observer position and line of sight.
It also outputs the
ray_pathas seen from the observer position and line of sight. This is useful in-case a call to the destructivespectral_radApplyUnitFromSpectralRadiance()is warranted.Execution and customization
See
spectral_rad_observer_agendaSet()for builtin options that selects execution options.You can execute
spectral_rad_observer_agendadirectly from the workspace by callingspectral_rad_observer_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
spectral_rad_observer_agendaOperator. See it,spectral_rad_observer_agendaSetOperator(), andspectral_rad_observer_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Constraints
On output,
spectral_radhas the size offreq_grid.On output,
spectral_rad_jachas the shape of the expectedmodel_state_vec(i.e., the x-size ofjac_targets) times the size offreq_grid.
Agenda output
Agenda input
Default value
Shares the global
measurement_sensorShares the global
ray_path_observer_agendaShares the global
spectral_propmat_agendaShares the global
spectral_rad_observer_agendaShares the global
spectral_rad_space_agendaShares the global
spectral_rad_surface_agendahse_derivative = 0
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_rad_operator: SpectralRadianceOperator
The spectral radiance operator.
This is a class that can compute the spectral radiance along a path for a single viewing direction and frequency.
It provides several methods to get the path of the spectral radiance.
Input to workspace methods
Output from workspace method
Related workspace variables
- spectral_rad_scat_path: ArrayOfStokvecVector
Spectral radiance scattered into the propagation path
Input to workspace method
Output from workspace method
Related workspace variables
- spectral_rad_space_agenda: Agenda
Gets spectral radiance as seen of space.
This agenda calculates the spectral radiance as seen of space. One common use-case is to provide a background spectral radiance.
The input path point should be as if it is looking at space.
Execution and customization
See
spectral_rad_space_agendaSet()for builtin options that selects execution options.You can execute
spectral_rad_space_agendadirectly from the workspace by callingspectral_rad_space_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
spectral_rad_space_agendaOperator. See it,spectral_rad_space_agendaSetOperator(), andspectral_rad_space_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Constraints
On output,
spectral_radhas the size offreq_grid.On output,
spectral_rad_jachas the shape of the expectedmodel_state_vec(i.e., the x-size ofjac_targets) times the size offreq_grid.
Agenda output
Agenda input
Default value
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_rad_srcvec_jac_path: ArrayOfStokvecMatrix
Source derivative vectors along the propagation path
Input to workspace method
Output from workspace method
Related workspace variables
- spectral_rad_srcvec_path: ArrayOfStokvecVector
Source vectors along the propagation path
Input to workspace method
Modified by workspace method
Output from workspace method
Related workspace variables
- spectral_rad_surface_agenda: Agenda
Computes spectral radiance as seen of the surface.
This agenda calculates the spectral radiance as seen of the surface. One common use-case us to provide a background spectral radiance.
The input path point should be as if it is looking at the surface.
Subsurface calculations are also supported through this agenda, but might require setting
spectral_rad_closed_surface_agendaas well.Execution and customization
See
spectral_rad_surface_agendaSet()for builtin options that selects execution options.You can execute
spectral_rad_surface_agendadirectly from the workspace by callingspectral_rad_surface_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
spectral_rad_surface_agendaOperator. See it,spectral_rad_surface_agendaSetOperator(), andspectral_rad_surface_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Constraints
On output,
spectral_radhas the size offreq_grid.On output,
spectral_rad_jachas the shape of the expectedmodel_state_vec(i.e., the x-size ofjac_targets) times the size offreq_grid.
Agenda output
Agenda input
Default value
Ignore(), using: input =subsurf_field
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_rad_transform_operator: SpectralRadianceTransformOperator
The spectral radiance transform operator
This is responsible for things like converting the spectral radiance into a different unit, e.g., from [W / m \(^2\) sr Hz] to Kelvin.
Default value
<SpectralRadianceTransformOperator::unit>Input to workspace methods
Output from workspace method
Related workspace variables
- spectral_surf_refl: MuelmatVector
Spectral surface reflectance.
Shape:
freq_gridOutput from workspace methods
Output from workspace agenda
Related workspace variables
- spectral_surf_refl_agenda: Agenda
An agenda to compute the surface reflectance.
Execution and customization
See
spectral_surf_refl_agendaSet()for builtin options that selects execution options.You can execute
spectral_surf_refl_agendadirectly from the workspace by callingspectral_surf_refl_agendaExecute().As all agendas in ARTS, it is also customizable via its operator helper class:
spectral_surf_refl_agendaOperator. See it,spectral_surf_refl_agendaSetOperator(), andspectral_surf_refl_agendaExecuteOperator()for more details.Also see the
arts_agendaproperty for how to fully define an agenda in python.Constraints
spectral_surf_reflmatchfreq_gridsizespectral_surf_refl_jacmatchjac_targetstarget count andfreq_gridsize
Agenda output
Agenda input
Input to workspace methods
Output from workspace methods
Related workspace variables
- spectral_surf_refl_jac: MuelmatMatrix
Spectral surface reflectance jacobian.
Shape:
jac_targets- target count xfreq_gridOutput from workspace methods
Output from workspace agenda
Related workspace variables
- spectral_tramat_bkg: MuelmatVector
Transmittance from the background
Input to workspace method
Output from workspace methods
Related workspace variables
- spectral_tramat_cumulative_path: ArrayOfMuelmatVector
Cumulative transmission matrices along the propagation path
Input to workspace methods
Output from workspace method
Related workspace variables
- spectral_tramat_jac_path: ArrayOfMuelmatTensor3
Transmission derivative matrices along the propagation path.
The outer dimension is the number of layers.
The inner dimensions are the number of level derivatives, the number of jacbian targets, and the number of frequency points. The required number of level derivatives is determined by the appropriate method (a common value is 2, for the 2 levels surrounding a layer).
The order of the elements is such that index zero is closest to the obeserver.
Input to workspace methods
Output from workspace method
Related workspace variables
- spectral_tramat_path: ArrayOfMuelmatVector
Transmission matrices along the propagation path.
The outer dimension is the number of layers.
The inner dimension is the number of frequency points.
The order of the elements is such that index zero is closest to the obeserver.
Input to workspace methods
Output from workspace method
Related workspace variables
- subsurf_field: SubsurfaceField
The sub-surface field.
This contains global subsurface properties, such as temperature. It also contains many properties that are used by specific subsurface-related methods.
It is a 3D field with
alt,lat, andlondimensions.For more information, see The subsurface.
Default value
"bottom_depth": 1.7976931348623157e+308Input to workspace methods
Modified by workspace methods
Input to workspace agendas
Modified by workspace agenda
Related workspace variables
- subsurf_profile: ArrayOfSubsurfacePoint
A profile of subsurface points. Supposed to be ordered from top to bottom.
For more information, see The subsurface.
Input to workspace methods
Output from workspace method
Related workspace variables
- sun: Sun
A sun.
Input to workspace methods
Output from workspace methods
Related workspace variables
- sun_path: ArrayOfPropagationPathPoint
A path to a sun if it is visible.
A related variable is
ray_pathSize is number of path points for the sun.
Input to workspace method
Output from workspace method
Related workspace variables
- suns: ArrayOfSun
A list of
Sun.Size is number of suns.
Input to workspace methods
Related workspace variable
- surf_field: SurfaceField
The surface field.
This contains the global surface values, such as elevation and temperature but also entirely abstract properties and types that are used by specific surface-related methods.
It is a 2D field with
lat, andlondimensions.For more information, see The surface and planet.
Input to workspace methods
Modified by workspace methods
Output from workspace methods
Input to workspace agendas
Modified by workspace agenda
Related workspace variables
- water_equivalent_pressure_operator: NumericUnaryOperator
The water equivalent pressure operator.
Usage: psat = water_equivalent_pressure_operator(temperature).
Parameters
- temperatureNumeric
Temperature in Kelvin.
Returns
- psatNumeric
The water equivalent pressure in Pascal.
Input to workspace method
Output from workspace method
- zen_grid: ZenGrid
A single zenith angle grid.
Units: degrees
Note
There is no global grid system in ARTS, so beware of the local nature of all grids.
Input to workspace methods
Output from workspace method
Related workspace variables
Operators
- __eq__(value, /)
Return self==value.
- __ge__(value, /)
Return self>=value.
- __getstate__()
Helper for pickle.
- __gt__(value, /)
Return self>value.
- __hash__()
Return hash(self).
- __init__(self) None
- __init__(self, arg: pyarts3.arts.CxxWorkspace) None
- __init__(self, with_defaults: bool = True) None
- __iter__(self) collections.abc.Iterator[tuple[str, pyarts3.arts.Wsv]]
Allows iter(self)
- __le__(value, /)
Return self<=value.
- __lt__(value, /)
Return self<value.
- __ne__(value, /)
Return self!=value.