VTD 控制文件关键词指南
在人工智能的帮助下,我又得到了一份VTD控制文件关键词指南。
控制文件关键词指南Control-file keyword guide
按模型用途查找关键词,逐项查看语法、参数作用和源码限制。Browse by model role and inspect syntax, parameter effects and source-level limitations.完整文字清单Full reference
时间与历表Time and ephemerides
指定时间转换所需的闰秒数据和太阳系天体历表。
Specify leap-second data for time conversion and Solar-system ephemerides.
LEAP_SECOND: 解析支持Parsed
指定 UTC 与 TAI 转换所需的闰秒信息来源。
Specify the source of leap-second information for UTC–TAI conversion.
LEAP_SECOND: (<file> | NERS)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已有的 LEAP_SECOND 格式文件。An existing file in LEAP_SECOND format. |
NERS | 通过 NERS 获取闰秒数据。Use the NERS mechanism to obtain leap-second information. |
无 NONE。NERS 是保留值,不按普通文件名处理;能否取得数据取决于 NERS 的安装和配置。
NONE is not supported. NERS is a reserved value, not an ordinary filename; data availability depends on the NERS installation and configuration.
VTD%CONF%FINAM_LEAPSEC
DE_EPHEMERIDES: 解析支持Parsed
指定太阳系天体历表,为相对论时延、潮汐等计算提供地球、太阳、月球等天体的位置和速度。
Specify Solar-system ephemerides providing positions and velocities for Earth, the Sun, the Moon and other bodies, for relativistic delay and tide calculations.
DE_EPHEMERIDES: <file>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | VTD 历表读取程序支持的 DE 历表文件。A DE ephemeris file supported by the VTD reader. |
无 NONE。旧网页中的 DE403_EPHEMERIDES: 不是本版解析器接受的关键词;也不能据本关键词名推断任意 JPL 文件格式都能直接读取。
NONE is not supported. The old DE403_EPHEMERIDES keyword is not accepted by this parser. The generic keyword name does not imply support for every JPL file format.
VTD%CONF%FINAM_DE_EPH
测站坐标与位置变化Stations and position variations
测站基础坐标、速度和偏心向量,与可按索引叠加的位置变化模型。
Reference station coordinates, velocities and eccentricities, plus indexed position-variation contributions.
STATION_DESCRIPTION: 解析支持Parsed
指定测站与天线的基本信息文件,包括测站名称、天线座架类型、轴线偏差等,供测站识别和天线几何模型计算使用。
Specify the station and antenna description file. It provides station names, mount types and axis offsets for station matching and antenna geometry.
STATION_DESCRIPTION: <file>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已有的 STADESC 格式文件;应覆盖参与计算的测站。An existing STADESC file covering the stations used in the calculation. |
没有关闭选项;NONE 在此会被当作文件名检查。天线座架类型指地平式(方位—俯仰)、赤道式等轴系形式;轴线偏差指两条旋转轴线不相交时的最短距离。本文件不提供测站三维坐标,坐标由 STATION_COORDINATES 指定。
There is no disabling value: NONE is treated as a filename. Mount type denotes the axis arrangement, such as alt-azimuth or equatorial. Axis offset is the shortest distance between the two non-intersecting rotation axes. Station coordinates are supplied separately by STATION_COORDINATES.
VTD%CONF%FINAM_STADESC
STATION_COORDINATES: 解析支持Parsed
指定测站在地固系中的参考坐标及其参考历元。
Specify reference station coordinates in the terrestrial frame and their reference epochs.
STATION_COORDINATES: <file>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已有的测站坐标文件,支持 GETPAR_STA、SIT-MODFILE 等读取程序认可的格式。An existing coordinate file in a format recognized by the reader, including GETPAR_STA and SIT-MODFILE. |
无 NONE。坐标、速度、偏心向量和随时间变化的位置改正是不同输入,不能互相替代。
NONE is not supported. Coordinates, velocities, eccentricity vectors and time-dependent position corrections are separate inputs.
VTD%CONF%FINAM_STACOO
STATION_VELOCITIES: 解析支持Parsed
指定测站速度,用于将参考历元的坐标推算到计算历元。
Specify station velocities for propagating reference coordinates to the calculation epoch.
STATION_VELOCITIES: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 测站速度文件,支持 GETPAR_VEL、VEL-MODFILE。A station velocity file in GETPAR_VEL or VEL-MODFILE format. |
NONE | 不读取速度文件。Do not read a velocity file. |
速度的单位依数据文件格式解释;此关键词的值本身是文件名,不是速度数值。
Units are defined by the data-file format. The value of this keyword is a filename, not a numerical velocity.
VTD%CONF%FINAM_STAVEL
STATION_ECCENTRICITIES: 解析支持Parsed
指定测站坐标所对应的地面标志点到天线参考点的偏心向量,以及该向量的有效时段。
Specify eccentricity vectors from the coordinate monument to the antenna reference point, together with their validity intervals.
STATION_ECCENTRICITIES: <file>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 ECC 格式测站偏心数据文件。An existing eccentricity file in ECC format. |
无 NONE。偏心向量不能与天线固定轴和活动轴之间的轴线偏差混为一谈。
NONE is not supported. A monument-to-antenna eccentricity is distinct from the offset between the fixed and moving antenna axes.
VTD%CONF%FINAM_STAECC
POSVAR_FIL: 解析支持Parsed
指定第 i 项测站位置变化数据。可用于潮汐或非潮汐负荷、测站位置的非线性变化等,不同项可分别配置。
Specify station-position variation dataset i, for example loading or other nonlinear position changes. Separate contributions can have separate entries.
POSVAR_FIL: NONE声明不配置该类位置变化条目。
Declare no position-variation entry of this kind.
POSVAR_FIL: <i> <path>i 为 1–16;同一索引的四项应成套设置。
i is 1–16; supply all four entries for the same index.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
i <path> | i 为 1–16 的整数。按 POSVAR_MOD 的选择,填写周期项模型文件、B 样条模型文件,或 BINDISP 位移时间序列的文件夹路径。i is an integer from 1 to 16. The path is a harmonic or B-spline model file, or a BINDISP time-series directory, depending on POSVAR_MOD. |
同一 i 的四个关键词应成套提供。使用连续编号最清楚;不要把 NONE 与已配置的索引条目混写,NONE 分支并不逐项清除先前数据。
Supply all four POSVAR keywords for each index. Consecutive numbering is clearest. Do not mix NONE with indexed entries: the NONE branch does not clear previously configured array elements.
VTD%CONF%POSVAR_FIL
POSVAR_MOD: 解析支持Parsed
选择第 i 项测站位置变化的数据模型。
Select the data model for station-position variation contribution i.
POSVAR_MOD: NONE声明不配置该类位置变化条目。
Declare no position-variation entry of this kind.
POSVAR_MOD: <i> (HARMONIC_MODEL | TIME_SERIES | B_SPLINE)i 为 1–16;同一索引的四项应成套设置。
i is 1–16; supply all four entries for the same index.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
i HARMONIC_MODEL | 采用 HARPOS 周期项模型,根据各项的频率、振幅和相位计算测站位移。Evaluate a HARPOS harmonic model from its frequencies, amplitudes and phases. |
i TIME_SERIES | BINDISP 格式的测站位移时间序列,使用 POSVAR_INT 指定插值方式。Use a BINDISP position-displacement time series and the POSVAR_INT interpolation method. |
i B_SPLINE | 用文件提供的 B 样条表示计算位移。Evaluate the B-spline representation supplied in a model file. |
i 为 1–16,与其他 POSVAR 条目一致。文档中偶见的 HARMONIC_MODE 少了末尾 L,不是合法值。
i must be 1–16 and match the other POSVAR entries. HARMONIC_MODE, without the final L, is not accepted.
VTD%CONF%POSVAR_MOD
POSVAR_INT: 解析支持Parsed
选择第 i 项位置变化时间序列的插值方法。
Select the interpolation method for position-variation time series i.
POSVAR_INT: NONE声明不配置该类位置变化条目。
Declare no position-variation entry of this kind.
POSVAR_INT: <i> (CLOSE_POINT | LINEAR | SPLINE)i 为 1–16;同一索引的四项应成套设置。
i is 1–16; supply all four entries for the same index.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
i CLOSE_POINT | 取时间上最近的数据点。Use the nearest sample in time. |
i LINEAR | 相邻历元间作线性插值。Interpolate linearly between neighboring epochs. |
i SPLINE | 作样条插值。Use spline interpolation. |
i 为 1–16。该设置主要作用于 TIME_SERIES;周期项模型直接求值,B 样条模型按自身系数求值。不要把它解释为所有模型都会重新做一次所选插值。
i is 1–16. This primarily affects TIME_SERIES. Harmonic models are evaluated directly, and B-spline models use their own coefficients; this does not re-interpolate every model.
VTD%CONF%POSVAR_INT
POSVAR_USE: 解析支持Parsed
规定第 i 项位置变化模型缺少所需测站数据时的处理。
Specify how to handle missing station data in position-variation contribution i.
POSVAR_USE: NONE声明不配置该类位置变化条目。
Declare no position-variation entry of this kind.
POSVAR_USE: <i> (REQUIRED | IF_AVAILABLE)i 为 1–16;同一索引的四项应成套设置。
i is 1–16; supply all four entries for the same index.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
i REQUIRED | 要求该模型提供所需测站数据;缺失时作为错误处理。Require data for the relevant stations; missing data are an error. |
i IF_AVAILABLE | 有相应测站数据时使用;没有时允许不应用该项。Use the model where station data are available; otherwise allow this contribution to be omitted. |
i 为 1–16。IF_AVAILABLE 不代表损坏文件、错误格式或任意读取失败都应被忽略。
i is 1–16. IF_AVAILABLE does not mean that malformed files or arbitrary read failures are ignored.
VTD%CONF%POSVAR_USE
射电源与太阳系内天体Radio sources and Solar-system bodies
设置射电源坐标、视差、自行、结构及系统偏差改正;太阳系内自然天体和人造天体的近场计算另需轨道数据。
Configure source coordinates, parallaxes, proper motions, structure and systematic-bias corrections; near-field calculations for natural and artificial Solar-system bodies also require orbit data.
SOURCE_COORDINATES: 解析支持Parsed
指定第 1 份射电源表,提供射电源坐标或名称、类型等识别信息。
Specify the first source-coordinate or source-identification catalogue.
SOURCE_COORDINATES: <file>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | VTD 支持的射电源表,如 GETPAR_SOU、SOU-MODFILE、SOURCE-NAMES 系列格式。A catalogue recognized by the reader, including GETPAR_SOU, SOU-MODFILE and SOURCE-NAMES variants. |
无 NONE。四份射电源表按第 1 至第 4 份顺序读取;同一源在后续文件中的记录可覆盖先前记录。对于太阳系内天体,还需结合目标类型和轨道数据进行计算。
NONE is not supported. Catalogues 1 through 4 are processed in order, and later records for the same source can replace earlier records. This is not a first-match lookup. Near-field sources also depend on their object types and orbit files.
VTD%CONF%FINAM_SOUCOO
SOURCE_COORDINATES_2ND: 解析支持Parsed
指定第 2 份射电源表。
Specify source catalogue 2.
SOURCE_COORDINATES_2ND: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 读取第 2 份射电源表,支持的格式与第 1 份相同。Read catalogue 2, using the same supported formats as the first catalogue. |
NONE | 不使用第 2 份射电源表。Do not use catalogue 2. |
后续文件既可补充新的射电源,也可覆盖前面文件中同名源的坐标或其他信息。
This is not merely a fallback catalogue: a later record for an already encountered source can replace its coordinates or source information.
VTD%CONF%FINAM_SOUCOO
SOURCE_COORDINATES_3RD: 解析支持Parsed
指定第 3 份射电源表。
Specify source catalogue 3.
SOURCE_COORDINATES_3RD: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 读取第 3 份射电源表,支持的格式与第 1 份相同。Read catalogue 3, using the same supported formats as the first catalogue. |
NONE | 不使用第 3 份射电源表。Do not use catalogue 3. |
后续文件既可补充新的射电源,也可覆盖前面文件中同名源的坐标或其他信息。
This is not merely a fallback catalogue: a later record for an already encountered source can replace its coordinates or source information.
VTD%CONF%FINAM_SOUCOO
SOURCE_COORDINATES_4TH: 解析支持Parsed
指定第 4 份射电源表。
Specify source catalogue 4.
SOURCE_COORDINATES_4TH: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 读取第 4 份射电源表,支持的格式与第 1 份相同。Read catalogue 4, using the same supported formats as the first catalogue. |
NONE | 不使用第 4 份射电源表。Do not use catalogue 4. |
后续文件既可补充新的射电源,也可覆盖前面文件中同名源的坐标或其他信息。
This is not merely a fallback catalogue: a later record for an already encountered source can replace its coordinates or source information.
VTD%CONF%FINAM_SOUCOO
SOURCE_PRLX_PRP_MOTION: 解析支持Parsed
指定射电源的视差、自行及参考历元数据。
Specify source parallax and proper-motion data for sources with known distance and motion.
SOURCE_PRLX_PRP_MOTION: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 读取源视差、自行及相关参考历元的数据文件。Read the additional parallax, proper-motion and reference-epoch data file. |
NONE | 不读取这类附加数据。Do not read these additional data. |
它是对射电源表的补充;各数值的单位与记录格式由该数据文件的读取程序规定。
This supplements the source catalogue. Units and record structure are defined by the corresponding file reader.
VTD%CONF%FINAM_SOUPRL_PRP
DIR_NZO: 解析支持Parsed
指定太阳系内天体的轨道数据文件夹,用于自然天体和人造天体的近场时延计算。
Specify the orbit-data directory for Solar-system bodies, including natural and artificial bodies, used in near-field delay calculations.
DIR_NZO: (<directory> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<directory> | 已存在的轨道数据文件夹路径;程序按射电源表中的目标名称和类型查找轨道。An existing orbit directory, searched using object names and types from the source catalogue. |
NONE | 不指定太阳系内天体的轨道数据文件夹。Do not specify a near-field orbit directory. |
“近场”在这里表示计算中需要考虑目标的有限距离,主要涉及太阳系内自然天体及人造卫星、空间探测器等人造天体。仓库文档列出 NZO、CCSDS 轨道消息、TLE 和 SP3 等输入格式;具体支持情况以轨道读取程序为准。设置此路径并不会改变射电源表中记录的目标类型。
Near-field here means that the finite distance of the target must be considered. Typical targets are natural Solar-system bodies, artificial satellites and spacecraft. The repository documentation lists NZO, CCSDS orbit messages, TLE and SP3; actual support is determined by the orbit readers. Setting this path does not change the object types in the source catalogue.
VTD%CONF%DIR_NZO
SOURCE_STRUCTURE: 解析支持Parsed
指定射电源结构模型的控制文件,用于计算源结构引起的时延等改正。
Specify the dedicated control file for source-structure delay contributions.
SOURCE_STRUCTURE: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 读取源结构控制文件;由其关联源、频段和结构数据。Read the structure control file, which associates sources, bands and structure data. |
NONE | 不加载源结构模型。Do not load a source-structure model. |
这里通常填写控制文件,不是直接填写一张 FITS 图像。旧文档的 NO 不是本版关闭值。
Supply a control file rather than an individual FITS image. NO in the old documentation is not the disabling value accepted here.
VTD%CONF%FINAM_STRUC
SOU_DEBIAS_MODEL: 解析支持Parsed
选择射电源坐标系统偏差改正模型。程序根据经验模型给出的赤经或赤纬偏差,计算对应的时延和时延率改正。
Select an empirical model of systematic source-coordinate biases. Right-ascension or declination biases are converted into delay and delay-rate corrections using the corresponding partial derivatives.
SOU_DEBIAS_MODEL: <value>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 不计算射电源坐标系统偏差改正。Do not apply empirical source-position debiasing. |
NO | 与 NONE 相同,是计算程序接受的另一关闭值。A disabling alias also accepted by the computation routine. |
MAP_780N | 采用 MAP_780N 的三次 B 样条系数,计算随源赤纬变化的赤纬偏差。Select the ARG_NOD_MAP_780N / SPL_NOD_MAP_780N cubic B-spline table for declination bias as a function of declination. |
MAP_780S | 采用 MAP_780S 的独立样条系数,计算赤纬偏差。Select the independent MAP_780S declination-bias spline table. |
MAP_780A | 采用 MAP_780A 的独立样条系数,计算赤纬偏差。Select the independent MAP_780A declination-bias spline table. |
MOD_850N | 采用 MOD_850N 的独立样条系数,计算赤纬偏差。Select the independent MOD_850N declination-bias spline table. |
MOD_850S | 采用 MOD_850S 的独立样条系数,计算赤纬偏差。Select the independent MOD_850S declination-bias spline table. |
MOD_750R | 采用 MOD_750R 的独立样条系数,计算赤纬偏差。Select the independent MOD_750R declination-bias spline table. |
MOD_850A | 采用 MOD_850A 的独立样条系数,计算赤纬偏差。Select the independent MOD_850A declination-bias spline table. |
MOD_900A | 采用 MOD_900A 的两组样条系数,分别计算赤经和赤纬偏差。Select the 900A tables for both right-ascension and declination biases. |
MOD_900R | 采用 MOD_900R 的两组样条系数,分别计算赤经和赤纬偏差。Select the 900R tables for both right-ascension and declination biases. |
1MAS | 测试选项:计算赤纬增加 1 毫角秒(mas)所对应的时延和时延率改正。Test option: delay and delay-rate corrections corresponding to a +1 mas declination bias. |
10MAS | 测试选项:计算赤纬增加 10 毫角秒(mas)所对应的时延和时延率改正。Test option: delay and delay-rate corrections corresponding to a +10 mas declination bias. |
VTD_CONF 只保存模型名称,不检查具体取值;上表列出 VTD_SOU_DEBIAS 实际识别的名称。
MAP/MOD 模型使用源码内置的三次 B 样条系数,按源赤纬求值,再除以有效频率的平方。1MAS 和 10MAS 直接采用指定的赤纬偏差,用于测试。程序先检查观测类型和有效频率,不满足条件时直接返回,因此并非所有观测都会应用改正。
这些改正通过时延对源坐标的偏导数计入理论时延及其变化率,不会直接改写输入射电源表。模型名称中的数字和 N/S/A/R 是内置模型标识,不能据名称自行解释为可调高度等参数。精确定义以源码中的节点和系数表为准;不要使用文档误写的 MAP_850N 等名称。
VTD_CONF stores the name without validating the model. The table lists names recognized by VTD_SOU_DEBIAS.
MAP/MOD models evaluate built-in cubic B-splines at the source declination and divide the result by the effective frequency squared. 1MAS and 10MAS use the specified declination biases for testing. Observable-type and effective-frequency checks can return before a correction is applied.
Corrections enter the theoretical delay and delay rate through source-coordinate partial derivatives; the input source catalogue is not rewritten. Digits and N/S/A/R are built-in model identifiers, not freely adjustable height parameters. The node and coefficient tables define the models precisely. Do not use misspellings such as MAP_850N.
VTD%CONF%SOU_DEBIAS_MODEL
GALACTIC_ABERRATION: 解析支持Parsed
控制是否计入银河系光行差:太阳系质心绕银心运动的向心加速度引起射电源视方向的长期变化,进而影响理论时延。
Control the long-term source-direction change and delay contribution caused by acceleration of the Solar system toward the Galactic center.
GALACTIC_ABERRATION: (YES | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
YES | 计算银河系光行差引起的时延改正。Calculate the Galactic-aberration contribution. |
NONE | 不计算银河系光行差改正。Do not calculate this contribution. |
本版 VTD_GAL_ABR 的加速度常量为 2.531×10⁻¹⁰ m/s²,并相对源参考历元计算。它不是视差角 PARALLACTIC_ANGLE;文档中两者有复制文字错误。
This VTD_GAL_ABR implementation uses 2.531×10⁻¹⁰ m/s² and computes the change relative to the source reference epoch. It is distinct from PARALLACTIC_ANGLE; parts of the documentation contain copied text confusing the two.
VTD%CONF%GAL_ABR
地球定向与自转Earth orientation and rotation
配置地球定向参数(EOP)、地球自转先验模型(AEM)、地球自转经验模型(ERM)、地球定向周期项模型(HEO)以及岁差、章动模型,用于计算地固系到空固系的变换。
Configure Earth orientation parameters (EOP), the a priori Earth rotation model (AEM), the empirical Earth rotation model (ERM), harmonic Earth orientation (HEO), precession and nutation to calculate the terrestrial-to-celestial transformation.
EOP_SERIES: 解析支持Parsed
指定地球定向参数(EOP)时间序列,提供极移、UT1 等数据。
Specify the source of time series for polar motion, UT1 and other Earth orientation parameters.
EOP_SERIES: (<file> | NERS | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | EOP 序列文件;读取程序也能识别相应 NERS 配置输入。An EOP time-series file; the reader can also recognize the relevant NERS configuration input. |
NERS | 采用 NERS 的默认配置及数据机制。Use the default NERS configuration and data mechanism. |
NONE | 不读取常规 EOP 时间序列文件;须提供所选地球自转计算方法需要的其他数据。Do not read a conventional EOP series; provide other inputs consistent with the selected Earth rotation path. |
EOP 时间序列、地球自转先验模型(AEM)、地球自转经验模型(ERM)及地球定向周期项模型(HEO)分别提供不同信息;应按照实际采用的地球自转计算方法配套配置。
Conventional EOP series and the AEM, ERM and harmonic models have distinct roles. Their settings must form a consistent combination.
VTD%CONF%FINAM_EOP
EOP_TIME_SCALE: 解析支持Parsed
声明 EOP 序列历元采用的时间尺度。
Declare the time scale of epochs in the EOP input series.
EOP_TIME_SCALE: <value>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
TAI | 国际原子时。International Atomic Time. |
TDT | 地球力学时,现称地球时(TT);控制文件仍使用旧标识 TDT。Terrestrial Dynamical Time, the older name corresponding to TT. |
TDB | 质心力学时,指太阳系质心参考系使用的这一时间尺度。Barycentric Dynamical Time. |
UTC | 协调世界时。Coordinated Universal Time. |
UT1 | 世界时 UT1。Universal Time UT1. |
NERS | 解析时按 TAI 处理。Parsed as TAI. |
NONE | 不为常规 EOP 序列指定时间尺度;只在此前已经配置非空 AEM_FILE 时接受。No conventional EOP time scale; accepted only when a preceding AEM_FILE has supplied a nonempty filename. |
这是输入 EOP 序列的时间尺度,不能据此改变 VTD 其他 API 参数所要求的时间尺度。
This describes the EOP input epochs. It does not change the time scales required by other VTD API arguments.
VTD%CONF%EOP_TIME_SCALEVTD%CONF%FINAM_AEM
AEM_FILE: 解析支持Parsed
指定地球自转先验模型(AEM)文件,给出岁差、主要章动项和绕地轴自转等基本旋转。
Specify an a priori Earth rotation model describing large-angle terms such as precession, major nutation and axial rotation.
AEM_FILE: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 AEM 格式文件,用作经验地球自转计算方法中的先验模型。An existing AEM file enabling the corresponding empirical Earth rotation path. |
NONE | 不读取 AEM 文件,采用其他已配置的地球自转计算方法。Do not provide an AEM file; use another configured rotation path. |
AEM 中的参数属于不能忽略其高阶项的大角度量;小的缓变改正和周期性改正分别由 ERM 与 HEO 模型提供。若设置 EOP_TIME_SCALE: NONE,本关键词必须先出现,并且已给出非空 AEM 文件名。
AEM describes large-angle parameters whose higher-order terms cannot be neglected. ERM and HEO supply small slowly varying and periodic corrections, respectively. For EOP_TIME_SCALE: NONE, AEM_FILE must already have supplied a nonempty filename.
VTD%CONF%FINAM_AEM
ERM_FILE: 解析支持Parsed
指定地球自转经验模型(ERM)文件,以 B 样条描述相对于先验模型的缓慢变化小量。
Specify the empirical model of small, slowly varying Earth rotation perturbations.
ERM_FILE: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 包含地球自转扰动矢量 B 样条系数的 ERM 文件。An ERM file containing B-spline coefficients of the perturbation vector. |
NONE | 不读取 ERM 文件。Do not read an ERM file. |
地球自转先验模型(AEM)给出基本旋转;ERM 给出缓慢变化的小改正;地球定向周期项模型(HEO)给出周期性小改正。
AEM supplies the large-angle rotation, ERM supplies slowly varying corrections, and the harmonic EOP file supplies periodic corrections.
VTD%CONF%FINAM_ERM
HARMONIC_EOP_FILE: 解析支持Parsed
指定地球定向周期项模型(HEO)文件,用于计算相对于地球自转先验模型的周期性小改正。
Specify harmonic Earth orientation corrections describing periodic perturbations to the underlying rotation model.
HARMONIC_EOP_FILE: (<file> | NONE | NERS)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 读取 HEO 格式的地球定向周期项模型文件。Read a HEO harmonic Earth orientation model. |
NONE | 不读取外部地球定向周期项模型文件。Do not use an external harmonic file. |
NERS | 通过 NERS 获取地球定向的周期性改正。Obtain the relevant harmonic Earth orientation information through NERS. |
模型以正弦、余弦项之和表示周期性变化,并可包含振幅和相位的缓慢变化。它与 EOP 时间序列、AEM 地球自转先验模型、ERM 地球自转经验模型的作用不同,是否叠加由所选计算方法决定。
The model represents periodic variations as a sum of sine and cosine terms, allowing slowly varying amplitudes and phases. Its role differs from EOP time series, the AEM a priori rotation and ERM empirical corrections; combination depends on the selected calculation path.
VTD%CONF%FINAM_HEO
UZT_MODEL: 解析支持Parsed
选择带谐潮引起的 UT1 变化模型。
Select the model of UT1 variations caused by zonal tides.
UZT_MODEL: <value>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 不计算单独的带谐潮 UT1 模型。Do not calculate a separate zonal-tide UT1 model. |
NERS | 在本关键词中等价于 NONE,避免另外加入一套带谐潮模型。Equivalent to NONE for this keyword, avoiding an additional zonal-tide model. |
DICKMAN1993 | Dickman 1993 模型,使用完整项集。Use the full Dickman 1993 term set. |
DICKMAN1993_PRINCIPAL | Dickman 模型的主项及另 14 个较大的 UT1 角速度项;文档阈值为 1.0D-14 rad/s。Use the principal Dickman term and 14 additional large UT1 angular-velocity terms; the documented threshold is 1.0D-14 rad/s. |
DICKMAN1993_SHORT | Dickman 模型中周期短于 60 天的项。Use Dickman terms with periods shorter than 60 days. |
RE2014 | Ray–Erofeeva 2014 模型,使用完整项集。Use the full Ray–Erofeeva 2014 term set. |
RE2014_SHORT | RE2014 模型中周期短于 35 天的项。Use RE2014 terms with periods shorter than 35 days. |
本项决定用哪个模型;模型怎样与 EOP 序列组合,由 UZT_USE 决定。
This selects the model; UZT_USE determines how it is combined with the EOP series.
VTD%CONF%UZT_MODEL
UZT_USE: 解析支持Parsed
决定所选带谐潮 UT1 模型在 EOP 插值和最终计算中的用法。
Select how the zonal-tide UT1 model is used during EOP interpolation and final evaluation.
UZT_USE: <value>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 不施加该项。Do not apply this contribution. |
NERS | 等价于 NONE。Equivalent to NONE. |
ADD | 把模型项加到先验 UT1 中。Add the model contribution to a priori UT1. |
SUBTRACT | 从先验 UT1 中减去模型项。Subtract the model contribution from a priori UT1. |
INTERPOLATE | 插值前从序列扣除模型项,插值后再恢复,减少高频潮汐对稀疏 EOP 插值的影响。Remove the model before interpolating the series and restore it afterward, reducing the effect of high-frequency tides on sparse EOP interpolation. |
选择取决于输入 UT1 序列是否已经含有相应潮汐;应避免重复加入或重复去除。
The choice depends on whether the input UT1 series already includes the relevant tide terms. Avoid adding or removing them twice.
VTD%CONF%UZT_USE
EROT_COMPAT: 解析支持Parsed
设置地球自转矩阵计算中的兼容选项或试验选项。
Control compatibility or experimental processing of the Earth rotation matrix.
EROT_COMPAT: (NONE | NERS | CALC10 | NO_SARG)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 使用 VTD 的通常矩阵组合。Use the normal VTD matrix composition. |
NERS | 本关键词中映射为 NONE。Maps to NONE for this keyword. |
CALC10 | 采用为与 CALC 10 比较而设置的兼容处理。Use compatibility processing intended for comparison with CALC 10. |
NO_SARG | 把恒星时旋转角 S_ANG 及其导数置零,属于特殊试验设置。Set the sidereal rotation angle S_ANG and its derivative to zero; an experimental setting. |
正确拼写是 NO_SARG;文档的 NO_SANG 不会被接受。NO_SARG 会改变实际旋转矩阵,不是单纯不输出某个角。
The accepted spelling is NO_SARG, not the documented NO_SANG. NO_SARG changes the rotation matrix; it does not merely suppress an output angle.
VTD%CONF%EROT_COMPAT
PRECESSION_EXPRESSION: 解析支持Parsed
选择岁差表达式,参与地固系到空固系的变换。
Select the precession expression used in the terrestrial-to-celestial transformation.
PRECESSION_EXPRESSION: <value>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
LIESKE_1977 | Lieske 等 1977 岁差表达式。Lieske et al. 1977 precession expression. |
SIMON_1994 | Simon 等 1994 岁差参数。Simon et al. 1994 precession parameters. |
IERS_1996 | IERS 1996 采用的参数表达式。Parameter expression adopted by IERS 1996. |
CAPITAINE_2003 | Capitaine 等 2003 表达式。Capitaine et al. 2003 expression. |
CAPITAINE_2005 | Capitaine 等 2005 表达式。Capitaine et al. 2005 expression. |
NONE | 不由此选项单独计算岁差,通常由 AEM 地球自转先验模型提供相应部分。No separate precession term through this option, normally used with the AEM path. |
NERS | NERS 配套设置;VTD_ERM_NA 内部将此代码归入 CAPITAINE_2003 的系数分支。NERS-associated setting; VTD_ERM_NA groups this code with the CAPITAINE_2003 coefficient branch. |
NONE 不应被理解为任何计算流程下地球都“没有岁差”:AEM 可以已经包含相应旋转。
NONE does not mean that every calculation path omits physical precession: AEM may already include the corresponding rotation.
VTD%CONF%PREC_EXP
NUTATION_EXPANSION: 部分选项受限Some options limited
选择章动展开及其计算流程。
Select the nutation expansion and its computation path.
NUTATION_EXPANSION: <value>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
WAHR1980 | Wahr 1980 章动模型。Wahr 1980 nutation model. |
IERS1996 | IERS 1996 章动展开。IERS 1996 nutation expansion. |
REN2000 | REN2000 刚性地球章动展开。REN2000 rigid-Earth nutation expansion. |
MHB2000 | Mathews–Herring–Buffett 2000 非刚性地球章动模型。Mathews–Herring–Buffett 2000 nonrigid-Earth nutation model. |
MHB2000_TRANSF | 通过传递函数实现的 MHB2000 相关计算。MHB2000-related computation implemented through a transfer function. |
MHB2000_ADDON | 解析器保留的 MHB2000 附加项选项;通常地球自转计算分支不支持,见下述限制。A parser-retained MHB2000 add-on option, unsupported in the usual downstream rotation branch. |
NUT__PETA | HEO_EMPI 的 A 型简化展开,保留主要顺行、逆行及逆行半年项。HEO_EMPI type A: a three-term simplified expansion containing the major prograde and retrograde terms and the retrograde semiannual term. |
NUT__PETB | HEO_EMPI 使用 heo_08d 的 71 项系数表,并作其规定的岁差率、黄赤交角率及偏置处理。HEO_EMPI uses the 71-term heo_08d table and its prescribed precession-rate, obliquity-rate and offset corrections. |
NUT__PETC | HEO_EMPI 使用 REN2000 相关的 4 项系数表;与 A 型的振幅等参数不同,且不作 B 型的同一组经验偏置处理。HEO_EMPI uses a four-term REN2000-related table with amplitudes different from type A, without the same empirical offsets as type B. |
NONE | 不通过该选项提供独立章动项,通常配合 AEM 路径。No separate nutation term through this option, normally used with AEM. |
NERS | 通过 NERS 获取章动角及其变化率。Obtain nutation angles and rates from NERS. |
实现限制: MHB2000_ADDON 会被 VTD_CONF 接受,但 VTD_ERM_NA 的实际分支没有相应处理,会进入未知章动代码错误。三个 NUT__PET 选项的精确定义应以 heo_empi.f 及其系数表为准,不宜仅凭字母猜测物理模型。
Implementation limit: VTD_CONF accepts MHB2000_ADDON, but VTD_ERM_NA has no corresponding computation branch and reports an unknown nutation code. The precise NUT__PET definitions are given by heo_empi.f and its coefficient tables; the letters alone do not define a standard physical model.
VTD%CONF%NUT_EXP
GEODESIC_NUTATION: 解析支持Parsed
控制是否单独加入测地章动项。
Control the additional geodesic-nutation contribution.
GEODESIC_NUTATION: (YES | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
YES | 计算并加入测地章动项。Calculate and add geodesic nutation. |
NONE | 不另加测地章动项。Do not add a separate geodesic-nutation term. |
要与所用主章动模型的定义一致,避免重复加入已包含的项。
Keep this consistent with the definition of the main nutation model to avoid adding an included contribution twice.
VTD%CONF%NUT_GDS
固体潮与极潮Solid Earth and pole tides
选择测站潮汐位移的响应模型,以及零频潮和平均极约定。
Select tidal displacement responses, the zero-frequency tide convention and the mean pole.
SOLID_EARTH_TIDES_2ND_DEGREE: 解析支持Parsed
选择二阶固体潮的 Love 数与响应模型。
Select Love numbers and the response model for degree-2 solid Earth tides.
SOLID_EARTH_TIDES_2ND_DEGREE: <value>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
MDG97EL | Mathews–Dehant–Gipson 1997 弹性地球响应。Mathews–Dehant–Gipson 1997 elastic-Earth response. |
MDG97AN | MDG97 非弹性地球响应。MDG97 anelastic-Earth response. |
DDW99EH | Dehant–Defraigne–Wahr 1999 弹性、流体静力平衡模型。Dehant–Defraigne–Wahr 1999 elastic, hydrostatic-equilibrium model. |
DDW99IN | DDW99 非弹性、非流体静力平衡模型。DDW99 inelastic, nonhydrostatic-equilibrium model. |
LOVE | Love 1923 模型。Love 1923 model. |
MATHEWS_2000 | Mathews 2000 模型。Mathews 2000 model. |
MATHEWS_2001 | Mathews 2001 模型。Mathews 2001 model. |
NONE | 该项的 Love 数取零,不计算其位移响应。Set Love numbers for this contribution to zero, suppressing its displacement response. |
此处“二阶”对应球谐展开中的 degree 2,表示引潮位展开的相应部分。
Degree 2 is the spherical-harmonic degree; it does not mean squaring the displacement.
VTD%CONF%STD_2ND_MODEL
SOLID_EARTH_TIDES_3RD_DEGREE: 解析支持Parsed
选择三阶固体潮响应。
Select the degree-3 solid Earth tide response.
SOLID_EARTH_TIDES_3RD_DEGREE: (MDG97 | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
MDG97 | 使用 MDG97 三阶潮汐 Love 数。Use MDG97 degree-3 Love numbers. |
NONE | 三阶潮汐 Love 数取零。Set degree-3 Love numbers to zero. |
VTD%CONF%STD_3RD_MODEL
SOLID_EARTH_TIDES_ZERO_FREQ: 解析支持Parsed
选择固体潮零频分量的响应,关系到永久潮的处理约定。
Select the zero-frequency solid Earth tide response, which affects the permanent-tide convention.
SOLID_EARTH_TIDES_ZERO_FREQ: (ZERO | MDG97AN | FLUID)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
ZERO | 零频 Love 数取零,不加入对应的永久变形。Set zero-frequency Love numbers to zero, omitting the associated permanent deformation. |
MDG97AN | 采用 MDG97 非弹性模型的零频响应。Use the MDG97 anelastic zero-frequency response. |
FLUID | 采用流体地球的零频 Love 数。Use fluid-Earth zero-frequency Love numbers. |
本关键词没有 NONE,关闭值必须写 ZERO。永久潮约定应与测站坐标系统相容。
NONE is not accepted: use ZERO to suppress this response. The permanent-tide convention must be consistent with the station coordinates.
VTD%CONF%STD_ZF_MODEL
POLE_TIDE_MODEL: 解析支持Parsed
选择极潮位移的响应模型,描述极移改变离心势造成的测站形变。
Select the pole-tide displacement response to changes in the centrifugal potential caused by polar motion.
POLE_TIDE_MODEL: <value>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
MDG97EL | Mathews–Dehant–Gipson 1997 弹性地球响应。Mathews–Dehant–Gipson 1997 elastic-Earth response. |
MDG97AN | MDG97 非弹性地球响应。MDG97 anelastic-Earth response. |
DDW99EH | Dehant–Defraigne–Wahr 1999 弹性、流体静力平衡模型。Dehant–Defraigne–Wahr 1999 elastic, hydrostatic-equilibrium model. |
DDW99IN | DDW99 非弹性、非流体静力平衡模型。DDW99 inelastic, nonhydrostatic-equilibrium model. |
LOVE | Love 1923 模型。Love 1923 model. |
MATHEWS_2000 | Mathews 2000 模型。Mathews 2000 model. |
MATHEWS_2001 | Mathews 2001 模型。Mathews 2001 model. |
NONE | 该项的 Love 数取零,不计算其位移响应。Set Love numbers for this contribution to zero, suppressing its displacement response. |
模型名称与二阶固体潮共用一套枚举,但作用于极潮;平均极的位置另由 MEAN_POLE_MODEL 控制。
The enumeration is shared with degree-2 solid tides but is applied to pole tides. MEAN_POLE_MODEL separately selects the mean pole.
VTD%CONF%PTD_MODEL
MEAN_POLE_MODEL: 解析支持Parsed
选择计算极潮所用的平均极模型。
Select the mean-pole model used for pole tides.
MEAN_POLE_MODEL: (NONE | IERS2010 | IERS2022)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 平均极坐标取零;不是关闭极潮。Set mean-pole coordinates to zero; this does not disable pole tides. |
IERS2010 | 采用源码的 IERS 2010 平均极表达式。Use the IERS 2010 expression implemented in the source. |
IERS2022 | 采用源码的 IERS 2022 平均极表达式。Use the IERS 2022 expression implemented in the source. |
是否计算极潮由 POLE_TIDE_MODEL 决定;此处改变的是从极移中扣除的平均极。
POLE_TIDE_MODEL controls whether pole tides are computed. This option changes the mean pole subtracted from polar motion.
VTD%CONF%MEAN_POLE_MODEL
天线与耦合项Antennas and coupling terms
设置天线形变、轴线偏差、相位中心偏移,以及大气传播与天线几何模型之间的耦合项。
Configure antenna deformation, axis offsets, phase-center offsets and coupling between atmospheric propagation and antenna geometry.
ANTENNA_DEFORMATIONS_FILE: 解析支持Parsed
指定天线重力形变模型文件,用于计算形变引起的信号传播时延改正。
Specify an antenna gravitational-deformation model file for computing the resulting signal-propagation delay correction.
ANTENNA_DEFORMATIONS_FILE: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 AGD 格式文件,记录各天线随仰角变化的重力形变模型数据。An existing AGD file describing elevation-dependent antenna deformation. |
NONE | 不加载天线重力形变模型。Do not load an antenna gravitational-deformation model. |
文件提供焦距变化随仰角的关系,VTD 对其插值并换算为时延改正。未列入文件的天线,其重力形变时延项取零。此项与固体潮位移、天线热膨胀分别处理。
The file supplies focal-length changes as a function of elevation. VTD interpolates them and converts them to delay corrections. An antenna absent from the file receives a zero gravitational-deformation delay contribution. Solid Earth tides and thermal expansion are handled separately.
VTD%CONF%FINAM_AGD
ANTENNA_THERMAL_EXPANSION: 含实现异常Implementation caveat
配置天线热膨胀模型、无需使用该模型的测站列表、温度数据来源及温度滞后时间。
Configure the antenna thermal-expansion model, in situ exclusion list, temperature source and temperature lag.
ANTENNA_THERMAL_EXPANSION: NONE不加载热膨胀模型。
Do not load a thermal-expansion model.
ANTENNA_THERMAL_EXPANSION: MODEL <anti_file> INSITU (<ahm_file> | NONE | NO) TEMPERATURE (METEO | SPD) LAG <seconds>按固定顺序写出全部子字段;不要把语法示意中的括号和竖线写入控制文件。
Supply every subfield in this fixed order; do not type the alternative notation into the control file.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
MODEL <anti_file> | ANTI 热形变参数文件,含结构尺寸、膨胀参数和参考温度。ANTI thermal-deformation file containing structural dimensions, expansion parameters and reference temperatures. |
INSITU <ahm_file> | 列出已有天线高度变化现场测量数据的测站;对这些测站不再使用常规热膨胀模型。实测位移须通过测站位置变化模型等方式另行输入。List of stations with in situ antenna-height measurements. Those stations skip the ordinary thermal model; measured displacements must be supplied separately through position-variation or another mechanism. |
INSITU NONE / NO | 不使用现场测量排除列表;NO 仅在这一子字段明确受支持。Do not use an in situ exclusion list; NO is explicitly supported in this subfield. |
TEMPERATURE METEO | 使用传入的有效现场温度 AIR_TEMP_EFF;本例程不会按 LAG 自动回溯现场温度序列。Use the supplied effective in situ temperature AIR_TEMP_EFF. This routine does not automatically apply LAG to an in situ temperature series. |
TEMPERATURE SPD | 从 SPD 地表温度时间序列插值,并按 LAG 回溯时间。Interpolate the SPD surface-temperature series at the epoch shifted backward by LAG. |
LAG <seconds> | 滞后时间,单位为秒,实数。使用显式小数点,如 7200.0;读取格式为 F15.5。Time lag in seconds, a real value. Include a decimal point, for example 7200.0; the read format is F15.5. |
实现问题: 温度来源的报错分支错误地再次判断 SPD,因此某些非法值未被拒绝;请只使用 METEO 或 SPD。是否检查 SPD 温度数据的可用性还受无关的 IER 条件控制,因此即使配置解析成功,也不能据此确认外部温度数据可用。
Implementation issues: the error branch for the temperature source repeats the SPD test, leaving some invalid values unreported. Use only METEO or SPD. An unrelated IER condition also gates the SPD-data dependency check, so successful configuration parsing does not prove that external temperature data are ready.
VTD%CONF%FINAM_ANTIVTD%CONF%FINAM_AHMVTD%CONF%ATHD_DATA_FROMVTD%CONF%ATHD_LAG
AXIS_OFFSET_MODEL: 解析支持Parsed
控制是否计算天线轴线偏差引起的几何时延,即天线两条旋转轴线不相交所产生的时延项。
Control geometric delay caused by nonintersecting fixed and moving antenna axes.
AXIS_OFFSET_MODEL: (YES | NONE | CALC9)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
YES | 采用 VTD 的常规天线轴线偏差时延模型。Use the normal VTD axis-offset treatment. |
NONE | 不计算天线轴线偏差时延项。Do not apply this axis-offset delay model. |
CALC9 | 采用用于复现 CALC 9 行为的兼容处理。Use compatibility processing intended to reproduce CALC 9 behavior. |
轴线偏差数值由 STATION_DESCRIPTION 指定的测站信息文件提供;本关键词只控制计算方式。与大气传播的耦合项由 TROP_AXOF_COUPLING 单独设置。
The offset value comes from the station description; this keyword selects the treatment. A separate keyword controls atmospheric coupling to the offset.
VTD%CONF%AXOF_MODEL
TROP_AXOF_COUPLING: 解析支持Parsed
控制是否计算大气传播与天线轴线偏差的耦合时延项。
Control the coupling contribution between atmospheric propagation and antenna axis offset.
TROP_AXOF_COUPLING: (YES | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
YES | 计算该耦合时延项。Calculate the coupling contribution. |
NONE | 不计算该耦合时延项。Do not calculate this coupling contribution. |
关闭值是 NONE,不是旧文档部分段落所写的 NO。
The disabling value is NONE, not the NO shown in parts of the old documentation.
VTD%CONF%TROP_AXOF_COUPL
TROP_GEOMETRIC_COUPLING: 解析支持Parsed
控制是否计算大气传播与几何时延的耦合项。
Control the coupling contribution between atmospheric delay and the geometric-delay expression.
TROP_GEOMETRIC_COUPLING: (YES | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
YES | 加入该耦合项。Include the coupling term. |
NONE | 不加入该耦合项。Omit the coupling term. |
不能把它当作总对流层时延开关。另受 PARALLACTIC_ANGLE: NONE 的赋值错误影响,见下一条。
This is not the total tropospheric-delay switch. It is also affected by the PARALLACTIC_ANGLE: NONE assignment defect.
VTD%CONF%TROP_GEOM_COUPL
PARALLACTIC_ANGLE: 含实现异常Implementation caveat
控制是否计入视差角变化对相位时延等量的影响。
Control the contribution of parallactic-angle rotation to phase delay and related quantities.
PARALLACTIC_ANGLE: (YES | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
YES | 设置 PARALLACTIC_ANGLE 为 YES,启用该项。Set PARALLACTIC_ANGLE to YES, enabling the contribution. |
NONE | 意图关闭该项,但当前错误地把 TROP_GEOM_COUPL 置为 NONE。Intended to disable it, but currently sets TROP_GEOM_COUPL to NONE instead. |
确定的赋值错误: NONE 分支没有给 PARALLACTIC_ANGLE 赋值,会意外关闭大气—几何耦合,并造成配置顺序依赖。若先设 YES 再设 NONE,后者也不能可靠撤销前者。
Confirmed assignment defect: the NONE branch does not assign PARALLACTIC_ANGLE. It unexpectedly disables atmospheric–geometric coupling and makes the outcome depend on ordering. A NONE entry following YES also fails to reliably undo that YES setting.
VTD%CONF%PARALLACTIC_ANGLEVTD%CONF%TROP_GEOM_COUPL
DIR_BTX: 含实现异常Implementation caveat
指定存放 BINTEX 格式天线相位中心偏移数据的文件夹,供相应地面天线和 GNSS 卫星模型使用。
Specify the directory of BINTEX binary antenna phase-center offset data for the relevant ground antennas and GNSS satellite models.
DIR_BTX: (<directory> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<directory> | 已存在的文件夹路径,其中包含 VTD 能够读取的 .btx 数据文件。An existing directory containing .btx files recognized by the reader. |
NONE | 配置层面表示不指定该文件夹。At the configuration level, do not specify this directory. |
实现不一致: VTD_CONF 把 NONE 清成空串,但 VTD_LOAD_STADESC、VTD_LOAD_NZO 的加载条件比较的是“不是字符串 NONE”。因此空串仍可能进入文件夹扫描;此处记录的是静态控制流风险,没有据此声称已经做过运行复现。旧名 PHASE_OFFSET_FILE 会被兼容预处理改写为 DIR_BTX。
Implementation inconsistency: VTD_CONF clears NONE to an empty string, whereas VTD_LOAD_STADESC and VTD_LOAD_NZO test for a value different from the literal NONE. The empty string can therefore still enter directory scanning. This is a static control-flow finding, not a reported runtime reproduction. The legacy PHASE_OFFSET_FILE name is preprocessed to DIR_BTX.
VTD%CONF%DIR_BTX
大气时延与偏导数Atmospheric delay and partials
分别设置先验大气传播时延模型,以及时延对待估大气参数的偏导数形式。
Configure the a priori atmospheric propagation delay and its partial derivatives with respect to estimated atmospheric parameters separately.
METEO_DEF: 含实现异常Implementation caveat
选择气象观测值缺失或超出合理范围时采用的替代气象模型。
Select the fallback meteorological model for missing or abnormal input data.
METEO_DEF: (IMA | CALC | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
IMA | 按源码给定的标准大气模型,用高程计算替代气压及相应温度。Use the standard-atmosphere height relationships implemented for pressure and the associated temperature. |
CALC | 采用 CALC 风格的默认气压高度关系,主要供兼容比较。Use a CALC-style default pressure–height relationship, primarily for compatibility comparisons. |
NONE | 按文档意图应不替换气象参数,但当前实现并不完全如此。Documented as preserving the input, but the current implementation does not fully do so. |
实际行为: VTD_TROPDEL 在气压超出合理范围时,仅区分 IMA 与其他值,故 NONE 也走 CALC 的气压替代分支。正常范围内的气压不受该回退逻辑改变。
Actual behavior: when pressure is outside its accepted range, VTD_TROPDEL distinguishes only IMA from other values. NONE therefore also takes the CALC pressure fallback. Pressure within the accepted range is not changed by this fallback logic.
VTD%CONF%METEO_DEF
HYDROSTATIC_ZENITH_DELAY: 部分选项受限Some options limited
选择先验天顶静力时延模型。
Select the a priori hydrostatic zenith-delay model.
HYDROSTATIC_ZENITH_DELAY: (SAASTAMOINEN | NONE)从下表选择一个值。
Select one value from the table.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
SAASTAMOINEN | 按气压、纬度与测站高程计算 Saastamoinen 天顶静力时延。Calculate Saastamoinen hydrostatic zenith delay from pressure, latitude and height. |
NONE | 此天顶静力时延项置零。Set this hydrostatic zenith-delay term to zero. |
HYDROSTATIC_ZENITH_DELAY: MMF <file>历史文件模式;加载阶段已禁用。
Historical file mode, disabled during loading.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
MMF <file> | 从历史 MMF 数据中取天顶静力时延;当前加载阶段禁用。Read hydrostatic zenith delay from historical MMF data; currently disabled during loading. |
SPD_3D 数据可在后续替换先验斜路径时延,所以此处 NONE 不等于整个模型没有大气时延。
SPD_3D may later replace the a priori slant delay. NONE here does not imply the absence of all atmospheric delay.
VTD%CONF%HZD_MODELVTD%CONF%FINAM_MMF
WET_ZENITH_DELAY: 部分选项受限Some options limited
指定先验天顶湿时延的来源。
Select the source of a priori wet, or nonhydrostatic, zenith delay.
WET_ZENITH_DELAY: (NONE)从下表选择一个值。
Select one value from the table.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 此独立天顶湿时延项置零。Set this separate wet zenith-delay term to zero. |
WET_ZENITH_DELAY: MMF <file>历史文件模式;加载阶段已禁用。
Historical file mode, disabled during loading.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
MMF <file> | 从历史 MMF 数据中取天顶湿时延;当前加载阶段禁用。Read wet zenith delay from historical MMF data; currently disabled during loading. |
没有 SAASTAMOINEN、NMFW 或 SPD 这些取值。设置 NONE 仍可通过 SPD_3D 提供总时延及水汽分量,也不妨碍估计残余天顶时延。
SAASTAMOINEN, NMFW and SPD are not values for this keyword. NONE still allows SPD_3D total and water-vapor delays and does not prevent estimation of a residual zenith-delay parameter.
VTD%CONF%WZD_MODELVTD%CONF%FINAM_MMF
HYDROSTATIC_MAPPING_FUNCTION: 部分选项受限Some options limited
选择静力映射函数,将天顶静力时延换算为观测方向上的斜路径时延。
Select the mapping function from hydrostatic zenith delay to slant delay.
HYDROSTATIC_MAPPING_FUNCTION: (NONE | NMFH)从下表选择一个值。
Select one value from the table.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 不通过此静力映射函数产生斜路径项。Do not produce a slant contribution through this hydrostatic mapping function. |
NMFH | Niell 1996 静力映射函数,使用历元、纬度、测站高程和仰角。Niell 1996 hydrostatic mapping, using epoch, latitude, height and elevation. |
HYDROSTATIC_MAPPING_FUNCTION: MMF <file>历史文件模式;加载阶段已禁用。
Historical file mode, disabled during loading.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
MMF <file> | 历史上的 Mean Mapping Function 文件模式。Historical Mean Mapping Function file mode. |
MMF 已被禁用: 解析器接受并检查文件存在,但 VTD_LOAD 明确报错 “obsolete, and it is disabled”。此限制也适用于其他三个带 MMF 的关键词。
MMF is disabled: parsing accepts the option and checks the file, but VTD_LOAD explicitly reports that MMF is obsolete and disabled. The same restriction affects the other three MMF-enabled keywords.
VTD%CONF%HMF_MODELVTD%CONF%FINAM_MMF
WET_MAPPING_FUNCTION: 部分选项受限Some options limited
指定湿映射函数选项,写入配置字段 WMF_MODEL;该字段在当前主计算流程中未被实际使用。
Set the WMF_MODEL wet-delay mapping field; the current main computation path has an implementation limitation.
WET_MAPPING_FUNCTION: (NONE | NMFW | NMFH | SPD | IONO_350 | IONO_400 | IONO_450 | IONO_500)从下表选择一个值。
Select one value from the table.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 配置含义为不使用湿映射函数。Nominally disable the wet mapping function. |
NMFW | Niell 1996 湿映射函数。Nominal Niell 1996 wet mapping function. |
NMFH | Niell 1996 静力映射函数。Nominal selection of Niell hydrostatic mapping. |
SPD | 基于外部斜路径时延的映射形式。Nominal mapping form associated with external slant delays. |
IONO_350 | 高度为 350 km 的薄壳映射形式。Nominal thin-shell mapping at 350 km. |
IONO_400 | 高度为 400 km 的薄壳映射形式。Nominal thin-shell mapping at 400 km. |
IONO_450 | 高度为 450 km 的薄壳映射形式。Nominal thin-shell mapping at 450 km. |
IONO_500 | 高度为 500 km 的薄壳映射形式。Nominal thin-shell mapping at 500 km. |
WET_MAPPING_FUNCTION: MMF <file>历史文件模式;加载阶段已禁用。
Historical file mode, disabled during loading.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
MMF <file> | 历史 MMF 文件模式;加载阶段明确拒绝。Historical MMF file mode, explicitly rejected during loading. |
实际用途: 在本次检索的 vtd/src 中,WMF_MODEL 仅由配置解析器赋值,没有在 VTD_TROPDEL 中作为计算分支读取。不能承诺更改此关键词就会改变湿时延或估计偏导。用于残余大气时延估计的映射形式实际由 ATMOSPHERE_PATH_DELAY_PARTIAL 选择。
Actual use: in the inspected vtd/src tree, WMF_MODEL is assigned by the parser but is not read as a computational selector by VTD_TROPDEL. Changing this keyword cannot be promised to change the wet delay or fitted partial. ATMOSPHERE_PATH_DELAY_PARTIAL selects the mapping used for the residual atmospheric-delay parameter.
VTD%CONF%WMF_MODELVTD%CONF%FINAM_MMF
SLANT_PATH_DELAY_MODEL: 部分选项受限Some options limited
选择外部大气斜路径时延数据的使用方式。
Select how external atmospheric slant propagation delays are used.
SLANT_PATH_DELAY_MODEL: (NONE | SPD_3D | EXT_PD)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 不采用此外部斜路径时延模型,按其他大气关键词计算相应先验项。Do not use this external slant-delay model; other atmospheric keywords select the relevant a priori terms. |
SPD_3D | 对数值天气模型生成的各测站斜路径时延数据作三维插值,三个维度为仰角映射变量、方位角和时间。Perform three-dimensional interpolation of station slant delays derived from numerical weather models, using an elevation-mapping variable, azimuth and time. |
EXT_PD | 外部路径时延接口代码;实际字符串是 EXT_PD,而不是 EXT_3D。External path-delay interface code; the actual string is EXT_PD, not EXT_3D. |
SPD_3D 依赖 EXTERNAL_DELAY_DIR 系列及各测站的有效数据。VTD_TROPDEL 的外部数据替换分支明确判断 SPD_3D;EXT_PD 虽可解析,不能据此认为它在纯 VTD 调用链中与 SPD_3D 等价,需核对宿主程序如何提供和使用外部时延。
TRP__EXT_3D 是 Fortran 常量名,其值为 EXT_PD;错误信息中的 EXT_3D 不应照抄。兼容关键词 SLANTED_PATH_DELAY_MODEL: 与本关键词同义。
SPD_3D depends on EXTERNAL_DELAY_DIR entries and valid station data. The replacement branch in VTD_TROPDEL explicitly tests SPD_3D. Although EXT_PD parses, it is not equivalent to SPD_3D in the standalone VTD path; inspect how the host program supplies and applies external delays.
TRP__EXT_3D is the Fortran constant name, whose value is EXT_PD. Do not copy EXT_3D from the error message. SLANTED_PATH_DELAY_MODEL is a compatible keyword alias.
VTD%CONF%SPD_MODEL
SLANT_PATH_DELAY_BIAS_FILE: 部分选项受限Some options limited
指定各测站的外部大气时延偏差与比例因子文件。
Specify the station-level external path-delay bias parameter file.
SLANT_PATH_DELAY_BIAS_FILE: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 读取 SPD 偏差文件中的测站名称、天顶时延偏差 ZEN_BIAS 和比例因子 ZEN_SCALE。Read station names, ZEN_BIAS and ZEN_SCALE from an SPD bias file. |
NONE | 不读取此偏差文件。Do not read a bias file. |
实际用途限制: VTD_LOAD_SPD 确实读取并存储这些字段;本次检索的 VTD 主计算流程没有找到对 ZEN_BIAS、ZEN_SCALE 的后续应用,不能把它描述为“填写后必然加上的常数斜路径时延”。兼容名称为 SLANTED_PATH_DELAY_BIAS_FILE。
Actual-use limitation: VTD_LOAD_SPD reads and stores these fields, but no later application of ZEN_BIAS or ZEN_SCALE was found in the inspected VTD main path. A successful read does not prove that a constant slant-delay correction is applied. SLANTED_PATH_DELAY_BIAS_FILE is the compatible alias.
VTD%CONF%SPD_BIAS_FILE
EXTERNAL_DELAY_DIR: 解析支持Parsed
指定第 1 个外部大气时延数据文件夹。
Specify external atmospheric-delay directory 1.
EXTERNAL_DELAY_DIR: (<directory> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<directory> | 已存在的文件夹路径,程序按第 1 优先顺序在此查找各测站的外部 SPD 数据。An existing directory searched for station SPD data at priority 1. |
NONE | 不使用第 1 个数据文件夹。Do not specify directory 1. |
EXTERNAL_DELAY_DIR 指定的文件夹也是 TOTAL_SCALE、WATER_SCALE 依赖检查的对象;仅填写后面三个路径不能满足这一检查。四个路径按顺序用于查找数据,不将四份时延相加;数据须符合所需测站名称、格式和时间范围。
The first directory is also checked as a dependency of TOTAL_SCALE and WATER_SCALE; directories 2–4 alone do not satisfy that check. The four directories do not define four delays to be added together. Data must satisfy the required station, format and time coverage.
VTD%CONF%DIR_EPD
EXTERNAL_DELAY_DIR_2ND: 解析支持Parsed
指定第 2 个外部大气时延数据文件夹。
Specify external atmospheric-delay directory 2.
EXTERNAL_DELAY_DIR_2ND: (<directory> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<directory> | 已存在的文件夹路径,程序按第 2 优先顺序在此查找各测站的外部 SPD 数据。An existing directory searched for station SPD data at priority 2. |
NONE | 不使用第 2 个数据文件夹。Do not specify directory 2. |
前面的文件夹未找到所需测站的可用数据时,再查找此文件夹。四个路径按顺序用于查找数据,不将四份时延相加;数据须符合所需测站名称、格式和时间范围。
This directory is searched when usable station data have not been found in preceding directories. The four directories do not define four delays to be added together. Data must satisfy the required station, format and time coverage.
VTD%CONF%DIR_EPD
EXTERNAL_DELAY_DIR_3RD: 解析支持Parsed
指定第 3 个外部大气时延数据文件夹。
Specify external atmospheric-delay directory 3.
EXTERNAL_DELAY_DIR_3RD: (<directory> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<directory> | 已存在的文件夹路径,程序按第 3 优先顺序在此查找各测站的外部 SPD 数据。An existing directory searched for station SPD data at priority 3. |
NONE | 不使用第 3 个数据文件夹。Do not specify directory 3. |
前面的文件夹未找到所需测站的可用数据时,再查找此文件夹。四个路径按顺序用于查找数据,不将四份时延相加;数据须符合所需测站名称、格式和时间范围。
This directory is searched when usable station data have not been found in preceding directories. The four directories do not define four delays to be added together. Data must satisfy the required station, format and time coverage.
VTD%CONF%DIR_EPD
EXTERNAL_DELAY_DIR_4TH: 解析支持Parsed
指定第 4 个外部大气时延数据文件夹。
Specify external atmospheric-delay directory 4.
EXTERNAL_DELAY_DIR_4TH: (<directory> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<directory> | 已存在的文件夹路径,程序按第 4 优先顺序在此查找各测站的外部 SPD 数据。An existing directory searched for station SPD data at priority 4. |
NONE | 不使用第 4 个数据文件夹。Do not specify directory 4. |
前面的文件夹未找到所需测站的可用数据时,再查找此文件夹。四个路径按顺序用于查找数据,不将四份时延相加;数据须符合所需测站名称、格式和时间范围。
This directory is searched when usable station data have not been found in preceding directories. The four directories do not define four delays to be added together. Data must satisfy the required station, format and time coverage.
VTD%CONF%DIR_EPD
ATMOSPHERE_PATH_DELAY_PARTIAL: 含实现异常Implementation caveat
选择大气斜路径时延对待估天顶时延参数的偏导数形式,用于参数估计;先验时延模型由其他关键词设置。
Select the partial derivative of slant delay with respect to an estimated zenith-delay parameter. This controls parameter estimation, not the direct selection of a priori slant delay.
ATMOSPHERE_PATH_DELAY_PARTIAL: <model>选择残余大气参数的偏导形式。
Select a partial-derivative form for the residual atmospheric parameter.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 偏导取零。Set the partial to zero. |
NMFW | 以 Niell 湿映射函数作为偏导。Use Niell wet mapping as the partial. |
NMFH | 以 Niell 静力映射函数作为偏导。Use Niell hydrostatic mapping as the partial. |
TOTAL_SCALE | 用外部总斜路径时延与总天顶时延之比作为偏导。Use external total slant delay divided by total zenith delay. |
WATER_SCALE | 用外部水汽斜路径时延与水汽天顶时延之比作为偏导。Use external water-vapor slant delay divided by water-vapor zenith delay. |
IONO_350 | 350 km 高度薄壳映射函数。Thin-shell mapping at 350 km. |
IONO_400 | 400 km 高度薄壳映射函数。Thin-shell mapping at 400 km. |
IONO_450 | 450 km 高度薄壳映射函数。Thin-shell mapping at 450 km. |
IONO_500 | 500 km 高度薄壳映射函数。Thin-shell mapping at 500 km. |
ATMOSPHERE_PATH_DELAY_PARTIAL: GAUSSIAN_LAYER <height> <fwhm>高度和半高全宽的单位均为米;当前解析器误读宽度,见限制说明。
Height and FWHM are in meters. The parser currently misreads the width; see the limitation below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
GAUSSIAN_LAYER <height> <fwhm> | 高斯层映射形式;层中心高度和半高全宽均为米,详见下述实现问题。Gaussian-layer mapping, with center height and full width at half maximum in meters; see the parser defect below. |
TOTAL_SCALE、WATER_SCALE 要求第一外部时延文件夹非空,并应配合 SPD_3D 及相应分量数据;解析器只检查文件夹条件,不能验证完整模型组合。
GAUSSIAN_LAYER 存在确定的读字段错误: 第三个字段被同时读入高度和宽度,第四个字段没有被正确使用。例如 GAUSSIAN_LAYER 5000.0 500.0 实际把两者都读成 5000.0。修正前不能据配置文本认为采用了 500 m 的 FWHM。两个数的读取格式是 F12.6,务必写小数点。
IONO_* 在这里仅借用薄壳的仰角依赖形式,并不会自动启用 TEC 电离层时延。
TOTAL_SCALE and WATER_SCALE require a nonempty first external-delay directory and should be paired with SPD_3D and the required data components. The parser checks the directory condition, not the entire model combination.
Confirmed GAUSSIAN_LAYER field-reading defect: both height and width are read from field 3; field 4 is not correctly used. Thus GAUSSIAN_LAYER 5000.0 500.0 reads 5000.0 for both values. Until corrected, the text cannot be taken as selecting a 500 m FWHM. Both reads use F12.6: include a decimal point.
IONO_* only borrows the thin-shell elevation dependence here; it does not enable a TEC-based ionospheric delay.
VTD%CONF%ATM_PARTIAL_TYPEVTD%CONF%ATM_PARTIAL_PAR
ATMOSPHERE_TILT_PARTIALS: 解析支持Parsed
选择时延对大气水平梯度或大气层倾斜参数的偏导数形式,分别对应南北和东西分量。
Select north/east partial derivatives for atmospheric gradients or tilt parameters.
ATMOSPHERE_TILT_PARTIALS: <value>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 两分量偏导均为零。Set both partials to zero. |
NORTH_EAST | 源码给出 −m cos A、−m sin A,其中 m 是已计算的天顶时延偏导。The source uses −m cos A and −m sin A, where m is the already computed zenith-delay partial. |
MACMILLAN_1995 | 采用 m_h(e) cot(e) cos A 与对应 sin A 形式。Use m_h(e) cot(e) cos A and the corresponding sin A form. |
TILT_NMFH | 采用 NMF 静力映射函数除以 tan(e) sin(e)+C_CH,再乘 cos A 或 sin A。Divide NMF hydrostatic mapping by tan(e) sin(e)+C_CH, then multiply by cos A or sin A. |
TILT_NMFW | 同一分母形式,但分子改用 NMF 湿映射函数。Use the same denominator but NMF wet mapping in the numerator. |
e 为仰角,A 为方位角,C_CH 为源码常数 C__CHEN_HERRING;偏导数的正负号取决于参数定义。本关键词只选择偏导数形式,不提供先验梯度数值,也不指定参数估计结果。
e is elevation, A is azimuth and C_CH is the source constant C__CHEN_HERRING. Signs depend on the parameter definition. This keyword selects partial derivatives; it supplies neither a priori gradient values nor estimated gradient results.
VTD%CONF%ATD_PARTIALS
电离层模型与数据Ionosphere models and data
选择总电子含量(TEC)的映射方式、电离层时延比例因子,以及按顺序查找的九个候选数据文件。
Select total electron content (TEC) mapping, the ionospheric-delay scale factor and nine candidate files searched in order.
IONOSPHERE_MODEL: 解析支持Parsed
选择根据全球卫星导航系统(GNSS)的总电子含量(TEC)图计算电离层传播时延的模型。
Select the model for calculating ionospheric propagation contributions from GNSS TEC maps.
IONOSPHERE_MODEL: (NONE | GNSS_TEC_MAP | GNSS_TEC_MOD | GNSS_TEC_MHI)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 不按 TEC 图计算该电离层项。Do not calculate this TEC-map ionospheric contribution. |
GNSS_TEC_MAP | 采用通常的球形薄壳映射;壳层高度取 TEC 文件头。Use standard spherical thin-shell mapping, with height from the TEC file header. |
GNSS_TEC_MOD | 采用修正单层映射:高度常量 506700 m,天顶角缩放因子 0.9782。Use modified single-layer mapping with a height constant of 506700 m and zenith-angle factor 0.9782. |
GNSS_TEC_MHI | 采用更高壳层的修正映射:高度常量 600000 m,天顶角缩放因子同为 0.9782。Use modified mapping at a higher shell of 600000 m, with the same zenith-angle factor 0.9782. |
后两者是在映射函数中改变高度和角度关系;VTD_IONO_DELAY 的穿刺点计算仍读取 TEC 文件头高度,不能概括为“所有几何量都改用 506.7 或 600 km”。时延还取决于观测频率、观测类型及 IONOSPHERE_SCALE。最后是否把该项加入总时延,还受调用方 OBS_TYP%APPLY_IONO 控制。
The last two choices change the height and angle relation in the mapping function. Pierce-point geometry in VTD_IONO_DELAY still uses the TEC header height, so not all geometry moves to 506.7 or 600 km. The result also depends on observing frequency, observable type and IONOSPHERE_SCALE. The caller’s OBS_TYP%APPLY_IONO controls whether the contribution is added to total delay.
VTD%CONF%IONO_MODEL
IONOSPHERE_SCALE: 解析支持Parsed
设置由 TEC 图计算的电离层时延的比例因子。
Set an overall multiplier for the TEC-map ionospheric contribution.
IONOSPHERE_SCALE: <real>可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<real> | 程序可读入的实数;1.0 保持原值,0.0 将该电离层时延项置零,其他取值按相应比例缩放。A parseable real number: 1.0 leaves the contribution unchanged, 0.0 scales it to zero, and other values scale it proportionally. |
解析器没有设置数值上下限,能读入负值不代表它具有通常物理意义。环境变量 VTD_IONO_SCALE 能在计算中覆盖配置值;检查结果时应同时检查该环境变量。
No numerical bounds are enforced. Acceptance of a negative number does not imply its usual physical suitability. The VTD_IONO_SCALE environment variable can override the configured value during computation.
VTD%CONF%IONOSPHERE_SCALE
IONOSPHERE_DATA_FILE: 解析支持Parsed
指定第 1 个候选电离层 TEC 图文件。
Specify candidate TEC-map file 1.
IONOSPHERE_DATA_FILE: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 VIONO 格式二进制 TEC 图文件,按第 1 优先顺序检查。An existing VIONO internal binary TEC-map file at candidate priority 1. |
NONE | 不使用第 1 个候选文件。Do not use candidate file 1. |
VTD_LOAD_IONO 依次查找首个覆盖整个所需时段的文件,找到后停止;不把九个文件的时延相加,也不是自动按日期拼接九个文件。原始 IONEX 文本不能仅改扩展名就作为 VIONO 使用。
VTD_LOAD_IONO selects the first file covering the entire requested interval, then stops. It neither adds nine ionospheric delays nor automatically concatenates the nine files by date. Renaming an IONEX text file does not convert it to VIONO.
VTD%CONF%IONO_FILE
IONOSPHERE_DATA_FILE_2ND: 解析支持Parsed
指定第 2 个候选电离层 TEC 图文件。
Specify candidate TEC-map file 2.
IONOSPHERE_DATA_FILE_2ND: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 VIONO 格式二进制 TEC 图文件,按第 2 优先顺序检查。An existing VIONO internal binary TEC-map file at candidate priority 2. |
NONE | 不使用第 2 个候选文件。Do not use candidate file 2. |
VTD_LOAD_IONO 依次查找首个覆盖整个所需时段的文件,找到后停止;不把九个文件的时延相加,也不是自动按日期拼接九个文件。原始 IONEX 文本不能仅改扩展名就作为 VIONO 使用。
VTD_LOAD_IONO selects the first file covering the entire requested interval, then stops. It neither adds nine ionospheric delays nor automatically concatenates the nine files by date. Renaming an IONEX text file does not convert it to VIONO.
VTD%CONF%IONO_FILE
IONOSPHERE_DATA_FILE_3RD: 解析支持Parsed
指定第 3 个候选电离层 TEC 图文件。
Specify candidate TEC-map file 3.
IONOSPHERE_DATA_FILE_3RD: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 VIONO 格式二进制 TEC 图文件,按第 3 优先顺序检查。An existing VIONO internal binary TEC-map file at candidate priority 3. |
NONE | 不使用第 3 个候选文件。Do not use candidate file 3. |
VTD_LOAD_IONO 依次查找首个覆盖整个所需时段的文件,找到后停止;不把九个文件的时延相加,也不是自动按日期拼接九个文件。原始 IONEX 文本不能仅改扩展名就作为 VIONO 使用。
VTD_LOAD_IONO selects the first file covering the entire requested interval, then stops. It neither adds nine ionospheric delays nor automatically concatenates the nine files by date. Renaming an IONEX text file does not convert it to VIONO.
VTD%CONF%IONO_FILE
IONOSPHERE_DATA_FILE_4TH: 解析支持Parsed
指定第 4 个候选电离层 TEC 图文件。
Specify candidate TEC-map file 4.
IONOSPHERE_DATA_FILE_4TH: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 VIONO 格式二进制 TEC 图文件,按第 4 优先顺序检查。An existing VIONO internal binary TEC-map file at candidate priority 4. |
NONE | 不使用第 4 个候选文件。Do not use candidate file 4. |
VTD_LOAD_IONO 依次查找首个覆盖整个所需时段的文件,找到后停止;不把九个文件的时延相加,也不是自动按日期拼接九个文件。原始 IONEX 文本不能仅改扩展名就作为 VIONO 使用。
VTD_LOAD_IONO selects the first file covering the entire requested interval, then stops. It neither adds nine ionospheric delays nor automatically concatenates the nine files by date. Renaming an IONEX text file does not convert it to VIONO.
VTD%CONF%IONO_FILE
IONOSPHERE_DATA_FILE_5TH: 解析支持Parsed
指定第 5 个候选电离层 TEC 图文件。
Specify candidate TEC-map file 5.
IONOSPHERE_DATA_FILE_5TH: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 VIONO 格式二进制 TEC 图文件,按第 5 优先顺序检查。An existing VIONO internal binary TEC-map file at candidate priority 5. |
NONE | 不使用第 5 个候选文件。Do not use candidate file 5. |
VTD_LOAD_IONO 依次查找首个覆盖整个所需时段的文件,找到后停止;不把九个文件的时延相加,也不是自动按日期拼接九个文件。原始 IONEX 文本不能仅改扩展名就作为 VIONO 使用。
VTD_LOAD_IONO selects the first file covering the entire requested interval, then stops. It neither adds nine ionospheric delays nor automatically concatenates the nine files by date. Renaming an IONEX text file does not convert it to VIONO.
VTD%CONF%IONO_FILE
IONOSPHERE_DATA_FILE_6TH: 解析支持Parsed
指定第 6 个候选电离层 TEC 图文件。
Specify candidate TEC-map file 6.
IONOSPHERE_DATA_FILE_6TH: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 VIONO 格式二进制 TEC 图文件,按第 6 优先顺序检查。An existing VIONO internal binary TEC-map file at candidate priority 6. |
NONE | 不使用第 6 个候选文件。Do not use candidate file 6. |
VTD_LOAD_IONO 依次查找首个覆盖整个所需时段的文件,找到后停止;不把九个文件的时延相加,也不是自动按日期拼接九个文件。原始 IONEX 文本不能仅改扩展名就作为 VIONO 使用。
VTD_LOAD_IONO selects the first file covering the entire requested interval, then stops. It neither adds nine ionospheric delays nor automatically concatenates the nine files by date. Renaming an IONEX text file does not convert it to VIONO.
VTD%CONF%IONO_FILE
IONOSPHERE_DATA_FILE_7TH: 解析支持Parsed
指定第 7 个候选电离层 TEC 图文件。
Specify candidate TEC-map file 7.
IONOSPHERE_DATA_FILE_7TH: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 VIONO 格式二进制 TEC 图文件,按第 7 优先顺序检查。An existing VIONO internal binary TEC-map file at candidate priority 7. |
NONE | 不使用第 7 个候选文件。Do not use candidate file 7. |
VTD_LOAD_IONO 依次查找首个覆盖整个所需时段的文件,找到后停止;不把九个文件的时延相加,也不是自动按日期拼接九个文件。原始 IONEX 文本不能仅改扩展名就作为 VIONO 使用。
VTD_LOAD_IONO selects the first file covering the entire requested interval, then stops. It neither adds nine ionospheric delays nor automatically concatenates the nine files by date. Renaming an IONEX text file does not convert it to VIONO.
VTD%CONF%IONO_FILE
IONOSPHERE_DATA_FILE_8TH: 解析支持Parsed
指定第 8 个候选电离层 TEC 图文件。
Specify candidate TEC-map file 8.
IONOSPHERE_DATA_FILE_8TH: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 VIONO 格式二进制 TEC 图文件,按第 8 优先顺序检查。An existing VIONO internal binary TEC-map file at candidate priority 8. |
NONE | 不使用第 8 个候选文件。Do not use candidate file 8. |
VTD_LOAD_IONO 依次查找首个覆盖整个所需时段的文件,找到后停止;不把九个文件的时延相加,也不是自动按日期拼接九个文件。原始 IONEX 文本不能仅改扩展名就作为 VIONO 使用。
VTD_LOAD_IONO selects the first file covering the entire requested interval, then stops. It neither adds nine ionospheric delays nor automatically concatenates the nine files by date. Renaming an IONEX text file does not convert it to VIONO.
VTD%CONF%IONO_FILE
IONOSPHERE_DATA_FILE_9TH: 解析支持Parsed
指定第 9 个候选电离层 TEC 图文件。
Specify candidate TEC-map file 9.
IONOSPHERE_DATA_FILE_9TH: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 已存在的 VIONO 格式二进制 TEC 图文件,按第 9 优先顺序检查。An existing VIONO internal binary TEC-map file at candidate priority 9. |
NONE | 不使用第 9 个候选文件。Do not use candidate file 9. |
VTD_LOAD_IONO 依次查找首个覆盖整个所需时段的文件,找到后停止;不把九个文件的时延相加,也不是自动按日期拼接九个文件。原始 IONEX 文本不能仅改扩展名就作为 VIONO 使用。
VTD_LOAD_IONO selects the first file covering the entire requested interval, then stops. It neither adds nine ionospheric delays nor automatically concatenates the nine files by date. Renaming an IONEX text file does not convert it to VIONO.
VTD%CONF%IONO_FILE
几何时延与时延率Geometric delay and rates
选择远场、近场几何时延与多普勒频移的计算模型,设置相对论尺度约定和时延率计算选项。
Select far-field and near-field geometric-delay and Doppler models, relativistic scaling conventions and delay-rate options.
GRS_METRIC: 含实现异常Implementation caveat
选择地心参考系统坐标及时间尺度相关的相对论尺度约定。
Select the relativistic scaling convention associated with geocentric coordinates and time scales.
GRS_METRIC: (IAU2000 | ITRF2000 | ITRF1996)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
IAU2000 | 选用 IAU 2000 对应约定。Select the IAU 2000 convention. |
ITRF2000 | 选用源码中的 ITRF 2000 兼容约定。Select the implemented ITRF 2000 compatibility convention. |
ITRF1996 | 文本上表示 ITRF 1996,但当前被映射到 ITRF1992 内部常量,见下述问题。Textually denotes ITRF 1996, but currently maps to the internal ITRF1992 constant. |
实现不一致: ITRF1996 被赋为 VTD__METRIC_ITRF1992;VTD_PK2001 对 ITRF1992 与 ITRF1996 设有不同分支,所以不能把该文本值当作已正确执行 ITRF1996 计算。它也不是“选取某一版测站坐标表”的关键词。
Implementation mismatch: ITRF1996 is assigned VTD__METRIC_ITRF1992. VTD_PK2001 has distinct ITRF1992 and ITRF1996 branches, so the text does not correctly select the latter. This is not a keyword for selecting a station-coordinate catalogue release.
VTD%CONF%GRS_METRIC
GEOM_EXPR_FAR_ZONE: 解析支持Parsed
选择远场源在真空中的相对论几何时延表达式。
Select the relativistic vacuum geometric-delay expression for far-field sources.
GEOM_EXPR_FAR_ZONE: (KS_1999 | PK_2001)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
KS_1999 | Kopeikin–Schäfer 1999 表达式。Kopeikin–Schäfer 1999 expression. |
PK_2001 | Petrov–Kopeikin 2001 表达式。Petrov–Kopeikin 2001 expression. |
无 NONE。远场或近场计算由源类型等信息决定,不是仅写这个关键词就把某源强制归为远场。
NONE is not supported. The source type and related data determine whether the far- or near-field path is used; this keyword alone does not classify a source as far-field.
VTD%CONF%GEOM_EXPR_FAR_ZONE
GEOM_EXPR_NEAR_ZONE: 解析支持Parsed
选择太阳系内天体的近场几何时延模型,计算目标处于有限距离时的真空传播时延差。
Select the vacuum geometric-delay expression for near-field targets.
GEOM_EXPR_NEAR_ZONE: (LIGHT_TIME | JN_2019)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
LIGHT_TIME | 通过迭代求解光行时方程。Iteratively solve the light-time equation. |
JN_2019 | 采用 Jaron–Nothnagel 2019 近场时延模型在当前 VTD 源码中的实现。The Jaron–Nothnagel 2019-related expression as implemented in the current source. |
无 NONE。近场计算还依赖目标轨道、时刻和源类型;不能只更改此值就得到卫星时延。
NONE is not supported. Near-field calculations also require the target orbit, epoch and source type; changing this value alone does not produce a satellite delay.
VTD%CONF%GEOM_EXPR_NEAR_ZONE
DOPPLER_EXPR: 解析支持Parsed
选择太阳系内天体的多普勒频移计算模型。
Select the expression used to calculate Doppler frequency shift for a near-field target.
DOPPLER_EXPR: COARSE_2006可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
COARSE_2006 | 使用源码提供的 2006 年粗略多普勒计算表达式。Use the coarse 2006 Doppler expression implemented in the source. |
本版唯一合法枚举值;没有 NONE。它设置的是多普勒计算方法,不等于要求 VTD_DELAY 每次都输出多普勒,也不同于 DELAY_RATE。
This is the only supported enumeration value; NONE is not accepted. Selecting a Doppler method does not make every VTD_DELAY call return a Doppler result, and it is distinct from DELAY_RATE.
VTD%CONF%DOPPLER_EXPR
DELAY_RATE: 含实现异常Implementation caveat
控制是否计算时延对时间的解析导数(时延率)及相关偏导数。
Control calculation of analytical delay rates and related derivatives.
DELAY_RATE: (YES | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
YES | 开启解析时延率计算。Enable analytical delay-rate calculation. |
NONE | 关闭由 FL_RATE 控制的时延率计算分支,以减少运算。Disable rate branches controlled by FL_RATE to reduce computation. |
NONE 不应被解释为可以把全部返回的时延率字段当作已严格清零;下游是否读取这些字段仍需遵守接口用法。
相关实现问题: VTD_DELAY 汇总 RATE 时先无条件加入两站电离层时延率差,随后在 OBS_TYP%APPLY_IONO 为真时再次加入同一差值。电离层时延率非零时会有重复计入风险;不能仅凭 DELAY_RATE: YES 就认为所有时延率项已经正确汇总。
NONE does not guarantee that every returned rate field has been explicitly zeroed; downstream consumers must respect the interface contract.
Related implementation issue: VTD_DELAY first adds the station ionospheric-rate difference unconditionally when forming RATE, then adds the same difference again when OBS_TYP%APPLY_IONO is true. Nonzero ionospheric rates can therefore be counted twice. DELAY_RATE: YES alone does not ensure correct aggregation of every rate term.
VTD%CONF%FL_RATE
兼容旧名称Legacy aliases
三个兼容入口不增加独立功能,也不应作为额外关键词重复填写。
These three compatibility entries add no independent functionality and must not be supplied as duplicate extra keywords.
SLANTED_PATH_DELAY_MODEL: 兼容名称Compatibility alias
SLANT_PATH_DELAY_MODEL 的兼容旧名称。
Compatibility alias for SLANT_PATH_DELAY_MODEL.
SLANTED_PATH_DELAY_MODEL: (NONE | SPD_3D | EXT_PD)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
NONE | 不采用此外部斜路径时延模型,按其他大气关键词计算相应先验项。Do not use this external slant-delay model; other atmospheric keywords select the relevant a priori terms. |
SPD_3D | 对数值天气模型生成的各测站斜路径时延数据作三维插值,三个维度为仰角映射变量、方位角和时间。Perform three-dimensional interpolation of station slant delays derived from numerical weather models, using an elevation-mapping variable, azimuth and time. |
EXT_PD | 外部路径时延接口代码;实际字符串是 EXT_PD,而不是 EXT_3D。External path-delay interface code; the actual string is EXT_PD, not EXT_3D. |
进入与 SLANT_PATH_DELAY_MODEL 相同的解析分支。使用 NONE、SPD_3D 或 EXT_PD。 其模型限制与对应常规关键词相同。
Uses the same parser branch as SLANT_PATH_DELAY_MODEL. Values are NONE, SPD_3D and EXT_PD. The canonical keyword’s model limitations still apply.
VTD%CONF%SPD_MODEL
SLANTED_PATH_DELAY_BIAS_FILE: 兼容名称Compatibility alias
SLANT_PATH_DELAY_BIAS_FILE 的兼容旧名称。
Compatibility alias for SLANT_PATH_DELAY_BIAS_FILE.
SLANTED_PATH_DELAY_BIAS_FILE: (<file> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<file> | 读取 SPD 偏差文件中的测站名称、天顶时延偏差 ZEN_BIAS 和比例因子 ZEN_SCALE。Read station names, ZEN_BIAS and ZEN_SCALE from an SPD bias file. |
NONE | 不读取此偏差文件。Do not read a bias file. |
进入与 SLANT_PATH_DELAY_BIAS_FILE 相同的解析分支。值为文件名或 NONE。 其模型限制与对应常规关键词相同。
Uses the same parser branch as SLANT_PATH_DELAY_BIAS_FILE. Supply a filename or NONE. The canonical keyword’s model limitations still apply.
VTD%CONF%SPD_BIAS_FILE
PHASE_OFFSET_FILE: 兼容名称Compatibility alias
DIR_BTX 的兼容旧名称。
Compatibility alias for DIR_BTX.
PHASE_OFFSET_FILE: (<directory> | NONE)可设置值及其含义如下。
Supported values and their meanings are listed below.
| 取值 / 字段Value / field | 含义与作用Meaning and effect |
|---|---|
<directory> | 已存在的文件夹路径,其中包含 VTD 能够读取的 .btx 数据文件。An existing directory containing .btx files recognized by the reader. |
NONE | 配置层面表示不指定该文件夹。At the configuration level, do not specify this directory. |
在分词和大写转换前,以固定列字符串替换为 DIR_BTX。旧名应从首列大写书写,冒号后留空格;优先使用 DIR_BTX。当前应填写相位中心数据所在的文件夹路径。 其模型限制与对应常规关键词相同。
Rewritten to DIR_BTX by a fixed-column match before tokenization and uppercase conversion. If retained, write the uppercase name in column 1 with a space after the colon. Prefer DIR_BTX. The value now denotes the directory containing phase-center data. The canonical keyword’s model limitations still apply.
VTD%CONF%DIR_BTX
执行结构与使用约定Execution structure and notation
实际调用与数据流Call and data flow
调用方先初始化 VTD 对象,再调用 VTD_CONF,将控制文件中的选项、文件名和参数存入 VTD%CONF,并检查部分文件或文件夹是否存在。
The caller initializes VTD and calls VTD_CONF. Enumerations, paths and parameters are stored in VTD%CONF; some path-existence checks occur here.
VTD_LOAD 按照所需测站、射电源和时间范围,读取测站表、射电源表、太阳系天体历表、地球定向数据及外部模型。MMF 等选项会在此阶段被拒绝。
VTD_LOAD uses the station list, source list and time interval to load station and source catalogues, Solar-system ephemerides, Earth orientation and external models. Options such as MMF are rejected at this stage.
VTD_DELAY 接收源、两站、历元和观测类型;内部调用 VTD_MOMENT 更新历元状态,并调用大气、电离层和几何时延等相关例程。
VTD_DELAY receives the source, station pair, epoch and observable type. It calls VTD_MOMENT to update the epoch state and invokes the relevant atmospheric, ionospheric and geometric-delay routines.
VTD_DELAY 汇总总时延、时延率及相关偏导,交回调用方。观测频率和 APPLY_IONO 等调用参数仍会影响最终结果,不能仅查看控制文件。
VTD_DELAY returns the combined delay, rate and relevant partials. Observing frequencies and caller-side controls such as APPLY_IONO still affect the result; the control file alone is insufficient.
第一行格式标签First-line format label
# VTD Control file. Format version of 2024.05.02
- 本指南按用途分为九组,另列三个旧名称。VTD 控制文件没有这些分组标题,也不使用 pSolve 的 $SETUP、$FLAGS 等配置段。The nine groups and three legacy names organize this guide. They are not section headers in a VTD control file, which does not use pSolve sections such as $SETUP or $FLAGS.
- 一行通常写 KEYWORD: value。冒号属于关键词;关键词转为大写,但选项通常区分大小写,按表中的大写形式填写。A record normally has the form KEYWORD: value. The colon is part of the keyword. Keywords are uppercased, but option values are generally case-sensitive; use the listed uppercase forms.
- 字段以空格、Tab 或零字节分隔;没有引号分组机制,路径应避免空白字符。当前解析器跳过空行和首列 # 注释,不把首列 * 当作注释。Fields are separated by spaces, tabs or NUL characters. There is no quote-grouping mechanism; avoid whitespace in paths. The parser skips blank lines and # comments in column 1, not * comments.
- 支持 ${变量名} 环境变量替换;相对路径不自动以控制文件所在文件夹为基准。固定缓冲上限为 256 行、每行 128 字符、32 个字段。Environment substitution uses ${name}. Relative paths are not automatically resolved from the configuration-file directory. Fixed buffers allow 256 lines, 128 characters per line and 32 fields.
- 应完整列出 71 类常规关键词。源码只检查计数,不逐项检查不同关键词集合,因此重复项可能掩盖缺项。只在支持 NONE 的位置使用 NONE。Supply all 71 canonical keyword types. The source checks a count rather than a set of distinct names, so duplicates can mask omissions. Use NONE only where supported.
- POSVAR 四项按相同索引成套设置,索引范围为 1–16;索引 1 或 NONE 计入常规关键词计数。兼容名称与对应常规名称择一使用。Supply the four POSVAR entries together for each index, from 1 to 16. Index 1 or NONE contributes to the canonical-keyword count. Choose either an alias or its canonical name, not both.
- 实数显式写小数点,例如 7200.0。F15.5、F12.6 等 Fortran 格式可能将没有小数点的输入按隐含小数位解释。Write real numbers with a decimal point, such as 7200.0. Fortran formats such as F15.5 and F12.6 may interpret inputs without a decimal point using implicit fractional digits.
- 语法卡片中的尖括号、括号、竖线只是说明符号。它们不是可直接运行的完整配置,也不能表示所有模型可任意组合。Angle brackets, parentheses and vertical bars in syntax cards are notation. The cards are not complete runnable configurations and do not imply that all models can be freely combined.
- 配置 → 内部字段 → 数据加载 → 计算 → 输出必须连起来理解。解析通过并不证明选项在下游可用;限制说明来自静态源码核对,未遍历运行全部模型组合。Read the chain as configuration → internal fields → data loading → computation → output. Successful parsing does not prove downstream support. Limitations come from static source inspection, not execution of every model combination.
符号说明Notation
| 符号Symbol | 读法Meaning |
|---|---|
<file> / <directory> | 替换为文件路径或文件夹路径,不输入尖括号。Replace with a file or directory path; omit angle brackets. |
<i> | 位置变化组索引,1–16。Position-variation index, 1–16. |
(A | B) | 从 A、B 中选一个,不输入括号或竖线。Choose A or B; omit parentheses and the vertical bar. |
<real> / <seconds> | 数值参数,按条目要求写明单位对应的数值,并显式使用小数点。Numerical parameter in the units specified for that entry; include a decimal point. |
术语约定Terminology
| 英文术语English term | 本文用法Usage in this guide |
|---|---|
| Solar-system ephemerides | 太阳系天体历表:提供太阳系天体的位置、速度等数据。Ephemerides supplying positions, velocities and related states of Solar-system bodies. |
| Antenna mount / axis offset | 天线座架/轴线偏差:前者指座架的轴系形式,后者指两条旋转轴线不相交时的间距。The antenna axis arrangement / the separation of non-intersecting rotation axes. |
| Near-field object | 太阳系内天体(近场):包括自然天体和人造天体;“近场”强调时延计算需考虑目标的有限距离。Natural and artificial Solar-system bodies; near-field emphasizes that the target’s finite distance must be included in delay modelling. |
| EOP / AEM / ERM | 地球定向参数/地球自转先验模型/地球自转经验模型。缩写保留,以便与源码和数据格式对应。Earth orientation parameters / a priori Earth rotation model / empirical Earth rotation model. Acronyms are retained for matching source code and file formats. |
| Harmonic Earth orientation (HEO) | 地球定向周期项模型:用正弦、余弦项描述相对于先验模型的周期性小改正。Periodic corrections to the a priori Earth orientation, represented by sine and cosine terms. |
| Source-coordinate debiasing | 射电源坐标系统偏差改正:本程序将经验坐标偏差换算为时延和时延率改正。Empirical source-coordinate biases converted by VTD into delay and delay-rate corrections. |
| Galactic aberration | 银河系光行差。Galactic aberration. |
| Directory / catalogue | 文件夹(路径)/数据表:directory 指文件系统中的文件夹;source catalogue 在本文称射电源表。A filesystem directory / a data catalogue. Source catalogues contain source records and are distinct from directories. |
| Delay / path-length change | 时延/传播路径长度变化:前者为时间量,后者为长度量,应按具体模型换算。A time interval / a length change. Conversion between them follows the relevant model. |