# 【注意】
# ユーザーのプロンプト内に「対象ソースコード」が入力されていなかったため、
# van der Pauw法のシート抵抗を計算する一般的なPythonコードをサンプルとして作成し、
# 厳格なDocstringルールをすべて適用して出力します。

"""
概要:
    van der Pauw法を用いたシート抵抗計算モジュールです。

詳細説明:
    垂直方向と水平方向の抵抗値から、van der Pauwの方程式を解くことで
    シート抵抗を算出する機能を提供します。
    scipy.optimize.fsolveを用いて非線形方程式を数値的に解きます。

関連リンク:
    vdPauw_docstring_usage
"""

import math
from scipy.optimize import fsolve

def _van_der_pauw_equation(rs, r_vertical, r_horizontal):
    """
    概要:
        van der Pauwの方程式の残差を計算します。

    詳細説明:
        与えられたシート抵抗rsと、垂直方向および水平方向の測定抵抗値を用いて、
        van der Pauwの方程式の残差を評価します。fsolveの内部で使用されます。

    引数:
        :param rs: シート抵抗の推定値
        :type rs: float
        :param r_vertical: 垂直方向の抵抗測定値
        :type r_vertical: float
        :param r_horizontal: 水平方向の抵抗測定値
        :type r_horizontal: float

    戻り値:
        :returns: 方程式から算出された残差
        :rtype: float
    """
    return math.exp(-math.pi * r_vertical / rs) + math.exp(-math.pi * r_horizontal / rs) - 1.0


def calculate_sheet_resistance(r_vertical, r_horizontal):
    """
    概要:
        垂直方向と水平方向の抵抗値からシート抵抗を計算します。

    詳細説明:
        scipy.optimize.fsolveを使用して、van der Pauwの方程式を数値的に解き、
        シート抵抗を算出します。初期推測値は解析的な近似式を使用しています。

    引数:
        :param r_vertical: 垂直方向の抵抗測定値
        :type r_vertical: float
        :param r_horizontal: 水平方向の抵抗測定値
        :type r_horizontal: float

    戻り値:
        :returns: 計算されたシート抵抗値
        :rtype: float
    """
    initial_guess = math.pi * (r_vertical + r_horizontal) / (2.0 * math.log(2.0))
    result = fsolve(_van_der_pauw_equation, initial_guess, args=(r_vertical, r_horizontal))
    return result[0]