Skip to content

DOC: add note about near-field in FIM and SAFIM #46

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jun 26, 2025
Merged

DOC: add note about near-field in FIM and SAFIM #46

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 11 additions & 4 deletions docs/locales/en/LC_MESSAGES/Advanced/filon/linear_filon.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: PyGRT 0.6.1.dev17+g4521452.d20250424\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-05-05 22:22+0800\n"
"POT-Creation-Date: 2025-06-26 18:19+0800\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: en\n"
Expand Down Expand Up @@ -211,11 +211,18 @@ msgstr ""

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

#: ../../source/Advanced/filon/linear_filon.rst:78
msgid "``filonCut:float`` 对应C选项卡中的 ``<Fcut>`` 参数"
msgstr "``filonCut:float`` corresponding to the ``<Fcut>`` in the C tab."

#: ../../source/Advanced/filon/linear_filon.rst:82
msgid ""
"在程序中，固定间隔的Filon积分不计算近场项，即 :doc:`/Tutorial/dynamic/gfunc` 中介绍的 :math:`p=1`"
" 对应的积分项。"
msgstr ""
"``filonCut:float`` corresponding to the ``<Fcut>`` in the C tab."
"In the program, Fixed-Interval FIM does not compute the near-field term, that is, "
"the integral term corresponding to :math:`p=1` introduced in :doc:`/Tutorial/dynamic/gfunc`."


49 changes: 34 additions & 15 deletions docs/locales/en/LC_MESSAGES/Advanced/filon/self_adaptive_filon.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: PyGRT 0.7.1.dev29+g6f42373.d20250505\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-05-05 22:22+0800\n"
"POT-Creation-Date: 2025-06-26 18:19+0800\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: en\n"
Expand Down Expand Up @@ -46,7 +46,14 @@ msgid ""
":ref:`(Chen and Zhang, 2001) <chen_2001>` :ref:`(张海明, 2021) "
"<zhang_book_2021>` 。"
msgstr ""
"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>`."
"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>`."

#: ../../source/Advanced/filon/self_adaptive_filon.rst:16
msgid "参数介绍"
Expand All @@ -67,8 +74,8 @@ msgid ""
":command:`grt -h` 或 :command:`stgrt -h`。"
msgstr ""
"The :command:`grt` and :command:`stgrt` programs support the following "
"optional parameters to use SAFIM. For detailed "
"explanations, see :command:`grt -h` or :command:`stgrt -h`."
"optional parameters to use SAFIM. For detailed explanations, see "
":command:`grt -h` or :command:`stgrt -h`."

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

#: ../../source/Advanced/filon/self_adaptive_filon.rst:29
msgid ""
"``<Ftol>`` 定义自适应采样精度，见 :ref:`(Chen and Zhang, 2001) <chen_2001>` "
":ref:`(张海明, 2021) <zhang_book_2021>`，通常1e-2即可。"
msgstr ""
"``<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."
"``<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."

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

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

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

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

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

#: ../../source/Advanced/filon/self_adaptive_filon.rst:68
msgid ""
"从对比图可以清晰地看出，自适应采样用更少的点数勾勒核函数的主要特征，这显著提高了计算效率。尽管自适应过程增加了额外的计算量，在小震中距范围内计算优势不明显，"
" **但随着震中距的增加，自适应Filon积分的优势将愈发显著。**"
msgstr ""
"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.**"
"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.**"

#: ../../source/Advanced/filon/self_adaptive_filon.rst:72
msgid ""
"在程序中，自适应Filon积分不计算近场项，即 :doc:`/Tutorial/dynamic/gfunc` 中介绍的 :math:`p=1` "
"对应的积分项。"
msgstr ""
"In the program, SAFIM does not compute the near-field term, that is, "
"the integral term corresponding to :math:`p=1` introduced in :doc:`/Tutorial/dynamic/gfunc`."
4 changes: 4 additions & 0 deletions docs/source/Advanced/filon/linear_filon.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,3 +76,7 @@

+ ``filonLength:float`` 对应C选项卡中的 ``<Flength>`` 参数
+ ``filonCut:float`` 对应C选项卡中的 ``<Fcut>`` 参数

.. note::

在程序中，固定间隔的Filon积分不计算近场项，即 :doc:`/Tutorial/dynamic/gfunc` 中介绍的 :math:`p=1` 对应的积分项。
6 changes: 5 additions & 1 deletion docs/source/Advanced/filon/self_adaptive_filon.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,4 +65,8 @@
:align: center


从对比图可以清晰地看出，自适应采样用更少的点数勾勒核函数的主要特征，这显著提高了计算效率。尽管自适应过程增加了额外的计算量，在小震中距范围内计算优势不明显， **但随着震中距的增加，自适应Filon积分的优势将愈发显著。**
从对比图可以清晰地看出，自适应采样用更少的点数勾勒核函数的主要特征，这显著提高了计算效率。尽管自适应过程增加了额外的计算量，在小震中距范围内计算优势不明显， **但随着震中距的增加，自适应Filon积分的优势将愈发显著。**

.. note::

在程序中，自适应Filon积分不计算近场项，即 :doc:`/Tutorial/dynamic/gfunc` 中介绍的 :math:`p=1` 对应的积分项。