物理量の名前をPythonで

Question

私はシミュレーションコードで使用されている物理的/数学的な量の良い命名体系を確立したいと思います。次の例を考えてみましょう：

from math import * 

class GaussianBeamIntensity(object): 
    """ 
    Optical intensity profile of a Gaussian laser beam. 
    """ 

    def __init__(self, intensity_at_waist_center, waist_radius, wavelength): 
     """ 
     Arguments: 

     *intensity_at_waist_center*: The optical intensity of the beam at the 
      center of its waist in W/m^2 units. 

     *waist_radius*: The radius of the beam waist in meters. 

     *wavelength*: The wavelength of the laser beam in meters. 

     """ 

     self.intensity_at_waist_center = intensity_at_waist_center 
     self.waist_radius = waist_radius 
     self.wavelength = wavelength 
     self._calculate_auxiliary_quantities() 

    def _calculate_auxiliary_quantities(self): 
     # Shorthand notation 
     w_0, lambda_ = self.waist_radius, self.wavelength 

     self.rayleigh_range = pi * w_0**2/lambda_ 
     # Generally some more quantities could follow 

    def __call__(self, rho, z): 
     """ 
     Arguments: 

     *rho*, *z*: Cylindrical coordinates of a spatial point. 
     """ 
     # Shorthand notation 
     I_0, w_0 = self.intensity_at_waist_center, self.waist_radius 
     z_R = self.rayleigh_range 

     w_z = w_0 * sqrt(1.0 + (z/z_R)**2) 
     I = I_0 * (w_0/w_z)**2 * exp(-2.0 * rho**2/w_z**2) 
     return I 

命名スキームを使用すると、数式が比較的短いままであること可読性と簡潔な表記（間バランスをとるために、物理的性質（物性、関数の引数など）のために提案する何一貫した）？上記の例を改善していただけますか？または、より良い体系を提案するか？

PEP8のガイドラインに従い、「愚かな一貫性は少しの心のホッコブリン」であることを覚えておくとよいでしょう。伝統的な80文字の行の長さに従いながら、わかりやすい名前に固執するのは難しいようです。

ありがとうございます！

Answer 1

私はあなたがすでに良いバランスを見つけたと思います。表現の名前は重要なので、私はクラス属性としてλrefの代わりにwavelenghtの使用に完全に同意します。このようにして、インタフェースは明確かつ表現力豊かなままです。

しかし、長い式では、lambda_は光学式の波長に一般に認められ広く使用されている表記法であるため、簡略表記として良い選択です。私は、数式を実装するとき、あなたがしたいことは、紙の上に書く方程式の形式（または記事などに表示されるような形）に可能な限り近づけることだと思います。

簡潔に言えば、インターフェイスは表現力豊かで、式は短くしておいてください。

Answer 2

Python3を使用して、変数名に実際のシンボルλを使用できます。

私のようなコードを書くことを楽しみにして：

from math import pi as π 

sphere_volume = lambda r : 4/3 * π * r**3