Merge branch 'develop' into release-2.1

Author: yomichi

docs/sphinx/en/source/how_to_use/index.rst

@@ -128,7 +128,7 @@ The coordinate information should not be written here because it will obviously
 The lattice sites are specified in a separate abICS input file (see below), 
 and abICS will take care of generating the coordinates section at each sampling step.
 
-.. _subsec_basic_input:
+.. _trainer_specific_notes:
 
 Machine learning trainer/calculator-specific notes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

docs/sphinx/en/source/inputfiles/parameter_solver.rst

@@ -16,6 +16,8 @@ In the present version, there are two main types of solvers.
 
       - Parameters of the DFT solver such as convergence criteria are specified by using input files of the solver.
 
+      - Solver specific notes (e.g., input filename) are described in :ref:`solver_specific_notes`.
+
    - Configurations (atomic positions, atomic species, etc.) are specified by the ``[config]`` section.
 
 - Potts model solver

docs/sphinx/en/source/inputfiles/parameter_train.rst

@@ -3,10 +3,12 @@
 [train] section
 -------------------------------
 
-We create neural network potentials by learning the results of ab initio calculations made by abics\_train using aenet.
-The input information for abics_train is described in the ``[trainer]`` section. The description of each parameter is as follows.
+``abics_train`` creates and trains a regression model from configurations to energies.
+Indeed, ``abics_train`` uses an external program to train the model.
+In the current version, only ``aenet`` is supported as an external program.
+For software-specific notes (such as input file names), see :ref:`trainer_specific_notes`.
 
-This section specifies the type of physical quantity to be acquired.
+The input information for ``abics_train`` is described in the ``[trainer]`` section. The description of each parameter is as follows.
 An example is shown as follows:
 
   ::

docs/sphinx/ja/source/how_to_use/index.rst

@@ -132,7 +132,7 @@ OpenMX
 参照ファイルのパスはabICSの入力ファイルにある ``[solver]`` セクションの ``base_input_dir`` で指定します。
 座標情報については、abICSの入力ファイルを参照するため、記載する必要はありません。
 
-.. _subsec_basic_input:
+.. _trainer_specific_notes:
 
 機械学習モデルソルバー利用時の注意点
 =======================================

docs/sphinx/ja/source/inputfiles/parameter_solver.rst

@@ -17,6 +17,8 @@
 
       - 収束条件など, ソフトウェア固有のパラメータなどはそれぞれの入力ファイルから読み取ります.
 
+      - それぞれのソフトウェア固有の注意事項（入力ファイル名など）は :ref:`solver_specific_notes` を参照してください.
+
    - 原子の存在する座標や原子種などは ``[config]`` セクションで指定します.
 
 - Potts 模型ソルバー

docs/sphinx/ja/source/inputfiles/parameter_train.rst

@@ -4,8 +4,12 @@
 -------------------------------
 
 訓練データから配置エネルギー予測モデルを学習する学習器の設定を行います。
-現在のところ、abICSではaenetのみに対応しています。
-以下のようなファイルフォーマットをしています.
+
+予測モデルの作成・学習には外部のプログラムを利用します。
+現在はaenetのみに対応しています。
+ソフトウェア固有の注意事項（入力ファイル名など）は :ref:`trainer_specific_notes` を参照してください.
+
+本セクションは以下のようなファイルフォーマットをしています.
 
 .. code-block:: toml