distutils.ccompiler_opt.CCompilerOpt.conf_features_partial() のサンプルコード

NumPy の Packaging に関連する distutils.ccompiler_opt.CCompilerOpt.conf_features_partial() の解説

distutils.ccompiler_opt.CCompilerOpt.conf_features_partial() は、NumPy の Packaging において、コンパイラオプションを設定するための重要な関数です。この関数は、NumPy のインストール時に、特定のコンパイラ機能が利用可能かどうかを判断し、必要なオプションを自動的に設定します。

詳細

この関数は、以下の引数を受け取ります。

• compiler: 使用するコンパイラの名前
• feature: 設定するコンパイラ機能の名前
• default: 機能が利用可能でない場合に設定されるオプション

この関数は、以下の処理を行います。

1. 指定されたコンパイラと機能がサポートされているかどうかを確認します。
2. サポートされている場合は、必要なオプションを設定します。
3. サポートされていない場合は、デフォルトオプションを設定します。

例

以下の例は、gcc コンパイラで -march=native オプションを設定する方法を示します。

from distutils.ccompiler_opt import CCompilerOpt

compiler_opt = CCompilerOpt()
compiler_opt.conf_features_partial('gcc', 'march=native', '-march=native')

# NumPy のインストール時に、`-march=native` オプションが自動的に設定されます。

補足

• conf_features_partial() 関数は、NumPy のインストール時にのみ使用されます。NumPy を使用したアプリケーション開発では、この関数は使用しません。

NumPy の Packaging に関連する distutils.ccompiler_opt.CCompilerOpt.conf_features_partial() のサンプルコード

from distutils.ccompiler_opt import CCompilerOpt

compiler_opt = CCompilerOpt()
compiler_opt.conf_features_partial('gcc', 'march=native', '-march=native')

# NumPy のインストール時に、`-march=native` オプションが自動的に設定されます。

Clang コンパイラで -msse2 オプションを設定する

from distutils.ccompiler_opt import CCompilerOpt

compiler_opt = CCompilerOpt()
compiler_opt.conf_features_partial('clang', 'msse2', '-msse2')

# NumPy のインストール時に、`-msse2` オプションが自動的に設定されます。

Intel コンパイラで -xMIC オプションを設定する

from distutils.ccompiler_opt import CCompilerOpt

compiler_opt = CCompilerOpt()
compiler_opt.conf_features_partial('intel', 'xMIC', '-xMIC')

# NumPy のインストール時に、`-xMIC` オプションが自動的に設定されます。

複数のコンパイラで異なるオプションを設定する

from distutils.ccompiler_opt import CCompilerOpt

compiler_opt = CCompilerOpt()

# GCC コンパイラ
compiler_opt.conf_features_partial('gcc', 'march=native', '-march=native')

# Clang コンパイラ
compiler_opt.conf_features_partial('clang', 'msse2', '-msse2')

# Intel コンパイラ
compiler_opt.conf_features_partial('intel', 'xMIC', '-xMIC')

# NumPy のインストール時に、コンパイラに応じて異なるオプションが設定されます。

デフォルトオプションを設定する

from distutils.ccompiler_opt import CCompilerOpt

compiler_opt = CCompilerOpt()

# 特定の機能がサポートされていない場合に、`-O2` オプションを設定
compiler_opt.conf_features_partial('gcc', 'avx', '-O2')

# NumPy のインストール時に、`avx` 機能がサポートされていない場合は、`-O2` オプションが設定されます。

補足

• これらのサンプルコードは、NumPy のインストール時にのみ使用されます。NumPy を使用したアプリケーション開発では、これらのコードは使用しません。

NumPy の Packaging における distutils.ccompiler_opt.CCompilerOpt.conf_features_partial() の代替方法

• 複雑な設定には対応していない
• NumPy のバージョンによって動作が異なる

これらの制限を克服するために、以下の代替方法を使用することができます。

環境変数を使用する

コンパイラオプションは、環境変数を使用して設定することができます。例えば、GCC コンパイラで -march=native オプションを設定するには、以下の環境変数を設定します。

export CFLAGS="-march=native"

setup.py ファイルを編集して、コンパイラオプションを直接設定することができます。例えば、以下のように build_ext コマンドに -march=native オプションを追加します。

from distutils.core import setup
from distutils.extension import Extension

setup(
    ext_modules=[
        Extension('my_module',
                  sources=['my_module.c'],
                  extra_compile_args=['-march=native'])
    ]
)

numpy.distutils.ccompiler モジュールは、NumPy の Packaging に特化したコンパイラオプション設定機能を提供します。このモジュールを使用することで、より複雑な設定を行うことができます。

例

from numpy.distutils.ccompiler import CCompiler

compiler = CCompiler()

# GCC コンパイラで `-march=native` オプションを設定
compiler.add_compile_option('-march=native')

# Clang コンパイラで `-msse2` オプションを設定
compiler.add_compile_option('-msse2', compiler='clang')

# NumPy のインストール時に、コンパイラに応じて異なるオプションが設定されます。

補足

• numpy.distutils.ccompiler モジュールは、NumPy のバージョンによって動作が異なる場合があります。詳細は、NumPy のドキュメントを参照してください。