Skip to content

Commit 4b086cc

Browse files
Dengda98Dengda98
authored
DOC: add note about near-field in FIM and SAFIM (#46)
1 parent 67c2b12 commit 4b086cc

File tree

4 files changed

+54
-20
lines changed

4 files changed

+54
-20
lines changed

‎docs/locales/en/LC_MESSAGES/Advanced/filon/linear_filon.po‎

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: PyGRT 0.6.1.dev17+g4521452.d20250424\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2025-05-05 22:22+0800\n"
11+
"POT-Creation-Date: 2025-06-26 18:19+0800\n"
1212
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language: en\n"
@@ -211,11 +211,18 @@ msgstr ""
211211

212212
#: ../../source/Advanced/filon/linear_filon.rst:77
213213
msgid "``filonLength:float`` 对应C选项卡中的 ``<Flength>`` 参数"
214-
msgstr ""
215-
"``filonLength:List`` corresponding to the ``<Flength>`` in the C tab."
214+
msgstr "``filonLength:List`` corresponding to the ``<Flength>`` in the C tab."
216215

217216
#: ../../source/Advanced/filon/linear_filon.rst:78
218217
msgid "``filonCut:float`` 对应C选项卡中的 ``<Fcut>`` 参数"
218+
msgstr "``filonCut:float`` corresponding to the ``<Fcut>`` in the C tab."
219+
220+
#: ../../source/Advanced/filon/linear_filon.rst:82
221+
msgid ""
222+
"在程序中，固定间隔的Filon积分不计算近场项，即 :doc:`/Tutorial/dynamic/gfunc` 中介绍的 :math:`p=1`"
223+
" 对应的积分项。"
219224
msgstr ""
220-
"``filonCut:float`` corresponding to the ``<Fcut>`` in the C tab."
225+
"In the program, Fixed-Interval FIM does not compute the near-field term, that is, "
226+
"the integral term corresponding to :math:`p=1` introduced in :doc:`/Tutorial/dynamic/gfunc`."
227+
221228

‎docs/locales/en/LC_MESSAGES/Advanced/filon/self_adaptive_filon.po‎

Lines changed: 34 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: PyGRT 0.7.1.dev29+g6f42373.d20250505\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2025-05-05 22:22+0800\n"
11+
"POT-Creation-Date: 2025-06-26 18:19+0800\n"
1212
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language: en\n"
@@ -46,7 +46,14 @@ msgid ""
4646
":ref:`(Chen and Zhang, 2001) <chen_2001>` :ref:`(张海明, 2021) "
4747
"<zhang_book_2021>` 。"
4848
msgstr ""
49-
"In the :ref:`linear_filon` section, the process and core principles of Filon's integration are briefly introduced, namely **piecewise analytical solutions of the integral**. The following introduces the **Self-Adaptive Filon's Integration Method (SAFIM)**, which is **dynamic segmentation**, sampling more in regions where the kernel function changes drastically and less in regions where it changes smoothly. For detailed principles, see :ref:`(Chen and Zhang, 2001) <chen_2001>` :ref:`(Zhang Haiming, 2021) <zhang_book_2021>`."
49+
"In the :ref:`linear_filon` section, the process and core principles of "
50+
"Filon's integration are briefly introduced, namely **piecewise analytical"
51+
" solutions of the integral**. The following introduces the **Self-"
52+
"Adaptive Filon's Integration Method (SAFIM)**, which is **dynamic "
53+
"segmentation**, sampling more in regions where the kernel function "
54+
"changes drastically and less in regions where it changes smoothly. For "
55+
"detailed principles, see :ref:`(Chen and Zhang, 2001) <chen_2001>` "
56+
":ref:`(Zhang Haiming, 2021) <zhang_book_2021>`."
5057

5158
#: ../../source/Advanced/filon/self_adaptive_filon.rst:16
5259
msgid "参数介绍"
@@ -67,8 +74,8 @@ msgid ""
6774
":command:`grt -h` 或 :command:`stgrt -h`。"
6875
msgstr ""
6976
"The :command:`grt` and :command:`stgrt` programs support the following "
70-
"optional parameters to use SAFIM. For detailed "
71-
"explanations, see :command:`grt -h` or :command:`stgrt -h`."
77+
"optional parameters to use SAFIM. For detailed explanations, see "
78+
":command:`grt -h` or :command:`stgrt -h`."
7279

7380
#: ../../source/Advanced/filon/self_adaptive_filon.rst:26
7481
msgid "``-La<length>[/<Ftol>/<Fcut>]``"
@@ -80,14 +87,17 @@ msgid ""
8087
" 部分）"
8188
msgstr ""
8289
"``<length>`` defines the integration interval for discrete wavenumber "
83-
"integration (see :ref:`k_integ_rst` section, :ref:`linear_filon` section)."
90+
"integration (see :ref:`k_integ_rst` section, :ref:`linear_filon` "
91+
"section)."
8492

8593
#: ../../source/Advanced/filon/self_adaptive_filon.rst:29
8694
msgid ""
8795
"``<Ftol>`` 定义自适应采样精度，见 :ref:`(Chen and Zhang, 2001) <chen_2001>` "
8896
":ref:`(张海明, 2021) <zhang_book_2021>`，通常1e-2即可。"
8997
msgstr ""
90-
"``<Ftol>`` defines the precision of self-adaptive sampling, see :ref:`(Chen and Zhang, 2001) <chen_2001>` :ref:`(张海明, 2021) <zhang_book_2021>`. In general set 1e-2."
98+
"``<Ftol>`` defines the precision of self-adaptive sampling, see "
99+
":ref:`(Chen and Zhang, 2001) <chen_2001>` :ref:`(张海明, 2021) "
100+
"<zhang_book_2021>`. In general set 1e-2."
91101

92102
#: ../../source/Advanced/filon/self_adaptive_filon.rst:30
93103
msgid ""
@@ -111,18 +121,16 @@ msgstr ""
111121
"The :func:`compute_grn() <pygrt.pymod.PyModel1D.compute_grn>` function "
112122
"and :func:`compute_static_grn() "
113123
"<pygrt.pymod.PyModel1D.compute_static_grn>` function support the "
114-
"following optional parameters to use SAFIM. For detailed "
115-
"explanations, see the API."
124+
"following optional parameters to use SAFIM. For detailed explanations, "
125+
"see the API."
116126

117127
#: ../../source/Advanced/filon/self_adaptive_filon.rst:36
118128
msgid "``safilonTol:float`` 对应C选项卡中的 ``<Ftol>`` 参数"
119-
msgstr ""
120-
"``safilonTol:List`` corresponding to the ``<Ftol>`` in the C tab."
129+
msgstr "``safilonTol:List`` corresponding to the ``<Ftol>`` in the C tab."
121130

122131
#: ../../source/Advanced/filon/self_adaptive_filon.rst:37
123132
msgid "``filonCut:float`` 对应C选项卡中的 ``<Fcut>`` 参数"
124-
msgstr ""
125-
"``filonCut:float`` corresponding to the ``<Fcut>`` in the C tab."
133+
msgstr "``filonCut:float`` corresponding to the ``<Fcut>`` in the C tab."
126134

127135
#: ../../source/Advanced/filon/self_adaptive_filon.rst:41
128136
msgid "示例程序"
@@ -134,13 +142,24 @@ msgstr "use ``-S`` to export kernel function files."
134142

135143
#: ../../source/Advanced/filon/self_adaptive_filon.rst:58
136144
msgid "使用以下Python脚本绘制核函数采样点，"
137-
msgstr ""
138-
"Use the following Python script to plot the kernel sample points,"
145+
msgstr "Use the following Python script to plot the kernel sample points,"
139146

140147
#: ../../source/Advanced/filon/self_adaptive_filon.rst:68
141148
msgid ""
142149
"从对比图可以清晰地看出，自适应采样用更少的点数勾勒核函数的主要特征，这显著提高了计算效率。尽管自适应过程增加了额外的计算量，在小震中距范围内计算优势不明显，"
143150
" **但随着震中距的增加，自适应Filon积分的优势将愈发显著。**"
144151
msgstr ""
145-
"From the comparison chart, it is clear that SAFIM outlines the main features of the kernel function with fewer points, significantly improving computational efficiency. Although the SAFIM adds extra computational overhead, its computational advantage is not obvious in the small epicentral distance range, **but as the epicentral distance increases, the advantage of SAFIM becomes increasingly significant.**"
152+
"From the comparison chart, it is clear that SAFIM outlines the main "
153+
"features of the kernel function with fewer points, significantly "
154+
"improving computational efficiency. Although the SAFIM adds extra "
155+
"computational overhead, its computational advantage is not obvious in the"
156+
" small epicentral distance range, **but as the epicentral distance "
157+
"increases, the advantage of SAFIM becomes increasingly significant.**"
146158

159+
#: ../../source/Advanced/filon/self_adaptive_filon.rst:72
160+
msgid ""
161+
"在程序中，自适应Filon积分不计算近场项，即 :doc:`/Tutorial/dynamic/gfunc` 中介绍的 :math:`p=1` "
162+
"对应的积分项。"
163+
msgstr ""
164+
"In the program, SAFIM does not compute the near-field term, that is, "
165+
"the integral term corresponding to :math:`p=1` introduced in :doc:`/Tutorial/dynamic/gfunc`."

‎docs/source/Advanced/filon/linear_filon.rst‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,3 +76,7 @@
7676

7777
+ ``filonLength:float`` 对应C选项卡中的 ``<Flength>`` 参数
7878
+ ``filonCut:float`` 对应C选项卡中的 ``<Fcut>`` 参数
79+
80+
.. note::
81+
82+
在程序中，固定间隔的Filon积分不计算近场项，即 :doc:`/Tutorial/dynamic/gfunc` 中介绍的 :math:`p=1` 对应的积分项。

‎docs/source/Advanced/filon/self_adaptive_filon.rst‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,4 +65,8 @@
6565
:align: center
6666

6767

68-
从对比图可以清晰地看出，自适应采样用更少的点数勾勒核函数的主要特征，这显著提高了计算效率。尽管自适应过程增加了额外的计算量，在小震中距范围内计算优势不明显， **但随着震中距的增加，自适应Filon积分的优势将愈发显著。**
68+
从对比图可以清晰地看出，自适应采样用更少的点数勾勒核函数的主要特征，这显著提高了计算效率。尽管自适应过程增加了额外的计算量，在小震中距范围内计算优势不明显， **但随着震中距的增加，自适应Filon积分的优势将愈发显著。**
69+
70+
.. note::
71+
72+
在程序中，自适应Filon积分不计算近场项，即 :doc:`/Tutorial/dynamic/gfunc` 中介绍的 :math:`p=1` 对应的积分项。

0 commit comments

Comments
 (0)