Spec-Zone.ru › NumPy 1.21

Использование через numpy.distutils

numpy.distutils является частью NumPy, расширяющей стандартный Python distutils для работы с источниками Fortran и файлами сигнатур F2PY, например, для компиляции источников Fortran, вызова F2PY для создания модулей расширения и т. д.

Пример

Рассмотрим следующий файл setup:

from numpy.distutils.core import Extension

ext1 = Extension(name = 'scalar',
                 sources = ['scalar.f'])
ext2 = Extension(name = 'fib2',
                 sources = ['fib2.pyf', 'fib1.f'])

if __name__ == "__main__":
    from numpy.distutils.core import setup
    setup(name = 'f2py_example',
          description       = "F2PY Users Guide examples",
          author            = "Pearu Peterson",
          author_email      = "pearu@cens.ioc.ee",
          ext_modules = [ext1, ext2]
          )
# End of setup_example.py

Запуск

python setup_example.py build

создаст два модуля расширения scalar и fib2 в директории сборки.

numpy.distutils расширяет distutils следующими возможностями:

  • Extension аргумент класса sources может содержать файлы исходного кода Fortran. Кроме того, список sources может содержать не более одного файла сигнатуры F2PY, и тогда имя модуля расширения должно совпадать с именем <modulename> используемым в файле сигнатуры. Предполагается, что файл сигнатуры F2PY содержит ровно один python module блок.

    Если sources не содержит файлов сигнатур, то F2PY используется для сканирования файлов исходного кода Fortran в поисках сигнатур процедур для создания обёртки для кодов Fortran.

    Дополнительные параметры для процесса F2PY можно указать, используя аргумент класса Extension f2py_options.

  • Определены следующие новые команды distutils:

    build_src

    для создания модулей расширения обёртки для Fortran, среди прочего.

    config_fc

    для изменения параметров компилятора Fortran

    а также команды build_ext и build_clib улучшены для поддержки источников Fortran.

    Запуск

    python <setup.py file> config_fc build_src build_ext --help
    

    покажет доступные параметры для этих команд.

  • При построении пакетов Python, содержащих источники Fortran, можно выбрать различные компиляторы Fortran, используя команду build_ext с опцией --fcompiler=<Vendor>. Здесь <Vendor> может быть одним из следующих имён:

    absoft sun mips intel intelv intele intelev nag compaq compaqv gnu vast pg hpux
    

    См. numpy_distutils/fcompiler.py для актуального списка поддерживаемых компиляторов или запустите

    f2py -c --help-fcompiler
    

© 2005–2022 NumPy Developers
Licensed under the 3-clause BSD License.
https://numpy.org/doc/1.21/f2py/distutils.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API