インストール

セクションの概要

このセクションでは,Mayaviをインストールするさまざまな方法について説明します.

すでにMayaviを起動して実行している場合は,このセクションをスキップできます.

Mayavi自体はインストールするのが難しいパッケージではありませんが,残念ながら依存関係はかなり重いです.幸いなことに,これらの依存関係の多くはPyPIのwheelとして使用できるようになりました.

  1. VTK
  2. GUIツールキット, PyQt4PySidePyQt5 ,または wxPython

最新のVTKwheelは,すべての主要プラットフォーム(Windows,MacOS,およびLinux)で利用できますが,64ビットマシンでのみ利用できます.Python3.xはこれらすべてのオペレーティングシステムで,Python 2.7.xはMacOSとLinuxで完全にサポートされています.あなたのプラットフォームがサポートされていない場合は, General Build and Installation instructions

Python3.xでは, PyQt5 をインストールする必要があります.2.7.xには他にもオプションがあり, PySidePyQt4wxPython を使うことができます.これらは,pipまたはパッケージマネージャからインストールできます.

現在,Mayavi自体は新しいwxPython4.xで動作するはずです.ただし, traitsuipyface ,およびその他のETSパッケージではまだサポートされていないため,UIは正しく動作しません.古いバージョンでも動作するはずです.PyQt/PySideは,ほとんどそのままの状態で動作するはずです.PySide2はまだ若いのでYMMVです.

pip でのインストール

pip は, PyPA からPythonパッケージをインストールするための PyPA 推奨ツールです.PyPIで入手可能なMayaviの最新バージョンは, ここ で見ることができます.

pip を使用すると,必要なpythonパッケージを自動的にfetchしてインストールできます.

最新の安定版リリース

最新リリース4.6 .0以降では,Python3.xを使用していて64ビットマシンを使用している場合, pip によるインストールが最も簡単で,次のようになります.

$ pip install mayavi

$ pip install PyQt5

よし!

これができない場合は,上記のドキュメントを読み,VTKと適切なUIツールキットをインストールする方法を見つけて,上記の手順を繰り返します.

jupyterノートブックのサポートにも関心がある場合は,次の操作を行います(もちろん jupyter がインストールされていることを確認した後で).

$ jupyter nbextension install --py mayavi --user
$ jupyter nbextension enable --py mayavi --user

また, ipywidgetsipyevents がインストールされている必要があります.これらは,pipまたは任意のパッケージマネージャを使用してインストールできます.

最新版

githubから最新バージョンのMayaviをインストールするには,次の手順を実行します.

$ git clone https://github.com/enthought/mayavi.git
$ cd mayavi
$ pip install -r requirements.txt
$ pip install PyQt5  # replace this with any supported toolkit
$ python setup.py install  # or develop

上記の手順に従ってjupyter nbextensionsを追加すれば,準備は完了です.

Mayaviは,ETSの一部である複数のパッケージに依存しています.開発中のmayaviバージョンが,リリースされていないコンポーネントの一部の機能に依存している可能性があります.Mayaviが依存するETSパッケージは, apptoolstraits_traitsuipyface ,および envisage_ です.これらのいずれかが必要な場合は,gitを使ってインストールすることもできます.いずれも比較的簡単にパッケージをインストールできます.

既製のディストリビューションのインストール

Windows:Windows環境でMayaviをインストールする最善の方法は, Enthought CanopyPythonxyAnaconda などの完全なPythonディストリビューションをインストールすることです.Pythonxyについては,コンポーネントを選択するときにインストーラーで 'ETS' をチェックインする必要があることに注意してください.Pythonxyが使用するディスク容量を減らすには,ほかのコンポーネントのチェックを外します.
MacOSX:Pythonの完全なディストリビューション Enthought Canopy (Mayaviを含む)または Anaconda はMacOSXでも利用可能です.
UbuntuまたはDebian:
 Mayaviは DebianUbuntu にパッケージされており, apt でインストールできます.
RedHat EL3およびEL4:
 Pythonの完全なディストリビューション Enthought Canopy (Mayaviを含む)はRHEL3と4でも利用できます.

EDMは,無料で入手できるEnthoughtのPython環境マネージャーです.新しいPythonユーザは,軽量でカスタムなPython環境を作成できます.EDMの主な利点は,パッケージの依存関係を最先端の方法で確実に管理できることです.競合を解決し,一貫したパッケージ・バージョン・セットを確保できます.これは edmInstaller からダウンロードできます.

EDMはPython 2.7.xとPython3.xランタイムを提供します.Python 2.7がデフォルトバージョンです.EDMをインストールした後,端末から edm を使って簡単にmayaviをインストールできます.

$ edm install mayavi pyqt

これにより,mayaviと 'pyqt' がインストールされます.この後,次のコマンドを実行して,デフォルトのPythonバージョンでシェルを起動できます.

$ edm shell

これにより,MayaviがデフォルトのPython 2.7に設定されます.

python 3.6.xの場合は,次のコマンドを実行してインストールできます.

$ edm environments create --version 3.6 py3

ここで, 'py3' は環境の名前です.必要に応じて,この名前を別の名前に変更できます.環境を作成したら,次の手順でアクティブにできます.

$ edm shell -e py3

これで,次のようにmayaviをインストールできます.

$ edm install mayavi pyqt

'pyqt' は,python 3.6およびpython 2.7に対して明示的にインストールする必要があることに注意してください.

Condaは,複数バージョンのソフトウェア・パッケージとその依存関係をインストールするためのオープンソースのパッケージ管理環境管理システムです.CondaはAnacondaとMinicondaに含まれています.

Minicondaは小さな "bootstrap" バージョンで,conda,python,そしてそれらが依存するパッケージを含みます.オペレーティングシステムによっては, MinicondaInstaller をダウンロードできます.

condaをインストールしたら,コマンドラインから以下を実行する必要があります.

$ conda create -n pyconda python=3.5 pyqt=4
$ source activate pyconda
$ conda install -c menpo mayavi

これで準備万端です.Mayavi 4.6 .0以降では, pyqt=5 を使うこともできます.

Conda-forge によるインストール

conda-forgeはコミュニティ主導のインストール可能パッケージのcondaチャネルです.conda-forgeの詳細については,彼らの website にアクセスしてください.

conda-forgeを使用してインストールするには,次の手順に従います.

まず,環境のクローンを作成するか,環境を最初から構築します.

$ conda create --name pyforge --clone root
or
$ conda create --name pyforge python=2.7

次に,conda-forgeチャンネルを追加します.

$ conda config --add channels conda-forge

'pyforge' 環境をアクティブ化します.

$ source activate pyforge

同じキーワードが重複している場合は,最後のインスタンスが使用されます.

$ conda install vtk
$ conda install pyqt=4

最後に,Mayaviは次のようにインストールできます.

$ conda install mayavi

インストールのテスト

インストールがOKかどうかをテストする最も簡単な方法は,次のようにmayavi2アプリケーションを実行することです.

mayavi2

コマンドの詳細なヘルプを表示するには,次の操作を実行します.

mayavi2 -h

mayavi2 はmayaviアプリケーションです.win32などの一部のプラットフォームでは,"PythonXYScripts"フォルダにある"mayavi2.exe"プログラムをダブルクリックする必要があります.このディレクトリがパスにあることを確認してください.

注釈

Mayaviは他にもさまざまな方法で使用できますが,最初は mayavi2 アプリケーションが最も簡単です.

mayaviのソースtarballがある場合や,githubリポジトリからソースをチェックアウトしている場合は, mayavi*/examples の例を実行してください.さまざまな機能を説明するスクリプト例は多数あります.テストは mayavi*/tests サブディレクトリにあります.

テストスイート

tvtkとmayaviの基本的なテストスイートは,noseを使って実行できます.

nosetests -v tvtk/tests
nosetests -v mayavi

統合テストは次のように実行できます.

cd integrationtests/mayavi
python run.py

トラブルシューティング

インストールに問題がある場合は, ヘルプの表示 ページで情報の検索方法の詳細を確認するか,メーリングリストに電子メールを送ってください.