% QARTS3 Defines setting fields for arts calculations % % The function defines all mandatory Qarts fields. Most fields are initiated % to {}, that indicates that no value has been specified. No data will be % transferred to arts for fields later not given a non-{} value. The % settings are converted to control files by *qarts3cfile*. % % This function is organised in such way that *qcheck* and *qinfo* can be % used. % % Allowed formats differ between the fields, see *qarts3.txt* found in % folder documentation/qarts. % % FORMAT [Q,I] = qarts3 % % OUT Q Setting structure (with all fields set to {}). % I Includes same fields as Q, where the content of each field % is a description string (used by *qinfo*). % 2020-08-19 Created by Patrick Eriksson. function [Q,I] = qarts3 %----------------------------------------------------------------------------- Q.ABS_LINES = {}; I.ABS_LINES = [ ... 'The data on spectroscopic lines to use. See *ABS_LINES_FORMAT* for how ',... 'to handle cases without lines. Can be given in two ways:', ... '#1. As a file name. All formats handled by arts can then be used. See', ... ' ABS_LINES_FORMAT. The reading is not restricted to any frequency range.', ... '#2. For the XML option, several file names can be given (as string array)',... ' and the line data in the files are appended.',... '#3. As an array of line data. This option is only allowed when ',... 'ABS_LINES_FORMAT is set to ''XML''.' ]; %----------------------------------------------------------------------------- Q.ABS_LINES_FLIMS = {}; I.ABS_LINES_FLIMS = [ ... 'Frequency limits when reading from input spectroscopic file.', ... '# When *ABS_LINES_FORMAT* is set and is not equal to ''None'', this ',... 'field matches the arguments *fmin* and *fmax* in ARTS reading routines ',... 'for *abs_lines*. See e.g. *abs_linesReadFromJpl*. This field shall be a ',... 'vector of length 2. If not set, default is [0,1e99].',... '# Can be given either as the name of a file, as a matching Matlab ',... 'variable or control file text.' ]; %----------------------------------------------------------------------------- Q.ABS_LINES_FORMAT = {}; I.ABS_LINES_FORMAT = [ ... 'The format of spectroscopic data.', ... '# Possible line formats are ''XML'', ''Artscat'', ''Hitran'', ''Jpl'' and ',... '''Mytran2''. The first option (XML) expects the ABS_LINES is line data',... 'including meta data (i.e. the system inroduced 2020).',... '# The field can further be set to ''None'' which indicates that no line ',... 'data shall be included (the WSV *abs_lines_per_species* is set to be empty).' ]; %----------------------------------------------------------------------------- Q.ABS_LINESHAPE = {}; I.ABS_LINESHAPE = [ ... 'The line shape to use. The same line shape is used for all tag groups.', ... ' Shall be a string. ', ... 'Do "arts -d abs_linesSetLineShapeType" to list valid options.' ]; %----------------------------------------------------------------------------- Q.ABS_LINESHAPE_CUTOFF = {}; I.ABS_LINESHAPE_CUTOFF = [ ... 'The line shape cut-off to apply. The same cut-off is used for all tag', ... ' groups. A value of <0 means no cut-off. ', ... 'Do "arts -d abslineshapeDefine" for further information.' ]; %----------------------------------------------------------------------------- Q.ABS_LINESHAPE_FACTOR = {}; I.ABS_LINESHAPE_FACTOR = [ ... 'The line shape normalisation factor to apply. The same factor is used', ... ' for all tag groups. Shall be a string. ', ... 'Do "arts -d abs_linesSetNormalization" for valid options.' ]; %----------------------------------------------------------------------------- Q.ABS_LINESHAPE_MIRRORING = {}; I.ABS_LINESHAPE_MIRRORING = [ ... 'Option for mirroring of lines.', ... 'Do "arts -d abs_linesSetMirroring" for valid options.' ]; %----------------------------------------------------------------------------- Q.ABS_SPECIES = {}; I.ABS_SPECIES = [ ... 'Specification of absorption species. Arts requires in many cases that ', ... 'H2O and N2 are included. ',... 'This is a structure array defining species and associated retrieval ',... 'variables. These sub-fields are defined: ', ... '# ',... '# Tag group data, following *arts_tgs_cnvrt*.', ... '# ',... '# VMR data for the species. The input shall follow the atmdata ',... 'format, defined in *isatmdata*. The data specified here are not directly ',... 'given to arts, it can only be used to set-up *VMR_FIELD*. This step is ',... 'handled by *qarts_vmr_field*. The field is accordingly not mandatory. ',... 'The main usage of this field should be to import data of climatology ',... 'character. Can be given as a variable or a file saved through *gf_save*. ',... 'This field is recognised and used automatically by Qpack2.',... '# ',... '# If set to true the species is retrieved. Otherwise the ', ... 'species is not retrieved (what a surprise!).', ... '# ',... '# Retrieval unit. Allowed choices are ''rel'', ''vmr'', ''nd'', ', ... 'and ''logrel''. For some more information:',... '#arts -d jacobianAddAbsSpecies.', ... '# ',... '# Retrieval grids for the species. An array of vectors of length 3:',... ' {p_grid,lat_grid,lon_grid}. Grids for dimensions not used shall be ',... 'empty.',... '# ',... '# Covariance matrix of a priori knowledge for the species. Size must ',... 'match the grid field. Data must match . A matrix, that can be ',... 'sparse.',... '# ',... '# The inverse of SX. An optional field. If set, a matrix of same ',... 'size as SX. Otherwise the inverse is calculated internally. A reason to '.... 'set this field is if the inverse can be determined by an analytical ',... 'espression.',... '# ',... '# Flag for any function creating L2 data. See comments for ',... '*L2_EXTRA*. If set to true, the retrieved state for the species ',... 'will be included in the L2 output. Otherwise not. This field has no ',... 'importance if RETRIEVE is false.',... '# ',... '# Fine tuning of L2 data ranges. ',... 'The default is to store data directly matching the retrieval ',... 'grids. This is done if the field is non-existing. This ',... 'field allows you to either crop or extend range of the L2 data. ',... 'It is then a vector of length, at least, twice the atmospheric ',... 'dimensionality: [p_min p_max lat_min lat_max lon_min lon_max] where ',... 'lat_min gives the minimum latitude to include etc. ',... '# If a given limit is inside the range covered by the corresponding ',... 'retrieval grid, this results in that the data are cropped. This ',... 'feature can be used to remove parts that are of no interest for ',... 'L2 data (such as parts always having a low measurement response). ',... '# The default L2 output is not reflecting the fact that values at ',... 'end points of the retrieval grids are valid all the way to the ',... 'matching atmospheric limit. This field can also be used to ',... 'incorporate this part. If a limit is outside the retrieval grid, ',... 'the L2 data will also include the retrieved state at the ',... 'specified or the atmospheric limit (which is the closest to the ',... 'retrieval grid). In practice this signifies a duplication of end point ',... 'data.',... '# Only retrieved profile and errors are modified. Averaging kernel, ',... 'covariance and gain matrices are kept consistent with the original ',... 'retrieval grids.'... '# ',... '# Min and max allowed value for retrievals. This field has ',... 'no impact on linear retrievals. These limits are applied during the ',... 'iterations of a non-linear inversion. The limits apply also to the ',... 'final result for inversions that converge, but not always for non-',... 'converging inversions,',... '# A single min and ',... 'max value is applied for each species. The field can be left undefined, ',... 'be empty, be a scalar or vector of length 2. A single value as taken as ',... 'min, and is then set to Inf. The min value can be set to -Inf. The unit',... 'follows the field *UNIT*.',... '# The primary usage of the field should be to avoid negative vmr values. ',... '# ',... ]; %----------------------------------------------------------------------------- Q.ABSORPTION = {}; I.ABSORPTION = [ ... 'String describing how absorption shall be calculated/obtained. ',... 'Existing options are:', ... '# {} : Absorption variables defined by include files. All ',... 'absorption fields above will be ignored.',... '# ''OnTheFly'' : Absorption is calculated for each propagation path ',... 'point. The agenda *abs_scalar_gas_agenda* must here be set in some way. ',... 'No other absorption variables need to be set.',... '# ''CalcTable'': Calculate and use an absorption look-up table. See ',... '*qarts_abstable* for simple setting of needed variables.',... '# ''LoadTable'': Load and use pre-calculated absorption look-up table. ',... 'Requires that Q.abs_lookup is set.',... '#If this field is set, *ABS_XSEC_AGENDA* and *PROPMAT_CLEARSKY_AGENDA* ',... 'are set matching calculations of standard type.' ]; %----------------------------------------------------------------------------- Q.ATMOSPHERE_DIM = {}; I.ATMOSPHERE_DIM = [ ... 'Triggers to call AtmosphereSetXD, where X is the value of the field.' ]; %----------------------------------------------------------------------------- % Q.BATCH = {}; % I.BATCH = [ ... % 'Batch calculations. Defined by a structure, described in ',... % '*qartsBatch*. Type ''qinfo(@qartsBatch);'' for further information. ',... % 'Batch calculations are not started automatically (in e.g. *arts_y*), but ',... % 'must be selected specifically (most easily done by using *arts_batch*).' % ]; %----------------------------------------------------------------------------- Q.CHECKS_DO = false; I.CHECKS_DO = [ ... 'Boolean to automatically insert *atmfields_checkedCalc* and all other ',... 'similar checks.' ]; %----------------------------------------------------------------------------- % Q.FSHIFTFIT = {}; % I.FSHIFTFIT = [ ... % 'Structure for specification of frequency shift retrievals. No retrieval',... % 'is made if field is empty or sub-field RETRIEVAL is set to false. The WSM ',... % 'used is *jacobianAddFreqShift*. The polynomial order is hard-coded to ',... % 'zero. These sub-fields are defined:',... % '# ',... % '# Flag to activate frequency retrieval.', ... % '# ',... % '# Size for numerical perturbation.', ... % '# ',... % '# Variance of a priori knowledge on the variable.',... % '# ',... % '# The inverse of SX. An optional field, see further ABS_SPECIES.',... % '# ',... % '# Flag for any function creating L2 data. See comments for ',... % '*L2_EXTRA*. If set to true, the retrieved frequency fit variables ',... % 'will be included in the L2 output. Otherwise not. This field has no ',... % 'importance if RETRIEVE is false.' % ]; %----------------------------------------------------------------------------- % Q.FSTRETCHFIT = {}; % I.FSTRETCHFIT = [ ... % 'Structure for specification of frequency stretch retrievals. No retrieval ',... % 'is made if field is empty or sub-field RETRIEVAL is set to false. The WSM ',... % 'used is *jacobianAddFreqStretch*. The polynomial order is hard-coded to ',... % 'zero. These sub-fields are defined:',... % '# ',... % '# Flag to activate frequency retrieval.', ... % '# ',... % '# Size for numerical perturbation.', ... % '# ',... % '# Variance of a priori knowledge on the variable.',... % '# ',... % '# The inverse of SX. An optional field, see further ABS_SPECIES.',... % '# ',... % '# Flag for any function creating L2 data. See comments for ',... % '*L2_EXTRA*. If set to true, the retrieved frequency fit variables ',... % 'will be included in the L2 output. Otherwise not. This field has no ',... % 'importance if RETRIEVE is false.' % ]; %----------------------------------------------------------------------------- Q.HSE = {}; I.HSE = [ ... 'Variables associated with hydrostatic equilibrium. A structure with the ',... 'sub-fields:',... '# ',... '# Flag to enforce hydrostatic equilibrium. If true, the WSV *z_field*',... 'is recalculated by *z_fieldFromHSE* (note that a "first guess" *z_field* ',... 'must be provided).',... '# ',... '#

Pressure for reference point. Matches the WSV *p_hse*.',... '# ',... '# Calculation accuracy. Matches the WSV *z_hse_accuracy*.',... '# ',... '#If the field is unset, no action is taken. This equals to set Q.HSE.ON ',... 'to false. Note the setting Q.T.HSE which controls the calculation of t-',... 'jacobians. The two settings are treated as independent, but should ',... 'be set to the same value (true/false), otherwise inconsistencies will ',... 'be introduced.' ]; %----------------------------------------------------------------------------- Q.INCLUDES = {}; I.INCLUDES = [ ... 'Paths to control files to be included. These files will be included ',... 'at the top of the control file.',... '# The atmlab setting ARTS_INCLUDES is recognised. To include the ',... 'standard arts general definition file, select:',... '{''ARTS_INCLUDES/general.arts''}' ]; %----------------------------------------------------------------------------- Q.INPUT_FILE_FORMAT = 'binary'; I.INPUT_FILE_FORMAT = [ ... 'The file format for arts input files. That is, the format of the files ',... 'created in Matlab to be read by arts. Possible options are ''binary'', '... 'and ''double''. The binary option, that is default, should be most '... 'efficient. Use ''double'' if you want to visually inspect the files ',... 'generated. (The option ''float'' is not allowed, as this is not always '... 'sufficient for frequency data.)' ]; %----------------------------------------------------------------------------- Q.J_DO = {}; I.J_DO = [ ... 'Boolean to include calculation of jacobians.',... '# {}: Nothing is done. Relevant data are assumed to be specified by ',... 'inclusion files.',... '# 0: Call of *jacobianOff* is included.',... '# 1: Action follows setting of field *J*.' ]; %----------------------------------------------------------------------------- % Q.L2_EXTRA = {}; % I.L2_EXTRA = [ ... % 'Information to functions repacking retrieval information. Such a product ', ... % 'is normally denoted as L2 data. This field lists data to be included ', ... % 'beside the direct retrieval quantities, for which their L2 field has ',... % 'the same functionality. The information is given as string array, e.g.:',... % '# Q.L2_EXTRA = {''cost'',''mresp'',''ptz''}',... % '#There is no general L2 function and the possible data output (and ',... % 'coding) differs between the functions.' % ]; %----------------------------------------------------------------------------- % Q.MAG_U = {}; % I.MAG_U = [ ... % 'Data and settings associated with MAG_U_FIELD. Has the same role as T with ',... % 'respect to T_FIELD, but as there are no retrievals associated with MAG_U ',... % 'there is only one sub-field here:',... % '# ',... % '# The input shall follow the atmdata format, defined in ',... % '*isatmdata*. The data specified here are not directly given to arts, it ',... % 'can only be used to set-up *MAG_U_FIELD*. This step is handled by ',... % '*qarts_atm_field*. The main usage of this field should be to import ',... % 'data of climatology character. Can be given as a variable or a file saved ',... % 'through *gf_save*. ',... % 'This field is recognised and used automatically by Qpack2.',... % '# ',... % '# If set to true, this magnetic field component is retrieved.', ... % '# ',... % '# Retrieval grids for the component. An array of vectors of length 3:',... % ' {p_grid,lat_grid,lon_grid}. Grids for dimensions not used shall be ',... % 'empty.',... % '# ',... % '# Covariance matrix of a priori knowledge. Size must ',... % 'match the grid field. Data must match . A matrix, that can be ',... % 'sparse.',... % '# ',... % '# The inverse of SX. An optional field, see further ABS_SPECIES.',... % '# ',... % '# Flag for any function creating L2 data. See comments for ',... % '*L2_EXTRA*. If set to true, the retrieved state for this component ',... % 'will be included in the L2 output. Otherwise not.',... % '# ',... % '# As the same field for ABS_SPECIES.',... % '# ',... % '# Min and max allowed value for retrievals. Works exactly as ',... % 'for ABS_SPECIES.',... % '# ',... % '#None of the fields are mandatory for pure forward calculations. If ',... % 'RETRIEVAL is set to false, the other retrieval related fields are ignored.' % ]; %----------------------------------------------------------------------------- % Q.MAG_V = {}; % I.MAG_V = [ ... % 'Data and settings associated with the v-component of the magnetic field. ',... % 'Defined as MAG_U, and the details are nor repeated here.' % ]; %----------------------------------------------------------------------------- % Q.MAG_W = {}; % I.MAG_W = [ ... % 'Data and settings associated with the w-component of the magnetic field. ',... % 'Defined as MAG_U, and the details are nor repeated here.' % ]; %----------------------------------------------------------------------------- % Q.POINTING = {}; % I.POINTING = [ ... % 'Structure for specification of pointing fit retrievals. No retrieval is', ... % 'made if field is empty or sub-field RETRIEVAL is set to false. The WSM ',... % 'used is *jacobianAddPointingZa*. These sub-fields are defined:',... % '# ',... % '# Flag to activate pointing retrieval.', ... % '# ',... % '# Size for numerical perturbation. See used WSM.', ... % '# ',... % '# Order of polynomial to describe the time variation of ',... % 'pointing errors.', ... % '# ',... % '# The manner in which the jacobian is determined. See used WSM.',... % '# ',... % '# Covariance matrix of a priori knowledge for pointing fit variables. ',... % 'A square matrix of size POLY_ORDER+1.',... % '# ',... % '# The inverse of SX. An optional field, see further ABS_SPECIES.',... % '# ',... % '# Flag for any function creating L2 data. See comments for ',... % '*L2_EXTRA*. If set to true, the retrieved pointing variables ',... % 'will be included in the L2 output. Otherwise not. This field has no ',... % 'importance if RETRIEVE is false.' % ]; %----------------------------------------------------------------------------- % Q.POLYFIT = {}; % I.POLYFIT = [ ... % 'Structure for specification of polynomial baseline fits. No retrieval is', ... % 'made if field is empty or sub-field RETRIEVAL is set to false. The WSM ',... % 'used is *jacobianAddPolyfit*. All no_xxx_variation arguments of the WSM ',... % 'are set to default value. The different polynomial coefficients are ',... % 'assumed to be uncorrelated. These sub-fields are defined:',... % '# ',... % '# Flag to activate pointing retrieval', ... % '# ',... % '# Order of polynomial fit.', ... % '# ',... % '# Covariance matrix of a priori knowledge for coefficient of order ',... % 'zero. There shall be such a matrix for each coefficient order until:',... % '# ',... % '# Covariance matrix of a priori knowledge for coefficient of order ',... % 'POLY_ORDER. The last required covariance matrix.',... % '# ',... % '# The inverse of SXn. An optional field, see further ABS_SPECIES.',... % '# ',... % '# Flag for any function creating L2 data. See comments for ',... % '*L2_EXTRA*. If set to true, the retrieved baseline variables ',... % 'will be included in the L2 output. Otherwise not. This field has no ',... % 'importance if RETRIEVE is false.' % ]; %----------------------------------------------------------------------------- Q.RAW_ATMOSPHERE = {}; I.RAW_ATMOSPHERE = [ ... 'If set, a "raw atmosphere" is read. This is the main file name for the ',... 'raw atmosphere. See further ''arts -d AtmRawRead''.',... '#Data in the fields T, Z and ABS_SOECIES.ATMDATA are included at a later ',... 'stage and will then overwrite the data from the raw atmosphere. This ',... 'gives thus some flexibility to mix data from different sources.' ]; %----------------------------------------------------------------------------- Q.RAW_ATM_EXPAND_1D = {}; I.RAW_ATM_EXPAND_1D = [ ... 'Boolean to expand an 1D raw atmosphere to set dimensionality. If set to ',... '1, the WSM *AtmFieldsCalcExpand1D* is used instead of *AtmFieldsCalc*.',... 'This variable is only used if RAW_ATMOSPHERE is set.' ]; %----------------------------------------------------------------------------- %Q.SCATTERING = {}; %I.SCATTERING = [ ... %'Handling of cloudbox/scattering. Defined by a structure, described in ',... %'*qartsCloudbox*. Type ''qinfo(@qartsCloudbox);'' for further information.' %]; %----------------------------------------------------------------------------- Q.SCATTERING_DO = {}; I.SCATTERING_DO = [ ... 'Boolean to activate the cloud box (scattering calculations), or not.',... '# {}: Nothing is done. Relevant data are assumed to be specified by ',... 'inclusion files.',... '# Not yet implemented' ]; %----------------------------------------------------------------------------- Q.SENSOR_DO = {}; I.SENSOR_DO = [ ... 'Boolean to include sensor characteristics. Otherwise monochromatic pencil ',... 'beam calculations are performed. *SENSOR_POS/LOS* are used in both cases. ',... '# {}: Nothing is done. Relevant data are assumed to be specified by ',... 'inclusion files.',... '# false: Call of *sensorOff* is included.',... '# true : Action follows setting of field *SENSOR_RESPONSE*.' ]; %----------------------------------------------------------------------------- Q.SENSOR = {}; I.SENSOR = [ ... 'Two options exist:', ... '#1: A series of workspace method calls (format as for e.g. WSMS_AT_END).',... '#2: Calculate the response from basic data. This field shall then be a ',... 'structure, following the definitions in *qartsSensor*. Type ',... '''qinfo(@qartsSensor);'' for definition of required data fields.',... 'Other fields that must/may be specified here include ANTENNA_DIM and ',... 'MBLOCK_DLOS_GRID.',... '#You can of course specify all sensor variables individually, but it ',... 'is the Q.sensor_response you should set and all associated variables.' ]; %----------------------------------------------------------------------------- % Q.SINEFIT = {}; % I.SINEFIT = [ ... % 'Structure for specification of sinusoidal baseline fits. No retrieval is', ... % 'made if field is empty or sub-field RETRIEVAL is set to false. The WSM ',... % 'used is *jacobianAddSinefit*. All no_xxx_variation arguments of the WSM ',... % 'are set to default value. The different period lengths are assumed ',... % 'to be uncorrelated. These sub-fields are defined:',... % '# ',... % '# Flag to activate retrieval', ... % '# ',... % '# Period lengths of the fit.', ... % '# ',... % '# Covariance matrix of a priori knowledge for coefficients of first ',... % 'period length. This is applied as the covariance for both the sine and ',... % 'cosine term, assuming that the two terms are uncorrelated. That is, for ',... % 'single spectra retrievals, SX1 is a scalar, giving the variance for both ',... % 'a and b, where the baseline is modelled as a*sin(...)+b*cos(...). ',... % 'There shall be such a matrix for each period length until:',... % '# ',... % '# Covariance matrix of a priori knowledge for last period length. ',... % 'The last required covariance matrix.',... % '# ',... % '# The inverse of SX. An optional field, see further ABS_SPECIES.',... % '# ',... % '# Flag for any function creating L2 data. See comments for ',... % '*L2_EXTRA*. If set to true, the retrieved baseline variables ',... % 'will be included in the L2 output. Otherwise not. This field has no ',... % 'importance if RETRIEVE is false.' % ]; %----------------------------------------------------------------------------- % Q.T = {}; % I.T = [ ... % 'Data and setting associated with atmospheric temperatures. Normally used ',... % 'when retrieving temperature. Otherwise, *T_FIELD* can be set directly.',... % '# ',... % '# The input shall follow the atmdata format, defined in ',... % '*isatmdata*. The data specified here are not directly given to arts, it ',... % 'can only be used to set-up *T_FIELD*. This step is handled by ',... % '*qarts_atm_field*. The main usage of this field should be to import ',... % 'data of climatology character. Can be given as a variable or a file saved ',... % 'through *gf_save*. ',... % 'This field is recognised and used automatically by Qpack2.',... % '# ',... % '# If set to true, atmospheric temperatures are retrieved.', ... % '# ',... % '# Retrieval grids for temperature. An array of vectors of length 3:',... % ' {p_grid,lat_grid,lon_grid}. Grids for dimensions not used shall be ',... % 'empty.',... % '# ',... % '# Covariance matrix of a priori knowledge for temperature. Size must ',... % 'match the grid field. Data must match . A matrix, that can be ',... % 'sparse.',... % '# ',... % '# The inverse of SX. An optional field, see further ABS_SPECIES.',... % '# ',... % '# Flag for any function creating L2 data. See comments for ',... % '*L2_EXTRA*. If set to true, the retrieved state for temperature ',... % 'will be included in the L2 output. Otherwise not.',... % '# ',... % '# As the same field for ABS_SPECIES.',... % '# ',... % '# Min and max allowed value for retrievals. Works exactly as ',... % 'for ABS_SPECIES.',... % '# ',... % '# As the argument to *jacobianAddTemperature* with same name. ',... % 'Default here is "on". This refers only to the actual jacobian calculation.',... % ' If the atmosphere itself fulfils HSE or not is controlled by Q.HSE.',... % '# ',... % '#None of the fields are mandatory for pure forward calculations. If ',... % 'RETRIEVAL is set to false, the other retrieval related fields are ignored.' % ]; %----------------------------------------------------------------------------- % Q.TNOISE_C = {}; % I.TNOISE_C = [ ... % 'Thermal noise correlation. A matrix (sparse preferably) giving the ', ... % 'correlation of thermal noise between channels. Hence, the diagonal ',... % 'elements shall all be one. If the thermal noise is the same for all ',... % 'channels and has a standard deviation of s, the covariance matrix is ',... % 's*s*TNOISE_C.' % ]; %----------------------------------------------------------------------------- % Q.WIND_U = {}; % I.WIND_U = [ ... % 'Data and settings associated with the u-component of winds. Normally used ',... % 'when retrieving winds. Otherwise, *WIND_U_FIELD* can be set directly.',... % '# ',... % '# The input shall follow the atmdata format, defined in ',... % '*isatmdata*. The data specified here are not directly given to arts, it ',... % 'can only be used to set-up *WIND_U_FIELD*. This step is handled by ',... % '*qarts_atm_field*. The main usage of this field should be to import ',... % 'data of climatology character. Can be given as a variable or a file saved ',... % 'through *gf_save*. ',... % 'This field is recognised and used automatically by Qpack2.',... % '# ',... % '# If set to true, this atmospheric wind component is retrieved.', ... % '# ',... % '# Retrieval grids for the wind. An array of vectors of length 3:',... % ' {p_grid,lat_grid,lon_grid}. Grids for dimensions not used shall be ',... % 'empty.',... % '# ',... % '# Covariance matrix of a priori knowledge. Size must ',... % 'match the grid field. Data must match . A matrix, that can be ',... % 'sparse.',... % '# ',... % '# The inverse of SX. An optional field, see further ABS_SPECIES.',... % '# ',... % '# Flag for any function creating L2 data. See comments for ',... % '*L2_EXTRA*. If set to true, the retrieved state for this wind component ',... % 'will be included in the L2 output. Otherwise not.',... % '# ',... % '# As the same field for ABS_SPECIES.',... % '# ',... % '# Min and max allowed value for retrievals. Works exactly as ',... % 'for ABS_SPECIES.',... % '# ',... % '#None of the fields are mandatory for pure forward calculations. If ',... % 'RETRIEVAL is set to false, the other retrieval related fields are ignored.' % ]; %----------------------------------------------------------------------------- % Q.WIND_V = {}; % I.WIND_V = [ ... % 'Data and settings associated with the v-component of winds. Defined ',... % 'as WIND_U, and the details are nor repeated here.' % ]; %----------------------------------------------------------------------------- % Q.WIND_W = {}; % I.WIND_W = [ ... % 'Data and settings associated with the w-component of winds. Defined ',... % 'as WIND_U, and the details are nor repeated here.' % ]; %----------------------------------------------------------------------------- Q.WSMS_AT_HALFWAY = {}; I.WSMS_AT_HALFWAY = [ ... 'Workspace method calls to include at approximately halfway. ',... 'Format and options as for WSMS_AT_START.' ]; %----------------------------------------------------------------------------- Q.WSMS_AT_END = {}; I.WSMS_AT_END = [ ... 'Workspace method calls to include at the end of the control file. ',... 'Format and options as for WSMS_AT_START.' ]; %----------------------------------------------------------------------------- Q.WSMS_AT_START = {}; I.WSMS_AT_START = [ ... 'Workspace method calls to include at the top of the control file. These ',... 'calls are only preceded by possible settings set by INCLUDES.',... '# Method calls are specified as an cell array of strings. For example, if ',... 'no inclusion files are used, these calls could be useful to include',... '# { ''VectorSet(abs_n2,[0.7808])'', ''abs_cont_descriptionInit'' }' ]; %----------------------------------------------------------------------------- % Q.Z = {}; % I.Z = [ ... % 'Data and settings associated with Z_FIELD. Has the same role as T with ',... % 'respect to T_FIELD, but as there are no retrievals associated with Z ',... % 'there is only one sub-field here:',... % '# ',... % '# The input shall follow the atmdata format, defined in ',... % '*isatmdata*. The data specified here are not directly given to arts, it ',... % 'can only be used to set-up *Z_FIELD*. This step is handled by ',... % '*qarts_atm_field*. The main usage of this field should be to import ',... % 'data of climatology character. Can be given as a variable or a file saved ',... % 'through *gf_save*. ',... % 'This field is recognised and used automatically by Qpack2.',... % ]; %----------------------------------------------------------------------------- Q.Z_SURFACE = {}; I.Z_SURFACE = [ ... 'As the arts WSV with the same name but included in teh control file at a ', ... 'later stage. Allowed formats follow standard WSVs.' ]; %-----------------------------------------------------------------------------