pyfemtet 0.4.1__py3-none-any.whl → 0.4.2__py3-none-any.whl

pyfemtet/FemtetPJTSample/NX_ex01/NX_ex01.py

@@ -1,17 +1,20 @@
-"""外部 CAD ソフト NX との連携
+"""External CAD (NX) Integration
 
-外部 CAD ソフト NX で作成したパラメトリックモデルを
-Femtet にインポートして最適化を行います。
+This script performs parametric optimization
+using a project that has imported an external CAD model
+that has been parametrically modeled.
 
-事前準備として、以下の作業を行ってください。
-    - NX_ex01.prt と NX_ex01.femprj を同じフォルダに配置する
-    - C:\temp フォルダを作成する
-        ※ 最適化の実行中に NX から .x_t ファイルがエクスポートされます。
+Please perform the following steps in preparation.
+    - Install NX.
+    - Place NX_ex01.prt, NX_ex01.femprj and .py file in the same folder.
+    - Create C:\\temp folder on your disk.
+        Note: NX exports .x_t files during optimization.
 """
 
 import os
 from pyfemtet.opt import FEMOpt, OptunaOptimizer
 from pyfemtet.opt.interface import FemtetWithNXInterface
+from pyfemtet.core import ModelError
 
 
 here, me = os.path.split(__file__)
@@ -19,35 +22,60 @@ os.chdir(here)
 
 
 def disp(Femtet):
-    """解析結果から Z 方向最大変位を取得します。
-    目的関数の第一引数は Femtet インスタンスである必要があります。
+    """Obtain the maximum displacement in the Z direction from the analysis results.
+
+    Note:
+        The objective or constraint function
+        must take a Femtet as its first argument
+        and must return a single float.
+
+    Warning:
+        CAD integration may assign boundary conditions to unintended locations.
+
+        In this example, if the boundary conditions are assigned as intended,
+        the maximum displacement is always negative.
+        If the maximum displacement is positive,
+        it is assumed that boundary condition assignment has failed
+        and a ModelError is raised.
+        
+        If a ModelError, MeshError, or SolveError is raised during an optimization,
+        the Optimizer considers the trial a failure
+        and skips it to the next trial.
     """
     _, _, ret = Femtet.Gogh.Galileo.GetMaxDisplacement_py()
+
+    if ret >= 0:
+        raise ModelError('The boundary condition assignment is incorrect.')
     return ret
 
 
 def volume(Femtet):
-    """解析結果からモデル体積を取得します。
-    目的関数の第一引数は Femtet インスタンスである必要があります。
-    """
+    """Obtain the volume."""
     _, ret = Femtet.Gogh.CalcVolume_py([0])
     return ret
 
 
 def C_minus_B(_, opt):
-    """C 寸法と B 寸法の差を計算します。
+    """Calculate the difference between C and B dimensions.
 
-    拘束関数の第一引数は Femtet インスタンスである必要がありますが、
-    この例では使用していません。
+    The constraint function must take a Femtet instance as its first argument,
+    but this example does not use it.
 
-    ほかの例では設計変数にアクセスする際以下のスニペットを用いますが、
-    CAD 連携を行う場合、Femtet に設計変数が設定されていないためです。
-        A = Femtet.GetVariableValue('A')
-
-    pyfemtet.opt では目的関数・拘束関数の第二引数以降に任意の変数を設定できます。
-    この例では、第二引数に FEMOpt のメンバー変数 opt を取り、
-    そのメソッド get_parameter() を用いて設計変数を取得しています。
+    Another example uses the following snippet to access design variables:
 
+        A = Femtet.GetVariableValue('A')
+    
+    However, when performing CAD integration,
+    this method does not work because the variables are not set in the .femprj file.
+
+    In CAD integration, design variables are obtained in the following way.
+    
+    The objective function and constraint function can take any variable after the first argument.
+    The member variable opt of FEMOpt has a method called get_parameter().
+    This method can retrieve design variables added by add_parameter().
+    By taking opt as the second argument, you can execute get_parameter()
+    in the objective function or constraint function to obtain the design variables.
+    
     """
     A, B, C = opt.get_parameter('values')
     return C - B
@@ -55,35 +83,36 @@ def C_minus_B(_, opt):
 
 if __name__ == '__main__':
 
-    # NX-Femtet 連携オブジェクトを用意
-    # ここで起動している Femtet と紐づけがされます。
+    # Define NX-Femtet integration object.
+    # At this point, Python is connected to the running Femtet.
     fem = FemtetWithNXInterface(
         prt_path='NX_ex01.prt',
         femprj_path='NX_ex01.femprj',
     )
 
+    # Define mathematical optimization object.
     opt = OptunaOptimizer(
         sampler_kwargs=dict(
             n_startup_trials=5,
         )
     )
 
-    # 最適化処理を行うオブジェクトに連携オブジェクトを紐づけ
+    # Define FEMOpt object (This process integrates mathematical optimization and FEM.).
     femopt = FEMOpt(fem=fem, opt=opt)
 
-    # 設計変数の設定
+    # Add design variables (Use variable names set in NX) to the optimization problem.
     femopt.add_parameter('A', 10, lower_bound=1, upper_bound=59)
     femopt.add_parameter('B', 10, lower_bound=1, upper_bound=40)
     femopt.add_parameter('C', 20, lower_bound=5, upper_bound=59)
 
-    # 拘束関数の設定
+    # Add constraint to the optimization problem.
     femopt.add_constraint(C_minus_B, 'C>B', lower_bound=1, args=femopt.opt)
 
-    # 目的関数の設定
-    femopt.add_objective(disp, name='変位', direction=0)
-    femopt.add_objective(volume, name='体積', direction='minimize')
+    # Add objective to the optimization problem.
+    femopt.add_objective(disp, name='displacement', direction=0)
+    femopt.add_objective(volume, name='volume', direction='minimize')
 
-    # 最適化の実行
+    # Run optimization.
     femopt.set_random_seed(42)
     femopt.optimize(n_trials=20)
     femopt.terminate_all()

pyfemtet/FemtetPJTSample/Sldworks_ex01/Sldworks_ex01.py

@@ -1,12 +1,14 @@
-"""外部 CAD ソフト Solidworks との連携
+"""External CAD (Solidworks) Integration
 
-外部 CAD ソフト Solidworks で作成したパラメトリックモデルを
-Femtet にインポートして最適化を行います。
+This script performs parametric optimization
+using a project that has imported an external CAD model
+that has been parametrically modeled.
 
-事前準備として、以下の作業を行ってください。
-    - Sldworks_ex01.SLDPRT と Sldworks_ex01.femprj を同じフォルダに配置する
-    - C:\temp フォルダを作成する
-        ※ 最適化の実行中に Solidworks から .x_t ファイルがエクスポートされます。
+Please perform the following steps in preparation.
+    - Install Solidworks.
+    - Place Sldworks_ex01.SLDPRT, Sldworks_ex01.femprj and this .py file in the same folder.
+    - Create C:\\temp folder on your disk.
+        Note: NX exports .x_t files during optimization.
 """
 
 import os
@@ -20,45 +22,60 @@ os.chdir(here)
 
 
 def disp(Femtet):
-    """解析結果から Z 方向最大変位を取得します。
-    目的関数の第一引数は Femtet インスタンスである必要があります。
+    """Obtain the maximum displacement in the Z direction from the analysis results.
+
+    Note:
+        The objective or constraint function
+        must take a Femtet as its first argument
+        and must return a single float.
+
+    Warning:
+        CAD integration may assign boundary conditions to unintended locations.
+
+        In this example, if the boundary conditions are assigned as intended,
+        the maximum displacement is always negative.
+        If the maximum displacement is positive,
+        it is assumed that boundary condition assignment has failed
+        and a ModelError is raised.
+
+        If a ModelError, MeshError, or SolveError is raised during an optimization,
+        the Optimizer considers the trial a failure
+        and skips it to the next trial.
     """
     _, _, ret = Femtet.Gogh.Galileo.GetMaxDisplacement_py()
 
-    # CAD 連携の場合、境界条件をトポロジーIDに基づいて割り当てているので、
-    # 意図しない箇所に境界条件が割り当てられることがあります。
-    # この問題では意図通りの割り当てができていれば最大変位は必ず負なので
-    # 答えが正の場合は境界条件割り当てに失敗しているとみなして
-    # ModelError を送出するようにします。
-    # 最適化ルーチン中に ModelError, MeshError, SolveError が送出された場合
-    # Optimizer はその試行を失敗とみなし、スキップして次の試行を行います。
     if ret >= 0:
-        raise ModelError('境界条件の割り当てが間違えています。')
+        raise ModelError('The boundary condition assignment is incorrect.')
     return ret
 
 
 def volume(Femtet):
-    """解析結果からモデル体積を取得します。
-    目的関数の第一引数は Femtet インスタンスである必要があります。
-    """
+    """Obtain the volume."""
     _, ret = Femtet.Gogh.CalcVolume_py([0])
     return ret
 
 
 def C_minus_B(_, opt):
-    """C 寸法と B 寸法の差を計算します。
-
-    拘束関数の第一引数は Femtet インスタンスである必要がありますが、
-    この例では使用していません。
+    """Calculate the difference between C and B dimensions.
 
-    ほかの例では設計変数にアクセスする際以下のスニペットを用いますが、
-    CAD 連携を行う場合、Femtet に設計変数が設定されていないためです。
-        A = Femtet.GetVariableValue('A')
+    The constraint function must take a Femtet instance as its first argument,
+    but this example does not use it.
 
-    pyfemtet.opt では目的関数・拘束関数の第二引数以降に任意の変数を設定できます。
-    この例では、第二引数に FEMOpt のメンバー変数 opt を取り、
-    そのメソッド get_parameter() を用いて設計変数を取得しています。
+    Another example uses the following snippet to access design variables:
 
+        A = Femtet.GetVariableValue('A')
+    
+    However, when performing CAD integration,
+    this method does not work because the variables are not set in the .femprj file.
+
+    In CAD integration, design variables are obtained in the following way.
+    
+    The objective function and constraint function can take any variable after the first argument.
+    The member variable opt of FEMOpt has a method called get_parameter().
+    This method can retrieve design variables added by add_parameter().
+    By taking opt as the second argument, you can execute get_parameter()
+    in the objective function or constraint function to obtain the design variables.
+    
     """
     A, B, C = opt.get_parameter('values')
     return C - B
@@ -66,34 +83,39 @@ def C_minus_B(_, opt):
 
 if __name__ == '__main__':
 
-    # Solidworks-Femtet 連携オブジェクトを用意
-    # ここで起動している Femtet と紐づけがされます。
+    # Define Solidworks-Femtet integration object.
+    # At this point, Python is connected to the running Femtet.
     fem = FemtetWithSolidworksInterface(
         sldprt_path='Sldworks_ex01.SLDPRT',
         femprj_path='Sldworks_ex01.femprj',
     )
 
+    # Define mathematical optimization object.
     opt = OptunaOptimizer(
         sampler_kwargs=dict(
             n_startup_trials=5,
         )
     )
 
-    # 最適化処理を行うオブジェクトに連携オブジェクトを紐づけ
+    # Define FEMOpt object (This process integrates mathematical optimization and FEM.).
     femopt = FEMOpt(fem=fem, opt=opt)
 
-    # 設計変数の設定
+    # Add design variables (Use variable names set in NX) to the optimization problem.
     femopt.add_parameter('A', 10, lower_bound=1, upper_bound=59)
     femopt.add_parameter('B', 10, lower_bound=1, upper_bound=40)
     femopt.add_parameter('C', 20, lower_bound=5, upper_bound=59)
 
-    # 拘束関数の設定
+    # Add constraint to the optimization problem.
+    # Note that we use the ``args`` keyword
+    # to pass femopt.opt as an argument
+    # to the constraint function ``C_minus_B``.
     femopt.add_constraint(C_minus_B, 'C>B', lower_bound=1, args=femopt.opt)
 
-    # 目的関数の設定
-    femopt.add_objective(disp, name='変位', direction=0)
-    femopt.add_objective(volume, name='体積', direction='minimize')
+    # Add objective to the optimization problem.
+    femopt.add_objective(disp, name='displacement', direction=0)
+    femopt.add_objective(volume, name='volume', direction='minimize')
 
-    # 最適化の実行
+    # Run optimization.
     femopt.set_random_seed(42)
     femopt.optimize(n_trials=20)
+    femopt.terminate_all()

pyfemtet/FemtetPJTSample/gau_ex08_parametric.py

@@ -1,26 +1,30 @@
-"""有限長ソレノイドコイルの自己インダクタンス
+"""Single-objective optimization: self-inductance of a finite length solenoid coil
 
-gau_ex08_parametric.femprj に対し磁場解析を行い、
-自己インダクタンスを特定の値にする
-有限長さソレノイドコイルの寸法を探索します。
+Perform magnetic field analysis on gau_ex08_parametric.femprj
+to find the dimensions of a finite length solenoid coil
+that makes the self-inductance a specific value.
 """
 from optuna.integration.botorch import BoTorchSampler
 from pyfemtet.opt import FEMOpt, OptunaOptimizer
 
 
 def inductance(Femtet):
-    """Femtet の解析結果から自己インダクタンスを取得します。
+    """Get the self-inductance.
 
-    Femtet : マクロを使用するためのインスタンスです。詳しくは "Femtet マクロヘルプ / CFemtet クラス" をご覧ください。
-        目的関数は第一引数に Femtet インスタンスを取る必要があります。
+    Note:
+        The objective or constraint function
+        must take a Femtet as its first argument
+        and must return a single float.
 
-    l : 計算された自己インダクタンスです。
-        目的関数は単一の float を返す必要があります。
+    Params:
+        Femtet: An instance for using Femtet macros. For more information, see "Femtet Macro Help / CFemtet Class".
 
+    Returns:
+        float: Self-inductance.
     """
     Gogh = Femtet.Gogh
 
-    # インダクタンスの取得
+    # Get inductance.
     cName = Gogh.Gauss.GetCoilList()[0]
     l = Gogh.Gauss.GetL(cName, cName)
     return l  # F
@@ -28,7 +32,7 @@ def inductance(Femtet):
 
 if __name__ == '__main__':
 
-    # 最適化手法を定義するオブジェクトを用意
+    # Define mathematical optimization object.
     opt = OptunaOptimizer(
         sampler_class=BoTorchSampler,
         sampler_kwargs=dict(
@@ -36,20 +40,19 @@ if __name__ == '__main__':
         )
     )
 
-    # 最適化処理を行うオブジェクトを用意
-    femopt = FEMOpt(opt=opt)  # ここで起動している Femtet が紐づけされます
+    # Define FEMOpt object (This process integrates mathematical optimization and FEM.).
+    femopt = FEMOpt(opt=opt)
 
-    # 設計変数の登録
-    femopt.add_parameter("h", 3, lower_bound=1.5, upper_bound=6, memo='1巻きピッチ')
-    femopt.add_parameter("r", 5, lower_bound=1, upper_bound=10, memo='コイル半径')
-    femopt.add_parameter("n", 3, lower_bound=1, upper_bound=5, memo='コイル巻き数')
+    # Add design variables (Use variable names set in Femtet) to the optimization problem.
+    femopt.add_parameter("h", 3, lower_bound=1.5, upper_bound=6)
+    femopt.add_parameter("r", 5, lower_bound=1, upper_bound=10)
+    femopt.add_parameter("n", 3, lower_bound=1, upper_bound=5)
 
-    # インダクタンスが 0.1 uF に近づくようにゴールを設定
-    femopt.add_objective(
-        inductance, name='自己インダクタンス', direction=0.1e-06
-        )
+    # Add objective to the optimization problem.
+    # The target inductance value is 0.1 uF.
+    femopt.add_objective(inductance, name='self-inductance', direction=0.1e-06)
 
-    # 最適化の実行
+    # Run optimization.
     femopt.set_random_seed(42)
     femopt.optimize(n_trials=20)
     femopt.terminate_all()

pyfemtet/FemtetPJTSample/her_ex40_parametric.py

@@ -1,3 +1,9 @@
+"""Single-objective optimization: Resonant frequency of a circular patch antenna
+
+Using Femtet’s electromagnetic wave analysis solver,
+we explain an example of setting the resonant frequency
+of a circular patch antenna to a specific value.
+"""
 from time import sleep
 
 import numpy as np
@@ -8,9 +14,8 @@ from optuna.integration.botorch import BoTorchSampler
 from pyfemtet.opt import OptunaOptimizer, FEMOpt
 
 
-
 class SParameterCalculator:
-    """S パラメータ・共振周波数計算用クラスです。"""
+    """This class is for calculating S-parameters and resonance frequencies."""
     
     def __init__(self):
         self.freq = []
@@ -20,51 +25,55 @@ class SParameterCalculator:
         self.minimum_S = None
 
     def get_result_from_Femtet(self, Femtet):
-        """Femtet の解析結果から周波数と S パラメータの関係を取得します。"""
+        """Obtain the relationship between frequency and S-parameter from the Femtet analysis results."""
 
-        # 前準備
+        # Preparation
         Femtet.OpenCurrentResult(True)
         Gogh = Femtet.Gogh
         
-        # 各モードに対して周波数と S(1,1) を取得する
+        # Obtain the frequency and S(1,1) for each mode
         mode = 0
         freq_list = []
         dB_S_list = []
-        for mode in tqdm(range(Gogh.Hertz.nMode), '結果取得中'):
-            # Femtet 結果画面のモード設定
+        for mode in tqdm(range(Gogh.Hertz.nMode), 'Obtaining frequency and S-parameter'):
+            # Femtet result screen mode settings
             Gogh.Hertz.Mode = mode
             sleep(0.01)
-            # 周波数の取得
+            # Get frequency
             freq = Gogh.Hertz.GetFreq().Real
-            # S パラメータの取得
+            # Get S-parameters
             comp_S = Gogh.Hertz.GetSMatrix(0, 0)
             norm = np.linalg.norm((comp_S.Real, comp_S.Imag))
             dB_S = 20 * np.log10(norm)
-            # 結果の取得
+            # Get results
             freq_list.append(freq)
             dB_S_list.append(dB_S)
         self.freq = freq_list
         self.S = dB_S_list
 
     def calc_resonance_frequency(self):
-        """S に対して最初のピークを与える freq を計算します。"""
+        """Compute the frequency that gives the first peak for S-parameter."""
         x = -np.array(self.S)
         peaks, _ = find_peaks(x, height=None, threshold=None, distance=None, prominence=0.5, width=None, wlen=None, rel_height=0.5, plateau_size=None)
         from pyfemtet.core import SolveError
         if len(peaks) == 0:
-            raise SolveError('ピークが検出されませんでした。')
+            raise SolveError('No peaks detected.')
         self.resonance_frequency = self.freq[peaks[0]]
         self.minimum_S = self.S[peaks[0]]
 
     def get_resonance_frequency(self, Femtet):
-        """共振周波数を計算します。
-
-        Femtet : マクロを使用するためのインスタンスです。詳しくは "Femtet マクロヘルプ / CFemtet クラス" をご覧ください。
-            目的関数は第一引数に Femtet インスタンスを取る必要があります。
+        """Calculate the resonant frequency.
 
-        f : 計算された共振周波数です。
-            目的関数は単一の float を返す必要があります。
+        Note:
+            The objective or constraint function
+            must take a Femtet as its first argument
+            and must return a single float.
 
+        Params:
+            Femtet: An instance for using Femtet macros. For more information, see "Femtet Macro Help / CFemtet Class".
+        
+        Returns:
+            float: A resonance frequency.
         """
         self.get_result_from_Femtet(Femtet)
         self.calc_resonance_frequency()
@@ -73,14 +82,16 @@ class SParameterCalculator:
         
 
 def antenna_is_smaller_than_substrate(Femtet):
-    """アンテナのサイズと基板のサイズの関係を計算します。
-
-    Femtet : マクロを使用するためのインスタンスです。詳しくは "Femtet マクロヘルプ / CFemtet クラス" をご覧ください。
-        拘束関数は第一引数に Femtet インスタンスを取る必要があります。
+    """Calculate the relationship between antenna size and board size.
 
-    Sx/2 - ant_r : 基板サイズとアンテナサイズの差です。
-        拘束関数は単一の float を返す必要があります。
+    This function is used to constrain the model
+    from breaking down while changing parameters.
 
+    Params:
+        Femtet: An instance for using Femtet macros.
+    
+    Returns:
+        float: Difference between the board size and antenna size. Must be equal to or grater than 1 mm.
     """
     ant_r = Femtet.GetVariableValue('ant_r')
     Sx = Femtet.GetVariableValue('sx')
@@ -88,14 +99,16 @@ def antenna_is_smaller_than_substrate(Femtet):
 
 
 def port_is_inside_antenna(Femtet):
-    """給電ポートの位置とアンテナのサイズの関係を計算します。
-
-    Femtet : マクロを使用するためのインスタンスです。詳しくは "Femtet マクロヘルプ / CFemtet クラス" をご覧ください。
-        拘束関数は第一引数に Femtet インスタンスを取る必要があります。
+    """Calculate the relationship between the feed port location and antenna size.
 
-    ant_r - xf : アンテナ辺縁と給電ポートの位置の差です。
-        拘束関数は単一の float を返す必要があります。
+    This function is used to constrain the model
+    from breaking down while changing parameters.
 
+    Params:
+        Femtet: An instance for using Femtet macros.
+    
+    Returns:
+        float: Difference between the antenna edge and the position of the feed port. Must be equal to or grater than 1 mm.
     """
     ant_r = Femtet.GetVariableValue('ant_r')
     xf = Femtet.GetVariableValue('xf')
@@ -103,10 +116,10 @@ def port_is_inside_antenna(Femtet):
 
 
 if __name__ == '__main__':
-    # S パラメータ計算用クラス
+    # Define the object for calculating S-parameters and resonance frequencies.
     s = SParameterCalculator()
 
-    # 最適化手法を定義するオブジェクトを用意
+    # Define mathematical optimization object.
     opt = OptunaOptimizer(
         sampler_class=BoTorchSampler,
         sampler_kwargs=dict(
@@ -114,22 +127,21 @@ if __name__ == '__main__':
         )
     )
     
-    # 最適化処理を行うオブジェクトを用意
-    femopt = FEMOpt(
-        opt=opt,
-    )  # ここで起動している Femtet が紐づけされます
+    # Define FEMOpt object (This process integrates mathematical optimization and FEM.).
+    femopt = FEMOpt(opt=opt)
     
-    # 設計変数の設定
-    femopt.add_parameter('ant_r', 10, 5, 20, memo='円形アンテナの半径')
-    femopt.add_parameter('sx', 50, 40, 60, memo='基板のサイズ')
-    femopt.add_parameter('xf', 5, 1, 20, memo='給電ポートの偏心量')
-
-    # 拘束の設定
-    femopt.add_constraint(antenna_is_smaller_than_substrate, 'アンテナサイズ', lower_bound=1)
-    femopt.add_constraint(port_is_inside_antenna, 'ポート位置', lower_bound=1)
-
-    # 目的の設定
-    femopt.add_objective(s.get_resonance_frequency, '第一共振周波数（GHz）', direction=3.0)
+    # Add design variables (Use variable names set in Femtet) to the optimization problem.
+    femopt.add_parameter('ant_r', 10, 5, 20)
+    femopt.add_parameter('sx', 50, 40, 60)
+    femopt.add_parameter('xf', 5, 1, 20)
+
+    # Add constraint to the optimization problem.
+    femopt.add_constraint(antenna_is_smaller_than_substrate, 'board_antenna_clearance', lower_bound=1)
+    femopt.add_constraint(port_is_inside_antenna, 'antenna_port_clearance', lower_bound=1)
+
+    # Add objective to the optimization problem.
+    # The target frequency is 3 GHz.
+    femopt.add_objective(s.get_resonance_frequency, 'First_resonant_frequency(GHz)', direction=3.0)
 
     femopt.set_random_seed(42)
     femopt.optimize(n_trials=20)

pyfemtet/FemtetPJTSample/wat_ex14_parallel_parametric.py

@@ -1,23 +1,26 @@
-"""基板上の発熱体
+"""Parallel computing / Multi-objective optimization: heating element on board
 
-wat_ex14_parametric.femprj に対し熱伝導解析を行い、
-チップの発熱による温度上昇を最小にしつつ
-基板寸法を最小にする
-基板寸法・チップ配置寸法を探索します。
+Perform thermal conduction analysis on wat_ex14_parametric.femprj
+and search for board dimensions and chip placement dimensions that
+minimize the board dimensions while minimizing the temperature rise
+due to chip heat generation.
 """
-
 from pyfemtet.opt import FEMOpt
 
 
 def max_temperature(Femtet, body_name):
-    """Femtet の解析結果からチップの最高温度を取得します。
+    """Get the maximum temperature of the chip.
 
-    Femtet : マクロを使用するためのインスタンスです。詳しくは "Femtet マクロヘルプ / CFemtet クラス" をご覧ください。
-        目的関数は第一引数に Femtet インスタンスを取る必要があります。
+    Note:
+        The objective or constraint function
+        must take a Femtet as its first argument
+        and must return a single float.
 
-    max_temp : 計算された最高温度です。
-        目的関数は単一の float を返す必要があります。
+    Params:
+        Femtet: An instance for using Femtet macros. For more information, see "Femtet Macro Help / CFemtet Class".
 
+    Returns:
+        float: Max-temperature.
     """
     Gogh = Femtet.Gogh
 
@@ -27,14 +30,13 @@ def max_temperature(Femtet, body_name):
 
 
 def substrate_size(Femtet):
-    """Femtet の設計変数から基板サイズを取得します。
-
-    Femtet : マクロを使用するためのインスタンスです。詳しくは "Femtet マクロヘルプ / CFemtet クラス" をご覧ください。
-        目的関数は第一引数に Femtet インスタンスを取る必要があります。
-
-    subs_w * subs_d : XY 平面における基板の占有面積です。
-        目的関数は単一の float を返す必要があります。
+    """Calculate the substrate size.
 
+    Params:
+        Femtet: An instance for using Femtet macros. For more information, see "Femtet Macro Help / CFemtet Class".
+    
+    Returns:
+        float: The area occupied by the board in the XY plane.
     """
     subs_w = Femtet.GetVariableValue('substrate_w')
     subs_d = Femtet.GetVariableValue('substrate_d')
@@ -44,20 +46,20 @@ def substrate_size(Femtet):
 
 if __name__ == '__main__':
 
-    # 最適化処理を行うオブジェクトを用意
+    # Define FEMOpt object (This process integrates mathematical optimization and FEM.).
     femopt = FEMOpt()
 
-    # 設計変数の設定
-    femopt.add_parameter("substrate_w", 40, lower_bound=22, upper_bound=40, memo='基板サイズ X')
-    femopt.add_parameter("substrate_d", 60, lower_bound=33, upper_bound=60, memo='基板サイズ Y')
+    # Add design variables (Use variable names set in Femtet) to the optimization problem.
+    femopt.add_parameter("substrate_w", 40, lower_bound=22, upper_bound=40)
+    femopt.add_parameter("substrate_d", 60, lower_bound=33, upper_bound=60)
 
-    # 目的関数の設定
-    femopt.add_objective(max_temperature, name='メインチップ温度', args=('MAINCHIP',))
-    femopt.add_objective(max_temperature, name='サブチップ温度', args=('SUBCHIP',))
-    femopt.add_objective(substrate_size, name='基板サイズ')
+    # Add objective to the optimization problem.
+    femopt.add_objective(max_temperature, name='main chip temp.', args=('MAINCHIP',))
+    femopt.add_objective(max_temperature, name='sub chip temp.', args=('SUBCHIP',))
+    femopt.add_objective(substrate_size, name='substrate size')
 
-    # 最適化の実行
+    # Run optimization.
     femopt.set_random_seed(42)
-    # femopt.main(n_trials=20)
-    femopt.optimize(n_trials=20, n_parallel=3)  # ここのみ wat_ex14_parametric.py から変更しました。
+    # femopt.optimize(n_trials=20)
+    femopt.optimize(n_trials=20, n_parallel=3)  # Change only this line.
     femopt.terminate_all()

pyfemtet/FemtetPJTSample/wat_ex14_parametric.py

@@ -1,23 +1,26 @@
-"""基板上の発熱体
+"""Multi-objective optimization: heating element on board
 
-wat_ex14_parametric.femprj に対し熱伝導解析を行い、
-チップの発熱による温度上昇を最小にしつつ
-基板寸法を最小にする
-基板寸法・チップ配置寸法を探索します。
+Perform thermal conduction analysis on wat_ex14_parametric.femprj
+and search for board dimensions and chip placement dimensions that
+minimize the board dimensions while minimizing the temperature rise
+due to chip heat generation.
 """
-
 from pyfemtet.opt import FEMOpt
 
 
 def max_temperature(Femtet, body_name):
-    """Femtet の解析結果からチップの最高温度を取得します。
+    """Get the maximum temperature of the chip.
 
-    Femtet : マクロを使用するためのインスタンスです。詳しくは "Femtet マクロヘルプ / CFemtet クラス" をご覧ください。
-        目的関数は第一引数に Femtet インスタンスを取る必要があります。
+    Note:
+        The objective or constraint function
+        must take a Femtet as its first argument
+        and must return a single float.
 
-    max_temp : 計算された最高温度です。
-        目的関数は単一の float を返す必要があります。
+    Params:
+        Femtet: An instance for using Femtet macros. For more information, see "Femtet Macro Help / CFemtet Class".
 
+    Returns:
+        float: Max-temperature.
     """
     Gogh = Femtet.Gogh
 
@@ -27,14 +30,13 @@ def max_temperature(Femtet, body_name):
 
 
 def substrate_size(Femtet):
-    """Femtet の設計変数から基板サイズを取得します。
-
-    Femtet : マクロを使用するためのインスタンスです。詳しくは "Femtet マクロヘルプ / CFemtet クラス" をご覧ください。
-        目的関数は第一引数に Femtet インスタンスを取る必要があります。
-
-    subs_w * subs_d : XY 平面における基板の占有面積です。
-        目的関数は単一の float を返す必要があります。
+    """Calculate the substrate size.
 
+    Params:
+        Femtet: An instance for using Femtet macros. For more information, see "Femtet Macro Help / CFemtet Class".
+    
+    Returns:
+        float: The area occupied by the board in the XY plane.
     """
     subs_w = Femtet.GetVariableValue('substrate_w')
     subs_d = Femtet.GetVariableValue('substrate_d')
@@ -44,19 +46,19 @@ def substrate_size(Femtet):
 
 if __name__ == '__main__':
 
-    # 最適化処理を行うオブジェクトを用意
+    # Define FEMOpt object (This process integrates mathematical optimization and FEM.).
     femopt = FEMOpt()
 
-    # 設計変数の設定
-    femopt.add_parameter("substrate_w", 40, lower_bound=22, upper_bound=40, memo='基板サイズ X')
-    femopt.add_parameter("substrate_d", 60, lower_bound=33, upper_bound=60, memo='基板サイズ Y')
+    # Add design variables (Use variable names set in Femtet) to the optimization problem.
+    femopt.add_parameter("substrate_w", 40, lower_bound=22, upper_bound=40)
+    femopt.add_parameter("substrate_d", 60, lower_bound=33, upper_bound=60)
 
-    # 目的関数の設定
-    femopt.add_objective(max_temperature, name='メインチップ温度', args=('MAINCHIP',))
-    femopt.add_objective(max_temperature, name='サブチップ温度', args=('SUBCHIP',))
-    femopt.add_objective(substrate_size, name='基板サイズ')
+    # Add objective to the optimization problem.
+    femopt.add_objective(max_temperature, name='main chip temp.', args=('MAINCHIP',))
+    femopt.add_objective(max_temperature, name='sub chip temp.', args=('SUBCHIP',))
+    femopt.add_objective(substrate_size, name='substrate size')
 
-    # 最適化の実行
+    # Run optimization.
     femopt.set_random_seed(42)
     femopt.optimize(n_trials=20)
     femopt.terminate_all()

pyfemtet/__init__.py

@@ -1 +1 @@
-__version__ = "0.4.1"
+__version__ = "0.4.2"

pyfemtet/opt/_femopt_core.py

@@ -374,7 +374,6 @@ class History:
     prm_names = []
     obj_names = []
     cns_names = []
-    local_data = pd.DataFrame()
     is_restart = False
     is_processing = False
     _future = None
@@ -397,6 +396,9 @@ class History:
         self.cns_names = cns_names
         self.additional_metadata = additional_metadata or ''
 
+        # 初期化
+        self.local_data = pd.DataFrame()
+
         # 最適化実行中かどうか
         self.is_processing = client is not None
 

pyfemtet/opt/interface/_femtet.py

@@ -126,7 +126,7 @@ class FemtetInterface(FEMInterface):
                     sleep(1)
                 sleep(1)
 
-            except AttributeError:  # already dead
+            except (AttributeError, OSError):  # already dead
                 pass
         # CoUninitialize()  # Win32 exception occurred releasing IUnknown at 0x0000022427692748
 

pyfemtet/opt/opt/_optuna.py

@@ -155,6 +155,12 @@ class OptunaOptimizer(AbstractOptimizer):
 
                 # add_initial_parameter で追加された初期値
                 for prm, prm_set_name in self.additional_initial_parameter:
+                    if type(prm) is dict:
+                        assert prm.keys() == params.keys(), '設定されたパラメータ名と add_init_parameter で追加されたパラメータ名が一致しません。'
+                    else:
+                        assert len(prm) == len(params.keys()), '設定されたパラメータ数と add_init_parameter で追加されたパラメータ数が一致しません。'
+                        prm = dict(zip(params.keys(), prm))
+
                     self.study.enqueue_trial(
                         prm,
                         user_attrs={"message": prm_set_name}

{pyfemtet-0.4.1.dist-info → pyfemtet-0.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyfemtet
-Version: 0.4.1
+Version: 0.4.2
 Summary: Design parameter optimization using Femtet.
 Home-page: https://github.com/pyfemtet/pyfemtet
 License: BSD-3-Clause
@@ -35,7 +35,8 @@ Description-Content-Type: text/markdown
 PyFemtet is the extension package for Femtet with Python.
 
 - Femtet Website: https://www.muratasoftware.com/
-- Documentation: https://pyfemtet.github.io/pyfemtet/
+- Documentation (English): https://pyfemtet.readthedocs.io/en/stable/
+- ドキュメント（日本語）: https://pyfemtet.readthedocs.io/jp/stable/
 - Source code: https://github.com/pyfemtet/pyfemtet
 - Bug reports: https://github.com/pyfemtet/pyfemtet/issues
 

{pyfemtet-0.4.1.dist-info → pyfemtet-0.4.2.dist-info}/RECORD

@@ -1,38 +1,38 @@
 pyfemtet/FemtetPJTSample/NX_ex01/NX_ex01.femprj,sha256=JfzRl_C72doQFJO0hJq8BTX6TSFB_Skh2C4l-kiWoXY,170268
 pyfemtet/FemtetPJTSample/NX_ex01/NX_ex01.prt,sha256=3okHLeMdslrRA_wkhppZtxIe-2-ZPMfNqWCdQwUV31o,226626
-pyfemtet/FemtetPJTSample/NX_ex01/NX_ex01.py,sha256=78Ajx05h7OgRmBWHXe0d3uqfoUQSfvsR8CO9UhU1cjU,3064
+pyfemtet/FemtetPJTSample/NX_ex01/NX_ex01.py,sha256=YJ3nszFLYfd7m4CaQ6ZG9DS_aHdgQIdSHCopmGakBWE,3980
 pyfemtet/FemtetPJTSample/Sldworks_ex01/Sldworks_ex01.SLDPRT,sha256=U0Yh559Fygd5sp013NwwhZ5vRA8D_E6kmiUXDP5isJQ,83094
 pyfemtet/FemtetPJTSample/Sldworks_ex01/Sldworks_ex01.femprj,sha256=omF3QvS8gzi_fSr2yobbVVaspR2YzDiUcMYvei-8ZmQ,155307
-pyfemtet/FemtetPJTSample/Sldworks_ex01/Sldworks_ex01.py,sha256=1AMFKAcXEEBUIkvqJB5mTzzdj_7mOTfBHqEtsGRIjVE,3901
+pyfemtet/FemtetPJTSample/Sldworks_ex01/Sldworks_ex01.py,sha256=Irv3nNXkQpCGZgy41IcWwGKVddW6oOziwe6EyantUn4,4182
 pyfemtet/FemtetPJTSample/gau_ex08_parametric.femprj,sha256=EguPWZHcwZMMX8cX1rZhLc2Pr__P4PR8RF4_n4uxDaI,268761
-pyfemtet/FemtetPJTSample/gau_ex08_parametric.py,sha256=4q4mCUz_N6MC9K45FP4kOHQlp0IvD4ItnESHxpWtgEQ,2013
+pyfemtet/FemtetPJTSample/gau_ex08_parametric.py,sha256=B-ibQDodTLcJ-wc8sNVb1Dxae2ksL6Fns3uNBRU7s5g,1799
 pyfemtet/FemtetPJTSample/her_ex40_parametric.femprj,sha256=ZFQ1Rl31dmLhYW__yahRYLejKw5DdccPGdpg67CWlS0,126336
-pyfemtet/FemtetPJTSample/her_ex40_parametric.py,sha256=IkUESNiNpZxGbmnYgp4QqFQurNA27uNsT_ogj-3uYRw,5172
-pyfemtet/FemtetPJTSample/wat_ex14_parallel_parametric.py,sha256=sfWqEFXJjEOP6Hff28U6BpSZBFWtpAjWlFCUEwnNuDg,2401
+pyfemtet/FemtetPJTSample/her_ex40_parametric.py,sha256=B5PQoh71Q3KN2CyLU1gP_Yh9g3o6poi0HFasWzHQ_vk,5144
+pyfemtet/FemtetPJTSample/wat_ex14_parallel_parametric.py,sha256=UfhJffuXyhzdIWNpOrpV6xLTK1fuVvgyhlyg4Rp-628,2148
 pyfemtet/FemtetPJTSample/wat_ex14_parametric.femprj,sha256=pxacKe0NPNUPAcxqo2cATFApsMKiVt2g2e_FOk4fpjA,172895
-pyfemtet/FemtetPJTSample/wat_ex14_parametric.py,sha256=Z9mH67rh7GBm86UA6OdhBeiGAGpssRGoUlgzw7T3wfc,2289
-pyfemtet/__init__.py,sha256=IfrBKs_W4usv6LOPMiFXYlA5wFjjr8eb0zFW3FWiUtM,21
+pyfemtet/FemtetPJTSample/wat_ex14_parametric.py,sha256=LGbWxCek0Ad2YrDCKykiQkE3aIypM4g8P3mLd_2anEE,2052
+pyfemtet/__init__.py,sha256=Y-I6FXKes4hB39WcBm3HZ1OCtCWiErPB6YZ-YSgexuE,21
 pyfemtet/core.py,sha256=3lqfBGJ5IuKz2Nqj5pRo7YQqKwx_0ZDL72u95Ur_1p0,1386
 pyfemtet/dispatch_extensions.py,sha256=MhWiUXVt2Cq8vDeajMK4SrajjiAmb4m2fK8gXwHLrWA,16177
 pyfemtet/logger.py,sha256=JYD0FvzijMS2NvZN7VT7vZA5hqtHEkvS93AHlIMDePw,2507
 pyfemtet/opt/__init__.py,sha256=_P8unESvqCRD5pmuo6-5yo7BbrPi7c0aE6UZpqUD-_I,596
 pyfemtet/opt/_femopt.py,sha256=mkawFpY0UXENeJYuH2mkLpNgUncIWY3QYMHUj-lL-4o,20602
-pyfemtet/opt/_femopt_core.py,sha256=Ju0Ghto2EnmVyaimpjGUk9FjTmNRdbpQLLmOwU60eMQ,24331
+pyfemtet/opt/_femopt_core.py,sha256=bCSb1XvqeEfX6T2Z24eLI8nIa82omy8_Pnf5HXEmEsQ,24361
 pyfemtet/opt/interface/__init__.py,sha256=qz5BszPuU3jZIoDnPjkPDAgvgHLlx1sYhuqh5ID798k,480
 pyfemtet/opt/interface/_base.py,sha256=lDjdvKYmBMxSc7SfoWSu91qVijGaQ2Ng-0C7z_f4eFM,2079
-pyfemtet/opt/interface/_femtet.py,sha256=PenHHV_FofsgPdDwzbytS3EKkaR7HZKHRAQCGYZSxYM,24428
+pyfemtet/opt/interface/_femtet.py,sha256=VzwJ4srviYIb9X4HNDx1_W2w2xUpNYBxa928qBZpdAc,24439
 pyfemtet/opt/interface/_femtet_with_nx/__init__.py,sha256=-6W2g2FDEcKzGHmI5KAKQe-4U5jDpMj0CXuma-GZca0,83
 pyfemtet/opt/interface/_femtet_with_nx/_interface.py,sha256=OU0nYmePEVKsjplokisfyuaepB-PkL6E-cwCiIhXNS0,4192
 pyfemtet/opt/interface/_femtet_with_nx/update_model.py,sha256=t0AB7mKY7rmrI_9stP1-5qhzmugEQ19DnZ4CCrCdTSw,2856
 pyfemtet/opt/interface/_femtet_with_sldworks.py,sha256=t3CZ-ni2kXBpbCdr9C5xEc2GHgW8LscJNMV97wJRnTk,6515
 pyfemtet/opt/opt/__init__.py,sha256=eQh-7PJN2YEUbHZnjinbeIyb0bk1wSh76TaEAa2l8SU,191
 pyfemtet/opt/opt/_base.py,sha256=aO71a8lIHHb5xIEoIu7oO_maynrNIEHfwt4uFFOUY58,7101
-pyfemtet/opt/opt/_optuna.py,sha256=F2CZ88b0EewkaAlzyH4MxNBAtth8JqZq8i58sIOe2NE,9506
+pyfemtet/opt/opt/_optuna.py,sha256=TWtp9auU6GBWtEJVOuo8aWSvLcCHCUNUyOQRnqyln4I,9996
 pyfemtet/opt/visualization/__init__.py,sha256=PUCHoZnuZrHjTd0QQQBgzWkCpKY2noBPTvi-lyvxQyw,193
 pyfemtet/opt/visualization/_graphs.py,sha256=G6HaoGD3GpuwXih1nuTeFQMD0zv4jrhogedP9hxaG1c,5306
 pyfemtet/opt/visualization/_monitor.py,sha256=WcbuMjnp5LiybwCYBnJ78ju2h7sBJJtqUf1CbUacfXI,42104
-pyfemtet-0.4.1.dist-info/LICENSE,sha256=sVQBhyoglGJUu65-BP3iR6ujORI6YgEU2Qm-V4fGlOA,1485
-pyfemtet-0.4.1.dist-info/METADATA,sha256=H4GyusBGs-BN-Hxso394zZHFmyMewLswXZ9WMUzA4mA,1752
-pyfemtet-0.4.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-pyfemtet-0.4.1.dist-info/entry_points.txt,sha256=E_NUq8BEuKLM3z6Ou0sh6HyvaKE5O6NBDlmO-wgEGaQ,67
-pyfemtet-0.4.1.dist-info/RECORD,,
+pyfemtet-0.4.2.dist-info/LICENSE,sha256=sVQBhyoglGJUu65-BP3iR6ujORI6YgEU2Qm-V4fGlOA,1485
+pyfemtet-0.4.2.dist-info/METADATA,sha256=Dl3D0ipVFiUvEwcDOMbp5c8N3gPvLzjvg7Wuc7ahrCA,1848
+pyfemtet-0.4.2.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+pyfemtet-0.4.2.dist-info/entry_points.txt,sha256=E_NUq8BEuKLM3z6Ou0sh6HyvaKE5O6NBDlmO-wgEGaQ,67
+pyfemtet-0.4.2.dist-info/RECORD,,